@webority/mobile-ui 0.0.0-stage → 0.0.33

package/lib/typescript/commonjs/components/FieldBase/useFloatingLabel.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The field family's floating label, shared by Input and SearchBar.
+ *
+ * Resting, the label sits over the text (past any leading icon) at the
+ * field's font size; on focus or with a value it rises to the box's top edge
+ * at 85% scale and slides to the field's left edge, straight above the icon.
+ * On the outlined variant the top border is cut where the floated label
+ * lands (`topNotch`, handed to FieldBase), so the rule never runs behind the
+ * text and the label needs no masking background.
+ *
+ * The hook owns the animation, the label's measured layout (which sizes the
+ * notch) and the Animated.Text itself; the consumer places `node` inside the
+ * wrapper that also holds FieldBase (position relative, overflow visible)
+ * and passes `topNotch` through.
+ */
+import type { StyleProp, TextStyle } from 'react-native';
+import type { ResolvedFieldSizeTokens } from '../../theme/types';
+import type { FieldBaseProps, FieldBaseVariant } from './FieldBase';
+/** The floated label's scale; the outlined notch is sized from it. */
+export declare const FLOATED_LABEL_SCALE = 0.85;
+export interface UseFloatingLabelOptions {
+    label?: string;
+    /** Render at all (label present and the consumer's labelMode is 'float'). */
+    enabled: boolean;
+    /** Whether the label is up on the border right now (focused or holding a value). */
+    floated: boolean;
+    required?: boolean;
+    variant: FieldBaseVariant;
+    sizeTokens: ResolvedFieldSizeTokens;
+    /** Where the text starts past the leading slot (icon, gaps, divider), px. */
+    leadingOffset: number;
+    /** Width the trailing slot takes, for a right-aligned label, px. */
+    trailingOffset?: number;
+    textAlign?: 'left' | 'right' | 'center';
+    /** The field's left padding at rest; 0 for underline rows whose text is flush with the rule. */
+    paddingLeft: number;
+    /** Explicit line height of the field's text (textarea); the label box takes it too. */
+    lineHeight?: number;
+    /** Extra resting offset from the top padding (a textarea's optical nudge). */
+    restNudge?: number;
+    /** Float a little less (a textarea's exact line box needs 2px). */
+    floatTrim?: number;
+    color: string;
+    style?: StyleProp<TextStyle>;
+}
+export interface UseFloatingLabelResult {
+    /** The Animated.Text, or null when disabled. Place it beside FieldBase inside a relative wrapper. */
+    node: React.ReactNode;
+    /** Hand to FieldBase so the outlined top border opens under the floated label. */
+    topNotch: FieldBaseProps['topNotch'];
+}
+export declare const useFloatingLabel: ({ label, enabled, floated, required, variant, sizeTokens, leadingOffset, trailingOffset, textAlign, paddingLeft, lineHeight, restNudge, floatTrim, color, style }: UseFloatingLabelOptions) => UseFloatingLabelResult;
+//# sourceMappingURL=useFloatingLabel.d.ts.map

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

