@classytic/stage 0.2.0 → 0.3.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Classytic
+Copyright (c) 2026 Classytic LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -14,7 +14,7 @@ npm i @classytic/stage react react-dom
 
 Everything is also re‑exported from the root for convenience, but prefer subpaths so
 your bundle pulls only what it uses (ESM, per‑file emit; `sideEffects` are scoped to
-`**/*.css` + `**/assets/**`, so JS tree‑shakes while styles/assets are preserved):
+`**/*.css`, so JavaScript tree-shakes while the shared stylesheet is preserved):
 
 | Subpath | What's in it |
 |---|---|
@@ -63,3 +63,7 @@ export function Demo() {
 ## License
 
 MIT
+
+## Trademark
+
+MIT-licensed code. "Classytic"/"arc" names + logos are trademarks of Classytic LLC — see [TRADEMARK.md](TRADEMARK.md).

package/dist/assets/index.mjs

@@ -1,5 +1,4 @@
 import { StageAssetDefs } from "./kit/svg-defs.mjs";
 import { BucketGlyph, HangerHook, WeightGlyph, XBlockGlyph } from "./kit/glyphs.mjs";
-import "./kit/index.mjs";
 
 export { BucketGlyph, HangerHook, StageAssetDefs, WeightGlyph, XBlockGlyph };

package/dist/builder/Palette.mjs

@@ -4,96 +4,57 @@ import { ToolIcon } from "./icons.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/builder/Palette.tsx
-const btn = (active) => ({
-	display: "inline-flex",
-	alignItems: "center",
-	gap: 6,
-	padding: "6px 10px",
-	borderRadius: 8,
-	fontSize: 13,
-	fontWeight: 600,
-	cursor: "pointer",
-	color: active ? "var(--stage-bg)" : "var(--stage-fg)",
-	background: active ? "var(--stage-accent)" : "transparent",
-	border: `1px solid ${active ? "var(--stage-accent)" : "var(--stage-muted)"}`
-});
-const iconBtn = (disabled) => ({
-	display: "inline-flex",
-	alignItems: "center",
-	gap: 6,
-	padding: "6px 10px",
-	borderRadius: 8,
-	fontSize: 13,
-	fontWeight: 600,
-	cursor: disabled ? "not-allowed" : "pointer",
-	opacity: disabled ? .4 : 1,
-	color: "var(--stage-fg)",
-	background: "transparent",
-	border: "1px solid var(--stage-muted)"
-});
 function Palette({ tools, activeTool, onSelect, onUndo, onRedo, canUndo, canRedo, onClear, onSave, hint }) {
-	return /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsxs("div", {
-		role: "toolbar",
-		"aria-label": "construction tools",
-		style: {
-			display: "flex",
-			flexWrap: "wrap",
-			gap: 6,
-			alignItems: "center"
-		},
-		children: [
-			tools.map((t) => /* @__PURE__ */ jsxs("button", {
-				type: "button",
-				"aria-pressed": activeTool === t.id,
-				onClick: () => onSelect(t.id),
-				style: btn(activeTool === t.id),
-				children: [/* @__PURE__ */ jsx(ToolIcon, { name: t.icon }), t.label]
-			}, t.id)),
-			/* @__PURE__ */ jsx("span", { style: {
-				width: 1,
-				alignSelf: "stretch",
-				background: "var(--stage-muted)",
-				margin: "0 4px"
-			} }),
-			/* @__PURE__ */ jsxs("button", {
-				type: "button",
-				onClick: onUndo,
-				disabled: !canUndo,
-				style: iconBtn(!canUndo),
-				children: [/* @__PURE__ */ jsx(ToolIcon, { name: "undo" }), "Undo"]
-			}),
-			/* @__PURE__ */ jsxs("button", {
-				type: "button",
-				onClick: onRedo,
-				disabled: !canRedo,
-				style: iconBtn(!canRedo),
-				children: [/* @__PURE__ */ jsx(ToolIcon, { name: "redo" }), "Redo"]
-			}),
-			/* @__PURE__ */ jsx("button", {
-				type: "button",
-				onClick: onClear,
-				style: iconBtn(false),
-				children: "Clear"
-			}),
-			onSave && /* @__PURE__ */ jsx("button", {
-				type: "button",
-				onClick: onSave,
-				style: {
-					...iconBtn(false),
-					color: "var(--stage-good)",
-					borderColor: "var(--stage-good)"
-				},
-				children: "Save"
-			})
-		]
-	}), /* @__PURE__ */ jsx("p", {
-		style: {
-			fontSize: 12,
-			opacity: .7,
-			margin: "6px 2px 0"
-		},
-		children: hint
-	})] });
+	return /* @__PURE__ */ jsxs("div", {
+		className: "stage-palette",
+		children: [/* @__PURE__ */ jsxs("div", {
+			role: "toolbar",
+			"aria-label": "construction tools",
+			className: "stage-palette__toolbar",
+			children: [
+				tools.map((t) => /* @__PURE__ */ jsxs("button", {
+					type: "button",
+					"aria-pressed": activeTool === t.id,
+					onClick: () => onSelect(t.id),
+					className: "stage-tool-button",
+					children: [/* @__PURE__ */ jsx(ToolIcon, { name: t.icon }), t.label]
+				}, t.id)),
+				/* @__PURE__ */ jsx("span", {
+					className: "stage-palette__divider",
+					"aria-hidden": "true"
+				}),
+				/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					onClick: onUndo,
+					disabled: !canUndo,
+					className: "stage-tool-button",
+					children: [/* @__PURE__ */ jsx(ToolIcon, { name: "undo" }), "Undo"]
+				}),
+				/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					onClick: onRedo,
+					disabled: !canRedo,
+					className: "stage-tool-button",
+					children: [/* @__PURE__ */ jsx(ToolIcon, { name: "redo" }), "Redo"]
+				}),
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: onClear,
+					className: "stage-tool-button",
+					children: "Clear"
+				}),
+				onSave && /* @__PURE__ */ jsx("button", {
+					type: "button",
+					onClick: onSave,
+					className: "stage-tool-button stage-tool-button--save",
+					children: "Save"
+				})
+			]
+		}), /* @__PURE__ */ jsx("p", {
+			className: "stage-palette__hint",
+			children: hint
+		})]
+	});
 }
 
 //#endregion

