@tim-code/my-util 0.0.10 → 0.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tim-code/my-util",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "",
   "type": "module",
   "author": "",

package/src/math.js

@@ -1,9 +1,32 @@
 /**
- * Module safe for negative numbers i.e. mod(-1, 3) === 2 (not -1 as in -1 % 3).
- * @param {number} n
- * @param {number} m If 0, returns NaN as does n % m.
+ * Gives the remainder when the number is divided by modulus.
+ * The sign of the remainder is always the same as the modulus i.e. mod(-1, 3) === 2 (not -1 as in -1 % 3).
+ * @param {number} number
+ * @param {number} modulus If 0, returns NaN as does n % m.
  * @returns {number}
  */
-export function mod(n, m) {
-  return ((n % m) + m) % m
+export function mod(number, modulus) {
+  return ((number % modulus) + modulus) % modulus
+}
+
+/**
+ * Prepend a plus to a number or string if positive.
+ * @param {number|string} number Or string
+ * @param {Object} $1
+ * @param {boolean=} $1.zero If true, prepends a plus to zero as well.
+ * @returns {string|undefined} Returns undefined if number is not a number or string. NaN return undefined.
+ */
+export function formatPlus(number, { zero = false } = {}) {
+  if (typeof number === "number" && !isNaN(number)) {
+    if (number > 0 || (zero && number === 0)) {
+      return `+${number}`
+    }
+    return `${number}`
+  } else if (typeof number === "string") {
+    if (number === "0" ? zero : number[0] !== "-") {
+      return `+${number}`
+    }
+    return number
+  }
+  return undefined
 }

package/src/math.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "@jest/globals"
-const { mod } = await import("./math.js")
+const { mod, formatPlus } = await import("./math.js")
 
 describe("mod", () => {
   it("returns n when n is less than m and n is non-negative", () => {
@@ -34,4 +34,82 @@ describe("mod", () => {
     expect(mod(0, 0)).toBeNaN()
     expect(mod(-3, 0)).toBeNaN()
   })
+
+  // All sign combinations for number and modulus
+  it("handles all sign combinations for number and modulus", () => {
+    // number > 0, modulus > 0
+    expect(mod(5, 3)).toBe(2)
+    // number > 0, modulus < 0
+    expect(mod(5, -3)).toBe(-1)
+    // number < 0, modulus > 0
+    expect(mod(-5, 3)).toBe(1)
+    // number < 0, modulus < 0
+    expect(mod(-5, -3)).toBe(-2)
+    // number = 0, modulus > 0
+    expect(mod(0, 3)).toBe(0)
+    // number = 0, modulus < 0
+    expect(mod(0, -3)).toBe(-0)
+    // number > 0, modulus = 0
+    expect(mod(5, 0)).toBeNaN()
+    // number < 0, modulus = 0
+    expect(mod(-5, 0)).toBeNaN()
+    // number = 0, modulus = 0
+    expect(mod(0, 0)).toBeNaN()
+  })
+})
+
+describe("formatPlus", () => {
+  it("prepends a plus for positive numbers", () => {
+    expect(formatPlus(1)).toBe("+1")
+    expect(formatPlus(123.45)).toBe("+123.45")
+  })
+
+  it("does not prepend a plus for negative numbers", () => {
+    expect(formatPlus(-1)).toBe("-1")
+    expect(formatPlus(-123.45)).toBe("-123.45")
+  })
+
+  it("does not prepend a plus for zero by default", () => {
+    expect(formatPlus(0)).toBe("0")
+  })
+
+  it("prepends a plus for zero if zero option is true", () => {
+    expect(formatPlus(0, { zero: true })).toBe("+0")
+  })
+
+  it("handles undefined options argument", () => {
+    expect(formatPlus(5)).toBe("+5")
+    expect(formatPlus(-5)).toBe("-5")
+    expect(formatPlus(0)).toBe("0")
+  })
+
+  // String input cases
+  it("prepends a plus for positive string numbers", () => {
+    expect(formatPlus("5")).toBe("+5")
+    expect(formatPlus("123.45")).toBe("+123.45")
+  })
+
+  it("does not prepend a plus for negative string numbers", () => {
+    expect(formatPlus("-5")).toBe("-5")
+    expect(formatPlus("-123.45")).toBe("-123.45")
+  })
+
+  it("prepends a plus for string zero if zero option is true", () => {
+    expect(formatPlus("0", { zero: true })).toBe("+0")
+  })
+
+  it("does not prepend a plus for string zero if zero option is false", () => {
+    expect(formatPlus("0")).toBe("0")
+  })
+
+  it("returns undefined for non-number, non-string input", () => {
+    expect(formatPlus(undefined)).toBeUndefined()
+    // eslint-disable-next-line no-restricted-syntax
+    expect(formatPlus(null)).toBeUndefined()
+    expect(formatPlus({})).toBeUndefined()
+    expect(formatPlus([])).toBeUndefined()
+    expect(formatPlus(true)).toBeUndefined()
+    expect(formatPlus(Symbol("x"))).toBeUndefined()
+    expect(formatPlus(NaN)).toBeUndefined()
+  })
 })