@happyvertical/smrt-commerce 0.56.0 → 0.56.2

package/dist/money.js

@@ -0,0 +1,274 @@
+import { n as roundSignedRational, t as allocateSignedRationals } from "./chunks/money-rational-CcW7gzG5.js";
+import { ISO_4217_MINOR_UNITS } from "@happyvertical/smrt-ui/currency";
+//#region src/money.ts
+function assertIntegerMinorUnits(context, label, entries) {
+	for (const [field, value] of entries) if (!Number.isFinite(value) || !Number.isInteger(value)) throw new Error(`${context} ${label}: ${field} must be an integer number of minor units (cents, satoshis) \u2014 got ${value}. Money is exact: $19.99 is 1999, not 19.99.`);
+}
+var MoneyValidationError = class extends Error {
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+		this.publicMessage = message;
+	}
+	code;
+	name = "MoneyValidationError";
+	/** Explicit marker consumed by public transports that preserve typed errors. */
+	publicMessage;
+};
+var PERCENT_SCALE = 1000000n;
+var PERCENT_DENOMINATOR = 100n * PERCENT_SCALE;
+var MAX_SAFE_MONEY = BigInt(Number.MAX_SAFE_INTEGER);
+var IDENTIFIER = /^\S(?:.*\S)?$/;
+function validationError(code, message) {
+	throw new MoneyValidationError(code, message);
+}
+function assertIdentifier(value, label) {
+	if (typeof value !== "string" || !IDENTIFIER.test(value)) validationError("INVALID_MONEY_INPUT", `${label} must be a nonempty string`);
+}
+function safeMoney(value) {
+	if (value > MAX_SAFE_MONEY || value < -MAX_SAFE_MONEY) validationError("UNSAFE_MONEY", "Money exceeds safe integer minor units");
+	return Number(value);
+}
+function money(value) {
+	if (!Number.isSafeInteger(value)) validationError("UNSAFE_MONEY", "Money must be safe integer minor units");
+	return BigInt(value);
+}
+function numberDecimal(value, precision) {
+	if (!Number.isFinite(value) || value < 0 || value > Number.MAX_SAFE_INTEGER) validationError("INVALID_MONEY_INPUT", "Quantity is outside the supported range");
+	const [mantissa, exponentText = "0"] = value.toString().split("e");
+	const [whole, fraction = ""] = mantissa.split(".");
+	const places = fraction.length - Number(exponentText);
+	if (places > precision) validationError("INVALID_MONEY_INPUT", "Quantity exceeds the supported decimal precision");
+	const coefficient = BigInt(whole + fraction);
+	return places < 0 ? {
+		coefficient: coefficient * 10n ** BigInt(-places),
+		scale: 1n
+	} : {
+		coefficient,
+		scale: 10n ** BigInt(places)
+	};
+}
+function percentUnits(value) {
+	if (typeof value !== "string" || !/^(?:0|[1-9]\d{0,2})(?:\.\d{1,6})?$/.test(value)) validationError("PERCENT_OUT_OF_RANGE", "Percent must be an exact decimal from 0 through 100 with at most six fractional digits");
+	const [whole, fraction = ""] = value.split(".");
+	const units = BigInt(whole) * PERCENT_SCALE + BigInt(fraction.padEnd(6, "0"));
+	if (units > PERCENT_DENOMINATOR) validationError("PERCENT_OUT_OF_RANGE", "Percent exceeds 100");
+	return units;
+}
+function validateTaxCode(code, rates) {
+	if (!code || typeof code !== "object") validationError("INVALID_MONEY_INPUT", "Tax code must be an object");
+	assertIdentifier(code.id, "Tax code ID");
+	if (code.kind !== "taxable" && code.kind !== "zero-rated" && code.kind !== "exempt" && code.kind !== "out-of-scope") validationError("TAX_CODE_KIND", "Unknown tax code kind");
+	if (!Array.isArray(code.components)) validationError("INVALID_MONEY_INPUT", "Tax code components must be an array");
+	if (code.kind === "taxable" && code.components.length === 0) validationError("TAX_CODE_TAXABLE_EMPTY", "Taxable codes require at least one component");
+	if (code.kind !== "taxable" && code.components.length !== 0) validationError("TAX_CODE_NON_TAXABLE_COMPONENTS", "Non-taxable codes cannot contain components");
+	const seen = /* @__PURE__ */ new Set();
+	return code.components.map((component) => {
+		if (!component || typeof component !== "object") validationError("INVALID_MONEY_INPUT", "Tax component must be an object");
+		assertIdentifier(component.taxComponentId, "Tax component ID");
+		if (seen.has(component.taxComponentId)) validationError("TAX_CODE_DUPLICATE_COMPONENT", "Duplicate tax component within code");
+		seen.add(component.taxComponentId);
+		if (typeof component.compound !== "boolean") validationError("INVALID_MONEY_INPUT", "Tax component compound must be boolean");
+		if (component.compound) validationError("COMPOUND_UNSUPPORTED", "Compound tax components are not supported");
+		const rate = percentUnits(component.percent);
+		const existing = rates.get(component.taxComponentId);
+		if (existing !== void 0 && existing !== rate) validationError("TAX_COMPONENT_RATE_CONFLICT", "Shared tax component has conflicting percentages");
+		rates.set(component.taxComponentId, rate);
+		return {
+			taxComponentId: component.taxComponentId,
+			rate
+		};
+	});
+}
+function discountFor(gross, discount) {
+	if (!discount || typeof discount !== "object") validationError("INVALID_MONEY_INPUT", "Discount must be a tagged object");
+	const runtime = discount;
+	if (runtime.rate !== void 0 && runtime.minor !== void 0) validationError("DISCOUNT_BOTH_FORMS", "A discount cannot include both percent and amount forms");
+	let result;
+	if (discount.kind === "none") {
+		if (runtime.rate !== void 0 || runtime.minor !== void 0) validationError("DISCOUNT_BOTH_FORMS", "A none discount cannot include percent or amount values");
+		result = 0n;
+	} else if (discount.kind === "percent") result = roundSignedRational(gross * percentUnits(discount.rate), PERCENT_DENOMINATOR);
+	else if (discount.kind === "amount") result = money(discount.minor);
+	else validationError("INVALID_MONEY_INPUT", "Unknown discount kind");
+	if (result !== 0n && gross !== 0n && result < 0n !== gross < 0n) validationError("DISCOUNT_SIGN", "Discount amount must carry the sign of gross");
+	if (gross === 0n && result !== 0n) validationError("DISCOUNT_SIGN", "A zero gross cannot carry a discount");
+	const magnitude = (value) => value < 0n ? -value : value;
+	if (magnitude(result) > magnitude(gross)) validationError("DISCOUNT_EXCEEDS_GROSS", "Discount cannot exceed gross");
+	return result;
+}
+function validateDocumentInput(input) {
+	if (!input || typeof input !== "object") validationError("INVALID_MONEY_INPUT", "Money input must be an object");
+	if (typeof input.currency !== "string" || !/^[A-Z]{3}$/.test(input.currency) || !ISO_4217_MINOR_UNITS.has(input.currency) || ISO_4217_MINOR_UNITS.get(input.currency) === null) validationError("CURRENCY_MISMATCH", "Currency must be a supported uppercase ISO 4217 code with minor units");
+	if (input.lineAmountType !== "exclusive" && input.lineAmountType !== "inclusive" && input.lineAmountType !== "none") validationError("INVALID_MONEY_INPUT", "Unknown line amount type");
+	if (input.roundingScope !== "line" && input.roundingScope !== "document") validationError("INVALID_MONEY_INPUT", "Unknown tax rounding scope");
+	if (!Array.isArray(input.lines)) validationError("INVALID_MONEY_INPUT", "Lines must be an array");
+}
+function calculateMoneyDocument(input) {
+	validateDocumentInput(input);
+	const ids = /* @__PURE__ */ new Set();
+	const rates = /* @__PURE__ */ new Map();
+	const working = input.lines.map((line) => {
+		if (!line || typeof line !== "object") validationError("INVALID_MONEY_INPUT", "Money line must be an object");
+		assertIdentifier(line.id, "Line ID");
+		if (ids.has(line.id)) validationError("INVALID_MONEY_INPUT", "Duplicate money line ID");
+		ids.add(line.id);
+		const explicitNet = line.netAmountMinor === void 0 ? null : money(line.netAmountMinor);
+		const quantity = numberDecimal(line.quantity, 6);
+		const gross = explicitNet ?? roundSignedRational(quantity.coefficient * money(line.unitPrice), quantity.scale);
+		safeMoney(gross);
+		const discount = explicitNet === null ? discountFor(gross, line.discount) : 0n;
+		const amount = gross - discount;
+		safeMoney(amount);
+		if (input.lineAmountType === "none" && !line.taxCode) validationError("TAX_CODE_NOT_FOUND", "None pricing requires an out-of-scope tax code");
+		if (input.lineAmountType === "none" && line.taxCode?.kind !== "out-of-scope") validationError("TAX_CODE_KIND", "None pricing requires an out-of-scope tax code");
+		const components = line.taxCode ? validateTaxCode(line.taxCode, rates) : [];
+		const totalRate = components.reduce((sum, component) => sum + component.rate, 0n);
+		const denominator = explicitNet === null && input.lineAmountType === "inclusive" ? PERCENT_DENOMINATOR + totalRate : PERCENT_DENOMINATOR;
+		return {
+			input: line,
+			gross,
+			discount,
+			amount,
+			explicitNet,
+			exact: input.lineAmountType === "none" ? [] : components.map((component) => ({
+				taxComponentId: component.taxComponentId,
+				numerator: amount * component.rate,
+				denominator
+			})),
+			taxes: /* @__PURE__ */ new Map()
+		};
+	});
+	if (input.roundingScope === "line") for (const line of working) for (const component of line.exact) line.taxes.set(component.taxComponentId, roundSignedRational(component.numerator, component.denominator));
+	else for (const componentId of [...rates.keys()].sort()) {
+		const eligible = working.flatMap((line) => {
+			const exact = line.exact.find((component) => component.taxComponentId === componentId);
+			return exact ? [{
+				line,
+				exact
+			}] : [];
+		});
+		const allocated = allocateSignedRationals(eligible.map(({ line, exact }) => ({
+			id: line.input.id,
+			numerator: exact.numerator,
+			denominator: exact.denominator
+		})));
+		for (const allocation of allocated.allocations) eligible.find(({ line }) => line.input.id === allocation.id)?.line.taxes.set(componentId, allocation.value);
+	}
+	const lines = working.map((line) => {
+		const components = line.exact.map((component) => ({
+			taxComponentId: component.taxComponentId,
+			taxMinor: safeMoney(line.taxes.get(component.taxComponentId) ?? 0n)
+		}));
+		const tax2 = components.reduce((sum, component) => sum + BigInt(component.taxMinor), 0n);
+		const net = line.explicitNet ?? (input.lineAmountType === "inclusive" ? line.amount - tax2 : line.amount);
+		const amount = line.explicitNet !== null && input.lineAmountType === "inclusive" ? net + tax2 : line.amount;
+		return {
+			id: line.input.id,
+			grossMinor: safeMoney(line.gross),
+			discountMinor: safeMoney(line.discount),
+			amountMinor: safeMoney(amount),
+			components,
+			taxMinor: safeMoney(tax2),
+			netMinor: safeMoney(net)
+		};
+	});
+	const taxRows = /* @__PURE__ */ new Map();
+	for (let index = 0; index < working.length; index++) {
+		const source = working[index].input;
+		const result = lines[index];
+		if (!source.taxCode || source.taxCode.components.length === 0 || input.lineAmountType === "none") {
+			const key = `${source.taxCode?.id ?? ""}\0`;
+			const row = taxRows.get(key) ?? {
+				taxCodeId: source.taxCode?.id ?? null,
+				taxComponentId: null,
+				taxableMinor: 0,
+				taxMinor: 0
+			};
+			row.taxableMinor = safeMoney(BigInt(row.taxableMinor) + BigInt(result.netMinor));
+			taxRows.set(key, row);
+			continue;
+		}
+		for (const component of result.components) {
+			if (!source.taxCode) validationError("INVALID_MONEY_INPUT", "Tax component requires a tax code");
+			const key = `${source.taxCode.id}\0${component.taxComponentId}`;
+			const row = taxRows.get(key) ?? {
+				taxCodeId: source.taxCode.id,
+				taxComponentId: component.taxComponentId,
+				taxableMinor: 0,
+				taxMinor: 0
+			};
+			row.taxableMinor = safeMoney(BigInt(row.taxableMinor) + BigInt(result.netMinor));
+			row.taxMinor = safeMoney(BigInt(row.taxMinor) + BigInt(component.taxMinor));
+			taxRows.set(key, row);
+		}
+	}
+	const taxes = [...taxRows.values()].sort((left, right) => {
+		const leftCode = left.taxCodeId ?? "";
+		const rightCode = right.taxCodeId ?? "";
+		if (leftCode !== rightCode) return leftCode < rightCode ? -1 : 1;
+		const leftComponent = left.taxComponentId ?? "";
+		const rightComponent = right.taxComponentId ?? "";
+		return leftComponent < rightComponent ? -1 : leftComponent > rightComponent ? 1 : 0;
+	});
+	const subtotal = lines.reduce((sum, line) => sum + BigInt(line.netMinor), 0n);
+	const discountTotal = lines.reduce((sum, line) => sum + BigInt(line.discountMinor), 0n);
+	const tax = lines.reduce((sum, line) => sum + BigInt(line.taxMinor), 0n);
+	return {
+		lines,
+		subtotalMinor: safeMoney(subtotal),
+		discountTotalMinor: safeMoney(discountTotal),
+		taxMinor: safeMoney(tax),
+		totalMinor: safeMoney(subtotal + tax),
+		taxes
+	};
+}
+function selectedCode(id, source, context) {
+	if (!id) return null;
+	const taxCode = context.codes[id];
+	if (!taxCode) validationError("TAX_CODE_NOT_FOUND", `Unknown tax code: ${id}`);
+	if (typeof taxCode.active !== "boolean") validationError("INVALID_MONEY_INPUT", `Tax code ${id} has invalid state`);
+	if (!taxCode.active) validationError("TAX_CODE_INACTIVE", `Tax code ${id} is inactive`);
+	if (taxCode.appliesTo !== "sales" && taxCode.appliesTo !== "purchases" && taxCode.appliesTo !== "both") validationError("INVALID_MONEY_INPUT", `Tax code ${id} has invalid applicability`);
+	if (taxCode.appliesTo !== "both" && taxCode.appliesTo !== context.direction) validationError("TAX_CODE_SCOPE", `Tax code ${id} does not apply to ${context.direction}`);
+	return {
+		taxCode,
+		source
+	};
+}
+function resolveLineTaxCode(line, context) {
+	if (!line || typeof line !== "object" || !context || typeof context !== "object") validationError("INVALID_MONEY_INPUT", "Tax-code resolution inputs must be objects");
+	if (!context.codes || typeof context.codes !== "object") validationError("INVALID_MONEY_INPUT", "Tax-code map must be an object");
+	if (line.lineAmountType !== "exclusive" && line.lineAmountType !== "inclusive" && line.lineAmountType !== "none") validationError("INVALID_MONEY_INPUT", "Unknown line amount type");
+	if (context.direction !== "sales" && context.direction !== "purchases") validationError("INVALID_MONEY_INPUT", "Unknown tax-code direction");
+	if (line.lineAmountType === "none") {
+		if (!context.outOfScopeCodeId) validationError("TAX_CODE_NOT_FOUND", "None mode requires an out-of-scope tax code");
+		const resolved = selectedCode(context.outOfScopeCodeId, "none", context);
+		if (resolved?.taxCode?.kind !== "out-of-scope") validationError("TAX_CODE_KIND", "None mode requires an out-of-scope tax code");
+		return resolved;
+	}
+	if (context.customerTaxExempt && !line.lineOverride) {
+		if (!context.exemptCodeId) validationError("TAX_CODE_NOT_FOUND", "An exempt customer requires an exempt tax code");
+		const exempt = selectedCode(context.exemptCodeId, "exempt-customer", context);
+		if (exempt?.taxCode?.kind !== "exempt") validationError("TAX_CODE_KIND", "Customer exemption requires an exempt tax code");
+		return exempt;
+	}
+	const candidates = [
+		[line.lineOverride, "line"],
+		[context.productCodeId, "product"],
+		[context.partyCodeId, "customer"],
+		[context.appDefaultCodeId, "app"]
+	];
+	for (const [id, source] of candidates) {
+		const resolved = selectedCode(id, source, context);
+		if (resolved) return resolved;
+	}
+	return {
+		taxCode: null,
+		source: "none"
+	};
+}
+//#endregion
+export { MoneyValidationError, assertIntegerMinorUnits, calculateMoneyDocument, resolveLineTaxCode };
+
+//# sourceMappingURL=money.js.map