@@ -0,0 +1,156 @@
+/**
+ * FilePicker — attachment picking UI with pluggable native sources.
+ *
+ * The library owns the UI and behaviour: trigger (dashed card / list row /
+ * custom render prop), the source-chooser sheet (shared OptionSheet), enforced
+ * validation (maxFiles / maxSizeMB / accept / custom), the canonical file
+ * shape, per-file status + progress display, remove/retry affordances,
+ * a11y, haptics and theming.
+ *
+ * What it deliberately does NOT own:
+ *   - Native picking. Camera / gallery / document access lives in app-level
+ *     `sources` adapters (`pick(): Promise<PickedFileInput[]>`), so the
+ *     library stays zero-dependency and each app wires the native modules it
+ *     already ships. Throwing inside `pick` surfaces as a field error;
+ *     returning `[]` is a cancel.
+ *   - Networking. Uploads belong to the app's API client / outbox; the app
+ *     reflects them back via per-file `status` / `progress` and gets retry
+ *     taps through `onRetry`.
+ *   - Heavy processing. The async `process` hook runs per accepted file
+ *     (compression, EXIF strip, local copy) before it lands in `files` —
+ *     plug the app's image pipeline in there.
+ */
+import React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
+export type FilePickerVariant = 'card' | 'list';
+export type FilePickerFileStatus = 'idle' | 'processing' | 'uploading' | 'done' | 'error';
+export interface FilePickerFile {
+    /** Stable identity — generated by the library when the source doesn't provide one. */
+    id: string;
+    name: string;
+    /** Local content URI (freshly picked files). */
+    uri?: string;
+    /** Remote URL for already-uploaded files (edit screens). */
+    url?: string;
+    /** Remote thumbnail. Image files fall back to `uri` / `url`. */
+    thumbnailUrl?: string;
+    /** Mime type, e.g. `image/jpeg`. */
+    type?: string;
+    /** Bytes. */
+    size?: number;
+    /** Display-only upload state — the app sets these, the library renders them. */
+    status?: FilePickerFileStatus;
+    /** 0–1, rendered while `status === 'uploading'`. */
+    progress?: number;
+    /** Shown on the file while `status === 'error'`. */
+    error?: string;
+    /** Consumer payload — preserved untouched through every operation. */
+    meta?: Record<string, unknown>;
+}
+/** What a source's `pick()` resolves with — the library normalizes the rest. */
+export interface PickedFileInput {
+    uri: string;
+    name?: string;
+    type?: string;
+    size?: number;
+    meta?: Record<string, unknown>;
+}
+export interface FilePickerSource {
+    key: string;
+    label: string;
+    description?: string;
+    icon?: React.ReactNode;
+    /** Launch native picking. Resolve `[]` for user-cancel; throw for real failures. */
+    pick: () => Promise<PickedFileInput[]>;
+}
+/** Everything a custom `renderFile` template needs to paint one file. */
+export interface FilePickerFileState {
+    file: FilePickerFile;
+    index: number;
+    disabled: boolean;
+    remove: () => void;
+    retry?: () => void;
+}
+export interface FilePickerTriggerState {
+    /** Open a specific source, or the chooser sheet when omitted and >1 source. */
+    open: (sourceKey?: string) => void;
+    disabled: boolean;
+    fileCount: number;
+    atCapacity: boolean;
+}
+export interface FilePickerLabels {
+    /** Trigger text when no files are attached. Default 'Attach file'. */
+    trigger: string;
+    /** Add-affordance text/tile label once files exist. Default '+'. (card tile) / 'Add more' (list row). */
+    addMore: string;
+    /** Source chooser sheet title. Default 'Add from'. */
+    sheetTitle: string;
+    /** A11y label template for a file's remove button. */
+    removeFile: (name: string) => string;
+    /** Retry affordance a11y label. Default 'Retry upload'. */
+    retry: string;
+    errorTooMany: (maxFiles: number) => string;
+    errorTooLarge: (name: string, maxSizeMB: number) => string;
+    errorWrongType: (name: string) => string;
+}
+export interface FilePickerRef {
+    /** Open a source by key, or the chooser (sheet when >1 source). */
+    open: (sourceKey?: string) => void;
+    /** Remove all files. */
+    clear: () => void;
+}
+export interface FilePickerProps {
+    /** Controlled file list. */
+    files?: FilePickerFile[];
+    /** Uncontrolled initial list (edit screens can seed remote files here too). */
+    defaultFiles?: FilePickerFile[];
+    onChange?: (files: FilePickerFile[]) => void;
+    /** Native picking adapters. One source launches directly; several open the chooser sheet. */
+    sources: ReadonlyArray<FilePickerSource>;
+    maxFiles?: number;
+    /** Per-file size cap — oversized picks are rejected with a visible error. */
+    maxSizeMB?: number;
+    /** Accepted mime globs, e.g. `['image/*', 'application/pdf']`. Unset = accept all. */
+    accept?: ReadonlyArray<string>;
+    /** Custom per-file rule — return an error string to reject. */
+    validate?: (file: FilePickerFile) => string | null | undefined;
+    /**
+     * Async per-file transform between pick and `files` (compression, local
+     * copy). The file shows `processing` while it runs; a throw rejects the
+     * file with the thrown message as the field error.
+     */
+    process?: (file: FilePickerFile) => Promise<FilePickerFile>;
+    /** `card`: dashed upload card → horizontal thumbnail strip. `list`: rows with name/size/status. */
+    variant?: FilePickerVariant;
+    /** Full custom per-file template. Library keeps remove/retry handlers + a11y wiring via the state object. */
+    renderFile?: (state: FilePickerFileState) => React.ReactNode;
+    /** Replace the built-in trigger entirely; behaviour arrives via the state object. */
+    renderTrigger?: (state: FilePickerTriggerState) => React.ReactNode;
+    disabled?: boolean;
+    /** Hint under the trigger (e.g. "Up to 5 files, max 100MB each."). */
+    helperText?: string;
+    /** External error — wins over internal validation errors (form binding). */
+    error?: string;
+    labels?: Partial<FilePickerLabels>;
+    /** Haptics for pick/remove (selection) and rejections (error). Pass false to disable. */
+    haptic?: HapticType | false;
+    /** Files accepted by a pick (post-validation, post-process). */
+    onPick?: (files: FilePickerFile[]) => void;
+    onRemove?: (file: FilePickerFile) => void;
+    /** Each rejection message (also shown as the field error). */
+    onError?: (message: string, file?: FilePickerFile) => void;
+    /** Tap on a file tile/row — wire previews (ImageGallery) here. */
+    onFilePress?: (file: FilePickerFile) => void;
+    /** When set, files with `status 'error'` show a retry affordance that calls this. */
+    onRetry?: (file: FilePickerFile) => void;
+    style?: StyleProp<ViewStyle>;
+    accessibilityLabel?: string;
+    testID?: string;
+}
+export declare const formatFileSize: (bytes?: number) => string;
+export declare const matchesAccept: (type: string | undefined, accept?: ReadonlyArray<string>) => boolean;
+declare const FilePicker: React.ForwardRefExoticComponent<FilePickerProps & React.RefAttributes<FilePickerRef>>;
+export { FilePicker };
+export default FilePicker;
+//# sourceMappingURL=FilePicker.d.ts.map

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

