@ditojs/utils 2.99.0 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ditojs/utils",
-  "version": "2.99.0",
+  "version": "3.0.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/main/packages/utils",
@@ -19,9 +19,6 @@
     "src/",
     "types/"
   ],
-  "scripts": {
-    "types": "tsc --noEmit types/index.d.ts"
-  },
   "engines": {
     "node": ">= 24.0.0"
   },
@@ -32,11 +29,8 @@
     "ie >= 11",
     "ie_mob >= 11"
   ],
-  "dependencies": {
-    "punycode": "^2.3.1"
-  },
   "devDependencies": {
     "typescript": "^6.0.3"
   },
-  "gitHead": "ba1ce26d349a74e8143faa614488182b67416db1"
+  "gitHead": "399f683a6ca227a03cfc0978fee9055383e6b3d8"
 }

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

@@ -35,6 +35,7 @@ exports[`index > exports all symbols 1`] = `
   "flatten": [Function],
   "format": [Function],
   "formatDate": [Function],
+  "formatPlainDate": [Function],
   "getCommonOffset": [Function],
   "getCommonPrefix": [Function],
   "getEntriesAtDataPath": [Function],
@@ -73,6 +74,7 @@ exports[`index > exports all symbols 1`] = `
   "mixin": [Function],
   "normalizeDataPath": [Function],
   "parseDataPath": [Function],
+  "parsePlainDate": [Function],
   "pick": [Function],
   "pickBy": [Function],
   "setDataPathEntries": [Function],

package/src/array/shuffle.js

