RubyGems - minting - Versions diffs - 1.9.6 → 1.9.7 - Mend

minting 1.9.6 → 1.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (32) hide show

checksums.yaml +4 -4
data/README.md +30 -25
data/Rakefile +16 -20
data/bin/bench_check +2 -2
data/doc/Mint/Currency.html +183 -94
data/doc/Mint/Money.html +866 -334
data/doc/Mint/RangeStepPatch.html +1 -1
data/doc/Mint/Registry.html +10 -10
data/doc/Mint/Rounding.html +2 -2
data/doc/Mint/UnknownCurrency.html +6 -4
data/doc/Mint.html +33 -106
data/doc/Minting.html +2 -2
data/doc/Numeric.html +479 -0
data/doc/String.html +241 -0
data/doc/_index.html +27 -1
data/doc/agents/copilot-instructions.md +3 -3
data/doc/class_list.html +1 -1
data/doc/file.README.html +47 -33
data/doc/index.html +47 -33
data/doc/method_list.html +125 -53
data/doc/top-level-namespace.html +5 -21
data/lib/minting/currency/currency.rb +6 -3
data/lib/minting/data/world-currencies.yaml +75 -23
data/lib/minting/mint/i18n.rb +1 -1
data/lib/minting/mint/rounding.rb +1 -0
data/lib/minting/money/conversion.rb +1 -0
data/lib/minting/money/format/formatting.rb +88 -55
data/lib/minting/money/format/to_s.rb +20 -3
data/lib/minting/money/money.rb +0 -4
data/lib/minting/version.rb +1 -1
metadata +3 -2
data/doc/Mint/CurrencyRegistry.html +0 -511

data/doc/Mint/Money.html CHANGED Viewed

@@ -140,7 +140,17 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
 </div>
         </dt>
