@forthtilliath/expo-backup-ui 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Forthtilliath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,57 @@
-# Temporary Holding Version
+# @forthtilliath/expo-backup-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The "Settings ▸ Backup" screen for [`@forthtilliath/expo-backup`](../expo-backup#readme), shared by every app: automatic Google Drive backup, manual export/import with undo, encryption and recovery code. French by default, English with `locale="en"`, every text and style overridable.
+
+## Install
+
+```bash
+npm install @forthtilliath/expo-backup-ui @forthtilliath/expo-backup
+```
+
+No dependency beyond `react` / `react-native` (no icon library, no other kit).
+
+## Usage
+
+```tsx
+// app/_layout.tsx — once
+import { useAutoBackup } from "@forthtilliath/expo-backup-ui";
+import { backup } from "@/lib/backup";
+
+useAutoBackup(backup);
+```
+
+```tsx
+// app/(tabs)/settings/backup.tsx
+import { BackupScreen } from "@forthtilliath/expo-backup-ui";
+
+<ScrollView contentContainerStyle={{ padding: 16 }}>
+  <BackupScreen
+    manager={backup}
+    describeBackup={(data) =>
+      `${data.foods.length} aliments, ${data.weighings.length} pesées`
+    }
+    styles={{
+      section: { backgroundColor: colors.surface, borderColor: colors.border },
+      sectionTitle: { color: colors.text },
+      hint: { color: colors.textMuted },
+      button: { backgroundColor: colors.primary },
+    }}
+  />
+</ScrollView>;
+```
+
+| Prop                    |                                                                                                  |
+| ----------------------- | ------------------------------------------------------------------------------------------------ |
+| `manager`               | The app's `createBackupManager(...)`                                                             |
+| `cloud`                 | `false` hides the Google Drive section (no OAuth client yet)                                     |
+| `describeBackup`        | Short description of a backup in the confirmations                                               |
+| `onRestored`            | Called after a restore, e.g. to reload in-memory stores                                          |
+| `locale` / `dateLocale` | `"fr"` (default) or `"en"`; dates follow the locale unless `dateLocale` is set                   |
+| `labels`                | Any subset of the texts, error messages included (`labels.errors.network`…)                      |
+| `styles`                | Per-slot overrides merged on the defaults (`section`, `button`, `secondaryButton`, `modalCard`…) |
+
+Every action runs one at a time (a double tap is ignored) and shows errors in an alert: the package's own in the screen's language, the app's `parse` errors as is.
+
+The encryption section only appears when the manager's encryption isn't `off`: a switch in `optional` mode, a status line in `required` mode, and — on demand only, since it is the key — the recovery code, shown selectable so it can be copied into a password manager.
+
+Also exported: `useBackupState(manager)` (the manager's state, re-rendering on change) and `errorMessage(error, labels)`.

package/dist/ActionButton.d.ts

@@ -0,0 +1,12 @@
+import { type MergedStyles } from "./styles.js";
+export interface ActionButtonProps {
+    label: string;
+    onPress: () => void;
+    variant?: "primary" | "secondary" | "ghost";
+    disabled?: boolean;
+    /** Shows a spinner instead of the label. */
+    busy?: boolean;
+    styles: MergedStyles;
+}
+export declare function ActionButton({ label, onPress, variant, disabled, busy, styles, }: ActionButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=ActionButton.d.ts.map

package/dist/ActionButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionButton.d.ts","sourceRoot":"","sources":["../src/ActionButton.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,OAAO,EACP,OAAmB,EACnB,QAAgB,EAChB,IAAY,EACZ,MAAM,GACP,EAAE,iBAAiB,+BAqCnB"}

package/dist/ActionButton.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ActivityIndicator, Pressable, Text } from "react-native";
+import { PRIMARY_COLOR } from "./styles.js";
+export function ActionButton({ label, onPress, variant = "primary", disabled = false, busy = false, styles, }) {
+    const variantStyle = variant === "secondary"
+        ? styles.secondaryButton
+        : variant === "ghost"
+            ? styles.ghostButton
+            : undefined;
+    const variantTextStyle = variant === "secondary"
+        ? styles.secondaryButtonText
+        : variant === "ghost"
+            ? styles.ghostButtonText
+            : undefined;
+    const spinnerColor = styles.activityIndicatorColor ??
+        (variant === "primary" ? "#ffffff" : PRIMARY_COLOR);
+    return (_jsx(Pressable, { style: [
+            styles.button,
+            variantStyle,
+            (disabled || busy) && styles.buttonDisabled,
+        ], onPress: onPress, disabled: disabled || busy, accessibilityRole: "button", accessibilityLabel: label, accessibilityState: { disabled: disabled || busy, busy }, children: busy ? (_jsx(ActivityIndicator, { color: spinnerColor })) : (_jsx(Text, { style: [styles.buttonText, variantTextStyle], children: label })) }));
+}

package/dist/BackupScreen.d.ts

@@ -0,0 +1,27 @@
+import type { BackupManager } from "@forthtilliath/expo-backup";
+import { type BackupLocale, type BackupScreenLabelOverrides } from "./labels.js";
+import { type BackupScreenStyles } from "./styles.js";
+export interface BackupScreenProps<T> {
+    manager: BackupManager<T>;
+    /** Hide the Google Drive section (e.g. an app without an OAuth client yet). */
+    cloud?: boolean;
+    /** Short description of a backup for the confirmations, e.g. "12 aliments, 340 pesées". */
+    describeBackup?: (data: T) => string;
+    /** Called after a restore (file or cloud), e.g. to refresh in-memory stores. */
+    onRestored?: (data: T) => void;
+    /** @defaultValue "fr" */
+    locale?: BackupLocale;
+    /** Locale of the dates. Defaults to the `locale`'s (`fr-FR` / `en-US`). */
+    dateLocale?: string;
+    /** Overrides individual built-in texts, whatever the `locale`. */
+    labels?: BackupScreenLabelOverrides;
+    styles?: BackupScreenStyles;
+}
+/**
+ * The whole "Settings ▸ Backup" screen: automatic Google Drive backup, manual
+ * file export/import with undo, and — unless the manager's encryption is
+ * `off` — the encryption status and recovery code. Render it inside the
+ * app's own ScrollView/screen container.
+ */
+export declare function BackupScreen<T>({ manager, cloud, describeBackup, onRestored, locale, dateLocale, labels, styles, }: BackupScreenProps<T>): import("react").JSX.Element;
+//# sourceMappingURL=BackupScreen.d.ts.map

package/dist/BackupScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackupScreen.d.ts","sourceRoot":"","sources":["../src/BackupScreen.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAKhE,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,0BAA0B,EAEhC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,aAAa,CAAC;AAKnE,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IACrC,gFAAgF;IAChF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,yBAAyB;IACzB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAC9B,OAAO,EACP,KAAY,EACZ,cAAc,EACd,UAAU,EACV,MAAa,EACb,UAAU,EACV,MAAM,EACN,MAAM,GACP,EAAE,iBAAiB,CAAC,CAAC,CAAC,+BA2BtB"}

package/dist/BackupScreen.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { View } from "react-native";
+import { CloudSection } from "./CloudSection.js";
+import { EncryptionSection } from "./EncryptionSection.js";
+import { FileSection } from "./FileSection.js";
+import { resolveLabels, } from "./labels.js";
+import { RecoveryCodeInputModal } from "./RecoveryCodeModals.js";
+import { mergeStyles } from "./styles.js";
+import { useBackupUi } from "./useBackupUi.js";
+const DATE_LOCALES = { fr: "fr-FR", en: "en-US" };
+/**
+ * The whole "Settings ▸ Backup" screen: automatic Google Drive backup, manual
+ * file export/import with undo, and — unless the manager's encryption is
+ * `off` — the encryption status and recovery code. Render it inside the
+ * app's own ScrollView/screen container.
+ */
+export function BackupScreen({ manager, cloud = true, describeBackup, onRestored, locale = "fr", dateLocale, labels, styles, }) {
+    const merged = mergeStyles(styles);
+    const t = resolveLabels(locale, labels);
+    const { ui, recoveryPrompt } = useBackupUi({
+        manager,
+        t,
+        styles: merged,
+        describeBackup,
+        dateLocale: dateLocale ?? DATE_LOCALES[locale],
+        onRestored,
+    });
+    return (_jsxs(View, { style: merged.container, children: [cloud && _jsx(CloudSection, { ui: ui }), _jsx(FileSection, { ui: ui }), _jsx(EncryptionSection, { ui: ui }), _jsx(RecoveryCodeInputModal, { visible: recoveryPrompt !== null, error: recoveryPrompt?.error, onSubmit: (code) => recoveryPrompt?.resolve(code), onCancel: () => recoveryPrompt?.resolve(null), t: t, styles: merged })] }));
+}

package/dist/CloudSection.d.ts

@@ -0,0 +1,6 @@
+import type { BackupUi } from "./useBackupUi.js";
+/** Linking a Google account, then the automatic backup's status and actions. */
+export declare function CloudSection<T>({ ui }: {
+    ui: BackupUi<T>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=CloudSection.d.ts.map

package/dist/CloudSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudSection.d.ts","sourceRoot":"","sources":["../src/CloudSection.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,+BAgG1D"}

package/dist/CloudSection.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Text, View } from "react-native";
+import { ActionButton } from "./ActionButton.js";
+import { askConfirmation, askConflictChoice } from "./dialogs.js";
+/** Linking a Google account, then the automatic backup's status and actions. */
+export function CloudSection({ ui }) {
+    const { manager, state, t, styles, busy, run } = ui;
+    const { cloudAccount } = state;
+    const handleConnect = () => run(async () => {
+        const result = await manager.connectCloud();
+        if (result.status === "cancelled")
+            return;
+        if (result.status === "conflict") {
+            const keep = await askConflictChoice(t, ui.describe(result.remote));
+            if (keep === null) {
+                await manager.cancelConflict();
+                return;
+            }
+            await manager.resolveConflict(result, keep);
+        }
+        Alert.alert(t.connectedTitle, t.connectedConfirm(result.email));
+    });
+    const handleSyncNow = () => run(async () => {
+        await manager.syncNow();
+        // Errors are kept in the state (shown below) rather than thrown.
+    });
+    const handleRestore = () => run(async () => {
+        const remote = await manager.fetchCloudBackup();
+        if (remote === null) {
+            Alert.alert(t.noCloudBackupTitle, t.noCloudBackupMessage);
+            return;
+        }
+        await ui.confirmAndRestore(remote, "cloud");
+    });
+    const handleDisconnect = () => run(async () => {
+        const confirmed = await askConfirmation(t, t.disconnectConfirmTitle, t.disconnectConfirmMessage, t.disconnectButton);
+        if (confirmed)
+            await manager.disconnectCloud();
+    });
+    if (!cloudAccount) {
+        return (_jsxs(View, { style: styles.section, children: [_jsx(Text, { style: styles.sectionTitle, children: t.cloudTitle }), _jsx(Text, { style: styles.hint, children: t.cloudHint }), _jsx(ActionButton, { label: t.connectButton, onPress: () => void handleConnect(), busy: busy, styles: styles })] }));
+    }
+    return (_jsxs(View, { style: styles.section, children: [_jsx(Text, { style: styles.sectionTitle, children: t.cloudTitle }), _jsx(Text, { style: styles.status, children: cloudAccount.email }), _jsxs(Text, { style: styles.status, children: [t.lastCloudBackup(ui.formatDate(state.lastCloudBackupAt)), state.cloudPending && !state.cloudError ? t.cloudPending : ""] }), state.cloudError && (_jsx(Text, { style: styles.errorText, children: t.errors[state.cloudError] })), _jsx(Text, { style: styles.hint, children: t.autoHint }), _jsx(ActionButton, { label: t.syncNowButton, variant: "secondary", onPress: () => void handleSyncNow(), disabled: busy, styles: styles }), _jsx(ActionButton, { label: t.restoreCloudButton, variant: "secondary", onPress: () => void handleRestore(), disabled: busy, styles: styles }), _jsx(ActionButton, { label: t.disconnectButton, variant: "ghost", onPress: () => void handleDisconnect(), disabled: busy, styles: styles })] }));
+}

package/dist/EncryptionSection.d.ts

@@ -0,0 +1,9 @@
+import type { BackupUi } from "./useBackupUi.js";
+/**
+ * Encryption status (toggle in `optional` mode), plus the recovery code: shown
+ * only on demand, since it is the key itself.
+ */
+export declare function EncryptionSection<T>({ ui }: {
+    ui: BackupUi<T>;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=EncryptionSection.d.ts.map

package/dist/EncryptionSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptionSection.d.ts","sourceRoot":"","sources":["../src/EncryptionSection.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,sCA0E/D"}

package/dist/EncryptionSection.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Alert, Pressable, Switch, Text, View } from "react-native";
+import { ActionButton } from "./ActionButton.js";
+import { RecoveryCodeDisplayModal } from "./RecoveryCodeModals.js";
+/**
+ * Encryption status (toggle in `optional` mode), plus the recovery code: shown
+ * only on demand, since it is the key itself.
+ */
+export function EncryptionSection({ ui }) {
+    const { manager, state, t, styles, busy, run } = ui;
+    const [recoveryCode, setRecoveryCode] = useState(null);
+    if (manager.encryptionMode === "off")
+        return null;
+    const active = manager.isEncryptionActive();
+    const handleToggle = (enabled) => run(() => manager.setEncryptionEnabled(enabled));
+    const handleShowCode = () => run(async () => {
+        setRecoveryCode(await manager.getRecoveryCode());
+    });
+    const handleEnterCode = () => run(async () => {
+        const code = await ui.askRecoveryCode();
+        if (code === null)
+            return;
+        await manager.addRecoveryCode(code);
+        Alert.alert(t.recoveryCodeAdded);
+    });
+    return (_jsxs(View, { style: styles.section, children: [_jsx(Text, { style: styles.sectionTitle, children: t.encryptionTitle }), manager.encryptionMode === "optional" ? (_jsxs(Pressable, { style: styles.switchRow, disabled: busy, onPress: () => void handleToggle(!state.encryptionEnabled), accessibilityRole: "switch", accessibilityState: { checked: state.encryptionEnabled }, accessibilityLabel: t.encryptionToggle, children: [_jsx(Text, { style: styles.switchLabel, children: t.encryptionToggle }), _jsx(Switch, { value: state.encryptionEnabled, disabled: busy, onValueChange: (value) => void handleToggle(value) })] })) : null, _jsx(Text, { style: styles.hint, children: manager.encryptionMode === "required"
+                    ? t.encryptionRequiredHint
+                    : t.encryptionOptionalHint }), active && (_jsx(ActionButton, { label: t.showRecoveryCodeButton, variant: "secondary", onPress: () => void handleShowCode(), disabled: busy, styles: styles })), _jsx(ActionButton, { label: t.enterRecoveryCodeButton, variant: "ghost", onPress: () => void handleEnterCode(), disabled: busy, styles: styles }), _jsx(RecoveryCodeDisplayModal, { code: recoveryCode, onClose: () => {
+                    setRecoveryCode(null);
+                }, t: t, styles: styles })] }));
+}

package/dist/FileSection.d.ts

@@ -0,0 +1,6 @@
+import type { BackupUi } from "./useBackupUi.js";
+/** Export to a file through the share sheet, import one back, undo the last restore. */
+export declare function FileSection<T>({ ui }: {
+    ui: BackupUi<T>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=FileSection.d.ts.map

package/dist/FileSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileSection.d.ts","sourceRoot":"","sources":["../src/FileSection.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;IAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,+BAwEzD"}

package/dist/FileSection.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Text, View } from "react-native";
+import { ActionButton } from "./ActionButton.js";
+import { askConfirmation, errorMessage } from "./dialogs.js";
+/** Export to a file through the share sheet, import one back, undo the last restore. */
+export function FileSection({ ui }) {
+    const { manager, state, t, styles, busy, run } = ui;
+    const handleExport = () => run(() => manager.exportToFile());
+    const handleImport = () => run(async () => {
+        let result = await manager.pickBackupFile();
+        let promptError;
+        // A file from another phone, encrypted with a key this one doesn't
+        // have: ask for that phone's recovery code until it fits or the user
+        // gives up.
+        while (result.status === "missing-key") {
+            const code = await ui.askRecoveryCode(promptError);
+            if (code === null)
+                return;
+            try {
+                result = await result.retry(code);
+            }
+            catch (error) {
+                promptError = errorMessage(error, t);
+            }
+        }
+        if (result.status === "cancelled")
+            return;
+        await ui.confirmAndRestore(result.data, "file");
+    });
+    const handleUndo = () => run(async () => {
+        const confirmed = await askConfirmation(t, t.undoConfirmTitle, t.undoConfirmMessage, t.confirm);
+        if (!confirmed)
+            return;
+        await manager.undoLastRestore();
+        Alert.alert(t.undoneTitle);
+    });
+    return (_jsxs(View, { style: styles.section, children: [_jsx(Text, { style: styles.sectionTitle, children: t.fileTitle }), _jsx(Text, { style: styles.status, children: t.lastBackup(ui.formatDate(state.lastBackupAt)) }), _jsx(Text, { style: styles.hint, children: manager.isEncryptionActive() ? t.fileHintEncrypted : t.fileHint }), _jsx(ActionButton, { label: t.exportButton, variant: "secondary", onPress: () => void handleExport(), disabled: busy, styles: styles }), _jsx(ActionButton, { label: t.importButton, variant: "secondary", onPress: () => void handleImport(), disabled: busy, styles: styles }), state.hasSafetyBackup && (_jsx(ActionButton, { label: t.undoButton, variant: "ghost", onPress: () => void handleUndo(), disabled: busy, styles: styles }))] }));
+}

package/dist/RecoveryCodeModals.d.ts

@@ -0,0 +1,23 @@
+import type { BackupScreenLabels } from "./labels.js";
+import type { MergedStyles } from "./styles.js";
+interface ModalProps {
+    t: BackupScreenLabels;
+    styles: MergedStyles;
+}
+/** Shows the recovery code, selectable so it can be copied to a password manager. */
+export declare function RecoveryCodeDisplayModal({ code, onClose, t, styles, }: ModalProps & {
+    code: string | null;
+    onClose: () => void;
+}): import("react").JSX.Element;
+/**
+ * Asks for a recovery code. Android has no `Alert.prompt`, hence a modal.
+ * `error` shows why the previous attempt was refused.
+ */
+export declare function RecoveryCodeInputModal({ visible, error, onSubmit, onCancel, t, styles, }: ModalProps & {
+    visible: boolean;
+    error: string | undefined;
+    onSubmit: (code: string) => void;
+    onCancel: () => void;
+}): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=RecoveryCodeModals.d.ts.map

package/dist/RecoveryCodeModals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryCodeModals.d.ts","sourceRoot":"","sources":["../src/RecoveryCodeModals.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,UAAU;IAClB,CAAC,EAAE,kBAAkB,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,EACvC,IAAI,EACJ,OAAO,EACP,CAAC,EACD,MAAM,GACP,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,+BAoB3D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,CAAC,EACD,MAAM,GACP,EAAE,UAAU,GAAG;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,+BAwDA"}

package/dist/RecoveryCodeModals.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { Modal, Text, TextInput, View } from "react-native";
+import { ActionButton } from "./ActionButton.js";
+/** Shows the recovery code, selectable so it can be copied to a password manager. */
+export function RecoveryCodeDisplayModal({ code, onClose, t, styles, }) {
+    return (_jsx(Modal, { visible: code !== null, transparent: true, animationType: "fade", onRequestClose: onClose, children: _jsx(View, { style: styles.modalBackdrop, children: _jsxs(View, { style: styles.modalCard, children: [_jsx(Text, { style: styles.sectionTitle, children: t.recoveryCodeTitle }), _jsx(Text, { style: styles.recoveryCode, selectable: true, children: code }), _jsx(Text, { style: styles.hint, children: t.recoveryCodeHint }), _jsx(ActionButton, { label: t.close, onPress: onClose, styles: styles })] }) }) }));
+}
+/**
+ * Asks for a recovery code. Android has no `Alert.prompt`, hence a modal.
+ * `error` shows why the previous attempt was refused.
+ */
+export function RecoveryCodeInputModal({ visible, error, onSubmit, onCancel, t, styles, }) {
+    const [code, setCode] = useState("");
+    function submit() {
+        const typed = code;
+        setCode("");
+        onSubmit(typed);
+    }
+    function cancel() {
+        setCode("");
+        onCancel();
+    }
+    return (_jsx(Modal, { visible: visible, transparent: true, animationType: "fade", onRequestClose: cancel, children: _jsx(View, { style: styles.modalBackdrop, children: _jsxs(View, { style: styles.modalCard, children: [_jsx(Text, { style: styles.sectionTitle, children: t.recoveryCodeInputTitle }), _jsx(Text, { style: styles.hint, children: t.recoveryCodeInputHint }), _jsx(TextInput, { style: styles.input, value: code, onChangeText: setCode, placeholder: t.recoveryCodePlaceholder, placeholderTextColor: styles.placeholderTextColor, autoCapitalize: "characters", autoCorrect: false, autoComplete: "off", 
+                        // Keeps the code out of the keyboard's learned words and suggestions.
+                        importantForAutofill: "no", secureTextEntry: false, keyboardType: "visible-password" }), error !== undefined && _jsx(Text, { style: styles.errorText, children: error }), _jsx(ActionButton, { label: t.confirm, onPress: submit, disabled: code.trim() === "", styles: styles }), _jsx(ActionButton, { label: t.cancel, variant: "ghost", onPress: cancel, styles: styles })] }) }) }));
+}

package/dist/dialogs.d.ts

@@ -0,0 +1,9 @@
+import type { BackupScreenLabels } from "./labels.js";
+/** User-facing text of any error: localized for the package's own, as is for the app's. */
+export declare function errorMessage(error: unknown, t: BackupScreenLabels): string;
+export declare function showError(error: unknown, t: BackupScreenLabels): void;
+/** Resolves to true only if the user taps `confirmLabel` (not on cancel or dismiss). */
+export declare function askConfirmation(t: BackupScreenLabels, title: string, message: string, confirmLabel: string): Promise<boolean>;
+/** Which backup to keep when linking an account that already holds one; null if cancelled. */
+export declare function askConflictChoice(t: BackupScreenLabels, description: string): Promise<"device" | "cloud" | null>;
+//# sourceMappingURL=dialogs.d.ts.map

package/dist/dialogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../src/dialogs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAI1E;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAErE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAC7B,CAAC,EAAE,kBAAkB,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,kBAAkB,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC,CAmCpC"}

package/dist/dialogs.js

@@ -0,0 +1,72 @@
+import { Alert } from "react-native";
+// Subpath: errors.js loads no native module, unlike the package root.
+import { BackupError } from "@forthtilliath/expo-backup/errors";
+/** User-facing text of any error: localized for the package's own, as is for the app's. */
+export function errorMessage(error, t) {
+    if (error instanceof BackupError)
+        return t.errors[error.code];
+    if (error instanceof Error && error.message)
+        return error.message;
+    return t.errors.unknown;
+}
+export function showError(error, t) {
+    Alert.alert(t.errorTitle, errorMessage(error, t));
+}
+/** Resolves to true only if the user taps `confirmLabel` (not on cancel or dismiss). */
+export function askConfirmation(t, title, message, confirmLabel) {
+    return new Promise((resolve) => {
+        Alert.alert(title, message, [
+            {
+                text: t.cancel,
+                style: "cancel",
+                onPress: () => {
+                    resolve(false);
+                },
+            },
+            {
+                text: confirmLabel,
+                style: "destructive",
+                onPress: () => {
+                    resolve(true);
+                },
+            },
+        ], {
+            cancelable: true,
+            onDismiss: () => {
+                resolve(false);
+            },
+        });
+    });
+}
+/** Which backup to keep when linking an account that already holds one; null if cancelled. */
+export function askConflictChoice(t, description) {
+    return new Promise((resolve) => {
+        Alert.alert(t.conflictTitle, t.conflictMessage(description), [
+            {
+                text: t.cancel,
+                style: "cancel",
+                onPress: () => {
+                    resolve(null);
+                },
+            },
+            {
+                text: t.conflictKeepDevice,
+                style: "destructive",
+                onPress: () => {
+                    resolve("device");
+                },
+            },
+            {
+                text: t.conflictKeepCloud,
+                onPress: () => {
+                    resolve("cloud");
+                },
+            },
+        ], {
+            cancelable: true,
+            onDismiss: () => {
+                resolve(null);
+            },
+        });
+    });
+}

package/dist/hooks.d.ts

@@ -0,0 +1,10 @@
+import type { BackupManager, BackupState } from "@forthtilliath/expo-backup";
+/** The manager's state (linked account, last backup, pending upload…), re-rendering on change. */
+export declare function useBackupState<T>(manager: BackupManager<T>): BackupState;
+/**
+ * Starts the manager for the component's lifetime: reads the persisted state,
+ * retries a pending upload, flushes when the app goes to the background.
+ * Mount it once, in the root layout.
+ */
+export declare function useAutoBackup<T>(manager: BackupManager<T>): void;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE7E,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,WAAW,CAExE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAEhE"}

package/dist/hooks.js

@@ -0,0 +1,13 @@
+import { useEffect, useSyncExternalStore } from "react";
+/** The manager's state (linked account, last backup, pending upload…), re-rendering on change. */
+export function useBackupState(manager) {
+    return useSyncExternalStore(manager.subscribe, manager.getState);
+}
+/**
+ * Starts the manager for the component's lifetime: reads the persisted state,
+ * retries a pending upload, flushes when the app goes to the background.
+ * Mount it once, in the root layout.
+ */
+export function useAutoBackup(manager) {
+    useEffect(() => manager.start(), [manager]);
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./BackupScreen.js";
+export { errorMessage } from "./dialogs.js";
+export * from "./hooks.js";
+export * from "./labels.js";
+export type { BackupScreenStyles } from "./styles.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./BackupScreen.js";
+export { errorMessage } from "./dialogs.js";
+export * from "./hooks.js";
+export * from "./labels.js";

package/dist/labels.d.ts

@@ -0,0 +1,67 @@
+import type { BackupErrorCode } from "@forthtilliath/expo-backup";
+/** Languages the built-in labels are available in. */
+export type BackupLocale = "fr" | "en";
+/** Every text of the screen. Pass a partial object in `labels` to override some. */
+export interface BackupScreenLabels {
+    cloudTitle: string;
+    cloudHint: string;
+    connectButton: string;
+    connectedTitle: string;
+    connectedConfirm: (email: string) => string;
+    lastCloudBackup: (date: string) => string;
+    cloudPending: string;
+    autoHint: string;
+    syncNowButton: string;
+    restoreCloudButton: string;
+    disconnectButton: string;
+    disconnectConfirmTitle: string;
+    disconnectConfirmMessage: string;
+    conflictTitle: string;
+    conflictMessage: (description: string) => string;
+    conflictKeepDevice: string;
+    conflictKeepCloud: string;
+    noCloudBackupTitle: string;
+    noCloudBackupMessage: string;
+    fileTitle: string;
+    lastBackup: (date: string) => string;
+    fileHint: string;
+    fileHintEncrypted: string;
+    exportButton: string;
+    importButton: string;
+    undoButton: string;
+    undoConfirmTitle: string;
+    undoConfirmMessage: string;
+    undoneTitle: string;
+    restoreConfirmTitle: string;
+    restoreConfirmMessage: (description: string) => string;
+    restoreConfirmButton: string;
+    restoredTitle: string;
+    restoredMessage: string;
+    encryptionTitle: string;
+    encryptionToggle: string;
+    encryptionOptionalHint: string;
+    encryptionRequiredHint: string;
+    showRecoveryCodeButton: string;
+    enterRecoveryCodeButton: string;
+    recoveryCodeTitle: string;
+    recoveryCodeHint: string;
+    recoveryCodeInputTitle: string;
+    recoveryCodeInputHint: string;
+    recoveryCodePlaceholder: string;
+    recoveryCodeAdded: string;
+    /** Shown when the app's `describeBackup` isn't given. */
+    defaultDescription: string;
+    never: string;
+    cancel: string;
+    confirm: string;
+    close: string;
+    errorTitle: string;
+    errors: Record<BackupErrorCode, string>;
+}
+/** What `labels` accepts: any subset of the texts, error messages included. */
+export type BackupScreenLabelOverrides = Partial<Omit<BackupScreenLabels, "errors">> & {
+    errors?: Partial<BackupScreenLabels["errors"]>;
+};
+export declare const defaultLabels: Record<BackupLocale, BackupScreenLabels>;
+export declare function resolveLabels(locale: BackupLocale, overrides: BackupScreenLabelOverrides | undefined): BackupScreenLabels;
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAKlE,sDAAsD;AACtD,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;AAEvC,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAE7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IAExB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,yDAAyD;IACzD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,+EAA+E;AAC/E,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAC9C,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CACnC,GAAG;IACF,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAGlE,CAAC;AAEF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,0BAA0B,GAAG,SAAS,GAChD,kBAAkB,CAOpB"}

package/dist/labels.en.d.ts

@@ -0,0 +1,3 @@
+import type { BackupScreenLabels } from "./labels.js";
+export declare const enLabels: BackupScreenLabels;
+//# sourceMappingURL=labels.en.d.ts.map

package/dist/labels.en.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.en.d.ts","sourceRoot":"","sources":["../src/labels.en.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,QAAQ,EAAE,kBAkGtB,CAAC"}

package/dist/labels.en.js

@@ -0,0 +1,75 @@
+export const enLabels = {
+    cloudTitle: "Automatic backup",
+    cloudHint: "Link your Google account: your data is sent to your Google Drive (in a private folder only this app can see) after every change. Handy to switch phones without losing anything.",
+    connectButton: "Connect Google Drive",
+    connectedTitle: "Automatic backup enabled",
+    connectedConfirm: (email) => `Your data is now sent to the Google Drive of ${email} after every change.`,
+    lastCloudBackup: (date) => `Last upload: ${date}`,
+    cloudPending: " · upload pending…",
+    autoHint: "Uploaded automatically after every change.",
+    syncNowButton: "Back up now",
+    restoreCloudButton: "Restore from Google Drive",
+    disconnectButton: "Disconnect",
+    disconnectConfirmTitle: "Turn off automatic backup?",
+    disconnectConfirmMessage: "The last backup stays on your Google Drive, but future changes won't be sent there anymore.",
+    conflictTitle: "A backup already exists",
+    conflictMessage: (description) => `This Google account already holds a backup (${description}). Which one do you want to keep?`,
+    conflictKeepDevice: "This phone",
+    conflictKeepCloud: "Google Drive",
+    noCloudBackupTitle: "No backup",
+    noCloudBackupMessage: "Nothing has been sent to Google Drive yet.",
+    fileTitle: "Manual backup",
+    lastBackup: (date) => `Last backup: ${date}`,
+    fileHint: "A file to keep somewhere safe or move to another phone.",
+    fileHintEncrypted: "An encrypted file: unreadable without this phone's key, or its recovery code.",
+    exportButton: "Export my data",
+    importButton: "Import a backup",
+    undoButton: "Undo the last restore",
+    undoConfirmTitle: "Undo the last restore?",
+    undoConfirmMessage: "Puts the data back as it was right before the last restore. Anything done since will be lost.",
+    undoneTitle: "Data from before the restore is back.",
+    restoreConfirmTitle: "Restore this backup?",
+    restoreConfirmMessage: (description) => `Backup: ${description}. All current data will be replaced (you can undo the restore afterwards).`,
+    restoreConfirmButton: "Restore",
+    restoredTitle: "Restore complete",
+    restoredMessage: "Your data has been replaced.",
+    encryptionTitle: "Encryption",
+    encryptionToggle: "Encrypt my backups",
+    encryptionOptionalHint: "Exported files and the Google Drive copy become unreadable without the app's key. Nothing to remember: the key is kept on this phone and in your Google Drive.",
+    encryptionRequiredHint: "Your backups are always encrypted. Nothing to remember: the key is kept on this phone and in your Google Drive.",
+    showRecoveryCodeButton: "Show recovery code",
+    enterRecoveryCodeButton: "Enter a recovery code",
+    recoveryCodeTitle: "Recovery code",
+    recoveryCodeHint: "Only needed without Google Drive: write it down (or keep it in a password manager) to read your exported files on another phone. Never share it.",
+    recoveryCodeInputTitle: "Enter a recovery code",
+    recoveryCodeInputHint: "The recovery code of the phone that created the backup (Settings ▸ Backup ▸ Show recovery code).",
+    recoveryCodePlaceholder: "XXXXX-XXXXX-…",
+    recoveryCodeAdded: "Recovery code added.",
+    defaultDescription: "app data",
+    never: "never",
+    cancel: "Cancel",
+    confirm: "OK",
+    close: "Close",
+    errorTitle: "Error",
+    errors: {
+        "google-unavailable": "Google Drive backup isn't available in this version of the app.",
+        "play-services-unavailable": "Google Play services aren't available on this phone.",
+        "oauth-misconfigured": "Google doesn't recognize this version of the app (missing OAuth client or different SHA-1).",
+        "sign-in-failed": "Signing in to Google failed.",
+        "reconnect-required": "Reconnect your Google account to resume backups.",
+        "drive-api-disabled": "The Google Drive API isn't enabled in the app's Google Cloud project.",
+        "drive-permission-missing": "Access to Google Drive wasn't granted. Reconnect your account and allow Drive access.",
+        "drive-access-denied": "Google Drive denied access. Reconnect your Google account.",
+        "drive-unavailable": "Google Drive is temporarily unavailable.",
+        network: "No internet connection.",
+        "missing-key": "This backup is encrypted with a key this phone doesn't know. Enter the recovery code of the device that created it.",
+        "invalid-recovery-code": "This recovery code contains a typo.",
+        "recovery-code-mismatch": "This recovery code is valid, but it isn't the one that encrypted this file.",
+        corrupted: "This backup is damaged or was modified.",
+        "newer-format": "This backup comes from a newer version of the app. Update the app before importing it.",
+        "no-safety-backup": "No restore to undo.",
+        "sharing-unavailable": "File sharing isn't available on this device.",
+        "file-too-large": "This file is too large to be a backup of the app.",
+        unknown: "An unexpected error occurred.",
+    },
+};

package/dist/labels.fr.d.ts

@@ -0,0 +1,3 @@
+import type { BackupScreenLabels } from "./labels.js";
+export declare const frLabels: BackupScreenLabels;
+//# sourceMappingURL=labels.fr.d.ts.map

package/dist/labels.fr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.fr.d.ts","sourceRoot":"","sources":["../src/labels.fr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,QAAQ,EAAE,kBAuGtB,CAAC"}

package/dist/labels.fr.js

@@ -0,0 +1,75 @@
+export const frLabels = {
+    cloudTitle: "Sauvegarde automatique",
+    cloudHint: "Relie ton compte Google : tes données sont envoyées automatiquement sur ton Google Drive (dans un dossier privé réservé à l'app) après chaque modification. Pratique pour changer de téléphone sans rien perdre.",
+    connectButton: "Connecter Google Drive",
+    connectedTitle: "Sauvegarde automatique activée",
+    connectedConfirm: (email) => `Tes données sont désormais envoyées sur le Google Drive de ${email} après chaque modification.`,
+    lastCloudBackup: (date) => `Dernier envoi : ${date}`,
+    cloudPending: " · envoi en attente…",
+    autoHint: "Envoi automatique après chaque modification.",
+    syncNowButton: "Sauvegarder maintenant",
+    restoreCloudButton: "Restaurer depuis Google Drive",
+    disconnectButton: "Déconnecter",
+    disconnectConfirmTitle: "Désactiver la sauvegarde automatique ?",
+    disconnectConfirmMessage: "La dernière sauvegarde reste sur ton Google Drive, mais les prochaines modifications n'y seront plus envoyées.",
+    conflictTitle: "Une sauvegarde existe déjà",
+    conflictMessage: (description) => `Ce compte Google contient déjà une sauvegarde (${description}). Laquelle garder ?`,
+    conflictKeepDevice: "Ce téléphone",
+    conflictKeepCloud: "Google Drive",
+    noCloudBackupTitle: "Aucune sauvegarde",
+    noCloudBackupMessage: "Rien n'a encore été envoyé sur Google Drive.",
+    fileTitle: "Sauvegarde manuelle",
+    lastBackup: (date) => `Dernière sauvegarde : ${date}`,
+    fileHint: "Un fichier à garder précieusement ou à transférer vers un autre téléphone.",
+    fileHintEncrypted: "Un fichier chiffré : illisible sans la clé de ce téléphone, ou sa clé de secours.",
+    exportButton: "Exporter mes données",
+    importButton: "Importer une sauvegarde",
+    undoButton: "Annuler la dernière restauration",
+    undoConfirmTitle: "Annuler la dernière restauration ?",
+    undoConfirmMessage: "Remet les données telles qu'elles étaient juste avant la dernière restauration. Ce qui a été fait depuis sera perdu.",
+    undoneTitle: "Données d'avant la restauration remises en place.",
+    restoreConfirmTitle: "Restaurer cette sauvegarde ?",
+    restoreConfirmMessage: (description) => `Sauvegarde : ${description}. Toutes les données actuelles seront remplacées (tu pourras annuler la restauration ensuite).`,
+    restoreConfirmButton: "Restaurer",
+    restoredTitle: "Restauration terminée",
+    restoredMessage: "Les données ont été remplacées.",
+    encryptionTitle: "Chiffrement",
+    encryptionToggle: "Chiffrer mes sauvegardes",
+    encryptionOptionalHint: "Les fichiers exportés et la copie Google Drive deviennent illisibles sans la clé de l'app. Rien à retenir : la clé est gardée sur ce téléphone et dans ton Google Drive.",
+    encryptionRequiredHint: "Tes sauvegardes sont toujours chiffrées. Rien à retenir : la clé est gardée sur ce téléphone et dans ton Google Drive.",
+    showRecoveryCodeButton: "Afficher la clé de secours",
+    enterRecoveryCodeButton: "Saisir une clé de secours",
+    recoveryCodeTitle: "Clé de secours",
+    recoveryCodeHint: "Utile seulement sans Google Drive : note-la (ou garde-la dans un gestionnaire de mots de passe) pour relire tes fichiers exportés sur un autre téléphone. Ne la partage avec personne.",
+    recoveryCodeInputTitle: "Saisir une clé de secours",
+    recoveryCodeInputHint: "La clé de secours du téléphone qui a créé la sauvegarde (Réglages ▸ Sauvegarde ▸ Afficher la clé de secours).",
+    recoveryCodePlaceholder: "XXXXX-XXXXX-…",
+    recoveryCodeAdded: "Clé de secours ajoutée.",
+    defaultDescription: "données de l'app",
+    never: "jamais",
+    cancel: "Annuler",
+    confirm: "Valider",
+    close: "Fermer",
+    errorTitle: "Erreur",
+    errors: {
+        "google-unavailable": "La sauvegarde Google Drive n'est pas disponible dans cette version de l'app.",
+        "play-services-unavailable": "Les services Google Play sont indisponibles sur ce téléphone.",
+        "oauth-misconfigured": "Google ne reconnaît pas cette version de l'app (client OAuth absent ou empreinte SHA-1 différente).",
+        "sign-in-failed": "La connexion à Google a échoué.",
+        "reconnect-required": "Reconnecte ton compte Google pour reprendre la sauvegarde.",
+        "drive-api-disabled": "L'API Google Drive n'est pas activée dans le projet Google Cloud de l'app.",
+        "drive-permission-missing": "L'accès à Google Drive n'a pas été autorisé. Reconnecte ton compte en acceptant l'accès à Drive.",
+        "drive-access-denied": "Google Drive a refusé l'accès. Reconnecte ton compte Google.",
+        "drive-unavailable": "Google Drive est momentanément indisponible.",
+        network: "Pas de connexion internet.",
+        "missing-key": "Cette sauvegarde est chiffrée avec une clé inconnue de ce téléphone. Saisis la clé de secours de l'appareil qui l'a créée.",
+        "invalid-recovery-code": "Cette clé de secours contient une faute de frappe.",
+        "recovery-code-mismatch": "Cette clé de secours est valide, mais ce n'est pas celle qui a chiffré ce fichier.",
+        corrupted: "Cette sauvegarde est endommagée ou a été modifiée.",
+        "newer-format": "Cette sauvegarde vient d'une version plus récente de l'app. Mets l'app à jour avant de l'importer.",
+        "no-safety-backup": "Aucune restauration à annuler.",
+        "sharing-unavailable": "Le partage de fichiers n'est pas disponible sur cet appareil.",
+        "file-too-large": "Ce fichier est trop volumineux pour être une sauvegarde de l'app.",
+        unknown: "Une erreur inattendue est survenue.",
+    },
+};

package/dist/labels.js

@@ -0,0 +1,14 @@
+import { enLabels } from "./labels.en.js";
+import { frLabels } from "./labels.fr.js";
+export const defaultLabels = {
+    fr: frLabels,
+    en: enLabels,
+};
+export function resolveLabels(locale, overrides) {
+    const base = defaultLabels[locale];
+    return {
+        ...base,
+        ...overrides,
+        errors: { ...base.errors, ...overrides?.errors },
+    };
+}

package/dist/styles.d.ts

@@ -0,0 +1,39 @@
+import type { StyleProp, TextStyle, ViewStyle } from "react-native";
+/** Per-slot overrides, merged on top of the defaults (not replacing them). */
+export interface BackupScreenStyles {
+    container?: StyleProp<ViewStyle>;
+    section?: StyleProp<ViewStyle>;
+    sectionTitle?: StyleProp<TextStyle>;
+    hint?: StyleProp<TextStyle>;
+    status?: StyleProp<TextStyle>;
+    errorText?: StyleProp<TextStyle>;
+    button?: StyleProp<ViewStyle>;
+    buttonText?: StyleProp<TextStyle>;
+    secondaryButton?: StyleProp<ViewStyle>;
+    secondaryButtonText?: StyleProp<TextStyle>;
+    ghostButton?: StyleProp<ViewStyle>;
+    ghostButtonText?: StyleProp<TextStyle>;
+    buttonDisabled?: StyleProp<ViewStyle>;
+    switchRow?: StyleProp<ViewStyle>;
+    switchLabel?: StyleProp<TextStyle>;
+    modalBackdrop?: StyleProp<ViewStyle>;
+    modalCard?: StyleProp<ViewStyle>;
+    recoveryCode?: StyleProp<TextStyle>;
+    input?: StyleProp<TextStyle>;
+    /** Not a style: color of the spinners. */
+    activityIndicatorColor?: string;
+    /** Not a style: placeholder color of the recovery-code input. */
+    placeholderTextColor?: string;
+}
+type Slot = Exclude<keyof BackupScreenStyles, "activityIndicatorColor" | "placeholderTextColor">;
+export declare const defaultStyles: Record<Slot, ViewStyle | TextStyle>;
+export declare const PRIMARY_COLOR = "#2563eb";
+export type MergedStyles = Record<Slot, StyleProp<ViewStyle | TextStyle>[]> & {
+    /** Undefined: white on primary buttons, primary color elsewhere. */
+    activityIndicatorColor: string | undefined;
+    placeholderTextColor: string;
+};
+/** Each slot as `[default, override]`, so overriding one property keeps the rest. */
+export declare function mergeStyles(overrides: BackupScreenStyles | undefined): MergedStyles;
+export {};
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,eAAe,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,mBAAmB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iEAAiE;IACjE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,KAAK,IAAI,GAAG,OAAO,CACjB,MAAM,kBAAkB,EACxB,wBAAwB,GAAG,sBAAsB,CAClD,CAAC;AAIF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAgE7D,CAAC;AAEF,eAAO,MAAM,aAAa,YAAU,CAAC;AAErC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC,EAAE,CAAC,GAAG;IAC5E,oEAAoE;IACpE,sBAAsB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,WAAW,CACzB,SAAS,EAAE,kBAAkB,GAAG,SAAS,GACxC,YAAY,CAUd"}

package/dist/styles.js

@@ -0,0 +1,79 @@
+const primary = "#2563eb";
+export const defaultStyles = {
+    container: { gap: 16 },
+    section: {
+        backgroundColor: "#ffffff",
+        borderWidth: 1,
+        borderColor: "#e5e7eb",
+        borderRadius: 12,
+        padding: 16,
+        gap: 10,
+    },
+    sectionTitle: { fontSize: 16, fontWeight: "700", color: "#111827" },
+    hint: { fontSize: 13, lineHeight: 18, color: "#6b7280" },
+    status: { fontSize: 14, color: "#111827" },
+    errorText: { fontSize: 13, color: "#dc2626" },
+    button: {
+        backgroundColor: primary,
+        borderRadius: 10,
+        paddingVertical: 12,
+        paddingHorizontal: 16,
+        alignItems: "center",
+    },
+    buttonText: { color: "#ffffff", fontSize: 15, fontWeight: "600" },
+    secondaryButton: {
+        backgroundColor: "transparent",
+        borderWidth: 1,
+        borderColor: primary,
+    },
+    secondaryButtonText: { color: primary },
+    ghostButton: { backgroundColor: "transparent" },
+    ghostButtonText: { color: "#6b7280" },
+    buttonDisabled: { opacity: 0.5 },
+    switchRow: {
+        flexDirection: "row",
+        alignItems: "center",
+        justifyContent: "space-between",
+    },
+    switchLabel: { flex: 1, fontSize: 15, color: "#111827" },
+    modalBackdrop: {
+        flex: 1,
+        justifyContent: "center",
+        padding: 24,
+        backgroundColor: "rgba(0,0,0,0.5)",
+    },
+    modalCard: {
+        backgroundColor: "#ffffff",
+        borderRadius: 12,
+        padding: 20,
+        gap: 12,
+    },
+    recoveryCode: {
+        fontSize: 17,
+        lineHeight: 26,
+        fontFamily: "monospace",
+        letterSpacing: 1,
+        color: "#111827",
+    },
+    input: {
+        borderWidth: 1,
+        borderColor: "#d1d5db",
+        borderRadius: 8,
+        padding: 12,
+        fontFamily: "monospace",
+        color: "#111827",
+    },
+};
+export const PRIMARY_COLOR = primary;
+/** Each slot as `[default, override]`, so overriding one property keeps the rest. */
+export function mergeStyles(overrides) {
+    const merged = {};
+    for (const slot of Object.keys(defaultStyles)) {
+        merged[slot] = [defaultStyles[slot], overrides?.[slot]];
+    }
+    return {
+        ...merged,
+        activityIndicatorColor: overrides?.activityIndicatorColor,
+        placeholderTextColor: overrides?.placeholderTextColor ?? "#9ca3af",
+    };
+}

package/dist/useBackupUi.d.ts

@@ -0,0 +1,35 @@
+import type { BackupManager, BackupState } from "@forthtilliath/expo-backup";
+import type { BackupScreenLabels } from "./labels.js";
+import type { MergedStyles } from "./styles.js";
+/** What every section of the screen shares. */
+export interface BackupUi<T> {
+    manager: BackupManager<T>;
+    state: BackupState;
+    t: BackupScreenLabels;
+    styles: MergedStyles;
+    /** One action at a time for the whole screen: a second tap is ignored, errors are alerted. */
+    busy: boolean;
+    run: (action: () => Promise<void>) => Promise<void>;
+    describe: (data: T) => string;
+    formatDate: (epochMs: number | null) => string;
+    /** Confirms with a description of `data`, restores it, tells the user. */
+    confirmAndRestore: (data: T, source: "file" | "cloud") => Promise<void>;
+    /** Opens the recovery-code input; null if the user closes it. */
+    askRecoveryCode: (error?: string) => Promise<string | null>;
+}
+export interface RecoveryPrompt {
+    error: string | undefined;
+    resolve: (code: string | null) => void;
+}
+export declare function useBackupUi<T>({ manager, t, styles, describeBackup, dateLocale, onRestored, }: {
+    manager: BackupManager<T>;
+    t: BackupScreenLabels;
+    styles: MergedStyles;
+    describeBackup: ((data: T) => string) | undefined;
+    dateLocale: string;
+    onRestored: ((data: T) => void) | undefined;
+}): {
+    ui: BackupUi<T>;
+    recoveryPrompt: RecoveryPrompt | null;
+};
+//# sourceMappingURL=useBackupUi.d.ts.map

package/dist/useBackupUi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackupUi.d.ts","sourceRoot":"","sources":["../src/useBackupUi.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,CAAC,EAAE,kBAAkB,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,8FAA8F;IAC9F,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC9B,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC;IAC/C,0EAA0E;IAC1E,iBAAiB,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,iEAAiE;IACjE,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACxC;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAC7B,OAAO,EACP,CAAC,EACD,MAAM,EACN,cAAc,EACd,UAAU,EACV,UAAU,GACX,EAAE;IACD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,EAAE,kBAAkB,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7C,GAAG;IAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAqE7D"}

package/dist/useBackupUi.js

@@ -0,0 +1,65 @@
+import { useRef, useState } from "react";
+import { Alert } from "react-native";
+import { askConfirmation, showError } from "./dialogs.js";
+import { useBackupState } from "./hooks.js";
+export function useBackupUi({ manager, t, styles, describeBackup, dateLocale, onRestored, }) {
+    const state = useBackupState(manager);
+    const [busy, setBusy] = useState(false);
+    // A ref, not `busy`: two taps handled before the re-render would both
+    // still read the stale `false`.
+    const inFlightRef = useRef(false);
+    const [recoveryPrompt, setRecoveryPrompt] = useState(null);
+    async function run(action) {
+        if (inFlightRef.current)
+            return;
+        inFlightRef.current = true;
+        setBusy(true);
+        try {
+            await action();
+        }
+        catch (error) {
+            showError(error, t);
+        }
+        finally {
+            inFlightRef.current = false;
+            setBusy(false);
+        }
+    }
+    const describe = (data) => describeBackup?.(data) ?? t.defaultDescription;
+    async function confirmAndRestore(data, source) {
+        const confirmed = await askConfirmation(t, t.restoreConfirmTitle, t.restoreConfirmMessage(describe(data)), t.restoreConfirmButton);
+        if (!confirmed)
+            return;
+        await manager.restore(data, { source });
+        Alert.alert(t.restoredTitle, t.restoredMessage);
+        onRestored?.(data);
+    }
+    function askRecoveryCode(error) {
+        return new Promise((resolve) => {
+            setRecoveryPrompt({
+                error,
+                resolve: (code) => {
+                    setRecoveryPrompt(null);
+                    resolve(code);
+                },
+            });
+        });
+    }
+    return {
+        ui: {
+            manager,
+            state,
+            t,
+            styles,
+            busy,
+            run,
+            describe,
+            formatDate: (epochMs) => epochMs === null
+                ? t.never
+                : new Date(epochMs).toLocaleString(dateLocale),
+            confirmAndRestore,
+            askRecoveryCode,
+        },
+        recoveryPrompt,
+    };
+}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@forthtilliath/expo-backup-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "type": "module",
+  "sideEffects": false,
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Forthtilliath/forthtilliath-packages.git",
+    "directory": "packages/expo-backup-ui"
+  },
+  "homepage": "https://github.com/Forthtilliath/forthtilliath-packages/tree/main/packages/expo-backup-ui#readme",
+  "bugs": "https://github.com/Forthtilliath/forthtilliath-packages/issues",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./dist/*.js"
+  },
+  "dependencies": {
+    "@forthtilliath/expo-backup": "^0.2.0"
+  },
+  "peerDependencies": {
+    "react": ">=19",
+    "react-native": ">=0.81"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.18",
+    "@types/react-test-renderer": "^19.1.0",
+    "@vitest/coverage-v8": "5.0.2",
+    "eslint": "10.7.0",
+    "react": "^19.2.8",
+    "react-native": "0.86.0",
+    "react-test-renderer": "19.2.3",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.2",
+    "@forthtilliath/typescript-config": "0.1.1",
+    "@forthtilliath/eslint-config": "0.9.0"
+  },
+  "scripts": {
+    "lint": "eslint . --max-warnings 0",
+    "check-types": "tsc --noEmit",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "dev": "tsc --watch -p tsconfig.build.json",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage"
+  }
 }