#config

Reads or updates the configuration for the current Arith constructor.

import { Arith } from "@teakit/arith";

const previous = Arith.config();

// Update shared defaults for the default constructor.
Arith.config({ DECIMAL_PLACES: 5 });
Arith.from("1").div("3").toString(); // "0.33333"

// EXPONENTIAL_AT controls when toString switches notation.
Arith.config({ EXPONENTIAL_AT: 2 });
Arith.from("123").toString(); // "1.23e+2"
Arith.from("12.3").toString(); // "12.3"

// FORMAT controls toFormat defaults.
Arith.config({ FORMAT: { groupSeparator: " ", decimalSeparator: "," } });
Arith.from("1234.56").toFormat(); // "1 234,56"

// config() returns the current settings.
Arith.config().DECIMAL_PLACES; // 5

// Restore the previous config after temporary changes.
Arith.config(previous);

#API Reference

#Signature

Arith.config(object?: ArithConfig): ArithConfigResult;

#Parameters

#Returns

Returns the full current configuration after applying any supplied changes.

#Throws

• Throws if object is not an object.
• Throws if a config value is outside its allowed range.
• Throws if CRYPTO: true is requested and crypto is unavailable.

#Configuration Fields

#Agent Contract

#Agent Notes

• Save the previous config before mutating shared Arith in examples or tests.
• Prefer Arith.clone() for reusable code to avoid global config side effects.
• Import with import { Arith } from "@teakit/arith"; default imports are unsupported.
• Static helpers are called as Arith.method(...) and do not require an instance receiver.
• Do not generate BigNumber, Decimal, isBigNumber, or isDecimal compatibility APIs.
• Use string inputs for exact decimal values when a static helper accepts numeric values.