amounts 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b7620b025be07f1166e655108c2b9cea0232acb60d814cf91b71ecb47ddf1fb
-  data.tar.gz: 8f8ab43608f4ced54ab5020c7cbcf69b0741c9203e549558b27356766187efb5
+  metadata.gz: b83ca37936b92cf689a865d0173dafd36e354f5e058fab07983efa436796b5d6
+  data.tar.gz: 3071b5b4bb06f46511a8dc45ec8d0f888b0863d61cfdbda363b313d806fb2f8a
 SHA512:
-  metadata.gz: 466350a8fbfff01e84bd044f23ced9d63288eb4147f13d70df2a3db9b37745cafee46e03cb3d1d9b0b805fff8ece3ca13df029c19786204f21e2fe1336b1e564
-  data.tar.gz: 807ba283121158491de02a78084dae5ce12c6360ac106a7d72a1bde6a7f536ac3009fdf329b9e75972fe3631ade8bdae3dd0f2d1f2d2e74f9a023f28d46f5cb1
+  metadata.gz: 398502b610a4e35059307a3f2e895f119ba8456bdfeb22cf95a0976d37b21fcbbedc8f0ff201b90efa6faf5b9cb1f18e9dae2209cc838f8f6cc3929ea73d4d81
+  data.tar.gz: d26be5a7c85fd002ddc3435880d25bebae7b7a29007295b064efb2bcfe0eacb0d3959044c499db1621e7e8e1b238b311c546dc24c591e8ccfc02b61e4865e281

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.0.5 - 2026-04-26
+
+### Added
+
+- `Amount#ui(decorated: false)` returns the rounded UI value as a plain
+  numeric string without the `display_symbol` prefix or suffix. Useful when
+  the caller renders the currency label separately (e.g. in a column header
+  or chip). Composes with `unit:` and `direction:` — for example,
+  `Amount.gold("1").ui(unit: :gram, decorated: false)` returns `"31.10"`.
+  Default remains `decorated: true`, so existing callers see no change.
+
 ## 0.0.4 - 2026-04-26
 
 ### Changed (breaking)

data/lib/amount/display.rb

@@ -18,9 +18,21 @@ class Amount
 
     # @param unit [Symbol, nil]
     # @param direction [Symbol]
+    # @param decorated [Boolean] when `false`, omit the display symbol and
+    #   return just the rounded number. Useful when the caller renders the
+    #   currency label separately (e.g. in a column header or a chip).
     # @return [String]
-    def ui(unit: nil, direction: :floor)
-      unit ? render_display_unit(unit, direction) : render_default(direction)
+    # @example
+    #   Amount.usdc("1.50").ui                       # => "$1.50"
+    #   Amount.usdc("1.50").ui(decorated: false)     # => "1.50"
+    #   Amount.gold("1").ui(unit: :gram)             # => "31.10 g"
+    #   Amount.gold("1").ui(unit: :gram, decorated: false)  # => "31.10"
+    def ui(unit: nil, direction: :floor, decorated: true)
+      if unit
+        render_display_unit(unit, direction, decorated:)
+      else
+        render_default(direction, decorated:)
+      end
     end
 
     # @return [String]
@@ -37,19 +49,24 @@ class Amount
 
     private
 
-    def render_default(direction)
+    def render_default(direction, decorated:)
       rounded = round(@amount.decimal, @entry.ui_decimals, direction)
-      apply_symbol(format("%.#{@entry.ui_decimals}f", rounded), @entry.display_symbol, @entry.display_position)
+      formatted = format("%.#{@entry.ui_decimals}f", rounded)
+      return formatted unless decorated
+
+      apply_symbol(formatted, @entry.display_symbol, @entry.display_position)
     end
 
-    def render_display_unit(unit, direction)
+    def render_display_unit(unit, direction, decorated:)
       spec = fetch_display_unit(unit)
       scaled = @amount.decimal * Amount.coerce_decimal(spec[:scale])
       decimals = spec[:ui_decimals] || @entry.ui_decimals
       rounded = round(scaled, decimals, direction)
+      formatted = format("%.#{decimals}f", rounded)
+      return formatted unless decorated
 
       apply_symbol(
-        format("%.#{decimals}f", rounded),
+        formatted,
         spec[:symbol] || @entry.display_symbol,
         spec[:position] || @entry.display_position
       )

data/lib/amount/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Amount
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/test/test_amount.rb

@@ -169,6 +169,16 @@ class AmountTest < Minitest::Test
     assert_equal "$1.57", Amount.new("1.561", :USDC).ui(direction: :ceil)
   end
 
+  def test_ui_decorated_false_omits_the_display_symbol
+    assert_equal "1.50", Amount.new("1.5", :USDC).ui(decorated: false)
+    assert_equal "1.5000", Amount.new("1.5", :SOL).ui(decorated: false)
+    assert_equal "1", Amount.new(1, :LOGS).ui(decorated: false)
+  end
+
+  def test_ui_decorated_false_with_ceil_direction
+    assert_equal "1.57", Amount.new("1.561", :USDC).ui(direction: :ceil, decorated: false)
+  end
+
   def test_display_units_scale_output
     gold = Amount.new("1.5", :GOLD)
 
@@ -177,6 +187,14 @@ class AmountTest < Minitest::Test
     assert_equal "0.04665 kg", gold.ui(unit: :kg)
   end
 
+  def test_display_units_with_decorated_false
+    gold = Amount.new("1.5", :GOLD)
+
+    assert_equal "1.5000", gold.ui(decorated: false)
+    assert_equal "46.65", gold.ui(unit: :gram, decorated: false)
+    assert_equal "0.04665", gold.ui(unit: :kg, decorated: false)
+  end
+
   def test_in_unit_returns_raw_bigdecimal
     gold = Amount.new("1.0", :GOLD)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: amounts
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Seb Scholl