@micha.bigler/ui-core-micha 4.6.0 → 4.7.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 4.7.1 - UCM-BILL-4
+
+The withdrawal dialog no longer says the subscription will not renew for a token package: for `kind: token_package` it says that the unused tokens of the purchase are removed (`Billing.WITHDRAWAL_EFFECT_TOKENS`, de, de_informal, en, fr, sw).
+
+## 4.7.0 - UCM-RCPT-1
+
+Shared receipt capture and review, against the `django-core-micha` receipts module (DCM-RCPT-1; `consent/` and `read/`
+under `apiBase`, default `/api/receipts/`). `ReceiptCaptureCard` offers the camera (`capture="environment"`) and a file
+button for JPG, PNG, HEIC and PDF, scales large JPEG and PNG files on the device (HEIC and PDF pass through; at most
+10 MB), shows the progress while the receipt is read and the recognised boxes on the image, and the edge states (no
+consent, nothing recognised, recognition unavailable, file not readable). Without consent it shows the consent switch
+and, when the host gives `onUploadOnly`, an upload-only path. `ReceiptReviewDialog` (a sheet on phones) lists each
+recognised value next to the form's current one with "Apply", "Only empty fields" and "Apply all"; the host passes its
+form values, field labels and extra fields and receives only the chosen values (`onApply(values, { mode })`).
+`ReceiptPicker` selects among several receipts in one photo (low confidence starts unselected). `ReceiptConsentSwitch`
+reads and writes the user's own consent and works on a profile page too; the text names the `provider` the host passes.
+Also `useReceiptConsent`, `createReceiptsApi` / `defaultReceiptsApi` (every function overridable), `receiptFileProblem`,
+`prepareReceiptFile` and `receiptsTranslations` (de/en/fr/sw, part of `uiCoreTranslations`). The kit stores nothing; the
+app keeps its form and its files.
+
 ## 4.6.0 - UCM-CHAT-6
 
 Plain model choice, summary and cost on the shared chat surface, against `django-core-micha` 3.5.0 (DCM-CHAT-13).

package/dist/billing/WithdrawalDialog.js

@@ -90,6 +90,6 @@ export function WithdrawalDialog({ open, purchase, api, onClose, onWithdrawn })
         onClose === null || onClose === void 0 ? void 0 : onClose(); };
     const amount = formatPrice(preview === null || preview === void 0 ? void 0 : preview.refund_cents, i18n.language, preview === null || preview === void 0 ? void 0 : preview.currency);
     const none = !(Number(preview === null || preview === void 0 ? void 0 : preview.refund_cents) > 0);
-    return _jsxs(Dialog, { open: open, onClose: close, disableEscapeKeyDown: state === 'submitting', fullWidth: true, maxWidth: "sm", "aria-labelledby": titleId, children: [_jsx(DialogTitle, { id: titleId, children: t(state === 'success' ? 'Billing.WITHDRAWAL_DONE' : 'Billing.WITHDRAWAL_TITLE') }), _jsxs(DialogContent, { children: [state === 'loading' && _jsxs(Stack, { direction: "row", spacing: 1, alignItems: "center", role: "status", children: [_jsx(CircularProgress, { size: 20 }), _jsx(Typography, { children: t('Billing.LOADING') })] }), state === 'preview_error' && _jsx(Alert, { severity: "error", sx: WITHDRAWAL_DIALOG_ALERT_SX, children: t('Billing.WITHDRAWAL_PREVIEW_ERROR') }), (state === 'not_possible') && _jsx(Alert, { severity: "info", children: t('Billing.WITHDRAWAL_NOT_POSSIBLE') }), (state === 'ready' || state === 'submitting' || state === 'confirm_error') && _jsxs(Stack, { spacing: 1, children: [_jsx(Typography, { children: t('Billing.WITHDRAWAL_EFFECT') }), _jsx(Typography, { children: none ? t('Billing.WITHDRAWAL_REFUND_NONE') : t('Billing.WITHDRAWAL_REFUND', { amount }) }), _jsx(Typography, { children: t('Billing.WITHDRAWAL_CALCULATION', { explanation: describeCalculation(Object.assign(Object.assign({}, preview), { kind: purchase === null || purchase === void 0 ? void 0 : purchase.kind }), t, i18n.language) }) }), state === 'confirm_error' && _jsx(Alert, { severity: "error", sx: WITHDRAWAL_DIALOG_ALERT_SX, children: t('Billing.WITHDRAWAL_ERROR') }), state === 'submitting' && _jsxs(Typography, { role: "status", children: [_jsx(CircularProgress, { size: 16 }), " ", t('Billing.LOADING')] })] }), state === 'success' && _jsx(Typography, { children: t('Billing.WITHDRAWAL_DONE_DETAIL', { date: formatDateTime(result === null || result === void 0 ? void 0 : result.withdrawn_at, i18n.language) }) })] }), _jsx(DialogActions, { children: state === 'ready' || state === 'confirm_error' ? _jsxs(_Fragment, { children: [_jsx(Button, { onClick: close, disabled: state === 'submitting', children: t('Billing.WITHDRAWAL_CANCEL') }), _jsx(Button, { variant: "contained", onClick: confirm, disabled: state === 'submitting', children: t('Billing.WITHDRAWAL_CONFIRM') })] }) : state === 'preview_error' ? _jsxs(_Fragment, { children: [_jsx(Button, { onClick: close, children: t('Billing.WITHDRAWAL_CLOSE') }), _jsx(Button, { onClick: () => setAttempt((n) => n + 1), children: t('Billing.RETRY') })] }) : (state === 'success' || state === 'not_possible') && _jsx(Button, { onClick: close, children: t('Billing.WITHDRAWAL_CLOSE') }) })] });
+    return _jsxs(Dialog, { open: open, onClose: close, disableEscapeKeyDown: state === 'submitting', fullWidth: true, maxWidth: "sm", "aria-labelledby": titleId, children: [_jsx(DialogTitle, { id: titleId, children: t(state === 'success' ? 'Billing.WITHDRAWAL_DONE' : 'Billing.WITHDRAWAL_TITLE') }), _jsxs(DialogContent, { children: [state === 'loading' && _jsxs(Stack, { direction: "row", spacing: 1, alignItems: "center", role: "status", children: [_jsx(CircularProgress, { size: 20 }), _jsx(Typography, { children: t('Billing.LOADING') })] }), state === 'preview_error' && _jsx(Alert, { severity: "error", sx: WITHDRAWAL_DIALOG_ALERT_SX, children: t('Billing.WITHDRAWAL_PREVIEW_ERROR') }), (state === 'not_possible') && _jsx(Alert, { severity: "info", children: t('Billing.WITHDRAWAL_NOT_POSSIBLE') }), (state === 'ready' || state === 'submitting' || state === 'confirm_error') && _jsxs(Stack, { spacing: 1, children: [_jsx(Typography, { children: t((purchase === null || purchase === void 0 ? void 0 : purchase.kind) === 'token_package' ? 'Billing.WITHDRAWAL_EFFECT_TOKENS' : 'Billing.WITHDRAWAL_EFFECT') }), _jsx(Typography, { children: none ? t('Billing.WITHDRAWAL_REFUND_NONE') : t('Billing.WITHDRAWAL_REFUND', { amount }) }), _jsx(Typography, { children: t('Billing.WITHDRAWAL_CALCULATION', { explanation: describeCalculation(Object.assign(Object.assign({}, preview), { kind: purchase === null || purchase === void 0 ? void 0 : purchase.kind }), t, i18n.language) }) }), state === 'confirm_error' && _jsx(Alert, { severity: "error", sx: WITHDRAWAL_DIALOG_ALERT_SX, children: t('Billing.WITHDRAWAL_ERROR') }), state === 'submitting' && _jsxs(Typography, { role: "status", children: [_jsx(CircularProgress, { size: 16 }), " ", t('Billing.LOADING')] })] }), state === 'success' && _jsx(Typography, { children: t('Billing.WITHDRAWAL_DONE_DETAIL', { date: formatDateTime(result === null || result === void 0 ? void 0 : result.withdrawn_at, i18n.language) }) })] }), _jsx(DialogActions, { children: state === 'ready' || state === 'confirm_error' ? _jsxs(_Fragment, { children: [_jsx(Button, { onClick: close, disabled: state === 'submitting', children: t('Billing.WITHDRAWAL_CANCEL') }), _jsx(Button, { variant: "contained", onClick: confirm, disabled: state === 'submitting', children: t('Billing.WITHDRAWAL_CONFIRM') })] }) : state === 'preview_error' ? _jsxs(_Fragment, { children: [_jsx(Button, { onClick: close, children: t('Billing.WITHDRAWAL_CLOSE') }), _jsx(Button, { onClick: () => setAttempt((n) => n + 1), children: t('Billing.RETRY') })] }) : (state === 'success' || state === 'not_possible') && _jsx(Button, { onClick: close, children: t('Billing.WITHDRAWAL_CLOSE') }) })] });
 }
 export default WithdrawalDialog;