@@ -1,7 +1,7 @@
 export function shuffle(array) {
   // Do the Fisher-Yates (aka Knuth) Shuffle:
   const res = array.slice()
-  for (let i = array.length; i; ) {
+  for (let i = array.length; i;) {
     const r = Math.floor(Math.random() * i)
     const t = res[--i]
     res[i] = res[r]

package/src/object/equals.test.js

@@ -40,8 +40,11 @@ describe('equals()', () => {
     [false, '', false],
 
     [symbol1, symbol1, true],
-    [symbol1, Object(symbol1), true],
-    [Object(symbol1), Object(symbol1), true],
+    // TODO: Uncomment once vitest can format boxed symbols in `%o` titles,
+    // and remove 'should compare boxed symbols' below:
+    // https://github.com/vitest-dev/vitest/issues/11445
+    // [symbol1, Object(symbol1), true],
+    // [Object(symbol1), Object(symbol1), true],
     [symbol1, symbol2, false],
 
     [null, null, true],
@@ -60,6 +63,12 @@ describe('equals()', () => {
     }
   )
 
+  // TODO: Remove once the boxed symbol rows above are uncommented.
+  it('should compare boxed symbols', () => {
+    expect(equals(symbol1, Object(symbol1))).toBe(true)
+    expect(equals(Object(symbol1), Object(symbol1))).toBe(true)
+  })
+
   it('should compare arrays', () => {
     let array1 = [true, null, 1, 'a', undefined]
     let array2 = [true, null, 1, 'a', undefined]

package/src/string/formatPlainDate.js

@@ -0,0 +1,14 @@
+/**
+ * Formats a date as its local plain date, e.g. `'2026-05-14'`, without the
+ * time and time zone of `toISOString()`, which can shift it to another day.
+ */
+export function formatPlainDate(date) {
+  // Use the date parts, as shifting by `getTimezoneOffset()` misses offsets
+  // with seconds, e.g. local mean time before 1894 in Europe/Zurich.
+  const pad = (number, length = 2) => String(number).padStart(length, '0')
+  return [
+    pad(date.getFullYear(), 4),
+    pad(date.getMonth() + 1),
+    pad(date.getDate())
+  ].join('-')
+}

package/src/string/formatPlainDate.test.js

@@ -0,0 +1,13 @@
+import { formatPlainDate } from './formatPlainDate.js'
+
+describe('formatPlainDate()', () => {
+  it('should format the local plain date', () => {
+    expect(formatPlainDate(new Date(2026, 4, 14))).toBe('2026-05-14')
+    expect(formatPlainDate(new Date(2026, 4, 14, 23, 59))).toBe(
+      '2026-05-14'
+    )
+    expect(formatPlainDate(new Date(987, 0, 1))).toBe('0987-01-01')
+    // Local mean time, with an offset in seconds in some timezones:
+    expect(formatPlainDate(new Date(1850, 6, 1))).toBe('1850-07-01')
+  })
+})

package/src/string/index.js

@@ -4,6 +4,7 @@ export * from './decamelize.js'
 export * from './deindent.js'
 export * from './escapeRegexp.js'
 export * from './format.js'
+export * from './formatPlainDate.js'
 export * from './formatDate.js'
 export * from './getCommonPrefix.js'
 export * from './isAbsoluteUrl.js'
@@ -13,3 +14,4 @@ export * from './isEmail.js'
 export * from './isHostname.js'
 export * from './isUrl.js'
 export * from './labelize.js'
+export * from './parsePlainDate.js'

package/src/string/isDomain.js

@@ -1,9 +1,16 @@
-import punycode from 'punycode/punycode.js'
-
 // Best effort approach, allowing Internationalized domain name (with punycode)
 const domainRegExp =
   /^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$/i
 
 export function isDomain(str) {
-  return !!(str && domainRegExp.test(punycode.toASCII(str)))
+  // Reject characters that `URL` would treat as delimiters or decode, so that
+  // only the domain itself is converted to its ASCII (punycode) form.
+  if (!str || /[\s/\\?#@:%]/.test(str)) {
+    return false
+  }
+  try {
+    return domainRegExp.test(new URL(`http://${str}`).hostname)
+  } catch {
+    return false
+  }
 }

package/src/string/isDomain.test.js

@@ -12,4 +12,13 @@ describe('isDomain()', () => {
     expect(isDomain('line_to.com')).toBe(false)
     expect(isDomain('lünéto.com')).toBe(true)
   })
+
+  it('should return false for anything beyond a domain', () => {
+    expect(isDomain('')).toBe(false)
+    expect(isDomain('lineto.com:80')).toBe(false)
+    expect(isDomain('lineto.com/path')).toBe(false)
+    expect(isDomain('user@lineto.com')).toBe(false)
+    expect(isDomain('line%74o.com')).toBe(false)
+    expect(isDomain('line to.com')).toBe(false)
+  })
 })

package/src/string/parsePlainDate.js

@@ -0,0 +1,18 @@
+import { formatPlainDate } from './formatPlainDate.js'
+
+/**
+ * Parses a plain date like `'2026-05-14'` as local midnight, unlike
+ * `new Date()`, which parses it as UTC midnight. Returns `null` for anything
+ * else, including invalid dates like `'2026-02-30'`.
+ */
+export function parsePlainDate(string) {
+  if (/^\d{4}-\d{2}-\d{2}$/.test(string)) {
+    // Date-time strings without an offset are parsed as local time.
+    const date = new Date(`${string}T00:00`)
+    // Reject invalid days, which `Date` rolls over to the next month.
+    if (formatPlainDate(date) === string) {
+      return date
+    }
+  }
+  return null
+}

package/src/string/parsePlainDate.test.js

@@ -0,0 +1,20 @@
+import { parsePlainDate } from './parsePlainDate.js'
+
+describe('parsePlainDate()', () => {
+  it('should parse plain dates as local midnight', () => {
+    expect(parsePlainDate('2026-05-14')).toEqual(new Date(2026, 4, 14))
+    expect(parsePlainDate('1850-07-01')).toEqual(new Date(1850, 6, 1))
+  })
+
+  it('should return null for other values', () => {
+    expect(parsePlainDate(null)).toBe(null)
+    expect(parsePlainDate('')).toBe(null)
+    expect(parsePlainDate('2026-05-14T00:00:00.000Z')).toBe(null)
+    expect(parsePlainDate('14.05.2026')).toBe(null)
+  })
+
+  it('should return null for invalid dates', () => {
+    expect(parsePlainDate('2026-02-30')).toBe(null)
+    expect(parsePlainDate('2026-13-01')).toBe(null)
+  })
+})

package/types/index.d.ts

@@ -518,6 +518,19 @@ export function format(
     }
   }
 ): string | null | undefined
+/**
+ * Formats a date as its local plain date, e.g. `'2026-05-14'`, without the
+ * time and time zone of `toISOString()`, which can shift it to another day.
+ */
+export function formatPlainDate(date: Date): string
+/**
+ * Parses a plain date like `'2026-05-14'` as local midnight, unlike
+ * `new Date()`, which parses it as UTC midnight. Returns `null` for anything
+ * else, including invalid dates like `'2026-02-30'`.
+ */
+export function parsePlainDate(
+  string: string | null | undefined
+): Date | null
 /**
  * Formats a date value as a string. If the value is not a Date,
  * attempts to convert it to a Date first.