@hzblj/kara-components 0.0.0-stage → 0.2.0

package/lib/typescript/molecules/list-item/list-item.types.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+import type { IconName } from '../../atoms/icon';
+export type ListItemProps = {
+    icon?: IconName;
+    onPress?: () => void;
+    subtitle?: string;
+    testID?: string;
+    title: string;
+};
+export type ListItemComponent = (props: ListItemProps) => ReactNode;

package/lib/typescript/molecules/navigation-bar/index.d.ts

@@ -0,0 +1,2 @@
+export * from './navigation-bar';
+export * from './navigation-bar.types';

package/lib/typescript/molecules/navigation-bar/navigation-bar.d.ts

@@ -0,0 +1 @@
+export * from './navigation-bar.ios';

package/lib/typescript/molecules/navigation-bar/navigation-bar.ios.d.ts

@@ -0,0 +1,2 @@
+import type { NavigationBarComponent } from './navigation-bar.types';
+export declare const NavigationBar: NavigationBarComponent;

package/lib/typescript/molecules/navigation-bar/navigation-bar.types.d.ts

@@ -0,0 +1,24 @@
+import type { ReactNode } from 'react';
+/**
+ * A title with back and close items, for a sheet that is not a navigation screen. On iOS a standalone
+ * `UINavigationBar`, so the items press and render exactly like a native-stack header's — on iOS 26 they share the
+ * bar's glass instead of swelling as standalone glass buttons do. On Android a Material row of icon buttons. The React
+ * Native tier: it needs no host.
+ */
+export type NavigationBarProps = {
+    /** The back item's accessibility label. `Back` by default. */
+    backLabel?: string;
+    /** iOS: the back item's accessibility identifier. */
+    backTestID?: string;
+    /** The close item's accessibility label. `Close` by default. */
+    closeLabel?: string;
+    /** iOS: the close item's accessibility identifier. */
+    closeTestID?: string;
+    /** Shows the back item. */
+    onBack?: () => void;
+    /** Shows the close item. */
+    onClose?: () => void;
+    testID?: string;
+    title?: string;
+};
+export type NavigationBarComponent = (props: NavigationBarProps) => ReactNode;

package/lib/typescript/molecules/pager/index.d.ts

@@ -0,0 +1,2 @@
+export * from './pager';
+export * from './pager.types';

package/lib/typescript/molecules/pager/pager.d.ts

@@ -0,0 +1 @@
+export * from './pager.ios';

package/lib/typescript/molecules/pager/pager.ios.d.ts

@@ -0,0 +1,2 @@
+import type { PagerComponent } from './pager.types';
+export declare const Pager: PagerComponent;

package/lib/typescript/molecules/pager/pager.types.d.ts

@@ -0,0 +1,32 @@
+import type { SpaceSize } from '@hzblj/kara-theme';
+import type { ReactNode } from 'react';
+/**
+ * A swipeable, snapping pager: SwiftUI's `TabView` in its page style, Compose's `HorizontalPager`.
+ *
+ * Pages are addressed by their index rather than by a name, because Compose's pager is index-native
+ * and SwiftUI's tab values are strings — synthesising the string from the child's position is
+ * lossless, whereas inventing indices for named tabs on Compose would not be. Children are therefore
+ * plain nodes with no `Pager.Page` part to wrap them in: a page carries no props of its own, so the
+ * ceremony would buy nothing.
+ */
+export type PagerProps = {
+    children?: ReactNode;
+    /**
+     * Page dots. iOS draws SwiftUI's own, over the bottom edge; Compose has no built-in indicator, so
+     * Android composes the dots and places them below the pager, which is where Material puts them.
+     */
+    indicators?: boolean;
+    /** Fires once a swipe or a programmatic move has settled, never mid-gesture. */
+    onPageChange?: (page: number) => void;
+    /** Zero-based. Controlled when passed; otherwise the pager just starts at 0 and owns its position. */
+    page?: number;
+    /** Android only — a SwiftUI page-style `TabView` has no gap between pages. */
+    pageSpacing?: SpaceSize;
+    /**
+     * Android only. SwiftUI can only disable a `TabView` as a whole, which would take the pages'
+     * content down with the swipe, so iOS always stays swipeable.
+     */
+    scrollEnabled?: boolean;
+    testID?: string;
+};
+export type PagerComponent = (props: PagerProps) => ReactNode;

