minting 1.7.3 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ebe31c2ae1b9febafa3a6a4ccea1392cb089242746a933d530121b08f55cd4e
-  data.tar.gz: 80f1eb17f62b7a7924df8b2fedb79d864bcadd5ea5e8432e5149b14fb0d9af0c
+  metadata.gz: a027eb400724db0164db62cc9d76ce371b73a538d4b5713f85a917b31c43330a
+  data.tar.gz: cf7bb6b476300f02f39992dab1e7ecbff9e7d14974dbf8c33fc89dd1c093e20e
 SHA512:
-  metadata.gz: 44147d3523485fc36491bb62f24df5f4040fe3ddda673201d5b6fc9a5e005bda94cd3300b4e84682f4378cb9eedb851ad16c247a2dfeb9de264fd24a6b1714ca
-  data.tar.gz: 5f41672831c8c722e47de8b8e94549bb633c48b677fc8e63eca9f10233062f32a0acd276b31271a4f0ac4417779b03db7f034a9b9afcfbd39c0cbadb16886dbf
+  metadata.gz: 9274bdfeb0ffdb3a8e22366a71d02265008bdabcf18abdbc68ec70c4e92768e1c9fdbb58bd243c2f3ad8e3094f3e5cfc45e876756a9a93720a428cc0a42210a1
+  data.tar.gz: d0647ee4aa7e9f28dc5cc6d7698639830edabff5b4a0b14c108f55f4bd6a8004e603dccfdcb934c5d404a670f4baf7e2269440643a586bab1c6e2dc71314b7b7

data/README.md

@@ -176,12 +176,12 @@ Notes:
 
 ```ruby
 # By ISO code (direct hash lookup, string only)
-Mint.currency_for_code('USD')        #=> #<Currency code="USD" ...>
+Mint::Currency.for_code('USD')        #=> #<Currency code="USD" ...>
 
 # By display symbol (highest-priority currency for ambiguous symbols)
-Mint.currency_for_symbol('$')        #=> #<Currency code="USD" ...>
-Mint.currency_for_symbol('R$')       #=> #<Currency code="BRL" ...>
-Mint.currency_for_symbol('€')        #=> #<Currency code="EUR" ...>
+Mint::Currency.for_symbol('$')        #=> #<Currency code="USD" ...>
+Mint::Currency.for_symbol('R$')       #=> #<Currency code="BRL" ...>
+Mint::Currency.for_symbol('€')        #=> #<Currency code="EUR" ...>
 
 ```
 
@@ -189,15 +189,25 @@ Mint.currency_for_symbol('€')        #=> #<Currency code="EUR" ...>
 
 **Exact amounts** — Amounts are stored as `Rational` and rounded to the currency subunit.
 
+**Rounding modes** — Wrap operations in `Mint.with_rounding(mode)` to change how amounts are rounded to the subunit:
+
+```ruby
+Mint.with_rounding(:half_down) { Mint.money(1.005, 'USD') }  #=> [USD 1.00]
+Mint.with_rounding(:ceil)      { Mint.money(1.001, 'USD') }  #=> [USD 1.01]
+Mint.with_rounding(:floor)     { Mint.parse('1.009', 'USD') } #=> [USD 1.00]
+```
+
+Modes: `:half_up` (default), `:half_down`, `:floor`, `:ceil`, `:truncate`, `:down`. Applies to construction, parsing, `change`, `split`, and `allocate`. Restores the previous mode when the block exits, even on exception.
+
 **Refinements** — `10.dollars` and similar helpers require `using Mint` in the current scope (see Usage above).
 
 **Division** — `money / 5` returns new `Money`; `money / other_money` returns a numeric ratio, not money.
 
 **Zero equality** — Any zero amount is considered equal across currencies and to numeric zero (`Mint.money(0, 'USD') == Mint.money(0, 'EUR')` is intentionally `true`). Non-zero amounts must match currency and value.
 
-**Zero helper** — `Mint.zero('USD')` returns a frozen zero-Money, useful as a default value for discounts, totals, or counters.
+**Zero helper** — `Currency.zero('USD')` returns a frozen zero-Money, useful as a default value for discounts, totals, or counters.
 
-**Registered currencies** — `Mint.register_currency(code:, subunit:, symbol:, priority:)` adds custom currencies. Only registered codes and symbols are recognized by the parser.
+**Registered currencies** — `Currency.register(code:, subunit:, symbol:, priority:)` adds custom currencies. Only registered codes and symbols are recognized by the parser.
 
 **Built-in currencies** — 150+ ISO-4217 world currencies ship in `lib/minting/data/currencies.yaml` and load when the registry is first accessed.
 
@@ -216,11 +226,18 @@ Or at runtime:
 Minting.use_top_level_constants!
 ```
 
+For Rails applications, you can enable the top-level constants in an initializer:
+
+```ruby
+# config/initializers/minting.rb
+require "minting/dsl"
+```
+
 After opting in:
 
 ```ruby
-price = Money.create(10, "USD")     # equivalent to Mint::Money.create
-tax   = Money.money(2.50, "USD")
+price = Money.from(10, "USD")                   # equivalent to Mint::Money.from
+tax   = Money.from(2.50, "USD")
 cur   = Currency.new(code: "EUR", symbol: "€", subunit: 2, priority: 0)
 ```