package/dist/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","names":["tax"],"sources":["../src/money.ts"],"sourcesContent":["/** Exact, transport-neutral commercial document money calculation. */\n\nimport { ISO_4217_MINOR_UNITS } from '@happyvertical/smrt-ui/currency';\nimport {\n  allocateSignedRationals,\n  roundSignedRational,\n} from './money-rational.js';\n\n/** Throw unless every named model value is a finite integer minor-unit amount. */\nexport function assertIntegerMinorUnits(\n  context: string,\n  label: string,\n  entries: ReadonlyArray<readonly [string, number]>,\n): void {\n  for (const [field, value] of entries) {\n    if (!Number.isFinite(value) || !Number.isInteger(value)) {\n      throw new Error(\n        `${context} ${label}: ${field} must be an integer number of minor ` +\n          `units (cents, satoshis) — got ${value}. Money is exact: $19.99 is ` +\n          '1999, not 19.99.',\n      );\n    }\n  }\n}\n\nexport type LineAmountType = 'exclusive' | 'inclusive' | 'none';\nexport type TaxRoundingScope = 'line' | 'document';\nexport type TaxCodeKind = 'taxable' | 'zero-rated' | 'exempt' | 'out-of-scope';\nexport type TaxCodeAppliesTo = 'sales' | 'purchases' | 'both';\n\nexport type MoneyValidationCode =\n  | 'DISCOUNT_BOTH_FORMS'\n  | 'DISCOUNT_EXCEEDS_GROSS'\n  | 'DISCOUNT_SIGN'\n  | 'PERCENT_OUT_OF_RANGE'\n  | 'COMPOUND_UNSUPPORTED'\n  | 'INVALID_MONEY_INPUT'\n  | 'TAX_CODE_DUPLICATE_COMPONENT'\n  | 'TAX_CODE_KIND'\n  | 'TAX_CODE_NON_TAXABLE_COMPONENTS'\n  | 'TAX_CODE_NOT_FOUND'\n  | 'TAX_CODE_TAXABLE_EMPTY'\n  | 'TAX_COMPONENT_RATE_CONFLICT'\n  | 'TAX_CODE_INACTIVE'\n  | 'TAX_CODE_SCOPE'\n  | 'UNSAFE_MONEY'\n  | 'FROZEN_DOCUMENT'\n  | 'CURRENCY_MISMATCH'\n  | 'ACCOUNTING_SYNC_IN_PROGRESS'\n  | 'ACCOUNTING_SYNC_RECONCILIATION_REQUIRED'\n  | 'ACCOUNTING_SYNC_UNSUPPORTED'\n  | 'CREDIT_EXCEEDS_LINE'\n  | 'CREDIT_TARGET_NOT_ISSUED';\n\n/** Stable validation error shared by model, editor, and transport adapters. */\nexport class MoneyValidationError extends Error {\n  override readonly name = 'MoneyValidationError';\n  /** Explicit marker consumed by public transports that preserve typed errors. */\n  readonly publicMessage: string;\n\n  constructor(\n    readonly code: MoneyValidationCode,\n    message: string,\n  ) {\n    super(message);\n    this.publicMessage = message;\n  }\n}\n\nexport interface TaxComponentInput {\n  taxComponentId: string;\n  /** Exact percent: \"7\" means 7%; at most six fractional digits. */\n  percent: string;\n  compound: boolean;\n}\n\nexport interface MoneyTaxCodeInput {\n  id: string;\n  kind: TaxCodeKind;\n  components: readonly TaxComponentInput[];\n}\n\nexport interface ResolvableTaxCodeInput extends MoneyTaxCodeInput {\n  active: boolean;\n  appliesTo: TaxCodeAppliesTo;\n}\n\nexport type MoneyDiscountInput =\n  | { kind: 'none' }\n  | { kind: 'percent'; rate: string }\n  | { kind: 'amount'; minor: number };\n\nexport interface MoneyLineInput {\n  id: string;\n  /** Nonnegative decimal quantity with at most six fractional digits. */\n  quantity: number;\n  /** Signed safe integer minor units. */\n  unitPrice: number;\n  discount: MoneyDiscountInput;\n  /** Explicit tax-exclusive basis for credit-note amount allocations. */\n  netAmountMinor?: number;\n  /** Null means no code resolved; `none` pricing requires an out-of-scope code. */\n  taxCode: MoneyTaxCodeInput | null;\n}\n\nexport interface MoneyLineResult {\n  id: string;\n  grossMinor: number;\n  discountMinor: number;\n  amountMinor: number;\n  components: { taxComponentId: string; taxMinor: number }[];\n  taxMinor: number;\n  netMinor: number;\n}\n\nexport interface MoneyDocumentTaxResult {\n  /** Null records an unassigned line without inventing a persisted tax-code ID. */\n  taxCodeId: string | null;\n  taxComponentId: string | null;\n  taxableMinor: number;\n  taxMinor: number;\n}\n\nexport interface MoneyDocumentResult {\n  lines: MoneyLineResult[];\n  subtotalMinor: number;\n  discountTotalMinor: number;\n  taxMinor: number;\n  totalMinor: number;\n  taxes: MoneyDocumentTaxResult[];\n}\n\nexport type TaxCodeResolutionSource =\n  | 'line'\n  | 'exempt-customer'\n  | 'product'\n  | 'customer'\n  | 'app'\n  | 'none';\n\nexport interface ResolveLineTaxCodeInput {\n  lineAmountType: LineAmountType;\n  lineOverride?: string | null;\n}\n\nexport interface ResolveLineTaxCodeContext {\n  direction: 'sales' | 'purchases';\n  codes: Readonly<Record<string, ResolvableTaxCodeInput>>;\n  customerTaxExempt: boolean;\n  exemptCodeId?: string | null;\n  productCodeId?: string | null;\n  partyCodeId?: string | null;\n  appDefaultCodeId?: string | null;\n  outOfScopeCodeId?: string | null;\n}\n\nexport interface ResolvedLineTaxCode {\n  taxCode: ResolvableTaxCodeInput | null;\n  source: TaxCodeResolutionSource;\n}\n\nconst PERCENT_SCALE = 1_000_000n;\nconst PERCENT_DENOMINATOR = 100n * PERCENT_SCALE;\nconst MAX_SAFE_MONEY = BigInt(Number.MAX_SAFE_INTEGER);\nconst IDENTIFIER = /^\\S(?:.*\\S)?$/;\n\nfunction validationError(code: MoneyValidationCode, message: string): never {\n  throw new MoneyValidationError(code, message);\n}\n\nfunction assertIdentifier(value: string, label: string): void {\n  if (typeof value !== 'string' || !IDENTIFIER.test(value))\n    validationError(\n      'INVALID_MONEY_INPUT',\n      `${label} must be a nonempty string`,\n    );\n}\n\nfunction safeMoney(value: bigint): number {\n  if (value > MAX_SAFE_MONEY || value < -MAX_SAFE_MONEY)\n    validationError('UNSAFE_MONEY', 'Money exceeds safe integer minor units');\n  return Number(value);\n}\n\nfunction money(value: number): bigint {\n  if (!Number.isSafeInteger(value))\n    validationError('UNSAFE_MONEY', 'Money must be safe integer minor units');\n  return BigInt(value);\n}\n\ninterface ExactDecimal {\n  coefficient: bigint;\n  scale: bigint;\n}\n\nfunction numberDecimal(value: number, precision: number): ExactDecimal {\n  if (!Number.isFinite(value) || value < 0 || value > Number.MAX_SAFE_INTEGER)\n    validationError(\n      'INVALID_MONEY_INPUT',\n      'Quantity is outside the supported range',\n    );\n  const [mantissa, exponentText = '0'] = value.toString().split('e');\n  const [whole, fraction = ''] = mantissa.split('.');\n  const places = fraction.length - Number(exponentText);\n  if (places > precision)\n    validationError(\n      'INVALID_MONEY_INPUT',\n      'Quantity exceeds the supported decimal precision',\n    );\n  const coefficient = BigInt(whole + fraction);\n  return places < 0\n    ? { coefficient: coefficient * 10n ** BigInt(-places), scale: 1n }\n    : { coefficient, scale: 10n ** BigInt(places) };\n}\n\nfunction percentUnits(value: string): bigint {\n  if (\n    typeof value !== 'string' ||\n    !/^(?:0|[1-9]\\d{0,2})(?:\\.\\d{1,6})?$/.test(value)\n  )\n    validationError(\n      'PERCENT_OUT_OF_RANGE',\n      'Percent must be an exact decimal from 0 through 100 with at most six fractional digits',\n    );\n  const [whole, fraction = ''] = value.split('.');\n  const units = BigInt(whole) * PERCENT_SCALE + BigInt(fraction.padEnd(6, '0'));\n  if (units > PERCENT_DENOMINATOR)\n    validationError('PERCENT_OUT_OF_RANGE', 'Percent exceeds 100');\n  return units;\n}\n\nfunction validateTaxCode(\n  code: MoneyTaxCodeInput,\n  rates: Map<string, bigint>,\n): { taxComponentId: string; rate: bigint }[] {\n  if (!code || typeof code !== 'object')\n    validationError('INVALID_MONEY_INPUT', 'Tax code must be an object');\n  assertIdentifier(code.id, 'Tax code ID');\n  if (\n    code.kind !== 'taxable' &&\n    code.kind !== 'zero-rated' &&\n    code.kind !== 'exempt' &&\n    code.kind !== 'out-of-scope'\n  )\n    validationError('TAX_CODE_KIND', 'Unknown tax code kind');\n  if (!Array.isArray(code.components))\n    validationError(\n      'INVALID_MONEY_INPUT',\n      'Tax code components must be an array',\n    );\n  if (code.kind === 'taxable' && code.components.length === 0)\n    validationError(\n      'TAX_CODE_TAXABLE_EMPTY',\n      'Taxable codes require at least one component',\n    );\n  if (code.kind !== 'taxable' && code.components.length !== 0)\n    validationError(\n      'TAX_CODE_NON_TAXABLE_COMPONENTS',\n      'Non-taxable codes cannot contain components',\n    );\n  const seen = new Set<string>();\n  return code.components.map((component) => {\n    if (!component || typeof component !== 'object')\n      validationError('INVALID_MONEY_INPUT', 'Tax component must be an object');\n    assertIdentifier(component.taxComponentId, 'Tax component ID');\n    if (seen.has(component.taxComponentId))\n      validationError(\n        'TAX_CODE_DUPLICATE_COMPONENT',\n        'Duplicate tax component within code',\n      );\n    seen.add(component.taxComponentId);\n    if (typeof component.compound !== 'boolean')\n      validationError(\n        'INVALID_MONEY_INPUT',\n        'Tax component compound must be boolean',\n      );\n    if (component.compound)\n      validationError(\n        'COMPOUND_UNSUPPORTED',\n        'Compound tax components are not supported',\n      );\n    const rate = percentUnits(component.percent);\n    const existing = rates.get(component.taxComponentId);\n    if (existing !== undefined && existing !== rate)\n      validationError(\n        'TAX_COMPONENT_RATE_CONFLICT',\n        'Shared tax component has conflicting percentages',\n      );\n    rates.set(component.taxComponentId, rate);\n    return { taxComponentId: component.taxComponentId, rate };\n  });\n}\n\nfunction discountFor(gross: bigint, discount: MoneyDiscountInput): bigint {\n  if (!discount || typeof discount !== 'object')\n    validationError('INVALID_MONEY_INPUT', 'Discount must be a tagged object');\n  const runtime = discount as MoneyDiscountInput & {\n    rate?: unknown;\n    minor?: unknown;\n  };\n  if (runtime.rate !== undefined && runtime.minor !== undefined)\n    validationError(\n      'DISCOUNT_BOTH_FORMS',\n      'A discount cannot include both percent and amount forms',\n    );\n  let result: bigint;\n  if (discount.kind === 'none') {\n    if (runtime.rate !== undefined || runtime.minor !== undefined)\n      validationError(\n        'DISCOUNT_BOTH_FORMS',\n        'A none discount cannot include percent or amount values',\n      );\n    result = 0n;\n  } else if (discount.kind === 'percent') {\n    result = roundSignedRational(\n      gross * percentUnits(discount.rate),\n      PERCENT_DENOMINATOR,\n    );\n  } else if (discount.kind === 'amount') {\n    result = money(discount.minor);\n  } else {\n    validationError('INVALID_MONEY_INPUT', 'Unknown discount kind');\n  }\n  if (result !== 0n && gross !== 0n && result < 0n !== gross < 0n)\n    validationError(\n      'DISCOUNT_SIGN',\n      'Discount amount must carry the sign of gross',\n    );\n  if (gross === 0n && result !== 0n)\n    validationError('DISCOUNT_SIGN', 'A zero gross cannot carry a discount');\n  const magnitude = (value: bigint) => (value < 0n ? -value : value);\n  if (magnitude(result) > magnitude(gross))\n    validationError('DISCOUNT_EXCEEDS_GROSS', 'Discount cannot exceed gross');\n  return result;\n}\n\nfunction validateDocumentInput(input: {\n  currency: string;\n  lineAmountType: LineAmountType;\n  roundingScope: TaxRoundingScope;\n  lines: readonly MoneyLineInput[];\n}): void {\n  if (!input || typeof input !== 'object')\n    validationError('INVALID_MONEY_INPUT', 'Money input must be an object');\n  if (\n    typeof input.currency !== 'string' ||\n    !/^[A-Z]{3}$/.test(input.currency) ||\n    !ISO_4217_MINOR_UNITS.has(input.currency) ||\n    ISO_4217_MINOR_UNITS.get(input.currency) === null\n  )\n    validationError(\n      'CURRENCY_MISMATCH',\n      'Currency must be a supported uppercase ISO 4217 code with minor units',\n    );\n  if (\n    input.lineAmountType !== 'exclusive' &&\n    input.lineAmountType !== 'inclusive' &&\n    input.lineAmountType !== 'none'\n  )\n    validationError('INVALID_MONEY_INPUT', 'Unknown line amount type');\n  if (input.roundingScope !== 'line' && input.roundingScope !== 'document')\n    validationError('INVALID_MONEY_INPUT', 'Unknown tax rounding scope');\n  if (!Array.isArray(input.lines))\n    validationError('INVALID_MONEY_INPUT', 'Lines must be an array');\n}\n\n/** Calculate exact line amounts, per-component tax, and document totals. */\nexport function calculateMoneyDocument(input: {\n  currency: string;\n  lineAmountType: LineAmountType;\n  roundingScope: TaxRoundingScope;\n  lines: readonly MoneyLineInput[];\n}): MoneyDocumentResult {\n  validateDocumentInput(input);\n  const ids = new Set<string>();\n  const rates = new Map<string, bigint>();\n  const working = input.lines.map((line) => {\n    if (!line || typeof line !== 'object')\n      validationError('INVALID_MONEY_INPUT', 'Money line must be an object');\n    assertIdentifier(line.id, 'Line ID');\n    if (ids.has(line.id))\n      validationError('INVALID_MONEY_INPUT', 'Duplicate money line ID');\n    ids.add(line.id);\n    const explicitNet =\n      line.netAmountMinor === undefined ? null : money(line.netAmountMinor);\n    const quantity = numberDecimal(line.quantity, 6);\n    const gross =\n      explicitNet ??\n      roundSignedRational(\n        quantity.coefficient * money(line.unitPrice),\n        quantity.scale,\n      );\n    safeMoney(gross);\n    const discount =\n      explicitNet === null ? discountFor(gross, line.discount) : 0n;\n    const amount = gross - discount;\n    safeMoney(amount);\n    if (input.lineAmountType === 'none' && !line.taxCode)\n      validationError(\n        'TAX_CODE_NOT_FOUND',\n        'None pricing requires an out-of-scope tax code',\n      );\n    if (\n      input.lineAmountType === 'none' &&\n      line.taxCode?.kind !== 'out-of-scope'\n    )\n      validationError(\n        'TAX_CODE_KIND',\n        'None pricing requires an out-of-scope tax code',\n      );\n    const components = line.taxCode ? validateTaxCode(line.taxCode, rates) : [];\n    const totalRate = components.reduce(\n      (sum, component) => sum + component.rate,\n      0n,\n    );\n    const denominator =\n      explicitNet === null && input.lineAmountType === 'inclusive'\n        ? PERCENT_DENOMINATOR + totalRate\n        : PERCENT_DENOMINATOR;\n    return {\n      input: line,\n      gross,\n      discount,\n      amount,\n      explicitNet,\n      exact:\n        input.lineAmountType === 'none'\n          ? []\n          : components.map((component) => ({\n              taxComponentId: component.taxComponentId,\n              numerator: amount * component.rate,\n              denominator,\n            })),\n      taxes: new Map<string, bigint>(),\n    };\n  });\n\n  if (input.roundingScope === 'line') {\n    for (const line of working)\n      for (const component of line.exact)\n        line.taxes.set(\n          component.taxComponentId,\n          roundSignedRational(component.numerator, component.denominator),\n        );\n  } else {\n    for (const componentId of [...rates.keys()].sort()) {\n      const eligible = working.flatMap((line) => {\n        const exact = line.exact.find(\n          (component) => component.taxComponentId === componentId,\n        );\n        return exact ? [{ line, exact }] : [];\n      });\n      const allocated = allocateSignedRationals(\n        eligible.map(({ line, exact }) => ({\n          id: line.input.id,\n          numerator: exact.numerator,\n          denominator: exact.denominator,\n        })),\n      );\n      for (const allocation of allocated.allocations)\n        eligible\n          .find(({ line }) => line.input.id === allocation.id)\n          ?.line.taxes.set(componentId, allocation.value);\n    }\n  }\n\n  const lines = working.map((line): MoneyLineResult => {\n    const components = line.exact.map((component) => ({\n      taxComponentId: component.taxComponentId,\n      taxMinor: safeMoney(line.taxes.get(component.taxComponentId) ?? 0n),\n    }));\n    const tax = components.reduce(\n      (sum, component) => sum + BigInt(component.taxMinor),\n      0n,\n    );\n    const net =\n      line.explicitNet ??\n      (input.lineAmountType === 'inclusive' ? line.amount - tax : line.amount);\n    const amount =\n      line.explicitNet !== null && input.lineAmountType === 'inclusive'\n        ? net + tax\n        : line.amount;\n    return {\n      id: line.input.id,\n      grossMinor: safeMoney(line.gross),\n      discountMinor: safeMoney(line.discount),\n      amountMinor: safeMoney(amount),\n      components,\n      taxMinor: safeMoney(tax),\n      netMinor: safeMoney(net),\n    };\n  });\n\n  const taxRows = new Map<string, MoneyDocumentTaxResult>();\n  for (let index = 0; index < working.length; index++) {\n    const source = working[index].input;\n    const result = lines[index];\n    if (\n      !source.taxCode ||\n      source.taxCode.components.length === 0 ||\n      input.lineAmountType === 'none'\n    ) {\n      const key = `${source.taxCode?.id ?? ''}\\u0000`;\n      const row = taxRows.get(key) ?? {\n        taxCodeId: source.taxCode?.id ?? null,\n        taxComponentId: null,\n        taxableMinor: 0,\n        taxMinor: 0,\n      };\n      row.taxableMinor = safeMoney(\n        BigInt(row.taxableMinor) + BigInt(result.netMinor),\n      );\n      taxRows.set(key, row);\n      continue;\n    }\n    for (const component of result.components) {\n      if (!source.taxCode)\n        validationError(\n          'INVALID_MONEY_INPUT',\n          'Tax component requires a tax code',\n        );\n      const key = `${source.taxCode.id}\\u0000${component.taxComponentId}`;\n      const row = taxRows.get(key) ?? {\n        taxCodeId: source.taxCode.id,\n        taxComponentId: component.taxComponentId,\n        taxableMinor: 0,\n        taxMinor: 0,\n      };\n      row.taxableMinor = safeMoney(\n        BigInt(row.taxableMinor) + BigInt(result.netMinor),\n      );\n      row.taxMinor = safeMoney(\n        BigInt(row.taxMinor) + BigInt(component.taxMinor),\n      );\n      taxRows.set(key, row);\n    }\n  }\n  const taxes = [...taxRows.values()].sort((left, right) => {\n    const leftCode = left.taxCodeId ?? '';\n    const rightCode = right.taxCodeId ?? '';\n    if (leftCode !== rightCode) return leftCode < rightCode ? -1 : 1;\n    const leftComponent = left.taxComponentId ?? '';\n    const rightComponent = right.taxComponentId ?? '';\n    return leftComponent < rightComponent\n      ? -1\n      : leftComponent > rightComponent\n        ? 1\n        : 0;\n  });\n  const subtotal = lines.reduce((sum, line) => sum + BigInt(line.netMinor), 0n);\n  const discountTotal = lines.reduce(\n    (sum, line) => sum + BigInt(line.discountMinor),\n    0n,\n  );\n  const tax = lines.reduce((sum, line) => sum + BigInt(line.taxMinor), 0n);\n  return {\n    lines,\n    subtotalMinor: safeMoney(subtotal),\n    discountTotalMinor: safeMoney(discountTotal),\n    taxMinor: safeMoney(tax),\n    totalMinor: safeMoney(subtotal + tax),\n    taxes,\n  };\n}\n\nfunction selectedCode(\n  id: string | null | undefined,\n  source: TaxCodeResolutionSource,\n  context: ResolveLineTaxCodeContext,\n): ResolvedLineTaxCode | null {\n  if (!id) return null;\n  const taxCode = context.codes[id];\n  if (!taxCode)\n    validationError('TAX_CODE_NOT_FOUND', `Unknown tax code: ${id}`);\n  if (typeof taxCode.active !== 'boolean')\n    validationError('INVALID_MONEY_INPUT', `Tax code ${id} has invalid state`);\n  if (!taxCode.active)\n    validationError('TAX_CODE_INACTIVE', `Tax code ${id} is inactive`);\n  if (\n    taxCode.appliesTo !== 'sales' &&\n    taxCode.appliesTo !== 'purchases' &&\n    taxCode.appliesTo !== 'both'\n  )\n    validationError(\n      'INVALID_MONEY_INPUT',\n      `Tax code ${id} has invalid applicability`,\n    );\n  if (taxCode.appliesTo !== 'both' && taxCode.appliesTo !== context.direction)\n    validationError(\n      'TAX_CODE_SCOPE',\n      `Tax code ${id} does not apply to ${context.direction}`,\n    );\n  return { taxCode, source };\n}\n\n/** Resolve a line tax code from already-loaded values, without model or I/O access. */\nexport function resolveLineTaxCode(\n  line: ResolveLineTaxCodeInput,\n  context: ResolveLineTaxCodeContext,\n): ResolvedLineTaxCode {\n  if (\n    !line ||\n    typeof line !== 'object' ||\n    !context ||\n    typeof context !== 'object'\n  )\n    validationError(\n      'INVALID_MONEY_INPUT',\n      'Tax-code resolution inputs must be objects',\n    );\n  if (!context.codes || typeof context.codes !== 'object')\n    validationError('INVALID_MONEY_INPUT', 'Tax-code map must be an object');\n  if (\n    line.lineAmountType !== 'exclusive' &&\n    line.lineAmountType !== 'inclusive' &&\n    line.lineAmountType !== 'none'\n  )\n    validationError('INVALID_MONEY_INPUT', 'Unknown line amount type');\n  if (context.direction !== 'sales' && context.direction !== 'purchases')\n    validationError('INVALID_MONEY_INPUT', 'Unknown tax-code direction');\n  if (line.lineAmountType === 'none') {\n    if (!context.outOfScopeCodeId)\n      validationError(\n        'TAX_CODE_NOT_FOUND',\n        'None mode requires an out-of-scope tax code',\n      );\n    const resolved = selectedCode(context.outOfScopeCodeId, 'none', context);\n    if (resolved?.taxCode?.kind !== 'out-of-scope')\n      validationError(\n        'TAX_CODE_KIND',\n        'None mode requires an out-of-scope tax code',\n      );\n    return resolved;\n  }\n  if (context.customerTaxExempt && !line.lineOverride) {\n    if (!context.exemptCodeId)\n      validationError(\n        'TAX_CODE_NOT_FOUND',\n        'An exempt customer requires an exempt tax code',\n      );\n    const exempt = selectedCode(\n      context.exemptCodeId,\n      'exempt-customer',\n      context,\n    );\n    if (exempt?.taxCode?.kind !== 'exempt')\n      validationError(\n        'TAX_CODE_KIND',\n        'Customer exemption requires an exempt tax code',\n      );\n    return exempt;\n  }\n  const candidates: readonly [\n    string | null | undefined,\n    TaxCodeResolutionSource,\n  ][] = [\n    [line.lineOverride, 'line'],\n    [context.productCodeId, 'product'],\n    [context.partyCodeId, 'customer'],\n    [context.appDefaultCodeId, 'app'],\n  ];\n  for (const [id, source] of candidates) {\n    const resolved = selectedCode(id, source, context);\n    if (resolved) return resolved;\n  }\n  return { taxCode: null, source: 'none' };\n}\n"],"mappings":";;;AASO,SAAS,wBACd,SACA,OACA,SACM;CACN,KAAA,MAAW,CAAC,OAAO,UAAU,SAC3B,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,GACpD,MAAM,IAAI,MACR,GAAG,QAAO,GAAI,MAAK,IAAK,MAAK,yEACM,MAAK,6CAE1C;AAGN;AAgCO,IAAM,uBAAN,cAAmC,MAAM;CAK9C,YACW,MACT,SACA;EACA,MAAM,OAAO;EAHJ,KAAA,OAAA;EAIT,KAAK,gBAAgB;CACvB;CALW;CALO,OAAO;;CAEhB;AASX;AA8FA,IAAM,gBAAgB;AACtB,IAAM,sBAAsB,OAAO;AACnC,IAAM,iBAAiB,OAAO,OAAO,gBAAgB;AACrD,IAAM,aAAa;AAEnB,SAAS,gBAAgB,MAA2B,SAAwB;CAC1E,MAAM,IAAI,qBAAqB,MAAM,OAAO;AAC9C;AAEA,SAAS,iBAAiB,OAAe,OAAqB;CAC5D,IAAI,OAAO,UAAU,YAAY,CAAC,WAAW,KAAK,KAAK,GACrD,gBACE,uBACA,GAAG,MAAK,2BACV;AACJ;AAEA,SAAS,UAAU,OAAuB;CACxC,IAAI,QAAQ,kBAAkB,QAAQ,CAAC,gBACrC,gBAAgB,gBAAgB,wCAAwC;CAC1E,OAAO,OAAO,KAAK;AACrB;AAEA,SAAS,MAAM,OAAuB;CACpC,IAAI,CAAC,OAAO,cAAc,KAAK,GAC7B,gBAAgB,gBAAgB,wCAAwC;CAC1E,OAAO,OAAO,KAAK;AACrB;AAOA,SAAS,cAAc,OAAe,WAAiC;CACrE,IAAI,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,KAAK,QAAQ,OAAO,kBACzD,gBACE,uBACA,yCACF;CACF,MAAM,CAAC,UAAU,eAAe,OAAO,MAAM,SAAS,CAAA,CAAE,MAAM,GAAG;CACjE,MAAM,CAAC,OAAO,WAAW,MAAM,SAAS,MAAM,GAAG;CACjD,MAAM,SAAS,SAAS,SAAS,OAAO,YAAY;CACpD,IAAI,SAAS,WACX,gBACE,uBACA,kDACF;CACF,MAAM,cAAc,OAAO,QAAQ,QAAQ;CAC3C,OAAO,SAAS,IACZ;EAAE,aAAa,cAAc,OAAO,OAAO,CAAC,MAAM;EAAG,OAAO;CAAG,IAC/D;EAAE;EAAa,OAAO,OAAO,OAAO,MAAM;CAAE;AAClD;AAEA,SAAS,aAAa,OAAuB;CAC3C,IACE,OAAO,UAAU,YACjB,CAAC,qCAAqC,KAAK,KAAK,GAEhD,gBACE,wBACA,wFACF;CACF,MAAM,CAAC,OAAO,WAAW,MAAM,MAAM,MAAM,GAAG;CAC9C,MAAM,QAAQ,OAAO,KAAK,IAAI,gBAAgB,OAAO,SAAS,OAAO,GAAG,GAAG,CAAC;CAC5E,IAAI,QAAQ,qBACV,gBAAgB,wBAAwB,qBAAqB;CAC/D,OAAO;AACT;AAEA,SAAS,gBACP,MACA,OAC4C;CAC5C,IAAI,CAAC,QAAQ,OAAO,SAAS,UAC3B,gBAAgB,uBAAuB,4BAA4B;CACrE,iBAAiB,KAAK,IAAI,aAAa;CACvC,IACE,KAAK,SAAS,aACd,KAAK,SAAS,gBACd,KAAK,SAAS,YACd,KAAK,SAAS,gBAEd,gBAAgB,iBAAiB,uBAAuB;CAC1D,IAAI,CAAC,MAAM,QAAQ,KAAK,UAAU,GAChC,gBACE,uBACA,sCACF;CACF,IAAI,KAAK,SAAS,aAAa,KAAK,WAAW,WAAW,GACxD,gBACE,0BACA,8CACF;CACF,IAAI,KAAK,SAAS,aAAa,KAAK,WAAW,WAAW,GACxD,gBACE,mCACA,6CACF;CACF,MAAM,uBAAO,IAAI,IAAY;CAC7B,OAAO,KAAK,WAAW,KAAK,cAAc;EACxC,IAAI,CAAC,aAAa,OAAO,cAAc,UACrC,gBAAgB,uBAAuB,iCAAiC;EAC1E,iBAAiB,UAAU,gBAAgB,kBAAkB;EAC7D,IAAI,KAAK,IAAI,UAAU,cAAc,GACnC,gBACE,gCACA,qCACF;EACF,KAAK,IAAI,UAAU,cAAc;EACjC,IAAI,OAAO,UAAU,aAAa,WAChC,gBACE,uBACA,wCACF;EACF,IAAI,UAAU,UACZ,gBACE,wBACA,2CACF;EACF,MAAM,OAAO,aAAa,UAAU,OAAO;EAC3C,MAAM,WAAW,MAAM,IAAI,UAAU,cAAc;EACnD,IAAI,aAAa,KAAA,KAAa,aAAa,MACzC,gBACE,+BACA,kDACF;EACF,MAAM,IAAI,UAAU,gBAAgB,IAAI;EACxC,OAAO;GAAE,gBAAgB,UAAU;GAAgB;EAAK;CAC1D,CAAC;AACH;AAEA,SAAS,YAAY,OAAe,UAAsC;CACxE,IAAI,CAAC,YAAY,OAAO,aAAa,UACnC,gBAAgB,uBAAuB,kCAAkC;CAC3E,MAAM,UAAU;CAIhB,IAAI,QAAQ,SAAS,KAAA,KAAa,QAAQ,UAAU,KAAA,GAClD,gBACE,uBACA,yDACF;CACF,IAAI;CACJ,IAAI,SAAS,SAAS,QAAQ;EAC5B,IAAI,QAAQ,SAAS,KAAA,KAAa,QAAQ,UAAU,KAAA,GAClD,gBACE,uBACA,yDACF;EACF,SAAS;CACX,OAAA,IAAW,SAAS,SAAS,WAC3B,SAAS,oBACP,QAAQ,aAAa,SAAS,IAAI,GAClC,mBACF;MACF,IAAW,SAAS,SAAS,UAC3B,SAAS,MAAM,SAAS,KAAK;MAE7B,gBAAgB,uBAAuB,uBAAuB;CAEhE,IAAI,WAAW,MAAM,UAAU,MAAM,SAAS,OAAO,QAAQ,IAC3D,gBACE,iBACA,8CACF;CACF,IAAI,UAAU,MAAM,WAAW,IAC7B,gBAAgB,iBAAiB,sCAAsC;CACzE,MAAM,aAAa,UAAmB,QAAQ,KAAK,CAAC,QAAQ;CAC5D,IAAI,UAAU,MAAM,IAAI,UAAU,KAAK,GACrC,gBAAgB,0BAA0B,8BAA8B;CAC1E,OAAO;AACT;AAEA,SAAS,sBAAsB,OAKtB;CACP,IAAI,CAAC,SAAS,OAAO,UAAU,UAC7B,gBAAgB,uBAAuB,+BAA+B;CACxE,IACE,OAAO,MAAM,aAAa,YAC1B,CAAC,aAAa,KAAK,MAAM,QAAQ,KACjC,CAAC,qBAAqB,IAAI,MAAM,QAAQ,KACxC,qBAAqB,IAAI,MAAM,QAAQ,MAAM,MAE7C,gBACE,qBACA,uEACF;CACF,IACE,MAAM,mBAAmB,eACzB,MAAM,mBAAmB,eACzB,MAAM,mBAAmB,QAEzB,gBAAgB,uBAAuB,0BAA0B;CACnE,IAAI,MAAM,kBAAkB,UAAU,MAAM,kBAAkB,YAC5D,gBAAgB,uBAAuB,4BAA4B;CACrE,IAAI,CAAC,MAAM,QAAQ,MAAM,KAAK,GAC5B,gBAAgB,uBAAuB,wBAAwB;AACnE;AAGO,SAAS,uBAAuB,OAKf;CACtB,sBAAsB,KAAK;CAC3B,MAAM,sBAAM,IAAI,IAAY;CAC5B,MAAM,wBAAQ,IAAI,IAAoB;CACtC,MAAM,UAAU,MAAM,MAAM,KAAK,SAAS;EACxC,IAAI,CAAC,QAAQ,OAAO,SAAS,UAC3B,gBAAgB,uBAAuB,8BAA8B;EACvE,iBAAiB,KAAK,IAAI,SAAS;EACnC,IAAI,IAAI,IAAI,KAAK,EAAE,GACjB,gBAAgB,uBAAuB,yBAAyB;EAClE,IAAI,IAAI,KAAK,EAAE;EACf,MAAM,cACJ,KAAK,mBAAmB,KAAA,IAAY,OAAO,MAAM,KAAK,cAAc;EACtE,MAAM,WAAW,cAAc,KAAK,UAAU,CAAC;EAC/C,MAAM,QACJ,eACA,oBACE,SAAS,cAAc,MAAM,KAAK,SAAS,GAC3C,SAAS,KACX;EACF,UAAU,KAAK;EACf,MAAM,WACJ,gBAAgB,OAAO,YAAY,OAAO,KAAK,QAAQ,IAAI;EAC7D,MAAM,SAAS,QAAQ;EACvB,UAAU,MAAM;EAChB,IAAI,MAAM,mBAAmB,UAAU,CAAC,KAAK,SAC3C,gBACE,sBACA,gDACF;EACF,IACE,MAAM,mBAAmB,UACzB,KAAK,SAAS,SAAS,gBAEvB,gBACE,iBACA,gDACF;EACF,MAAM,aAAa,KAAK,UAAU,gBAAgB,KAAK,SAAS,KAAK,IAAI,CAAC;EAC1E,MAAM,YAAY,WAAW,QAC1B,KAAK,cAAc,MAAM,UAAU,MACpC,EACF;EACA,MAAM,cACJ,gBAAgB,QAAQ,MAAM,mBAAmB,cAC7C,sBAAsB,YACtB;EACN,OAAO;GACL,OAAO;GACP;GACA;GACA;GACA;GACA,OACE,MAAM,mBAAmB,SACrB,CAAC,IACD,WAAW,KAAK,eAAe;IAC7B,gBAAgB,UAAU;IAC1B,WAAW,SAAS,UAAU;IAC9B;GACF,EAAE;GACR,uBAAO,IAAI,IAAoB;EACjC;CACF,CAAC;CAED,IAAI,MAAM,kBAAkB,QAC1B,KAAA,MAAW,QAAQ,SACjB,KAAA,MAAW,aAAa,KAAK,OAC3B,KAAK,MAAM,IACT,UAAU,gBACV,oBAAoB,UAAU,WAAW,UAAU,WAAW,CAChE;MAEJ,KAAA,MAAW,eAAe,CAAC,GAAG,MAAM,KAAK,CAAC,CAAA,CAAE,KAAK,GAAG;EAClD,MAAM,WAAW,QAAQ,SAAS,SAAS;GACzC,MAAM,QAAQ,KAAK,MAAM,MACtB,cAAc,UAAU,mBAAmB,WAC9C;GACA,OAAO,QAAQ,CAAC;IAAE;IAAM;GAAM,CAAC,IAAI,CAAC;EACtC,CAAC;EACD,MAAM,YAAY,wBAChB,SAAS,KAAK,EAAE,MAAM,aAAa;GACjC,IAAI,KAAK,MAAM;GACf,WAAW,MAAM;GACjB,aAAa,MAAM;EACrB,EAAE,CACJ;EACA,KAAA,MAAW,cAAc,UAAU,aACjC,SACG,MAAM,EAAE,WAAW,KAAK,MAAM,OAAO,WAAW,EAAE,CAAA,EACjD,KAAK,MAAM,IAAI,aAAa,WAAW,KAAK;CACpD;CAGF,MAAM,QAAQ,QAAQ,KAAK,SAA0B;EACnD,MAAM,aAAa,KAAK,MAAM,KAAK,eAAe;GAChD,gBAAgB,UAAU;GAC1B,UAAU,UAAU,KAAK,MAAM,IAAI,UAAU,cAAc,KAAK,EAAE;EACpE,EAAE;EACF,MAAMA,OAAM,WAAW,QACpB,KAAK,cAAc,MAAM,OAAO,UAAU,QAAQ,GACnD,EACF;EACA,MAAM,MACJ,KAAK,gBACJ,MAAM,mBAAmB,cAAc,KAAK,SAASA,OAAM,KAAK;EACnE,MAAM,SACJ,KAAK,gBAAgB,QAAQ,MAAM,mBAAmB,cAClD,MAAMA,OACN,KAAK;EACX,OAAO;GACL,IAAI,KAAK,MAAM;GACf,YAAY,UAAU,KAAK,KAAK;GAChC,eAAe,UAAU,KAAK,QAAQ;GACtC,aAAa,UAAU,MAAM;GAC7B;GACA,UAAU,UAAUA,IAAG;GACvB,UAAU,UAAU,GAAG;EACzB;CACF,CAAC;CAED,MAAM,0BAAU,IAAI,IAAoC;CACxD,KAAA,IAAS,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS;EACnD,MAAM,SAAS,QAAQ,MAAK,CAAE;EAC9B,MAAM,SAAS,MAAM;EACrB,IACE,CAAC,OAAO,WACR,OAAO,QAAQ,WAAW,WAAW,KACrC,MAAM,mBAAmB,QACzB;GACA,MAAM,MAAM,GAAG,OAAO,SAAS,MAAM,GAAE;GACvC,MAAM,MAAM,QAAQ,IAAI,GAAG,KAAK;IAC9B,WAAW,OAAO,SAAS,MAAM;IACjC,gBAAgB;IAChB,cAAc;IACd,UAAU;GACZ;GACA,IAAI,eAAe,UACjB,OAAO,IAAI,YAAY,IAAI,OAAO,OAAO,QAAQ,CACnD;GACA,QAAQ,IAAI,KAAK,GAAG;GACpB;EACF;EACA,KAAA,MAAW,aAAa,OAAO,YAAY;GACzC,IAAI,CAAC,OAAO,SACV,gBACE,uBACA,mCACF;GACF,MAAM,MAAM,GAAG,OAAO,QAAQ,GAAE,IAAS,UAAU;GACnD,MAAM,MAAM,QAAQ,IAAI,GAAG,KAAK;IAC9B,WAAW,OAAO,QAAQ;IAC1B,gBAAgB,UAAU;IAC1B,cAAc;IACd,UAAU;GACZ;GACA,IAAI,eAAe,UACjB,OAAO,IAAI,YAAY,IAAI,OAAO,OAAO,QAAQ,CACnD;GACA,IAAI,WAAW,UACb,OAAO,IAAI,QAAQ,IAAI,OAAO,UAAU,QAAQ,CAClD;GACA,QAAQ,IAAI,KAAK,GAAG;EACtB;CACF;CACA,MAAM,QAAQ,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAA,CAAE,MAAM,MAAM,UAAU;EACxD,MAAM,WAAW,KAAK,aAAa;EACnC,MAAM,YAAY,MAAM,aAAa;EACrC,IAAI,aAAa,WAAW,OAAO,WAAW,YAAY,KAAK;EAC/D,MAAM,gBAAgB,KAAK,kBAAkB;EAC7C,MAAM,iBAAiB,MAAM,kBAAkB;EAC/C,OAAO,gBAAgB,iBACnB,KACA,gBAAgB,iBACd,IACA;CACR,CAAC;CACD,MAAM,WAAW,MAAM,QAAQ,KAAK,SAAS,MAAM,OAAO,KAAK,QAAQ,GAAG,EAAE;CAC5E,MAAM,gBAAgB,MAAM,QACzB,KAAK,SAAS,MAAM,OAAO,KAAK,aAAa,GAC9C,EACF;CACA,MAAM,MAAM,MAAM,QAAQ,KAAK,SAAS,MAAM,OAAO,KAAK,QAAQ,GAAG,EAAE;CACvE,OAAO;EACL;EACA,eAAe,UAAU,QAAQ;EACjC,oBAAoB,UAAU,aAAa;EAC3C,UAAU,UAAU,GAAG;EACvB,YAAY,UAAU,WAAW,GAAG;EACpC;CACF;AACF;AAEA,SAAS,aACP,IACA,QACA,SAC4B;CAC5B,IAAI,CAAC,IAAI,OAAO;CAChB,MAAM,UAAU,QAAQ,MAAM;CAC9B,IAAI,CAAC,SACH,gBAAgB,sBAAsB,qBAAqB,IAAI;CACjE,IAAI,OAAO,QAAQ,WAAW,WAC5B,gBAAgB,uBAAuB,YAAY,GAAE,mBAAoB;CAC3E,IAAI,CAAC,QAAQ,QACX,gBAAgB,qBAAqB,YAAY,GAAE,aAAc;CACnE,IACE,QAAQ,cAAc,WACtB,QAAQ,cAAc,eACtB,QAAQ,cAAc,QAEtB,gBACE,uBACA,YAAY,GAAE,2BAChB;CACF,IAAI,QAAQ,cAAc,UAAU,QAAQ,cAAc,QAAQ,WAChE,gBACE,kBACA,YAAY,GAAE,qBAAsB,QAAQ,WAC9C;CACF,OAAO;EAAE;EAAS;CAAO;AAC3B;AAGO,SAAS,mBACd,MACA,SACqB;CACrB,IACE,CAAC,QACD,OAAO,SAAS,YAChB,CAAC,WACD,OAAO,YAAY,UAEnB,gBACE,uBACA,4CACF;CACF,IAAI,CAAC,QAAQ,SAAS,OAAO,QAAQ,UAAU,UAC7C,gBAAgB,uBAAuB,gCAAgC;CACzE,IACE,KAAK,mBAAmB,eACxB,KAAK,mBAAmB,eACxB,KAAK,mBAAmB,QAExB,gBAAgB,uBAAuB,0BAA0B;CACnE,IAAI,QAAQ,cAAc,WAAW,QAAQ,cAAc,aACzD,gBAAgB,uBAAuB,4BAA4B;CACrE,IAAI,KAAK,mBAAmB,QAAQ;EAClC,IAAI,CAAC,QAAQ,kBACX,gBACE,sBACA,6CACF;EACF,MAAM,WAAW,aAAa,QAAQ,kBAAkB,QAAQ,OAAO;EACvE,IAAI,UAAU,SAAS,SAAS,gBAC9B,gBACE,iBACA,6CACF;EACF,OAAO;CACT;CACA,IAAI,QAAQ,qBAAqB,CAAC,KAAK,cAAc;EACnD,IAAI,CAAC,QAAQ,cACX,gBACE,sBACA,gDACF;EACF,MAAM,SAAS,aACb,QAAQ,cACR,mBACA,OACF;EACA,IAAI,QAAQ,SAAS,SAAS,UAC5B,gBACE,iBACA,gDACF;EACF,OAAO;CACT;CACA,MAAM,aAGA;EACJ,CAAC,KAAK,cAAc,MAAM;EAC1B,CAAC,QAAQ,eAAe,SAAS;EACjC,CAAC,QAAQ,aAAa,UAAU;EAChC,CAAC,QAAQ,kBAAkB,KAAK;CAClC;CACA,KAAA,MAAW,CAAC,IAAI,WAAW,YAAY;EACrC,MAAM,WAAW,aAAa,IAAI,QAAQ,OAAO;EACjD,IAAI,UAAU,OAAO;CACvB;CACA,OAAO;EAAE,SAAS;EAAM,QAAQ;CAAO;AACzC"}

