@forthtilliath/react-native-kit 0.19.0 → 0.21.0

package/README.md

@@ -213,6 +213,7 @@ import { PhotoPicker } from "@forthtilliath/react-native-kit/components/picker/P
 
 - `renderPreview(photoUri, saving)` replaces the square preview and the "Add a photo" placeholder (e.g. a round avatar with initials and a small camera badge); the press, permission and action sheet stay the same.
 - While `savePhoto` runs, the picker ignores presses (`saving` is `true`, `accessibilityState.busy`).
+- `onOpen()` fires when a press opens the camera/library choice — the place for a haptic tick (`onOpen={tapFeedback}`).
 - A failure (camera, picker or `savePhoto` rejecting) goes to `onError(error)`; without it, an alert says the photo was not saved (`labels.saveErrorTitle` / `saveErrorMessage`).
 
 ### `<PickerModal visible title items onSelect onClose />`
@@ -296,6 +297,25 @@ const repeat = usePressRepeat();
 />;
 ```
 
+### `useViewShare(options?)`
+
+Shares as an image a view rendered only for the capture (a scoreboard, a summary card): `share()` sets `capturing` to `true`, waits two frames for the screen to mount and draw the view attached to `ref`, then calls `shareViewAsImage`. A failure shows an alert with the error's message (French or English titles, `errorTitle` / `errorMessage` to override), or goes to `onError(error)`. A second `share()` while one runs is ignored. Takes `shareViewAsImage`'s options (`dialogTitle`…).
+
+```tsx
+import { useViewShare } from "@forthtilliath/react-native-kit/hooks/useViewShare";
+
+const ranking = useViewShare({ dialogTitle: "Partager le classement" });
+
+<Button title="Partager" onPress={() => void ranking.share()} />;
+{
+  ranking.capturing ? (
+    <View ref={ranking.ref} collapsable={false} style={offScreen}>
+      <RankingCard />
+    </View>
+  ) : null;
+}
+```
+
 ### `confirmDestructive(title, onConfirm, options?)`
 
 Generic destructive-action confirmation (title + message + Cancel/Confirm), for anything irreversible (delete, reset...). Ships with French defaults, or English ones with `{ locale: "en" }` (`message`, `cancelLabel`, `confirmLabel` all overridable).
@@ -382,20 +402,20 @@ const colors = Colors[useResolvedScheme()];
 
 Every component below has neutral default colors and a `styles` prop whose slots are each merged **after** their default (a partial override keeps the rest of the slot) — pass the app's palette there.
 
-| Component                                                               | Import path                         | What it is                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
-| ----------------------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `<BottomSheet visible onClose bottomInset?>`                            | `components/overlay/BottomSheet`    | Modal sliding up from the bottom, content scrollable past 85 % of the screen. Pass `useSafeAreaInsets().bottom` as `bottomInset` with Android edge-to-edge.                                                                                                                                                                                                                                                                                                         |
-| `<OptionsModal visible onClose options onSelect>`                       | `components/picker/OptionsModal`    | Centered popup listing `{ value, label }` options; a tap selects and closes.                                                                                                                                                                                                                                                                                                                                                                                        |
-| `<SelectField label valueLabel options onSelect>`                       | `components/picker/SelectField`     | Native-looking "select": captioned button + `OptionsModal` (styled through `styles.optionsModal`).                                                                                                                                                                                                                                                                                                                                                                  |
-| `<SegmentedToggle options value onChange label?>`                       | `components/picker/SegmentedToggle` | Row of equal-width buttons, one active (Calendar / List…), announced as a radio group; each option may carry a smaller `hint` line under its label.                                                                                                                                                                                                                                                                                                                 |
-| `<QuantityStepper value onChange label min? max?>`                      | `components/picker/QuantityStepper` | Whole-number counter `min…max` (`0…999`, negatives allowed with a negative `min`, `-Infinity`/`Infinity` for no bound): −/+ buttons moving by `step` (1; disabled at the bounds, `longPressStep` to jump on long press, or `repeatOnHold` to repeat faster and faster while held) and a numeric field; `onStep(value)` fires on each −/+ change (e.g. `onStep={tapFeedback}`), not on typing; screen-reader labels in French or English (`a11yLabels` to override). |
-| `<SwitchRow label description? value onChange>`                         | `components/settings/SwitchRow`     | Settings line "label + description + switch", the whole row pressable and read as one switch; `colors` for the track and thumb.                                                                                                                                                                                                                                                                                                                                     |
-| `<SettingsCard title icon?>` + `SettingsCardStatus`, `SettingsCardHint` | `components/settings/SettingsCard`  | Settings card: icon + title header, then free content — status lines (small icon + text, `iconColor` per state) and a quieter hint.                                                                                                                                                                                                                                                                                                                                 |
-| `<CheckboxGroup options values onChange label?>`                        | `components/picker/CheckboxGroup`   | Wrapping chips that each check and uncheck independently (extensions, tags…), each announced as a checkbox.                                                                                                                                                                                                                                                                                                                                                         |
-| `<MonthDayGrid days selected onToggle>`                                 | `components/picker/MonthDayGrid`    | Monday-first month grid whose days toggle on and off (holidays, days off…); `YYYY-MM-DD` days.                                                                                                                                                                                                                                                                                                                                                                      |
-| `<AddButton label onPress>`                                             | `components/list/AddButton`         | Dashed "+ Add …" button closing a list.                                                                                                                                                                                                                                                                                                                                                                                                                             |
-| `<DragHandle onPressIn accessibilityLabel>`                             | `components/list/DragHandle`        | "⠿" grip for `react-native-draggable-flatlist` rows (gesture-handler's `Pressable`).                                                                                                                                                                                                                                                                                                                                                                                |
-| `<ErrorFallback error retry>`                                           | `components/feedback/ErrorFallback` | Readable crash screen with a retry button, for Expo Router's `ErrorBoundary`; texts in French or English (`labels` to override).                                                                                                                                                                                                                                                                                                                                    |
+| Component                                                               | Import path                         | What it is                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| ----------------------------------------------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `<BottomSheet visible onClose bottomInset?>`                            | `components/overlay/BottomSheet`    | Modal sliding up from the bottom, content scrollable past 85 % of the screen. Pass `useSafeAreaInsets().bottom` as `bottomInset` with Android edge-to-edge.                                                                                                                                                                                                                                                                                                                                                                                     |
+| `<OptionsModal visible onClose options onSelect>`                       | `components/picker/OptionsModal`    | Centered popup listing `{ value, label }` options; a tap selects and closes.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `<SelectField label valueLabel options onSelect>`                       | `components/picker/SelectField`     | Native-looking "select": captioned button + `OptionsModal` (styled through `styles.optionsModal`).                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `<SegmentedToggle options value onChange label?>`                       | `components/picker/SegmentedToggle` | Row of equal-width buttons, one active (Calendar / List…), announced as a radio group; each option may carry a smaller `hint` line under its label.                                                                                                                                                                                                                                                                                                                                                                                             |
+| `<QuantityStepper value onChange label min? max?>`                      | `components/picker/QuantityStepper` | Whole-number counter `min…max` (`0…999`, negatives allowed with a negative `min`, `-Infinity`/`Infinity` for no bound): −/+ buttons moving by `step` (1; disabled at the bounds, `longPressStep` to jump on long press, or `repeatOnHold` to repeat faster and faster while held) and a numeric field; `onStep(value)` fires on each −/+ change (e.g. `onStep={tapFeedback}`), not on typing; `maxFontSizeMultiplier` caps the system font scaling of −, + and the field; screen-reader labels in French or English (`a11yLabels` to override). |
+| `<SwitchRow label description? value onChange>`                         | `components/settings/SwitchRow`     | Settings line "label + description + switch", the whole row pressable and read as one switch; `colors` for the track and thumb.                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `<SettingsCard title icon?>` + `SettingsCardStatus`, `SettingsCardHint` | `components/settings/SettingsCard`  | Settings card: icon + title header, then free content — status lines (small icon + text, `iconColor` per state) and a quieter hint.                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `<CheckboxGroup options values onChange label?>`                        | `components/picker/CheckboxGroup`   | Wrapping chips that each check and uncheck independently (extensions, tags…), each announced as a checkbox.                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `<MonthDayGrid days selected onToggle>`                                 | `components/picker/MonthDayGrid`    | Monday-first month grid whose days toggle on and off (holidays, days off…); `YYYY-MM-DD` days.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `<AddButton label onPress>`                                             | `components/list/AddButton`         | Dashed "+ Add …" button closing a list.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `<DragHandle onPressIn accessibilityLabel>`                             | `components/list/DragHandle`        | "⠿" grip for `react-native-draggable-flatlist` rows (gesture-handler's `Pressable`).                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `<ErrorFallback error retry>`                                           | `components/feedback/ErrorFallback` | Readable crash screen with a retry button, for Expo Router's `ErrorBoundary`; texts in French or English (`labels` to override).                                                                                                                                                                                                                                                                                                                                                                                                                |
 
 `SwipeableRow` also takes `fullSwipeToDelete`: swiping past half the row deletes right away (the row slides out over a full-width delete band) instead of revealing a button — pair it with an `UndoToast`.
 
@@ -561,6 +581,24 @@ import {
 />;
 ```
 
