@burdenoff/microfe-movethewheels 2026.1016.3 → 2026.1016.4

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

@@ -0,0 +1,366 @@
+import { Button as e } from "../ui.js";
+import { ContainerEvidencePicker as t } from "../ContainerEvidencePicker.js";
+import { FreightCurrency as n, FreightSelect as r, FreightText as i } from "../freight-cost/FreightFields.js";
+import { fixedFreightMinor as a, freightMoney as o } from "../../utils/freightDraft.js";
+import { invoiceCanonical as s, invoiceFactsInput as c, matchesInvoicePreview as l } from "../../utils/invoiceComparison.js";
+import { InvoiceResults as u } from "./InvoiceResults.js";
+import { useEffect as d, useRef as f, useState as p } from "react";
+import { jsx as m, jsxs as h } from "react/jsx-runtime";
+//#region src/movethewheels/components/freight-invoice/InvoiceForm.tsx
+function g() {
+	return {
+		schemaVersion: 1,
+		supplierReference: null,
+		supplierLabel: null,
+		invoiceReference: null,
+		sourceReference: "",
+		sourceRevision: "",
+		invoiceDate: null,
+		currency: {
+			code: "",
+			minorUnitDigits: 2
+		},
+		rows: [{
+			id: crypto.randomUUID(),
+			description: "",
+			estimateLineId: null,
+			currency: {
+				code: "",
+				minorUnitDigits: 2
+			},
+			payerReference: null,
+			payerLabel: null,
+			quantity: null,
+			unit: null,
+			unitRateMajor: null,
+			amountMinor: null,
+			zeroReason: null
+		}]
+	};
+}
+function _(e) {
+	return {
+		id: e.id,
+		estimateReference: e.estimateReference,
+		version: e.version,
+		kind: e.facts.kind,
+		sourceReference: e.facts.sourceReference,
+		sourceRevision: e.facts.sourceRevision,
+		quotedAt: e.facts.quotedAt,
+		validFrom: e.facts.validFrom,
+		validUntil: e.facts.validUntil,
+		acceptance: "NOT_ESTABLISHED"
+	};
+}
+function v({ estimate: v, previous: y, disabled: b, canRecord: x, onPreview: S, onSave: C }) {
+	let [w, T] = p(() => y ? structuredClone(y.facts) : g()), [E, D] = p([]), [O, k] = p(""), [A, j] = p(null), [M, N] = p(null), [P, F] = p(!1), I = f(null), L = f(!0), R = f(!1);
+	d(() => (L.current = !0, () => {
+		L.current = !1;
+	}), []);
+	let z = s({
+		facts: w,
+		evidence: E.map(({ fileId: e, versionId: t }) => ({
+			fileId: e,
+			versionId: t
+		})),
+		estimateId: v.id
+	}), B = A?.body === z ? A.value : null, V = (e) => T({
+		...w,
+		...e
+	}), H = (e, t) => V({ rows: w.rows.map((n) => n.id === e ? {
+		...n,
+		...t
+	} : n) }), U = async () => {
+		if (R.current || b || !I.current?.reportValidity()) return;
+		R.current = !0, F(!0), N(null);
+		let e = z;
+		try {
+			let t = c(w), n = await S({
+				shipmentId: v.shipmentId,
+				estimateVersionId: v.id,
+				facts: t,
+				evidence: E.map(({ fileId: e, versionId: t }) => ({
+					fileId: e,
+					versionId: t
+				}))
+			});
+			if (!l(n, t, _(v))) throw Error("The preview did not match these reported facts and exact estimate. Nothing was sent.");
+			L.current && j({
+				body: e,
+				value: n
+			});
+		} catch (e) {
+			L.current && N(e instanceof Error ? e.message : "Unable to preview the reported facts.");
+		} finally {
+			R.current = !1, L.current && F(!1);
+		}
+	};
+	return /* @__PURE__ */ h("form", {
+		ref: I,
+		className: "min-w-0 space-y-5",
+		"aria-label": "Manual invoice comparison",
+		onSubmit: (e) => {
+			if (e.preventDefault(), !(!B || B.recordable !== !0 || b || !x || R.current)) {
+				N(null);
+				try {
+					let e = c(w);
+					C({
+						shipmentId: v.shipmentId,
+						estimateVersionId: v.id,
+						facts: e,
+						evidence: E.map(({ fileId: e, versionId: t }) => ({
+							fileId: e,
+							versionId: t
+						})),
+						expectedRevision: y?.revision ?? 0,
+						expectedPreviousComparisonId: y?.id ?? null,
+						correctionReason: y && O.trim() || null
+					}, _(v)).catch(() => N("The original request remains retained; inspect read-only recovery."));
+				} catch (e) {
+					N(e instanceof Error ? e.message : "Review the reported source fields. Nothing was sent.");
+				}
+			}
+		},
+		children: [
+			/* @__PURE__ */ h("fieldset", {
+				disabled: b || P,
+				className: "min-w-0 space-y-5",
+				children: [
+					/* @__PURE__ */ m("legend", {
+						className: "text-lg font-semibold",
+						children: y ? "Append an immutable correction" : "Reported supplier invoice"
+					}),
+					/* @__PURE__ */ m("p", { children: "Blank means unknown, never zero. This is a manual comparison, not approval or payment. No FX, credits or split allocation." }),
+					/* @__PURE__ */ h("p", { children: [
+						"Exact pinned ",
+						v.facts.kind.toLowerCase(),
+						": ",
+						v.estimateReference,
+						" / version",
+						" ",
+						v.version,
+						"; ",
+						v.facts.title,
+						". Source validity: ",
+						v.validityAtRead,
+						". Acceptance is not established."
+					] }),
+					/* @__PURE__ */ h("div", {
+						className: "grid min-w-0 gap-3 md:grid-cols-2",
+						children: [
+							/* @__PURE__ */ m(i, {
+								label: "Supplier source reference",
+								value: w.supplierReference ?? "",
+								disabled: !!y,
+								onChange: (e) => V({ supplierReference: e })
+							}),
+							/* @__PURE__ */ m(i, {
+								label: "Supplier label",
+								value: w.supplierLabel ?? "",
+								onChange: (e) => V({ supplierLabel: e })
+							}),
+							/* @__PURE__ */ m(i, {
+								label: "Invoice reference",
+								value: w.invoiceReference ?? "",
+								disabled: !!y,
+								onChange: (e) => V({ invoiceReference: e })
+							}),
+							/* @__PURE__ */ m(i, {
+								label: "Invoice source reference",
+								value: w.sourceReference,
+								required: !0,
+								onChange: (e) => V({ sourceReference: e })
+							}),
+							/* @__PURE__ */ m(i, {
+								label: "Invoice source revision",
+								value: w.sourceRevision,
+								required: !0,
+								onChange: (e) => V({ sourceRevision: e })
+							}),
+							/* @__PURE__ */ m(i, {
+								label: "Invoice source date (optional)",
+								type: "date",
+								value: w.invoiceDate ?? "",
+								onChange: (e) => V({ invoiceDate: e || null })
+							})
+						]
+					}),
+					/* @__PURE__ */ m(n, {
+						label: "Invoice currency",
+						value: w.currency,
+						onChange: (e) => V({
+							currency: e,
+							rows: w.rows.map((t) => ({
+								...t,
+								currency: e,
+								amountMinor: null,
+								zeroReason: null
+							}))
+						})
+					}),
+					w.rows.map((t, n) => /* @__PURE__ */ h("fieldset", {
+						className: "min-w-0 space-y-3 rounded border p-3",
+						children: [
+							/* @__PURE__ */ h("legend", {
+								className: "font-semibold",
+								children: ["Reported row ", n + 1]
+							}),
+							/* @__PURE__ */ m(i, {
+								label: `Row ${n + 1} description`,
+								value: t.description,
+								required: !0,
+								onChange: (e) => H(t.id, { description: e })
+							}),
+							/* @__PURE__ */ h(r, {
+								label: `Row ${n + 1} exact estimate mapping`,
+								value: t.estimateLineId ?? "",
+								onChange: (e) => H(t.id, { estimateLineId: e || null }),
+								children: [/* @__PURE__ */ m("option", {
+									value: "",
+									children: "Unmatched invoice row"
+								}), v.facts.lines.map((e) => /* @__PURE__ */ h("option", {
+									value: e.id,
+									children: [
+										e.description,
+										" / ",
+										e.id,
+										" / ",
+										e.disposition
+									]
+								}, e.id))]
+							}),
+							/* @__PURE__ */ h("div", {
+								className: "grid min-w-0 gap-3 md:grid-cols-2",
+								children: [
+									/* @__PURE__ */ m(i, {
+										label: `Row ${n + 1} payer source reference`,
+										value: t.payerReference ?? "",
+										onChange: (e) => H(t.id, { payerReference: e })
+									}),
+									/* @__PURE__ */ m(i, {
+										label: `Row ${n + 1} payer label`,
+										value: t.payerLabel ?? "",
+										onChange: (e) => H(t.id, { payerLabel: e })
+									}),
+									/* @__PURE__ */ h("label", {
+										className: "block text-sm",
+										children: [
+											"Row ",
+											n + 1,
+											" supplied amount (",
+											t.currency.code || "declare currency",
+											")",
+											/* @__PURE__ */ m("input", {
+												className: "mt-1 min-h-11 w-full rounded border p-2",
+												"aria-label": `Row ${n + 1} supplied amount`,
+												inputMode: "decimal",
+												defaultValue: t.amountMinor == null ? "" : o(t.amountMinor, t.currency.minorUnitDigits),
+												onChange: (e) => {
+													try {
+														H(t.id, { amountMinor: a(e.target.value, t.currency.minorUnitDigits) }), e.target.setCustomValidity("");
+													} catch (n) {
+														H(t.id, { amountMinor: null }), e.target.setCustomValidity(n instanceof Error ? n.message : "Invalid sourced amount.");
+													}
+												}
+											}, `${t.currency.code}:${t.currency.minorUnitDigits}`)
+										]
+									}),
+									/* @__PURE__ */ m(i, {
+										label: `Row ${n + 1} zero source reason`,
+										value: t.zeroReason ?? "",
+										onChange: (e) => H(t.id, { zeroReason: e })
+									}),
+									/* @__PURE__ */ m(i, {
+										label: `Row ${n + 1} supplied quantity`,
+										value: t.quantity ?? "",
+										onChange: (e) => H(t.id, { quantity: e })
+									}),
+									/* @__PURE__ */ m(i, {
+										label: `Row ${n + 1} explicit unit`,
+										value: t.unit ?? "",
+										onChange: (e) => H(t.id, { unit: e })
+									}),
+									/* @__PURE__ */ m(i, {
+										label: `Row ${n + 1} supplied unit rate`,
+										value: t.unitRateMajor ?? "",
+										onChange: (e) => H(t.id, { unitRateMajor: e })
+									})
+								]
+							}),
+							/* @__PURE__ */ h("p", { children: [
+								w.currency.code || "currency unknown",
+								" / decimal places",
+								" ",
+								w.currency.minorUnitDigits,
+								". Amount stays as supplied, not quantity × rate."
+							] }),
+							/* @__PURE__ */ h(e, {
+								type: "button",
+								variant: "outline",
+								disabled: w.rows.length === 1,
+								onClick: () => V({ rows: w.rows.filter((e) => e.id !== t.id) }),
+								children: ["Remove row ", n + 1]
+							})
+						]
+					}, t.id)),
+					/* @__PURE__ */ m(e, {
+						type: "button",
+						variant: "outline",
+						disabled: w.rows.length >= 100,
+						onClick: () => V({ rows: [...w.rows, {
+							id: crypto.randomUUID(),
+							description: "",
+							estimateLineId: null,
+							currency: { ...w.currency },
+							payerReference: null,
+							payerLabel: null,
+							quantity: null,
+							unit: null,
+							unitRateMajor: null,
+							amountMinor: null,
+							zeroReason: null
+						}] }),
+						children: "Add reported row"
+					}),
+					/* @__PURE__ */ m(t, {
+						currentOnly: !0,
+						value: E,
+						onChange: D,
+						description: "Choose current readable ACTIVE Files versions with an integrity fingerprint. The server rechecks eligibility when recording; no binary is uploaded here."
+					}),
+					y && /* @__PURE__ */ m(i, {
+						label: "Correction source reason",
+						value: O,
+						required: !1,
+						onChange: k
+					}),
+					/* @__PURE__ */ h("div", {
+						className: "flex flex-wrap gap-3",
+						children: [/* @__PURE__ */ m(e, {
+							type: "button",
+							variant: "outline",
+							onClick: () => void U(),
+							children: "Preview reported comparison"
+						}), /* @__PURE__ */ m(e, {
+							type: "submit",
+							disabled: !x || B?.recordable !== !0 || !E.length || !!y && !O.trim(),
+							children: "Record immutable comparison"
+						})]
+					})
+				]
+			}),
+			!x && /* @__PURE__ */ m("p", { children: "Shipment update permission is required to record; structural preview remains read-only." }),
+			P && /* @__PURE__ */ m("p", {
+				role: "status",
+				children: "Comparing the exact recorded facts…"
+			}),
+			M && /* @__PURE__ */ m("p", {
+				role: "alert",
+				children: M
+			}),
+			B && /* @__PURE__ */ m(u, { value: B })
+		]
+	});
+}
+//#endregion
+export { v as InvoiceForm };

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