package/dist/recipes.d.ts

@@ -61,7 +61,7 @@ export declare class PurchasesRecipe extends SmrtRecipe {
         icon: string;
         description: string;
     };
-    static models: (typeof PurchaseOrder | typeof ContractLineItem)[];
+    static models: (typeof ContractLineItem | typeof PurchaseOrder)[];
     static nav: {
         label: string;
         model: typeof PurchaseOrder;
@@ -110,7 +110,7 @@ export declare class PurchasesRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };
@@ -129,7 +129,7 @@ export declare class SalesRecipe extends SmrtRecipe {
         icon: string;
         description: string;
     };
-    static models: (typeof Order | typeof ContractLineItem)[];
+    static models: (typeof ContractLineItem | typeof Order)[];
     static nav: {
         label: string;
         model: typeof Order;
@@ -178,7 +178,7 @@ export declare class SalesRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };
@@ -228,7 +228,7 @@ export declare class EstimatesRecipe extends SmrtRecipe {
         icon: string;
         description: string;
     };
-    static models: (typeof Estimate | typeof ContractLineItem)[];
+    static models: (typeof ContractLineItem | typeof Estimate)[];
     static nav: {
         label: string;
         model: typeof Estimate;
@@ -274,7 +274,7 @@ export declare class EstimatesRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };
@@ -293,7 +293,7 @@ export declare class WholesaleRecipe extends SmrtRecipe {
         icon: string;
         description: string;
     };
