@core / money

1.0.1 ▾

1.0.1

認証済みMIT

GitHub

整数（最小単位）で扱う金額：ISO 通貨、安全なパース、丸め、端数の出ない配分、.99 価格、書式化

コード4 ファイルコンテキスト約 423 トークンスキャン合格

インストール

$genpm add @core/money

含まれるもの

src/lib/money/ にソースコード（4 ファイル）。 (9.6 KB)
src/lib/money/AGENTS.md に AI ルール、加えて IDE 用のルールファイル。
@core/contracts を自動で解決します。

README

このパッケージには README がありません。

約 423 トークン→ src/lib/money/AGENTS.md→ .cursor/rules/genpm-core-money.mdc

これは AI が src/lib/money で作業するときに読む内容そのものです。それ以外はコンテキストに追加されません。

@core/money — rules for AI agents

Purpose

Money as { amount, currency } with amount an integer of minor units (cents) and an ISO 4217 code, so commerce modules never use floats. Parsing from decimal strings, safe arithmetic that refuses mixed currencies, rounding, percentages, lossless allocation (splitting a discount across lines), charm prices (.99, never below the input; …9 in zero-decimal currencies), formatting with Intl and conversion with a rates table. Pure functions: no tables, no network.

Map

index.ts — public API: money, parseMoney, add, sub, sum, multiply, percent, allocate, charmPrice, format, toDecimalString, convert, currencyDecimals.
money.ts — implementation. The Money type comes from @core/contracts.

Integration

Nothing to configure. Store money in two columns: amount integer (minor units) and currency text.
User input: parseMoney('19,99', 'EUR') (never Number(input) * 100).
Display: format(price, locale); APIs/JSON-LD: toDecimalString(price).
Split amounts: allocate(discount, lines.map((l) => l.subtotal.amount)).
Verify: add(money(1, 'EUR'), money(1, 'USD')) throws.

Conventions

All arithmetic through these helpers; JPY has 0 decimals and KWD 3, so never assume 100.
Percentages round half-up by default; pass 'half-even' where your accounting requires it.
Exchange rates are inputs (store the rate used with each order); this module does not fetch them.

Don't

Don't use floats for prices, totals or taxes, and don't add amounts of different currencies.
Don't round intermediate results before the final step unless the business rule says so.

# @core/money — rules for AI agents

## Purpose
Money as `{ amount, currency }` with `amount` an integer of minor units (cents) and an ISO 4217 code, so commerce
modules never use floats. Parsing from decimal strings, safe arithmetic that refuses mixed currencies, rounding,
percentages, lossless allocation (splitting a discount across lines), charm prices (`.99`, never below the input; `…9` in zero-decimal currencies), formatting with `Intl`
and conversion with a rates table. Pure functions: no tables, no network.

## Map
- `index.ts` — public API: `money`, `parseMoney`, `add`, `sub`, `sum`, `multiply`, `percent`, `allocate`, `charmPrice`, `format`, `toDecimalString`, `convert`, `currencyDecimals`.
- `money.ts` — implementation. The `Money` type comes from @core/contracts.

## Integration
1. Nothing to configure. Store money in two columns: `amount integer` (minor units) and `currency text`.
2. User input: `parseMoney('19,99', 'EUR')` (never `Number(input) * 100`).
3. Display: `format(price, locale)`; APIs/JSON-LD: `toDecimalString(price)`.
4. Split amounts: `allocate(discount, lines.map((l) => l.subtotal.amount))`.
5. Verify: `add(money(1, 'EUR'), money(1, 'USD'))` throws.

## Conventions
- All arithmetic through these helpers; JPY has 0 decimals and KWD 3, so never assume 100.
- Percentages round half-up by default; pass `'half-even'` where your accounting requires it.
- Exchange rates are inputs (store the rate used with each order); this module does not fetch them.

## Don't
- Don't use floats for prices, totals or taxes, and don't add amounts of different currencies.
- Don't round intermediate results before the final step unless the business rule says so.