package/lib/typescript/molecules/radio-group/index.d.ts

@@ -0,0 +1,2 @@
+export * from './radio-group';
+export * from './radio-group.types';

package/lib/typescript/molecules/radio-group/radio-group.d.ts

@@ -0,0 +1 @@
+export * from './radio-group.ios';

package/lib/typescript/molecules/radio-group/radio-group.ios.d.ts

@@ -0,0 +1,2 @@
+import type { RadioGroupComponent } from './radio-group.types';
+export declare const RadioGroup: RadioGroupComponent;

package/lib/typescript/molecules/radio-group/radio-group.types.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from 'react';
+export type RadioOption = {
+    label: string;
+    value: string;
+};
+export type RadioGroupProps = {
+    onValueChange?: (value: string) => void;
+    options: RadioOption[];
+    value: string;
+};
+export type RadioGroupComponent = (props: RadioGroupProps) => ReactNode;

package/lib/typescript/molecules/rn-tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export * from './rn-tooltip';
+export * from './rn-tooltip.types';

package/lib/typescript/molecules/rn-tooltip/rn-tooltip.d.ts

@@ -0,0 +1 @@
+export * from './rn-tooltip.ios';

package/lib/typescript/molecules/rn-tooltip/rn-tooltip.ios.d.ts

@@ -0,0 +1,2 @@
+import type { RnTooltipComponent } from './rn-tooltip.types';
+export declare const RnTooltip: RnTooltipComponent;

package/lib/typescript/molecules/rn-tooltip/rn-tooltip.types.d.ts

@@ -0,0 +1,37 @@
+import type { ReactElement, ReactNode } from 'react';
+export type RnTooltipActionVariant = 'link' | 'primary' | 'secondary';
+export type RnTooltipAction = {
+    label: string;
+    onPress: () => void;
+    /** `link` by default — an underlined text. `primary`/`secondary` are small filled/outlined buttons. */
+    variant?: RnTooltipActionVariant;
+};
+/** `outside`: a touch outside the bubble. `anchorHidden`: the anchor's centre left the visible area. */
+export type RnTooltipDismissReason = 'anchorHidden' | 'outside';
+/**
+ * A rich tooltip — title, message, actions — anchored below a React Native view, and drawn above every sibling.
+ * Controlled: it never hides itself. `onDismiss` reports why it should, and the caller turns `visible` off. The React
+ * Native tier, unlike `Tooltip`, whose anchor is a native view inside a host.
+ */
+export type RnTooltipProps = {
+    actions?: RnTooltipAction[];
+    /** Which end of the bubble the actions sit at. `end` by default. */
+    actionsAlignment?: 'end' | 'start';
+    /**
+     * Insets from the window's top and bottom that the anchor's centre must stay inside — a header or a tab bar over the
+     * content. Past them the tooltip asks to be dismissed with `anchorHidden`.
+     */
+    boundaryInsets?: {
+        bottom?: number;
+        top?: number;
+    };
+    /** The anchor — a single React Native view. */
+    children: ReactElement;
+    message?: string;
+    onDismiss: (reason: RnTooltipDismissReason) => void;
+    /** The appear animation finished. */
+    onShown?: () => void;
+    title?: string;
+    visible: boolean;
+};
+export type RnTooltipComponent = (props: RnTooltipProps) => ReactNode;

package/lib/typescript/molecules/scroll-edge-container/index.d.ts

@@ -0,0 +1,3 @@
+export { isScrollEdgeEffectAvailable } from '@hzblj/kara-native';
+export * from './scroll-edge-container';
+export * from './scroll-edge-container.types';

package/lib/typescript/molecules/scroll-edge-container/scroll-edge-container.d.ts

@@ -0,0 +1 @@
+export * from './scroll-edge-container.ios';

package/lib/typescript/molecules/scroll-edge-container/scroll-edge-container.ios.d.ts

@@ -0,0 +1,6 @@
+import type { ScrollEdgeContainerComponent } from './scroll-edge-container.types';
+/**
+ * Below iOS 26 the native container still lays the bars out as insets, just without the effect — so a bar wants a
+ * background of its own there; `isScrollEdgeEffectAvailable()` says which case applies.
+ */
+export declare const ScrollEdgeContainer: ScrollEdgeContainerComponent;

