@burdenoff/microfe-movethewheels 2026.1101.4 → 2026.1102.2

package/dist/components/freight-cost/FreightDraftForm.js

@@ -1,8 +1,8 @@
 import { Button as e } from "../ui.js";
 import { ContainerEvidencePicker as t } from "../ContainerEvidencePicker.js";
-import { commercialCanonical as n, commercialCaptureInput as r } from "../../utils/freightCommercial.js";
-import { FreightCurrency as i, FreightSelect as a, FreightText as o } from "./FreightFields.js";
-import { freightInstant as s, freightLocalTime as c, newFreightFacts as l, newFreightLine as u } from "../../utils/freightDraft.js";
+import { FreightCurrency as n, FreightSelect as r, FreightText as i } from "./FreightFields.js";
+import { freightInstant as a, freightLocalTime as o, newFreightFacts as s, newFreightLine as c } from "../../utils/freightDraft.js";
+import { commercialCanonical as l, commercialCaptureInput as u } from "../../utils/freightCommercial.js";
 import { FreightCommercialEditor as d } from "./FreightCommercialEditor.js";
 import { FreightLineEditor as f } from "./FreightLineEditor.js";
 import { FreightScopeEditor as p } from "./FreightScopeEditor.js";
@@ -12,7 +12,7 @@ import { useRef as g, useState as _ } from "react";
 import { jsx as v, jsxs as y } from "react/jsx-runtime";
 //#region src/movethewheels/components/freight-cost/FreightDraftForm.tsx
 function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
