@core / money

1.0.1 ▾

1.0.1

verificadoMIT

GitHub

Dinheiro em inteiros (centavos): moedas ISO, parsing seguro, arredondamento, rateio sem perdas, preços .99 e formato

Código4 arquivosContexto~423 tokensanálise aprovada

~423 tokens→ src/lib/money/AGENTS.md→ .cursor/rules/genpm-core-money.mdc

Isto é exatamente o que sua IA lê quando trabalha em src/lib/money. Nada mais é adicionado ao contexto dela.

@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.

A árvore exata que será injetada, após o .genpmignore. Fixada em

src/lib/money/index.tssomente leitura · e980a84

// @core/money — API pública. Importa desde aquí.
export {
  add,
  allocate,
  charmPrice,
  compare,
  convert,
  currencyDecimals,
  equals,
  format,
  isNegative,
  isZero,
  max,
  min,
  type Money,
  MoneyError,
  money,
  multiply,
  parseMoney,
  percent,
  sub,
  sum,
  toDecimalString,
  zero,
} from './money.ts';