@@ -0,0 +1,240 @@
+import { reuseCard as e } from "../ReuseControls.js";
+import { freightLabel as t } from "../../utils/freightDraft.js";
+import { invoiceMoney as n, invoiceRowDifference as r } from "../../utils/invoiceComparison.js";
+import { jsx as i, jsxs as a } from "react/jsx-runtime";
+//#region src/movethewheels/components/freight-invoice/InvoiceResults.tsx
+function o({ value: o }) {
+	let { estimate: s, outcome: c } = o;
+	return /* @__PURE__ */ a("section", {
+		className: e,
+		"aria-label": "Invoice comparison results",
+		children: [
+			/* @__PURE__ */ i("h2", {
+				className: "text-lg font-semibold",
+				children: "Recorded-fact comparison"
+			}),
+			/* @__PURE__ */ a("p", { children: [
+				"Exact ",
+				s.kind.toLowerCase(),
+				" ",
+				s.estimateReference,
+				", version ",
+				s.version,
+				". Source ",
+				s.sourceReference,
+				" / ",
+				s.sourceRevision,
+				"."
+			] }),
+			/* @__PURE__ */ a("p", { children: [
+				"Quote date ",
+				s.quotedAt ?? "Unknown",
+				"; source validity",
+				" ",
+				s.validFrom ?? "Unknown",
+				" to ",
+				s.validUntil ?? "Unknown",
+				". Acceptance is not established by this comparison."
+			] }),
+			"recordable" in o && /* @__PURE__ */ a("p", {
+				role: "status",
+				children: [
+					"Structural preview only.",
+					" ",
+					o.recordable ? "Source structure is recordable; current permission and Files eligibility are checked when recording." : `Not recordable: ${o.blockers.map(t).join(", ")}.`
+				]
+			}),
+			/* @__PURE__ */ i("p", {
+				className: "font-medium",
+				children: c.allLinesMatched ? "All explicitly compared rows and expected coverage agree under this method." : "Differences or unknown coverage remain."
+			}),
+			/* @__PURE__ */ i("p", { children: "This is not an all-in cost, contracted-rate audit, liability finding, invoice approval or payment." }),
+			c.rows.map((e, n) => /* @__PURE__ */ a("article", {
+				className: "min-w-0 space-y-2 rounded border p-3",
+				children: [
+					/* @__PURE__ */ a("h3", {
+						className: "font-medium",
+						children: [
+							"Row ",
+							n + 1,
+							":",
+							" ",
+							o.facts.rows.find((t) => t.id === e.invoiceLineId)?.description ?? "Reported charge"
+						]
+					}),
+					/* @__PURE__ */ i("p", { children: e.estimateLineId ? "Mapped to the selected estimate row." : "No estimate row mapped." }),
+					/* @__PURE__ */ i("p", { children: e.flags.map(t).join(" · ") }),
+					e.reasons.length > 0 && /* @__PURE__ */ a("p", { children: ["Unknown reasons: ", e.reasons.map(t).join(", ")] }),
+					/* @__PURE__ */ a("p", { children: ["Comparable amount difference: ", r(o, e.invoiceLineId)] })
+				]
+			}, e.invoiceLineId)),
+			c.missingExpectedLineIds.map((e) => /* @__PURE__ */ a("p", { children: [
+				"Missing expected line: ",
+				e,
+				". An unknown value is not treated as zero."
+			] }, e)),
+			c.unknownExpectedCoverage.map((e) => /* @__PURE__ */ a("p", { children: [
+				"Unknown expected-charge coverage: ",
+				e.estimateLineId,
+				". This is not a proven missing charge."
+			] }, e.estimateLineId)),
+			/* @__PURE__ */ a("section", {
+				className: "space-y-2",
+				children: [
+					/* @__PURE__ */ i("h3", {
+						className: "font-semibold",
+						children: "Comparable pairs only"
+					}),
+					c.comparableSubtotals.length === 0 && /* @__PURE__ */ i("p", { children: "No bounded comparable subtotal." }),
+					c.comparableSubtotals.map((e) => /* @__PURE__ */ a("p", { children: [
+						"Payer",
+						" ",
+						o.facts.rows.find((t) => t.payerReference === e.payerReference)?.payerLabel ?? e.payerReference,
+						": estimate ",
+						n(e.estimateMinor, e.currency),
+						", invoice",
+						" ",
+						n(e.invoiceMinor, e.currency),
+						", difference",
+						" ",
+						n(e.deltaMinor, e.currency),
+						". Included rows",
+						" ",
+						e.invoiceLineIds.map((e) => o.facts.rows.find((t) => t.id === e)?.description ?? "Reported charge").join(", "),
+						". Other rows are omitted."
+					] }, JSON.stringify([e.currency, e.payerReference])))
+				]
+			}),
+			[["Declared estimate subtotals", o.estimateDeclaredSubtotals], ["Declared invoice subtotals", o.invoiceDeclaredSubtotals]].map(([e, t]) => /* @__PURE__ */ a("section", {
+				className: "space-y-2",
+				children: [/* @__PURE__ */ i("h3", {
+					className: "font-semibold",
+					children: e
+				}), t.map((e, t) => /* @__PURE__ */ a("p", { children: [
+					"Payer ",
+					e.payerLabel ?? "Unknown",
+					" (",
+					e.payerReference ?? "Unknown reference",
+					");",
+					" ",
+					"known ",
+					n(e.knownAmountMinor, e.currency),
+					"; total",
+					" ",
+					n(e.totalAmountMinor, e.currency),
+					"."
+				] }, JSON.stringify([
+					e.currency,
+					e.payerReference,
+					t
+				])))]
+			}, e))
+		]
+	});
+}
+function s({ record: e }) {
+	return /* @__PURE__ */ a("section", {
+		className: "min-w-0 space-y-4 break-words",
+		children: [
+			/* @__PURE__ */ a("h2", {
+				className: "text-lg font-semibold",
+				children: ["Immutable comparison revision ", e.revision]
+			}),
+			/* @__PURE__ */ a("p", { children: [
+				"Invoice ",
+				e.facts.invoiceReference,
+				"; supplier",
+				" ",
+				e.facts.supplierLabel ?? "Unknown label",
+				" (",
+				e.facts.supplierReference,
+				"). Source",
+				" ",
+				e.facts.sourceReference,
+				" / ",
+				e.facts.sourceRevision,
+				"; invoice date",
+				" ",
+				e.facts.invoiceDate ?? "Unknown",
+				"."
+			] }),
+			/* @__PURE__ */ a("p", { children: [
+				"Recorded ",
+				e.recordedAt,
+				" by ",
+				e.createdBy,
+				", ",
+				t(e.actorProvenance),
+				"; on behalf of ",
+				e.onBehalfOf ?? "Not declared",
+				". Method ",
+				e.methodVersion,
+				"."
+			] }),
+			e.correctionReason && /* @__PURE__ */ a("p", { children: [
+				"Correction reason: ",
+				e.correctionReason,
+				"; predecessor ",
+				e.previousComparisonId,
+				"."
+			] }),
+			/* @__PURE__ */ a("details", { children: [/* @__PURE__ */ i("summary", {
+				className: "min-h-11 cursor-pointer font-medium",
+				children: "Original reported rows and exact evidence"
+			}), /* @__PURE__ */ a("div", {
+				className: "space-y-3",
+				children: [e.facts.rows.map((e) => /* @__PURE__ */ a("article", {
+					className: "rounded border p-3",
+					children: [
+						/* @__PURE__ */ a("h3", { children: [
+							e.description,
+							" (",
+							e.id,
+							")"
+						] }),
+						/* @__PURE__ */ a("p", { children: [
+							"Mapping ",
+							e.estimateLineId ?? "Unmatched",
+							"; amount",
+							" ",
+							n(e.amountMinor, e.currency),
+							"; payer ",
+							e.payerLabel ?? "Unknown",
+							" (",
+							e.payerReference ?? "Unknown reference",
+							")."
+						] }),
+						/* @__PURE__ */ a("p", { children: [
+							"Quantity ",
+							e.quantity ?? "Unknown",
+							" ",
+							e.unit ?? "unknown unit",
+							"; supplied rate",
+							" ",
+							e.unitRateMajor ?? "Unknown",
+							". Invoice amount was not recalculated."
+						] }),
+						e.zeroReason && /* @__PURE__ */ a("p", { children: ["Zero reason: ", e.zeroReason] })
+					]
+				}, e.id)), e.evidence.map((e) => /* @__PURE__ */ a("p", {
+					className: "break-all",
+					children: [
+						"File ",
+						e.fileId,
+						", exact version ",
+						e.versionId,
+						"; SHA256 ",
+						e.sha256Hash,
+						"; checked",
+						" ",
+						e.checkedAt,
+						". Point-in-time eligibility only."
+					]
+				}, e.versionId))]
+			})] }),
+			/* @__PURE__ */ i(o, { value: e })
+		]
+	});
+}
+//#endregion
+export { s as InvoiceHistoryRecord, o as InvoiceResults };