-    static models: (typeof WholesaleOrder | typeof ContractLineItem)[];
+    static models: (typeof ContractLineItem | typeof WholesaleOrder)[];
     static nav: {
         label: string;
         model: typeof WholesaleOrder;
@@ -342,7 +342,7 @@ export declare class WholesaleRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };
@@ -366,7 +366,7 @@ export declare class InvoicingRecipe extends SmrtRecipe {
         icon: string;
         description: string;
     };
-    static models: (typeof InvoiceLineItem | typeof Payment | typeof Invoice | typeof PaymentAllocation)[];
+    static models: (typeof Invoice | typeof InvoiceLineItem | typeof Payment | typeof PaymentAllocation)[];
     static nav: ({
         label: string;
         model: typeof Invoice;
@@ -456,7 +456,7 @@ export declare class InvoicingRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };
@@ -622,7 +622,7 @@ export declare class AgreementsRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };
@@ -653,7 +653,7 @@ export declare class LeasesRecipe extends SmrtRecipe {
         icon: string;
         description: string;
     };
-    static models: (typeof Lease | typeof ContractLineItem)[];
+    static models: (typeof ContractLineItem | typeof Lease)[];
     static nav: {
         label: string;
         model: typeof Lease;
@@ -705,7 +705,7 @@ export declare class LeasesRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };
@@ -729,7 +729,7 @@ export declare class LicensesRecipe extends SmrtRecipe {
         icon: string;
         description: string;
     };