package/dist/i18n/billingTranslations.js

@@ -44,6 +44,7 @@ export const billingTranslations = {
     'Billing.WITHDRAWAL_UNTIL': { de: 'bis {{date}}', de_informal: 'bis {{date}}', en: 'until {{date}}', fr: 'jusqu’au {{date}}', sw: 'hadi {{date}}' },
     'Billing.WITHDRAWAL_TITLE': { de: 'Vertrag widerrufen?', de_informal: 'Vertrag widerrufen?', en: 'Withdraw this contract?', fr: 'Révoquer ce contrat ?', sw: 'Uondoe mkataba huu?' },
     'Billing.WITHDRAWAL_EFFECT': { de: 'Mit dem Widerruf endet der Zugang aus diesem Kauf sofort, und das Abo verlängert sich nicht.', de_informal: 'Mit dem Widerruf endet der Zugang aus diesem Kauf sofort, und das Abo verlängert sich nicht.', en: 'With the withdrawal, access from this purchase ends immediately and the subscription will not renew.', fr: 'La révocation met immédiatement fin à l’accès lié à cet achat et l’abonnement ne sera pas renouvelé.', sw: 'Ukiondoa, ufikiaji wa ununuzi huu utaisha mara moja na usajili hautasasishwa.' },
+    'Billing.WITHDRAWAL_EFFECT_TOKENS': { de: 'Mit dem Widerruf werden die noch nicht verbrauchten Token aus diesem Kauf entfernt.', de_informal: 'Mit dem Widerruf werden die noch nicht verbrauchten Token aus diesem Kauf entfernt.', en: 'Withdrawing removes the unused tokens from this purchase.', fr: 'La révocation supprime les jetons non utilisés de cet achat.', sw: 'Kuondoa kunaondoa tokeni ambazo hazijatumika za ununuzi huu.' },
     'Billing.WITHDRAWAL_REFUND': { de: 'Sie erhalten {{amount}} zurück.', de_informal: 'Du erhältst {{amount}} zurück.', en: 'You will receive {{amount}} back.', fr: 'Vous recevrez {{amount}} en remboursement.', sw: 'Utarejeshewa {{amount}}.' },
     'Billing.WITHDRAWAL_REFUND_NONE': { de: 'Sie erhalten keine Rückzahlung.', de_informal: 'Du erhältst keine Rückzahlung.', en: 'You will receive no refund.', fr: 'Vous ne recevrez aucun remboursement.', sw: 'Hutapokea marejesho ya pesa.' },
     'Billing.WITHDRAWAL_CALCULATION': { de: 'Berechnung: {{explanation}}', de_informal: 'Berechnung: {{explanation}}', en: 'Calculation: {{explanation}}', fr: 'Calcul : {{explanation}}', sw: 'Hesabu: {{explanation}}' },

package/dist/i18n/receiptsTranslations.js

@@ -0,0 +1,38 @@
+export const receiptsTranslations = {
+    'Receipts.CAMERA': { de: 'Beleg fotografieren', en: 'Take a receipt photo', fr: 'Photographier un reçu', sw: 'Piga picha ya risiti' },
+    'Receipts.PICK_FILE': { de: 'Datei wählen', en: 'Choose a file', fr: 'Choisir un fichier', sw: 'Chagua faili' },
+    'Receipts.ACCEPTED_TYPES': { de: 'JPG, PNG, HEIC oder PDF', en: 'JPG, PNG, HEIC or PDF', fr: 'JPG, PNG, HEIC ou PDF', sw: 'JPG, PNG, HEIC au PDF' },
+    'Receipts.READING': { de: 'Beleg wird gelesen …', en: 'Reading receipt …', fr: 'Lecture du reçu …', sw: 'Risiti inasomwa …' },
+    'Receipts.ANOTHER': { de: 'Anderer Beleg', en: 'Another receipt', fr: 'Un autre reçu', sw: 'Risiti nyingine' },
+    'Receipts.REVIEW_TITLE': { de: 'Erkannte Werte', en: 'Recognised values', fr: 'Valeurs reconnues', sw: 'Thamani zilizotambuliwa' },
+    'Receipts.SAME_AS_FORM': { de: 'wie im Formular', en: 'same as in the form', fr: 'identique au formulaire', sw: 'sawa na iliyo kwenye fomu' },
+    'Receipts.APPLY': { de: 'Übernehmen', en: 'Apply', fr: 'Appliquer', sw: 'Tumia' },
+    'Receipts.ONLY_EMPTY': { de: 'Nur leere Felder', en: 'Empty fields only', fr: 'Champs vides uniquement', sw: 'Sehemu tupu pekee' },
+    'Receipts.APPLY_ALL': { de: 'Alle übernehmen', en: 'Apply all', fr: 'Tout appliquer', sw: 'Tumia zote' },
+    'Receipts.CLOSE': { de: 'Schliessen', en: 'Close', fr: 'Fermer', sw: 'Funga' },
+    'Receipts.CERTAIN': { de: 'sicher', en: 'confident', fr: 'sûr', sw: 'uhakika' },
+    'Receipts.UNCERTAIN': { de: 'unsicher', en: 'uncertain', fr: 'incertain', sw: 'si ya uhakika' },
+    'Receipts.RECOGNISED_COUNT': { de: '{{n}} Belege erkannt', en: '{{n}} receipts recognised', fr: '{{n}} reçus reconnus', sw: 'Risiti {{n}} zimetambuliwa' },
+    'Receipts.APPLY_COUNT': { de: '{{n}} übernehmen', en: 'Apply {{n}}', fr: 'Appliquer {{n}}', sw: 'Tumia {{n}}' },
+    'Receipts.UNREADABLE': { de: 'Unleserlich', en: 'Unreadable', fr: 'Illisible', sw: 'Haijasomeka' },
+    'Receipts.AMOUNT_UNKNOWN': { de: 'Betrag nicht erkannt', en: 'Amount not recognised', fr: 'Montant non reconnu', sw: 'Kiasi hakikutambuliwa' },
+    'Receipts.CONSENT': { de: 'Belege dürfen für die automatische Erkennung an {{provider}} übermittelt werden. Jederzeit widerrufbar.', en: 'Receipts may be sent to {{provider}} for automatic recognition. You can withdraw consent at any time.', fr: 'Les reçus peuvent être transmis à {{provider}} pour reconnaissance automatique. Vous pouvez retirer votre consentement à tout moment.', sw: 'Risiti zinaweza kutumwa kwa {{provider}} ili zitambuliwe kiotomatiki. Unaweza kuondoa ruhusa wakati wowote.' },
+    'Receipts.UPLOAD_ONLY': { de: 'Nur hochladen', en: 'Upload only', fr: 'Téléverser uniquement', sw: 'Pakia pekee' },
+    'Receipts.NOTHING_RECOGNISED': { de: 'Auf diesem Beleg wurden keine Angaben erkannt. Bitte von Hand erfassen.', en: 'No details were recognised on this receipt. Please enter them manually.', fr: 'Aucune information n’a été reconnue sur ce reçu. Veuillez les saisir manuellement.', sw: 'Hakuna maelezo yaliyotambuliwa kwenye risiti hii. Tafadhali yaweke mwenyewe.' },
+    'Receipts.UNAVAILABLE': { de: 'Die Belegerkennung ist im Moment nicht verfügbar. Bitte von Hand erfassen.', en: 'Receipt recognition is unavailable right now. Please enter the details manually.', fr: 'La reconnaissance des reçus est momentanément indisponible. Veuillez saisir les informations manuellement.', sw: 'Utambuzi wa risiti haupatikani kwa sasa. Tafadhali weka maelezo mwenyewe.' },
+    'Receipts.FILE_PROBLEM': { de: 'Diese Datei kann nicht gelesen werden. Erlaubt sind JPG, PNG, HEIC und PDF bis 10 MB.', en: 'This file cannot be read. JPG, PNG, HEIC and PDF files up to 10 MB are allowed.', fr: 'Impossible de lire ce fichier. Les fichiers JPG, PNG, HEIC et PDF jusqu’à 10 Mo sont acceptés.', sw: 'Faili hii haiwezi kusomwa. JPG, PNG, HEIC na PDF hadi MB 10 zinaruhusiwa.' },
+    'Receipts.FIELD_merchant': { de: 'Händler', en: 'Merchant', fr: 'Commerçant', sw: 'Muuzaji' },
+    'Receipts.FIELD_date': { de: 'Datum', en: 'Date', fr: 'Date', sw: 'Tarehe' },
+    'Receipts.FIELD_total': { de: 'Betrag', en: 'Amount', fr: 'Montant', sw: 'Kiasi' },
+    'Receipts.FIELD_currency': { de: 'Währung', en: 'Currency', fr: 'Devise', sw: 'Sarafu' },
+    'Receipts.FIELD_payment_method': { de: 'Zahlungsart', en: 'Payment method', fr: 'Mode de paiement', sw: 'Njia ya malipo' },
+    'Receipts.FIELD_account': { de: 'Konto', en: 'Account', fr: 'Compte', sw: 'Akaunti' },
+    'Receipts.FIELD_items': { de: 'Positionen', en: 'Line items', fr: 'Articles', sw: 'Vipengee' },
+    'Receipts.CARD_LABEL': { de: 'Beleg', en: 'Receipt', fr: 'Reçu', sw: 'Risiti' },
+    'Receipts.CANCEL': { de: 'Abbrechen', en: 'Cancel', fr: 'Annuler', sw: 'Ghairi' },
+    'Receipts.PAYMENT_cash': { de: 'Bar', en: 'Cash', fr: 'Espèces', sw: 'Taslimu' },
+    'Receipts.PAYMENT_card': { de: 'Karte', en: 'Card', fr: 'Carte', sw: 'Kadi' },
+    'Receipts.PAYMENT_other': { de: 'Andere', en: 'Other', fr: 'Autre', sw: 'Nyingine' },
+    'Receipts.CONSENT_ERROR': { de: 'Die Einwilligung konnte nicht geladen werden.', en: 'Consent could not be loaded.', fr: 'Impossible de charger le consentement.', sw: 'Ruhusa haikuweza kupakiwa.' },
+    'Receipts.RETRY': { de: 'Erneut versuchen', en: 'Try again', fr: 'Réessayer', sw: 'Jaribu tena' },
+};

package/dist/i18n/uiCoreTranslations.js

@@ -15,10 +15,11 @@ import { chartsTranslations } from './chartsTranslations';
 import { chatTranslations } from './chatTranslations';
 import { messagingTranslations } from './messagingTranslations';
 import { notificationsTranslations } from './notificationsTranslations';
+import { receiptsTranslations } from './receiptsTranslations';
 import { onboardingTranslations } from './onboardingTranslations';
 import { sectionNavTranslations } from './sectionNavTranslations';
 import { userMenuTranslations } from './userMenuTranslations';
-export const uiCoreTranslations = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, authTranslations), billingTranslations), chartsTranslations), chatTranslations), messagingTranslations), notificationsTranslations), onboardingTranslations), sectionNavTranslations), userMenuTranslations);
+export const uiCoreTranslations = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, authTranslations), billingTranslations), chartsTranslations), chatTranslations), messagingTranslations), notificationsTranslations), receiptsTranslations), onboardingTranslations), sectionNavTranslations), userMenuTranslations);
 export function createUiCoreTranslations({ germanVariant = 'formal' } = {}) {
     return Object.fromEntries(Object.entries(uiCoreTranslations).map(([key, value]) => {
         const { de_informal } = value, rest = __rest(value, ["de_informal"]);

package/dist/index.js

@@ -99,4 +99,13 @@ export { chartsTranslations } from './i18n/chartsTranslations';
 export { messagingTranslations } from './i18n/messagingTranslations';
 export { chatTranslations } from './i18n/chatTranslations';
 export { billingTranslations } from './i18n/billingTranslations';
+export { receiptsTranslations } from './i18n/receiptsTranslations';
+export { ReceiptCaptureCard } from './receipts/ReceiptCaptureCard';
+export { ReceiptReviewDialog } from './receipts/ReceiptReviewDialog';
+export { ReceiptPicker } from './receipts/ReceiptPicker';
+export { ReceiptConsentSwitch } from './receipts/ReceiptConsentSwitch';
+export { useReceiptConsent } from './receipts/useReceiptConsent';
+export { createReceiptsApi, defaultReceiptsApi } from './receipts/api';
+export { receiptFileProblem, prepareReceiptFile } from './receipts/files';
+export { RECEIPT_ACCEPT, RECEIPT_MAX_BYTES } from './receipts/wire';
 export { createUiCoreTranslations, uiCoreTranslations } from './i18n/uiCoreTranslations';

package/dist/receipts/ReceiptCaptureCard.js

@@ -0,0 +1,119 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useEffect, useRef, useState } from 'react';
+import { Alert, Box, Button, Card, CardContent, LinearProgress, Paper, Stack, Typography } from '@mui/material';
+import { useTranslation } from 'react-i18next';
+import { defaultReceiptsApi } from './api';
+import { RECEIPT_ACCEPT } from './wire';
+import { prepareReceiptFile, receiptFileProblem } from './files';
+import { useReceiptConsent } from './useReceiptConsent';
+import ReceiptConsentSwitch from './ReceiptConsentSwitch';
+import ReceiptPicker from './ReceiptPicker';
+import ReceiptReviewDialog from './ReceiptReviewDialog';
+export const RECEIPT_CAPTURE_CARD_SX = { width: '100%' };
+export const RECEIPT_CAPTURE_ALERT_SX = { width: '100%' };
+export const RECEIPT_CAPTURE_ACTION_SX = { flex: '1 1 auto' };
+export const RECEIPT_CAPTURE_PROGRESS_SX = { width: '100%' };
+const ERROR_TEXT = { unsupported_file_type: 'file', file_too_large: 'file', invalid_request: 'file', nothing_recognised: 'nothing', provider_unavailable: 'unavailable', spend_cap_reached: 'unavailable', count_limit_reached: 'unavailable', authentication_required: 'unavailable' };
+const problemCode = (error) => { var _a, _b; return ((_b = (_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.data) === null || _b === void 0 ? void 0 : _b.code) || 'provider_unavailable'; };
+export function ReceiptCaptureCard({ api = defaultReceiptsApi, provider = 'OpenAI', context, values, fieldLabels, extraFields, accountLabel, onApply, onSelectReceipts, confirmLabel, onUploadOnly, onFile, onReset, disabled, sx }) {
+    const { t } = useTranslation();
+    const consent = useReceiptConsent(api);
+    const [phase, setPhase] = useState('idle'), [error, setError] = useState(null), [receipt, setReceipt] = useState(null), [receipts, setReceipts] = useState([]), [progress, setProgress] = useState(null), [reviewOpen, setReviewOpen] = useState(false);
+    const [file, setFile] = useState(null), [preview, setPreview] = useState(null);
+    const cameraRef = useRef(null), fileRef = useRef(null), uploadRef = useRef(null), abortRef = useRef(null), urlRef = useRef(null);
+    const clearUrl = () => { if (urlRef.current)
+        URL.revokeObjectURL(urlRef.current); urlRef.current = null; setPreview(null); };
+    const reset = () => { var _a; (_a = abortRef.current) === null || _a === void 0 ? void 0 : _a.abort(); abortRef.current = null; clearUrl(); setFile(null); setReceipt(null); setReceipts([]); setProgress(null); setError(null); setPhase('idle'); setReviewOpen(false); onReset === null || onReset === void 0 ? void 0 : onReset(); };
+    useEffect(() => () => { var _a; (_a = abortRef.current) === null || _a === void 0 ? void 0 : _a.abort(); if (urlRef.current)
+        URL.revokeObjectURL(urlRef.current); }, []);
+    useEffect(() => { var _a; if (consent.status === 'ready' && !consent.granted && phase === 'reading') {
+        (_a = abortRef.current) === null || _a === void 0 ? void 0 : _a.abort();
+        setPhase('idle');
+    } }, [consent.status, consent.granted, phase]);
+    const choose = async (raw, uploadOnly = false) => {
+        var _a, _b, _c;
+        const incoming = ((_b = (_a = raw === null || raw === void 0 ? void 0 : raw.target) === null || _a === void 0 ? void 0 : _a.files) === null || _b === void 0 ? void 0 : _b[0]) || raw;
+        if (raw === null || raw === void 0 ? void 0 : raw.target)
+            raw.target.value = '';
+        if (!incoming)
+            return;
+        (_c = abortRef.current) === null || _c === void 0 ? void 0 : _c.abort();
+        clearUrl();
+        setError(null);
+        setReceipt(null);
+        setReceipts([]);
+        setReviewOpen(false);
+        let issue = receiptFileProblem(incoming, { checkSize: uploadOnly });
+        if (issue) {
+            setError(issue);
+            setPhase('error');
+            return;
+        }
+        if (uploadOnly) {
+            onUploadOnly === null || onUploadOnly === void 0 ? void 0 : onUploadOnly(incoming);
+            return;
+        }
+        const controller = new AbortController();
+        abortRef.current = controller;
+        setPhase('reading');
+        setProgress(null);
+        try {
+            const prepared = await prepareReceiptFile(incoming);
+            issue = receiptFileProblem(prepared);
+            if (controller.signal.aborted)
+                return;
+            if (issue) {
+                setError(issue);
+                setPhase('error');
+                return;
+            }
+            setFile(prepared);
+            onFile === null || onFile === void 0 ? void 0 : onFile(prepared);
+            if (['image/jpeg', 'image/png'].includes(prepared.type.toLowerCase()) && !/\.(heic|heif)$/i.test(prepared.name)) {
+                try {
+                    urlRef.current = URL.createObjectURL(prepared);
+                    setPreview(urlRef.current);
+                }
+                catch (_d) { /* preview is optional */ }
+            }
+            const result = await api.readReceipts(prepared, { context, signal: controller.signal, onUploadProgress: (e) => setProgress((e === null || e === void 0 ? void 0 : e.total) ? Math.round((e.loaded / e.total) * 100) : null) });
+            if (controller.signal.aborted)
+                return;
+            const list = Array.isArray(result) ? result : [];
+            if (!list.length) {
+                clearUrl();
+                setFile(null);
+                setError('nothing_recognised');
+                setPhase('error');
+                return;
+            }
+            setReceipts(list);
+            if (list.length === 1) {
+                setReceipt(list[0]);
+                setPhase('review');
+                setReviewOpen(true);
+            }
+            else
+                setPhase('picker');
+        }
+        catch (e) {
+            if (!controller.signal.aborted) {
+                const code = problemCode(e);
+                if (code === 'consent_required') {
+                    consent.reload();
+                    setPhase('idle');
+                }
+                else {
+                    setError(code);
+                    setPhase('error');
+                }
+            }
+        }
+    };
+    const errKey = error && ERROR_TEXT[error];
+    const overlayBoxes = receipt ? [receipt.box, ...(receipt.items || []).map((i) => i.box)].filter((b) => b && b.w > 0 && b.h > 0) : [];
+    const camera = _jsx("input", { ref: cameraRef, hidden: true, type: "file", accept: "image/*", capture: "environment", onChange: choose });
+    const chooser = _jsx("input", { ref: fileRef, hidden: true, type: "file", accept: RECEIPT_ACCEPT, onChange: choose });
+    return _jsx(Paper, { component: "section", "aria-label": t('Receipts.CARD_LABEL'), sx: [RECEIPT_CAPTURE_CARD_SX, ...(Array.isArray(sx) ? sx : sx ? [sx] : [])], children: _jsx(Card, { variant: "outlined", children: _jsx(CardContent, { children: _jsxs(Stack, { spacing: 2, children: [_jsx(ReceiptConsentSwitch, { api: api, provider: provider, consent: consent }), !consent.granted && _jsx(_Fragment, { children: onUploadOnly && _jsxs(_Fragment, { children: [_jsx(Button, { disabled: disabled, onClick: () => { var _a; return (_a = uploadRef.current) === null || _a === void 0 ? void 0 : _a.click(); }, children: t('Receipts.UPLOAD_ONLY') }), _jsx("input", { ref: uploadRef, hidden: true, type: "file", accept: RECEIPT_ACCEPT, onChange: (e) => choose(e, true) })] }) }), consent.status === 'loading' && _jsx(LinearProgress, { sx: RECEIPT_CAPTURE_PROGRESS_SX }), consent.granted && _jsxs(_Fragment, { children: [_jsxs(Stack, { direction: { xs: 'column', sm: 'row' }, spacing: 1, children: [camera, chooser, _jsx(Button, { sx: RECEIPT_CAPTURE_ACTION_SX, variant: "contained", disabled: disabled || phase === 'reading', onClick: () => { var _a; return (_a = cameraRef.current) === null || _a === void 0 ? void 0 : _a.click(); }, children: t('Receipts.CAMERA') }), _jsx(Button, { sx: RECEIPT_CAPTURE_ACTION_SX, disabled: disabled || phase === 'reading', onClick: () => { var _a; return (_a = fileRef.current) === null || _a === void 0 ? void 0 : _a.click(); }, children: t('Receipts.PICK_FILE') })] }), _jsx(Typography, { variant: "body2", color: "text.secondary", children: t('Receipts.ACCEPTED_TYPES') })] }), phase === 'reading' && _jsxs(_Fragment, { children: [_jsx(Box, { sx: { position: 'relative' }, children: preview ? _jsxs(_Fragment, { children: [_jsx("img", { src: preview, alt: (file === null || file === void 0 ? void 0 : file.name) || '', style: { display: 'block', maxWidth: '100%', maxHeight: 360 } }), overlayBoxes.map((b, i) => _jsx(Box, { sx: { position: 'absolute', left: `${b.x * 100}%`, top: `${b.y * 100}%`, width: `${b.w * 100}%`, height: `${b.h * 100}%`, border: 2, borderColor: 'primary.main', pointerEvents: 'none' } }, i))] }) : _jsx(Typography, { children: (file === null || file === void 0 ? void 0 : file.name) || ' ' }) }), _jsx(LinearProgress, { variant: progress == null ? 'indeterminate' : 'determinate', value: progress || 0, sx: RECEIPT_CAPTURE_PROGRESS_SX }), _jsx(Typography, { role: "status", children: t('Receipts.READING') })] }), phase === 'review' && _jsxs(_Fragment, { children: [_jsx(Box, { sx: { position: 'relative' }, children: preview && _jsxs(_Fragment, { children: [_jsx("img", { src: preview, alt: (file === null || file === void 0 ? void 0 : file.name) || '', style: { display: 'block', maxWidth: '100%', maxHeight: 360 } }), overlayBoxes.map((b, i) => _jsx(Box, { sx: { position: 'absolute', left: `${b.x * 100}%`, top: `${b.y * 100}%`, width: `${b.w * 100}%`, height: `${b.h * 100}%`, border: 2, borderColor: 'primary.main', pointerEvents: 'none' } }, i))] }) }), _jsx(Button, { onClick: () => setReviewOpen(true), children: t('Receipts.REVIEW_TITLE') }), _jsx(ReceiptReviewDialog, { open: reviewOpen, receipt: receipt, values: values, fieldLabels: fieldLabels, extraFields: extraFields, accountLabel: accountLabel, onApply: onApply, onClose: () => setReviewOpen(false) })] }), phase === 'picker' && _jsx(ReceiptPicker, { receipts: receipts, imageUrl: preview, fieldLabels: fieldLabels, confirmLabel: confirmLabel, onCancel: reset, onConfirm: (chosen) => { onSelectReceipts === null || onSelectReceipts === void 0 ? void 0 : onSelectReceipts(chosen); clearUrl(); setReceipts([]); setPhase('idle'); } }), errKey && _jsx(Alert, { severity: errKey === 'file' ? 'error' : errKey === 'nothing' ? 'info' : 'warning', sx: RECEIPT_CAPTURE_ALERT_SX, children: t(errKey === 'file' ? 'Receipts.FILE_PROBLEM' : errKey === 'nothing' ? 'Receipts.NOTHING_RECOGNISED' : 'Receipts.UNAVAILABLE') }), phase !== 'idle' && _jsx(Button, { onClick: reset, children: t('Receipts.ANOTHER') })] }) }) }) });
+}
+export default ReceiptCaptureCard;

package/dist/receipts/ReceiptConsentSwitch.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useMemo } from 'react';
+import { Alert, Button, FormControlLabel, Stack, Switch } from '@mui/material';
+import { useTranslation } from 'react-i18next';
+import { defaultReceiptsApi } from './api';
+import { useReceiptConsent } from './useReceiptConsent';
+export const RECEIPT_CONSENT_CONTROL_SX = { alignItems: 'flex-start' };
+export const RECEIPT_CONSENT_ALERT_SX = { width: '100%' };
+export function ReceiptConsentSwitch({ api = defaultReceiptsApi, provider = 'OpenAI', consent, onChange, sx }) {
+    const { t } = useTranslation();
+    const fallbackApi = useMemo(() => consent ? { getConsent: () => Promise.resolve({ granted: false }), setConsent: (v) => consent.set(v).then((answer) => ({ granted: answer })) } : api, [api, Boolean(consent)]);
+    const own = useReceiptConsent(fallbackApi);
+    const state = consent || own;
+    const change = async (event) => { const answer = await state.set(event.target.checked); if (answer === event.target.checked)
+        onChange === null || onChange === void 0 ? void 0 : onChange(answer); };
+    return _jsxs(Stack, { spacing: 1, children: [_jsx(FormControlLabel, { sx: [RECEIPT_CONSENT_CONTROL_SX, ...(Array.isArray(sx) ? sx : sx ? [sx] : [])], control: _jsx(Switch, { checked: Boolean(state.granted), onChange: change, disabled: state.status === 'loading' || state.busy, inputProps: { 'aria-label': t('Receipts.CONSENT', { provider }) } }), label: t('Receipts.CONSENT', { provider }) }), (state.status === 'error' || state.error) && _jsx(Alert, { severity: "error", sx: RECEIPT_CONSENT_ALERT_SX, action: _jsx(Button, { color: "inherit", size: "small", onClick: state.reload, children: t('Receipts.RETRY') }), children: t('Receipts.CONSENT_ERROR') })] });
+}
+export default ReceiptConsentSwitch;

package/dist/receipts/ReceiptPicker.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useEffect, useState } from 'react';
+import { Box, Button, Card, CardContent, Checkbox, Chip, DialogActions, DialogContent, DialogTitle, Grid, Stack, Typography } from '@mui/material';
+import { useTranslation } from 'react-i18next';
+import { formatReceiptAmount, formatReceiptDate } from './format';
+export const RECEIPT_PICKER_CARD_SX = { height: '100%' };
+export const RECEIPT_PICKER_CLICK_SX = { cursor: 'pointer', height: '100%' };
+export const RECEIPT_PICKER_ACTION_SX = { justifyContent: 'space-between' };
+function cropStyle(box) { if (!box || !box.w || !box.h)
+    return null; return { backgroundSize: `${100 / box.w}% ${100 / box.h}%`, backgroundPosition: `${(box.x / (1 - box.w)) * 100 || 0}% ${(box.y / (1 - box.h)) * 100 || 0}%` }; }
+export function ReceiptPicker({ receipts = [], imageUrl, onConfirm, onCancel, confirmLabel, fieldLabels, sx }) {
+    const { t, i18n } = useTranslation();
+    const [selected, setSelected] = useState([]);
+    useEffect(() => setSelected(receipts.map((r, i) => r.confidence === 'low' ? -1 : i).filter((i) => i >= 0)), [receipts]);
+    const toggle = (i) => setSelected((old) => old.includes(i) ? old.filter((n) => n !== i) : [...old, i]);
+    const count = selected.length;
+    return _jsxs(Box, { sx: sx, children: [_jsx(DialogTitle, { children: t('Receipts.RECOGNISED_COUNT', { n: receipts.length }) }), _jsx(DialogContent, { children: _jsx(Grid, { container: true, spacing: 2, children: receipts.map((r, i) => { const crop = cropStyle(r.box); return _jsx(Grid, { size: { xs: 12, md: 4 }, children: _jsx(Card, { sx: RECEIPT_PICKER_CARD_SX, variant: "outlined", children: _jsx(Box, { onClick: () => toggle(i), sx: RECEIPT_PICKER_CLICK_SX, children: _jsx(CardContent, { children: _jsxs(Stack, { spacing: 1, children: [_jsx(Box, { role: "img", "aria-label": r.merchant || t('Receipts.UNREADABLE'), sx: Object.assign({ height: 100, bgcolor: 'action.hover', backgroundImage: imageUrl && crop ? `url(${imageUrl})` : 'none', backgroundRepeat: 'no-repeat' }, (imageUrl && crop ? crop : {})) }), _jsxs(Stack, { direction: "row", alignItems: "center", children: [_jsx(Checkbox, { checked: selected.includes(i), inputProps: { 'aria-label': r.merchant || t('Receipts.UNREADABLE') }, onChange: () => toggle(i), onClick: (e) => e.stopPropagation() }), _jsx(Typography, { children: r.merchant || t('Receipts.UNREADABLE') })] }), _jsxs(Typography, { variant: "body2", children: [r.date ? formatReceiptDate(r.date, i18n.language) : '', r.total ? ` · ${formatReceiptAmount(r.total, r.currency, i18n.language)}` : t('Receipts.AMOUNT_UNKNOWN')] }), _jsx(Chip, { size: "small", color: r.confidence === 'low' ? 'warning' : 'success', label: t(r.confidence === 'low' ? 'Receipts.UNCERTAIN' : 'Receipts.CERTAIN') })] }) }) }) }) }, i); }) }) }), _jsxs(DialogActions, { sx: RECEIPT_PICKER_ACTION_SX, children: [_jsx(Button, { onClick: onCancel, children: t('Receipts.CANCEL') }), _jsx(Button, { disabled: !count, variant: "contained", onClick: () => onConfirm === null || onConfirm === void 0 ? void 0 : onConfirm(receipts.filter((_r, i) => selected.includes(i))), children: confirmLabel ? confirmLabel(count) : t('Receipts.APPLY_COUNT', { n: count }) })] })] });
+}
+export default ReceiptPicker;

package/dist/receipts/ReceiptReviewDialog.js

@@ -0,0 +1,39 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { Box, Button, Chip, Dialog, DialogActions, DialogContent, DialogTitle, Drawer, Stack, Typography, useMediaQuery } from '@mui/material';
+import { useTheme } from '@mui/material/styles';
+import { useTranslation } from 'react-i18next';
+import { formatReceiptAmount, formatReceiptDate, isEmptyValue, receiptValueEqual } from './format';
+export const RECEIPT_REVIEW_ACTIONS_SX = { gap: 1, flexWrap: 'wrap', flexDirection: { xs: 'column', sm: 'row' }, '& > :nth-of-type(1)': { order: { xs: 3, sm: 0 } }, '& > :nth-of-type(2)': { order: { xs: 2, sm: 0 } }, '& > :nth-of-type(3)': { order: { xs: 1, sm: 0 } } };
+export const RECEIPT_REVIEW_ROW_SX = { display: 'grid', gridTemplateColumns: 'minmax(0, 1fr) auto', columnGap: 1, alignItems: 'start' };
+export const RECEIPT_REVIEW_SHEET_PAPER_SX = { height: '92%' };
+export const RECEIPT_REVIEW_ACTION_BUTTON_SX = { flex: '1 1 auto' };
+export function ReceiptReviewDialog({ open, receipt, values = {}, fieldLabels = {}, extraFields = [], accountLabel = (id) => id, onApply, onClose }) {
+    var _a;
+    const { t, i18n } = useTranslation();
+    const theme = useTheme();
+    const mobile = useMediaQuery(theme.breakpoints.down('sm'));
+    const rows = [];
+    const add = (key, value, recognized = value !== '' && value != null, format = (v) => String(v)) => { if (recognized)
+        rows.push({ key, value, text: format(value), confidence: receipt === null || receipt === void 0 ? void 0 : receipt.confidence }); };
+    add('merchant', receipt === null || receipt === void 0 ? void 0 : receipt.merchant);
+    add('date', receipt === null || receipt === void 0 ? void 0 : receipt.date, Boolean(receipt === null || receipt === void 0 ? void 0 : receipt.date), (v) => formatReceiptDate(v, i18n.language));
+    add('total', receipt === null || receipt === void 0 ? void 0 : receipt.total, Boolean(receipt === null || receipt === void 0 ? void 0 : receipt.total), (v) => formatReceiptAmount(v, receipt === null || receipt === void 0 ? void 0 : receipt.currency, i18n.language));
+    add('currency', receipt === null || receipt === void 0 ? void 0 : receipt.currency);
+    if ((receipt === null || receipt === void 0 ? void 0 : receipt.payment_method) && receipt.payment_method !== 'unknown')
+        add('payment_method', receipt.payment_method, true, (v) => t(`Receipts.PAYMENT_${v}`));
+    const account = (_a = receipt === null || receipt === void 0 ? void 0 : receipt.account_suggestions) === null || _a === void 0 ? void 0 : _a.find((s) => s === null || s === void 0 ? void 0 : s.account_id);
+    if (account)
+        rows.push({ key: 'account', value: account.account_id, text: accountLabel(account.account_id), confidence: account.confidence === 'low' ? 'low' : receipt === null || receipt === void 0 ? void 0 : receipt.confidence });
+    if (Array.isArray(receipt === null || receipt === void 0 ? void 0 : receipt.items) && receipt.items.length)
+        rows.push({ key: 'items', value: receipt.items, text: receipt.items.map((item) => `${item.description || ''}${item.amount ? ` · ${item.amount}` : ''}`).join('\n'), confidence: receipt === null || receipt === void 0 ? void 0 : receipt.confidence });
+    (extraFields || []).forEach(({ key, format }) => { if (!['merchant', 'date', 'total', 'currency', 'payment_method', 'account', 'items'].includes(key) && (receipt === null || receipt === void 0 ? void 0 : receipt[key]) != null && receipt[key] !== '')
+        add(key, receipt[key], true, format || ((v) => typeof v === 'string' ? v : JSON.stringify(v))); });
+    const label = (key) => { var _a; return fieldLabels[key] || ((_a = extraFields.find((field) => field.key === key)) === null || _a === void 0 ? void 0 : _a.label) || t(`Receipts.FIELD_${key}`); };
+    const apply = (list, mode, close) => { if (!list.length)
+        return; onApply === null || onApply === void 0 ? void 0 : onApply(Object.fromEntries(list.map((r) => [r.key, r.value])), { mode }); if (close)
+        onClose === null || onClose === void 0 ? void 0 : onClose(); };
+    const content = _jsxs(_Fragment, { children: [_jsx(DialogTitle, { id: "receipt-review-title", children: t('Receipts.REVIEW_TITLE') }), _jsx(DialogContent, { children: _jsx(Stack, { spacing: 2, children: rows.map((row) => { const current = values[row.key]; const equal = !isEmptyValue(current) && receiptValueEqual(row.key, current, row.value); return _jsxs(Box, { sx: RECEIPT_REVIEW_ROW_SX, children: [_jsxs(Box, { sx: { minWidth: 0 }, children: [_jsx(Typography, { variant: "subtitle2", children: label(row.key) }), _jsxs(Stack, { direction: "row", spacing: 1, alignItems: "center", flexWrap: "wrap", children: [row.key === 'items' ? _jsx(Box, { component: "ul", sx: { m: 0, pl: 2 }, children: row.value.map((item, index) => _jsx("li", { children: _jsx(Typography, { component: "span", children: `${item.description || ''}${item.amount ? ` · ${item.amount}` : ''}` }) }, index)) }) : _jsx(Typography, { children: row.text }), row.confidence === 'low' && _jsx(Chip, { size: "small", color: "warning", label: t('Receipts.UNCERTAIN') }), equal ? _jsx(Typography, { variant: "caption", children: t('Receipts.SAME_AS_FORM') }) : !isEmptyValue(current) && _jsx(Typography, { variant: "body2", sx: { textDecoration: 'line-through' }, children: String(current) })] })] }), !equal && _jsx(Button, { size: "small", onClick: () => apply([row], 'field', false), children: t('Receipts.APPLY') })] }, row.key); }) }) }), _jsxs(DialogActions, { sx: RECEIPT_REVIEW_ACTIONS_SX, children: [_jsx(Button, { sx: RECEIPT_REVIEW_ACTION_BUTTON_SX, onClick: onClose, children: t('Receipts.CLOSE') }), _jsx(Button, { variant: "outlined", sx: RECEIPT_REVIEW_ACTION_BUTTON_SX, disabled: !rows.some((r) => isEmptyValue(values[r.key])), onClick: () => apply(rows.filter((r) => isEmptyValue(values[r.key])), 'empty', true), children: t('Receipts.ONLY_EMPTY') }), _jsx(Button, { variant: "contained", sx: RECEIPT_REVIEW_ACTION_BUTTON_SX, disabled: !rows.length, onClick: () => apply(rows, 'all', true), children: t('Receipts.APPLY_ALL') })] })] });
+    return mobile ? _jsx(Drawer, { anchor: "bottom", open: open, onClose: onClose, PaperProps: { sx: RECEIPT_REVIEW_SHEET_PAPER_SX, role: 'dialog', 'aria-labelledby': 'receipt-review-title' }, children: content }) : _jsx(Dialog, { open: open, onClose: onClose, maxWidth: "sm", fullWidth: true, "aria-labelledby": "receipt-review-title", children: content });
+}
+export default ReceiptReviewDialog;

package/dist/receipts/api.js

@@ -0,0 +1,18 @@
+import apiClient from '../auth/apiClient';
+import { receiptsApiUrls } from './wire';
+export function createReceiptsApi(overrides = {}, { apiBase = '/api/receipts/' } = {}) {
+    const urls = receiptsApiUrls(apiBase);
+    const defaults = {
+        getConsent: () => apiClient.get(urls.consent).then((r) => r.data),
+        setConsent: (granted) => (granted ? apiClient.post(urls.consent) : apiClient.delete(urls.consent)).then((r) => r.data),
+        readReceipts: (file, { context, onUploadProgress, signal } = {}) => {
+            const body = new FormData();
+            body.append('file', file);
+            if (context !== undefined)
+                body.append('context', JSON.stringify(context));
+            return apiClient.post(urls.read, body, { onUploadProgress, signal }).then((r) => { var _a; return Array.isArray((_a = r.data) === null || _a === void 0 ? void 0 : _a.receipts) ? r.data.receipts : []; });
+        },
+    };
+    return Object.assign(Object.assign({}, defaults), overrides);
+}
+export const defaultReceiptsApi = createReceiptsApi();

package/dist/receipts/files.js

@@ -0,0 +1,39 @@
+import { RECEIPT_MAX_BYTES } from './wire';
+const extOf = (file) => String((file === null || file === void 0 ? void 0 : file.name) || '').split('.').pop().toLowerCase();
+// `checkSize: false` is for files that are scaled down before upload; the bound is checked again on the prepared file.
+export function receiptFileProblem(file, { checkSize = true } = {}) {
+    const ext = extOf(file);
+    const type = String((file === null || file === void 0 ? void 0 : file.type) || '').toLowerCase();
+    // A declared type decides; the extension only decides when the browser gave none (phones often send an empty type for HEIC).
+    const supported = type && type !== 'application/octet-stream'
+        ? ['image/jpeg', 'image/png', 'image/heic', 'image/heif', 'application/pdf'].includes(type)
+        : ['jpg', 'jpeg', 'png', 'heic', 'heif', 'pdf'].includes(ext);
+    if (!supported)
+        return 'unsupported_file_type';
+    if (!Number.isFinite(file === null || file === void 0 ? void 0 : file.size) || (checkSize && file.size > RECEIPT_MAX_BYTES))
+        return 'file_too_large';
+    return null;
+}
+function decode(file) { return new Promise((resolve, reject) => { const url = URL.createObjectURL(file); const image = new Image(); image.onload = () => { URL.revokeObjectURL(url); resolve(image); }; image.onerror = () => { URL.revokeObjectURL(url); reject(new Error('decode')); }; image.src = url; }); }
+function blobOf(canvas) { return new Promise((resolve) => canvas.toBlob(resolve, 'image/jpeg', 0.85)); }
+export async function prepareReceiptFile(file) {
+    var _a;
+    const ext = extOf(file), type = String((file === null || file === void 0 ? void 0 : file.type) || '').toLowerCase();
+    if (file.size <= 1.5 * 1024 * 1024 || !(['image/jpeg', 'image/png'].includes(type) || ['jpg', 'jpeg', 'png'].includes(ext)))
+        return file;
+    try {
+        const image = await decode(file), width = image.naturalWidth || image.width, height = image.naturalHeight || image.height;
+        const scale = Math.min(1, 2400 / Math.max(width, height));
+        if (!width || !height)
+            return file;
+        const canvas = document.createElement('canvas');
+        canvas.width = Math.round(width * scale);
+        canvas.height = Math.round(height * scale);
+        (_a = canvas.getContext('2d')) === null || _a === void 0 ? void 0 : _a.drawImage(image, 0, 0, canvas.width, canvas.height);
+        const blob = await blobOf(canvas);
+        return blob ? new File([blob], file.name.replace(/\.[^.]+$/, '') + '.jpg', { type: 'image/jpeg', lastModified: file.lastModified }) : file;
+    }
+    catch (_b) {
+        return file;
+    }
+}

package/dist/receipts/format.js

@@ -0,0 +1,42 @@
+import { intlLocale } from '../billing/format';
+export function formatReceiptAmount(total, currency, language) {
+    if (typeof total !== 'string' || !total.trim())
+        return total || '';
+    const n = Number(total);
+    if (!Number.isFinite(n))
+        return total;
+    const candidate = typeof currency === 'string' ? currency.toUpperCase() : '';
+    let code = 'USD';
+    try {
+        const supported = typeof Intl.supportedValuesOf === 'function' ? Intl.supportedValuesOf('currency') : null;
+        if (/^[A-Z]{3}$/.test(candidate) && (!supported || supported.includes(candidate))) {
+            new Intl.NumberFormat(intlLocale(language), { style: 'currency', currency: candidate });
+            code = candidate;
+        }
+    }
+    catch (_a) {
+        code = 'USD';
+    }
+    try {
+        return new Intl.NumberFormat(intlLocale(language), { style: 'currency', currency: code }).format(n);
+    }
+    catch (_b) {
+        return total;
+    }
+}
+export function formatReceiptDate(iso, language) {
+    if (typeof iso !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(iso))
+        return iso || '';
+    const date = new Date(`${iso}T00:00:00Z`);
+    if (!Number.isFinite(date.getTime()) || date.toISOString().slice(0, 10) !== iso)
+        return iso;
+    return new Intl.DateTimeFormat(intlLocale(language), { dateStyle: 'short', timeZone: 'UTC' }).format(date);
+}
+export function isEmptyValue(value) { return value === '' || value === null || value === undefined || (Array.isArray(value) && value.length === 0); }
+export function receiptValueEqual(key, a, b) {
+    if (key === 'items')
+        return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((item, i) => ['description', 'amount'].every((k) => { var _a; var _b, _c; return String((_b = item === null || item === void 0 ? void 0 : item[k]) !== null && _b !== void 0 ? _b : '').trim().toLowerCase() === String((_c = (_a = b[i]) === null || _a === void 0 ? void 0 : _a[k]) !== null && _c !== void 0 ? _c : '').trim().toLowerCase(); }));
+    if (key === 'total' && a !== '' && b !== '' && Number.isFinite(Number(a)) && Number.isFinite(Number(b)))
+        return Number(a) === Number(b);
+    return String(a !== null && a !== void 0 ? a : '').trim().toLowerCase() === String(b !== null && b !== void 0 ? b : '').trim().toLowerCase();
+}

package/dist/receipts/useReceiptConsent.js

@@ -0,0 +1,52 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+export function useReceiptConsent(api) {
+    const [status, setStatus] = useState('loading');
+    const [granted, setGranted] = useState(false);
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(false);
+    const [reloadCount, setReloadCount] = useState(0);
+    const liveRef = useRef(true);
+    const generation = useRef(0); // bumped when the api changes, so an answer of the old api can never count
+    const reload = useCallback(() => { setGranted(false); setStatus('loading'); setError(false); setReloadCount((n) => n + 1); }, []);
+    useEffect(() => {
+        liveRef.current = true;
+        let requestLive = true;
+        generation.current += 1;
+        setGranted(false);
+        setStatus('loading'); // consent known for another api never carries over
+        Promise.resolve().then(() => api.getConsent()).then((answer) => { if (requestLive) {
+            setGranted(Boolean(answer === null || answer === void 0 ? void 0 : answer.granted));
+            setStatus('ready');
+            setError(false);
+        } }).catch(() => { if (requestLive) {
+            setStatus('error');
+            setError(true);
+        } });
+        return () => { requestLive = false; liveRef.current = false; };
+    }, [api, reloadCount]);
+    const set = useCallback(async (next) => {
+        const mine = generation.current;
+        setBusy(true);
+        setError(false);
+        if (!next)
+            setGranted(false); // fail closed: a revocation takes effect at once, whatever the server answers
+        try {
+            const answer = await api.setConsent(Boolean(next));
+            if (!liveRef.current || mine !== generation.current)
+                return false;
+            setGranted(Boolean(answer === null || answer === void 0 ? void 0 : answer.granted));
+            setStatus('ready');
+            return Boolean(answer === null || answer === void 0 ? void 0 : answer.granted);
+        }
+        catch (_a) {
+            if (liveRef.current && mine === generation.current)
+                setError(true);
+            return false;
+        }
+        finally {
+            if (liveRef.current && mine === generation.current)
+                setBusy(false);
+        }
+    }, [api]);
+    return { status, granted, busy, error, set, reload };
+}

package/dist/receipts/wire.js

@@ -0,0 +1,5 @@
+export const RECEIPT_ERROR_CODES = ['consent_required', 'unsupported_file_type', 'file_too_large', 'invalid_request', 'nothing_recognised', 'spend_cap_reached', 'count_limit_reached', 'provider_unavailable', 'authentication_required'];
+export const RECEIPT_MAX_BYTES = 10 * 1024 * 1024;
+export const RECEIPT_ACCEPT = 'image/jpeg,image/png,image/heic,image/heif,application/pdf,.jpg,.jpeg,.png,.heic,.heif,.pdf';
+export const RECEIPT_FIELD_KEYS = ['merchant', 'date', 'total', 'currency', 'payment_method', 'account', 'items'];
+export const receiptsApiUrls = (base = '/api/receipts/') => { const root = base.replace(/\/$/, '') + '/'; return { consent: root + 'consent/', read: root + 'read/' }; };

package/dist/theme/kitSxRegistry.js

@@ -39,6 +39,10 @@ import { PLAN_PICKER_ALERT_SX, PLAN_PICKER_CARD_SX, PLAN_PICKER_LABEL_SX, PLAN_P
 import { SUBSCRIPTION_SECTION_ALERT_SX } from '../billing/SubscriptionSection';
 import { WITHDRAWAL_DIALOG_ALERT_SX } from '../billing/WithdrawalDialog';
 import { WITHDRAWAL_SECTION_ALERT_SX } from '../billing/WithdrawalSection';
+import { RECEIPT_CONSENT_ALERT_SX, RECEIPT_CONSENT_CONTROL_SX } from '../receipts/ReceiptConsentSwitch';
+import { RECEIPT_CAPTURE_ACTION_SX, RECEIPT_CAPTURE_ALERT_SX, RECEIPT_CAPTURE_CARD_SX, RECEIPT_CAPTURE_PROGRESS_SX } from '../receipts/ReceiptCaptureCard';
+import { RECEIPT_PICKER_ACTION_SX, RECEIPT_PICKER_CARD_SX } from '../receipts/ReceiptPicker';
+import { RECEIPT_REVIEW_ACTIONS_SX, RECEIPT_REVIEW_ACTION_BUTTON_SX, RECEIPT_REVIEW_SHEET_PAPER_SX } from '../receipts/ReceiptReviewDialog';
 const SX_EXPORTS = {
     ACCESS_CODE_ACTION_SX,
     ACCESS_ENDED_BANNER_ALERT_SX,
@@ -116,6 +120,17 @@ const SX_EXPORTS = {
     SUBSCRIPTION_SECTION_ALERT_SX,
     WITHDRAWAL_DIALOG_ALERT_SX,
     WITHDRAWAL_SECTION_ALERT_SX,
+    RECEIPT_CONSENT_ALERT_SX,
+    RECEIPT_CONSENT_CONTROL_SX,
+    RECEIPT_CAPTURE_ACTION_SX,
+    RECEIPT_CAPTURE_ALERT_SX,
+    RECEIPT_CAPTURE_CARD_SX,
+    RECEIPT_CAPTURE_PROGRESS_SX,
+    RECEIPT_PICKER_ACTION_SX,
+    RECEIPT_PICKER_CARD_SX,
+    RECEIPT_REVIEW_ACTIONS_SX,
+    RECEIPT_REVIEW_ACTION_BUTTON_SX,
+    RECEIPT_REVIEW_SHEET_PAPER_SX,
     USER_INVITE_ACTION_SX,
     USER_INVITE_ALERT_SX,
     USER_LIST_ACTION_SX,
@@ -223,4 +238,15 @@ export const KIT_COMPONENT_SX_REGISTRY = [
     entry('SubscriptionSection.alert', 'MuiAlert', SUBSCRIPTION_SECTION_ALERT_SX),
     entry('WithdrawalDialog.alert', 'MuiAlert', WITHDRAWAL_DIALOG_ALERT_SX),
     entry('WithdrawalSection.alert', 'MuiAlert', WITHDRAWAL_SECTION_ALERT_SX),
+    entry('ReceiptConsentSwitch.alert', 'MuiAlert', RECEIPT_CONSENT_ALERT_SX),
+    entry('ReceiptConsentSwitch.control', 'MuiFormControlLabel', RECEIPT_CONSENT_CONTROL_SX),
+    entry('ReceiptCaptureCard.card', 'MuiPaper', RECEIPT_CAPTURE_CARD_SX),
+    entry('ReceiptCaptureCard.alert', 'MuiAlert', RECEIPT_CAPTURE_ALERT_SX),
+    entry('ReceiptCaptureCard.action', 'MuiButton', RECEIPT_CAPTURE_ACTION_SX),
+    entry('ReceiptCaptureCard.progress', 'MuiLinearProgress', RECEIPT_CAPTURE_PROGRESS_SX),
+    entry('ReceiptPicker.card', 'MuiCard', RECEIPT_PICKER_CARD_SX),
+    entry('ReceiptPicker.actions', 'MuiDialogActions', RECEIPT_PICKER_ACTION_SX),
+    entry('ReceiptReviewDialog.actions', 'MuiDialogActions', RECEIPT_REVIEW_ACTIONS_SX),
+    entry('ReceiptReviewDialog.sheetPaper', 'MuiPaper', RECEIPT_REVIEW_SHEET_PAPER_SX),
+    entry('ReceiptReviewDialog.action', 'MuiButton', RECEIPT_REVIEW_ACTION_BUTTON_SX),
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micha.bigler/ui-core-micha",
-  "version": "4.6.0",
+  "version": "4.7.1",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "exports": {