package/dist/builder/SceneBuilder.mjs

@@ -149,12 +149,7 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 		}, `pend-${id}`) : null;
 	}), [pending, resolved]);
 	return /* @__PURE__ */ jsxs("div", {
-		className: "not-prose",
-		style: {
-			display: "flex",
-			flexDirection: "column",
-			gap: 10
-		},
+		className: "not-prose stage-builder",
 		children: [
 			/* @__PURE__ */ jsx(Palette, {
 				tools: toolSet,
@@ -184,21 +179,11 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 				]
 			}),
 			authoring && scalars.length > 0 && /* @__PURE__ */ jsx("div", {
-				style: {
-					display: "flex",
-					flexWrap: "wrap",
-					gap: 14,
-					padding: "2px",
-					fontSize: 13
-				},
+				className: "stage-builder__scalars",
 				children: scalars.map((el) => {
 					const f = el.free;
 					return /* @__PURE__ */ jsxs("label", {
-						style: {
-							display: "inline-flex",
-							alignItems: "center",
-							gap: 6
-						},
+						className: "stage-builder__scalar",
 						children: [
 							/* @__PURE__ */ jsx("strong", { children: el.label ?? el.id }),
 							/* @__PURE__ */ jsx("input", {
@@ -214,10 +199,7 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 								})
 							}),
 							/* @__PURE__ */ jsx("span", {
-								style: {
-									fontVariantNumeric: "tabular-nums",
-									minWidth: 24
-								},
+								className: "stage-builder__scalar-value",
 								children: f.value
 							})
 						]
@@ -225,30 +207,12 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 				})
 			}),
 			authoring && /* @__PURE__ */ jsxs("details", {
-				style: {
-					fontSize: 13,
-					border: "1px solid var(--stage-muted)",
-					borderRadius: 8,
-					padding: "6px 10px"
-				},
-				children: [/* @__PURE__ */ jsx("summary", {
-					style: {
-						cursor: "pointer",
-						fontWeight: 600
-					},
-					children: "Pedagogy, objectives · hints · difficulty"
-				}), /* @__PURE__ */ jsxs("div", {
-					style: {
-						display: "grid",
-						gap: 8,
-						marginTop: 8
-					},
+				className: "stage-builder__pedagogy",
+				children: [/* @__PURE__ */ jsx("summary", { children: "Pedagogy, objectives · hints · difficulty" }), /* @__PURE__ */ jsxs("div", {
+					className: "stage-builder__pedagogy-fields",
 					children: [
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "grid",
-								gap: 3
-							},
+							className: "stage-builder__field-label",
 							children: ["Objectives (one per line)", /* @__PURE__ */ jsx("textarea", {
 								rows: 2,
 								value: (pedagogy.objectives ?? []).join("\n"),
@@ -256,14 +220,11 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 									...p,
 									objectives: splitLines(e.currentTarget.value)
 								})),
-								style: FIELD
+								className: "stage-builder__field"
 							})]
 						}),
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "grid",
-								gap: 3
-							},
+							className: "stage-builder__field-label",
 							children: ["Hints (one per line)", /* @__PURE__ */ jsx("textarea", {
 								rows: 2,
 								value: (pedagogy.hints ?? []).join("\n"),
@@ -271,39 +232,29 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 									...p,
 									hints: splitLines(e.currentTarget.value)
 								})),
-								style: FIELD
+								className: "stage-builder__field"
 							})]
 						}),
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "grid",
-								gap: 3
-							},
+							className: "stage-builder__field-label",
 							children: ["Success criteria", /* @__PURE__ */ jsx("input", {
 								value: pedagogy.successCriteria ?? "",
 								onChange: (e) => setPedagogy((p) => ({
 									...p,
 									successCriteria: e.currentTarget.value || void 0
 								})),
-								style: FIELD
+								className: "stage-builder__field"
 							})]
 						}),
 						/* @__PURE__ */ jsxs("label", {
-							style: {
-								display: "inline-flex",
-								alignItems: "center",
-								gap: 8
-							},
+							className: "stage-builder__difficulty",
 							children: ["Difficulty", /* @__PURE__ */ jsxs("select", {
 								value: pedagogy.difficulty ?? "",
 								onChange: (e) => setPedagogy((p) => ({
 									...p,
 									difficulty: e.currentTarget.value ? Number(e.currentTarget.value) : void 0
 								})),
-								style: {
-									...FIELD,
-									width: "auto"
-								},
+								className: "stage-builder__field stage-builder__field--select",
 								children: [/* @__PURE__ */ jsx("option", {
 									value: "",
 									children: ", "
@@ -325,15 +276,6 @@ function SceneBuilder({ initial, onSave, view, height = 440, tools, authoring =
 		]
 	});
 }
-const FIELD = {
-	width: "100%",
-	border: "1px solid var(--stage-muted)",
-	borderRadius: 6,
-	padding: "4px 8px",
-	background: "transparent",
-	color: "inherit",
-	font: "inherit"
-};
 const splitLines = (s) => s.split("\n").map((x) => x.trim()).filter(Boolean);
 
 //#endregion

package/dist/core/index.d.mts

@@ -5,4 +5,5 @@ import { CoordsContext, DragOverlayContext, StageRefContext, useCoords, useDragO
 import { ClockProvider, ClockProviderProps, FrameDriver, FrameInfo, useFrameLoop } from "./clock.mjs";
 import { Learner, LearnerProvider, LearnerResult, PriorAttempts, useLearner } from "./learner.mjs";
 import { EaseFn, EaseName, Keyframe, OscillateOpts, SpringOpts, WaveShape, ease, lerp, oscillate, prefersReducedMotion, spring, timeline } from "./motion.mjs";
-export { ClockProvider, type ClockProviderProps, type ControlMap, type ControlSpec, type ControlSurface, type CoordinateSystem, CoordsContext, type CoordsOptions, DragOverlayContext, type EaseFn, type EaseName, type FrameDriver, type FrameInfo, type Keyframe, type Learner, LearnerProvider, type LearnerResult, type Matrix, type OscillateOpts, type PriorAttempts, type SpringOpts, StageRefContext, type Vec2, type ViewBox, type WaveShape, createCoords, ease, fmt, getControlSurface, lerp, listControlSurfaces, mat, onControlChange, oscillate, prefersReducedMotion, spring, timeline, useControlSurface, useCoords, useDragOverlay, useFrameLoop, useLearner, useStageRef, vec };
+import { approxEq, clamp, clamp01, gcd, remap, round, snapTo, toDeg, toRad } from "./math.mjs";
+export { ClockProvider, type ClockProviderProps, type ControlMap, type ControlSpec, type ControlSurface, type CoordinateSystem, CoordsContext, type CoordsOptions, DragOverlayContext, type EaseFn, type EaseName, type FrameDriver, type FrameInfo, type Keyframe, type Learner, LearnerProvider, type LearnerResult, type Matrix, type OscillateOpts, type PriorAttempts, type SpringOpts, StageRefContext, type Vec2, type ViewBox, type WaveShape, approxEq, clamp, clamp01, createCoords, ease, fmt, gcd, getControlSurface, lerp, listControlSurfaces, mat, onControlChange, oscillate, prefersReducedMotion, remap, round, snapTo, spring, timeline, toDeg, toRad, useControlSurface, useCoords, useDragOverlay, useFrameLoop, useLearner, useStageRef, vec };

package/dist/core/index.mjs

@@ -4,6 +4,7 @@ import { CoordsContext, DragOverlayContext, StageRefContext, useCoords, useDragO
 import { ClockProvider, useFrameLoop } from "./clock.mjs";
 import { getControlSurface, listControlSurfaces, onControlChange, useControlSurface } from "./control.mjs";
 import { LearnerProvider, useLearner } from "./learner.mjs";
+import { approxEq, clamp, clamp01, gcd, remap, round, snapTo, toDeg, toRad } from "./math.mjs";
 import { ease, lerp, oscillate, prefersReducedMotion, spring, timeline } from "./motion.mjs";
 
-export { ClockProvider, CoordsContext, DragOverlayContext, LearnerProvider, StageRefContext, createCoords, ease, fmt, getControlSurface, lerp, listControlSurfaces, mat, onControlChange, oscillate, prefersReducedMotion, spring, timeline, useControlSurface, useCoords, useDragOverlay, useFrameLoop, useLearner, useStageRef, vec };
+export { ClockProvider, CoordsContext, DragOverlayContext, LearnerProvider, StageRefContext, approxEq, clamp, clamp01, createCoords, ease, fmt, gcd, getControlSurface, lerp, listControlSurfaces, mat, onControlChange, oscillate, prefersReducedMotion, remap, round, snapTo, spring, timeline, toDeg, toRad, useControlSurface, useCoords, useDragOverlay, useFrameLoop, useLearner, useStageRef, vec };

package/dist/core/math.d.mts

@@ -0,0 +1,26 @@
+//#region src/core/math.d.ts
+/**
+ * Small numeric kit shared by every consumer (labs re-exports these). One
+ * source of truth: labs presets used to hand-roll `clamp` 8+ different times.
+ * Pure, SSR-deterministic (no transcendental output is emitted directly into
+ * SVG — callers still `fmt()` pixel values).
+ */
+declare const clamp: (v: number, lo: number, hi: number) => number;
+/** Clamp to the unit interval [0, 1] — the ubiquitous "fraction / progress" guard. */
+declare const clamp01: (v: number) => number;
+/** Round to `dp` decimal places (default 2), as a number. */
+declare const round: (n: number, dp?: number) => number;
+/** Greatest common divisor (Euclid), 0→1 so a ratio/fraction can always reduce. */
+declare const gcd: (a: number, b: number) => number;
+/** Degrees → radians. */
+declare const toRad: (deg: number) => number;
+/** Radians → degrees. */
+declare const toDeg: (rad: number) => number;
+/** Are two numbers equal within a tolerance (default 1e-6)? */
+declare const approxEq: (a: number, b: number, eps?: number) => boolean;
+/** Map x from [inMin,inMax] to [outMin,outMax], optionally clamped. */
+declare function remap(x: number, inMin: number, inMax: number, outMin: number, outMax: number, doClamp?: boolean): number;
+/** Snap `v` to the nearest multiple of `step` (step <= 0 → identity). */
+declare const snapTo: (v: number, step: number) => number;
+//#endregion
+export { approxEq, clamp, clamp01, gcd, remap, round, snapTo, toDeg, toRad };

package/dist/core/math.mjs

@@ -0,0 +1,37 @@
+//#region src/core/math.ts
+/**
+* Small numeric kit shared by every consumer (labs re-exports these). One
+* source of truth: labs presets used to hand-roll `clamp` 8+ different times.
+* Pure, SSR-deterministic (no transcendental output is emitted directly into
+* SVG — callers still `fmt()` pixel values).
+*/
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+/** Clamp to the unit interval [0, 1] — the ubiquitous "fraction / progress" guard. */
+const clamp01 = (v) => v < 0 ? 0 : v > 1 ? 1 : v;
+/** Round to `dp` decimal places (default 2), as a number. */
+const round = (n, dp = 2) => Math.round(n * 10 ** dp) / 10 ** dp;
+/** Greatest common divisor (Euclid), 0→1 so a ratio/fraction can always reduce. */
+const gcd = (a, b) => {
+	a = Math.abs(a);
+	b = Math.abs(b);
+	while (b) [a, b] = [b, a % b];
+	return a || 1;
+};
+const DEG = Math.PI / 180;
+/** Degrees → radians. */
+const toRad = (deg) => deg * DEG;
+/** Radians → degrees. */
+const toDeg = (rad) => rad / DEG;
+/** Are two numbers equal within a tolerance (default 1e-6)? */
+const approxEq = (a, b, eps = 1e-6) => Math.abs(a - b) <= eps;
+/** Map x from [inMin,inMax] to [outMin,outMax], optionally clamped. */
+function remap(x, inMin, inMax, outMin, outMax, doClamp = false) {
+	const t = inMax === inMin ? 0 : (x - inMin) / (inMax - inMin);
+	const v = outMin + (outMax - outMin) * t;
+	return doClamp ? clamp(v, Math.min(outMin, outMax), Math.max(outMin, outMax)) : v;
+}
+/** Snap `v` to the nearest multiple of `step` (step <= 0 → identity). */
+const snapTo = (v, step) => step > 0 ? Math.round(v / step) * step : v;
+
+//#endregion
+export { approxEq, clamp, clamp01, gcd, remap, round, snapTo, toDeg, toRad };

package/dist/finance/bizsim.d.mts

@@ -0,0 +1,93 @@
+//#region src/finance/bizsim.d.ts
+/**
+ * bizsim — a tiny, always-balanced business-simulation engine (part of `finance`).
+ *
+ * This is the PRIMITIVE a "run a business" story lesson is built on: a teacher/creator
+ * authors a scenario as a sequence of business ACTIONS (invest capital, take a loan,
+ * buy equipment, buy stock, sell, pay an expense, depreciate, close the period). Each
+ * action is a pure, DOUBLE-ENTRY-BALANCED transform of the business state, so the
+ * derived income statement and balance sheet are always correct and the balance sheet
+ * always balances — no accounting knowledge required to author, and it scales all the
+ * way to financial analysis (ratios) at the end.
+ *
+ * The engine is content-neutral: it knows nothing about samosas, apps or coffee — the
+ * creator supplies the story and the numbers.
+ */
+interface BizState {
+  cash: number;
+  /** Stock on hand: quantity and its value at cost. */
+  inventoryQty: number;
+  inventoryValue: number;
+  /** Fixed assets at book value. */
+  equipment: number;
+  /** Liabilities (loans). */
+  loan: number;
+  /** Owner capital contributed. */
+  capital: number;
+  /** Accumulated profit from closed periods. */
+  retained: number;
+  /** Current open-period tallies (become net profit at closePeriod). */
+  revenue: number;
+  cogs: number;
+  expenses: number;
+}
+declare const initialBiz: (over?: Partial<BizState>) => BizState;
+type BizAction = {
+  type: 'invest';
+  amount: number;
+} | {
+  type: 'loan';
+  amount: number;
+} | {
+  type: 'repay';
+  amount: number;
+} | {
+  type: 'buyEquipment';
+  amount: number;
+} | {
+  type: 'depreciate';
+  amount: number;
+} | {
+  type: 'buyStock';
+  qty: number;
+  unitCost: number;
+} | {
+  type: 'sell';
+  qty: number;
+  price: number;
+} | {
+  type: 'expense';
+  amount: number;
+} | {
+  type: 'closePeriod';
+};
+/** Apply one action; pure and balance-preserving (assets = liabilities + equity). */
+declare function applyBiz(s: BizState, a: BizAction): BizState;
+/** Run a whole authored scenario from an (optional) starting state. */
+declare function runBiz(actions: BizAction[], init?: Partial<BizState>): BizState;
+interface IncomeStatement {
+  revenue: number;
+  cogs: number;
+  grossProfit: number;
+  expenses: number;
+  netProfit: number;
+}
+/** Income statement for the current open period. */
+declare function incomeStatement(s: BizState): IncomeStatement;
+interface BalanceSheet {
+  cash: number;
+  inventory: number;
+  equipment: number;
+  totalAssets: number;
+  loan: number;
+  capital: number;
+  retained: number;
+  openProfit: number;
+  totalEquity: number;
+  totalLiabilitiesEquity: number;
+  balances: boolean;
+}
+/** Balance sheet; `balances` is always true by construction (a self-check). */
+declare function balanceSheet(s: BizState): BalanceSheet;
+//#endregion
+export { BalanceSheet, BizAction, BizState, IncomeStatement, applyBiz, balanceSheet, incomeStatement, initialBiz, runBiz };

package/dist/finance/bizsim.mjs

@@ -0,0 +1,117 @@
+//#region src/finance/bizsim.ts
+const initialBiz = (over = {}) => ({
+	cash: 0,
+	inventoryQty: 0,
+	inventoryValue: 0,
+	equipment: 0,
+	loan: 0,
+	capital: 0,
+	retained: 0,
+	revenue: 0,
+	cogs: 0,
+	expenses: 0,
+	...over
+});
+/** Apply one action; pure and balance-preserving (assets = liabilities + equity). */
+function applyBiz(s, a) {
+	switch (a.type) {
+		case "invest": return {
+			...s,
+			cash: s.cash + a.amount,
+			capital: s.capital + a.amount
+		};
+		case "loan": return {
+			...s,
+			cash: s.cash + a.amount,
+			loan: s.loan + a.amount
+		};
+		case "repay": return {
+			...s,
+			cash: s.cash - a.amount,
+			loan: s.loan - a.amount
+		};
+		case "buyEquipment": return {
+			...s,
+			cash: s.cash - a.amount,
+			equipment: s.equipment + a.amount
+		};
+		case "depreciate": return {
+			...s,
+			equipment: s.equipment - a.amount,
+			expenses: s.expenses + a.amount
+		};
+		case "buyStock": return {
+			...s,
+			cash: s.cash - a.qty * a.unitCost,
+			inventoryQty: s.inventoryQty + a.qty,
+			inventoryValue: s.inventoryValue + a.qty * a.unitCost
+		};
+		case "sell": {
+			const avg = s.inventoryQty > 0 ? s.inventoryValue / s.inventoryQty : 0;
+			const qty = Math.min(a.qty, s.inventoryQty);
+			const cost = qty * avg, sales = qty * a.price;
+			return {
+				...s,
+				cash: s.cash + sales,
+				revenue: s.revenue + sales,
+				cogs: s.cogs + cost,
+				inventoryQty: s.inventoryQty - qty,
+				inventoryValue: s.inventoryValue - cost
+			};
+		}
+		case "expense": return {
+			...s,
+			cash: s.cash - a.amount,
+			expenses: s.expenses + a.amount
+		};
+		case "closePeriod": {
+			const net = s.revenue - s.cogs - s.expenses;
+			return {
+				...s,
+				retained: s.retained + net,
+				revenue: 0,
+				cogs: 0,
+				expenses: 0
+			};
+		}
+		default: return s;
+	}
+}
+/** Run a whole authored scenario from an (optional) starting state. */
+function runBiz(actions, init = {}) {
+	return actions.reduce(applyBiz, initialBiz(init));
+}
+/** Income statement for the current open period. */
+function incomeStatement(s) {
+	const grossProfit = s.revenue - s.cogs;
+	return {
+		revenue: s.revenue,
+		cogs: s.cogs,
+		grossProfit,
+		expenses: s.expenses,
+		netProfit: grossProfit - s.expenses
+	};
+}
+/** Balance sheet; `balances` is always true by construction (a self-check). */
+function balanceSheet(s) {
+	const totalAssets = s.cash + s.inventoryValue + s.equipment;
+	const openProfit = s.revenue - s.cogs - s.expenses;
+	const totalEquity = s.capital + s.retained + openProfit;
+	const totalLiabilitiesEquity = s.loan + totalEquity;
+	return {
+		cash: s.cash,
+		inventory: s.inventoryValue,
+		equipment: s.equipment,
+		totalAssets,
+		loan: s.loan,
+		capital: s.capital,
+		retained: s.retained,
+		openProfit,
+		totalEquity,
+		totalLiabilitiesEquity,
+		balances: Math.abs(totalAssets - totalLiabilitiesEquity) < 1e-6
+	};
+}
+
+//#endregion
+export { applyBiz, balanceSheet, incomeStatement, initialBiz, runBiz };