pixelize-native-library 1.2.1 → 1.3.0

package/lib/typescript/modules/pin-input/PinInput.variants.d.ts

@@ -13,13 +13,13 @@
  * Free of React and of any `TextInput`/`Pressable` 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 PinInputSize = "sm" | "md" | "lg";
 /** A validity state, not a brand tone — same reasoning as `InputStatus`. */
 export type PinInputStatus = "default" | "error";
 export type PinInputKeyboardType = "number-pad" | "default";
-/** Same floor as Button/Input — 44dp (WCAG 2.5.5 / HIG). Duplicated, not imported: modules stay isolated. */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface PinInputSizeSpec {
     /** Visual box width/height in dp (boxes are square). */
     readonly boxSize: number;

package/lib/typescript/modules/pin-input/PinInputProps.d.ts

@@ -0,0 +1,26 @@
+import type { LayoutStyle } from "../../core/style";
+import type { PinInputKeyboardType, PinInputSize, PinInputStatus } from "./PinInput.variants";
+/** OTP-style multi-box code entry, backed by one hidden `TextInput`. */
+export interface PinInputProps {
+    /** Number of boxes / max code length. */
+    length?: number;
+    value: string;
+    onValueChange: (value: string) => void;
+    /** Fires once per completion, not on every re-render while already full. */
+    onComplete?: (value: string) => void;
+    /** Masks each box as a dot and the announced value — mirrors `secureTextEntry` semantics. */
+    secureTextEntry?: boolean;
+    keyboardType?: PinInputKeyboardType;
+    status?: PinInputStatus;
+    /** Shown below the row and folded into the accessible name when `status` is "error". */
+    errorText?: string;
+    disabled?: boolean;
+    size?: PinInputSize;
+    autoFocus?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+    /** Required — the field has no visible label (e.g. "6-digit verification code"). */
+    accessibilityLabel: string;
+}
+//# sourceMappingURL=PinInputProps.d.ts.map

package/lib/typescript/modules/pin-input/index.d.ts

@@ -5,6 +5,6 @@
  * by importing its internals.
  */
 export { PinInput } from "./PinInput";
-export type { PinInputProps } from "./PinInput";
+export type { PinInputProps } from "./PinInputProps";
 export type { PinInputKeyboardType, PinInputSize, PinInputStatus } from "./PinInput.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/plan-badge/PlanBadge.d.ts

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

package/lib/typescript/modules/plan-badge/PlanBadgeProps.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutStyle } from "../../core/style";
+/** Closed subscription tier labels for plan chrome. */
+export type PlanBadgeTier = "free" | "pro" | "enterprise";
+/** Small tier badge ("Free"/"Pro"/"Enterprise"); for pill-shaped "plan" copy, see `PlanPill`. */
+export interface PlanBadgeProps {
+    tier: PlanBadgeTier;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=PlanBadgeProps.d.ts.map

package/lib/typescript/modules/plan-badge/index.d.ts

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

package/lib/typescript/modules/plan-pill/PlanPill.d.ts

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

package/lib/typescript/modules/plan-pill/PlanPillProps.d.ts

@@ -0,0 +1,10 @@
+import type { LayoutStyle } from "../../core/style";
+import type { PlanBadgeTier } from "../plan-badge/PlanBadgeProps";
+/** Pill tier indicator ("Free plan"/"Pro plan"/"Enterprise"); for the badge variant, see `PlanBadge`. */
+export interface PlanPillProps {
+    /** Also drives the chip's `selected` (highlighted) styling for any tier but free. */
+    tier: PlanBadgeTier;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=PlanPillProps.d.ts.map

package/lib/typescript/modules/plan-pill/index.d.ts

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

package/lib/typescript/modules/progress-bar/ProgressBar.d.ts

@@ -8,18 +8,6 @@
  * the native driver, and a per-frame width would force a layout pass. `transformOrigin: "left"`
  * anchors the growth so the fill does not expand from its centre.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { ProgressBarSize, ProgressBarTone } from "./ProgressBar.variants";
-export interface ProgressBarProps {
-    /** 0–100. Omit for an indeterminate sweep. */
-    value?: number;
-    tone?: ProgressBarTone;
-    /** Closed union — drives the track (and fill) height. */
-    size?: ProgressBarSize;
-    accessibilityLabel?: string;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { ProgressBarProps } from "./ProgressBarProps";
 export declare const ProgressBar: import("react").NamedExoticComponent<ProgressBarProps>;
 //# sourceMappingURL=ProgressBar.d.ts.map

package/lib/typescript/modules/progress-bar/ProgressBarProps.d.ts

@@ -0,0 +1,16 @@
+import type { LayoutStyle } from "../../core/style";
+import type { ProgressBarSize, ProgressBarTone } from "./ProgressBar.variants";
+/** Linear progress indicator; omit `value` for an indeterminate looping sweep. */
+export interface ProgressBarProps {
+    /** 0–100. Omit for an indeterminate sweep. */
+    value?: number;
+    /** Defaults to "accent". */
+    tone?: ProgressBarTone;
+    /** Closed union — drives the track (and fill) height. */
+    size?: ProgressBarSize;
+    accessibilityLabel?: string;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=ProgressBarProps.d.ts.map

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

@@ -6,6 +6,6 @@
  * No `icon` prop, so no `IconName` re-export (same as `Spinner`/`Switch`).
  */
 export { ProgressBar } from "./ProgressBar";
-export type { ProgressBarProps } from "./ProgressBar";
+export type { ProgressBarProps } from "./ProgressBarProps";
 export type { ProgressBarSize, ProgressBarTone } from "./ProgressBar.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/radio-group/RadioGroup.d.ts

@@ -7,27 +7,7 @@
  * No animation anywhere (the dot appears/disappears by conditional render, not a fade or a move),
  * so there is nothing for `useReducedMotion` (WCAG 2.3.3) to gate — unlike Button's press fade.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { RadioGroupSize } from "./RadioGroup.variants";
-export interface RadioGroupOption {
-    readonly label: string;
-    readonly value: string;
-}
-export interface RadioGroupProps {
-    options: RadioGroupOption[];
-    value: string;
-    onValueChange: (value: string) => void;
-    disabled?: boolean;
-    size?: RadioGroupSize;
-    /**
-     * Names the group itself. Without it the `radiogroup` container is announced unnamed, so a reader
-     * hears each option's own label with nothing saying what the set of options is FOR (WCAG 1.3.1) —
-     * the rows carry their labels, the container carried none.
-     */
-    accessibilityLabel?: string;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { RadioGroupProps } from "./RadioGroupProps";
+export type { RadioGroupOption, RadioGroupProps } from "./RadioGroupProps";
 export declare const RadioGroup: import("react").NamedExoticComponent<RadioGroupProps>;
 //# sourceMappingURL=RadioGroup.d.ts.map

package/lib/typescript/modules/radio-group/RadioGroup.variants.d.ts

@@ -7,10 +7,10 @@
  *  - `resolveRadioRowAccessibility` derives the per-row a11y surface purely, so the
  *    "selected"/"disabled" contract is unit-testable without rendering React Native.
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 export type RadioGroupSize = "sm" | "md";
-/** Same floor as Button — Apple HIG minimum and WCAG 2.5.5 (AAA). */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface RadioGroupSizeSpec {
     /** Visual row height in dp. */
     readonly rowMinHeight: number;

package/lib/typescript/modules/radio-group/RadioGroupProps.d.ts

@@ -0,0 +1,21 @@
+import type { LayoutStyle } from "../../core/style";
+import type { RadioGroupSize } from "./RadioGroup.variants";
+/** One radio row's value and label. */
+export interface RadioGroupOption {
+    readonly label: string;
+    readonly value: string;
+}
+/** A single-select group of radio rows. */
+export interface RadioGroupProps {
+    options: RadioGroupOption[];
+    value: string;
+    onValueChange: (value: string) => void;
+    disabled?: boolean;
+    size?: RadioGroupSize;
+    /** Names the group; without it the container announces unnamed to assistive tech. */
+    accessibilityLabel?: string;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=RadioGroupProps.d.ts.map

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

@@ -5,6 +5,6 @@
  * never by importing its internals.
  */
 export { RadioGroup } from "./RadioGroup";
-export type { RadioGroupProps, RadioGroupOption } from "./RadioGroup";
+export type { RadioGroupProps, RadioGroupOption } from "./RadioGroupProps";
 export type { RadioGroupSize } from "./RadioGroup.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/reorder/Reorder.d.ts

@@ -31,18 +31,6 @@
  * 4.1.3): the accessible buttons already move the list, but without this the new order was
  * observable only by sight, which defeated the point of having them.
  */
-import type { LayoutStyle } from "../../core/style";
-export interface ReorderItem {
-    readonly id: string;
-    readonly label: string;
-}
-export interface ReorderProps {
-    items: ReorderItem[];
-    onReorder: (next: ReorderItem[]) => void;
-    disabled?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { ReorderProps } from "./ReorderProps";
 export declare const Reorder: import("react").NamedExoticComponent<ReorderProps>;
 //# sourceMappingURL=Reorder.d.ts.map

package/lib/typescript/modules/reorder/Reorder.variants.d.ts

@@ -13,15 +13,15 @@
  * Free of React and of any lucide import, so the WCAG + behaviour tests import it directly (mocking
  * only `react-native`'s `StyleSheet`, as `core/style` and every sibling module's tests do).
  */
+import { MIN_TOUCH_TARGET } from "../../core/a11y/touchTarget";
 import type { RoleColors, Theme } from "../../theme/hooks";
+export { MIN_TOUCH_TARGET };
 /**
  * Fixed row height, in dp. A fixed height — rather than per-row `onLayout` measurement — is what
  * lets the drag math below be a closed-form `dy ÷ rowHeight`, never an async-measured guess (the
  * build brief's own preference: "a fixed height is simpler and more robust here").
  */
 export declare const REORDER_ROW_HEIGHT = 56;
-/** The 44dp floor every touch target holds itself to (WCAG 2.5.5 AAA; comfortably clears 2.5.8). */
-export declare const MIN_TOUCH_TARGET = 44;
 /** Grip bar glyph — three of these stacked make the drag-handle affordance. No `IconName` in the
  *  closed 22-name set represents a drag handle, and that set is never extended for one component
  *  (per the build brief), so the grip is hand-built from plain themed bars instead. */

package/lib/typescript/modules/reorder/ReorderProps.d.ts

@@ -0,0 +1,19 @@
+import type { LayoutStyle } from "../../core/style";
+/** One row's identity and label. */
+export interface ReorderItem {
+    readonly id: string;
+    readonly label: string;
+}
+/** Configuration for the drag-to-reorder list. */
+export interface ReorderProps {
+    /** Fully controlled — never mutated internally; commit the reordered array from `onReorder`. */
+    items: ReorderItem[];
+    /** Called on drag release or a move-button press, with the full reordered array. */
+    onReorder: (next: ReorderItem[]) => void;
+    /** Disables both dragging and the up/down move buttons. */
+    disabled?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=ReorderProps.d.ts.map

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

@@ -5,5 +5,5 @@
  * never by importing its internals.
  */
 export { Reorder } from "./Reorder";
-export type { ReorderProps, ReorderItem } from "./Reorder";
+export type { ReorderProps, ReorderItem } from "./ReorderProps";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/rich-text/RichText.d.ts

@@ -1,15 +1,7 @@
 /**
  * RichText — read-only safe HTML renderer. Ported from tickets/mobile RichText.tsx.
  */
-import type { LayoutStyle } from "../../core/style";
-export interface RichTextProps {
-    html: string;
-    numberOfLines?: number;
-    onLinkPress?: (url: string) => void;
-    onImagePress?: (src: string) => void;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { RichTextProps } from "./RichTextProps";
+export type { RichTextProps } from "./RichTextProps";
 export declare const RichText: import("react").NamedExoticComponent<RichTextProps>;
 //# sourceMappingURL=RichText.d.ts.map

package/lib/typescript/modules/rich-text/RichTextProps.d.ts

@@ -0,0 +1,15 @@
+import type { LayoutStyle } from "../../core/style";
+/** A read-only renderer for sanitized HTML. */
+export interface RichTextProps {
+    html: string;
+    /** Renders flattened inline text instead of blocks, truncated to this many lines. */
+    numberOfLines?: number;
+    /** Overrides the default of opening the link via `Linking.openURL`. */
+    onLinkPress?: (url: string) => void;
+    /** Fires when an image placeholder is pressed; without it, images aren't pressable. */
+    onImagePress?: (src: string) => void;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=RichTextProps.d.ts.map

package/lib/typescript/modules/rich-text/index.d.ts

@@ -1,5 +1,5 @@
 export { RichText } from "./RichText";
-export type { RichTextProps } from "./RichText";
+export type { RichTextProps } from "./RichTextProps";
 export { decodeEntities, isElement, isSafeUrl, parseRichText, stripHtmlToText, textContent, } from "./parseRichText";
 export type { ElementNode, HtmlNode, TextNode } from "./parseRichText";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/rich-text-editor/RichTextEditor.d.ts

@@ -13,50 +13,6 @@
  * Toolbar toggle highlighting is driven by the native `onChangeState` event (bold/italic/… active
  * state as the cursor moves) — see `RichTextEditor.variants.ts` → `resolveRichTextEditorActiveActions`.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { MentionUser, RichTextEditorImage } from "./RichTextEditor.variants";
-export interface RichTextEditorHandle {
-    /** Reads the editor's current content as HTML. Async — the native layer parses on demand. */
-    getHTML: () => Promise<string>;
-    focus: () => void;
-    blur: () => void;
-    /** Replaces the entire editor content — for the rare case the parent resets it (e.g. loading a
-     *  template). Not a live sync mechanism; this is UNCONTROLLED between calls. */
-    setValue: (html: string) => void;
-}
-export interface RichTextEditorProps {
-    /** Initial HTML/text. Never re-applied on change — see the module header. */
-    defaultValue?: string;
-    placeholder?: string;
-    /** Rendered above the toolbar. Also becomes the editor field's accessible name unless one is
-     *  passed explicitly. */
-    label?: string;
-    /** Overrides the label→field accessible-name fallback. */
-    accessibilityLabel?: string;
-    /** Minimum editor height, in dp. */
-    minHeight?: number;
-    /** Candidate users for `@` mentions. Empty/omitted disables mentions gracefully (no `@` trigger
-     *  wired, no mention toolbar button rendered). */
-    mentionUsers?: MentionUser[];
-    /** Supplies an image to insert at the caret. Omitted/undefined hides the image toolbar button
-     *  entirely — the same "disables gracefully" contract `mentionUsers` has. The consumer owns
-     *  picking, uploading and any failure message; resolve `null` for a cancel or a failure, and a
-     *  rejection is caught here so the toolbar recovers with nothing inserted. */
-    onRequestImage?: () => Promise<RichTextEditorImage | null>;
-    /** Fires on every keystroke with the plain text — a cheap dirty-signal, not the HTML. */
-    onChangeText?: (text: string) => void;
-    onFocus?: () => void;
-    onBlur?: () => void;
-    editable?: boolean;
-    /** Off by default: while on, Android's `canScrollVertically` returns it verbatim, so the editor
-     *  claims every drag instead of releasing it to the page `ScrollView`. Enable only with a bounded height. */
-    scrollEnabled?: boolean;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    containerStyle?: LayoutStyle;
-    /** Normalizes arbitrary incoming HTML (Word/Google Docs/foreign markup) into the native editor's
-     *  canonical tag subset before it's applied. Off by default, matching the native library. */
-    useHtmlNormalizer?: boolean;
-    testID?: string;
-}
+import type { RichTextEditorHandle, RichTextEditorProps } from "./RichTextEditorProps";
 export declare const RichTextEditor: import("react").NamedExoticComponent<RichTextEditorProps & import("react").RefAttributes<RichTextEditorHandle>>;
 //# sourceMappingURL=RichTextEditor.d.ts.map

package/lib/typescript/modules/rich-text-editor/RichTextEditorProps.d.ts

@@ -0,0 +1,40 @@
+import type { LayoutStyle } from "../../core/style";
+import type { MentionUser, RichTextEditorImage } from "./RichTextEditor.variants";
+/** Imperative ref API — the editor is otherwise uncontrolled between renders. */
+export interface RichTextEditorHandle {
+    /** Reads the editor's current HTML; async, parsed on demand by the native layer. */
+    getHTML: () => Promise<string>;
+    focus: () => void;
+    blur: () => void;
+    /** Replaces the entire content; not a live sync — the editor stays uncontrolled. */
+    setValue: (html: string) => void;
+}
+/** Themed wrapper around the native Fabric `EnrichedTextInput`, with toolbar and mentions. */
+export interface RichTextEditorProps {
+    /** Initial HTML/text. Never re-applied on change — see the module header. */
+    defaultValue?: string;
+    placeholder?: string;
+    /** Rendered above the toolbar; also the field's accessible name unless overridden. */
+    label?: string;
+    /** Overrides the label→field accessible-name fallback. */
+    accessibilityLabel?: string;
+    /** Minimum editor height, in dp. */
+    minHeight?: number;
+    /** Candidate users for `@` mentions; empty/omitted disables mentions entirely. */
+    mentionUsers?: MentionUser[];
+    /** Omitted hides the image button; resolve null on cancel or failure. */
+    onRequestImage?: () => Promise<RichTextEditorImage | null>;
+    /** Fires every keystroke with plain text — a cheap dirty-signal, not the HTML. */
+    onChangeText?: (text: string) => void;
+    onFocus?: () => void;
+    onBlur?: () => void;
+    editable?: boolean;
+    /** Off by default — enabling lets the editor claim scroll gestures from the page. */
+    scrollEnabled?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    containerStyle?: LayoutStyle;
+    /** Normalizes pasted HTML (Word/Docs/foreign markup) before applying it. Off by default. */
+    useHtmlNormalizer?: boolean;
+    testID?: string;
+}
+//# sourceMappingURL=RichTextEditorProps.d.ts.map

package/lib/typescript/modules/rich-text-editor/index.d.ts

@@ -3,7 +3,7 @@
  * split for `verbatimModuleSyntax`.
  */
 export { RichTextEditor } from "./RichTextEditor";
-export type { RichTextEditorHandle, RichTextEditorProps } from "./RichTextEditor";
+export type { RichTextEditorHandle, RichTextEditorProps } from "./RichTextEditorProps";
 export type { MentionUser, RichTextEditorImage, RichTextEditorToolbarAction, } from "./RichTextEditor.variants";
 export { RICH_TEXT_EDITOR_TOOLBAR_ITEMS } from "./RichTextEditor.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/save-bar/SaveBar.d.ts

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

package/lib/typescript/modules/save-bar/SaveBarProps.d.ts

@@ -0,0 +1,18 @@
+import type { LayoutStyle } from "../../core/style";
+/** Sticky save/discard bar for dirty forms. */
+export interface SaveBarProps {
+    /** Bar renders nothing when false. */
+    dirty: boolean;
+    onSave: () => void;
+    /** When set, shows a Discard button (disabled while `saving`). */
+    onDiscard?: () => void;
+    /** Defaults to "Save". */
+    saveLabel?: string;
+    /** Defaults to "Discard"; unused unless `onDiscard` is set. */
+    discardLabel?: string;
+    /** Shows a loading state on Save and disables Discard; defaults to false. */
+    saving?: boolean;
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=SaveBarProps.d.ts.map

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

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

package/lib/typescript/modules/screen/Screen.d.ts

@@ -2,29 +2,6 @@
  * Screen — a screen shell composing SafeArea, optional KeyboardAvoidingView, optional pull-to-refresh,
  * optional `appBar` slot with safe-area edge splitting, and async-state slots.
  */
-import type { ReactNode } from "react";
-import type { LayoutStyle } from "../../core/style";
-import type { ScreenEdge, ScreenState } from "./Screen.variants";
-export interface ScreenProps {
-    children?: ReactNode;
-    /** Top header slot — receives top safe-area inset; body omits `top` from `edges`. */
-    appBar?: ReactNode;
-    edges?: readonly ScreenEdge[];
-    padded?: boolean;
-    keyboardAvoiding?: boolean;
-    keyboardVerticalOffset?: number;
-    refreshing?: boolean;
-    onRefresh?: () => void;
-    state?: ScreenState;
-    /** Shown when `state="loading"`. Defaults to `<LoadingState />`. */
-    loading?: ReactNode;
-    /** Shown when `state="empty"`. Compose `EmptyState` here. */
-    empty?: ReactNode;
-    /** Shown when `state="error"`. Compose `ErrorState` here. */
-    error?: ReactNode;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { ScreenProps } from "./ScreenProps";
 export declare const Screen: import("react").NamedExoticComponent<ScreenProps>;
 //# sourceMappingURL=Screen.d.ts.map

package/lib/typescript/modules/screen/ScreenProps.d.ts

@@ -0,0 +1,35 @@
+import type { ReactNode } from "react";
+import type { LayoutStyle } from "../../core/style";
+import type { ScreenEdge, ScreenState } from "./Screen.variants";
+/** A screen shell with SafeArea, optional AppBar, pull-to-refresh, and async-state slots. */
+export interface ScreenProps {
+    children?: ReactNode;
+    /** Top header slot — receives top safe-area inset; body omits `top` from `edges`. */
+    appBar?: ReactNode;
+    /** Defaults to `["top"]`; body omits `top` when `appBar` is set. */
+    edges?: readonly ScreenEdge[];
+    /** Adds themed padding around the body. Defaults to false. */
+    padded?: boolean;
+    /** Wraps content in a KeyboardAvoidingView. Defaults to false. */
+    keyboardAvoiding?: boolean;
+    /** Passed to KeyboardAvoidingView; ignored unless `keyboardAvoiding` is set. */
+    keyboardVerticalOffset?: number;
+    /** Pull-to-refresh spinner state; paired with `onRefresh`. */
+    refreshing?: boolean;
+    /** Enables pull-to-refresh — the RefreshControl only renders when this is set. */
+    onRefresh?: () => void;
+    /** Selects which slot renders: loading, empty, error, or children. Defaults to "idle". */
+    state?: ScreenState;
+    /** Shown when `state="loading"`. Defaults to `<LoadingState />`. */
+    loading?: ReactNode;
+    /** Shown when `state="empty"`. Compose `EmptyState` here. */
+    empty?: ReactNode;
+    /** Shown when `state="error"`. Compose `ErrorState` here. */
+    error?: ReactNode;
+    /** Wires an Animated.ScrollView with a shared `scrollY` for `AppBar`'s `scrollEffect` when `appBar` is set. */
+    scrollLinked?: boolean;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=ScreenProps.d.ts.map

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

@@ -4,6 +4,6 @@
  * props, never by importing its internals.
  */
 export { Screen } from "./Screen";
-export type { ScreenProps } from "./Screen";
+export type { ScreenProps } from "./ScreenProps";
 export type { ScreenEdge, ScreenState } from "./Screen.variants";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/modules/search-bar/SearchBar.d.ts

@@ -15,33 +15,7 @@
  * no motion for `useReducedMotion` (WCAG 2.3.3) to gate. The one moving part on screen — the
  * `loading` spinner — is `Spinner`'s own, which already honours reduced motion internally.
  */
-import type { LayoutStyle } from "../../core/style";
-import type { SearchBarSize } from "./SearchBar.variants";
-export interface SearchBarProps {
-    value: string;
-    onChangeText: (text: string) => void;
-    placeholder?: string;
-    /** Fires on the keyboard's submit/search key. Any pending debounce is flushed first. */
-    onSubmit?: () => void;
-    /** Fires after the clear button (or "Cancel") empties the query. */
-    onClear?: () => void;
-    /** `0` (default) reports every keystroke. Above `0`, `onChangeText` is debounced by this many
-     *  milliseconds while the rendered text stays instant. */
-    debounceMs?: number;
-    /** Reveals a trailing "Cancel" text button once the field is focused. */
-    showCancel?: boolean;
-    cancelLabel?: string;
-    /** Swaps the leading `search` glyph for a `Spinner`. */
-    loading?: boolean;
-    autoFocus?: boolean;
-    disabled?: boolean;
-    size?: SearchBarSize;
-    /** Overrides the placeholder→name fallback, for a placeholder that reads as a prompt rather than
-     *  a name ("Search…" tells a screen-reader user nothing about WHAT is being searched). */
-    accessibilityLabel?: string;
-    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
-    style?: LayoutStyle;
-    testID?: string;
-}
+import type { SearchBarProps } from "./SearchBarProps";
+export type { SearchBarProps } from "./SearchBarProps";
 export declare const SearchBar: import("react").NamedExoticComponent<SearchBarProps>;
 //# sourceMappingURL=SearchBar.d.ts.map

package/lib/typescript/modules/search-bar/SearchBar.variants.d.ts

@@ -11,11 +11,10 @@
  * Free of React and of `lucide`, 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 SearchBarSize = "sm" | "md";
-/** Same floor as Button/Input/ButtonGroup — 44dp (WCAG 2.5.5 / HIG). Duplicated, not imported:
- * modules stay isolated. */
-export declare const MIN_TOUCH_TARGET = 44;
 export interface SearchBarSizeSpec {
     /** Visual field height in dp (fixed, not a minimum — the hitSlop math depends on it). */
     readonly height: number;

package/lib/typescript/modules/search-bar/SearchBarProps.d.ts

@@ -0,0 +1,30 @@
+import type { LayoutStyle } from "../../core/style";
+import type { SearchBarSize } from "./SearchBar.variants";
+/** A query field with the affordances every list screen re-implements. */
+export interface SearchBarProps {
+    value: string;
+    onChangeText: (text: string) => void;
+    /** Defaults to "Search". */
+    placeholder?: string;
+    /** Fires on the keyboard's submit/search key. Any pending debounce is flushed first. */
+    onSubmit?: () => void;
+    /** Fires after the clear button (or "Cancel") empties the query. */
+    onClear?: () => void;
+    /** `0` (default) reports every keystroke; above `0`, debounces `onChangeText` by this many ms. */
+    debounceMs?: number;
+    /** Reveals a trailing "Cancel" text button once the field is focused. */
+    showCancel?: boolean;
+    /** Defaults to "Cancel". */
+    cancelLabel?: string;
+    /** Swaps the leading `search` glyph for a `Spinner`. */
+    loading?: boolean;
+    autoFocus?: boolean;
+    disabled?: boolean;
+    size?: SearchBarSize;
+    /** Overrides the placeholder→name fallback, for a placeholder that isn't a name. */
+    accessibilityLabel?: string;
+    /** Layout-only, outermost, applied exactly once as the LAST entry in the root style array. */
+    style?: LayoutStyle;
+    testID?: string;
+}
+//# sourceMappingURL=SearchBarProps.d.ts.map