@@ -0,0 +1,3 @@
+export type { FilePickerFile, FilePickerFileState, FilePickerFileStatus, FilePickerLabels, FilePickerProps, FilePickerRef, FilePickerSource, FilePickerTriggerState, FilePickerVariant, PickedFileInput } from './FilePicker';
+export { default, FilePicker, formatFileSize } from './FilePicker';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,42 @@
+import { type DownloadHttpClient } from '@webority/mobile-core/download';
+import type React from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export interface FileViewerSource {
+    uri: string;
+    headers?: Record<string, string>;
+    /**
+     * Fetches a remote `uri`. Pass the app's signed-in client (mobile-core's
+     * `userClient`, or its own) for a document behind sign-in; defaults to
+     * mobile-core's `publicClient`.
+     */
+    client?: DownloadHttpClient;
+    /** Reuse a previously downloaded copy of this URL instead of re-fetching. Default true. */
+    cache?: boolean;
+}
+export interface FileViewerProps {
+    source: FileViewerSource;
+    onLoadComplete?: (numberOfPages: number) => void;
+    onPageChanged?: (page: number, numberOfPages: number) => void;
+    onError?: (error: Error) => void;
+    /** Replaces the default themed spinner shown while the document loads. */
+    loadingIndicator?: () => React.ReactNode;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+    accessibilityLabel?: string;
+}
+/**
+ * Renders a PDF via our own native rasterizer (PDFKit 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.
+ */
+export declare const FileViewer: React.FC<FileViewerProps>;
+export default FileViewer;
+//# sourceMappingURL=FileViewer.d.ts.map

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

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

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

