@idlekit/money 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imjlk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,62 @@
-# Temporary Holding Version
+# @idlekit/money
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Money primitives for idle and incremental game economies.
+Includes numeric engines, notation, money state transitions, serialization, and visibility tracking.
+Official support in v1: Bun `>=1.4.2` only. Node.js and browser runtimes are not part of the v1 compatibility contract.
+
+```bash
+bun add @idlekit/money
+```
+
+Requires Bun `>=1.4.2`.
+
+Use this package when you need:
+
+- `Engine<N>` adapters
+- `Money` / `MoneyState`
+- `tickMoney` with `drop` / `accumulate`
+- money formatting, parsing, and serde
+
+## Quick example
+
+<!-- snippet: snippets/readme/money-quick-example.ts -->
+```ts
+import {
+  createBreakInfinityEngine,
+  deserializeMoneyState,
+  formatMoney,
+  serializeMoneyState,
+  tickMoney,
+} from "@idlekit/money";
+
+const E = createBreakInfinityEngine();
+const unit = { code: "COIN" as const };
+
+const result = tickMoney({
+  E,
+  state: {
+    money: { unit, amount: E.from("1e6") },
+    bucket: E.zero(),
+  },
+  delta: { unit, amount: E.from("25") },
+  policy: { mode: "accumulate", maxLogGap: 6 },
+});
+
+const saved = serializeMoneyState(E, result.state, { engineName: "break_infinity.js" });
+const restored = deserializeMoneyState(E, saved);
+
+console.log(formatMoney(E, restored.money));
+```
+
+## Runtime
+
+`@idlekit/money` is maintained as a Bun-first ESM package.
+
+`Engine.comparisonIsExact` optionally declares that `cmp` has no comparison tolerance. Number and break-infinity adapters report `true` with epsilon 0 and `false` with their default epsilon. Custom adapters may declare `true` only for strict comparisons; omission means unknown to analyses that require an exact goal boundary.
+
+## Documentation
+
+- Repository: [github.com/imjlk/idlekit](https://github.com/imjlk/idlekit)
+- Product roadmap: [docs/roadmap.md](https://github.com/imjlk/idlekit/blob/main/docs/roadmap.md)
+- Usage guide: [docs/money-library.md](https://github.com/imjlk/idlekit/blob/main/docs/money-library.md)
+- Example: [examples/money-package](https://github.com/imjlk/idlekit/tree/main/examples/money-package)

package/dist/engine/breakEternity.d.ts

@@ -0,0 +1,4 @@
+import type { Engine } from "./types";
+export declare const BREAK_ETERNITY_EXPERIMENTAL_MESSAGE = "breakEternityEngine is experimental and not implemented in idlekit v1. Use breakInfinityEngine or provide a custom Engine adapter.";
+export declare function createBreakEternityEngine(): Engine<never>;
+export declare const breakEternityEngine: Engine<never>;

package/dist/engine/breakEternity.js

@@ -0,0 +1,24 @@
+export const BREAK_ETERNITY_EXPERIMENTAL_MESSAGE = "breakEternityEngine is experimental and not implemented in idlekit v1. Use breakInfinityEngine or provide a custom Engine adapter.";
+function notImplemented() {
+    throw new Error(BREAK_ETERNITY_EXPERIMENTAL_MESSAGE);
+}
+export function createBreakEternityEngine() {
+    return {
+        zero: notImplemented,
+        from: notImplemented,
+        add: notImplemented,
+        sub: notImplemented,
+        mul: notImplemented,
+        div: notImplemented,
+        mulN: notImplemented,
+        divN: notImplemented,
+        cmp: notImplemented,
+        absLog10: notImplemented,
+        isFinite: notImplemented,
+        toString: notImplemented,
+        toNumber: notImplemented,
+    };
+}
+// Experimental placeholder kept only to preserve the public export.
+export const breakEternityEngine = createBreakEternityEngine();
+//# sourceMappingURL=breakEternity.js.map

package/dist/engine/breakEternity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakEternity.js","sourceRoot":"","sources":["../../src/engine/breakEternity.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mCAAmC,GAC9C,oIAAoI,CAAC;AAEvI,SAAS,cAAc;IACrB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,cAAc;QACnB,GAAG,EAAE,cAAc;QACnB,GAAG,EAAE,cAAc;QACnB,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,cAAc;QACpB,GAAG,EAAE,cAAc;QACnB,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE,cAAc;KACzB,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAC"}

package/dist/engine/breakInfinity.d.ts

@@ -0,0 +1,13 @@
+import type { Engine } from "./types";
+import Decimal from "break_infinity.js";
+import type { DecimalSource } from "break_infinity.js";
+export type NumberEngineOptions = Readonly<{
+    epsilon?: number;
+}>;
+export type BreakInfinityEngineOptions = Readonly<{
+    epsilon?: DecimalSource;
+}>;
+export declare function createNumberEngine(opts?: NumberEngineOptions): Engine<number>;
+export declare function createBreakInfinityEngine(opts?: BreakInfinityEngineOptions): Engine<Decimal>;
+export declare const breakInfinityEngine: Engine<Decimal>;
+export { Decimal };

package/dist/engine/breakInfinity.js

@@ -0,0 +1,104 @@
+import Decimal from "break_infinity.js";
+export function createNumberEngine(opts) {
+    const epsilon = opts?.epsilon ?? 1e-12;
+    return {
+        comparisonIsExact: epsilon === 0,
+        zero: () => 0,
+        from(input) {
+            if (typeof input === "number")
+                return input;
+            if (typeof input === "string")
+                return Number(input);
+            return input;
+        },
+        add: (a, b) => a + b,
+        sub: (a, b) => a - b,
+        mul: (a, k) => a * k,
+        div: (a, k) => a / k,
+        mulN: (a, b) => a * b,
+        divN: (a, b) => a / b,
+        cmp(a, b) {
+            const d = a - b;
+            if (Math.abs(d) <= epsilon)
+                return 0;
+            return d < 0 ? -1 : 1;
+        },
+        absLog10(a) {
+            const n = Math.abs(a);
+            if (n === 0)
+                return -Infinity;
+            return Math.log10(n);
+        },
+        isFinite: (a) => Number.isFinite(a),
+        toString: (a) => String(a),
+        toNumber: (a) => a,
+    };
+}
+function toDecimal(input) {
+    return input instanceof Decimal ? input : new Decimal(input);
+}
+function decimalIsFinite(value) {
+    return Number.isFinite(value.mantissa) && Number.isFinite(value.exponent);
+}
+/** `String(1e21)` is `"1e+21"`. Settlement text needs one plain decimal exponent. */
+function plainExponent(exponent) {
+    if (!Number.isFinite(exponent))
+        return String(exponent);
+    const sign = exponent < 0 ? "-" : "";
+    const magnitude = Math.abs(exponent);
+    if (magnitude < 1e21)
+        return `${sign}${String(magnitude)}`;
+    const text = magnitude.toExponential();
+    const match = /^(\d+)(?:\.(\d+))?e\+(\d+)$/.exec(text);
+    if (!match?.[1] || !match[3])
+        return `${sign}${text}`;
+    const fraction = match[2] ?? "";
+    const zeros = Number(match[3]) - fraction.length;
+    if (!Number.isInteger(zeros) || zeros < 0)
+        return `${sign}${text}`;
+    return `${sign}${match[1]}${fraction}${"0".repeat(zeros)}`;
+}
+export function createBreakInfinityEngine(opts) {
+    const epsilon = toDecimal(opts?.epsilon ?? "1e-12");
+    return {
+        comparisonIsExact: epsilon.eq(0),
+        zero: () => new Decimal(0),
+        from(input) {
+            return toDecimal(input);
+        },
+        add: (a, b) => a.add(b),
+        sub: (a, b) => a.sub(b),
+        mul: (a, k) => a.mul(k),
+        div: (a, k) => a.div(k),
+        mulN: (a, b) => a.mul(b),
+        divN: (a, b) => a.div(b),
+        cmp(a, b) {
+            const d = a.sub(b);
+            if (d.abs().lte(epsilon))
+                return 0;
+            return d.lt(0) ? -1 : 1;
+        },
+        absLog10(a) {
+            if (a.eq(0))
+                return -Infinity;
+            return a.absLog10();
+        },
+        isFinite: decimalIsFinite,
+        toString(value) {
+            const text = value.toString();
+            const underflow = (text === "0" || text === "-0") && value.mantissa !== 0;
+            if (!underflow && text !== "Infinity" && text !== "-Infinity")
+                return text;
+            if (!decimalIsFinite(value))
+                return text;
+            const sign = value.mantissa < 0 ? "-" : "";
+            const digits = String(Math.abs(value.mantissa));
+            return `${sign}${digits}e${plainExponent(value.exponent)}`;
+        },
+        toNumber: (a) => a.toNumber(),
+    };
+}
+// Canonical break_infinity.js adapter.
+export const breakInfinityEngine = createBreakInfinityEngine();
+export { Decimal };
+//# sourceMappingURL=breakInfinity.js.map

package/dist/engine/breakInfinity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakInfinity.js","sourceRoot":"","sources":["../../src/engine/breakInfinity.ts"],"names":[],"mappings":"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"}

package/dist/engine/types.d.ts

@@ -0,0 +1,22 @@
+export interface Engine<N> {
+    zero(): N;
+    from(input: number | string | N): N;
+    add(a: N, b: N): N;
+    sub(a: N, b: N): N;
+    mul(a: N, k: number): N;
+    div(a: N, k: number): N;
+    mulN(a: N, b: N): N;
+    divN(a: N, b: N): N;
+    cmp(a: N, b: N): -1 | 0 | 1;
+    /** True only when cmp has no comparison tolerance; omission means unknown. */
+    readonly comparisonIsExact?: boolean;
+    /**
+     * Exact order for values whose `toString` is not a bare decimal.
+     * Settlement rejects the comparison when this hook is absent.
+     */
+    exactOrder?(a: N, b: N): -1 | 0 | 1;
+    absLog10(a: N): number;
+    isFinite(a: N): boolean;
+    toString(a: N): string;
+    toNumber(a: N): number;
+}

package/dist/engine/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./engine/types";
+export * from "./engine/breakInfinity";
+export * from "./engine/breakEternity";
+export * from "./money/types";
+export * from "./policy/types";
+export * from "./policy/emitter";
+export * from "./policy/tickMoney";
+export * from "./notation/suffixer";
+export * from "./notation/formatMoney";
+export * from "./notation/parseMoney";
+export * from "./notation/visibilityTracker";
+export * from "./serde/moneyState";

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from "./engine/types";
+export * from "./engine/breakInfinity";
+export * from "./engine/breakEternity";
+export * from "./money/types";
+export * from "./policy/types";
+export * from "./policy/emitter";
+export * from "./policy/tickMoney";
+export * from "./notation/suffixer";
+export * from "./notation/formatMoney";
+export * from "./notation/parseMoney";
+export * from "./notation/visibilityTracker";
+export * from "./serde/moneyState";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,eAAe,CAAC;AAE9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,oBAAoB,CAAC"}

package/dist/money/types.d.ts

@@ -0,0 +1,12 @@
+export type Unit<U extends string> = Readonly<{
+    code: U;
+    symbol?: string;
+}>;
+export type Money<N, U extends string> = Readonly<{
+    unit: Unit<U>;
+    amount: N;
+}>;
+export type MoneyState<N, U extends string> = Readonly<{
+    money: Money<N, U>;
+    bucket: N;
+}>;

package/dist/money/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/money/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/money/types.ts"],"names":[],"mappings":""}

package/dist/notation/formatMoney.d.ts

@@ -0,0 +1,10 @@
+import type { Engine } from "../engine/types";
+import type { Money } from "../money/types";
+import { type Suffixer } from "./suffixer";
+export type FormatMoneyOptions = Readonly<{
+    suffix?: Suffixer;
+    significantDigits?: number;
+    showUnit?: boolean;
+    trimTrailingZeros?: boolean;
+}>;
+export declare function formatMoney<N, U extends string>(E: Engine<N>, money: Money<N, U>, opts?: FormatMoneyOptions): string;

package/dist/notation/formatMoney.js

@@ -0,0 +1,40 @@
+import { alphaInfiniteSuffix } from "./suffixer";
+function suffixAt(suffix, index) {
+    if (index <= 0)
+        return "";
+    if (!suffix)
+        return alphaInfiniteSuffix(index, 2);
+    if (suffix.kind === "table")
+        return suffix.table[index] ?? "";
+    return alphaInfiniteSuffix(index, suffix.minLen ?? 2);
+}
+function trimZeros(n) {
+    if (!n.includes("."))
+        return n;
+    return n.replace(/\.0+$/, "").replace(/(\.\d*?[1-9])0+$/, "$1");
+}
+export function formatMoney(E, money, opts) {
+    const digits = opts?.significantDigits ?? 3;
+    const showUnit = opts?.showUnit ?? true;
+    const trim = opts?.trimTrailingZeros ?? true;
+    const amount = money.amount;
+    const absLog10 = E.absLog10(amount);
+    const sign = E.cmp(amount, E.zero()) < 0 ? -1 : 1;
+    if (!Number.isFinite(absLog10)) {
+        const raw = E.toString(amount);
+        return showUnit ? `${raw} ${money.unit.code}` : raw;
+    }
+    const group = Math.max(0, Math.floor(absLog10 / 3));
+    const scale = E.from(`1e${group * 3}`);
+    const mantissa = E.toNumber(E.divN(amount, scale));
+    let left = Number.isFinite(mantissa)
+        ? Math.abs(mantissa).toPrecision(digits)
+        : Math.abs(E.toNumber(amount)).toPrecision(digits);
+    if (trim)
+        left = trimZeros(left);
+    const suffix = suffixAt(opts?.suffix, group);
+    const signed = sign < 0 && !left.startsWith("-") ? `-${left}` : left;
+    const raw = `${signed}${suffix}`;
+    return showUnit ? `${raw} ${money.unit.code}` : raw;
+}
+//# sourceMappingURL=formatMoney.js.map

package/dist/notation/formatMoney.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatMoney.js","sourceRoot":"","sources":["../../src/notation/formatMoney.ts"],"names":[],"mappings":"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"}

package/dist/notation/parseMoney.d.ts

@@ -0,0 +1,9 @@
+import type { Engine } from "../engine/types";
+import type { Money, Unit } from "../money/types";
+import { type Suffixer } from "./suffixer";
+export type ParseMoneyOptions<U extends string> = Readonly<{
+    suffix?: Suffixer;
+    unit?: Unit<U>;
+    allowUnitInString?: boolean;
+}>;
+export declare function parseMoney<N, U extends string>(E: Engine<N>, input: string, opts: ParseMoneyOptions<U>): Money<N, U>;

package/dist/notation/parseMoney.js

@@ -0,0 +1,52 @@
+import { alphaInfiniteIndex } from "./suffixer";
+function parseSuffixIndex(token, suffix) {
+    if (!token)
+        return 0;
+    if (!suffix) {
+        return alphaInfiniteIndex(token, 2);
+    }
+    if (suffix.kind === "table") {
+        const idx = suffix.table.findIndex((x) => x.toLowerCase() === token.toLowerCase());
+        return idx >= 0 ? idx : -1;
+    }
+    return alphaInfiniteIndex(token, suffix.minLen ?? 2);
+}
+export function parseMoney(E, input, opts) {
+    const text = input.trim();
+    const parts = text.split(/\s+/).filter(Boolean);
+    if (parts.length === 0 || parts.length > 2) {
+        throw new Error(`Invalid money string: ${input}`);
+    }
+    const left = parts[0];
+    if (!left)
+        throw new Error(`Invalid money string: ${input}`);
+    const leftMatch = left.match(/^([+-]?(?:\d+(?:\.\d+)?|\.\d+)(?:e[+-]?\d+)?)([A-Za-z]+)?$/i);
+    if (!leftMatch)
+        throw new Error(`Invalid money string: ${input}`);
+    const numeric = leftMatch[1];
+    if (!numeric)
+        throw new Error(`Invalid numeric part: ${input}`);
+    const suffixToken = leftMatch[2];
+    const inlineUnit = parts.length === 2 ? parts[1] : undefined;
+    if (inlineUnit && !opts.allowUnitInString) {
+        throw new Error("Unit in string is not allowed. Set allowUnitInString=true.");
+    }
+    const suffixIndex = parseSuffixIndex(suffixToken, opts.suffix);
+    if (suffixToken && suffixIndex < 0) {
+        throw new Error(`Unknown suffix: ${suffixToken}`);
+    }
+    const exp3 = suffixIndex * 3;
+    const scaled = exp3 > 0 ? E.mulN(E.from(numeric), E.from(`1e${exp3}`)) : E.from(numeric);
+    const unit = opts.unit ?? (inlineUnit ? { code: inlineUnit } : undefined);
+    if (!unit) {
+        throw new Error("Unit is required. Provide opts.unit or unit in input string.");
+    }
+    if (inlineUnit && unit.code !== inlineUnit) {
+        throw new Error(`Unit mismatch: expected ${unit.code}, got ${inlineUnit}`);
+    }
+    return {
+        unit,
+        amount: scaled,
+    };
+}
+//# sourceMappingURL=parseMoney.js.map

package/dist/notation/parseMoney.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMoney.js","sourceRoot":"","sources":["../../src/notation/parseMoney.ts"],"names":[],"mappings":"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"}

package/dist/notation/suffixer.d.ts

@@ -0,0 +1,9 @@
+export type Suffixer = {
+    kind: "alphaInfinite";
+    minLen?: number;
+} | {
+    kind: "table";
+    table: string[];
+};
+export declare function alphaInfiniteSuffix(index: number, minLen?: number): string;
+export declare function alphaInfiniteIndex(label: string, minLen?: number): number;

package/dist/notation/suffixer.js

@@ -0,0 +1,53 @@
+function assertValidMinLen(minLen) {
+    if (!Number.isInteger(minLen) || minLen < 1) {
+        throw new Error(`alphaInfinite minLen must be an integer >= 1 (received: ${minLen})`);
+    }
+}
+function pow26(exp) {
+    return 26 ** exp;
+}
+function countBeforeLength(length, minLen) {
+    let total = 0;
+    for (let len = minLen; len < length; len++)
+        total += pow26(len);
+    return total;
+}
+// 1 -> aa, 26 -> az, 27 -> ba, 676 -> zz, 677 -> aaa (minLen=2)
+export function alphaInfiniteSuffix(index, minLen = 2) {
+    assertValidMinLen(minLen);
+    if (!Number.isFinite(index) || index <= 0)
+        return "";
+    let remaining = Math.floor(index);
+    let length = minLen;
+    while (true) {
+        const count = pow26(length);
+        if (remaining <= count)
+            break;
+        remaining -= count;
+        length += 1;
+    }
+    let offset = remaining - 1;
+    const chars = new Array(length);
+    for (let pos = length - 1; pos >= 0; pos--) {
+        const digit = offset % 26;
+        chars[pos] = String.fromCharCode(97 + digit);
+        offset = Math.floor(offset / 26);
+    }
+    return chars.join("");
+}
+export function alphaInfiniteIndex(label, minLen = 2) {
+    assertValidMinLen(minLen);
+    const s = label.trim().toLowerCase();
+    if (s.length < minLen)
+        return -1;
+    let offset = 0;
+    for (const ch of s) {
+        const code = ch.charCodeAt(0);
+        if (code < 97 || code > 122)
+            return -1;
+        offset = offset * 26 + (code - 97);
+    }
+    const prior = countBeforeLength(s.length, minLen);
+    return prior + offset + 1;
+}
+//# sourceMappingURL=suffixer.js.map

package/dist/notation/suffixer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suffixer.js","sourceRoot":"","sources":["../../src/notation/suffixer.ts"],"names":[],"mappings":"AAUA,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2DAA2D,MAAM,GAAG,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,EAAE,IAAI,GAAG,CAAC;AACnB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc,EAAE,MAAc;IACvD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,GAAG,GAAG,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,EAAE;QAAE,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,MAAM,GAAG,CAAC;IAC3D,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAErD,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,MAAM,CAAC;IACpB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,SAAS,IAAI,KAAK;YAAE,MAAM;QAC9B,SAAS,IAAI,KAAK,CAAC;QACnB,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;IAED,IAAI,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAS,MAAM,CAAC,CAAC;IACxC,KAAK,IAAI,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,GAAG,EAAE,CAAC;QAC1B,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;QAC7C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,MAAM,GAAG,CAAC;IAC1D,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM;QAAE,OAAO,CAAC,CAAC,CAAC;IAEjC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,GAAG,GAAG;YAAE,OAAO,CAAC,CAAC,CAAC;QACvC,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/notation/visibilityTracker.d.ts

@@ -0,0 +1,17 @@
+import type { Engine } from "../engine/types";
+import type { Money } from "../money/types";
+import { type FormatMoneyOptions } from "./formatMoney";
+export type VisibilityChange = Readonly<{
+    changed: boolean;
+    current: string;
+    previous?: string;
+}>;
+export declare class VisibilityTracker<N, U extends string> {
+    #private;
+    private readonly E;
+    private readonly opts?;
+    constructor(E: Engine<N>, opts?: FormatMoneyOptions | undefined);
+    observe(money: Money<N, U>): VisibilityChange;
+    current(): string | undefined;
+    reset(): void;
+}

package/dist/notation/visibilityTracker.js

@@ -0,0 +1,24 @@
+import { formatMoney } from "./formatMoney";
+export class VisibilityTracker {
+    E;
+    opts;
+    #previous;
+    constructor(E, opts) {
+        this.E = E;
+        this.opts = opts;
+    }
+    observe(money) {
+        const current = formatMoney(this.E, money, this.opts);
+        const previous = this.#previous;
+        const changed = previous !== undefined && previous !== current;
+        this.#previous = current;
+        return { changed, current, previous };
+    }
+    current() {
+        return this.#previous;
+    }
+    reset() {
+        this.#previous = undefined;
+    }
+}
+//# sourceMappingURL=visibilityTracker.js.map

package/dist/notation/visibilityTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibilityTracker.js","sourceRoot":"","sources":["../../src/notation/visibilityTracker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAA2B,MAAM,eAAe,CAAC;AAQrE,MAAM,OAAO,iBAAiB;IAIT,CAAC;IACD,IAAI;IAJvB,SAAS,CAAU;IAEnB,YACmB,CAAY,EACZ,IAAyB;iBADzB,CAAC;oBACD,IAAI;IACpB,CAAC;IAEJ,OAAO,CAAC,KAAkB;QACxB,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,OAAO,CAAC;QAC/D,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/dist/policy/emitter.d.ts

@@ -0,0 +1,7 @@
+export type Emitter<E> = (events: readonly E[]) => void;
+export declare function onType<E extends {
+    type: string;
+}, T extends E["type"]>(type: T, handler: (e: Extract<E, {
+    type: T;
+}>) => void): (events: readonly E[]) => void;
+export declare function composeEmitters<E>(...emitters: Array<((events: readonly E[]) => void) | undefined>): (events: readonly E[]) => void;

package/dist/policy/emitter.js

@@ -0,0 +1,17 @@
+export function onType(type, handler) {
+    return (events) => {
+        for (const e of events) {
+            if (e.type === type) {
+                handler(e);
+            }
+        }
+    };
+}
+export function composeEmitters(...emitters) {
+    const list = emitters.filter(Boolean);
+    return (events) => {
+        for (const em of list)
+            em(events);
+    };
+}
+//# sourceMappingURL=emitter.js.map

package/dist/policy/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/policy/emitter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,MAAM,CACpB,IAAO,EACP,OAA6C;IAE7C,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,CAAC,CAA4B,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAAG,QAA6D;IAEhE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAA0C,CAAC;IAC/E,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,KAAK,MAAM,EAAE,IAAI,IAAI;YAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/policy/facts.d.ts

@@ -0,0 +1,6 @@
+import type { TickFactCounts } from "./types";
+export declare const APPLIED_FACTS: TickFactCounts;
+export declare const DROPPED_FACTS: TickFactCounts;
+export declare const QUEUED_FACTS: TickFactCounts;
+export declare const FLUSHED_FACTS: TickFactCounts;
+export declare const BLOCKED_FACTS: TickFactCounts;

package/dist/policy/facts.js

@@ -0,0 +1,7 @@
+// Counts have no amounts or run identity and can be shared without per-tick allocation.
+export const APPLIED_FACTS = Object.freeze({ applied: 1, dropped: 0, queued: 0, flushed: 0, blocked: 0 });
+export const DROPPED_FACTS = Object.freeze({ applied: 0, dropped: 1, queued: 0, flushed: 0, blocked: 0 });
+export const QUEUED_FACTS = Object.freeze({ applied: 0, dropped: 0, queued: 1, flushed: 0, blocked: 0 });
+export const FLUSHED_FACTS = Object.freeze({ applied: 1, dropped: 0, queued: 0, flushed: 1, blocked: 0 });
+export const BLOCKED_FACTS = Object.freeze({ applied: 0, dropped: 0, queued: 0, flushed: 0, blocked: 1 });
+//# sourceMappingURL=facts.js.map

package/dist/policy/facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.js","sourceRoot":"","sources":["../../src/policy/facts.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,CAAC,MAAM,aAAa,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1H,MAAM,CAAC,MAAM,aAAa,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1H,MAAM,CAAC,MAAM,YAAY,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AACzH,MAAM,CAAC,MAAM,aAAa,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1H,MAAM,CAAC,MAAM,aAAa,GAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/policy/strategies/accumulate.d.ts

@@ -0,0 +1,13 @@
+import type { Engine } from "../../engine/types";
+import type { Money, MoneyState } from "../../money/types";
+import type { Emitter } from "../emitter";
+import type { MoneyEvent, TickPolicy, TickResult } from "../types";
+export declare function applyAccumulatePolicy<N, U extends string>(args: {
+    E: Engine<N>;
+    state: MoneyState<N, U>;
+    delta: Money<N, any>;
+    policy: TickPolicy;
+    emit?: Emitter<MoneyEvent<N>>;
+    collectEvents: boolean;
+    collectFacts?: boolean;
+}): TickResult<N, U>;

package/dist/policy/strategies/accumulate.js

@@ -0,0 +1,67 @@
+import { computeLogGap, isTooSmall } from "./shared";
+import { APPLIED_FACTS, FLUSHED_FACTS, QUEUED_FACTS } from "../facts";
+export function applyAccumulatePolicy(args) {
+    const { E, state, delta, policy, emit, collectEvents, collectFacts } = args;
+    const events = [];
+    const baseBefore = state.money.amount;
+    const bucketed = E.add(state.bucket, delta.amount);
+    const logGap = computeLogGap(E, baseBefore, bucketed);
+    if (isTooSmall(E, baseBefore, bucketed, policy.maxLogGap, logGap)) {
+        const nextState = {
+            money: state.money,
+            bucket: bucketed,
+        };
+        if (collectEvents) {
+            events.push({
+                type: "queued",
+                base: baseBefore,
+                delta: delta.amount,
+                bucketAfter: bucketed,
+                logGap,
+                reason: "tooSmall",
+            });
+        }
+        const result = collectFacts
+            ? { status: "ok", state: nextState, events, facts: QUEUED_FACTS }
+            : { status: "ok", state: nextState, events };
+        if (collectEvents && emit)
+            emit(events);
+        return result;
+    }
+    const baseAfter = E.add(baseBefore, bucketed);
+    const nextState = {
+        money: {
+            unit: state.money.unit,
+            amount: baseAfter,
+        },
+        bucket: E.zero(),
+    };
+    const flushed = (collectEvents || collectFacts) && E.cmp(state.bucket, E.zero()) !== 0;
+    if (collectEvents) {
+        if (flushed) {
+            events.push({
+                type: "flushed",
+                baseBefore,
+                baseAfter,
+                bucketFlushed: state.bucket,
+                reason: "becameSignificant",
+            });
+        }
+        events.push({
+            type: "applied",
+            baseBefore,
+            baseAfter,
+            delta: bucketed,
+            logGap: Number.isFinite(logGap) ? logGap : undefined,
+        });
+    }
+    const result = collectFacts
+        ? (flushed
+            ? { status: "ok", state: nextState, events, facts: FLUSHED_FACTS, appliedDelta: bucketed, flushedBucket: state.bucket }
+            : { status: "ok", state: nextState, events, facts: APPLIED_FACTS, appliedDelta: bucketed })
+        : { status: "ok", state: nextState, events };
+    if (collectEvents && emit)
+        emit(events);
+    return result;
+}
+//# sourceMappingURL=accumulate.js.map

package/dist/policy/strategies/accumulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accumulate.js","sourceRoot":"","sources":["../../../src/policy/strategies/accumulate.ts"],"names":[],"mappings":"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"}

package/dist/policy/strategies/drop.d.ts

@@ -0,0 +1,13 @@
+import type { Engine } from "../../engine/types";
+import type { Money, MoneyState } from "../../money/types";
+import type { Emitter } from "../emitter";
+import type { MoneyEvent, TickPolicy, TickResult } from "../types";
+export declare function applyDropPolicy<N, U extends string>(args: {
+    E: Engine<N>;
+    state: MoneyState<N, U>;
+    delta: Money<N, any>;
+    policy: TickPolicy;
+    emit?: Emitter<MoneyEvent<N>>;
+    collectEvents: boolean;
+    collectFacts?: boolean;
+}): TickResult<N, U>;

package/dist/policy/strategies/drop.js

@@ -0,0 +1,49 @@
+import { computeLogGap, isTooSmall } from "./shared";
+import { APPLIED_FACTS, DROPPED_FACTS } from "../facts";
+export function applyDropPolicy(args) {
+    const { E, state, delta, policy, emit, collectEvents, collectFacts } = args;
+    const events = [];
+    const baseBefore = state.money.amount;
+    const logGap = computeLogGap(E, baseBefore, delta.amount);
+    if (isTooSmall(E, baseBefore, delta.amount, policy.maxLogGap, logGap)) {
+        if (collectEvents) {
+            events.push({
+                type: "dropped",
+                base: baseBefore,
+                delta: delta.amount,
+                logGap,
+                reason: "tooSmall",
+            });
+        }
+        const result = collectFacts
+            ? { status: "ok", state, events, facts: DROPPED_FACTS }
+            : { status: "ok", state, events };
+        if (collectEvents && emit)
+            emit(events);
+        return result;
+    }
+    const baseAfter = E.add(baseBefore, delta.amount);
+    const nextState = {
+        money: {
+            unit: state.money.unit,
+            amount: baseAfter,
+        },
+        bucket: E.zero(),
+    };
+    if (collectEvents) {
+        events.push({
+            type: "applied",
+            baseBefore,
+            baseAfter,
+            delta: delta.amount,
+            logGap: Number.isFinite(logGap) ? logGap : undefined,
+        });
+    }
+    const result = collectFacts
+        ? { status: "ok", state: nextState, events, facts: APPLIED_FACTS, appliedDelta: delta.amount }
+        : { status: "ok", state: nextState, events };
+    if (collectEvents && emit)
+        emit(events);
+    return result;
+}
+//# sourceMappingURL=drop.js.map

package/dist/policy/strategies/drop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.js","sourceRoot":"","sources":["../../../src/policy/strategies/drop.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,UAAU,eAAe,CAAsB,IAQpD;IACC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAC5E,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE1D,IAAI,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;QACtE,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,MAAM;gBACN,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,MAAM,GAAqB,YAAY;YAC3C,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE;YACvD,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QACpC,IAAI,aAAa,IAAI,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,SAAS,GAAqB;QAClC,KAAK,EAAE;YACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YACtB,MAAM,EAAE,SAAS;SAClB;QACD,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE;KACjB,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,SAAS;YACf,UAAU;YACV,SAAS;YACT,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAqB,YAAY;QAC3C,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE;QAC9F,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/C,IAAI,aAAa,IAAI,IAAI;QAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/policy/strategies/shared.d.ts

@@ -0,0 +1,3 @@
+import type { Engine } from "../../engine/types";
+export declare function computeLogGap<N>(E: Engine<N>, base: N, delta: N): number;
+export declare function isTooSmall<N>(E: Engine<N>, base: N, delta: N, maxLogGap?: number, knownGap?: number): boolean;

package/dist/policy/strategies/shared.js

@@ -0,0 +1,15 @@
+export function computeLogGap(E, base, delta) {
+    const zero = E.zero();
+    if (E.cmp(base, zero) <= 0)
+        return -Infinity;
+    if (E.cmp(delta, zero) === 0)
+        return Infinity;
+    return E.absLog10(base) - E.absLog10(delta);
+}
+export function isTooSmall(E, base, delta, maxLogGap, knownGap) {
+    if (maxLogGap === undefined)
+        return false;
+    const gap = knownGap ?? computeLogGap(E, base, delta);
+    return Number.isFinite(gap) && gap > maxLogGap;
+}
+//# sourceMappingURL=shared.js.map

package/dist/policy/strategies/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/policy/strategies/shared.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAI,CAAY,EAAE,IAAO,EAAE,KAAQ;IAC9D,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,QAAQ,CAAC;IAC7C,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,CAAY,EAAE,IAAO,EAAE,KAAQ,EAAE,SAAkB,EAAE,QAAiB;IAClG,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,GAAG,GAAG,QAAQ,IAAI,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,SAAS,CAAC;AACjD,CAAC"}

package/dist/policy/tickMoney.d.ts

@@ -0,0 +1,12 @@
+import type { Engine } from "../engine/types";
+import type { Money, MoneyState } from "../money/types";
+import type { CoreOptions, MoneyEvent, TickPolicy, TickResult } from "./types";
+import type { Emitter } from "./emitter";
+export declare function tickMoney<N, U extends string>(args: {
+    E: Engine<N>;
+    state: MoneyState<N, U>;
+    delta: Money<N, any>;
+    policy: TickPolicy;
+    emit?: Emitter<MoneyEvent<N>>;
+    options?: CoreOptions;
+}): TickResult<N, U>;

package/dist/policy/tickMoney.js

@@ -0,0 +1,36 @@
+import { applyAccumulatePolicy } from "./strategies/accumulate";
+import { applyDropPolicy } from "./strategies/drop";
+import { BLOCKED_FACTS } from "./facts";
+export function tickMoney(args) {
+    const { E, state, delta, policy, emit } = args;
+    const collectEvents = args.options?.collectEvents ?? true;
+    const collectFacts = args.options?.collectFacts ?? false;
+    const events = [];
+    if (state.money.unit.code !== delta.unit.code) {
+        if (collectEvents) {
+            events.push({
+                type: "blocked",
+                reason: "unitMismatch",
+                baseUnit: state.money.unit.code,
+                deltaUnit: delta.unit.code,
+            });
+        }
+        const result = collectFacts ? {
+            status: "blocked",
+            state,
+            events,
+            facts: BLOCKED_FACTS,
+        } : {
+            status: "blocked",
+            state,
+            events,
+        };
+        if (collectEvents && emit)
+            emit(events);
+        return result;
+    }
+    return policy.mode === "drop"
+        ? applyDropPolicy({ E, state, delta, policy, emit, collectEvents, collectFacts })
+        : applyAccumulatePolicy({ E, state, delta, policy, emit, collectEvents, collectFacts });
+}
+//# sourceMappingURL=tickMoney.js.map

package/dist/policy/tickMoney.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickMoney.js","sourceRoot":"","sources":["../../src/policy/tickMoney.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,UAAU,SAAS,CAAsB,IAO9C;IACC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;IAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,IAAI,IAAI,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,IAAI,KAAK,CAAC;IACzD,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,cAAc;gBACtB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;gBAC/B,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAqB,YAAY,CAAC,CAAC,CAAC;YAC9C,MAAM,EAAE,SAAS;YACjB,KAAK;YACL,MAAM;YACN,KAAK,EAAE,aAAa;SACrB,CAAC,CAAC,CAAC;YACF,MAAM,EAAE,SAAS;YACjB,KAAK;YACL,MAAM;SACP,CAAC;QAEF,IAAI,aAAa,IAAI,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM;QAC3B,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;QACjF,CAAC,CAAC,qBAAqB,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/policy/types.d.ts

@@ -0,0 +1,60 @@
+import type { MoneyState } from "../money/types";
+export type TickPolicy = Readonly<{
+    mode: "drop" | "accumulate";
+    maxLogGap?: number;
+}>;
+export type CoreOptions = Readonly<{
+    collectEvents?: boolean;
+    /** Compact event counts and reward amounts, independent of event retention. */
+    collectFacts?: boolean;
+}>;
+export type MoneyEvent<N> = {
+    type: "blocked";
+    reason: "unitMismatch";
+    baseUnit: string;
+    deltaUnit: string;
+} | {
+    type: "applied";
+    baseBefore: N;
+    baseAfter: N;
+    delta: N;
+    logGap?: number;
+} | {
+    type: "dropped";
+    base: N;
+    delta: N;
+    logGap: number;
+    reason: "tooSmall";
+} | {
+    type: "queued";
+    base: N;
+    delta: N;
+    bucketAfter: N;
+    logGap: number;
+    reason: "tooSmall";
+} | {
+    type: "flushed";
+    baseBefore: N;
+    baseAfter: N;
+    bucketFlushed: N;
+    reason: "becameSignificant";
+};
+export type TickStatus = "ok" | "blocked";
+export type TickFactCounts = Readonly<{
+    applied: number;
+    dropped: number;
+    queued: number;
+    flushed: number;
+    blocked: number;
+}>;
+export type TickResult<N, U extends string> = Readonly<{
+    status: TickStatus;
+    state: MoneyState<N, U>;
+    events: readonly MoneyEvent<N>[];
+    /** Present only when collectFacts is requested. Counts match the full event stream. */
+    facts?: TickFactCounts;
+    /** The applied event's delta, including queued money in accumulate mode. */
+    appliedDelta?: N;
+    /** The flushed event's prior bucket, when that event occurs. */
+    flushedBucket?: N;
+}>;

package/dist/policy/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/policy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/policy/types.ts"],"names":[],"mappings":""}

package/dist/serde/moneyState.d.ts

@@ -0,0 +1,20 @@
+import type { Engine } from "../engine/types";
+import type { MoneyState, Unit } from "../money/types";
+export type MoneyStateJSON = Readonly<{
+    v: 1;
+    unit: string;
+    amount: string;
+    bucket: string;
+    engine?: Readonly<{
+        name: string;
+        version?: string;
+    }>;
+}>;
+export declare function serializeMoneyState<N, U extends string>(E: Engine<N>, state: MoneyState<N, U>, meta?: {
+    engineName?: string;
+    engineVersion?: string;
+}): MoneyStateJSON;
+export declare function deserializeMoneyState<N, U extends string>(E: Engine<N>, json: MoneyStateJSON, opts?: {
+    unitFactory?: (code: string) => Unit<U>;
+    allowFutureVersions?: boolean;
+}): MoneyState<N, U>;

package/dist/serde/moneyState.js

@@ -0,0 +1,30 @@
+export function serializeMoneyState(E, state, meta) {
+    return {
+        v: 1,
+        unit: state.money.unit.code,
+        amount: E.toString(state.money.amount),
+        bucket: E.toString(state.bucket),
+        engine: meta?.engineName
+            ? {
+                name: meta.engineName,
+                version: meta.engineVersion,
+            }
+            : undefined,
+    };
+}
+export function deserializeMoneyState(E, json, opts) {
+    if (json.v !== 1 && !opts?.allowFutureVersions) {
+        throw new Error(`Unsupported money state version: ${json.v}`);
+    }
+    const unit = opts?.unitFactory
+        ? opts.unitFactory(json.unit)
+        : { code: json.unit };
+    return {
+        money: {
+            unit,
+            amount: E.from(json.amount),
+        },
+        bucket: E.from(json.bucket),
+    };
+}
+//# sourceMappingURL=moneyState.js.map

package/dist/serde/moneyState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moneyState.js","sourceRoot":"","sources":["../../src/serde/moneyState.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,mBAAmB,CACjC,CAAY,EACZ,KAAuB,EACvB,IAAsD;IAEtD,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;QAC3B,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACtC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAChC,MAAM,EAAE,IAAI,EAAE,UAAU;YACtB,CAAC,CAAC;gBACE,IAAI,EAAE,IAAI,CAAC,UAAU;gBACrB,OAAO,EAAE,IAAI,CAAC,aAAa;aAC5B;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,CAAY,EACZ,IAAoB,EACpB,IAGC;IAED,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,EAAE,WAAW;QAC5B,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,CAAC,CAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAS,EAAqB,CAAC;IAEjD,OAAO;QACL,KAAK,EAAE;YACL,IAAI;YACJ,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;SAC5B;QACD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "@idlekit/money",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Bun-first money primitives, notation, policies, and serialization for idle game economies.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/imjlk/idlekit.git",
+    "directory": "packages/money"
+  },
+  "homepage": "https://github.com/imjlk/idlekit/tree/main/packages/money#readme",
+  "bugs": {
+    "url": "https://github.com/imjlk/idlekit/issues"
+  },
+  "keywords": [
+    "bun",
+    "idle-game",
+    "incremental-game",
+    "money",
+    "economy",
+    "currency",
+    "big-number"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "bun": ">=1.4.2"
+  },
+  "scripts": {
+    "build": "rm -rf dist && ttsc -p tsconfig.build.json",
+    "typecheck": "ttsc -p tsconfig.json --noEmit",
+    "test": "bun test src",
+    "prepack": "bun run build && cd ../.. && bun tools/package-manifest.ts prepare packages/money",
+    "postpack": "cd ../.. && bun tools/package-manifest.ts restore packages/money"
+  },
+  "dependencies": {
+    "break_infinity.js": "^2.2.0"
+  }
+}