@lacspace/money 1.0.0

package/LICENSE

@@ -0,0 +1,51 @@
+Lacspace Free Licence
+Version 1.0, August 2026
+
+Copyright (c) 2026 Lacspace
+
+PREAMBLE
+
+This software is published by Lacspace under the Lacspace Free Licence — a free,
+permissive licence that lets you use this software for any purpose, including in
+commercial products and services, at no cost. It grants the same freedoms as
+common permissive open-source licences; the only condition is that this notice
+travels with the software. The canonical, always-current text of this licence is
+maintained at https://lacspace.com/licenses/lacspace-free-1.0
+
+GRANT OF RIGHTS
+
+Permission is hereby granted, free of charge, to any person or organisation
+obtaining a copy of this software and its associated documentation and data 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 conditions below. These rights are
+granted for any purpose, personal or commercial, and are perpetual, worldwide,
+non-exclusive, and royalty-free.
+
+CONDITIONS
+
+The above copyright notice, this permission notice, and the name of this licence
+("Lacspace Free Licence") shall be included in all copies or substantial portions
+of the Software.
+
+TRADEMARKS
+
+This licence does not grant permission to use the trade names, trademarks, service
+marks, logos, or product names of Lacspace, except as required to reproduce the
+notice above or to describe the origin of the Software in a truthful manner.
+
+DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
+
+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.
+
+---
+
+The Lacspace Free Licence is a source-available, permissive licence and is not (as
+of this version) an OSI-approved licence. In substance it grants the same freedoms
+as the MIT Licence. Learn more at https://lacspace.com/licenses

package/README.md