-	let [w, T] = _(null), [E, D] = _(l), [O, k] = _([]), [A, j] = _(null), [M, N] = _(null), [P, F] = _(!1), I = g(!1), L = JSON.stringify(E), R = A?.body === L ? A.value : null, z = (e) => D({
+	let [w, T] = _(null), [E, D] = _(s), [O, k] = _([]), [A, j] = _(null), [M, N] = _(null), [P, F] = _(!1), I = g(!1), L = JSON.stringify(E), R = A?.body === L ? A.value : null, z = (e) => D({
 		...E,
 		...e
 	}), B = async () => {
@@ -40,8 +40,8 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 			}
 			N(null);
 			try {
-				if (w && w.reviewed !== n(w.selectedLegs)) throw Error("Explicitly review the commercial leg selection before saving.");
-				let e = w ? r(w.facts, w.selectedLegs, O) : void 0;
+				if (w && w.reviewed !== l(w.selectedLegs)) throw Error("Explicitly review the commercial leg selection before saving.");
+				let e = w ? u(w.facts, w.selectedLegs, O) : void 0;
 				C(structuredClone(E), structuredClone(O), e).catch((e) => N(e instanceof Error ? e.message : "Unable to save this cost record."));
 			} catch (e) {
 				N(e instanceof Error ? e.message : "Review commercial facts before saving.");
@@ -59,13 +59,13 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 					/* @__PURE__ */ y("div", {
 						className: "grid gap-3 md:grid-cols-2",
 						children: [
-							/* @__PURE__ */ v(o, {
+							/* @__PURE__ */ v(i, {
 								label: "Estimate title",
 								value: E.title,
 								required: !0,
 								onChange: (e) => z({ title: e })
 							}),
-							/* @__PURE__ */ y(a, {
+							/* @__PURE__ */ y(r, {
 								label: "Record type",
 								value: E.kind,
 								onChange: (e) => {
@@ -79,13 +79,13 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 									children: "Reported quote"
 								})]
 							}),
-							/* @__PURE__ */ v(o, {
+							/* @__PURE__ */ v(i, {
 								label: "Commercial source",
 								value: E.sourceReference,
 								required: !0,
 								onChange: (e) => z({ sourceReference: e })
 							}),
-							/* @__PURE__ */ v(o, {
+							/* @__PURE__ */ v(i, {
 								label: "Source version",
 								value: E.sourceRevision,
 								required: !0,
@@ -93,7 +93,7 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 							})
 						]
 					}),
-					/* @__PURE__ */ v(o, {
+					/* @__PURE__ */ v(i, {
 						label: "Shipment and services covered by this source",
 						value: E.commercialScope,
 						required: !0,
@@ -107,13 +107,13 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 							". They are recorded as exact UTC instants."
 						]
 					}),
-					/* @__PURE__ */ v(o, {
+					/* @__PURE__ */ v(i, {
 						label: "Price applies at",
 						type: "datetime-local",
-						value: c(E.pricingAt),
+						value: o(E.pricingAt),
 						required: !0,
 						onChange: (e) => {
-							e && z({ pricingAt: s(e) });
+							e && z({ pricingAt: a(e) });
 						}
 					}),
 					/* @__PURE__ */ y("section", {
@@ -137,7 +137,7 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 								type: "button",
 								variant: "outline",
 								disabled: E.lines.length >= 100,
-								onClick: () => z({ lines: [...E.lines, u()] }),
+								onClick: () => z({ lines: [...E.lines, c()] }),
 								children: "Add cost item"
 							})
 						]
@@ -162,14 +162,14 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 									"quotedAt",
 									"validFrom",
 									"validUntil"
-								].map((e) => /* @__PURE__ */ v(o, {
+								].map((e) => /* @__PURE__ */ v(i, {
 									label: e === "quotedAt" ? "Quote received at" : e === "validFrom" ? "Quote valid from" : "Quote valid until",
 									type: "datetime-local",
-									value: E[e] ? c(E[e]) : "",
-									onChange: (t) => z({ [e]: t ? s(t) : null })
+									value: E[e] ? o(E[e]) : "",
+									onChange: (t) => z({ [e]: t ? a(t) : null })
 								}, e))]
 							}),
-							/* @__PURE__ */ y(a, {
+							/* @__PURE__ */ y(r, {
 								label: "Reporting total",
 								value: E.reportingCurrency ? "RECORDED" : "UNKNOWN",
 								onChange: (e) => z({ reportingCurrency: e === "RECORDED" ? {
@@ -184,7 +184,7 @@ function b({ disabled: b, shipmentId: x, onPreview: S, onSave: C }) {
 									children: "Use a recorded currency convention"
 								})]
 							}),
-							E.reportingCurrency && /* @__PURE__ */ v(i, {
+							E.reportingCurrency && /* @__PURE__ */ v(n, {
 								label: "Reporting currency convention",
 								value: E.reportingCurrency,
 								onChange: (e) => z({ reportingCurrency: e })

package/dist/components/freight-invoice/InvoiceReviewPanel.js

@@ -0,0 +1,255 @@
+import { Button as e } from "../ui.js";
+import { useConditionApi as t, useConditionQuery as n } from "../../hooks/useContainerCondition.js";
+import { ReuseState as r, reuseCard as i } from "../ReuseControls.js";
+import { FreightSelect as a } from "../freight-cost/FreightFields.js";
+import { DecideInvoiceReviewDocument as o, HandOffInvoiceSettlementDocument as s, InvoiceReviewExactDocument as c, RecordInvoiceSupplierResponseDocument as l, ResolveInvoiceDisputeDocument as u } from "../../src/generated/freight-invoice-operations.js";
+import { invoiceMoney as d } from "../../utils/invoiceComparison.js";
+import { DRAFT_PROBLEM_LABELS as f, REVIEW_EVENT_LABELS as p, REVIEW_STATUS_LABELS as m, authorNotice as h, availableReviewActions as g, decisionInput as _, handOffInput as v, isDraftProblem as y, resolutionInput as b, supplierResponseInput as x } from "../../utils/invoiceReview.js";
+import { useState as S } from "react";
+import { Fragment as C, jsx as w, jsxs as T } from "react/jsx-runtime";
+//#region src/movethewheels/components/freight-invoice/InvoiceReviewPanel.tsx
+var E = "mt-1 min-h-24 w-full rounded border p-2";
+function D({ record: e, permissions: t, onChanged: a }) {
+	let [o, s] = S(0), l = n(c, t.canRead ? {
+		shipmentId: e.shipmentId,
+		comparisonId: e.id
+	} : null, o);
+	if (!t.canRead) return /* @__PURE__ */ T("section", {
+		className: i,
+		"aria-label": "Invoice review",
+		children: [/* @__PURE__ */ w("h2", {
+			className: "text-lg font-semibold",
+			children: "Invoice review"
+		}), /* @__PURE__ */ w("p", { children: "Freight invoice read permission is required to see the review status of this invoice." })]
+	});
+	let u = l.data?.mtwFreightInvoiceReview;
+	return /* @__PURE__ */ T("section", {
+		className: i,
+		"aria-label": "Invoice review",
+		children: [
+			/* @__PURE__ */ w("h2", {
+				className: "text-lg font-semibold",
+				children: "Invoice review"
+			}),
+			/* @__PURE__ */ w(r, {
+				loading: l.loading,
+				error: l.error
+			}),
+			u && /* @__PURE__ */ w(O, {
+				review: u,
+				lines: e.facts.rows,
+				permissions: t,
+				onRecorded: () => {
+					s((e) => e + 1), a?.();
+				}
+			}, `${u.comparisonId}:${u.sequence}`)
+		]
+	});
+}
+function O({ review: e, lines: t, permissions: n, onRecorded: r }) {
+	let i = g(e, n), a = h(e), o = (e) => t.find((t) => t.id === e)?.description ?? e;
+	return /* @__PURE__ */ T("div", {
+		className: "space-y-4",
+		children: [
+			/* @__PURE__ */ T("p", {
+				className: "font-medium",
+				role: "status",
+				children: ["Status: ", m[e.status]]
+			}),
+			/* @__PURE__ */ T("p", { children: [
+				"Revision ",
+				e.revision,
+				" of ",
+				e.latestRevision,
+				". Known invoice amount",
+				" ",
+				d(e.knownInvoiceAmountMinor, e.currency),
+				e.invoiceAmountComplete ? "" : " (some reported amounts are unknown and are not counted as zero)",
+				"."
+			] }),
+			e.status === "SUPERSEDED" && /* @__PURE__ */ T("p", { children: ["A newer correction replaces this revision; review continues on the latest revision.", e.resolvedByCorrection && " Its open dispute was resolved by that correction."] }),
+			e.settlementReference && /* @__PURE__ */ T("p", { children: [
+				"Handed to platform Billing for settlement under reference",
+				" ",
+				/* @__PURE__ */ w("span", {
+					className: "break-all font-mono",
+					children: e.settlementReference
+				}),
+				". This revision can no longer be corrected."
+			] }),
+			a && /* @__PURE__ */ w("p", { children: a }),
+			e.events.length > 0 && /* @__PURE__ */ w("ol", {
+				className: "space-y-2",
+				"aria-label": "Review history",
+				children: e.events.map((e) => /* @__PURE__ */ T("li", {
+					className: "rounded border p-3 text-sm",
+					children: [
+						/* @__PURE__ */ T("p", {
+							className: "font-medium",
+							children: [
+								e.sequence,
+								". ",
+								p[e.kind],
+								" —",
+								" ",
+								m[e.statusAfter]
+							]
+						}),
+						/* @__PURE__ */ T("p", { children: [
+							e.recordedAt,
+							" by ",
+							e.createdBy
+						] }),
+						e.reason && /* @__PURE__ */ w("p", {
+							className: "whitespace-pre-wrap break-words",
+							children: e.reason
+						}),
+						e.disputedLineIds.length > 0 && /* @__PURE__ */ T("p", { children: ["Disputed lines: ", e.disputedLineIds.map(o).join(", ")] })
+					]
+				}, e.id))
+			}),
+			i.length > 0 ? /* @__PURE__ */ w(A, {
+				review: e,
+				actions: i,
+				lines: t,
+				onRecorded: r
+			}) : e.status !== "SUPERSEDED" && e.status !== "SETTLEMENT_HANDED_OFF" && !a && /* @__PURE__ */ w("p", { children: "Your role cannot take the next review step on this invoice." })
+		]
+	});
+}
+var k = {
+	DECIDE: "Accept or dispute",
+	RECORD_SUPPLIER_RESPONSE: "Record supplier response",
+	RESOLVE_DISPUTE: "Resolve dispute",
+	HAND_OFF_SETTLEMENT: "Hand off to Billing"
+};
+function A({ review: n, actions: r, lines: i, onRecorded: c }) {
+	let p = t(), [m, h] = S(r[0]), [g, D] = S("ACCEPTED"), [O, A] = S("ACCEPTED"), [j, M] = S(""), [N, P] = S([]), [F, I] = S(() => crypto.randomUUID()), [L, R] = S(!1), [z, B] = S(null), V = (e) => (t) => {
+		e(t), I(crypto.randomUUID()), B(null);
+	}, H = {
+		review: n,
+		idempotencyKey: F
+	}, U = async () => {
+		let e = m === "DECIDE" ? {
+			document: o,
+			input: _(H, g, j, N)
+		} : m === "RECORD_SUPPLIER_RESPONSE" ? {
+			document: l,
+			input: x(H, j)
+		} : m === "RESOLVE_DISPUTE" ? {
+			document: u,
+			input: b(H, O, j)
+		} : {
+			document: s,
+			input: v(H, j)
+		};
+		if (y(e.input)) {
+			B(f[e.input]);
+			return;
+		}
+		R(!0), B(null);
+		try {
+			await p(e.document, { input: e.input }), c();
+		} catch (e) {
+			B(e instanceof Error ? e.message : "The review step was not recorded.");
+		} finally {
+			R(!1);
+		}
+	};
+	return /* @__PURE__ */ T("form", {
+		className: "space-y-3 border-t pt-4",
+		"aria-label": "Next review step",
+		onSubmit: (e) => {
+			e.preventDefault(), U();
+		},
+		children: [
+			r.length > 1 && /* @__PURE__ */ w(a, {
+				label: "Review step",
+				value: m,
+				onChange: (e) => V(h)(e),
+				children: r.map((e) => /* @__PURE__ */ w("option", {
+					value: e,
+					children: k[e]
+				}, e))
+			}),
+			m === "DECIDE" && /* @__PURE__ */ T(C, { children: [/* @__PURE__ */ T(a, {
+				label: "Decision",
+				value: g,
+				onChange: (e) => V(D)(e),
+				children: [
+					/* @__PURE__ */ w("option", {
+						value: "ACCEPTED",
+						children: "Accept"
+					}),
+					/* @__PURE__ */ w("option", {
+						value: "ACCEPTED_WITH_VARIANCE",
+						children: "Accept with variance"
+					}),
+					/* @__PURE__ */ w("option", {
+						value: "DISPUTED",
+						children: "Dispute"
+					})
+				]
+			}), g === "DISPUTED" && /* @__PURE__ */ T("fieldset", {
+				className: "space-y-2",
+				children: [/* @__PURE__ */ w("legend", {
+					className: "text-sm font-medium",
+					children: "Disputed invoice lines"
+				}), i.map((e) => /* @__PURE__ */ T("label", {
+					className: "flex min-h-11 items-center gap-2 text-sm",
+					children: [
+						/* @__PURE__ */ w("input", {
+							type: "checkbox",
+							checked: N.includes(e.id),
+							onChange: (t) => V(P)(t.target.checked ? [...N, e.id] : N.filter((t) => t !== e.id))
+						}),
+						e.description,
+						" (",
+						d(e.amountMinor, e.currency),
+						")"
+					]
+				}, e.id))]
+			})] }),
+			m === "RESOLVE_DISPUTE" && /* @__PURE__ */ T(a, {
+				label: "Resolution",
+				value: O,
+				onChange: (e) => V(A)(e),
+				children: [/* @__PURE__ */ w("option", {
+					value: "ACCEPTED",
+					children: "Accept as invoiced"
+				}), /* @__PURE__ */ w("option", {
+					value: "ACCEPTED_WITH_VARIANCE",
+					children: "Accept with variance"
+				})]
+			}),
+			/* @__PURE__ */ T("label", {
+				className: "block text-sm",
+				children: [m === "RECORD_SUPPLIER_RESPONSE" ? "Supplier's response" : m === "HAND_OFF_SETTLEMENT" ? "Note for Billing (optional)" : "Reason", /* @__PURE__ */ w("textarea", {
+					className: E,
+					value: j,
+					maxLength: 1e3,
+					onChange: (e) => V(M)(e.target.value)
+				})]
+			}),
+			m === "RESOLVE_DISPUTE" && /* @__PURE__ */ w("p", {
+				className: "text-sm",
+				children: "A dispute can also close by recording a corrected invoice revision."
+			}),
+			m === "HAND_OFF_SETTLEMENT" && /* @__PURE__ */ w("p", {
+				className: "text-sm",
+				children: "Billing settles the invoice; MoveTheWheels keeps no payment ledger. After hand-off this revision can no longer be corrected."
+			}),
+			z && /* @__PURE__ */ w("p", {
+				role: "alert",
+				children: z
+			}),
+			/* @__PURE__ */ w(e, {
+				type: "submit",
+				disabled: L,
+				children: L ? "Recording…" : k[m]
+			})
+		]
+	});
+}
+//#endregion
+export { D as InvoiceReviewPanel };

package/dist/components/freight-invoice/InvoiceReviewQueue.js

@@ -0,0 +1,93 @@
+import { Button as e } from "../ui.js";
+import { useConditionQuery as t } from "../../hooks/useContainerCondition.js";
+import { ReusePager as n, ReuseState as r, reuseCard as i } from "../ReuseControls.js";
+import { FreightSelect as a } from "../freight-cost/FreightFields.js";
+import { InvoiceReviewQueueDocument as o, InvoiceReviewSummaryDocument as s } from "../../src/generated/freight-invoice-operations.js";
+import { invoiceMoney as c } from "../../utils/invoiceComparison.js";
+import { REVIEW_QUEUE_STATUSES as l, REVIEW_STATUS_LABELS as u } from "../../utils/invoiceReview.js";
+import { useState as d } from "react";
+import { jsx as f, jsxs as p } from "react/jsx-runtime";
+//#region src/movethewheels/components/freight-invoice/InvoiceReviewQueue.tsx
+var m = 10;
+function h({ revision: s, onOpen: h, locked: g = !1 }) {
+	let [_, v] = d("AWAITING_REVIEW"), [y, b] = d(0), x = t(o, {
+		status: _ || null,
+		pagination: {
+			limit: m,
+			offset: y
+		}
+	}, s), S = x.data?.mtwFreightInvoiceReviewPage;
+	return /* @__PURE__ */ p("section", {
+		className: i,
+		"aria-label": "Invoice review queue",
+		children: [
+			/* @__PURE__ */ f("h2", {
+				className: "text-lg font-semibold",
+				children: "Invoice review queue"
+			}),
+			/* @__PURE__ */ f("p", { children: "The latest revision of each recorded carrier invoice. Open one to review it." }),
+			g && /* @__PURE__ */ f("p", {
+				role: "status",
+				children: "Finish or cancel the invoice draft below before opening a review."
+			}),
+			/* @__PURE__ */ p(a, {
+				label: "Review status",
+				value: _,
+				onChange: (e) => {
+					v(e), b(0);
+				},
+				children: [/* @__PURE__ */ f("option", {
+					value: "",
+					children: "All statuses"
+				}), l.map((e) => /* @__PURE__ */ f("option", {
+					value: e,
+					children: u[e]
+				}, e))]
+			}),
+			/* @__PURE__ */ f(r, {
+				loading: x.loading,
+				error: x.error
+			}),
+			S && S.items.length === 0 && /* @__PURE__ */ f("p", { children: "No invoices with this review status." }),
+			/* @__PURE__ */ f("ul", {
+				className: "space-y-2",
+				children: S?.items.map((t) => /* @__PURE__ */ f("li", { children: /* @__PURE__ */ p(e, {
+					type: "button",
+					variant: "outline",
+					className: "h-auto w-full max-w-full justify-start whitespace-normal break-words text-left",
+					disabled: g,
+					onClick: () => h(t),
+					children: [
+						t.supplierLabel ?? t.supplierReference,
+						" / invoice ",
+						t.invoiceReference,
+						", revision ",
+						t.revision,
+						" — ",
+						u[t.status],
+						" —",
+						" ",
+						c(t.knownInvoiceAmountMinor, t.currency),
+						t.invoiceAmountComplete ? "" : " known"
+					]
+				}) }, t.comparisonId))
+			}),
+			/* @__PURE__ */ f(n, {
+				page: S,
+				busy: x.loading,
+				offset: y,
+				onChange: b
+			})
+		]
+	});
+}
+function g(e) {
+	let n = t(s, e ? {} : null);
+	return {
+		summary: n.data?.mtwFreightInvoiceReviewSummary ?? null,
+		loading: n.loading,
+		error: n.error
+	};
+}
+//#endregion
+export { h as InvoiceReviewQueue, g as useInvoiceReviewSummary };