package/lib/typescript/molecules/scroll-edge-container/scroll-edge-container.types.d.ts

@@ -0,0 +1,26 @@
+import type { ScrollEdgeEffect, ScrollEdgeScrollableProps } from '@hzblj/kara-native/swift-ui';
+import type { ResponsiveViewSx } from '@hzblj/kara-sx';
+import type { ReactElement, ReactNode } from 'react';
+export type { ScrollEdgeEffect, ScrollEdgeScrollableProps } from '@hzblj/kara-native/swift-ui';
+/**
+ * Bars over one React Native scroll view, with the iOS 26 scroll edge effect under them — the system's progressive
+ * blur where content scrolls past a bar. The React Native tier: it needs no host.
+ *
+ * A screen-level container: wrap the screen's scroll view with it. Mounted inside a cell of a virtualized list on iOS
+ * it draws only its bottom bar — the hosted scroll view and the top bar stay blank.
+ */
+export type ScrollEdgeContainerProps = ResponsiveViewSx & {
+    /**
+     * iOS: adds the bars' heights to the scroll view's own `contentInset` and starts it at the top of that inset, so the
+     * content begins below the top bar and scrolls under it. On by default.
+     */
+    automaticInsets?: boolean;
+    bottomBar?: ReactNode;
+    /** Exactly one React Native scroll view — `RnScrollView`, `RnFlatList`, `RnSectionList`. */
+    children: ReactElement<ScrollEdgeScrollableProps>;
+    /** iOS 26: how hard the edge cuts. `soft` by default. */
+    effect?: ScrollEdgeEffect;
+    testID?: string;
+    topBar?: ReactNode;
+};
+export type ScrollEdgeContainerComponent = (props: ScrollEdgeContainerProps) => ReactNode;

package/lib/typescript/molecules/search-bar/index.d.ts

@@ -0,0 +1,2 @@
+export * from './search-bar';
+export * from './search-bar.types';

package/lib/typescript/molecules/search-bar/search-bar.d.ts

@@ -0,0 +1,2 @@
+import type { SearchBarComponent } from './search-bar.types';
+export declare const SearchBar: SearchBarComponent;

package/lib/typescript/molecules/search-bar/search-bar.types.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+export type SearchBarProps = {
+    onChangeText?: (text: string) => void;
+    placeholder?: string;
+    testID?: string;
+    value: string;
+};
+export type SearchBarComponent = (props: SearchBarProps) => ReactNode;

package/lib/typescript/molecules/stepper/index.d.ts

@@ -0,0 +1,2 @@
+export * from './stepper';
+export * from './stepper.types';

package/lib/typescript/molecules/stepper/stepper.d.ts

@@ -0,0 +1 @@
+export * from './stepper.ios';

package/lib/typescript/molecules/stepper/stepper.ios.d.ts

@@ -0,0 +1,2 @@
+import type { StepperComponent } from './stepper.types';
+export declare const Stepper: StepperComponent;

package/lib/typescript/molecules/stepper/stepper.types.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from 'react';
+export type StepperProps = {
+    label: string;
+    max?: number;
+    min?: number;
+    onValueChange: (value: number) => void;
+    step?: number;
+    value: number;
+};
+export type StepperComponent = (props: StepperProps) => ReactNode;

package/lib/typescript/molecules/tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export * from './tooltip';
+export * from './tooltip.types';

package/lib/typescript/molecules/tooltip/tooltip.d.ts

@@ -0,0 +1 @@
+export * from './tooltip.ios';

package/lib/typescript/molecules/tooltip/tooltip.ios.d.ts

@@ -0,0 +1,2 @@
+import type { TooltipComponent } from './tooltip.types';
+export declare const Tooltip: TooltipComponent;

package/lib/typescript/molecules/tooltip/tooltip.types.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+export type TooltipProps = {
+    children: ReactNode;
+    text: string;
+    visible: boolean;
+    onDismiss: () => void;
+};
+export type TooltipComponent = (props: TooltipProps) => ReactNode;

package/lib/typescript/organisms/action-sheet/action-sheet.d.ts

@@ -0,0 +1 @@
+export * from './action-sheet.ios';

package/lib/typescript/organisms/action-sheet/action-sheet.ios.d.ts