@@ -0,0 +1,75 @@
+<div align="center">
+
+# @lacspace/money
+
+**Money without the floating-point bugs — integer cents, safe math, localized formatting.**
+
+[![npm version](https://img.shields.io/npm/v/@lacspace/money?color=%2316a34a&label=npm)](https://www.npmjs.com/package/@lacspace/money)
+[![license](https://img.shields.io/npm/l/@lacspace/money?color=green)](https://github.com/lacspace/npm-packages/blob/main/LICENSE)
+
+</div>
+
+> `0.1 + 0.2 !== 0.3` — so never store money as a float. `@lacspace/money` keeps amounts as **integer minor units**, refuses to add different currencies, splits a bill without losing a cent, and formats with `Intl`. Tiny, typed, isomorphic.
+
+## Install
+
+```bash
+npm i @lacspace/money
+```
+
+## Use it
+
+```ts
+import { money, Money } from "@lacspace/money";
+
+const price = money(19.99, "USD");   // 1999 minor units, exact
+price.multiply(3).format();          // "$59.97"
+price.add(money(5, "USD"));          // $24.99
+money(9.99, "USD").add(money(1, "EUR")); // ❌ throws: currency mismatch
+
+// Split a bill three ways — the cent doesn't vanish
+money(10, "USD").allocate([1, 1, 1]).map((m) => m.format());
+// ["$3.34", "$3.33", "$3.33"]   (sum is exactly $10.00)
+
+// Zero-decimal & 3-decimal currencies handled automatically
+money(1000, "JPY").format("ja-JP"); // "￥1,000"
+money(1.5, "BHD").toMinor();        // 1500  (BHD has 3 decimals)
+```
+
+## Why minor units
+
+```ts
+Money.fromMinor(1999, "USD");   // exact, no rounding surprises
+Money.of(19.99, "USD");         // convenience: rounds major → minor once
+money(19.99, "USD").toMinor();  // 1999
+```
+
+## API
+
+| | |
+| --- | --- |
+| `money(major, ccy)` / `Money.of` / `Money.fromMinor` / `Money.zero` / `Money.parse` | construct |
+| `.add` · `.subtract` · `.multiply` · `.divide` · `.negate` · `.abs` | arithmetic (currency-checked) |
+| `.allocate(ratios)` · `.split(n)` | remainder-preserving distribution |
+| `.equals` · `.greaterThan` · `.lessThan` · `.greaterThanOrEqual` · `.lessThanOrEqual` | compare |
+| `.isZero` · `.isPositive` · `.isNegative` | predicates |
+| `.format(locale?, opts?)` · `.toString` · `.toMajor` · `.toMinor` · `.toJSON` | output |
+| `sumMoney(list, ccy?)` · `decimalsFor(ccy)` | helpers |
+
+All operations return a new `Money` — instances are immutable.
+
+## Licensing
+
+Free under the **[Lacspace Free Licence](https://lacspace.com/licenses/lacspace-free-1.0)** — MIT-equivalent freedoms. Use it in personal and commercial projects at no cost; just keep the notice. See the **[Lacspace Licence Centre](https://lacspace.com/licenses)**.
+
+---
+
+<div align="center">
+
+**Part of the Lacspace ecosystem — zero-dependency, isomorphic TypeScript packages.**
+
+[All packages ↗](https://lacspace.com/packages) · [npm org ↗](https://www.npmjs.com/org/lacspace) · [Licence Centre ↗](https://lacspace.com/licenses) · [GitHub ↗](https://github.com/lacspace/npm-packages)
+
+</div>
+
+<div align="center"><sub>Built with care by <a href="https://lacspace.com">Lacspace</a> · Lacspace Free Licence · <a href="https://github.com/lacspace/npm-packages">source</a></sub></div>

package/dist/index.cjs

@@ -0,0 +1,208 @@
+'use strict';
+
+// src/index.ts
+var EXPONENTS = {
+  JPY: 0,
+  KRW: 0,
+  VND: 0,
+  CLP: 0,
+  ISK: 0,
+  HUF: 0,
+  XAF: 0,
+  XOF: 0,
+  XPF: 0,
+  RWF: 0,
+  UGX: 0,
+  GNF: 0,
+  BHD: 3,
+  KWD: 3,
+  OMR: 3,
+  TND: 3,
+  IQD: 3,
+  JOD: 3,
+  LYD: 3
+};
+function decimalsFor(currency) {
+  return EXPONENTS[currency.toUpperCase()] ?? 2;
+}
+function factorFor(currency) {
+  return Math.pow(10, decimalsFor(currency));
+}
+function roundHalfUp(n) {
+  return n < 0 ? -Math.round(-n) : Math.round(n);
+}
+var Money = class _Money {
+  constructor(minor, currency) {
+    if (!Number.isInteger(minor)) {
+      throw new TypeError(`Money amount must be an integer number of minor units, got ${minor}`);
+    }
+    this.amount = minor;
+    this.currency = currency.toUpperCase();
+  }
+  /** From major units: `Money.of(19.99, "USD")` → 1999 minor units. */
+  static of(major, currency) {
+    return new _Money(roundHalfUp(major * factorFor(currency)), currency);
+  }
+  /** From an integer count of minor units: `Money.fromMinor(1999, "USD")`. */
+  static fromMinor(minor, currency) {
+    return new _Money(minor, currency);
+  }
+  /** Zero in a currency. */
+  static zero(currency) {
+    return new _Money(0, currency);
+  }
+  /**
+   * Parse a formatted string like "$1,234.56" or "1.234,56" (best-effort).
+   * Non-digits except the last separator group are stripped.
+   */
+  static parse(input, currency) {
+    const cleaned = input.replace(/[^\d.,-]/g, "").trim();
+    if (!cleaned) throw new Error(`Cannot parse money from "${input}"`);
+    const neg = /^-/.test(cleaned) || /-\d/.test(cleaned);
+    let s = cleaned.replace(/-/g, "");
+    const lastDot = s.lastIndexOf(".");
+    const lastComma = s.lastIndexOf(",");
+    let decSep = "";
+    if (lastDot >= 0 && lastComma >= 0) decSep = lastDot > lastComma ? "." : ",";
+    else if (lastDot >= 0) decSep = ".";
+    else if (lastComma >= 0) decSep = ",";
+    let major;
+    if (decSep) {
+      const thousandsSep = decSep === "." ? "," : ".";
+      s = s.split(thousandsSep).join("");
+      major = Number(s.replace(decSep, "."));
+    } else {
+      major = Number(s);
+    }
+    if (Number.isNaN(major)) throw new Error(`Cannot parse money from "${input}"`);
+    return _Money.of(neg ? -major : major, currency);
+  }
+  assertSame(other) {
+    if (other.currency !== this.currency) {
+      throw new Error(`Currency mismatch: ${this.currency} vs ${other.currency}`);
+    }
+  }
+  add(other) {
+    this.assertSame(other);
+    return new _Money(this.amount + other.amount, this.currency);
+  }
+  subtract(other) {
+    this.assertSame(other);
+    return new _Money(this.amount - other.amount, this.currency);
+  }
+  /** Multiply by a scalar (e.g. quantity or tax rate), rounding to whole minor units. */
+  multiply(factor) {
+    return new _Money(roundHalfUp(this.amount * factor), this.currency);
+  }
+  /** Divide by a scalar, rounding to whole minor units. */
+  divide(divisor) {
+    if (divisor === 0) throw new Error("Division by zero");
+    return new _Money(roundHalfUp(this.amount / divisor), this.currency);
+  }
+  negate() {
+    return new _Money(-this.amount, this.currency);
+  }
+  abs() {
+    return new _Money(Math.abs(this.amount), this.currency);
+  }
+  /**
+   * Split into parts by integer ratios, distributing leftover minor units to the
+   * earliest parts so the sum always equals the original (no cent lost/created).
+   * `money(10,"USD").allocate([1,1,1])` → 3.34, 3.33, 3.33.
+   */
+  allocate(ratios) {
+    if (ratios.length === 0) throw new Error("allocate() needs at least one ratio");
+    if (ratios.some((r) => r < 0)) throw new Error("allocate() ratios must be non-negative");
+    const total = ratios.reduce((a, b) => a + b, 0);
+    if (total === 0) throw new Error("allocate() ratios must not all be zero");
+    const shares = ratios.map((r) => Math.floor(this.amount * r / total));
+    let remainder = this.amount - shares.reduce((a, b) => a + b, 0);
+    const order = ratios.map((r, i) => ({ r, i })).sort((a, b) => b.r - a.r);
+    let k = 0;
+    while (remainder > 0) {
+      shares[order[k % order.length].i] += 1;
+      remainder--;
+      k++;
+    }
+    return shares.map((s) => new _Money(s, this.currency));
+  }
+  /** Split evenly into `n` parts, distributing the remainder fairly. */
+  split(n) {
+    if (!Number.isInteger(n) || n <= 0) throw new Error("split() needs a positive integer");
+    return this.allocate(new Array(n).fill(1));
+  }
+  equals(other) {
+    return this.currency === other.currency && this.amount === other.amount;
+  }
+  greaterThan(other) {
+    this.assertSame(other);
+    return this.amount > other.amount;
+  }
+  lessThan(other) {
+    this.assertSame(other);
+    return this.amount < other.amount;
+  }
+  greaterThanOrEqual(other) {
+    this.assertSame(other);
+    return this.amount >= other.amount;
+  }
+  lessThanOrEqual(other) {
+    this.assertSame(other);
+    return this.amount <= other.amount;
+  }
+  isZero() {
+    return this.amount === 0;
+  }
+  isPositive() {
+    return this.amount > 0;
+  }
+  isNegative() {
+    return this.amount < 0;
+  }
+  /** The value in major units as a number (e.g. 19.99). Beware float for display — prefer format(). */
+  toMajor() {
+    return this.amount / factorFor(this.currency);
+  }
+  /** The raw integer minor-unit amount. */
+  toMinor() {
+    return this.amount;
+  }
+  /** Localized currency string, e.g. "$1,234.56" / "€1.234,56". */
+  format(locale, options) {
+    const decimals = decimalsFor(this.currency);
+    try {
+      return new Intl.NumberFormat(locale, {
+        style: "currency",
+        currency: this.currency,
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+        ...options
+      }).format(this.toMajor());
+    } catch {
+      return `${this.toMajor().toFixed(decimals)} ${this.currency}`;
+    }
+  }
+  toString() {
+    return this.format();
+  }
+  toJSON() {
+    return { amount: this.amount, currency: this.currency };
+  }
+};
+function money(major, currency) {
+  return Money.of(major, currency);
+}
+function sumMoney(items, currency) {
+  if (items.length === 0) {
+    if (!currency) throw new Error("sumMoney() of an empty list needs a currency");
+    return Money.zero(currency);
+  }
+  return items.reduce((acc, m) => acc.add(m));
+}
+
+exports.Money = Money;
+exports.decimalsFor = decimalsFor;
+exports.money = money;
+exports.sumMoney = sumMoney;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @lacspace/money\n * Money done right — integer minor units (no floating-point cents bugs),\n * currency-safe arithmetic, remainder-preserving allocation, and localized\n * formatting via `Intl`.\n *\n * ```ts\n * import { money } from \"@lacspace/money\";\n *\n * const price = money(19.99, \"USD\");      // 1999 minor units\n * const total = price.multiply(3);        // $59.97, exact\n * total.format();                          // \"$59.97\"\n * money(10, \"USD\").allocate([1, 1, 1]);    // [$3.34, $3.33, $3.33] — no cent lost\n * ```\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\n/** Minor-unit exponents for currencies that aren't the default 2. */\nconst EXPONENTS: Record<string, number> = {\n  JPY: 0, KRW: 0, VND: 0, CLP: 0, ISK: 0, HUF: 0, XAF: 0, XOF: 0, XPF: 0, RWF: 0, UGX: 0, GNF: 0,\n  BHD: 3, KWD: 3, OMR: 3, TND: 3, IQD: 3, JOD: 3, LYD: 3,\n};\n\n/** How many minor units are in one major unit for a currency (e.g. 100 for USD). */\nexport function decimalsFor(currency: string): number {\n  return EXPONENTS[currency.toUpperCase()] ?? 2;\n}\n\nfunction factorFor(currency: string): number {\n  return Math.pow(10, decimalsFor(currency));\n}\n\n/** Round half away from zero — the intuitive rule for money. */\nfunction roundHalfUp(n: number): number {\n  return n < 0 ? -Math.round(-n) : Math.round(n);\n}\n\nexport class Money {\n  /** Integer amount in minor units (e.g. cents). */\n  readonly amount: number;\n  /** ISO 4217 code, upper-cased. */\n  readonly currency: string;\n\n  private constructor(minor: number, currency: string) {\n    if (!Number.isInteger(minor)) {\n      throw new TypeError(`Money amount must be an integer number of minor units, got ${minor}`);\n    }\n    this.amount = minor;\n    this.currency = currency.toUpperCase();\n  }\n\n  /** From major units: `Money.of(19.99, \"USD\")` → 1999 minor units. */\n  static of(major: number, currency: string): Money {\n    return new Money(roundHalfUp(major * factorFor(currency)), currency);\n  }\n\n  /** From an integer count of minor units: `Money.fromMinor(1999, \"USD\")`. */\n  static fromMinor(minor: number, currency: string): Money {\n    return new Money(minor, currency);\n  }\n\n  /** Zero in a currency. */\n  static zero(currency: string): Money {\n    return new Money(0, currency);\n  }\n\n  /**\n   * Parse a formatted string like \"$1,234.56\" or \"1.234,56\" (best-effort).\n   * Non-digits except the last separator group are stripped.\n   */\n  static parse(input: string, currency: string): Money {\n    const cleaned = input.replace(/[^\\d.,-]/g, \"\").trim();\n    if (!cleaned) throw new Error(`Cannot parse money from \"${input}\"`);\n    const neg = /^-/.test(cleaned) || /-\\d/.test(cleaned);\n    let s = cleaned.replace(/-/g, \"\");\n    // Decide the decimal separator: whichever of . or , comes last.\n    const lastDot = s.lastIndexOf(\".\");\n    const lastComma = s.lastIndexOf(\",\");\n    let decSep = \"\";\n    if (lastDot >= 0 && lastComma >= 0) decSep = lastDot > lastComma ? \".\" : \",\";\n    else if (lastDot >= 0) decSep = \".\";\n    else if (lastComma >= 0) decSep = \",\";\n    let major: number;\n    if (decSep) {\n      const thousandsSep = decSep === \".\" ? \",\" : \".\";\n      s = s.split(thousandsSep).join(\"\");\n      major = Number(s.replace(decSep, \".\"));\n    } else {\n      major = Number(s);\n    }\n    if (Number.isNaN(major)) throw new Error(`Cannot parse money from \"${input}\"`);\n    return Money.of(neg ? -major : major, currency);\n  }\n\n  private assertSame(other: Money): void {\n    if (other.currency !== this.currency) {\n      throw new Error(`Currency mismatch: ${this.currency} vs ${other.currency}`);\n    }\n  }\n\n  add(other: Money): Money {\n    this.assertSame(other);\n    return new Money(this.amount + other.amount, this.currency);\n  }\n\n  subtract(other: Money): Money {\n    this.assertSame(other);\n    return new Money(this.amount - other.amount, this.currency);\n  }\n\n  /** Multiply by a scalar (e.g. quantity or tax rate), rounding to whole minor units. */\n  multiply(factor: number): Money {\n    return new Money(roundHalfUp(this.amount * factor), this.currency);\n  }\n\n  /** Divide by a scalar, rounding to whole minor units. */\n  divide(divisor: number): Money {\n    if (divisor === 0) throw new Error(\"Division by zero\");\n    return new Money(roundHalfUp(this.amount / divisor), this.currency);\n  }\n\n  negate(): Money {\n    return new Money(-this.amount, this.currency);\n  }\n\n  abs(): Money {\n    return new Money(Math.abs(this.amount), this.currency);\n  }\n\n  /**\n   * Split into parts by integer ratios, distributing leftover minor units to the\n   * earliest parts so the sum always equals the original (no cent lost/created).\n   * `money(10,\"USD\").allocate([1,1,1])` → 3.34, 3.33, 3.33.\n   */\n  allocate(ratios: number[]): Money[] {\n    if (ratios.length === 0) throw new Error(\"allocate() needs at least one ratio\");\n    if (ratios.some((r) => r < 0)) throw new Error(\"allocate() ratios must be non-negative\");\n    const total = ratios.reduce((a, b) => a + b, 0);\n    if (total === 0) throw new Error(\"allocate() ratios must not all be zero\");\n    const shares = ratios.map((r) => Math.floor((this.amount * r) / total));\n    let remainder = this.amount - shares.reduce((a, b) => a + b, 0);\n    // Hand out the remaining units one at a time to the parts with the biggest ratio.\n    const order = ratios.map((r, i) => ({ r, i })).sort((a, b) => b.r - a.r);\n    let k = 0;\n    while (remainder > 0) {\n      shares[order[k % order.length]!.i]! += 1;\n      remainder--;\n      k++;\n    }\n    return shares.map((s) => new Money(s, this.currency));\n  }\n\n  /** Split evenly into `n` parts, distributing the remainder fairly. */\n  split(n: number): Money[] {\n    if (!Number.isInteger(n) || n <= 0) throw new Error(\"split() needs a positive integer\");\n    return this.allocate(new Array(n).fill(1));\n  }\n\n  equals(other: Money): boolean {\n    return this.currency === other.currency && this.amount === other.amount;\n  }\n  greaterThan(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount > other.amount;\n  }\n  lessThan(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount < other.amount;\n  }\n  greaterThanOrEqual(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount >= other.amount;\n  }\n  lessThanOrEqual(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount <= other.amount;\n  }\n  isZero(): boolean {\n    return this.amount === 0;\n  }\n  isPositive(): boolean {\n    return this.amount > 0;\n  }\n  isNegative(): boolean {\n    return this.amount < 0;\n  }\n\n  /** The value in major units as a number (e.g. 19.99). Beware float for display — prefer format(). */\n  toMajor(): number {\n    return this.amount / factorFor(this.currency);\n  }\n\n  /** The raw integer minor-unit amount. */\n  toMinor(): number {\n    return this.amount;\n  }\n\n  /** Localized currency string, e.g. \"$1,234.56\" / \"€1.234,56\". */\n  format(locale?: string, options?: Intl.NumberFormatOptions): string {\n    const decimals = decimalsFor(this.currency);\n    try {\n      return new Intl.NumberFormat(locale, {\n        style: \"currency\",\n        currency: this.currency,\n        minimumFractionDigits: decimals,\n        maximumFractionDigits: decimals,\n        ...options,\n      }).format(this.toMajor());\n    } catch {\n      // Unknown currency to Intl — fall back to a plain number + code.\n      return `${this.toMajor().toFixed(decimals)} ${this.currency}`;\n    }\n  }\n\n  toString(): string {\n    return this.format();\n  }\n\n  toJSON(): { amount: number; currency: string } {\n    return { amount: this.amount, currency: this.currency };\n  }\n}\n\n/** Friendly constructor from major units: `money(19.99, \"USD\")`. */\nexport function money(major: number, currency: string): Money {\n  return Money.of(major, currency);\n}\n\n/** Sum a list of Money (all same currency). Empty list requires a currency fallback. */\nexport function sumMoney(items: Money[], currency?: string): Money {\n  if (items.length === 0) {\n    if (!currency) throw new Error(\"sumMoney() of an empty list needs a currency\");\n    return Money.zero(currency);\n  }\n  return items.reduce((acc, m) => acc.add(m));\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,79 @@
+/**
+ * @lacspace/money
+ * Money done right — integer minor units (no floating-point cents bugs),
+ * currency-safe arithmetic, remainder-preserving allocation, and localized
+ * formatting via `Intl`.
+ *
+ * ```ts
+ * import { money } from "@lacspace/money";
+ *
+ * const price = money(19.99, "USD");      // 1999 minor units
+ * const total = price.multiply(3);        // $59.97, exact
+ * total.format();                          // "$59.97"
+ * money(10, "USD").allocate([1, 1, 1]);    // [$3.34, $3.33, $3.33] — no cent lost
+ * ```
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+/** How many minor units are in one major unit for a currency (e.g. 100 for USD). */
+declare function decimalsFor(currency: string): number;
+declare class Money {
+    /** Integer amount in minor units (e.g. cents). */
+    readonly amount: number;
+    /** ISO 4217 code, upper-cased. */
+    readonly currency: string;
+    private constructor();
+    /** From major units: `Money.of(19.99, "USD")` → 1999 minor units. */
+    static of(major: number, currency: string): Money;
+    /** From an integer count of minor units: `Money.fromMinor(1999, "USD")`. */
+    static fromMinor(minor: number, currency: string): Money;
+    /** Zero in a currency. */
+    static zero(currency: string): Money;
+    /**
+     * Parse a formatted string like "$1,234.56" or "1.234,56" (best-effort).
+     * Non-digits except the last separator group are stripped.
+     */
+    static parse(input: string, currency: string): Money;
+    private assertSame;
+    add(other: Money): Money;
+    subtract(other: Money): Money;
+    /** Multiply by a scalar (e.g. quantity or tax rate), rounding to whole minor units. */
+    multiply(factor: number): Money;
+    /** Divide by a scalar, rounding to whole minor units. */
+    divide(divisor: number): Money;
+    negate(): Money;
+    abs(): Money;
+    /**
+     * Split into parts by integer ratios, distributing leftover minor units to the
+     * earliest parts so the sum always equals the original (no cent lost/created).
+     * `money(10,"USD").allocate([1,1,1])` → 3.34, 3.33, 3.33.
+     */
+    allocate(ratios: number[]): Money[];
+    /** Split evenly into `n` parts, distributing the remainder fairly. */
+    split(n: number): Money[];
+    equals(other: Money): boolean;
+    greaterThan(other: Money): boolean;
+    lessThan(other: Money): boolean;
+    greaterThanOrEqual(other: Money): boolean;
+    lessThanOrEqual(other: Money): boolean;
+    isZero(): boolean;
+    isPositive(): boolean;
+    isNegative(): boolean;
+    /** The value in major units as a number (e.g. 19.99). Beware float for display — prefer format(). */
+    toMajor(): number;
+    /** The raw integer minor-unit amount. */
+    toMinor(): number;
+    /** Localized currency string, e.g. "$1,234.56" / "€1.234,56". */
+    format(locale?: string, options?: Intl.NumberFormatOptions): string;
+    toString(): string;
+    toJSON(): {
+        amount: number;
+        currency: string;
+    };
+}
+/** Friendly constructor from major units: `money(19.99, "USD")`. */
+declare function money(major: number, currency: string): Money;
+/** Sum a list of Money (all same currency). Empty list requires a currency fallback. */
+declare function sumMoney(items: Money[], currency?: string): Money;
+
+export { Money, decimalsFor, money, sumMoney };

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @lacspace/money
+ * Money done right — integer minor units (no floating-point cents bugs),
+ * currency-safe arithmetic, remainder-preserving allocation, and localized
+ * formatting via `Intl`.
+ *
+ * ```ts
+ * import { money } from "@lacspace/money";
+ *
+ * const price = money(19.99, "USD");      // 1999 minor units
+ * const total = price.multiply(3);        // $59.97, exact
+ * total.format();                          // "$59.97"
+ * money(10, "USD").allocate([1, 1, 1]);    // [$3.34, $3.33, $3.33] — no cent lost
+ * ```
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+/** How many minor units are in one major unit for a currency (e.g. 100 for USD). */
+declare function decimalsFor(currency: string): number;
+declare class Money {
+    /** Integer amount in minor units (e.g. cents). */
+    readonly amount: number;
+    /** ISO 4217 code, upper-cased. */
+    readonly currency: string;
+    private constructor();
+    /** From major units: `Money.of(19.99, "USD")` → 1999 minor units. */
+    static of(major: number, currency: string): Money;
+    /** From an integer count of minor units: `Money.fromMinor(1999, "USD")`. */
+    static fromMinor(minor: number, currency: string): Money;
+    /** Zero in a currency. */
+    static zero(currency: string): Money;
+    /**
+     * Parse a formatted string like "$1,234.56" or "1.234,56" (best-effort).
+     * Non-digits except the last separator group are stripped.
+     */
+    static parse(input: string, currency: string): Money;
+    private assertSame;
+    add(other: Money): Money;
+    subtract(other: Money): Money;
+    /** Multiply by a scalar (e.g. quantity or tax rate), rounding to whole minor units. */
+    multiply(factor: number): Money;
+    /** Divide by a scalar, rounding to whole minor units. */
+    divide(divisor: number): Money;
+    negate(): Money;
+    abs(): Money;
+    /**
+     * Split into parts by integer ratios, distributing leftover minor units to the
+     * earliest parts so the sum always equals the original (no cent lost/created).
+     * `money(10,"USD").allocate([1,1,1])` → 3.34, 3.33, 3.33.
+     */
+    allocate(ratios: number[]): Money[];
+    /** Split evenly into `n` parts, distributing the remainder fairly. */
+    split(n: number): Money[];
+    equals(other: Money): boolean;
+    greaterThan(other: Money): boolean;
+    lessThan(other: Money): boolean;
+    greaterThanOrEqual(other: Money): boolean;
+    lessThanOrEqual(other: Money): boolean;
+    isZero(): boolean;
+    isPositive(): boolean;
+    isNegative(): boolean;
+    /** The value in major units as a number (e.g. 19.99). Beware float for display — prefer format(). */
+    toMajor(): number;
+    /** The raw integer minor-unit amount. */
+    toMinor(): number;
+    /** Localized currency string, e.g. "$1,234.56" / "€1.234,56". */
+    format(locale?: string, options?: Intl.NumberFormatOptions): string;
+    toString(): string;
+    toJSON(): {
+        amount: number;
+        currency: string;
+    };
+}
+/** Friendly constructor from major units: `money(19.99, "USD")`. */
+declare function money(major: number, currency: string): Money;
+/** Sum a list of Money (all same currency). Empty list requires a currency fallback. */
+declare function sumMoney(items: Money[], currency?: string): Money;
+
+export { Money, decimalsFor, money, sumMoney };

package/dist/index.js

@@ -0,0 +1,203 @@
+// src/index.ts
+var EXPONENTS = {
+  JPY: 0,
+  KRW: 0,
+  VND: 0,
+  CLP: 0,
+  ISK: 0,
+  HUF: 0,
+  XAF: 0,
+  XOF: 0,
+  XPF: 0,
+  RWF: 0,
+  UGX: 0,
+  GNF: 0,
+  BHD: 3,
+  KWD: 3,
+  OMR: 3,
+  TND: 3,
+  IQD: 3,
+  JOD: 3,
+  LYD: 3
+};
+function decimalsFor(currency) {
+  return EXPONENTS[currency.toUpperCase()] ?? 2;
+}
+function factorFor(currency) {
+  return Math.pow(10, decimalsFor(currency));
+}
+function roundHalfUp(n) {
+  return n < 0 ? -Math.round(-n) : Math.round(n);
+}
+var Money = class _Money {
+  constructor(minor, currency) {
+    if (!Number.isInteger(minor)) {
+      throw new TypeError(`Money amount must be an integer number of minor units, got ${minor}`);
+    }
+    this.amount = minor;
+    this.currency = currency.toUpperCase();
+  }
+  /** From major units: `Money.of(19.99, "USD")` → 1999 minor units. */
+  static of(major, currency) {
+    return new _Money(roundHalfUp(major * factorFor(currency)), currency);
+  }
+  /** From an integer count of minor units: `Money.fromMinor(1999, "USD")`. */
+  static fromMinor(minor, currency) {
+    return new _Money(minor, currency);
+  }
+  /** Zero in a currency. */
+  static zero(currency) {
+    return new _Money(0, currency);
+  }
+  /**
+   * Parse a formatted string like "$1,234.56" or "1.234,56" (best-effort).
+   * Non-digits except the last separator group are stripped.
+   */
+  static parse(input, currency) {
+    const cleaned = input.replace(/[^\d.,-]/g, "").trim();
+    if (!cleaned) throw new Error(`Cannot parse money from "${input}"`);
+    const neg = /^-/.test(cleaned) || /-\d/.test(cleaned);
+    let s = cleaned.replace(/-/g, "");
+    const lastDot = s.lastIndexOf(".");
+    const lastComma = s.lastIndexOf(",");
+    let decSep = "";
+    if (lastDot >= 0 && lastComma >= 0) decSep = lastDot > lastComma ? "." : ",";
+    else if (lastDot >= 0) decSep = ".";
+    else if (lastComma >= 0) decSep = ",";
+    let major;
+    if (decSep) {
+      const thousandsSep = decSep === "." ? "," : ".";
+      s = s.split(thousandsSep).join("");
+      major = Number(s.replace(decSep, "."));
+    } else {
+      major = Number(s);
+    }
+    if (Number.isNaN(major)) throw new Error(`Cannot parse money from "${input}"`);
+    return _Money.of(neg ? -major : major, currency);
+  }
+  assertSame(other) {
+    if (other.currency !== this.currency) {
+      throw new Error(`Currency mismatch: ${this.currency} vs ${other.currency}`);
+    }
+  }
+  add(other) {
+    this.assertSame(other);
+    return new _Money(this.amount + other.amount, this.currency);
+  }
+  subtract(other) {
+    this.assertSame(other);
+    return new _Money(this.amount - other.amount, this.currency);
+  }
+  /** Multiply by a scalar (e.g. quantity or tax rate), rounding to whole minor units. */
+  multiply(factor) {
+    return new _Money(roundHalfUp(this.amount * factor), this.currency);
+  }
+  /** Divide by a scalar, rounding to whole minor units. */
+  divide(divisor) {
+    if (divisor === 0) throw new Error("Division by zero");
+    return new _Money(roundHalfUp(this.amount / divisor), this.currency);
+  }
+  negate() {
+    return new _Money(-this.amount, this.currency);
+  }
+  abs() {
+    return new _Money(Math.abs(this.amount), this.currency);
+  }
+  /**
+   * Split into parts by integer ratios, distributing leftover minor units to the
+   * earliest parts so the sum always equals the original (no cent lost/created).
+   * `money(10,"USD").allocate([1,1,1])` → 3.34, 3.33, 3.33.
+   */
+  allocate(ratios) {
+    if (ratios.length === 0) throw new Error("allocate() needs at least one ratio");
+    if (ratios.some((r) => r < 0)) throw new Error("allocate() ratios must be non-negative");
+    const total = ratios.reduce((a, b) => a + b, 0);
+    if (total === 0) throw new Error("allocate() ratios must not all be zero");
+    const shares = ratios.map((r) => Math.floor(this.amount * r / total));
+    let remainder = this.amount - shares.reduce((a, b) => a + b, 0);
+    const order = ratios.map((r, i) => ({ r, i })).sort((a, b) => b.r - a.r);
+    let k = 0;
+    while (remainder > 0) {
+      shares[order[k % order.length].i] += 1;
+      remainder--;
+      k++;
+    }
+    return shares.map((s) => new _Money(s, this.currency));
+  }
+  /** Split evenly into `n` parts, distributing the remainder fairly. */
+  split(n) {
+    if (!Number.isInteger(n) || n <= 0) throw new Error("split() needs a positive integer");
+    return this.allocate(new Array(n).fill(1));
+  }
+  equals(other) {
+    return this.currency === other.currency && this.amount === other.amount;
+  }
+  greaterThan(other) {
+    this.assertSame(other);
+    return this.amount > other.amount;
+  }
+  lessThan(other) {
+    this.assertSame(other);
+    return this.amount < other.amount;
+  }
+  greaterThanOrEqual(other) {
+    this.assertSame(other);
+    return this.amount >= other.amount;
+  }
+  lessThanOrEqual(other) {
+    this.assertSame(other);
+    return this.amount <= other.amount;
+  }
+  isZero() {
+    return this.amount === 0;
+  }
+  isPositive() {
+    return this.amount > 0;
+  }
+  isNegative() {
+    return this.amount < 0;
+  }
+  /** The value in major units as a number (e.g. 19.99). Beware float for display — prefer format(). */
+  toMajor() {
+    return this.amount / factorFor(this.currency);
+  }
+  /** The raw integer minor-unit amount. */
+  toMinor() {
+    return this.amount;
+  }
+  /** Localized currency string, e.g. "$1,234.56" / "€1.234,56". */
+  format(locale, options) {
+    const decimals = decimalsFor(this.currency);
+    try {
+      return new Intl.NumberFormat(locale, {
+        style: "currency",
+        currency: this.currency,
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+        ...options
+      }).format(this.toMajor());
+    } catch {
+      return `${this.toMajor().toFixed(decimals)} ${this.currency}`;
+    }
+  }
+  toString() {
+    return this.format();
+  }
+  toJSON() {
+    return { amount: this.amount, currency: this.currency };
+  }
+};
+function money(major, currency) {
+  return Money.of(major, currency);
+}
+function sumMoney(items, currency) {
+  if (items.length === 0) {
+    if (!currency) throw new Error("sumMoney() of an empty list needs a currency");
+    return Money.zero(currency);
+  }
+  return items.reduce((acc, m) => acc.add(m));
+}
+
+export { Money, decimalsFor, money, sumMoney };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAmBA,IAAM,SAAA,GAAoC;AAAA,EACxC,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAC7F,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK,CAAA;AAAA,EAAG,GAAA,EAAK;AACvD,CAAA;AAGO,SAAS,YAAY,QAAA,EAA0B;AACpD,EAAA,OAAO,SAAA,CAAU,QAAA,CAAS,WAAA,EAAa,CAAA,IAAK,CAAA;AAC9C;AAEA,SAAS,UAAU,QAAA,EAA0B;AAC3C,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,WAAA,CAAY,QAAQ,CAAC,CAAA;AAC3C;AAGA,SAAS,YAAY,CAAA,EAAmB;AACtC,EAAA,OAAO,CAAA,GAAI,CAAA,GAAI,CAAC,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA;AAC/C;AAEO,IAAM,KAAA,GAAN,MAAM,MAAA,CAAM;AAAA,EAMT,WAAA,CAAY,OAAe,QAAA,EAAkB;AACnD,IAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,KAAK,CAAA,EAAG;AAC5B,MAAA,MAAM,IAAI,SAAA,CAAU,CAAA,2DAAA,EAA8D,KAAK,CAAA,CAAE,CAAA;AAAA,IAC3F;AACA,IAAA,IAAA,CAAK,MAAA,GAAS,KAAA;AACd,IAAA,IAAA,CAAK,QAAA,GAAW,SAAS,WAAA,EAAY;AAAA,EACvC;AAAA;AAAA,EAGA,OAAO,EAAA,CAAG,KAAA,EAAe,QAAA,EAAyB;AAChD,IAAA,OAAO,IAAI,OAAM,WAAA,CAAY,KAAA,GAAQ,UAAU,QAAQ,CAAC,GAAG,QAAQ,CAAA;AAAA,EACrE;AAAA;AAAA,EAGA,OAAO,SAAA,CAAU,KAAA,EAAe,QAAA,EAAyB;AACvD,IAAA,OAAO,IAAI,MAAA,CAAM,KAAA,EAAO,QAAQ,CAAA;AAAA,EAClC;AAAA;AAAA,EAGA,OAAO,KAAK,QAAA,EAAyB;AACnC,IAAA,OAAO,IAAI,MAAA,CAAM,CAAA,EAAG,QAAQ,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,KAAA,CAAM,KAAA,EAAe,QAAA,EAAyB;AACnD,IAAA,MAAM,UAAU,KAAA,CAAM,OAAA,CAAQ,WAAA,EAAa,EAAE,EAAE,IAAA,EAAK;AACpD,IAAA,IAAI,CAAC,OAAA,EAAS,MAAM,IAAI,KAAA,CAAM,CAAA,yBAAA,EAA4B,KAAK,CAAA,CAAA,CAAG,CAAA;AAClE,IAAA,MAAM,MAAM,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA,IAAK,KAAA,CAAM,KAAK,OAAO,CAAA;AACpD,IAAA,IAAI,CAAA,GAAI,OAAA,CAAQ,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAA;AAEhC,IAAA,MAAM,OAAA,GAAU,CAAA,CAAE,WAAA,CAAY,GAAG,CAAA;AACjC,IAAA,MAAM,SAAA,GAAY,CAAA,CAAE,WAAA,CAAY,GAAG,CAAA;AACnC,IAAA,IAAI,MAAA,GAAS,EAAA;AACb,IAAA,IAAI,WAAW,CAAA,IAAK,SAAA,IAAa,GAAG,MAAA,GAAS,OAAA,GAAU,YAAY,GAAA,GAAM,GAAA;AAAA,SAAA,IAChE,OAAA,IAAW,GAAG,MAAA,GAAS,GAAA;AAAA,SAAA,IACvB,SAAA,IAAa,GAAG,MAAA,GAAS,GAAA;AAClC,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,MAAM,YAAA,GAAe,MAAA,KAAW,GAAA,GAAM,GAAA,GAAM,GAAA;AAC5C,MAAA,CAAA,GAAI,CAAA,CAAE,KAAA,CAAM,YAAY,CAAA,CAAE,KAAK,EAAE,CAAA;AACjC,MAAA,KAAA,GAAQ,MAAA,CAAO,CAAA,CAAE,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAC,CAAA;AAAA,IACvC,CAAA,MAAO;AACL,MAAA,KAAA,GAAQ,OAAO,CAAC,CAAA;AAAA,IAClB;AACA,IAAA,IAAI,MAAA,CAAO,MAAM,KAAK,CAAA,QAAS,IAAI,KAAA,CAAM,CAAA,yBAAA,EAA4B,KAAK,CAAA,CAAA,CAAG,CAAA;AAC7E,IAAA,OAAO,OAAM,EAAA,CAAG,GAAA,GAAM,CAAC,KAAA,GAAQ,OAAO,QAAQ,CAAA;AAAA,EAChD;AAAA,EAEQ,WAAW,KAAA,EAAoB;AACrC,IAAA,IAAI,KAAA,CAAM,QAAA,KAAa,IAAA,CAAK,QAAA,EAAU;AACpC,MAAA,MAAM,IAAI,MAAM,CAAA,mBAAA,EAAsB,IAAA,CAAK,QAAQ,CAAA,IAAA,EAAO,KAAA,CAAM,QAAQ,CAAA,CAAE,CAAA;AAAA,IAC5E;AAAA,EACF;AAAA,EAEA,IAAI,KAAA,EAAqB;AACvB,IAAA,IAAA,CAAK,WAAW,KAAK,CAAA;AACrB,IAAA,OAAO,IAAI,MAAA,CAAM,IAAA,CAAK,SAAS,KAAA,CAAM,MAAA,EAAQ,KAAK,QAAQ,CAAA;AAAA,EAC5D;AAAA,EAEA,SAAS,KAAA,EAAqB;AAC5B,IAAA,IAAA,CAAK,WAAW,KAAK,CAAA;AACrB,IAAA,OAAO,IAAI,MAAA,CAAM,IAAA,CAAK,SAAS,KAAA,CAAM,MAAA,EAAQ,KAAK,QAAQ,CAAA;AAAA,EAC5D;AAAA;AAAA,EAGA,SAAS,MAAA,EAAuB;AAC9B,IAAA,OAAO,IAAI,OAAM,WAAA,CAAY,IAAA,CAAK,SAAS,MAAM,CAAA,EAAG,KAAK,QAAQ,CAAA;AAAA,EACnE;AAAA;AAAA,EAGA,OAAO,OAAA,EAAwB;AAC7B,IAAA,IAAI,OAAA,KAAY,CAAA,EAAG,MAAM,IAAI,MAAM,kBAAkB,CAAA;AACrD,IAAA,OAAO,IAAI,OAAM,WAAA,CAAY,IAAA,CAAK,SAAS,OAAO,CAAA,EAAG,KAAK,QAAQ,CAAA;AAAA,EACpE;AAAA,EAEA,MAAA,GAAgB;AACd,IAAA,OAAO,IAAI,MAAA,CAAM,CAAC,IAAA,CAAK,MAAA,EAAQ,KAAK,QAAQ,CAAA;AAAA,EAC9C;AAAA,EAEA,GAAA,GAAa;AACX,IAAA,OAAO,IAAI,OAAM,IAAA,CAAK,GAAA,CAAI,KAAK,MAAM,CAAA,EAAG,KAAK,QAAQ,CAAA;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,SAAS,MAAA,EAA2B;AAClC,IAAA,IAAI,OAAO,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,MAAM,qCAAqC,CAAA;AAC9E,IAAA,IAAI,MAAA,CAAO,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,GAAI,CAAC,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,wCAAwC,CAAA;AACvF,IAAA,MAAM,KAAA,GAAQ,OAAO,MAAA,CAAO,CAAC,GAAG,CAAA,KAAM,CAAA,GAAI,GAAG,CAAC,CAAA;AAC9C,IAAA,IAAI,KAAA,KAAU,CAAA,EAAG,MAAM,IAAI,MAAM,wCAAwC,CAAA;AACzE,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,IAAA,CAAK,KAAA,CAAO,IAAA,CAAK,MAAA,GAAS,CAAA,GAAK,KAAK,CAAC,CAAA;AACtE,IAAA,IAAI,SAAA,GAAY,IAAA,CAAK,MAAA,GAAS,MAAA,CAAO,MAAA,CAAO,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,GAAI,CAAA,EAAG,CAAC,CAAA;AAE9D,IAAA,MAAM,QAAQ,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,MAAO,EAAE,CAAA,EAAG,CAAA,EAAE,CAAE,CAAA,CAAE,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,CAAA,GAAI,EAAE,CAAC,CAAA;AACvE,IAAA,IAAI,CAAA,GAAI,CAAA;AACR,IAAA,OAAO,YAAY,CAAA,EAAG;AACpB,MAAA,MAAA,CAAO,MAAM,CAAA,GAAI,KAAA,CAAM,MAAM,CAAA,CAAG,CAAC,CAAA,IAAM,CAAA;AACvC,MAAA,SAAA,EAAA;AACA,MAAA,CAAA,EAAA;AAAA,IACF;AACA,IAAA,OAAO,MAAA,CAAO,IAAI,CAAC,CAAA,KAAM,IAAI,MAAA,CAAM,CAAA,EAAG,IAAA,CAAK,QAAQ,CAAC,CAAA;AAAA,EACtD;AAAA;AAAA,EAGA,MAAM,CAAA,EAAoB;AACxB,IAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,CAAC,CAAA,IAAK,KAAK,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,kCAAkC,CAAA;AACtF,IAAA,OAAO,IAAA,CAAK,SAAS,IAAI,KAAA,CAAM,CAAC,CAAA,CAAE,IAAA,CAAK,CAAC,CAAC,CAAA;AAAA,EAC3C;AAAA,EAEA,OAAO,KAAA,EAAuB;AAC5B,IAAA,OAAO,KAAK,QAAA,KAAa,KAAA,CAAM,QAAA,IAAY,IAAA,CAAK,WAAW,KAAA,CAAM,MAAA;AAAA,EACnE;AAAA,EACA,YAAY,KAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,WAAW,KAAK,CAAA;AACrB,IAAA,OAAO,IAAA,CAAK,SAAS,KAAA,CAAM,MAAA;AAAA,EAC7B;AAAA,EACA,SAAS,KAAA,EAAuB;AAC9B,IAAA,IAAA,CAAK,WAAW,KAAK,CAAA;AACrB,IAAA,OAAO,IAAA,CAAK,SAAS,KAAA,CAAM,MAAA;AAAA,EAC7B;AAAA,EACA,mBAAmB,KAAA,EAAuB;AACxC,IAAA,IAAA,CAAK,WAAW,KAAK,CAAA;AACrB,IAAA,OAAO,IAAA,CAAK,UAAU,KAAA,CAAM,MAAA;AAAA,EAC9B;AAAA,EACA,gBAAgB,KAAA,EAAuB;AACrC,IAAA,IAAA,CAAK,WAAW,KAAK,CAAA;AACrB,IAAA,OAAO,IAAA,CAAK,UAAU,KAAA,CAAM,MAAA;AAAA,EAC9B;AAAA,EACA,MAAA,GAAkB;AAChB,IAAA,OAAO,KAAK,MAAA,KAAW,CAAA;AAAA,EACzB;AAAA,EACA,UAAA,GAAsB;AACpB,IAAA,OAAO,KAAK,MAAA,GAAS,CAAA;AAAA,EACvB;AAAA,EACA,UAAA,GAAsB;AACpB,IAAA,OAAO,KAAK,MAAA,GAAS,CAAA;AAAA,EACvB;AAAA;AAAA,EAGA,OAAA,GAAkB;AAChB,IAAA,OAAO,IAAA,CAAK,MAAA,GAAS,SAAA,CAAU,IAAA,CAAK,QAAQ,CAAA;AAAA,EAC9C;AAAA;AAAA,EAGA,OAAA,GAAkB;AAChB,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA,EAGA,MAAA,CAAO,QAAiB,OAAA,EAA4C;AAClE,IAAA,MAAM,QAAA,GAAW,WAAA,CAAY,IAAA,CAAK,QAAQ,CAAA;AAC1C,IAAA,IAAI;AACF,MAAA,OAAO,IAAI,IAAA,CAAK,YAAA,CAAa,MAAA,EAAQ;AAAA,QACnC,KAAA,EAAO,UAAA;AAAA,QACP,UAAU,IAAA,CAAK,QAAA;AAAA,QACf,qBAAA,EAAuB,QAAA;AAAA,QACvB,qBAAA,EAAuB,QAAA;AAAA,QACvB,GAAG;AAAA,OACJ,CAAA,CAAE,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA;AAAA,IAC1B,CAAA,CAAA,MAAQ;AAEN,MAAA,OAAO,CAAA,EAAG,KAAK,OAAA,EAAQ,CAAE,QAAQ,QAAQ,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,QAAQ,CAAA,CAAA;AAAA,IAC7D;AAAA,EACF;AAAA,EAEA,QAAA,GAAmB;AACjB,IAAA,OAAO,KAAK,MAAA,EAAO;AAAA,EACrB;AAAA,EAEA,MAAA,GAA+C;AAC7C,IAAA,OAAO,EAAE,MAAA,EAAQ,IAAA,CAAK,MAAA,EAAQ,QAAA,EAAU,KAAK,QAAA,EAAS;AAAA,EACxD;AACF;AAGO,SAAS,KAAA,CAAM,OAAe,QAAA,EAAyB;AAC5D,EAAA,OAAO,KAAA,CAAM,EAAA,CAAG,KAAA,EAAO,QAAQ,CAAA;AACjC;AAGO,SAAS,QAAA,CAAS,OAAgB,QAAA,EAA0B;AACjE,EAAA,IAAI,KAAA,CAAM,WAAW,CAAA,EAAG;AACtB,IAAA,IAAI,CAAC,QAAA,EAAU,MAAM,IAAI,MAAM,8CAA8C,CAAA;AAC7E,IAAA,OAAO,KAAA,CAAM,KAAK,QAAQ,CAAA;AAAA,EAC5B;AACA,EAAA,OAAO,KAAA,CAAM,OAAO,CAAC,GAAA,EAAK,MAAM,GAAA,CAAI,GAAA,CAAI,CAAC,CAAC,CAAA;AAC5C","file":"index.js","sourcesContent":["/**\n * @lacspace/money\n * Money done right — integer minor units (no floating-point cents bugs),\n * currency-safe arithmetic, remainder-preserving allocation, and localized\n * formatting via `Intl`.\n *\n * ```ts\n * import { money } from \"@lacspace/money\";\n *\n * const price = money(19.99, \"USD\");      // 1999 minor units\n * const total = price.multiply(3);        // $59.97, exact\n * total.format();                          // \"$59.97\"\n * money(10, \"USD\").allocate([1, 1, 1]);    // [$3.34, $3.33, $3.33] — no cent lost\n * ```\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\n/** Minor-unit exponents for currencies that aren't the default 2. */\nconst EXPONENTS: Record<string, number> = {\n  JPY: 0, KRW: 0, VND: 0, CLP: 0, ISK: 0, HUF: 0, XAF: 0, XOF: 0, XPF: 0, RWF: 0, UGX: 0, GNF: 0,\n  BHD: 3, KWD: 3, OMR: 3, TND: 3, IQD: 3, JOD: 3, LYD: 3,\n};\n\n/** How many minor units are in one major unit for a currency (e.g. 100 for USD). */\nexport function decimalsFor(currency: string): number {\n  return EXPONENTS[currency.toUpperCase()] ?? 2;\n}\n\nfunction factorFor(currency: string): number {\n  return Math.pow(10, decimalsFor(currency));\n}\n\n/** Round half away from zero — the intuitive rule for money. */\nfunction roundHalfUp(n: number): number {\n  return n < 0 ? -Math.round(-n) : Math.round(n);\n}\n\nexport class Money {\n  /** Integer amount in minor units (e.g. cents). */\n  readonly amount: number;\n  /** ISO 4217 code, upper-cased. */\n  readonly currency: string;\n\n  private constructor(minor: number, currency: string) {\n    if (!Number.isInteger(minor)) {\n      throw new TypeError(`Money amount must be an integer number of minor units, got ${minor}`);\n    }\n    this.amount = minor;\n    this.currency = currency.toUpperCase();\n  }\n\n  /** From major units: `Money.of(19.99, \"USD\")` → 1999 minor units. */\n  static of(major: number, currency: string): Money {\n    return new Money(roundHalfUp(major * factorFor(currency)), currency);\n  }\n\n  /** From an integer count of minor units: `Money.fromMinor(1999, \"USD\")`. */\n  static fromMinor(minor: number, currency: string): Money {\n    return new Money(minor, currency);\n  }\n\n  /** Zero in a currency. */\n  static zero(currency: string): Money {\n    return new Money(0, currency);\n  }\n\n  /**\n   * Parse a formatted string like \"$1,234.56\" or \"1.234,56\" (best-effort).\n   * Non-digits except the last separator group are stripped.\n   */\n  static parse(input: string, currency: string): Money {\n    const cleaned = input.replace(/[^\\d.,-]/g, \"\").trim();\n    if (!cleaned) throw new Error(`Cannot parse money from \"${input}\"`);\n    const neg = /^-/.test(cleaned) || /-\\d/.test(cleaned);\n    let s = cleaned.replace(/-/g, \"\");\n    // Decide the decimal separator: whichever of . or , comes last.\n    const lastDot = s.lastIndexOf(\".\");\n    const lastComma = s.lastIndexOf(\",\");\n    let decSep = \"\";\n    if (lastDot >= 0 && lastComma >= 0) decSep = lastDot > lastComma ? \".\" : \",\";\n    else if (lastDot >= 0) decSep = \".\";\n    else if (lastComma >= 0) decSep = \",\";\n    let major: number;\n    if (decSep) {\n      const thousandsSep = decSep === \".\" ? \",\" : \".\";\n      s = s.split(thousandsSep).join(\"\");\n      major = Number(s.replace(decSep, \".\"));\n    } else {\n      major = Number(s);\n    }\n    if (Number.isNaN(major)) throw new Error(`Cannot parse money from \"${input}\"`);\n    return Money.of(neg ? -major : major, currency);\n  }\n\n  private assertSame(other: Money): void {\n    if (other.currency !== this.currency) {\n      throw new Error(`Currency mismatch: ${this.currency} vs ${other.currency}`);\n    }\n  }\n\n  add(other: Money): Money {\n    this.assertSame(other);\n    return new Money(this.amount + other.amount, this.currency);\n  }\n\n  subtract(other: Money): Money {\n    this.assertSame(other);\n    return new Money(this.amount - other.amount, this.currency);\n  }\n\n  /** Multiply by a scalar (e.g. quantity or tax rate), rounding to whole minor units. */\n  multiply(factor: number): Money {\n    return new Money(roundHalfUp(this.amount * factor), this.currency);\n  }\n\n  /** Divide by a scalar, rounding to whole minor units. */\n  divide(divisor: number): Money {\n    if (divisor === 0) throw new Error(\"Division by zero\");\n    return new Money(roundHalfUp(this.amount / divisor), this.currency);\n  }\n\n  negate(): Money {\n    return new Money(-this.amount, this.currency);\n  }\n\n  abs(): Money {\n    return new Money(Math.abs(this.amount), this.currency);\n  }\n\n  /**\n   * Split into parts by integer ratios, distributing leftover minor units to the\n   * earliest parts so the sum always equals the original (no cent lost/created).\n   * `money(10,\"USD\").allocate([1,1,1])` → 3.34, 3.33, 3.33.\n   */\n  allocate(ratios: number[]): Money[] {\n    if (ratios.length === 0) throw new Error(\"allocate() needs at least one ratio\");\n    if (ratios.some((r) => r < 0)) throw new Error(\"allocate() ratios must be non-negative\");\n    const total = ratios.reduce((a, b) => a + b, 0);\n    if (total === 0) throw new Error(\"allocate() ratios must not all be zero\");\n    const shares = ratios.map((r) => Math.floor((this.amount * r) / total));\n    let remainder = this.amount - shares.reduce((a, b) => a + b, 0);\n    // Hand out the remaining units one at a time to the parts with the biggest ratio.\n    const order = ratios.map((r, i) => ({ r, i })).sort((a, b) => b.r - a.r);\n    let k = 0;\n    while (remainder > 0) {\n      shares[order[k % order.length]!.i]! += 1;\n      remainder--;\n      k++;\n    }\n    return shares.map((s) => new Money(s, this.currency));\n  }\n\n  /** Split evenly into `n` parts, distributing the remainder fairly. */\n  split(n: number): Money[] {\n    if (!Number.isInteger(n) || n <= 0) throw new Error(\"split() needs a positive integer\");\n    return this.allocate(new Array(n).fill(1));\n  }\n\n  equals(other: Money): boolean {\n    return this.currency === other.currency && this.amount === other.amount;\n  }\n  greaterThan(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount > other.amount;\n  }\n  lessThan(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount < other.amount;\n  }\n  greaterThanOrEqual(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount >= other.amount;\n  }\n  lessThanOrEqual(other: Money): boolean {\n    this.assertSame(other);\n    return this.amount <= other.amount;\n  }\n  isZero(): boolean {\n    return this.amount === 0;\n  }\n  isPositive(): boolean {\n    return this.amount > 0;\n  }\n  isNegative(): boolean {\n    return this.amount < 0;\n  }\n\n  /** The value in major units as a number (e.g. 19.99). Beware float for display — prefer format(). */\n  toMajor(): number {\n    return this.amount / factorFor(this.currency);\n  }\n\n  /** The raw integer minor-unit amount. */\n  toMinor(): number {\n    return this.amount;\n  }\n\n  /** Localized currency string, e.g. \"$1,234.56\" / \"€1.234,56\". */\n  format(locale?: string, options?: Intl.NumberFormatOptions): string {\n    const decimals = decimalsFor(this.currency);\n    try {\n      return new Intl.NumberFormat(locale, {\n        style: \"currency\",\n        currency: this.currency,\n        minimumFractionDigits: decimals,\n        maximumFractionDigits: decimals,\n        ...options,\n      }).format(this.toMajor());\n    } catch {\n      // Unknown currency to Intl — fall back to a plain number + code.\n      return `${this.toMajor().toFixed(decimals)} ${this.currency}`;\n    }\n  }\n\n  toString(): string {\n    return this.format();\n  }\n\n  toJSON(): { amount: number; currency: string } {\n    return { amount: this.amount, currency: this.currency };\n  }\n}\n\n/** Friendly constructor from major units: `money(19.99, \"USD\")`. */\nexport function money(major: number, currency: string): Money {\n  return Money.of(major, currency);\n}\n\n/** Sum a list of Money (all same currency). Empty list requires a currency fallback. */\nexport function sumMoney(items: Money[], currency?: string): Money {\n  if (items.length === 0) {\n    if (!currency) throw new Error(\"sumMoney() of an empty list needs a currency\");\n    return Money.zero(currency);\n  }\n  return items.reduce((acc, m) => acc.add(m));\n}\n"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@lacspace/money",
+  "version": "1.0.0",
+  "description": "Money done right — integer minor units (no floating-point cent bugs), currency-safe arithmetic, remainder-preserving allocation/split, and localized formatting via Intl. Zero-dependency, isomorphic.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "money",
+    "currency",
+    "dinero-alternative",
+    "minor-units",
+    "cents",
+    "decimal",
+    "allocate",
+    "intl",
+    "currency-formatting",
+    "finance",
+    "price",
+    "typescript",
+    "zero-dependency",
+    "isomorphic"
+  ],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://lacspace.com/packages",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lacspace/npm-packages.git",
+    "directory": "money"
+  },
+  "bugs": {
+    "url": "https://github.com/lacspace/npm-packages/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}