@ditojs/utils 2.51.0 → 2.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ditojs/utils",
-  "version": "2.51.0",
+  "version": "2.52.0",
   "type": "module",
   "description": "Dito.js Utility Functions – Dito.js is a declarative and modern web framework, based on Objection.js, Koa.js and Vue.js",
   "repository": "https://github.com/ditojs/dito/tree/master/packages/utils",
@@ -39,5 +39,5 @@
   "devDependencies": {
     "typescript": "^5.8.3"
   },
-  "gitHead": "0b8f114647510db71c50be9fdc331297b1e726ab"
+  "gitHead": "dbfde6b475d824a88fbbbc1e007fd264e80d46fb"
 }

package/src/__snapshots__/index.test.js.snap

@@ -9,7 +9,6 @@ exports[`index > exports all symbols 1`] = `
   "camelize": [Function],
   "capitalize": [Function],
   "clone": [Function],
-  "convertToJson": [Function],
   "debounce": [Function],
   "debounceAsync": [Function],
   "decamelize": [Function],
@@ -59,6 +58,7 @@ exports[`index > exports all symbols 1`] = `
   "isModule": [Function],
   "isNumber": [Function],
   "isObject": [Function],
+  "isPlainArray": [Function],
   "isPlainObject": [Function],
   "isPromise": [Function],
   "isRegExp": [Function],

package/src/base/base.js

@@ -13,17 +13,20 @@ export function isPlainObject(arg) {
   // We also need to check for ctor.name === 'Object', in case this is an object
   // from another global scope (e.g. another vm context in Node.js).
   // When an value has no constructor, it was created with `Object.create(null)`
-  return (
-    !!arg && (
-      ctor && (
-        ctor === Object ||
-        ctor.name === 'Object'
-      ) ||
+  return !!(
+    arg && (
+      ctor && (ctor === Object || ctor.name === 'Object') ||
       !ctor && !isModule(arg)
     )
   )
 }
 
+export function isPlainArray(arg) {
+  const ctor = arg?.constructor
+  // See `isPlainObject()` for explanation.
+  return !!(arg && ctor && (ctor === Array || ctor.name === 'Array'))
+}
+
 export function isObject(arg) {
   return !!arg && typeof arg === 'object' && !isArray(arg)
 }

package/src/base/base.test.js

@@ -1,5 +1,6 @@
 import {
   isPlainObject,
+  isPlainArray,
   isObject,
   isArray,
   isModule,
@@ -23,6 +24,7 @@ import * as module from './index.js'
 
 const object = { a: 1 }
 const array = [1, 2, 3]
+const arrayLike = { 0: 1, 1: 2, 2: 3, length: 3 }
 const string = 'a'
 const number = 1
 const boolean = true
@@ -42,6 +44,7 @@ describe('isPlainObject()', () => {
     [module, false],
     [object, true],
     [array, false],
+    [arrayLike, true],
     [string, false],
     [number, false],
     [boolean, false],
@@ -64,12 +67,42 @@ describe('isPlainObject()', () => {
   )
 })
 
+describe('isPlainArray()', () => {
+  describe.each([
+    [null, false],
+    [module, false],
+    [object, false],
+    [array, true],
+    [arrayLike, false],
+    [string, false],
+    [number, false],
+    [boolean, false],
+    [date, false],
+    [regexp, false],
+    [symbol, false],
+    [instance, false],
+    [promise, false],
+    [func, false],
+    [lambda, false],
+    [asyncFunc, false],
+    [asyncLambda, false]
+  ])(
+    'isPlainArray(%o)',
+    (value, expected) => {
+      it(`returns ${expected}`, () => {
+        expect(isPlainArray(value)).toBe(expected)
+      })
+    }
+  )
+})
+
 describe('isObject()', () => {
   describe.each([
     [null, false],
     [module, true],
     [object, true],
     [array, false],
+    [arrayLike, true],
     [string, false],
     [number, false],
     [boolean, false],
@@ -101,6 +134,7 @@ describe('isArray()', () => {
     [module, false],
     [object, false],
     [array, true],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, false],
@@ -129,6 +163,7 @@ describe('isModule()', () => {
     [module, true],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, false],
@@ -157,6 +192,7 @@ describe('isFunction()', () => {
     [module, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, false],
@@ -185,6 +221,7 @@ describe('isNumber()', () => {
     [module, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, true],
     [Object(number), true],
@@ -214,6 +251,7 @@ describe('isInteger()', () => {
     [module, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, true],
     [boolean, false],
@@ -270,6 +308,7 @@ describe('isString()', () => {
     [null, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, true],
     [Object(string), true],
     [number, false],
@@ -298,6 +337,7 @@ describe('isBoolean()', () => {
     [null, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, true],
@@ -326,6 +366,7 @@ describe('isDate()', () => {
     [null, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, false],
@@ -353,6 +394,7 @@ describe('isRegExp()', () => {
     [null, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, false],
@@ -388,6 +430,7 @@ describe('isPromise()', () => {
     [null, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, false],
@@ -417,6 +460,7 @@ describe('isAsync()', () => {
     [null, false],
     [object, false],
     [array, false],
+    [arrayLike, false],
     [string, false],
     [number, false],
     [boolean, false],
@@ -444,6 +488,7 @@ describe('isArrayLike()', () => {
     [null, false],
     [object, false],
     [array, true],
+    [arrayLike, true],
     [string, true],
     [number, false],
     [boolean, false],

package/src/index.js

@@ -8,4 +8,3 @@ export * from './promise/index.js'
 export * from './function/index.js'
 export * from './dataPath/index.js'
 export * from './html/index.js'
-export * from './json/index.js'

package/src/json/convertToJson.js

@@ -1,27 +0,0 @@
-import { isArray, isPlainObject } from '../base/index.js'
-
-export function convertToJson(arg) {
-  return arg?.toJSON
-    ? arg.toJSON()
-    : isPlainObject(arg)
-      ? convertToJsonObject(arg)
-      : isArray(arg)
-        ? convertToJsonArray(arg)
-        : arg
-}
-
-function convertToJsonObject(arg) {
-  const json = {}
-  for (const key of Object.keys(arg)) {
-    json[key] = convertToJson(arg[key])
-  }
-  return json
-}
-
-function convertToJsonArray(arg) {
-  const ret = new Array(arg.length)
-  for (let i = 0, l = arg.length; i < l; ++i) {
-    ret[i] = convertToJson(arg[i])
-  }
-  return ret
-}

package/src/json/index.js

@@ -1 +0,0 @@
-export * from './convertToJson.js'