@@ -0,0 +1,2 @@
+import type { ActionSheetComponent } from './action-sheet.types';
+export declare const ActionSheet: ActionSheetComponent;

package/lib/typescript/organisms/action-sheet/action-sheet.types.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from 'react';
+import type { MenuAction } from '../menu';
+export type ActionSheetProps = {
+    actions: MenuAction[];
+    onDismiss: () => void;
+    title: string;
+    visible: boolean;
+};
+export type ActionSheetComponent = (props: ActionSheetProps) => ReactNode;

package/lib/typescript/organisms/action-sheet/index.d.ts

@@ -0,0 +1,2 @@
+export * from './action-sheet';
+export * from './action-sheet.types';

package/lib/typescript/organisms/alert/alert.d.ts

@@ -0,0 +1 @@
+export * from './alert.ios';

package/lib/typescript/organisms/alert/alert.ios.d.ts

@@ -0,0 +1,2 @@
+import type { AlertComponent } from './alert.types';
+export declare const Alert: AlertComponent;

package/lib/typescript/organisms/alert/alert.types.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from 'react';
+export type AlertProps = {
+    confirmLabel?: string;
+    destructive?: boolean;
+    message?: string;
+    onConfirm?: () => void;
+    onDismiss: () => void;
+    title: string;
+    visible: boolean;
+};
+export type AlertComponent = (props: AlertProps) => ReactNode;

package/lib/typescript/organisms/alert/index.d.ts

@@ -0,0 +1,2 @@
+export * from './alert';
+export * from './alert.types';

package/lib/typescript/organisms/context-menu/context-menu.d.ts

@@ -0,0 +1 @@
+export * from './context-menu.ios';

package/lib/typescript/organisms/context-menu/context-menu.ios.d.ts

@@ -0,0 +1,2 @@
+import type { ContextMenuComponent } from './context-menu.types';
+export declare const ContextMenu: ContextMenuComponent;

package/lib/typescript/organisms/context-menu/context-menu.types.d.ts

@@ -0,0 +1,33 @@
+import type { ResponsiveViewSx } from '@hzblj/kara-sx';
+import type { ReactNode } from 'react';
+import type { MenuAction } from '../menu';
+/**
+ * A context menu on a React Native subtree — a card in a list, say — opened by a long press. iOS: a
+ * `UIContextMenuInteraction`, with an optional React Native `preview` lifted while the menu is open and a callback for
+ * a tap on it. Android: a Material dropdown under the subtree. The trigger is ordinary React Native layout, so it
+ * needs no `Screen` or `Island`.
+ */
+export type ContextMenuProps = ResponsiveViewSx & {
+    actions: MenuAction[];
+    /** The trigger, laid out as usual. */
+    children: ReactNode;
+    /** iOS: the user tapped the lifted preview, committing to it — open the detail the card stands for. */
+    onPreviewPress?: () => void;
+    /**
+     * iOS: lifted in place of the trigger while the menu is open — a larger version of the card, say. A snapshot of the
+     * trigger when unset. Mounted only once a finger has rested on the trigger, so a list of cards does not pay for
+     * every preview up front.
+     */
+    preview?: ReactNode;
+    testID?: string;
+};
+export type ContextMenuExclusionProps = {
+    children: ReactNode;
+};
+export type ContextMenuComponent = ((props: ContextMenuProps) => ReactNode) & {
+    /**
+     * A region of the trigger that must not open the menu — a button inside the card. On iOS the interaction covers the
+     * whole trigger, so a long press on that button would otherwise open the card's menu.
+     */
+    Exclusion: (props: ContextMenuExclusionProps) => ReactNode;
+};

package/lib/typescript/organisms/context-menu/index.d.ts

@@ -0,0 +1,2 @@
+export * from './context-menu';
+export * from './context-menu.types';

package/lib/typescript/organisms/fab-menu/fab-menu.d.ts

@@ -0,0 +1 @@
+export * from './fab-menu.ios';

package/lib/typescript/organisms/fab-menu/fab-menu.ios.d.ts

@@ -0,0 +1,2 @@
+import type { FabMenuComponent } from './fab-menu.types';
+export declare const FabMenu: FabMenuComponent;

