@ditojs/utils 2.78.0 → 2.79.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ditojs/utils",
-  "version": "2.78.0",
+  "version": "2.79.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.9.3"
   },
-  "gitHead": "ede4c836e6b2bb5dfcc80e1614a3d85eb80b0efa"
+  "gitHead": "f87ce5ce121a30830776774cd447014afef5b8ec"
 }

package/src/object/index.js

@@ -1,4 +1,3 @@
-export * from './asCallback.js'
 export * from './clone.js'
 export * from './equals.js'
 export * from './groupBy.js'

package/types/index.d.ts

@@ -142,9 +142,16 @@ export function clone<T>(value: T, options?: {
  */
 export function equals(arg1: any, arg2: any): boolean
 
-// TODO: document groupBy
+/**
+ * Groups items in a collection by a key returned from the callback function,
+ * or by a property name when a string is provided.
+ */
+export function groupBy<T, K extends keyof T>(
+  collection: T[] | Record<string, T>,
+  callback: K
+): Record<string, T[]>
 export function groupBy<T, K extends string | number | symbol>(
-  list: T[],
+  collection: T[] | Record<string, T>,
   callback: (item: T) => K
 ): Record<K, T[]>
 
@@ -217,10 +224,16 @@ export function pick<ArgA, ArgB, ArgC, ArgD, ArgE>(
 export function pick(...args: any[]): any
 /**
  * Creates an object composed of the object properties predicate returns
- * truthy for.
+ * truthy for. When a string is provided, filters by the truthiness of that
+ * property on each value.
  * @param object The source object.
- * @param callback Callback invoked with three arguments: (value, key, item).
+ * @param callback Callback invoked with three arguments: (value, key, item),
+ * or a property name string to check for truthiness.
  */
+export function pickBy<T extends Dictionary<any>, K extends keyof T[keyof T]>(
+  object: T,
+  callback: K
+): Partial<T>
 export function pickBy<T extends Dictionary<any>>(
   object: T,
   callback?: (value: T[keyof T], key: keyof T, object: T) => any
@@ -231,6 +244,17 @@ export function mapKeys<T extends Dictionary<any>, K extends keyof any>(
   callback?: (key: keyof T, value: T[keyof T], object: T) => K
 ): Record<K, T[keyof T]>
 
+/**
+ * Maps the values of an object using a callback function, or extracts a
+ * property when a string is provided.
+ */
+export function mapValues<
+  T extends Dictionary<any>,
+  K extends keyof T[keyof T]
+>(
+  object: T,
+  callback: K
+): Record<keyof T, T[keyof T][K]>
 export function mapValues<T extends Dictionary<any>, K>(
   object: T,
   callback?: (value: T[keyof T], key: keyof T, object: T) => K
@@ -290,8 +314,12 @@ export function underscore(str: string): string
  */
 export function deindent(
   strings: OrArrayOf<string>,
-  ...values: Array<string>
+  ...values: Array<any>
 ): string
+/**
+ * Escapes special characters in a string for use in a regular expression.
+ */
+export function escapeRegexp(string: string): string
 /**
  * Returns the longest prefix string that is common to the supplied strings.
  */
@@ -314,6 +342,11 @@ export function isAbsoluteUrl(str: string): boolean
  * Determines whether the supplied string is a valid creditcard number.
  */
 export function isCreditCard(str: string): boolean
+/**
+ * Determines whether the supplied string is a valid domain name.
+ * Supports internationalized domain names with punycode.
+ */
+export function isDomain(str: string): boolean
 /**
  * Determines whether the supplied string is a valid email address.
  */
@@ -419,8 +452,37 @@ export function format(
     number?: boolean | NumberFormat
   }
 ): string
+/**
+ * Formats a date value as a string. If the value is not a Date,
+ * attempts to convert it to a Date first.
+ */
+export function formatDate(
+  value: any,
+  options?: {
+    /**
+     * @default 'en-US'
+     */
+    locale?: string
+    /**
+     * @default true
+     */
+    date?: boolean | DateFormat
+    /**
+     * @default true
+     */
+    time?: boolean | TimeFormat
+  }
+): string
 /* -------------------------------- function -------------------------------- */
 
+/**
+ * Logs a deprecation warning message to the console. Each unique message
+ * is only logged once.
+ *
+ * @param message The deprecation message to log.
+ */
+export function deprecate(message: string): void
+
 /**
  * Creates a debounced function that delays invoking func until after wait
  * milliseconds have elapsed since the last time the debounced function was
@@ -671,6 +733,21 @@ export function toPromiseCallback<T, R>(
 
 /* -------------------------------- dataPath -------------------------------- */
 
+/**
+ * Gets entries at a data path, supporting wildcards (* and **).
+ * Wildcard * matches direct children, ** matches recursively.
+ *
+ * @param obj The object to query.
+ * @param path The data path (supports wildcards).
+ * @param handleError Optional error handler called when path is invalid.
+ * @returns Object with normalized paths as keys and values at those paths.
+ */
+export function getEntriesAtDataPath(
+  obj: any,
+  path: OrArrayOf<string>,
+  handleError?: (obj: any, part: string, index: number) => any
+): Record<string, any>
+
 export function getValueAtDataPath(
   obj: any,
   path: OrArrayOf<string>,
@@ -681,12 +758,37 @@ export function normalizeDataPath(path: OrArrayOf<string>): string
 
 export function parseDataPath(path: OrArrayOf<string>): string
 
+/**
+ * Sets multiple values at data paths from an entries object.
+ *
+ * @param obj The object to modify.
+ * @param entries Object with data paths as keys and values to set.
+ * @returns The modified object.
+ */
+export function setDataPathEntries<O>(
+  obj: O,
+  entries: Record<string, any>
+): O
+
 export function setValueAtDataPath<O>(
   obj: O,
   path: OrArrayOf<string>,
   value: any
 ): O
 
+/* --------------------------------- class ---------------------------------- */
+
+/**
+ * Creates a mixin decorator that applies a mixin function to a class.
+ * Prevents duplicate application of the same mixin in the inheritance chain.
+ *
+ * @param mixinFunction Function that takes a class and returns a mixed class.
+ * @returns Decorator function that applies the mixin to a target class.
+ */
+export function mixin<T extends new (...args: any[]) => any>(
+  mixinFunction: (targetClass: T) => T
+): (targetClass: T) => T
+
 /* ---------------------------------- html ---------------------------------- */
 
 /**