-        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;symbol&gt;s%&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span></pre></dd>
+        <dd><pre class="code"><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;symbol&gt;s%&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
+        <dt id="PRESETS-constant" class="">PRESETS =
+        </dt>
+        <dd><pre class="code"><span class='lbrace'>{</span>
+  <span class='label'>amount:</span> <span class='lbrace'>{</span> <span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
+  <span class='label'>accounting:</span> <span class='lbrace'>{</span> <span class='label'>format:</span> <span class='lbrace'>{</span> <span class='label'>negative:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>(%&lt;symbol&gt;s%&lt;amount&gt;f)</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span> <span class='rbrace'>}</span><span class='comma'>,</span>
+  <span class='label'>european:</span> <span class='lbrace'>{</span> <span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;f %&lt;symbol&gt;s</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>decimal:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>thousand:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='comma'>,</span>
+  <span class='label'>currency:</span> <span class='lbrace'>{</span> <span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;currency&gt;s %&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span>
+<span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_freeze'>freeze</span></pre></dd>
     </dl>
@@ -221,7 +231,51 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
         <li class="public ">
   <span class="summary_signature">
-      <a href="#create-class_method" title="create (class method)">.<strong>create</strong>(amount, currency)  &#x21d2; Object </a>
+      <a href="#compile_formatter-class_method" title="compile_formatter (class method)">.<strong>compile_formatter</strong>(format_hash, currency, decimal, thousand)  &#x21d2; Object </a>
+  </span>
+    <span class="summary_desc"><div class='inline'><p>Builds and returns a lambda that formats amounts for a fixed [format_config, currency, decimal, thousand] combination.</p></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#compile_templates-class_method" title="compile_templates (class method)">.<strong>compile_templates</strong>(format_hash, subunit)  &#x21d2; Object </a>
+  </span>
+    <span class="summary_desc"><div class='inline'><p>Build each sign template with subunit precision baked in, returning a frozen Hash of templates keyed by sign (:positive, :negative, :zero).</p></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
+      <a href="#compiled_formatters-class_method" title="compiled_formatters (class method)">.<strong>compiled_formatters</strong>  &#x21d2; Object </a>
@@ -235,7 +289,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
-    <span class="summary_desc"><div class='inline'><p>Backwards-compatible alias for previous API TODO: deprecate in a future major release.</p></div></span>
+    <span class="summary_desc"><div class='inline'></div></span>
 </li>
@@ -528,7 +582,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'></div></span>
@@ -550,7 +604,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>True if both are zero, or both have same amount and same currency.</p></div></span>
@@ -605,6 +659,28 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
         <li class="public ">
   <span class="summary_signature">
+      <a href="#amount_to_s-instance_method" title="#amount_to_s (instance method)">#<strong>amount_to_s</strong>(thousand: &#39;,&#39;)  &#x21d2; Object </a>
+  </span>
+    <span class="summary_desc"><div class='inline'></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
       <a href="#clamp-instance_method" title="#clamp (instance method)">#<strong>clamp</strong>(min_or_range, max = nil)  &#x21d2; Money </a>
@@ -704,7 +780,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Strict equality — both amount and currency must match exactly.</p></div></span>
@@ -715,6 +791,30 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
         <li class="public ">
   <span class="summary_signature">
+      <a href="#format-instance_method" title="#format (instance method)">#<strong>format</strong>(preset = nil, format: nil, decimal: nil, thousand: nil, width: nil)  &#x21d2; String </a>
+      (also: #to_fs)
+  </span>
+    <span class="summary_desc"><div class='inline'><p>Formats money as a string with customizable format, thousand delimiter, and decimal.</p></div></span>
+</li>
+        <li class="public ">
+  <span class="summary_signature">
       <a href="#fractional-instance_method" title="#fractional (instance method)">#<strong>fractional</strong>  &#x21d2; Object </a>
@@ -836,7 +936,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Self if amount is non-zero, nil otherwise.</p></div></span>
@@ -880,7 +980,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Helper method to verify if another Money has the identical currency.</p></div></span>
@@ -968,7 +1068,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Converts the monetary amount to a BigDecimal object.</p></div></span>
@@ -990,7 +1090,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Converts the monetary amount to a standard float.</p></div></span>
@@ -1012,7 +1112,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Returns a Hash representation of the money instance.</p></div></span>
@@ -1034,7 +1134,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Renders a safe HTML5 <code>&lt;data&gt;</code> element containing the formatted currency.</p></div></span>
@@ -1056,7 +1156,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Truncates and converts the monetary amount to an Integer.</p></div></span>
@@ -1078,7 +1178,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Serializes the money instance to a standard JSON object containing the amount and currency.</p></div></span>
@@ -1100,7 +1200,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>Returns the exact internal Rational representation of the monetary amount.</p></div></span>
@@ -1111,7 +1211,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
         <li class="public ">
   <span class="summary_signature">
-      <a href="#to_s-instance_method" title="#to_s (instance method)">#<strong>to_s</strong>(format: nil, decimal: nil, thousand: nil, width: nil)  &#x21d2; String </a>
+      <a href="#to_s-instance_method" title="#to_s (instance method)">#<strong>to_s</strong>  &#x21d2; Object </a>
@@ -1125,7 +1225,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
-    <span class="summary_desc"><div class='inline'><p>Formats money as a string with customizable format, thousand delimiter, and decimal.</p></div></span>
+    <span class="summary_desc"><div class='inline'></div></span>
 </li>
@@ -1144,7 +1244,7 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
+  <span class="private note title">private</span>
     <span class="summary_desc"><div class='inline'><p>True if amount is zero.</p></div></span>
@@ -1187,12 +1287,12 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
       <pre class="lines">
-24
-25
-26</pre>
+20
+21
+22</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 24</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 20</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_amount'>amount</span>
   <span class='ivar'>@amount</span>
@@ -1228,12 +1328,12 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
       <pre class="lines">
-24
-25
-26</pre>
+20
+21
+22</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 24</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 20</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_currency'>currency</span>
   <span class='ivar'>@currency</span>
@@ -1251,9 +1351,9 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
       <div class="method_details first">
-  <h3 class="signature first" id="create-class_method">
+  <h3 class="signature first" id="compile_formatter-class_method">
-    .<strong>create</strong>(amount, currency)  &#x21d2; <tt>Object</tt>
+    .<strong>compile_formatter</strong>(format_hash, currency, decimal, thousand)  &#x21d2; <tt>Object</tt>
@@ -1261,8 +1361,9 @@ Uses <code>%&lt;symbol&gt;s</code> for the currency symbol and <code>%&lt;amount
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Backwards-compatible alias for previous API
-TODO: deprecate in a future major release</p>
+    <p>Builds and returns a lambda that formats amounts for a fixed
+[format_config, currency, decimal, thousand] combination.
+The lambda is cached by <span class='object_link'><a href="#compiled_formatters-class_method" title="Mint::Money.compiled_formatters (method)">compiled_formatters</a></span>.</p>
   </div>
 </div>
@@ -1275,17 +1376,214 @@ TODO: deprecate in a future major release</p>
       <pre class="lines">
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+67
+68
 69
 70
 71
-72</pre>
+72
+73
+74
+75
+76
+77
+78
+79
+80
+81
+82
+83
+84
+85
+86
+87
+88</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/format/formatting.rb', line 39</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_compile_formatter'>compile_formatter</span><span class='lparen'>(</span><span class='id identifier rubyid_format_hash'>format_hash</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span><span class='comma'>,</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='comma'>,</span> <span class='id identifier rubyid_thousand'>thousand</span><span class='rparen'>)</span> <span class='comment'># rubocop:disable Metrics/MethodLength, Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+</span>  <span class='id identifier rubyid_subunit'>subunit</span> <span class='op'>=</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_subunit'>subunit</span>
+  <span class='id identifier rubyid_has_decimal_substitution'>has_decimal_substitution</span> <span class='op'>=</span> <span class='id identifier rubyid_decimal'>decimal</span> <span class='op'>!=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.</span><span class='tstring_end'>&#39;</span></span>
+  <span class='id identifier rubyid_escaped_decimal'>escaped_decimal</span> <span class='op'>=</span> <span class='const'>Regexp</span><span class='period'>.</span><span class='id identifier rubyid_escape'>escape</span><span class='lparen'>(</span><span class='id identifier rubyid_decimal'>decimal</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_has_thousand_separator'>has_thousand_separator</span> <span class='op'>=</span> <span class='id identifier rubyid_thousand'>thousand</span> <span class='op'>&amp;&amp;</span> <span class='op'>!</span><span class='id identifier rubyid_thousand'>thousand</span><span class='period'>.</span><span class='id identifier rubyid_empty?'>empty?</span>
+  <span class='id identifier rubyid_templates'>templates</span> <span class='op'>=</span> <span class='id identifier rubyid_compile_templates'>compile_templates</span><span class='lparen'>(</span><span class='id identifier rubyid_format_hash'>format_hash</span><span class='comma'>,</span> <span class='id identifier rubyid_subunit'>subunit</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_positive_template'>positive_template</span><span class='comma'>,</span> <span class='id identifier rubyid_negative_template'>negative_template</span><span class='comma'>,</span> <span class='id identifier rubyid_zero_template'>zero_template</span> <span class='op'>=</span> <span class='id identifier rubyid_templates'>templates</span>
+  <span class='comment'># Detect whether templates use %&lt;fractional&gt; and/or %&lt;d-symbol&gt;
+</span>  <span class='id identifier rubyid_all_templates'>all_templates</span> <span class='op'>=</span> <span class='id identifier rubyid_templates'>templates</span><span class='period'>.</span><span class='id identifier rubyid_compact'>compact</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span>
+  <span class='id identifier rubyid_needs_fractional'>needs_fractional</span> <span class='op'>=</span> <span class='id identifier rubyid_all_templates'>all_templates</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;fractional&gt;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_needs_integral'>needs_integral</span> <span class='op'>=</span> <span class='id identifier rubyid_all_templates'>all_templates</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span> <span class='op'>||</span> <span class='id identifier rubyid_all_templates'>all_templates</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;integral&gt;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_multiplier'>multiplier</span> <span class='op'>=</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_fractional_multiplier'>fractional_multiplier</span>
+  <span class='id identifier rubyid_symbol'>symbol</span> <span class='op'>=</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_symbol'>symbol</span>
+  <span class='id identifier rubyid_args'>args</span> <span class='op'>=</span> <span class='lbrace'>{</span>
+    <span class='label'>currency:</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_code'>code</span><span class='comma'>,</span>
+    <span class='label'>dsymbol:</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_disambiguate_symbol'>disambiguate_symbol</span> <span class='op'>||</span> <span class='id identifier rubyid_symbol'>symbol</span><span class='comma'>,</span>
+    <span class='label'>symbol:</span> <span class='id identifier rubyid_symbol'>symbol</span>
+  <span class='rbrace'>}</span>
+  <span class='id identifier rubyid_lambda'>lambda</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_amount'>amount</span><span class='op'>|</span>
+    <span class='id identifier rubyid_format_template'>format_template</span> <span class='op'>=</span> <span class='kw'>if</span> <span class='id identifier rubyid_negative_template'>negative_template</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>&lt;</span> <span class='int'>0</span>
+                        <span class='id identifier rubyid_amount'>amount</span> <span class='op'>=</span> <span class='op'>-</span><span class='id identifier rubyid_amount'>amount</span>
+                        <span class='id identifier rubyid_negative_template'>negative_template</span>
+                      <span class='kw'>elsif</span> <span class='id identifier rubyid_zero_template'>zero_template</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>==</span> <span class='int'>0</span>
+                        <span class='id identifier rubyid_zero_template'>zero_template</span>
+                      <span class='kw'>else</span>
+                        <span class='id identifier rubyid_positive_template'>positive_template</span>
+                      <span class='kw'>end</span>
+    <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='symbol'>:amount</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_amount'>amount</span>
+    <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='symbol'>:integral</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_to_i'>to_i</span>
+    <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='symbol'>:fractional</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_abs'>abs</span> <span class='op'>%</span> <span class='int'>1</span><span class='rparen'>)</span> <span class='op'>*</span> <span class='id identifier rubyid_multiplier'>multiplier</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_i'>to_i</span> <span class='kw'>if</span> <span class='id identifier rubyid_needs_fractional'>needs_fractional</span>
+    <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='id identifier rubyid_format_template'>format_template</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_args'>args</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_gsub!'>gsub!</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(?&lt;=\d)\.(?=\d)</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_has_decimal_substitution'>has_decimal_substitution</span>
+    <span class='kw'>if</span> <span class='id identifier rubyid_needs_integral'>needs_integral</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_has_thousand_separator'>has_thousand_separator</span> <span class='op'>&amp;&amp;</span> <span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span> <span class='op'>&gt;=</span> <span class='int'>1000</span> <span class='op'>||</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>&lt;=</span> <span class='op'>-</span><span class='int'>1000</span><span class='rparen'>)</span>
+      <span class='comment'># Split on the decimal separator between digits only — symbols may contain &#39;.&#39; (e.g. د.إ).
+</span>      <span class='id identifier rubyid_parts'>parts</span> <span class='op'>=</span> <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_split'>split</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(?&lt;=\d)</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_escaped_decimal'>escaped_decimal</span><span class='embexpr_end'>}</span><span class='tstring_content'>(?=\d)</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='int'>2</span><span class='rparen'>)</span>
+      <span class='comment'># Insert the thousands delimiter before each run of 3 digits from the right.
+</span>      <span class='id identifier rubyid_parts'>parts</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_gsub!'>gsub!</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(\d)(?=(?:\d{3})+(?:[^\d]|$))</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='const'>Regexp</span><span class='period'>.</span><span class='id identifier rubyid_last_match'>last_match</span><span class='lparen'>(</span><span class='int'>1</span><span class='rparen'>)</span> <span class='op'>+</span> <span class='id identifier rubyid_thousand'>thousand</span> <span class='rbrace'>}</span>
+      <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='id identifier rubyid_parts'>parts</span><span class='period'>.</span><span class='id identifier rubyid_join'>join</span><span class='lparen'>(</span><span class='id identifier rubyid_decimal'>decimal</span><span class='rparen'>)</span>
+    <span class='kw'>end</span>
+    <span class='id identifier rubyid_result'>result</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="compile_templates-class_method">
+    .<strong>compile_templates</strong>(format_hash, subunit)  &#x21d2; <tt>Object</tt>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Build each sign template with subunit precision baked in, returning a
+frozen Hash of templates keyed by sign (:positive, :negative, :zero).
+Keeps %<symbol>s and %<currency>s as format args so width/padding specifiers work.</p>
+  </div>
+</div>
+<div class="tags">
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/format/formatting.rb', line 14</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_compile_templates'>compile_templates</span><span class='lparen'>(</span><span class='id identifier rubyid_format_hash'>format_hash</span><span class='comma'>,</span> <span class='id identifier rubyid_subunit'>subunit</span><span class='rparen'>)</span>
+  <span class='lbracket'>[</span>
+    <span class='id identifier rubyid_format_hash'>format_hash</span><span class='lbracket'>[</span><span class='symbol'>:positive</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='const'><span class='object_link'><a href="#DEFAULT_FORMAT-constant" title="Mint::Money::DEFAULT_FORMAT (constant)">DEFAULT_FORMAT</a></span></span><span class='comma'>,</span>
+    <span class='id identifier rubyid_format_hash'>format_hash</span><span class='lbracket'>[</span><span class='symbol'>:negative</span><span class='rbracket'>]</span><span class='comma'>,</span>
+    <span class='id identifier rubyid_format_hash'>format_hash</span><span class='lbracket'>[</span><span class='symbol'>:zero</span><span class='rbracket'>]</span>
+  <span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_map'>map</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_sign_format'>sign_format</span><span class='op'>|</span>
+    <span class='kw'>next</span> <span class='kw'>unless</span> <span class='id identifier rubyid_sign_format'>sign_format</span>
+    <span class='comment'># Injects the currency&#39;s subunit precision into %&lt;amount&gt;f specifiers
+</span>    <span class='comment'># (e.g. &#39;%&lt;amount&gt;f&#39; → &#39;%&lt;amount&gt;.2f&#39; for USD), preserving any
+</span>    <span class='comment'># existing width/alignment specifier (e.g. &#39;%&lt;amount&gt;+10f&#39; stays).
+</span>    <span class='id identifier rubyid_sign_format'>sign_format</span> <span class='op'>=</span> <span class='id identifier rubyid_sign_format'>sign_format</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>%&lt;amount&gt;(\s*\+?\d*)f</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>%&lt;amount&gt;\\1.</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_subunit'>subunit</span><span class='embexpr_end'>}</span><span class='tstring_content'>f</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
+    <span class='comment'># For zero-subunit currencies (JPY, KRW, etc.), strip %&lt;fractional&gt;d
+</span>    <span class='comment'># specifiers entirely since there is no fractional part to display.
+</span>    <span class='id identifier rubyid_sign_format'>sign_format</span><span class='period'>.</span><span class='id identifier rubyid_gsub!'>gsub!</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>%&lt;fractional&gt;[^%]*?d</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_subunit'>subunit</span><span class='period'>.</span><span class='id identifier rubyid_zero?'>zero?</span>
+    <span class='id identifier rubyid_sign_format'>sign_format</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="compiled_formatters-class_method">
+    .<strong>compiled_formatters</strong>  &#x21d2; <tt>Object</tt>
+</h3><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+6
+7
+8</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 69</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/format/formatting.rb', line 6</span>
-<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_create'>create</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_warn'>warn</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Money.create is now deprecated. Use Money.from</span><span class='tstring_end'>&#39;</span></span>
-  <span class='id identifier rubyid_from'>from</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span>
+<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_compiled_formatters'>compiled_formatters</span>
+  <span class='ivar'>@compiled_formatters</span> <span class='op'>||=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1324,7 +1622,7 @@ TODO: deprecate in a future major release</p>
         <span class='name'>amount</span>
-        <span class='type'>(<tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -1338,7 +1636,7 @@ TODO: deprecate in a future major release</p>
         <span class='name'>currency</span>
-        <span class='type'>(<tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>, <tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>, <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
@@ -1376,7 +1674,19 @@ TODO: deprecate in a future major release</p>
         &mdash;
-        <div class='inline'><p>If amount is not numeric or currency is invalid</p></div>
+        <div class='inline'><p>If amount is not numeric</p></div>
+    </li>
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="UnknownCurrency.html" title="Mint::UnknownCurrency (class)">Mint::UnknownCurrency</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'><p>If currency cannot be resolved</p></div>
     </li>
@@ -1388,20 +1698,20 @@ TODO: deprecate in a future major release</p>
       <pre class="lines">
-13
 14
 15
 16
 17
 18
 19
-20</pre>
+20
+21</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 13</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 14</span>
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_from'>from</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>amount must be Numeric</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Numeric</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>amount must be Numeric</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></span><span class='rparen'>)</span>
   <span class='id identifier rubyid_currency'>currency</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></span><span class='period'>.</span><span class='id identifier rubyid_resolve!'><span class='object_link'><a href="Currency.html#resolve!-class_method" title="Mint::Currency.resolve! (method)">resolve!</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_amount'>amount</span> <span class='op'>=</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_normalize_amount'>normalize_amount</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='rparen'>)</span>
@@ -1475,7 +1785,7 @@ smallest unit (e.g. cents). Must be an Integer to preserve exactness.</p></div>
         <span class='name'>currency</span>
-        <span class='type'>(<tt>String</tt>, <tt>Symbol</tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>, <tt>Symbol</tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>)</span>
@@ -1513,8 +1823,19 @@ smallest unit (e.g. cents). Must be an Integer to preserve exactness.</p></div>
         &mdash;
-        <div class='inline'><p>if <code>subunits</code> is not an Integer or <code>currency</code>
-is not registered</p></div>
+        <div class='inline'><p>if <code>subunits</code> is not an Integer</p></div>
+    </li>
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="UnknownCurrency.html" title="Mint::UnknownCurrency (class)">Mint::UnknownCurrency</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'><p>if <code>currency</code> is not registered</p></div>
     </li>
@@ -1526,16 +1847,16 @@ is not registered</p></div>
       <pre class="lines">
-92
-93
-94
-95
-96
-97
-98</pre>
+86
+87
+88
+89
+90
+91
+92</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 92</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 86</span>
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_from_subunits'>from_subunits</span><span class='lparen'>(</span><span class='id identifier rubyid_subunits'>subunits</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>subunits must be an Integer</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_subunits'>subunits</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Integer</span><span class='rparen'>)</span>
@@ -1581,7 +1902,7 @@ is not registered</p></div>
         <span class='name'>amount</span>
-        <span class='type'>(<tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -1631,10 +1952,10 @@ is not registered</p></div>
       <pre class="lines">
-29</pre>
+30</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 29</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 30</span>
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_no_currency'>no_currency</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='id identifier rubyid_from'>from</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>XXX</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span></pre>
     </td>
@@ -1684,7 +2005,7 @@ is not registered</p></div>
         <span class='name'>input</span>
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
@@ -1698,7 +2019,7 @@ is not registered</p></div>
         <span class='name'>currency</span>
-        <span class='type'>(<tt>String</tt>, <tt>Symbol</tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>, <tt>nil</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>, <tt>Symbol</tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>, <tt>nil</tt>)</span>
         <em class="default">(defaults to: <tt>nil</tt>)</em>
@@ -1731,10 +2052,10 @@ is not registered</p></div>
       <pre class="lines">
-46</pre>
+47</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 46</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 47</span>
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_input'>input</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_parse'><span class='object_link'><a href="../Mint.html#parse-instance_method" title="Mint#parse (method)">parse</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_input'>input</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span></pre>
     </td>
@@ -1775,7 +2096,7 @@ is not registered</p></div>
         <span class='name'>input</span>
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
@@ -1789,7 +2110,7 @@ is not registered</p></div>
         <span class='name'>currency</span>
-        <span class='type'>(<tt>String</tt>, <tt>Symbol</tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>, <tt>nil</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>, <tt>Symbol</tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>, <tt>nil</tt>)</span>
         <em class="default">(defaults to: <tt>nil</tt>)</em>
@@ -1838,10 +2159,10 @@ is not registered</p></div>
       <pre class="lines">
-58</pre>
+59</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 58</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 59</span>
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_parse!'>parse!</span><span class='lparen'>(</span><span class='id identifier rubyid_input'>input</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_parse!'><span class='object_link'><a href="../Mint.html#parse!-instance_method" title="Mint#parse! (method)">parse!</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_input'>input</span><span class='comma'>,</span> <span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span></pre>
     </td>
@@ -1873,7 +2194,7 @@ is not registered</p></div>
         <span class='name'>currency</span>
-        <span class='type'>(<tt>String</tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>, <tt><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></tt>)</span>
@@ -1906,7 +2227,7 @@ is not registered</p></div>
     <li>
-        <span class='type'>(<tt>ArgumentError</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="UnknownCurrency.html" title="Mint::UnknownCurrency (class)">Mint::UnknownCurrency</a></span></tt>)</span>
@@ -1923,10 +2244,10 @@ is not registered</p></div>
       <pre class="lines">
-65</pre>
+66</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 65</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 66</span>
 <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_zero'>zero</span><span class='lparen'>(</span><span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="Currency.html" title="Mint::Currency (class)">Currency</a></span></span><span class='period'>.</span><span class='id identifier rubyid_resolve!'><span class='object_link'><a href="Currency.html#resolve!-class_method" title="Mint::Currency.resolve! (method)">resolve!</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_currency'>currency</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_zero'><span class='object_link'><a href="Currency.html#zero-class_method" title="Mint::Currency.zero (method)">zero</a></span></span></pre>
     </td>
@@ -1964,7 +2285,7 @@ is not registered</p></div>
         <span class='name'>multiplicand</span>
-        <span class='type'>(<tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -2024,7 +2345,7 @@ is not registered</p></div>
       <pre class="code"><span class="info file"># File 'lib/minting/money/arithmetics/operators.rb', line 42</span>
 <span class='kw'>def</span> <span class='op'>*</span><span class='lparen'>(</span><span class='id identifier rubyid_multiplicand'>multiplicand</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_raise'>raise</span> <span class='const'>TypeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='kw'>self</span><span class='embexpr_end'>}</span><span class='tstring_content'> can&#39;t be multiplied by </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_multiplicand'>multiplicand</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_multiplicand'>multiplicand</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Numeric</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_raise'>raise</span> <span class='const'>TypeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='kw'>self</span><span class='embexpr_end'>}</span><span class='tstring_content'> can&#39;t be multiplied by </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_multiplicand'>multiplicand</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>unless</span> <span class='id identifier rubyid_multiplicand'>multiplicand</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></span><span class='rparen'>)</span>
   <span class='id identifier rubyid_copy_with'>copy_with</span><span class='lparen'>(</span><span class='label'>amount:</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>*</span> <span class='id identifier rubyid_multiplicand'>multiplicand</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
@@ -2057,7 +2378,7 @@ is not registered</p></div>
         <span class='name'>exponent</span>
-        <span class='type'>(<tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -2114,7 +2435,7 @@ is not registered</p></div>
       <pre class="code"><span class="info file"># File 'lib/minting/money/arithmetics/operators.rb', line 67</span>
 <span class='kw'>def</span> <span class='op'>**</span><span class='lparen'>(</span><span class='id identifier rubyid_exponent'>exponent</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='id identifier rubyid_copy_with'>copy_with</span><span class='lparen'>(</span><span class='label'>amount:</span> <span class='id identifier rubyid_amount'>amount</span><span class='op'>**</span><span class='id identifier rubyid_exponent'>exponent</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_exponent'>exponent</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Numeric</span><span class='rparen'>)</span>
+  <span class='kw'>return</span> <span class='id identifier rubyid_copy_with'>copy_with</span><span class='lparen'>(</span><span class='label'>amount:</span> <span class='id identifier rubyid_amount'>amount</span><span class='op'>**</span><span class='id identifier rubyid_exponent'>exponent</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_exponent'>exponent</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></span><span class='rparen'>)</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>TypeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='kw'>self</span><span class='embexpr_end'>}</span><span class='tstring_content'> can&#39;t be powered by </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_exponent'>exponent</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
 <span class='kw'>end</span></pre>
@@ -2147,7 +2468,7 @@ is not registered</p></div>
         <span class='name'>addend</span>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -2244,7 +2565,7 @@ is not registered</p></div>
         <span class='name'>subtrahend</span>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -2371,7 +2692,7 @@ is not registered</p></div>
       <div class="method_details ">
   <h3 class="signature " id="/-instance_method">
-    #<strong>/</strong>(divisor)  &#x21d2; <tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt>Numeric</tt>
+    #<strong>/</strong>(divisor)  &#x21d2; <tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>
@@ -2392,7 +2713,7 @@ is not registered</p></div>
         <span class='name'>divisor</span>
-        <span class='type'>(<tt>Numeric</tt>, <tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>, <tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>)</span>
@@ -2409,7 +2730,7 @@ is not registered</p></div>
     <li>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -2467,7 +2788,7 @@ is not registered</p></div>
 <span class='kw'>def</span> <span class='op'>/</span><span class='lparen'>(</span><span class='id identifier rubyid_divisor'>divisor</span><span class='rparen'>)</span>
   <span class='kw'>case</span> <span class='id identifier rubyid_divisor'>divisor</span>
-  <span class='kw'>when</span> <span class='const'>Numeric</span> <span class='kw'>then</span> <span class='kw'>return</span> <span class='id identifier rubyid_copy_with'>copy_with</span><span class='lparen'>(</span><span class='label'>amount:</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>/</span> <span class='id identifier rubyid_divisor'>divisor</span><span class='rparen'>)</span>
+  <span class='kw'>when</span> <span class='const'><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></span> <span class='kw'>then</span> <span class='kw'>return</span> <span class='id identifier rubyid_copy_with'>copy_with</span><span class='lparen'>(</span><span class='label'>amount:</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>/</span> <span class='id identifier rubyid_divisor'>divisor</span><span class='rparen'>)</span>
   <span class='kw'>when</span> <span class='const'><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></span>   <span class='kw'>then</span> <span class='kw'>return</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>/</span> <span class='id identifier rubyid_divisor'>divisor</span><span class='period'>.</span><span class='id identifier rubyid_amount'>amount</span> <span class='kw'>if</span> <span class='id identifier rubyid_same_currency?'>same_currency?</span> <span class='id identifier rubyid_divisor'>divisor</span>
   <span class='kw'>end</span>
   <span class='id identifier rubyid_raise'>raise</span> <span class='const'>TypeError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='kw'>self</span><span class='embexpr_end'>}</span><span class='tstring_content'> can&#39;t be divided by </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_divisor'>divisor</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
@@ -2488,7 +2809,11 @@ is not registered</p></div>
 </h3><div class="docstring">
   <div class="discussion">
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
   </div>
 </div>
@@ -2549,7 +2874,11 @@ two_usd &gt; Mint.money(2, &#39;BRL&#39;)
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns true if both are zero, or both have same amount and same currency.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Returns true if both are zero, or both have same amount and same currency.</p>
   </div>
 </div>
@@ -2688,7 +3017,7 @@ Disperses any subunit rounding amounts across the initial slots</p>
         <span class='name'>proportions</span>
-        <span class='type'>(<tt>Array&lt;Numeric&gt;</tt>)</span>
+        <span class='type'>(<tt>Array&lt;<span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span>&gt;</tt>)</span>
@@ -2761,6 +3090,80 @@ Disperses any subunit rounding amounts across the initial slots</p>
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="amount_to_s-instance_method">
+    #<strong>amount_to_s</strong>(thousand: &#39;,&#39;)  &#x21d2; <tt>Object</tt>
+</h3><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+115
+116
+117
+118
+119
+120
+121
+122
+123
+124
+125
+126
+127
+128
+129
+130
+131
+132
+133
+134
+135
+136
+137
+138
+139</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/format/to_s.rb', line 115</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_amount_to_s'>amount_to_s</span><span class='lparen'>(</span><span class='label'>thousand:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_subunit'>subunit</span> <span class='op'>=</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_subunit'>subunit</span>
+  <span class='id identifier rubyid_numeric'>numeric</span> <span class='op'>=</span> <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>%.</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_subunit'>subunit</span><span class='embexpr_end'>}</span><span class='tstring_content'>f</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_amount'>amount</span><span class='rparen'>)</span>
+  <span class='kw'>return</span> <span class='id identifier rubyid_numeric'>numeric</span> <span class='kw'>if</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>&gt;</span> <span class='op'>-</span><span class='int'>1000</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_amount'>amount</span> <span class='op'>&lt;</span> <span class='int'>1000</span>
+  <span class='id identifier rubyid_numeric'>numeric</span><span class='period'>.</span><span class='id identifier rubyid_reverse!'>reverse!</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_subunit'>subunit</span> <span class='op'>&gt;</span> <span class='int'>0</span>
+    <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='id identifier rubyid_numeric'>numeric</span><span class='lbracket'>[</span><span class='int'>0</span><span class='comma'>,</span> <span class='id identifier rubyid_subunit'>subunit</span> <span class='op'>+</span> <span class='int'>1</span><span class='rbracket'>]</span>
+    <span class='id identifier rubyid_integral'>integral</span> <span class='op'>=</span> <span class='id identifier rubyid_numeric'>numeric</span><span class='lbracket'>[</span><span class='id identifier rubyid_subunit'>subunit</span> <span class='op'>+</span> <span class='int'>1</span><span class='comma'>,</span> <span class='id identifier rubyid_numeric'>numeric</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span> <span class='op'>-</span> <span class='int'>1</span><span class='rbracket'>]</span>
+  <span class='kw'>else</span>
+    <span class='id identifier rubyid_result'>result</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+    <span class='id identifier rubyid_integral'>integral</span> <span class='op'>=</span> <span class='id identifier rubyid_numeric'>numeric</span>
+  <span class='kw'>end</span>
+  <span class='id identifier rubyid_length'>length</span> <span class='op'>=</span> <span class='id identifier rubyid_integral'>integral</span><span class='period'>.</span><span class='id identifier rubyid_length'>length</span>
+  <span class='comment'>#puts &quot;numeric: #{numeric} subunit: #{subunit} result: &lt;#{result}&gt; integral:#{integral}&quot; if self == Mint.money(-123_456_789.01, &#39;USD&#39;)
+</span>
+  <span class='id identifier rubyid_integral'>integral</span><span class='period'>.</span><span class='id identifier rubyid_chars'>chars</span><span class='period'>.</span><span class='id identifier rubyid_each_with_index'>each_with_index</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_char'>char</span><span class='comma'>,</span> <span class='id identifier rubyid_index'>index</span><span class='op'>|</span>
+    <span class='id identifier rubyid_remaining'>remaining</span> <span class='op'>=</span> <span class='id identifier rubyid_length'>length</span> <span class='op'>-</span> <span class='id identifier rubyid_index'>index</span>
+    <span class='id identifier rubyid_result'>result</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_thousand'>thousand</span> <span class='kw'>if</span> <span class='id identifier rubyid_index'>index</span> <span class='op'>&gt;</span> <span class='int'>0</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_remaining'>remaining</span> <span class='op'>&gt;</span> <span class='int'>0</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_index'>index</span> <span class='op'>%</span> <span class='int'>3</span> <span class='op'>==</span> <span class='int'>0</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_char'>char</span> <span class='op'>!=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>-</span><span class='tstring_end'>&#39;</span></span>
+    <span class='id identifier rubyid_result'>result</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_char'>char</span>
+  <span class='kw'>end</span>
+  <span class='id identifier rubyid_result'>result</span><span class='period'>.</span><span class='id identifier rubyid_reverse'>reverse</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -2827,7 +3230,7 @@ frozen <span class='object_link'><a href="" title="Mint::Money (class)">Mint::Mo
         <span class='name'>min_or_range</span>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt>Numeric</tt>, <tt>Range</tt>, <tt>nil</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>, <tt>Range</tt>, <tt>nil</tt>)</span>
@@ -2841,7 +3244,7 @@ frozen <span class='object_link'><a href="" title="Mint::Money (class)">Mint::Mo
         <span class='name'>max</span>
-        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt>Numeric</tt>, <tt>nil</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="" title="Mint::Money (class)">Money</a></span></tt>, <tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>, <tt>nil</tt>)</span>
         <em class="default">(defaults to: <tt>nil</tt>)</em>
@@ -2962,7 +3365,7 @@ This enables expressions like <code>5 * money</code> where <code>5</code> is a N
         <span class='name'>other</span>
-        <span class='type'>(<tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -3047,7 +3450,7 @@ while preserving immutability.</p>
         <span class='name'>amount</span>
-        <span class='type'>(<tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -3081,20 +3484,20 @@ while preserving immutability.</p>
       <pre class="lines">
+104
+105
+106
+107
+108
+109
 110
 111
 112
 113
-114
-115
-116
-117
-118
-119
-120</pre>
+114</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 110</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 104</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_copy_with'>copy_with</span><span class='lparen'>(</span><span class='label'>amount:</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_amount'>amount</span> <span class='op'>=</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_normalize_amount'>normalize_amount</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='rparen'>)</span>
@@ -3115,7 +3518,7 @@ while preserving immutability.</p>
       <div class="method_details ">
   <h3 class="signature " id="currency_code-instance_method">
-    #<strong>currency_code</strong>  &#x21d2; <tt>String</tt>
+    #<strong>currency_code</strong>  &#x21d2; <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>
@@ -3143,7 +3546,7 @@ while preserving immutability.</p>
     <li>
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
@@ -3160,10 +3563,10 @@ while preserving immutability.</p>
       <pre class="lines">
-31</pre>
+27</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 31</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 27</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_currency_code'>currency_code</span> <span class='op'>=</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_code'>code</span></pre>
     </td>
@@ -3182,7 +3585,11 @@ while preserving immutability.</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Strict equality — both amount and currency must match exactly.
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Strict equality — both amount and currency must match exactly.
 Unlike ==, does not treat zero as equivalent across currencies.</p>
   </div>
@@ -3226,6 +3633,265 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
     </td>
   </tr>
 </table>
+</div>
+      <div class="method_details ">
+  <h3 class="signature " id="format-instance_method">
+    #<strong>format</strong>(preset = nil, format: nil, decimal: nil, thousand: nil, width: nil)  &#x21d2; <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>
+    <span class="aliases">Also known as:
+    <span class="names"><span id='to_fs-instance_method'>to_fs</span></span>
+    </span>
+</h3><div class="docstring">
+  <div class="discussion">
+    <p>Formats money as a string with customizable format, thousand delimiter, and decimal</p>
+  </div>
+</div>
+<div class="tags">
+  <div class="examples">
+    <h4 class="tag_title">Examples:</h4>
+        <h5 class="example_title"><div class='inline'><p>Basic formatting</p></div></h5>
+      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='float'>1234.56</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span>                               <span class='comment'>#=&gt; &quot;$1,234.56&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>thousand:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>decimal:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>  <span class='comment'>#=&gt; &quot;$1.234,56&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>decimal:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>thousand:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>   <span class='comment'>#=&gt; &quot;$1234,56&quot;</span></code></pre>
+        <h5 class="example_title"><div class='inline'><p>Preset formats</p></div></h5>
+      <pre class="example code"><code><span class='id identifier rubyid_loss'>loss</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='op'>-</span><span class='float'>1234.56</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='id identifier rubyid_loss'>loss</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='symbol'>:accounting</span><span class='rparen'>)</span>                   <span class='comment'>#=&gt; &quot;($1,234.56)&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='symbol'>:european</span><span class='rparen'>)</span>                    <span class='comment'>#=&gt; &quot;1.234,56 €&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='symbol'>:amount</span><span class='rparen'>)</span>                      <span class='comment'>#=&gt; &quot;1234.56&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='symbol'>:currency</span><span class='rparen'>)</span>                    <span class='comment'>#=&gt; &quot;USD 1234.56&quot;</span></code></pre>
+        <h5 class="example_title"><div class='inline'><p>Custom formats</p></div></h5>
+      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>                    <span class='comment'>#=&gt; &quot;1234.56&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;currency&gt;s %&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>       <span class='comment'>#=&gt; &quot;USD 1234.56&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;f %&lt;symbol&gt;s</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>         <span class='comment'>#=&gt; &quot;1234.56 $&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;symbol&gt;s%&lt;amount&gt;+f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>         <span class='comment'>#=&gt; &quot;$+1234.56&quot;</span></code></pre>
+        <h5 class="example_title"><div class='inline'><p>Integral &amp; fractional parts</p></div></h5>
+      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;integral&gt;d.%&lt;fractional&gt;02d</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>  <span class='comment'>#=&gt; &quot;1234.56&quot;
+</span><span class='id identifier rubyid_price'>price</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='float'>0.99</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='id identifier rubyid_price'>price</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;integral&gt;d dollars and %&lt;fractional&gt;02d cents</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='comment'>#=&gt; &quot;0 dollars and 99 cents&quot;</span></code></pre>
+        <h5 class="example_title"><div class='inline'><p>Per-sign Hash format (accounting parentheses)</p></div></h5>
+      <pre class="example code"><code><span class='id identifier rubyid_loss'>loss</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='op'>-</span><span class='float'>1234.56</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
+<span class='id identifier rubyid_loss'>loss</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='lbrace'>{</span> <span class='label'>negative:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>(%&lt;symbol&gt;s%&lt;amount&gt;f)</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='rparen'>)</span> <span class='comment'>#=&gt; &quot;($1,234.56)&quot;
+</span><span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='int'>0</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>BRL</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='lbrace'>{</span> <span class='label'>zero:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>--</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='rparen'>)</span>        <span class='comment'>#=&gt; &quot;--&quot;</span></code></pre>
+        <h5 class="example_title"><div class='inline'><p>Padding and alignment</p></div></h5>
+      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;10.2f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>                <span class='comment'>#=&gt; &quot;   1234.56&quot;
+</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;symbol&gt;s%&lt;amount&gt;010.2f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>     <span class='comment'>#=&gt; &quot;$0001234.56&quot;</span></code></pre>
+        <h5 class="example_title"><div class='inline'><p>Locale-aware formatting (with Mint.locale_backend set)</p></div></h5>
+      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span>  <span class='comment'># decimal and thousand come from locale_backend</span></code></pre>
+  </div>
+<p class="tag_title">Parameters:</p>
+<ul class="param">
+    <li>
+        <span class='name'>preset</span>
+        <span class='type'>(<tt>Symbol</tt>, <tt>nil</tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        &mdash;
+        <div class='inline'><p>Named format preset, one of:
+<code>:accounting</code>, <code>:european</code>, <code>:amount</code>, <code>:currency</code>.
+When provided, expands to the preset's format options and merges
+with any explicit keyword arguments (kwargs override the preset).</p></div>
+    </li>
+    <li>
+        <span class='name'>format</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>, <tt>Hash</tt>, <tt>nil</tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        &mdash;
+        <div class='inline'><p>Either a Format string with placeholders
+(%<symbol>s, %<amount>f, %<currency>s, %<integral>d, %<fractional>d, %<dsymbol>s),
+or a Hash with per-sign keys (:positive, :negative, :zero) each
+holding a format string. A Hash is convenient for sign-aware formats
+such as accounting parentheses:</p>
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='lbrace'>{</span> <span class='label'>negative:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>(%&lt;symbol&gt;s%&lt;amount&gt;f)</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='rparen'>)</span>
+</code></pre>
+<p>Missing keys fall back to the module default, so a Hash with only
+:negative will still format positives sensibly. The valid keys are
+:positive, :negative, :zero; anything else raises ArgumentError.
+When <code>nil</code>, falls back to <code>Mint.locale_backend</code> if set, otherwise
+<code>&quot;%&lt;symbol&gt;s%&lt;amount&gt;f&quot;</code>.</p></div>
+    </li>
+    <li>
+        <span class='name'>thousand</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>, <tt>false</tt>, <tt>nil</tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        &mdash;
+        <div class='inline'><p>Thousands delimiter (e.g., ',' for 1,000).
+When <code>nil</code>, falls back to <code>Mint.locale_backend</code> if set, otherwise <code>&quot;,&quot;</code>.</p></div>
+    </li>
+    <li>
+        <span class='name'>decimal</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>, <tt>nil</tt>)</span>
+        <em class="default">(defaults to: <tt>nil</tt>)</em>
+        &mdash;
+        <div class='inline'><p>Decimal separator (e.g., '.' or ',').
+When <code>nil</code>, falls back to <code>Mint.locale_backend</code> if set, otherwise <code>&quot;.&quot;</code>.</p></div>
+    </li>
+</ul>
+<p class="tag_title">Returns:</p>
+<ul class="return">
+    <li>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
+        &mdash;
+        <div class='inline'><p>Formatted money string</p></div>
+    </li>
+</ul>
+<p class="tag_title">Raises:</p>
+<ul class="raise">
+    <li>
+        <span class='type'>(<tt>ArgumentError</tt>)</span>
+        &mdash;
+        <div class='inline'><p>if <code>preset</code> is not a recognised name, or if
+<code>format</code> is not a String or Hash, the Hash is empty, or the Hash
+contains an unrecognised key.</p></div>
+    </li>
+</ul>
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+85
+86
+87
+88
+89
+90
+91
+92
+93
+94
+95
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107
+108</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/format/to_s.rb', line 85</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='id identifier rubyid_preset'>preset</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>format:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>decimal:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>thousand:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>width:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_preset'>preset</span>
+    <span class='id identifier rubyid_config'>config</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="#PRESETS-constant" title="Mint::Money::PRESETS (constant)">PRESETS</a></span></span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='id identifier rubyid_preset'>preset</span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Unknown format preset: </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_preset'>preset</span><span class='period'>.</span><span class='id identifier rubyid_inspect'>inspect</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span> <span class='rbrace'>}</span>
+    <span class='id identifier rubyid_format'>format</span> <span class='op'>||=</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:format</span><span class='rbracket'>]</span>
+    <span class='id identifier rubyid_decimal'>decimal</span> <span class='op'>||=</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:decimal</span><span class='rbracket'>]</span>
+    <span class='id identifier rubyid_thousand'>thousand</span> <span class='op'>||=</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:thousand</span><span class='rbracket'>]</span>
+    <span class='id identifier rubyid_width'>width</span> <span class='op'>||=</span> <span class='id identifier rubyid_config'>config</span><span class='lbracket'>[</span><span class='symbol'>:width</span><span class='rbracket'>]</span>
+  <span class='kw'>end</span>
+  <span class='id identifier rubyid_validate_separators!'>validate_separators!</span><span class='lparen'>(</span><span class='label'>decimal:</span><span class='comma'>,</span> <span class='label'>thousand:</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='comma'>,</span> <span class='id identifier rubyid_thousand'>thousand</span> <span class='op'>=</span> <span class='id identifier rubyid_resolve_locale_for'>resolve_locale_for</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='comma'>,</span> <span class='id identifier rubyid_thousand'>thousand</span><span class='rparen'>)</span>
+  <span class='kw'>case</span> <span class='id identifier rubyid_format'>format</span>
+  <span class='kw'>when</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>then</span> <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>format must not be empty</span><span class='tstring_end'>&#39;</span></span>
+  <span class='kw'>when</span> <span class='const'>Hash</span>   <span class='kw'>then</span> <span class='id identifier rubyid_validate_format_hash'>validate_format_hash</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span>
+  <span class='kw'>when</span> <span class='const'><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></span> <span class='kw'>then</span> <span class='id identifier rubyid_format'>format</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='label'>positive:</span> <span class='id identifier rubyid_format'>format</span> <span class='rbrace'>}</span>
+  <span class='kw'>else</span>        <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Invalid format. Only String or Hash are accepted</span><span class='tstring_end'>&#39;</span></span>
+  <span class='kw'>end</span>
+  <span class='id identifier rubyid_formatted'>formatted</span> <span class='op'>=</span> <span class='id identifier rubyid_format_amount'>format_amount</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='label'>decimal:</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='comma'>,</span> <span class='label'>thousand:</span> <span class='id identifier rubyid_thousand'>thousand</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_width'>width</span> <span class='op'>?</span> <span class='id identifier rubyid_formatted'>formatted</span><span class='period'>.</span><span class='id identifier rubyid_rjust'>rjust</span><span class='lparen'>(</span><span class='id identifier rubyid_width'>width</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='id identifier rubyid_formatted'>formatted</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
       <div class="method_details ">
@@ -3262,10 +3928,10 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
       <pre class="lines">
-48</pre>
+44</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 48</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 44</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_fractional'>fractional</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_abs'>abs</span> <span class='op'>%</span> <span class='int'>1</span><span class='rparen'>)</span> <span class='op'>*</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_fractional_multiplier'>fractional_multiplier</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_i'>to_i</span></pre>
     </td>
@@ -3313,10 +3979,10 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
       <pre class="lines">
-53</pre>
+49</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 53</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 49</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_hash'>hash</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='id identifier rubyid_amount'>amount</span><span class='comma'>,</span> <span class='id identifier rubyid_currency_code'>currency_code</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_hash'>hash</span></pre>
     </td>
@@ -3327,7 +3993,7 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
       <div class="method_details ">
   <h3 class="signature " id="inspect-instance_method">
-    #<strong>inspect</strong>  &#x21d2; <tt>String</tt>
+    #<strong>inspect</strong>  &#x21d2; <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>
@@ -3347,7 +4013,7 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
     <li>
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
@@ -3364,12 +4030,12 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
       <pre class="lines">
-58
-59
-60</pre>
+54
+55
+56</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 58</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 54</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_inspect'>inspect</span>
   <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>[</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_currency_code'>currency_code</span><span class='embexpr_end'>}</span><span class='tstring_content'> %0.</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_subunit'>subunit</span><span class='embexpr_end'>}</span><span class='tstring_content'>f]</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_amount'>amount</span>
@@ -3412,7 +4078,7 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
         <span class='name'>new_amount</span>
-        <span class='type'>(<tt>Numeric</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../Numeric.html" title="Numeric (class)">Numeric</a></span></tt>)</span>
@@ -3446,13 +4112,13 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
       <pre class="lines">
-129
-130
-131
-132</pre>
+123
+124
+125
+126</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 129</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/constructors.rb', line 123</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_mint'>mint</span><span class='lparen'>(</span><span class='id identifier rubyid_new_amount'>new_amount</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_warn'>warn</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Money#mint is now deprecated and will be removed in v2</span><span class='tstring_end'>&#39;</span></span>
@@ -3525,7 +4191,11 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns self if amount is non-zero, nil otherwise.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Returns self if amount is non-zero, nil otherwise.</p>
   </div>
 </div>
@@ -3627,7 +4297,11 @@ Unlike ==, does not treat zero as equivalent across currencies.</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Helper method to verify if another Money has the identical currency.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Helper method to verify if another Money has the identical currency.</p>
   </div>
 </div>
@@ -3846,10 +4520,10 @@ For example, cents for USD (subunit 2), yen for JPY (subunit 0), fils for IQD (s
       <pre class="lines">
-41</pre>
+37</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 41</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/money.rb', line 37</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_subunits'>subunits</span> <span class='op'>=</span> <span class='lparen'>(</span><span class='id identifier rubyid_amount'>amount</span> <span class='op'>*</span> <span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_fractional_multiplier'>fractional_multiplier</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_i'>to_i</span></pre>
     </td>
@@ -3920,7 +4594,11 @@ Enables standard ranges and stepping (e.g. <code>1.dollar..10.dollars</code>).</
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Converts the monetary amount to a BigDecimal object.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Converts the monetary amount to a BigDecimal object.</p>
   </div>
 </div>
@@ -3957,10 +4635,10 @@ Enables standard ranges and stepping (e.g. <code>1.dollar..10.dollars</code>).</
       <pre class="lines">
-14</pre>
+15</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 14</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 15</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_d'>to_d</span> <span class='op'>=</span> <span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_to_d'>to_d</span> <span class='int'>0</span></pre>
     </td>
@@ -3979,7 +4657,11 @@ Enables standard ranges and stepping (e.g. <code>1.dollar..10.dollars</code>).</
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Converts the monetary amount to a standard float.
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Converts the monetary amount to a standard float.
 Note: Using float conversion loses precision guarantees.</p>
   </div>
@@ -4009,10 +4691,10 @@ Note: Using float conversion loses precision guarantees.</p>
       <pre class="lines">
-20</pre>
+21</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 20</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 21</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_f'>to_f</span> <span class='op'>=</span> <span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_to_f'>to_f</span></pre>
     </td>
@@ -4031,7 +4713,11 @@ Note: Using float conversion loses precision guarantees.</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns a Hash representation of the money instance.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Returns a Hash representation of the money instance.</p>
   </div>
 </div>
@@ -4069,12 +4755,12 @@ Note: Using float conversion loses precision guarantees.</p>
       <pre class="lines">
-47
 48
-49</pre>
+49
+50</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 47</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 48</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_hash'>to_hash</span>
   <span class='lbrace'>{</span> <span class='label'>currency:</span> <span class='id identifier rubyid_currency_code'>currency_code</span><span class='comma'>,</span> <span class='label'>amount:</span> <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>%0.</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_subunit'>subunit</span><span class='embexpr_end'>}</span><span class='tstring_content'>f</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_amount'>amount</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
@@ -4087,7 +4773,7 @@ Note: Using float conversion loses precision guarantees.</p>
       <div class="method_details ">
   <h3 class="signature " id="to_html-instance_method">
-    #<strong>to_html</strong>(format = DEFAULT_FORMAT)  &#x21d2; <tt>String</tt>
+    #<strong>to_html</strong>(format = DEFAULT_FORMAT)  &#x21d2; <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>
@@ -4095,7 +4781,11 @@ Note: Using float conversion loses precision guarantees.</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Renders a safe HTML5 <code>&lt;data&gt;</code> element containing the formatted currency.
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Renders a safe HTML5 <code>&lt;data&gt;</code> element containing the formatted currency.
 Embeds the ISO currency description and raw value as the metadata <code>title</code> attribute.</p>
   </div>
@@ -4109,7 +4799,7 @@ Embeds the ISO currency description and raw value as the metadata <code>title</c
         <span class='name'>format</span>
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
         <em class="default">(defaults to: <tt>DEFAULT_FORMAT</tt>)</em>
@@ -4128,7 +4818,7 @@ Embeds the ISO currency description and raw value as the metadata <code>title</c
     <li>
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
@@ -4145,18 +4835,18 @@ Embeds the ISO currency description and raw value as the metadata <code>title</c
       <pre class="lines">
-27
 28
 29
 30
-31</pre>
+31
+32</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 27</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 28</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_html'>to_html</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="#DEFAULT_FORMAT-constant" title="Mint::Money::DEFAULT_FORMAT (constant)">DEFAULT_FORMAT</a></span></span><span class='rparen'>)</span>
   <span class='id identifier rubyid_title'>title</span> <span class='op'>=</span> <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_currency_code'>currency_code</span><span class='embexpr_end'>}</span><span class='tstring_content'> %0.</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_subunit'>subunit</span><span class='embexpr_end'>}</span><span class='tstring_content'>f</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='id identifier rubyid_amount'>amount</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_body'>body</span> <span class='op'>=</span> <span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_body'>body</span> <span class='op'>=</span> <span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span>
   <span class='tstring'><span class='tstring_beg'>%(</span><span class='tstring_content'>&lt;data class=&#39;money&#39; title=&#39;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_title'>title</span><span class='embexpr_end'>}</span><span class='tstring_content'>&#39;&gt;</span><span class='embexpr_beg'>#{</span><span class='const'>ERB</span><span class='op'>::</span><span class='const'>Util</span><span class='period'>.</span><span class='id identifier rubyid_html_escape'>html_escape</span><span class='lparen'>(</span><span class='id identifier rubyid_body'>body</span><span class='rparen'>)</span><span class='embexpr_end'>}</span><span class='tstring_content'>&lt;/data&gt;</span><span class='tstring_end'>)</span></span>
 <span class='kw'>end</span></pre>
     </td>
@@ -4175,7 +4865,11 @@ Embeds the ISO currency description and raw value as the metadata <code>title</c
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Truncates and converts the monetary amount to an Integer.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Truncates and converts the monetary amount to an Integer.</p>
   </div>
 </div>
@@ -4213,10 +4907,10 @@ Embeds the ISO currency description and raw value as the metadata <code>title</c
       <pre class="lines">
-39</pre>
+40</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 39</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 40</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_i'>to_i</span> <span class='op'>=</span> <span class='id identifier rubyid_amount'>amount</span><span class='period'>.</span><span class='id identifier rubyid_to_i'>to_i</span></pre>
     </td>
@@ -4227,7 +4921,7 @@ Embeds the ISO currency description and raw value as the metadata <code>title</c
       <div class="method_details ">
   <h3 class="signature " id="to_json-instance_method">
-    #<strong>to_json</strong>(*_args)  &#x21d2; <tt>String</tt>
+    #<strong>to_json</strong>(*_args)  &#x21d2; <tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>
@@ -4235,7 +4929,11 @@ Embeds the ISO currency description and raw value as the metadata <code>title</c
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Serializes the money instance to a standard JSON object containing the amount and currency.
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Serializes the money instance to a standard JSON object containing the amount and currency.
 Highly optimized to run without external dependencies.</p>
   </div>
@@ -4248,7 +4946,7 @@ Highly optimized to run without external dependencies.</p>
     <li>
-        <span class='type'>(<tt>String</tt>)</span>
+        <span class='type'>(<tt><span class='object_link'><a href="../String.html" title="String (class)">String</a></span></tt>)</span>
@@ -4265,14 +4963,14 @@ Highly optimized to run without external dependencies.</p>
       <pre class="lines">
-55
 56
 57
 58
-59</pre>
+59
+60</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 55</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 56</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_json'>to_json</span><span class='lparen'>(</span><span class='op'>*</span><span class='id identifier rubyid__args'>_args</span><span class='rparen'>)</span>
   <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_format'>format</span><span class='lparen'>(</span>
@@ -4295,7 +4993,11 @@ Highly optimized to run without external dependencies.</p>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns the exact internal Rational representation of the monetary amount.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Returns the exact internal Rational representation of the monetary amount.</p>
   </div>
 </div>
@@ -4324,10 +5026,10 @@ Highly optimized to run without external dependencies.</p>
       <pre class="lines">
-64</pre>
+65</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 64</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/conversion.rb', line 65</span>
 <span class='kw'>def</span> <span class='id identifier rubyid_to_r'>to_r</span> <span class='op'>=</span> <span class='id identifier rubyid_amount'>amount</span></pre>
     </td>
@@ -4338,203 +5040,29 @@ Highly optimized to run without external dependencies.</p>
       <div class="method_details ">
   <h3 class="signature " id="to_s-instance_method">
-    #<strong>to_s</strong>(format: nil, decimal: nil, thousand: nil, width: nil)  &#x21d2; <tt>String</tt>
+    #<strong>to_s</strong>  &#x21d2; <tt>Object</tt>
-</h3><div class="docstring">
-  <div class="discussion">
-    <p>Formats money as a string with customizable format, thousand delimiter, and decimal</p>
-  </div>
-</div>
-<div class="tags">
-  <div class="examples">
-    <h4 class="tag_title">Examples:</h4>
-        <h5 class="example_title"><div class='inline'><p>Basic formatting</p></div></h5>
-      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='float'>1234.56</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-<span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span>                               <span class='comment'>#=&gt; &quot;$1,234.56&quot;
-</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>thousand:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>.</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>decimal:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>  <span class='comment'>#=&gt; &quot;$1.234,56&quot;
-</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>decimal:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>,</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='label'>thousand:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>   <span class='comment'>#=&gt; &quot;$1234,56&quot;</span></code></pre>
-        <h5 class="example_title"><div class='inline'><p>Custom formats</p></div></h5>
-      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>                    <span class='comment'>#=&gt; &quot;1234.56&quot;
-</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;currency&gt;s %&lt;amount&gt;f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>       <span class='comment'>#=&gt; &quot;USD 1234.56&quot;
-</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;f %&lt;symbol&gt;s</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>         <span class='comment'>#=&gt; &quot;1234.56 $&quot;
-</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;symbol&gt;s%&lt;amount&gt;+f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>         <span class='comment'>#=&gt; &quot;$+1234.56&quot;</span></code></pre>
-        <h5 class="example_title"><div class='inline'><p>Integral &amp; fractional parts</p></div></h5>
-      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;integral&gt;d.%&lt;fractional&gt;02d</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>  <span class='comment'>#=&gt; &quot;1234.56&quot;
-</span><span class='id identifier rubyid_price'>price</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='float'>0.99</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-<span class='id identifier rubyid_price'>price</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;integral&gt;d dollars and %&lt;fractional&gt;02d cents</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-<span class='comment'>#=&gt; &quot;0 dollars and 99 cents&quot;</span></code></pre>
-        <h5 class="example_title"><div class='inline'><p>Per-sign Hash format (accounting parentheses)</p></div></h5>
-      <pre class="example code"><code><span class='id identifier rubyid_loss'>loss</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='op'>-</span><span class='float'>1234.56</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>USD</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>
-<span class='id identifier rubyid_loss'>loss</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='lbrace'>{</span> <span class='label'>negative:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>(%&lt;symbol&gt;s%&lt;amount&gt;f)</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='rparen'>)</span> <span class='comment'>#=&gt; &quot;($1,234.56)&quot;
-</span><span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_money'><span class='object_link'><a href="../Mint.html#money-class_method" title="Mint.money (method)">money</a></span></span><span class='lparen'>(</span><span class='int'>0</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>BRL</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='lbrace'>{</span> <span class='label'>zero:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>--</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='rparen'>)</span>        <span class='comment'>#=&gt; &quot;--&quot;</span></code></pre>
-        <h5 class="example_title"><div class='inline'><p>Padding and alignment</p></div></h5>
-      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;amount&gt;10.2f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>                <span class='comment'>#=&gt; &quot;   1234.56&quot;
-</span><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>%&lt;symbol&gt;s%&lt;amount&gt;010.2f</span><span class='tstring_end'>&#39;</span></span><span class='rparen'>)</span>     <span class='comment'>#=&gt; &quot;$0001234.56&quot;</span></code></pre>
-        <h5 class="example_title"><div class='inline'><p>Locale-aware formatting (with Mint.locale_backend set)</p></div></h5>
-      <pre class="example code"><code><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span>  <span class='comment'># decimal and thousand come from locale_backend</span></code></pre>
-  </div>
-<p class="tag_title">Parameters:</p>
-<ul class="param">
-    <li>
-        <span class='name'>format</span>
-        <span class='type'>(<tt>String</tt>, <tt>Hash</tt>, <tt>nil</tt>)</span>
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
-        &mdash;
-        <div class='inline'><p>Either a Format string with placeholders
-(%<symbol>s, %<amount>f, %<currency>s, %<integral>d, %<fractional>d),
-or a Hash with per-sign keys (:positive, :negative, :zero) each
-holding a format string. A Hash is convenient for sign-aware formats
-such as accounting parentheses:</p>
-<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_money'>money</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='lbrace'>{</span> <span class='label'>negative:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>(%&lt;symbol&gt;s%&lt;amount&gt;f)</span><span class='tstring_end'>&#39;</span></span> <span class='rbrace'>}</span><span class='rparen'>)</span>
-</code></pre>
-<p>Missing keys fall back to the module default, so a Hash with only
-:negative will still format positives sensibly. The valid keys are
-:positive, :negative, :zero; anything else raises ArgumentError.
-When <code>nil</code>, falls back to <code>Mint.locale_backend</code> if set, otherwise
-<code>&quot;%&lt;symbol&gt;s%&lt;amount&gt;f&quot;</code>.</p></div>
-    </li>
-    <li>
-        <span class='name'>thousand</span>
-        <span class='type'>(<tt>String</tt>, <tt>false</tt>, <tt>nil</tt>)</span>
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
-        &mdash;
-        <div class='inline'><p>Thousands delimiter (e.g., ',' for 1,000).
-When <code>nil</code>, falls back to <code>Mint.locale_backend</code> if set, otherwise <code>&quot;,&quot;</code>.</p></div>
-    </li>
-    <li>
-        <span class='name'>decimal</span>
-        <span class='type'>(<tt>String</tt>, <tt>nil</tt>)</span>
-        <em class="default">(defaults to: <tt>nil</tt>)</em>
-        &mdash;
-        <div class='inline'><p>Decimal separator (e.g., '.' or ',').
-When <code>nil</code>, falls back to <code>Mint.locale_backend</code> if set, otherwise <code>&quot;.&quot;</code>.</p></div>
-    </li>
-</ul>
-<p class="tag_title">Returns:</p>
-<ul class="return">
-    <li>
-        <span class='type'>(<tt>String</tt>)</span>
-        &mdash;
-        <div class='inline'><p>Formatted money string</p></div>
-    </li>
-</ul>
-<p class="tag_title">Raises:</p>
-<ul class="raise">
-    <li>
-        <span class='type'>(<tt>ArgumentError</tt>)</span>
-        &mdash;
-        <div class='inline'><p>if <code>format</code> is not a String or Hash, the Hash
-is empty, or the Hash contains an unrecognised key.</p></div>
-    </li>
-</ul>
-</div><table class="source_code">
+</h3><table class="source_code">
   <tr>
     <td>
       <pre class="lines">
-60
-61
-62
-63
-64
-65
-66
-67
-68
-69
-70
-71
-72
-73</pre>
+110
+111
+112
+113</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/minting/money/format/to_s.rb', line 60</span>
+      <pre class="code"><span class="info file"># File 'lib/minting/money/format/to_s.rb', line 110</span>
-<span class='kw'>def</span> <span class='id identifier rubyid_to_s'>to_s</span><span class='lparen'>(</span><span class='label'>format:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>decimal:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>thousand:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='label'>width:</span> <span class='kw'>nil</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='comma'>,</span> <span class='id identifier rubyid_thousand'>thousand</span> <span class='op'>=</span> <span class='id identifier rubyid_resolve_locale_for'>resolve_locale_for</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='comma'>,</span> <span class='id identifier rubyid_thousand'>thousand</span><span class='rparen'>)</span>
-  <span class='kw'>case</span> <span class='id identifier rubyid_format'>format</span>
-  <span class='kw'>when</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span> <span class='kw'>then</span> <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>format must not be empty</span><span class='tstring_end'>&#39;</span></span>
-  <span class='kw'>when</span> <span class='const'>Hash</span>   <span class='kw'>then</span> <span class='id identifier rubyid_validate_format_hash'>validate_format_hash</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='rparen'>)</span>
-  <span class='kw'>when</span> <span class='const'>String</span> <span class='kw'>then</span> <span class='id identifier rubyid_format'>format</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='label'>positive:</span> <span class='id identifier rubyid_format'>format</span> <span class='rbrace'>}</span>
-  <span class='kw'>else</span>        <span class='id identifier rubyid_raise'>raise</span> <span class='const'>ArgumentError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Invalid format. Only String or Hash are accepted</span><span class='tstring_end'>&#39;</span></span>
-  <span class='kw'>end</span>
-  <span class='id identifier rubyid_formatted'>formatted</span> <span class='op'>=</span> <span class='id identifier rubyid_format_amount'>format_amount</span><span class='lparen'>(</span><span class='id identifier rubyid_format'>format</span><span class='comma'>,</span> <span class='label'>decimal:</span> <span class='id identifier rubyid_decimal'>decimal</span><span class='comma'>,</span> <span class='label'>thousand:</span> <span class='id identifier rubyid_thousand'>thousand</span><span class='rparen'>)</span>
-  <span class='id identifier rubyid_width'>width</span> <span class='op'>?</span> <span class='id identifier rubyid_formatted'>formatted</span><span class='period'>.</span><span class='id identifier rubyid_rjust'>rjust</span><span class='lparen'>(</span><span class='id identifier rubyid_width'>width</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='id identifier rubyid_formatted'>formatted</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_to_s'>to_s</span>
+  <span class='kw'>return</span> <span class='id identifier rubyid_format'>format</span> <span class='kw'>unless</span> <span class='const'><span class='object_link'><a href="../Mint.html" title="Mint (module)">Mint</a></span></span><span class='period'>.</span><span class='id identifier rubyid_locale_backend'><span class='object_link'><a href="../Mint.html#locale_backend-class_method" title="Mint.locale_backend (method)">locale_backend</a></span></span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
+  <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_currency'>currency</span><span class='period'>.</span><span class='id identifier rubyid_symbol'>symbol</span><span class='embexpr_end'>}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_amount_to_s'>amount_to_s</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -4552,7 +5080,11 @@ is empty, or the Hash contains an unrecognised key.</p></div>
 </h3><div class="docstring">
   <div class="discussion">
-    <p>Returns true if amount is zero.</p>
+    <p class="note private">
+  <strong>This method is part of a private API.</strong>
+  You should avoid using this method if possible, as it may be removed or be changed in the future.
+</p>
+<p>Returns true if amount is zero.</p>
   </div>
 </div>
@@ -4597,7 +5129,7 @@ is empty, or the Hash contains an unrecognised key.</p></div>
 </div>
       <div id="footer">
-  Generated on Mon Jun 22 16:47:02 2026 by
+  Generated on Wed Jul  1 01:11:53 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.44 (ruby-4.0.5).
 </div>