+`checkForUpdate` receives `{ includePrereleases }` (`false` by default). Pass `onIncludePrereleasesChange` to show a "Recevoir les versions de test" switch: the app stores the choice, hands it back as `includePrereleases`, and the screen checks again on each change (an older check that answers late is ignored). Hand the value on to `fetchLatestRelease({ …, includePrereleases, requireVerifiedApk: true })`, to `fetchReleaseHistory({ …, includePrereleases })` (the history is fetched again when that function changes), and to the launch check (`UpdateNotifier`) too. Style it with `styles.prereleaseSwitch` / `styles.prereleaseSwitchColors` (`SwitchRow`'s slots).
+
+```tsx
+<UpdateSettingsScreen
+  checkForUpdate={({ includePrereleases }) =>
+    fetchLatestRelease({
+      owner,
+      repo,
+      includePrereleases,
+      requireVerifiedApk: true,
+    })
+  }
+  includePrereleases={includePrereleases}
+  onIncludePrereleasesChange={setIncludePrereleases}
+  {...otherProps}
+/>
+```
+
 #### `<BackupSettingsScreen onExport onImport reminder? />`
 
 Export/import buttons plus an optional reminder-notification switch. Deliberately just a shell: what actually gets exported/imported is entirely app-specific (your own database tables), so `onExport`/`onImport` are required — this package can't have a sensible default for "how do I export my schema". Import asks for confirmation first (via `confirmDestructive`, from `utils/helpers/`) since it replaces existing data; `onImport` itself doesn't need to.
@@ -676,7 +714,7 @@ For all 7 components above, styling works the same way as `ChangelogNotes`: an o
 - `mergeSlotStyles(defaultStyles, styles)` — merges a component's per-slot `styles` overrides onto its defaults as `[default, override]` style arrays, so overriding one property of a slot keeps the rest of its default. Every component of this package uses it; handy for your own components following the same `styles` convention.
 - `shareFile(uri, { mimeType, dialogTitle?, locale? })` — opens the native share sheet for a local file; throws a user-facing `Error` (French, or English with `locale: "en"`) when the device can't share. Needs `expo-sharing`.
 - `shareTextFile(filename, content, options)` — writes the text to a file in the cache (replacing any previous one), then `shareFile`s it: `.ics`, `.csv`, JSON exports… Needs `expo-file-system` and `expo-sharing`.
-- `shareViewAsImage(ref, { dialogTitle?, locale? })` (`utils/helpers/shareViewAsImage`) — captures a view as a PNG and shares it (scoreboard, schedule…). Needs `react-native-view-shot` and `expo-sharing`; the capture library is loaded on demand, so a binary built without it only fails this call, with a user-facing `Error`.
+- `shareViewAsImage(ref, { dialogTitle?, locale? })` (`utils/helpers/shareViewAsImage`) — captures a view as a PNG and shares it (scoreboard, schedule…); `ref` is a `RefObject<ComponentRef<typeof View> | null>`, as `useRef<ComponentRef<typeof View>>(null)` gives. Needs `react-native-view-shot` and `expo-sharing`; the capture library is loaded on demand, so a binary built without it only fails this call, with a user-facing `Error`.
 - `isNativeModuleAvailable(name)` — whether a native module is compiled into this binary (either architecture): check it before loading a library that crashes on import without its module.
 
 ### Calendar (`utils/calendar/`)

package/dist/components/picker/PhotoPicker.d.ts

@@ -20,6 +20,12 @@ export interface PhotoPickerProps {
      * (`labels.saveErrorTitle` / `saveErrorMessage`).
      */
     onError?: (error: unknown) => void;
+    /**
+     * Called when a press opens the camera/library choice (not while a photo
+     * is being saved). The place for a haptic tick: `onOpen={tapFeedback}`
+     * (from `utils/helpers/haptics`).
+     */
+    onOpen?: () => void;
     labels?: PhotoPickerLabels;
     /**
      * Language of the built-in labels — French by default, or the nearest
@@ -28,5 +34,5 @@ export interface PhotoPickerProps {
     locale?: KitLocale;
     styles?: PhotoPickerStyles;
 }
-export declare function PhotoPicker({ photoUri, onChange, savePhoto, photoLabel, renderPreview, onError, labels, locale, styles, }: PhotoPickerProps): import("react").JSX.Element;
+export declare function PhotoPicker({ photoUri, onChange, savePhoto, photoLabel, renderPreview, onError, onOpen, labels, locale, styles, }: PhotoPickerProps): import("react").JSX.Element;
 //# sourceMappingURL=PhotoPicker.d.ts.map

package/dist/components/picker/PhotoPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PhotoPicker.d.ts","sourceRoot":"","sources":["../../../src/components/picker/PhotoPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,OAAO,CAAC;AAKzD,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC;IACxE;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAUD,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,aAAa,EACb,OAAO,EACP,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE,gBAAgB,+BAmHlB"}
+{"version":3,"file":"PhotoPicker.d.ts","sourceRoot":"","sources":["../../../src/components/picker/PhotoPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,OAAO,CAAC;AAKzD,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC;IACxE;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAUD,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,aAAa,EACb,OAAO,EACP,MAAM,EACN,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE,gBAAgB,+BAoHlB"}

package/dist/components/picker/PhotoPicker.js

@@ -13,7 +13,7 @@ const PICKER_OPTIONS = {
     aspect: [1, 1],
 };
 // Photo picker (camera or library) with a preview.
-export function PhotoPicker({ photoUri, onChange, savePhoto, photoLabel, renderPreview, onError, labels, locale, styles, }) {
+export function PhotoPicker({ photoUri, onChange, savePhoto, photoLabel, renderPreview, onError, onOpen, labels, locale, styles, }) {
     const mergedStyles = {
         ...mergeSlotStyles(defaultStyles, styles),
         iconColor: styles?.iconColor ?? defaultStyles.iconColor,
@@ -63,6 +63,7 @@ export function PhotoPicker({ photoUri, onChange, savePhoto, photoLabel, renderP
     function handlePickPhoto() {
         if (busyRef.current)
             return;
+        onOpen?.();
         Alert.alert(t.photoTitle(photoLabel), undefined, [
             {
                 text: t.takePhoto,

package/dist/components/picker/QuantityStepper.d.ts

@@ -39,6 +39,12 @@ export interface QuantityStepperProps {
      * @defaultValue false
      */
     repeatOnHold?: boolean;
+    /**
+     * Caps how much the system font size scales the "−", "+" and the field, so
+     * the row keeps fitting at the largest accessibility font sizes (e.g. `1.3`).
+     * Unset, they follow the system font size without limit.
+     */
+    maxFontSizeMultiplier?: number;
     /**
      * Language of the default screen-reader labels — French by default, or the
      * nearest `KitLocaleProvider`'s.
@@ -68,5 +74,5 @@ export interface QuantityStepperProps {
  * <QuantityStepper value={score} onChange={setScore} label="Points" min={-Infinity} max={Infinity} step={4} repeatOnHold onStep={tapFeedback} />
  * ```
  */
-export declare function QuantityStepper({ value, onChange, label, min, max, step, onStep, longPressStep, repeatOnHold, locale, a11yLabels, styles, }: QuantityStepperProps): import("react").JSX.Element;
+export declare function QuantityStepper({ value, onChange, label, min, max, step, onStep, longPressStep, repeatOnHold, maxFontSizeMultiplier, locale, a11yLabels, styles, }: QuantityStepperProps): import("react").JSX.Element;
 //# sourceMappingURL=QuantityStepper.d.ts.map

package/dist/components/picker/QuantityStepper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QuantityStepper.d.ts","sourceRoot":"","sources":["../../../src/components/picker/QuantityStepper.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAChD,oEAAoE;IACpE,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,GAAO,EACP,GAAS,EACT,IAAQ,EACR,MAAM,EACN,aAAa,EACb,YAAoB,EACpB,MAAM,EACN,UAAU,EACV,MAAM,GACP,EAAE,oBAAoB,+BA4ItB"}
+{"version":3,"file":"QuantityStepper.d.ts","sourceRoot":"","sources":["../../../src/components/picker/QuantityStepper.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC3B,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAChD,oEAAoE;IACpE,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,KAAK,EACL,GAAO,EACP,GAAS,EACT,IAAQ,EACR,MAAM,EACN,aAAa,EACb,YAAoB,EACpB,qBAAqB,EACrB,MAAM,EACN,UAAU,EACV,MAAM,GACP,EAAE,oBAAoB,+BAuJtB"}

package/dist/components/picker/QuantityStepper.js

@@ -37,7 +37,7 @@ function lengthOf(bound) {
  * <QuantityStepper value={score} onChange={setScore} label="Points" min={-Infinity} max={Infinity} step={4} repeatOnHold onStep={tapFeedback} />
  * ```
  */
-export function QuantityStepper({ value, onChange, label, min = 0, max = 999, step = 1, onStep, longPressStep, repeatOnHold = false, locale, a11yLabels, styles, }) {
+export function QuantityStepper({ value, onChange, label, min = 0, max = 999, step = 1, onStep, longPressStep, repeatOnHold = false, maxFontSizeMultiplier, locale, a11yLabels, styles, }) {
     const labels = { ...defaultA11yLabels[useKitLocale(locale)], ...a11yLabels };
     const merged = mergeSlotStyles(defaultStyles, styles);
     const atMin = value <= min;
@@ -97,7 +97,7 @@ export function QuantityStepper({ value, onChange, label, min = 0, max = 999, st
                     ? () => {
                         startRepeat(-1);
                     }
-                    : undefined, onPressOut: repeatOnHold ? repeat.stop : undefined, disabled: atMin, hitSlop: 6, accessibilityRole: "button", accessibilityLabel: labels.decrease(label), children: _jsx(Text, { style: merged.buttonText, children: "\u2212" }) }), _jsx(TextInput, { style: merged.input, value: draft ?? String(value), onChangeText: (text) => {
+                    : undefined, onPressOut: repeatOnHold ? repeat.stop : undefined, disabled: atMin, hitSlop: 6, accessibilityRole: "button", accessibilityLabel: labels.decrease(label), children: _jsx(Text, { style: merged.buttonText, maxFontSizeMultiplier: maxFontSizeMultiplier, children: "\u2212" }) }), _jsx(TextInput, { style: merged.input, value: draft ?? String(value), onChangeText: (text) => {
                     const cleaned = sanitize(text, allowsNegative);
                     const typed = Number(cleaned);
                     if (cleaned === "" || cleaned === "-" || typed < min) {
@@ -112,7 +112,7 @@ export function QuantityStepper({ value, onChange, label, min = 0, max = 999, st
                     set(draft === "" || draft === "-" ? 0 : Number(draft));
                 }, 
                 // "number-pad" has no "-" key on Android.
-                keyboardType: allowsNegative ? "numeric" : "number-pad", selectTextOnFocus: true, maxLength: Math.max(lengthOf(min), lengthOf(max)), accessibilityLabel: labels.input(label) }), _jsx(Pressable, { style: [merged.button, atMax && merged.buttonDisabled], onPress: tapsOnly
+                keyboardType: allowsNegative ? "numeric" : "number-pad", selectTextOnFocus: true, maxFontSizeMultiplier: maxFontSizeMultiplier, maxLength: Math.max(lengthOf(min), lengthOf(max)), accessibilityLabel: labels.input(label) }), _jsx(Pressable, { style: [merged.button, atMax && merged.buttonDisabled], onPress: tapsOnly
                     ? () => {
                         tap(step);
                     }
@@ -124,5 +124,5 @@ export function QuantityStepper({ value, onChange, label, min = 0, max = 999, st
                     ? () => {
                         startRepeat(1);
                     }
-                    : undefined, onPressOut: repeatOnHold ? repeat.stop : undefined, disabled: atMax, hitSlop: 6, accessibilityRole: "button", accessibilityLabel: labels.increase(label), children: _jsx(Text, { style: merged.buttonText, children: "+" }) })] }));
+                    : undefined, onPressOut: repeatOnHold ? repeat.stop : undefined, disabled: atMax, hitSlop: 6, accessibilityRole: "button", accessibilityLabel: labels.increase(label), children: _jsx(Text, { style: merged.buttonText, maxFontSizeMultiplier: maxFontSizeMultiplier, children: "+" }) })] }));
 }

package/dist/components/settings/UpdateSettingsScreen.d.ts

@@ -3,8 +3,14 @@ import type { UpdateSettingsScreenHistoryEntry, UpdateSettingsScreenLabels, Upda
 export type { UpdateSettingsScreenHistoryEntry, UpdateSettingsScreenLabels, UpdateSettingsScreenRelease, UpdateSettingsScreenStyles, } from "./UpdateSettingsScreen.styles.js";
 export interface UpdateSettingsScreenProps {
     currentVersion: string;
-    /** Fetches the latest available release, or `null` if there is none. */
-    checkForUpdate: () => Promise<UpdateSettingsScreenRelease | null>;
+    /**
+     * Fetches the latest available release, or `null` if there is none.
+     * Receives the current `includePrereleases`, e.g. to pass on to
+     * `fetchLatestRelease`.
+     */
+    checkForUpdate: (options: {
+        includePrereleases: boolean;
+    }) => Promise<UpdateSettingsScreenRelease | null>;
     /** Positive when `a` is newer than `b`, e.g. semver comparison. */
     compareVersions: (a: string, b: string) => number;
     /**
@@ -14,6 +20,13 @@ export interface UpdateSettingsScreenProps {
     downloadAndInstallApk: (apkUrl: string, onProgress?: (fraction: number) => void, apkSha256?: string) => Promise<void>;
     /** Omit to not show a version history section at all. */
     fetchReleaseHistory?: () => Promise<UpdateSettingsScreenHistoryEntry[]>;
+    /** Whether test versions (alpha, beta…) are offered. Defaults to `false`. */
+    includePrereleases?: boolean;
+    /**
+     * Shows a "test versions" switch when passed; the app stores the choice and
+     * hands it back as `includePrereleases`. Every change triggers a new check.
+     */
+    onIncludePrereleasesChange?: (value: boolean) => void;
     /**
      * Locale for formatting each history entry's date. Defaults to the
      * locale's (`"fr-FR"`, or `"en-US"` with `locale="en"`).
@@ -27,5 +40,5 @@ export interface UpdateSettingsScreenProps {
     locale?: KitLocale;
     styles?: UpdateSettingsScreenStyles;
 }
-export declare function UpdateSettingsScreen({ currentVersion, checkForUpdate, compareVersions, downloadAndInstallApk, fetchReleaseHistory, dateLocale: customDateLocale, labels, locale, styles, }: UpdateSettingsScreenProps): import("react").JSX.Element;
+export declare function UpdateSettingsScreen({ currentVersion, checkForUpdate, compareVersions, downloadAndInstallApk, fetchReleaseHistory, includePrereleases, onIncludePrereleasesChange, dateLocale: customDateLocale, labels, locale, styles, }: UpdateSettingsScreenProps): import("react").JSX.Element;
 //# sourceMappingURL=UpdateSettingsScreen.d.ts.map

package/dist/components/settings/UpdateSettingsScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpdateSettingsScreen.d.ts","sourceRoot":"","sources":["../../../src/components/settings/UpdateSettingsScreen.tsx"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,SAAS,EAEf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EACV,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,kCAAkC,CAAC;AAI1C,YAAY,EACV,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAU1C,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,cAAc,EAAE,MAAM,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAAC;IAClE,mEAAmE;IACnE,eAAe,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD;;;OAGG;IACH,qBAAqB,EAAE,CACrB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACvC,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAAC;IACxE;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AAQD,wBAAgB,oBAAoB,CAAC,EACnC,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE,yBAAyB,+BA8J3B"}
+{"version":3,"file":"UpdateSettingsScreen.d.ts","sourceRoot":"","sources":["../../../src/components/settings/UpdateSettingsScreen.tsx"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,SAAS,EAEf,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EACV,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,kCAAkC,CAAC;AAI1C,YAAY,EACV,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAU1C,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE;QACxB,kBAAkB,EAAE,OAAO,CAAC;KAC7B,KAAK,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAAC;IAClD,mEAAmE;IACnE,eAAe,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD;;;OAGG;IACH,qBAAqB,EAAE,CACrB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACvC,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAAC;IACxE,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,0BAA0B,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AAQD,wBAAgB,oBAAoB,CAAC,EACnC,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,kBAA0B,EAC1B,0BAA0B,EAC1B,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE,yBAAyB,+BAsL3B"}

package/dist/components/settings/UpdateSettingsScreen.js

@@ -1,18 +1,19 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { ActivityIndicator, Pressable, Text, View } from "react-native";
 import { ChangelogNotes } from "@forthtilliath/expo-release-updates-ui";
 import { KIT_LOCALE_TAGS, useKitLocale, } from "../../i18n/locale.js";
 import { mergeSlotStyles } from "../../utils/helpers/mergeSlotStyles.js";
+import { SwitchRow } from "./SwitchRow.js";
 import { defaultLabels, defaultStyles } from "./UpdateSettingsScreen.styles.js";
 import { UpdateSettingsScreenHistory } from "./UpdateSettingsScreenHistory.js";
 // Full "check for update" screen: installed version, a manual check button,
 // the available-update box (with changelog + install button) or an
 // up-to-date/error message, download progress, and — if
 // `fetchReleaseHistory` is passed — a list of past releases. Checks
-// automatically once on mount (the caller decided to navigate here, no need
-// to make them tap "check" again).
-export function UpdateSettingsScreen({ currentVersion, checkForUpdate, compareVersions, downloadAndInstallApk, fetchReleaseHistory, dateLocale: customDateLocale, labels, locale, styles, }) {
+// automatically on mount (the caller decided to navigate here, no need to make
+// them tap "check" again) and again whenever `includePrereleases` changes.
+export function UpdateSettingsScreen({ currentVersion, checkForUpdate, compareVersions, downloadAndInstallApk, fetchReleaseHistory, includePrereleases = false, onIncludePrereleasesChange, dateLocale: customDateLocale, labels, locale, styles, }) {
     const resolvedLocale = useKitLocale(locale);
     const dateLocale = customDateLocale ?? KIT_LOCALE_TAGS[resolvedLocale];
     const merged = {
@@ -34,10 +35,16 @@ export function UpdateSettingsScreen({ currentVersion, checkForUpdate, compareVe
             setReleaseHistory([]);
         });
     }, [fetchReleaseHistory]);
+    // Only the latest check may update the screen: toggling the switch during a
+    // check must not let the older answer land last.
+    const latestCheckRef = useRef(0);
     const handleCheckForUpdate = useCallback(async () => {
+        const check = ++latestCheckRef.current;
         setUpdateState({ status: "checking" });
         try {
-            const release = await checkForUpdate();
+            const release = await checkForUpdate({ includePrereleases });
+            if (check !== latestCheckRef.current)
+                return;
             if (!release || compareVersions(release.version, currentVersion) <= 0) {
                 setUpdateState({ status: "up-to-date" });
                 return;
@@ -45,13 +52,21 @@ export function UpdateSettingsScreen({ currentVersion, checkForUpdate, compareVe
             setUpdateState({ status: "available", release });
         }
         catch {
+            if (check !== latestCheckRef.current)
+                return;
             setUpdateState({ status: "error", message: t.checkError });
         }
-    }, [checkForUpdate, compareVersions, currentVersion, t.checkError]);
+    }, [
+        checkForUpdate,
+        compareVersions,
+        currentVersion,
+        includePrereleases,
+        t.checkError,
+    ]);
     useEffect(() => {
         void handleCheckForUpdate();
-        // eslint-disable-next-line @eslint-react/exhaustive-deps -- runs once on mount by design; handleCheckForUpdate is expected to be stable enough for the screen's lifetime.
-    }, []);
+        // eslint-disable-next-line @eslint-react/exhaustive-deps -- runs on mount and when includePrereleases changes by design; the other inputs are expected to be stable enough for the screen's lifetime.
+    }, [includePrereleases]);
     async function handleInstall({ apkUrl, apkSha256, }) {
         setUpdateState({ status: "downloading", progress: 0 });
         try {
@@ -70,7 +85,7 @@ export function UpdateSettingsScreen({ currentVersion, checkForUpdate, compareVe
         text: merged.helpText,
         ...merged.notes,
     }), [merged.helpText, merged.notes, merged.updateAvailableTitle]);
-    return (_jsxs(View, { style: merged.container, children: [_jsxs(View, { style: merged.infoBox, children: [_jsx(Text, { style: merged.infoLabel, children: t.installedVersionLabel }), _jsx(Text, { style: merged.infoValue, children: currentVersion })] }), updateState.status !== "available" &&
+    return (_jsxs(View, { style: merged.container, children: [_jsxs(View, { style: merged.infoBox, children: [_jsx(Text, { style: merged.infoLabel, children: t.installedVersionLabel }), _jsx(Text, { style: merged.infoValue, children: currentVersion })] }), onIncludePrereleasesChange && (_jsx(SwitchRow, { label: t.prereleaseLabel, description: t.prereleaseDescription, value: includePrereleases, onChange: onIncludePrereleasesChange, disabled: updateState.status === "downloading", colors: styles?.prereleaseSwitchColors, styles: styles?.prereleaseSwitch })), updateState.status !== "available" &&
                 updateState.status !== "downloading" && (_jsx(Pressable, { style: [merged.button, isBusy && merged.buttonDisabled], onPress: () => {
                     void handleCheckForUpdate();
                 }, disabled: isBusy, accessibilityRole: "button", accessibilityLabel: t.checkButton, children: updateState.status === "checking" ? (_jsx(ActivityIndicator, { color: activityIndicatorColor })) : (_jsx(Text, { style: merged.buttonText, children: t.checkButton })) })), updateState.status === "up-to-date" && (_jsx(Text, { style: merged.helpText, children: t.upToDate })), updateState.status === "error" && (_jsx(Text, { style: merged.errorText, children: updateState.message })), updateState.status === "available" && (_jsxs(View, { style: merged.updateAvailableBox, children: [_jsx(Text, { style: merged.updateAvailableTitle, children: t.availableTitle(updateState.release.version) }), updateState.release.notes ? (_jsx(ChangelogNotes, { notes: updateState.release.notes, styles: merged.notes })) : null, _jsx(Pressable, { style: merged.button, onPress: () => {

package/dist/components/settings/UpdateSettingsScreen.styles.d.ts

@@ -1,5 +1,6 @@
 import type { StyleProp, TextStyle, ViewStyle } from "react-native";
 import type { ChangelogNotesStyles } from "@forthtilliath/expo-release-updates-ui";
+import type { SwitchRowColors, SwitchRowStyles } from "./SwitchRow.js";
 export interface UpdateSettingsScreenRelease {
     version: string;
     notes: string;
@@ -24,6 +25,8 @@ export interface UpdateSettingsScreenLabels {
     downloadingLabel?: (percent: number) => string;
     downloadingHint?: string;
     historyTitle?: string;
+    prereleaseLabel?: string;
+    prereleaseDescription?: string;
 }
 export interface UpdateSettingsScreenStyles {
     container?: StyleProp<ViewStyle>;
@@ -45,6 +48,9 @@ export interface UpdateSettingsScreenStyles {
     changelogVersion?: StyleProp<TextStyle>;
     changelogDate?: StyleProp<TextStyle>;
     notes?: ChangelogNotesStyles;
+    /** The "test versions" switch row, shown with `onIncludePrereleasesChange`. */
+    prereleaseSwitch?: SwitchRowStyles;
+    prereleaseSwitchColors?: SwitchRowColors;
 }
 export declare const defaultLabels: {
     fr: {
@@ -59,6 +65,8 @@ export declare const defaultLabels: {
         downloadingLabel: (percent: number) => string;
         downloadingHint: string;
         historyTitle: string;
+        prereleaseLabel: string;
+        prereleaseDescription: string;
     };
     en: {
         installedVersionLabel: string;
@@ -72,7 +80,11 @@ export declare const defaultLabels: {
         downloadingLabel: (percent: number) => string;
         downloadingHint: string;
         historyTitle: string;
+        prereleaseLabel: string;
+        prereleaseDescription: string;
     };
 };
-export declare const defaultStyles: Required<Omit<UpdateSettingsScreenStyles, "activityIndicatorColor" | "notes">> & Pick<UpdateSettingsScreenStyles, "activityIndicatorColor" | "notes">;
+type LooseStyleKeys = "activityIndicatorColor" | "notes" | "prereleaseSwitch" | "prereleaseSwitchColors";
+export declare const defaultStyles: Required<Omit<UpdateSettingsScreenStyles, LooseStyleKeys>> & Pick<UpdateSettingsScreenStyles, "activityIndicatorColor" | "notes">;
+export {};
 //# sourceMappingURL=UpdateSettingsScreen.styles.d.ts.map

package/dist/components/settings/UpdateSettingsScreen.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpdateSettingsScreen.styles.d.ts","sourceRoot":"","sources":["../../../src/components/settings/UpdateSettingsScreen.styles.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UpdateSettingsScreen.styles.d.ts","sourceRoot":"","sources":["../../../src/components/settings/UpdateSettingsScreen.styles.ts"],"names":[],"mappings":"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"}

package/dist/components/settings/UpdateSettingsScreen.styles.js

@@ -11,6 +11,8 @@ export const defaultLabels = {
         downloadingLabel: (percent) => `Téléchargement… ${String(percent)}%`,
         downloadingHint: "Ton téléphone va ensuite te demander confirmation pour installer la mise à jour.",
         historyTitle: "Historique des versions",
+        prereleaseLabel: "Recevoir les versions de test",
+        prereleaseDescription: "Versions alpha et bêta, avant leur sortie : elles peuvent contenir des bugs.",
     },
     en: {
         installedVersionLabel: "Installed version",
@@ -24,6 +26,8 @@ export const defaultLabels = {
         downloadingLabel: (percent) => `Downloading… ${String(percent)}%`,
         downloadingHint: "Your phone will then ask you to confirm the install.",
         historyTitle: "Version history",
+        prereleaseLabel: "Get test versions",
+        prereleaseDescription: "Alpha and beta versions, before their release: they may contain bugs.",
     },
 };
 export const defaultStyles = {

package/dist/hooks/index.d.ts

@@ -2,4 +2,5 @@ export * from "./useDebouncedChange.js";
 export * from "./useEffectiveColorScheme.js";
 export * from "./usePressRepeat.js";
 export * from "./useSubmitGuard.js";
+export * from "./useViewShare.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/hooks/index.js

@@ -2,3 +2,4 @@ export * from "./useDebouncedChange.js";
 export * from "./useEffectiveColorScheme.js";
 export * from "./usePressRepeat.js";
 export * from "./useSubmitGuard.js";
+export * from "./useViewShare.js";

package/dist/hooks/useViewShare.d.ts

@@ -0,0 +1,39 @@
+import { type View } from "react-native";
+import { type ShareViewAsImageOptions } from "../utils/helpers/shareViewAsImage.js";
+export interface UseViewShareOptions extends ShareViewAsImageOptions {
+    /**
+     * Called when the capture or the share fails (capture missing from this
+     * binary, no share sheet…). Unset, an alert shows the error's message.
+     */
+    onError?: (error: unknown) => void;
+    /** Title of the default error alert. */
+    errorTitle?: string;
+    /** Message of the default error alert, for an error without a message. */
+    errorMessage?: string;
+}
+/**
+ * Shares as an image a view rendered on demand (a scoreboard, a summary card
+ * that isn't on screen): `capturing` is `true` while the capture runs — the
+ * screen mounts the view attached to `ref` (off screen, `collapsable={false}`)
+ * only meanwhile — and `share()` waits two frames for it to be drawn before
+ * capturing it with {@link shareViewAsImage}. A second `share()` while one is
+ * running is ignored.
+ *
+ * @example
+ * ```tsx
+ * const ranking = useViewShare({ dialogTitle: "Partager le classement" });
+ *
+ * <Button title="Partager" onPress={() => void ranking.share()} />
+ * {ranking.capturing ? (
+ *   <View ref={ranking.ref} collapsable={false} style={offScreen}>
+ *     <RankingCard />
+ *   </View>
+ * ) : null}
+ * ```
+ */
+export declare function useViewShare({ onError, errorTitle, errorMessage, ...options }?: UseViewShareOptions): {
+    ref: import("react").RefObject<View | null>;
+    capturing: boolean;
+    share: () => Promise<void>;
+};
+//# sourceMappingURL=useViewShare.d.ts.map

package/dist/hooks/useViewShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewShare.d.ts","sourceRoot":"","sources":["../../src/hooks/useViewShare.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,sCAAsC,CAAC;AAE9C,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAClE;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,UAAU,EACV,YAAY,EACZ,GAAG,OAAO,EACX,GAAE,mBAAwB;;;;EA+B1B"}

package/dist/hooks/useViewShare.js

@@ -0,0 +1,75 @@
+import { useRef, useState } from "react";
+import { Alert } from "react-native";
+import { useKitLocale } from "../i18n/locale.js";
+import { shareViewAsImage, } from "../utils/helpers/shareViewAsImage.js";
+const defaultErrorLabels = {
+    fr: {
+        errorTitle: "Partage impossible",
+        errorMessage: "L'image n'a pas pu être créée.",
+    },
+    en: {
+        errorTitle: "Couldn't share",
+        errorMessage: "The image couldn't be created.",
+    },
+};
+/** Resolves once React has rendered the last state change and native drew it. */
+function nextFrames() {
+    return new Promise((resolve) => {
+        requestAnimationFrame(() => {
+            requestAnimationFrame(() => {
+                resolve();
+            });
+        });
+    });
+}
+/**
+ * Shares as an image a view rendered on demand (a scoreboard, a summary card
+ * that isn't on screen): `capturing` is `true` while the capture runs — the
+ * screen mounts the view attached to `ref` (off screen, `collapsable={false}`)
+ * only meanwhile — and `share()` waits two frames for it to be drawn before
+ * capturing it with {@link shareViewAsImage}. A second `share()` while one is
+ * running is ignored.
+ *
+ * @example
+ * ```tsx
+ * const ranking = useViewShare({ dialogTitle: "Partager le classement" });
+ *
+ * <Button title="Partager" onPress={() => void ranking.share()} />
+ * {ranking.capturing ? (
+ *   <View ref={ranking.ref} collapsable={false} style={offScreen}>
+ *     <RankingCard />
+ *   </View>
+ * ) : null}
+ * ```
+ */
+export function useViewShare({ onError, errorTitle, errorMessage, ...options } = {}) {
+    const ref = useRef(null);
+    const [capturing, setCapturing] = useState(false);
+    // Ahead of `capturing`, which only changes on the next render.
+    const busyRef = useRef(false);
+    const locale = useKitLocale(options.locale);
+    const defaults = defaultErrorLabels[locale];
+    async function share() {
+        if (busyRef.current)
+            return;
+        busyRef.current = true;
+        setCapturing(true);
+        try {
+            await nextFrames();
+            await shareViewAsImage(ref, { ...options, locale });
+        }
+        catch (error) {
+            if (onError)
+                onError(error);
+            else
+                Alert.alert(errorTitle ?? defaults.errorTitle, error instanceof Error && error.message
+                    ? error.message
+                    : (errorMessage ?? defaults.errorMessage));
+        }
+        finally {
+            busyRef.current = false;
+            setCapturing(false);
+        }
+    }
+    return { ref, capturing, share };
+}

package/dist/utils/helpers/shareViewAsImage.d.ts

@@ -1,4 +1,4 @@
-import type { RefObject } from "react";
+import type { ComponentRef, RefObject } from "react";
 import type { View } from "react-native";
 import { type ShareFileOptions } from "./shareFile.js";
 export type ShareViewAsImageOptions = Omit<ShareFileOptions, "mimeType"> & {
@@ -12,10 +12,12 @@ export type ShareViewAsImageOptions = Omit<ShareFileOptions, "mimeType"> & {
  * module is known to be there: on a binary built without it, only this
  * feature fails — with a user-facing `Error` — instead of the whole screen.
  *
- * @param view - Ref of the view to capture (`collapsable={false}` on Android).
+ * @param view - Ref of the view to capture (`collapsable={false}` on Android),
+ *   as `useRef<ComponentRef<typeof View>>(null)` gives — `View` is the
+ *   component, not its instance type.
  * @param options - See {@link ShareViewAsImageOptions} and `shareFile`.
  * @example
  * await shareViewAsImage(rankingRef, { dialogTitle: "Partager le classement" });
  */
-export declare function shareViewAsImage(view: RefObject<View | null>, { captureUnavailableMessage, ...options }?: ShareViewAsImageOptions): Promise<void>;
+export declare function shareViewAsImage(view: RefObject<ComponentRef<typeof View> | null>, { captureUnavailableMessage, ...options }?: ShareViewAsImageOptions): Promise<void>;
 //# sourceMappingURL=shareViewAsImage.d.ts.map

package/dist/utils/helpers/shareViewAsImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shareViewAsImage.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/shareViewAsImage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAKzC,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG;IACzE,wEAAwE;IACxE,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAOF;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,EAC5B,EAAE,yBAAyB,EAAE,GAAG,OAAO,EAAE,GAAE,uBAA4B,GACtE,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"shareViewAsImage.d.ts","sourceRoot":"","sources":["../../../src/utils/helpers/shareViewAsImage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAKzC,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC,GAAG;IACzE,wEAAwE;IACxE,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAOF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,EACjD,EAAE,yBAAyB,EAAE,GAAG,OAAO,EAAE,GAAE,uBAA4B,GACtE,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/utils/helpers/shareViewAsImage.js

@@ -12,7 +12,9 @@ const defaultCaptureUnavailableMessages = {
  * module is known to be there: on a binary built without it, only this
  * feature fails — with a user-facing `Error` — instead of the whole screen.
  *
- * @param view - Ref of the view to capture (`collapsable={false}` on Android).
+ * @param view - Ref of the view to capture (`collapsable={false}` on Android),
+ *   as `useRef<ComponentRef<typeof View>>(null)` gives — `View` is the
+ *   component, not its instance type.
  * @param options - See {@link ShareViewAsImageOptions} and `shareFile`.
  * @example
  * await shareViewAsImage(rankingRef, { dialogTitle: "Partager le classement" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forthtilliath/react-native-kit",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",
@@ -22,7 +22,7 @@
     "./*": "./dist/*.js"
   },
   "dependencies": {
-    "@forthtilliath/ts-kit": "^0.14.0"
+    "@forthtilliath/ts-kit": "^0.15.0"
   },
   "peerDependencies": {
     "@expo/vector-icons": ">=15.0.0",
@@ -83,7 +83,7 @@
     "@size-limit/file": "^14.1.0",
     "@types/react": "^19.2.18",
     "@types/react-test-renderer": "^19.1.0",
-    "@vitest/coverage-v8": "5.0.2",
+    "@vitest/coverage-v8": "5.0.5",
     "eslint": "10.7.0",
     "expo-calendar": "~57.0.5",
     "expo-file-system": "~57.0.2",
@@ -101,16 +101,16 @@
     "react-test-renderer": "19.2.3",
     "size-limit": "^14.1.0",
     "typescript": "^5.9.3",
-    "vitest": "^5.0.2",
-    "@forthtilliath/expo-release-updates-ui": "^0.5.0",
-    "@forthtilliath/typescript-config": "0.1.1",
-    "@forthtilliath/eslint-config": "0.9.0"
+    "vitest": "^5.0.5",
+    "@forthtilliath/eslint-config": "0.10.0",
+    "@forthtilliath/expo-release-updates-ui": "^0.5.2",
+    "@forthtilliath/typescript-config": "0.1.1"
   },
   "size-limit": [
     {
       "name": "dist (all modules, brotli)",
       "path": "dist/**/*.js",
-      "limit": "47 KB"
+      "limit": "48 KB"
     }
   ],
   "scripts": {