// COLLECTION OPERATIONS — the operational hub for the whole collection.
// Launched from the "Add" control on the Garage landing page. Every action
// here begins a workflow that ultimately writes records into the archive
// (Timeline, Provenance, Service Ledger, Value History, Vault, Gallery…).
//
// Two views live inside one full-screen overlay:
// • 'menu' — the command center (four categories of actions)
// • 'receipt' — first step of the Upload Receipt workflow
//
// Principle, stated and restated: Actions create records. Records create the archive.
const { useState: useOps } = React;
// ─────────────────────────────────────────────────────────────────────
// Shared overlay chrome
// ─────────────────────────────────────────────────────────────────────
function OpsTopBar({ eyebrow, title, onClose, closeIcon = 'down' }) {
return (
{title}
{eyebrow}
);
}
// The principle banner — quiet, tracked, gold-keyed.
function PrincipleBanner({ style = {} }) {
return (
Actions create records. Records create the archive.
);
}
// A single navigation item — title only, matches the interior row rhythm.
function OpRow({ icon, title, onClick, badge, soon }) {
return (
Keep the source document in the Vault as part of the permanent record.
{/* Primary CTA */}
);
}
// ─────────────────────────────────────────────────────────────────────
// FLOW SHELL — full-screen overlay portalled to the phone stage
// ─────────────────────────────────────────────────────────────────────
function OperationsFlow({ vehicles = [], onClose, onAddVehicle, initialView = 'menu' }) {
const [view, setView] = useOps(initialView); // menu | account | emergency | transfer | owner | billing | receipt | story | review-queue | review-item | contributors
const [reviewItem, setReviewItem] = useOps(null); // submission opened from the queue
const [reportPeriod, setReportPeriod] = useOps(null); // period opened from Reports home
const [reviewOrigin, setReviewOrigin] = useOps('review-queue'); // which queue we opened from
const [removedIds, setRemovedIds] = useOps([]); // submissions filed to the archive — drop from the queue
const [closing, setClosing] = useOps(false);
// A submission, once reviewed and filed to the archive, leaves the queue.
const completeReview = () => {
setRemovedIds(ids => (reviewItem && !ids.includes(reviewItem.id)) ? [...ids, reviewItem.id] : ids);
setView(reviewOrigin);
};
// Fade out, then unmount.
const requestClose = () => {
if (closing) return;
setClosing(true);
setTimeout(() => { onClose && onClose(); }, 240);
};
const openReviewItem = (item) => {
setReviewItem(item);
// A receipt opens the full Upload Receipt review/allocate workflow,
// unchanged after the review step. The monthly report task opens the
// Monthly Expense Report flow. Other kinds get a light review.
if (item.kind === 'report') { setView('report-task'); return; }
setView(item.kind === 'receipt' ? 'review-receipt' : 'review-item');
};
const handleAction = (id) => {
if (id === 'view-collection') { requestClose(); return; }
if (id === 'add-vehicle') { onAddVehicle && onAddVehicle(); requestClose(); return; }
if (id === 'upload-receipt') { setView('receipt'); return; }
if (id === 'report') { setView('reports'); return; }
if (id === 'story') { setView('story'); return; }
if (id === 'review-queue') { setReviewOrigin('review-queue'); setView('review-queue'); return; }
if (id === 'review-expenses') { setReviewOrigin('review-expenses'); setView('review-expenses'); return; }
if (id === 'contributors') { setView('contributors'); return; }
if (id === 'account') { setView('account'); return; }
// Other workflows are stubbed in this prototype — they would each open
// their own first-step screen, mirroring Upload Receipt.
};
const node = (