feat(number): rename safeDivide to divide

BREAKING CHANGE: safeDivide is removed

docs/pages/number/_meta.json

@@ -1,4 +1,5 @@
 {
-  "safe-divide": "safeDivide",
+  "divide": "divide",
+  "clamp": "clamp",
   "random-int": "randomInt"
 }

docs/pages/number/divide.mdx

@@ -0,0 +1,23 @@
+# divide
+
+Divides two numbers returns fallback if result is not a finite number
+
+### Import
+
+```typescript copy
+import { divide } from '@fullstacksjs/toolbox';
+```
+
+### Signature
+
+```typescript copy
+function divide(dividend: number, divisor: number, fallback: number = NaN): number {}
+```
+
+### Examples
+
+```typescript copy
+divide(4, 2)     // 2
+divide(4, 0, 42) // 42
+divide(4, 0)     // NaN
+```

src/number/divide.spec.ts

@@ -0,0 +1,16 @@
+import { describe, expect, it } from 'vitest';
+import { divide } from './divide';
+
+describe('divide', () => {
+  it('should return the division of two number', () => {
+    expect(divide(4, 2)).toBe(2);
+  });
+
+  it('should return fallback when the divisor is zero', () => {
+    expect(divide(4, 0, 42)).toBe(42);
+  });
+
+  it('the default fallback should be nan', () => {
+    expect(divide(4, 0)).toBeNaN();
+  });
+});

src/number/divide.ts

@@ -0,0 +1,23 @@
+import { fallbackNumber } from '../values';
+
+/**
+ * Divides two numbers returns fallback if result is not a finite number
+ *
+ * @param {number} dividend dividend
+ * @param {number} divisor divisor
+ * @param {number} [fallback=NaN] fallback when the result is not finite
+ * @returns {number} division result or fallback
+ *
+ * @example
+ *
+ * divide(4, 2)     // 2
+ * divide(4, 0, 42) // 42
+ * divide(4, 0)     // NaN
+ */
+export function divide(
+  dividend: number,
+  divisor: number,
+  fallback: number = NaN,
+): number {
+  return fallbackNumber(dividend / divisor, fallback);
+}