@classytic/stage 0.2.0 → 0.4.0

package/dist/finance/accounting/statements.mjs

@@ -0,0 +1,142 @@
+import { DEFAULT_ACCOUNTING_POLICY, fromMinor, toMinor } from "./precision.mjs";
+
+//#region src/finance/accounting/statements.ts
+const line = (id, label, amount, kind = "detail", treatment) => ({
+	id,
+	label,
+	amount,
+	kind,
+	...treatment ? { treatment } : {}
+});
+const section = (id, title, lines) => ({
+	id,
+	title,
+	lines
+});
+function solveSoleTraderStatements(facts, policy = DEFAULT_ACCOUNTING_POLICY) {
+	const diagnostics = [];
+	for (const [name, value] of Object.entries(facts)) {
+		if (value == null) continue;
+		if (!Number.isFinite(value) || value < 0) diagnostics.push({
+			code: "invalid-adjustment",
+			severity: "error",
+			message: `${name} must be a finite non-negative amount.`
+		});
+	}
+	const emptyValues = {
+		grossProfit: 0,
+		netProfit: 0,
+		closingCapital: 0,
+		totalAssets: 0,
+		totalLiabilities: 0,
+		totalEquityAndLiabilities: 0,
+		balanceDifference: 0,
+		netMargin: 0
+	};
+	if (diagnostics.length > 0) return {
+		incomeStatement: [],
+		statementOfFinancialPosition: [],
+		values: emptyValues,
+		balances: false,
+		diagnostics,
+		trace: []
+	};
+	const m = (value) => toMinor(value, policy);
+	const out = (value) => fromMinor(value, policy);
+	const revenue = m(facts.revenue), costOfSales = m(facts.costOfSales), expenses = m(facts.expenses), otherIncome = m(facts.otherIncome ?? 0);
+	const grossProfit = revenue - costOfSales;
+	const netProfit = grossProfit + otherIncome - expenses;
+	const closingCapital = m(facts.openingCapital) + m(facts.capitalIntroduced ?? 0) + netProfit - m(facts.drawings ?? 0);
+	const nonCurrentAssets = m(facts.nonCurrentAssets);
+	const totalAssets = nonCurrentAssets + (m(facts.inventory) + m(facts.cash) + m(facts.otherCurrentAssets ?? 0));
+	const totalLiabilities = m(facts.loan) + m(facts.currentLiabilities);
+	const totalEquityAndLiabilities = closingCapital + totalLiabilities;
+	const balanceDifference = totalAssets - totalEquityAndLiabilities;
+	const values = {
+		grossProfit: out(grossProfit),
+		netProfit: out(netProfit),
+		closingCapital: out(closingCapital),
+		totalAssets: out(totalAssets),
+		totalLiabilities: out(totalLiabilities),
+		totalEquityAndLiabilities: out(totalEquityAndLiabilities),
+		balanceDifference: out(balanceDifference),
+		netMargin: revenue === 0 ? 0 : netProfit / revenue
+	};
+	return {
+		incomeStatement: [section("trading", "Trading", [
+			line("revenue", "Revenue", out(revenue), "detail", "add"),
+			line("cost-of-sales", "Cost of sales", out(costOfSales), "detail", "subtract"),
+			line("gross-profit", "Gross profit", values.grossProfit, "subtotal", "result")
+		]), section("profit", "Profit for the period", [
+			line("other-income", "Other income", out(otherIncome), "detail", "add"),
+			line("expenses", "Expenses", out(expenses), "detail", "subtract"),
+			line("net-profit", "Profit for the year", values.netProfit, "total", "result")
+		])],
+		statementOfFinancialPosition: [
+			section("non-current-assets", "Non-current assets", [line("non-current-assets", "Non-current assets", out(nonCurrentAssets), "subtotal", "result")]),
+			section("current-assets", "Current assets", [
+				line("inventory", "Inventory", out(m(facts.inventory))),
+				line("cash", "Cash and bank", out(m(facts.cash))),
+				line("other-current-assets", "Other current assets", out(m(facts.otherCurrentAssets ?? 0))),
+				line("total-assets", "Total assets", values.totalAssets, "total", "result")
+			]),
+			section("capital", "Capital", [
+				line("opening-capital", "Opening capital", out(m(facts.openingCapital)), "detail", "add"),
+				line("capital-introduced", "Capital introduced", out(m(facts.capitalIntroduced ?? 0)), "detail", "add"),
+				line("profit-for-year", "Profit for the year", values.netProfit, "detail", "add"),
+				line("drawings", "Drawings", out(m(facts.drawings ?? 0)), "detail", "subtract"),
+				line("closing-capital", "Closing capital", values.closingCapital, "subtotal", "result")
+			]),
+			section("liabilities", "Liabilities", [
+				line("loan", "Non-current liabilities", out(m(facts.loan))),
+				line("current-liabilities", "Current liabilities", out(m(facts.currentLiabilities))),
+				line("equity-and-liabilities", "Capital and liabilities", values.totalEquityAndLiabilities, "total", "result")
+			])
+		],
+		values,
+		balances: balanceDifference === 0,
+		diagnostics,
+		trace: [
+			{
+				id: "sole-trader:gross-profit",
+				kind: "derive",
+				rule: "Gross profit = revenue − cost of sales.",
+				working: `${out(revenue)} − ${out(costOfSales)}`,
+				result: values.grossProfit
+			},
+			{
+				id: "sole-trader:net-profit",
+				kind: "derive",
+				rule: "Profit for the year = gross profit + other income − expenses.",
+				working: `${values.grossProfit} + ${out(otherIncome)} − ${out(expenses)}`,
+				result: values.netProfit
+			},
+			{
+				id: "sole-trader:capital",
+				kind: "derive",
+				rule: "Closing capital = opening capital + capital introduced + profit − drawings.",
+				working: `${out(m(facts.openingCapital))} + ${out(m(facts.capitalIntroduced ?? 0))} + ${values.netProfit} − ${out(m(facts.drawings ?? 0))}`,
+				result: values.closingCapital
+			},
+			{
+				id: "sole-trader:position",
+				kind: "check",
+				rule: "Total assets must equal closing capital plus liabilities.",
+				working: `${values.totalAssets} − ${values.totalEquityAndLiabilities}`,
+				result: balanceDifference === 0
+			}
+		]
+	};
+}
+function solveCashSettledSoleTraderScenario(base, trading, policy = DEFAULT_ACCOUNTING_POLICY) {
+	const baselineProfit = base.revenue - base.costOfSales - base.expenses;
+	const scenarioProfit = trading.revenue - trading.costOfSales - trading.expenses;
+	return solveSoleTraderStatements({
+		...base,
+		...trading,
+		cash: base.cash + scenarioProfit - baselineProfit
+	}, policy);
+}
+
+//#endregion
+export { solveCashSettledSoleTraderScenario, solveSoleTraderStatements };