package/lib/typescript/organisms/fab-menu/fab-menu.types.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from 'react';
+import type { IconName } from '../../atoms/icon';
+import type { MenuAction } from '../menu';
+/**
+ * A floating action button that unfolds into its actions. Android: Material 3 Expressive's `FloatingActionButtonMenu`
+ * — the button turns into a close and the actions rise above it as labelled pills. iOS: the same button as the label
+ * of a SwiftUI `Menu`. A native atom — it renders inside `<Screen>` or `<Island>`.
+ */
+export type FabMenuProps = {
+    actions: MenuAction[];
+    /** The closed button's icon — one of the app's. A plus by default. */
+    icon?: IconName;
+    testID?: string;
+};
+export type FabMenuComponent = (props: FabMenuProps) => ReactNode;

package/lib/typescript/organisms/fab-menu/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fab-menu';
+export * from './fab-menu.types';

package/lib/typescript/organisms/form/form.d.ts

@@ -0,0 +1 @@
+export * from './form.ios';

package/lib/typescript/organisms/form/form.ios.d.ts

@@ -0,0 +1,2 @@
+import type { FormComponent } from './form.types';
+export declare const Form: FormComponent;

package/lib/typescript/organisms/form/form.types.d.ts

@@ -0,0 +1,18 @@
+import type { ReactNode } from 'react';
+/**
+ * A settings form — SwiftUI `Form` with its grouped sections, Material cards on Android. On iOS it scrolls like a
+ * `List`, so it needs a height from outside: a `Screen`, or an `Island` with `matchContents={false}` and a height. In
+ * an island that sizes itself to its content it has no height and shows nothing.
+ */
+export type FormProps = {
+    children: ReactNode;
+    testID?: string;
+};
+export type FormSectionProps = {
+    children: ReactNode;
+    footer?: string;
+    title?: string;
+};
+export type FormComponent = ((props: FormProps) => ReactNode) & {
+    Section: (props: FormSectionProps) => ReactNode;
+};

package/lib/typescript/organisms/form/index.d.ts

@@ -0,0 +1,2 @@
+export * from './form';
+export * from './form.types';

package/lib/typescript/organisms/index.d.ts

@@ -0,0 +1,9 @@
+export * from './action-sheet';
+export * from './alert';
+export * from './context-menu';
+export * from './fab-menu';
+export * from './form';
+export * from './menu';
+export * from './sheet';
+export * from './snackbar';
+export * from './swipe-actions';

package/lib/typescript/organisms/menu/index.d.ts

@@ -0,0 +1,2 @@
+export * from './menu';
+export * from './menu.types';

package/lib/typescript/organisms/menu/menu.d.ts

@@ -0,0 +1 @@
+export * from './menu.ios';

package/lib/typescript/organisms/menu/menu.ios.d.ts

@@ -0,0 +1,2 @@
+import type { MenuComponent } from './menu.types';
+export declare const Menu: MenuComponent;

package/lib/typescript/organisms/menu/menu.types.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from 'react';
+import type { IconName } from '../../atoms/icon';
+export type MenuAction = {
+    destructive?: boolean;
+    icon?: IconName;
+    label: string;
+    onPress: () => void;
+};
+export type MenuProps = {
+    actions: MenuAction[];
+    label: string;
+};
+export type MenuComponent = (props: MenuProps) => ReactNode;

package/lib/typescript/organisms/sheet/index.d.ts

@@ -0,0 +1,2 @@
+export * from './sheet';
+export * from './sheet.types';

package/lib/typescript/organisms/sheet/sheet.d.ts

@@ -0,0 +1 @@
+export * from './sheet.ios';

package/lib/typescript/organisms/sheet/sheet.ios.d.ts

@@ -0,0 +1,2 @@
+import type { SheetComponent } from './sheet.types';
+export declare const Sheet: SheetComponent;

package/lib/typescript/organisms/sheet/sheet.types.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+export type SheetProps = {
+    children: ReactNode;
+    fitToContents?: boolean;
+    onDismiss: () => void;
+    visible: boolean;
+};
+export type SheetComponent = (props: SheetProps) => ReactNode;

package/lib/typescript/organisms/snackbar/index.d.ts

@@ -0,0 +1,2 @@
+export * from './snackbar';
+export * from './snackbar.types';

package/lib/typescript/organisms/snackbar/snackbar.d.ts