-    static models: (typeof LicenseSale | typeof ContractLineItem)[];
+    static models: (typeof ContractLineItem | typeof LicenseSale)[];
     static nav: {
         label: string;
         model: typeof LicenseSale;
@@ -781,7 +781,7 @@ export declare class LicensesRecipe extends SmrtRecipe {
                     readonly visibility: "hidden";
                 };
                 readonly taxRate: {
-                    readonly help: "Type a percentage: 5 means 5%.";
+                    readonly help: "Stored fraction: 0.05 means 5%.";
                 };
             };
         };

package/dist/revenue-journal.d.ts

@@ -0,0 +1,61 @@
+/** Pure journal-entry construction from frozen commercial money snapshots. */
+export interface RevenueJournalDocumentInput {
+    id: string;
+    number?: string | null;
+    currency: string;
+    lineAmountType: 'exclusive' | 'inclusive' | 'none';
+    subtotalMinor: number;
+    taxMinor: number;
+    totalMinor: number;
+    providerTaxMinor: number;
+}
+export interface RevenueJournalLineInput {
+    id: string;
+    /** Stored gross-for-inclusive or net-for-exclusive line amount. */
+    amountMinor: number;
+    /** Stored total line tax, excluding document-level provider tax. */
+    taxMinor: number;
+    revenueAccountId?: string | null;
+}
+/** Stored DocumentTax snapshot fields used by revenue posting. */
+export interface RevenueJournalTaxInput {
+    currency: string;
+    taxCodeId: string | null;
+    taxCodeCode: string | null;
+    taxComponentId: string | null;
+    liabilityAccountId: string | null;
+    taxMinor: number;
+}
+export interface RevenueJournalOptions {
+    arAccountId: string;
+    revenueAccountId: string;
+    taxAccountId?: string | null;
+    /** Explicit ledger book currency; conversion is outside this helper. */
+    bookCurrency: string;
+    /** Use -1 for an exact reversal or credit direction. */
+    direction?: 1 | -1;
+}
+export interface RevenueJournalEntry {
+    accountId: string;
+    debit?: number;
+    credit?: number;
+    currency: string;
+    memo: string;
+}
+export interface RevenueJournalWarning {
+    code: 'LEGACY_TAX_ACCOUNT_FALLBACK';
+    taxCodeId: string;
+    taxCodeCode: string;
+    taxComponentId: string;
+    accountId: string;
+}
+export interface RevenueJournalResult {
+    entries: RevenueJournalEntry[];
+    warnings: RevenueJournalWarning[];
+}
+/**
+ * Build balanced entries from persisted values only. Positive source amounts
+ * debit receivables and credit revenue/tax; direction -1 swaps those sides.
+ */
+export declare function buildRevenueJournalEntries(document: RevenueJournalDocumentInput, lines: readonly RevenueJournalLineInput[], taxes: readonly RevenueJournalTaxInput[], options: RevenueJournalOptions): RevenueJournalResult;
+//# sourceMappingURL=revenue-journal.d.ts.map

package/dist/revenue-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenue-journal.d.ts","sourceRoot":"","sources":["../src/revenue-journal.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAO9E,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,6BAA6B,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AA4DD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,2BAA2B,EACrC,KAAK,EAAE,SAAS,uBAAuB,EAAE,EACzC,KAAK,EAAE,SAAS,sBAAsB,EAAE,EACxC,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CA8KtB"}