@@ -0,0 +1,66 @@
+import React from 'react';
+import type { View as RNView, StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils/hapticUtils';
+export type FloatingActionButtonSize = 'sm' | 'md' | 'lg';
+export type FloatingActionButtonTone = 'primary' | 'success' | 'warning' | 'error' | 'neutral';
+export type FloatingActionButtonPosition = 'bottomRight' | 'bottomLeft' | 'bottomCenter';
+export interface FloatingActionButtonProps {
+    /** JSX element for the icon. The FAB sizes it via the `size` prop's iconSize token. */
+    icon: React.ReactNode;
+    onPress: () => void;
+    label?: string;
+    size?: FloatingActionButtonSize;
+    tone?: FloatingActionButtonTone;
+    position?: FloatingActionButtonPosition;
+    bottomOffset?: number;
+    disabled?: boolean;
+    hideOnScroll?: boolean;
+    isScrolling?: boolean;
+    accessibilityLabel: string;
+    accessibilityHint?: string;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
+    style?: StyleProp<ViewStyle>;
+    containerStyle?: StyleProp<ViewStyle>;
+    labelStyle?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const FloatingActionButton: React.ForwardRefExoticComponent<FloatingActionButtonProps & React.RefAttributes<RNView>>;
+export interface FloatingActionButtonGroupAction {
+    key: string;
+    icon: React.ReactNode;
+    label?: string;
+    onPress: () => void;
+    tone?: FloatingActionButtonTone;
+    accessibilityLabel: string;
+}
+export interface FloatingActionButtonGroupProps {
+    primaryIcon: React.ReactNode;
+    primaryActiveIcon?: React.ReactNode;
+    actions: FloatingActionButtonGroupAction[];
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    position?: FloatingActionButtonPosition;
+    bottomOffset?: number;
+    size?: FloatingActionButtonSize;
+    accessibilityLabel?: string;
+    /** Haptic feedback for interactions. Pass false to disable; pass a HapticType to override the default. */
+    haptic?: HapticType | false;
+    /**
+     * Slide the whole group off the bottom edge while `isScrolling` is true,
+     * the same way the single button does. An open group closes first.
+     */
+    hideOnScroll?: boolean;
+    /** Whether the list behind the group is scrolling right now; wire to your scroll handler. */
+    isScrolling?: boolean;
+    containerStyle?: StyleProp<ViewStyle>;
+    secondaryActionStyle?: StyleProp<ViewStyle>;
+    labelPillStyle?: StyleProp<ViewStyle>;
+    labelStyle?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const FloatingActionButtonGroup: React.FC<FloatingActionButtonGroupProps>;
+export { FloatingActionButton, FloatingActionButtonGroup };
+export default FloatingActionButton;
+//# sourceMappingURL=FloatingActionButton.d.ts.map

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

@@ -0,0 +1,3 @@
+export type { FloatingActionButtonGroupAction, FloatingActionButtonGroupProps, FloatingActionButtonPosition, FloatingActionButtonProps, FloatingActionButtonSize, FloatingActionButtonTone } from './FloatingActionButton';
+export { default, FloatingActionButton, FloatingActionButtonGroup } from './FloatingActionButton';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,47 @@
+import React from 'react';
+import type { StyleProp, TextStyle, ViewStyle } from 'react-native';
+export interface ForceUpdateDialogProps {
+    /** Whether the dialog is visible. */
+    visible: boolean;
+    /** Called when the dialog is dismissed (only fired when `mandatory` is `false`). */
+    onClose?: () => void;
+    /**
+     * If `true`, hides the "Later" action and disables backdrop dismissal —
+     * use this for major version bumps that must not be skipped.
+     */
+    mandatory?: boolean;
+    /** Optional override of the destination URL (defaults to the platform store). */
+    updateUrl?: string | null;
+    /** Custom dialog title. */
+    title?: string;
+    /** Custom dialog message. */
+    message?: string;
+    /** Custom label for the primary "Update" action. */
+    updateLabel?: string;
+    /** Custom label for the dismiss action. Hidden when `mandatory`. */
+    laterLabel?: string;
+    /** Forwarded to the underlying Dialog container. */
+    containerStyle?: StyleProp<ViewStyle>;
+    /** Forwarded to the underlying Dialog title Text. */
+    titleStyle?: StyleProp<TextStyle>;
+    /** Forwarded to the underlying Dialog message Text. */
+    messageStyle?: StyleProp<TextStyle>;
+    testID?: string;
+}
+/**
+ * Drop-in update prompt that opens the App Store / Play Store on tap.
+ * Pair this with `useVersionCheck()` — render it when `isUpdateRequired` is true.
+ *
+ * @example
+ * const { isUpdateRequired, updateUrl } = useVersionCheck(isAppReady);
+ * return (
+ *   <ForceUpdateDialog
+ *     visible={isUpdateRequired}
+ *     mandatory
+ *     updateUrl={updateUrl}
+ *   />
+ * );
+ */
+export declare const ForceUpdateDialog: React.FC<ForceUpdateDialogProps>;
+export default ForceUpdateDialog;
+//# sourceMappingURL=ForceUpdateDialog.d.ts.map

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

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

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

@@ -0,0 +1,49 @@
+import React from 'react';
+import type { View as RNView, StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { FieldInputProps } from '../../form/types';
+export type FormFieldLayout = 'stacked' | 'inline';
+export interface FormFieldProps {
+    label?: string;
+    helperText?: string;
+    /**
+     * When truthy: helperText is hidden, error is shown in the error colour,
+     * and the container reports the invalid state to assistive tech.
+     * Ignored when `name` connects to a <Form> with an element child (the child
+     * renders its own error then).
+     */
+    error?: string;
+    /**
+     * Appends the required marker to the label. Marker text + colour come from
+     * `theme.components.field.{requiredMarker,requiredMarkerColor}` (default
+     * `'*'` in `colors.error`).
+     */
+    required?: boolean;
+    /**
+     * Connect this field to the surrounding `<Form>` by name. With an element
+     * child (e.g. `<Input/>`) the field's value/onChangeText/onBlur/error are
+     * injected automatically — best for text inputs. For non-text controls
+     * (Select, Switch, DatePicker…) use the render-prop form:
+     * `<FormField name="x">{(f) => <Select value={f.value} onChange={f.onChange} />}</FormField>`.
+     */
+    name?: string;
+    children: React.ReactNode | ((field: FieldInputProps) => React.ReactNode);
+    /** 'stacked' (default): label above input. 'inline': label left, input right. */
+    layout?: FormFieldLayout;
+    labelStyle?: StyleProp<TextStyle>;
+    helperStyle?: StyleProp<TextStyle>;
+    errorStyle?: StyleProp<TextStyle>;
+    containerStyle?: StyleProp<ViewStyle>;
+    /**
+     * Style override for the wrapper View that hosts `children` (the input slot).
+     * Useful for the `inline` layout when callers need to tweak the right-hand
+     * column (e.g., set a max width, align differently). Additive only — the
+     * library's base style still applies underneath.
+     */
+    inputContainerStyle?: StyleProp<ViewStyle>;
+    accessibilityLabel?: string;
+    testID?: string;
+}
+declare const FormField: React.ForwardRefExoticComponent<FormFieldProps & React.RefAttributes<RNView>>;
+export { FormField };
+export default FormField;
+//# sourceMappingURL=FormField.d.ts.map

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

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

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

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { GestureResponderEvent, View as RNView, StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
+export type IconButtonTone = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'neutral';
+/**
+ * `glass` is a frosted white fill with a bright rim and dark ink, for a
+ * button over a brand gradient or a photo (a back button on a hero). Its
+ * colours are `theme.colors.glass`, the same in both schemes; the tone is
+ * unused unless `active` forces the solid fill.
+ */
+export type IconButtonVariant = 'solid' | 'soft' | 'outline' | 'ghost' | 'glass';
+export type IconButtonSize = 'sm' | 'md' | 'lg';
+export type IconButtonShape = 'circle' | 'rounded';
+interface IconRenderProps {
+    color: string;
+    size: number;
+}
+export interface IconButtonProps {
+    /** Icon node, or a render fn `({ color, size }) => node` so IconButton can theme + size it. */
+    icon: React.ReactNode | ((props: IconRenderProps) => React.ReactNode);
+    onPress?: (e: GestureResponderEvent) => void;
+    /** Required — icon-only controls need an accessible name. */
+    accessibilityLabel: string;
+    tone?: IconButtonTone;
+    variant?: IconButtonVariant;
+    size?: IconButtonSize;
+    shape?: IconButtonShape;
+    /** Selected/active — renders filled (solid) regardless of `variant` (e.g. an active nav tile). */
+    active?: boolean;
+    disabled?: boolean;
+    loading?: boolean;
+    /** Press haptic. Default `'selection'`. */
+    haptic?: HapticType | false;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<RNView>>;
+export { IconButton };
+export default IconButton;
+//# sourceMappingURL=IconButton.d.ts.map

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

@@ -0,0 +1,3 @@
+export type { IconButtonProps, IconButtonShape, IconButtonSize, IconButtonTone, IconButtonVariant } from './IconButton';
+export { IconButton } from './IconButton';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,55 @@
+/**
+ * ImageGallery — themed gallery built on top of Carousel.
+ *
+ * Base view: a Carousel of cover-fitted images with optional thumbnails strip
+ * and counter pill. Tapping an image opens a fullscreen Lightbox that re-uses
+ * the Carousel for swiping but layers Reanimated 3 pinch-to-zoom + pan gestures
+ * on top so the active image can be inspected at up to 4x magnification.
+ *
+ * USAGE:
+ *
+ * <ImageGallery
+ *   images={[
+ *     { source: { uri: 'https://...' }, caption: 'Sunset' },
+ *     { source: { uri: 'https://...' }, alt: 'Tower at dusk' }
+ *   ]}
+ *   initialIndex={0}
+ * />
+ */
+import React from 'react';
+import type { ImageSourcePropType, StyleProp, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
+export interface GalleryImage {
+    source: ImageSourcePropType;
+    caption?: string;
+    alt?: string;
+}
+export interface ImageGalleryProps {
+    images: GalleryImage[];
+    initialIndex?: number;
+    showThumbnails?: boolean;
+    showCounter?: boolean;
+    enableLightbox?: boolean;
+    enablePinchZoom?: boolean;
+    onIndexChange?: (idx: number) => void;
+    /**
+     * Haptic feedback for interactions. Pass false to disable; pass a HapticType
+     * to override the default.
+     */
+    haptic?: HapticType | false;
+    /**
+     * When true, renders the component as its authored skeleton placeholder shape.
+     * The placeholder mirrors the real layout's footprint so the UI doesn't reflow
+     * when data arrives. Use this while the data driving the component is being fetched.
+     */
+    loading?: boolean;
+    accessibilityLabel?: string;
+    containerStyle?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+declare const ImageGallery: React.FC<ImageGalleryProps> & {
+    Skeleton: React.FC<ImageGalleryProps>;
+};
+export { ImageGallery };
+export default ImageGallery;
+//# sourceMappingURL=ImageGallery.d.ts.map

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * InlineSelect — a compact, borderless select trigger for inside other fields.
+ *
+ * Renders just the selected label + chevron (no FieldBase box) and opens the
+ * shared OptionSheet picker. Designed to live in Input's `leftIcon` /
+ * `rightIcon` slots — currency prefix on an amount field, country code on a
+ * phone field, unit suffix on a measurement — but works anywhere a bare
+ * dropdown trigger is needed (toolbars, list headers).
+ *
+ * Single-select only by design: a multi-select crammed into a field affix has
+ * no sane closed-state rendering. Reach for Select when you need multi.
+ *
+ * ```tsx
+ * <Input
+ *   placeholder="Amount"
+ *   textAlign="right"
+ *   keyboardType="number-pad"
+ *   leftIcon={
+ *     <InlineSelect options={currencies} value={currency} onChange={setCurrency} />
+ *   }
+ * />
+ * ```
+ */
+import React from 'react';
+import type { View as RNView, StyleProp, TextStyle, ViewStyle } from 'react-native';
+import type { HapticType } from '../../utils';
+import type { SelectOption, SelectValue } from '../OptionSheet/OptionSheet';
+export type InlineSelectSize = 'sm' | 'md' | 'lg';
+export interface InlineSelectProps<T = SelectOption> {
+    /** Same contract as Select's `options` — `SelectOption` shape by default, accessors for anything else. */
+    options: ReadonlyArray<T>;
+    /** Defaults to `(o) => (o as SelectOption).label`. */
+    getOptionLabel?: (option: T) => string;
+    /** Defaults to `(o) => (o as SelectOption).value`. */
+    getOptionValue?: (option: T) => SelectValue;
+    /** Defaults to `(o) => (o as SelectOption).disabled === true`. */
+    getOptionDisabled?: (option: T) => boolean;
+    /** Defaults to `(o) => (o as SelectOption).description`. */
+    getOptionDescription?: (option: T) => string | undefined;
+    /** Defaults to `(o) => (o as SelectOption).icon`. */
+    getOptionIcon?: (option: T) => React.ReactNode;
+    value?: SelectValue;
+    onChange: (value: SelectValue) => void;
+    /** Trigger text when nothing is selected. Default `'Select'`. */
+    placeholder?: string;
+    /**
+     * Label drawn above the trigger, the same `FieldLabel` Select uses, so a bare
+     * trigger reads as a field of its own. Also names the trigger for screen
+     * readers. Inside an Input slot give the Input its own `label` instead and
+     * leave this off; `title` alone still names the trigger for a11y.
+     */
+    label?: string;
+    /**
+     * Heading shown at the top of the options bottom-sheet. Independent of
+     * `label`: omit it for a sheet with no heading.
+     */
+    title?: string;
+    searchable?: boolean;
+    /**
+     * Haptic feedback for open + select. Pass false to disable; pass a
+     * HapticType to override the default.
+     */
+    haptic?: HapticType | false;
+    disabled?: boolean;
+    /**
+     * Matches the host field's size so fontSize / chevron track the surrounding
+     * Input. Default `'md'`.
+     */
+    size?: InlineSelectSize;
+    /**
+     * Trigger text + chevron colour. Resolution: prop →
+     * `theme.components.inlineSelect.color` → `colors.primary`
+     * (`text.disabled` when disabled).
+     */
+    color?: string;
+    /** Chevron colour override — falls back to `color`'s resolution. */
+    chevronColor?: string;
+    /** Chevron size in pixels. Default: the field size's `iconSize`. */
+    chevronSize?: number;
+    textStyle?: StyleProp<TextStyle>;
+    style?: StyleProp<ViewStyle>;
+    /** Style for every option row in the sheet (padding, background, …). */
+    optionStyle?: StyleProp<ViewStyle>;
+    /** Extra style for the selected option row — wins over `optionStyle` and the default selected fill. */
+    selectedOptionStyle?: StyleProp<ViewStyle>;
+    /** Style for every option's label text in the sheet. */
+    optionTextStyle?: StyleProp<TextStyle>;
+    /** Extra style for the selected option's label text — wins over `optionTextStyle` and the default selected colour. */
+    selectedOptionTextStyle?: StyleProp<TextStyle>;
+    accessibilityLabel?: string;
+    testID?: string;
+}
+declare const InlineSelect: React.ForwardRefExoticComponent<InlineSelectProps<unknown> & React.RefAttributes<RNView>>;
+export { InlineSelect };
+export default InlineSelect;
+//# sourceMappingURL=InlineSelect.d.ts.map

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

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