@@ -0,0 +1,2 @@
+import type { SnackbarComponent } from './snackbar.types';
+export declare const Snackbar: SnackbarComponent;

package/lib/typescript/organisms/snackbar/snackbar.types.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+export type SnackbarProps = {
+    actionLabel?: string;
+    message: string;
+    onAction?: () => void;
+    visible: boolean;
+};
+export type SnackbarComponent = (props: SnackbarProps) => ReactNode;

package/lib/typescript/organisms/swipe-actions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './swipe-actions';
+export * from './swipe-actions.types';

package/lib/typescript/organisms/swipe-actions/swipe-actions.d.ts

@@ -0,0 +1 @@
+export * from './swipe-actions.ios';

package/lib/typescript/organisms/swipe-actions/swipe-actions.ios.d.ts

@@ -0,0 +1,2 @@
+import type { SwipeActionsComponent } from './swipe-actions.types';
+export declare const SwipeActions: SwipeActionsComponent;

package/lib/typescript/organisms/swipe-actions/swipe-actions.types.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+export type SwipeActionsEdge = 'leading' | 'trailing';
+/**
+ * Swipe-to-reveal buttons on a row. iOS only — Compose ships no equivalent, so on Android the
+ * row renders exactly as it would without this wrapper and the action buttons are dropped.
+ * Degrading that way rather than to `null` keeps the content on screen.
+ */
+export type SwipeActionsProps = {
+    children: ReactNode;
+    testID?: string;
+};
+export type SwipeActionsGroupProps = {
+    /** Whether swiping all the way performs the first action in the group. */
+    allowsFullSwipe?: boolean;
+    children: ReactNode;
+    edge?: SwipeActionsEdge;
+};
+export type SwipeActionsComponent = ((props: SwipeActionsProps) => ReactNode) & {
+    Actions: (props: SwipeActionsGroupProps) => ReactNode;
+};

package/lib/typescript/platform-support.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Announces an atom that only one platform can implement. The stub still satisfies the shared
+ * component type, so `contract.check.ts` keeps both files honest — this just makes the gap loud
+ * in dev instead of leaving a control that mysteriously never appears.
+ *
+ * Warns once per atom: the gap is permanent, so repeating it every render would be noise.
+ */
+export declare const warnUnsupported: (atom: string, platform: 'Android' | 'iOS') => void;

package/lib/typescript/templates/index.d.ts

@@ -0,0 +1 @@
+export * from './screen';

package/lib/typescript/templates/screen/index.d.ts

@@ -0,0 +1,2 @@
+export * from './screen';
+export * from './screen.types';

package/lib/typescript/templates/screen/screen.d.ts

@@ -0,0 +1 @@
+export * from './screen.ios';

package/lib/typescript/templates/screen/screen.ios.d.ts

@@ -0,0 +1,2 @@
+import type { ScreenComponent } from './screen.types';
+export declare const Screen: ScreenComponent;

package/lib/typescript/templates/screen/screen.types.d.ts

@@ -0,0 +1,9 @@
+import type { Sx } from '@hzblj/kara-sx';
+import type { ReactNode } from 'react';
+export type ScreenProps = {
+    bg?: Sx['bg'];
+    children?: ReactNode;
+    ignoreKeyboardInset?: boolean;
+    testID?: string;
+};
+export type ScreenComponent = (props: ScreenProps) => ReactNode;

package/lib/typescript/use-refresh-state.d.ts

@@ -0,0 +1,15 @@
+export type RefreshState = {
+    isRefreshing: boolean;
+    refresh: () => void;
+};
+/**
+ * Bridges the two platforms' opposite takes on pull-to-refresh so both can expose one async
+ * `onRefresh`. SwiftUI's `refreshable` takes the promise and spins until it settles, so iOS hands the
+ * handler straight over; Compose's `PullToRefreshBox` is controlled and keeps spinning until
+ * `isRefreshing` goes false, which is the flag this derives.
+ *
+ * Errors are left to the caller: `Promise.resolve().then` turns even a synchronous throw into a
+ * rejection the caller still sees, while `finally` stops the spinner either way. Swallowing it here
+ * would leave a failed refresh looking like a successful one.
+ */
+export declare const useRefreshState: (onRefresh: (() => Promise<void>) | undefined) => RefreshState;