Normalize by default

Also, make the API match what the spec says: remove `toExponentialString` and `toDecimalPlaces`, bringing their functionality into `toString`, which now takes options.

Author: jessealama

src/decimal128.mts

@@ -58,7 +58,11 @@ describe("addition", () => {
     describe("non-normalized", () => {
         test("one point zero plus one point zero", () => {
             expect(
-                new Decimal128("1.0").add(new Decimal128("1.0")).toString()
+                new Decimal128("1.0", { normalize: false })
+                    .add(new Decimal128("1.0", { normalize: false }), {
+                        normalize: false,
+                    })
+                    .toString()
             ).toStrictEqual("2.0");
         });
     });
@@ -123,7 +127,7 @@ describe("examples from the General Decimal Arithmetic specification", () => {
         expect(
             new Decimal128("1E2")
                 .add(new Decimal128("1E4"))
-                .toExponentialString()
+                .toString({ format: "exponential" })
         ).toStrictEqual("1.01E+4");
     });
 });

tests/abs.test.js

@@ -7,8 +7,13 @@ describe("constructor", () => {
         test("sane string works", () => {
             expect(new Decimal128("123.456")).toBeInstanceOf(Decimal128);
         });
-        test("no normalization", () => {
-            expect(new Decimal128("1.20").toString()).toStrictEqual("1.20");
+        test("normalization by default", () => {
+            expect(new Decimal128("1.20").toString()).toStrictEqual("1.2");
+        });
+        test("normalization can be disabled", () => {
+            expect(
+                new Decimal128("1.20", { normalize: false }).toString()
+            ).toStrictEqual("1.20");
         });
         test("no normalization (exponential notation) (positive exponent)", () => {
             let d = new Decimal128("1.20E1");
@@ -436,18 +441,17 @@ describe("rounding options", () => {
                 new Decimal128("0.1", { foo: "bar" }).toString()
             ).toStrictEqual("0.1");
         });
-        test("unknown rounding mode throws", () => {
+        test("unknown rounding mode works out to default", () => {
             expect(
-                () => new Decimal128("0.1", { roundingMode: "jazzy" })
-            ).toThrow(Error);
+                new Decimal128("0.5", { roundingMode: "jazzy" }).toString()
+            ).toStrictEqual("0.5");
         });
         test("unknown rounding mode throws on large input", () => {
             expect(
-                () =>
-                    new Decimal128("0." + "9".repeat(10000), {
-                        roundingMode: "cool",
-                    })
-            ).toThrow(Error);
+                new Decimal128("0." + "9".repeat(10000), {
+                    roundingMode: "cool",
+                }).toString()
+            ).toStrictEqual("1.000000000000000000000000000000000");
         });
     });
     describe("negative value, final decimal digit is five, penultimate digit is less than nine", () => {

tests/add.test.js

@@ -162,7 +162,9 @@ describe("examples from the General Decimal Arithmetic Specification", () => {
     });
     test("example six", () => {
         expect(
-            new Decimal128("8.00").divide(new Decimal128("2")).toString()
+            new Decimal128("8.00", { normalize: false })
+                .divide(new Decimal128("2"), { normalize: false })
+                .toString()
         ).toStrictEqual("4.00");
     });
     test("example seven", () => {
@@ -184,7 +186,7 @@ describe("examples from the General Decimal Arithmetic Specification", () => {
         expect(
             new Decimal128("2.40E+6")
                 .divide(new Decimal128("2"))
-                .toExponentialString()
+                .toString({ format: "exponential" })
         ).toStrictEqual("1.20E+6");
     });
 });

tests/constructor.test.js

@@ -22,7 +22,9 @@ const examples = [
 
 function checkProduct(a, b, c) {
     expect(
-        new Decimal128(a).multiply(new Decimal128(b)).toString()
+        new Decimal128(a)
+            .multiply(new Decimal128(b), { normalize: false })
+            .toString()
     ).toStrictEqual(c);
 }
 
@@ -184,8 +186,8 @@ describe("examples from the General Decimal Arithmetic specification", () => {
         // slightly modified because we have more precision
         expect(
             new Decimal128("654321")
-                .multiply(new Decimal128("654321"))
-                .toExponentialString()
+                .multiply(new Decimal128("654321"), { normalize: false })
+                .toString({ format: "exponential" })
         ).toStrictEqual("4.28135971041E+11");
     });
 });

tests/divide.test.js

@@ -121,7 +121,9 @@ describe("examples from the General Decimal Arithmetic Specification", () => {
     });
     test("example six", () => {
         expect(
-            new Decimal128("3.6").remainder(new Decimal128("1.3")).toString()
+            new Decimal128("3.6")
+                .remainder(new Decimal128("1.3"), { normalize: false })
+                .toString()
         ).toStrictEqual("1.0");
     });
 });

tests/integer.test.js

@@ -50,19 +50,14 @@ describe("rounding", () => {
                 "1.5"
             );
         });
-        test("more digits than are available", () => {
-            expect(new Decimal128("1.5").round(2).toString()).toStrictEqual(
-                "1.50"
-            );
-        });
         test("negative odd", () => {
             expect(new Decimal128("-1.5").round(1).toString()).toStrictEqual(
                 "-1.5"
             );
         });
         test("round down (positive)", () => {
             expect(new Decimal128("1.1").round(6).toString()).toStrictEqual(
-                "1.100000"
+                "1.1"
             );
         });
     });

tests/multiply.test.js

@@ -8,7 +8,7 @@ describe("subtraction", () => {
     test("subtract decimal part", () => {
         expectDecimal128(
             new Decimal128("123.456").subtract(new Decimal128("0.456")),
-            "123.000"
+            "123"
         );
     });
     test("minus negative number", () => {
@@ -141,7 +141,9 @@ describe("examples from the General Decimal Arithmetic specification", () => {
     });
     test("example two", () => {
         expect(
-            new Decimal128("1.3").subtract(new Decimal128("1.30")).toString()
+            new Decimal128("1.3")
+                .subtract(new Decimal128("1.30", { normalize: false }))
+                .toString()
         ).toStrictEqual("0.00");
     });
     test("example three", () => {