@duplojs/utils 1.4.57 → 1.4.58

package/dist/date/tomorrow.cjs

@@ -1,13 +1,14 @@
 'use strict';
 
 var constants = require('./constants.cjs');
+var theDate = require('./theDate.cjs');
 
 /**
  * {@include date/tomorrow/index.md}
  */
 function tomorrow() {
     const timestamp = Date.now() + constants.millisecondsInOneDay;
-    return `date${timestamp}+`;
+    return theDate.TheDate.new(timestamp);
 }
 
 exports.tomorrow = tomorrow;

package/dist/date/tomorrow.d.ts

@@ -1,19 +1,24 @@
+import { TheDate } from "./theDate";
 /**
- * Returns tomorrow's date as TheDate.
+ * Returns an instant approximately one day after now as `TheDate`.
  * 
- * Signature: `tomorrow()` → returns a value
- * 
- * The input value is not mutated.
+ * Signature: `tomorrow()` → `TheDate`
  * 
  * ```ts
- * const result = D.tomorrow();
- * // result: "date" + timestamp
+ * const value = D.tomorrow();
+ * // value: TheDate
+ * 
+ * const iso = D.toISOString(value);
+ * // iso: string
  * 
  * ```
  * 
+ * @remarks
+ * - Computed from current timestamp plus one day in milliseconds.
+ * 
  * @see https://utils.duplojs.dev/en/v1/api/date/tomorrow
  * 
  * @namespace D
  * 
  */
-export declare function tomorrow(): `date${number}+`;
+export declare function tomorrow(): TheDate;

package/dist/date/tomorrow.mjs

@@ -1,11 +1,12 @@
 import { millisecondsInOneDay } from './constants.mjs';
+import { TheDate } from './theDate.mjs';
 
 /**
  * {@include date/tomorrow/index.md}
  */
 function tomorrow() {
     const timestamp = Date.now() + millisecondsInOneDay;
-    return `date${timestamp}+`;
+    return TheDate.new(timestamp);
 }
 
 export { tomorrow };

package/dist/date/types/index.d.ts

@@ -1,9 +1,9 @@
-export * from "./theDate";
+export * from "./serializedTheDate";
 export * from "./isLeapYear";
 export * from "./unit";
 export * from "./month";
 export * from "./time";
 export * from "./isSafeYear";
 export * from "./spoolingDate";
-export * from "./theTime";
+export * from "./serializedTheTime";
 export * from "./spoolingTime";

package/dist/date/types/serializedTheDate.d.ts

@@ -0,0 +1 @@
+export type SerializedTheDate = `date${number}${"-" | "+"}`;

package/dist/date/types/serializedTheTime.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Represents an immutable time value object (`TheTime`) stored in milliseconds.
+ * 
+ * Signature: `TheTime` → immutable class-like value object
+ * 
+ * `TheTime` solves unit-fragmentation issues (`hours`, `minutes`, `seconds`) by using a single safe millisecond representation while keeping strong typing and explicit serialization.
+ * 
+ * ```ts
+ * const theTime = D.createTime(2, "hour");
+ * // theTime: TheTime
+ * 
+ * const timeValue = theTime.toNative();
+ * // timeValue: number
+ * 
+ * const serialized = D.serialize(theTime);
+ * // serialized: SerializedTheTime
+ * 
+ * const date = D.create("2025-10-20");
+ * const dateWithDuration = D.addTime(date, theTime);
+ * // dateWithDuration: TheDate
+ * 
+ * const threeHours = D.createTime(3, "hour");
+ * // threeHours: TheTime
+ * 
+ * const asMilliseconds = D.toTimeValue(theTime);
+ * // asMilliseconds: number
+ * ```
+ * 
+ * @remarks
+ * - `TheTime` is not a `number`, but it behaves as an immutable numeric time value.
+ * - Date unit operators (`addMinutes`, `subtractDays`, etc.) target `TheDate`; `TheTime` is used as a normalized duration value.
+ * - Use `D.serialize(theTime)` to convert to `SerializedTheTime`.
+ * - Use `D.createTime(...)` / `D.createTimeOrThrow(...)` to construct instances.
+ * 
+ * @see https://utils.duplojs.dev/en/v1/api/date/theTime
+ * @see https://utils.duplojs.dev/en/v1/api/date/serialize
+ * @see https://utils.duplojs.dev/en/v1/api/date/createTime
+ * 
+ * @namespace D
+ * 
+ */
+export type SerializedTheTime = `time${number}${"+" | "-"}`;

package/dist/date/types/spoolingDate.d.ts

@@ -1,6 +1,7 @@
+import type { TheDate } from "../theDate";
 import { type Timezone } from "../timezone";
 export interface SpoolingDate {
-    value: string | Date | number;
+    value: TheDate | string | Date | number;
     timezone?: Timezone;
     year?: number;
     month?: number;

package/dist/date/yesterday.cjs

@@ -1,13 +1,14 @@
 'use strict';
 
 var constants = require('./constants.cjs');
+var theDate = require('./theDate.cjs');
 
 /**
  * {@include date/yesterday/index.md}
  */
 function yesterday() {
     const timestamp = Date.now() - constants.millisecondsInOneDay;
-    return `date${timestamp}+`;
+    return theDate.TheDate.new(timestamp);
 }
 
 exports.yesterday = yesterday;

package/dist/date/yesterday.d.ts

@@ -1,19 +1,24 @@
+import { TheDate } from "./theDate";
 /**
- * Returns yesterday's date as TheDate.
+ * Returns an instant approximately one day before now as `TheDate`.
  * 
- * Signature: `yesterday()` → returns a value
- * 
- * The input value is not mutated.
+ * Signature: `yesterday()` → `TheDate`
  * 
  * ```ts
- * const result = D.yesterday();
- * // result: "date" + timestamp
+ * const value = D.yesterday();
+ * // value: TheDate
+ * 
+ * const iso = D.toISOString(value);
+ * // iso: string
  * 
  * ```
  * 
+ * @remarks
+ * - Computed from current timestamp minus one day in milliseconds.
+ * 
  * @see https://utils.duplojs.dev/en/v1/api/date/yesterday
  * 
  * @namespace D
  * 
  */
-export declare function yesterday(): `date${number}+`;
+export declare function yesterday(): TheDate;

package/dist/date/yesterday.mjs

@@ -1,11 +1,12 @@
 import { millisecondsInOneDay } from './constants.mjs';
+import { TheDate } from './theDate.mjs';
 
 /**
  * {@include date/yesterday/index.md}
  */
 function yesterday() {
     const timestamp = Date.now() - millisecondsInOneDay;
-    return `date${timestamp}+`;
+    return TheDate.new(timestamp);
 }
 
 export { yesterday };

package/dist/index.cjs

@@ -27,15 +27,12 @@ var sleep = require('./common/sleep.cjs');
 var stringToBytes = require('./common/stringToBytes.cjs');
 var mimeType = require('./common/mimeType.cjs');
 var stringToMillisecond = require('./common/stringToMillisecond.cjs');
-var toJSON = require('./common/toJSON.cjs');
-var toTransform = require('./common/toTransform.cjs');
 var toWrappedValue = require('./common/toWrappedValue.cjs');
 var unwrap = require('./common/unwrap.cjs');
 var unwrapGroup = require('./common/unwrapGroup.cjs');
 var asyncLoop = require('./common/asyncLoop.cjs');
 var asyncRetry = require('./common/asyncRetry.cjs');
 var wrapValue = require('./common/wrapValue.cjs');
-var toString = require('./common/toString.cjs');
 var innerPipe = require('./common/innerPipe.cjs');
 var asyncInnerPipe = require('./common/asyncInnerPipe.cjs');
 var loop = require('./common/loop.cjs');
@@ -65,6 +62,7 @@ var toCurriedPredicate = require('./common/toCurriedPredicate.cjs');
 var pipeCall = require('./common/pipeCall.cjs');
 var asserts = require('./common/asserts.cjs');
 var path = require('./common/path.cjs');
+var transformer = require('./common/transformer.cjs');
 
 
 
@@ -113,8 +111,6 @@ exports.stringToBytes = stringToBytes.stringToBytes;
 exports.mimeType = mimeType.mimeType;
 exports.InvalidMillisecondInStringError = stringToMillisecond.InvalidMillisecondInStringError;
 exports.stringToMillisecond = stringToMillisecond.stringToMillisecond;
-exports.toJSON = toJSON.toJSON;
-exports.toTransform = toTransform.toTransform;
 exports.toWrappedValue = toWrappedValue.toWrappedValue;
 exports.unwrap = unwrap.unwrap;
 exports.unwrapGroup = unwrapGroup.unwrapGroup;
@@ -125,7 +121,6 @@ exports.isRuntimeWrappedValueKey = wrapValue.isRuntimeWrappedValueKey;
 exports.isWrappedValue = wrapValue.isWrappedValue;
 exports.keyWrappedValue = wrapValue.keyWrappedValue;
 exports.wrapValue = wrapValue.wrapValue;
-exports.toString = toString.toString;
 exports.innerPipe = innerPipe.innerPipe;
 exports.asyncInnerPipe = asyncInnerPipe.asyncInnerPipe;
 exports.loop = loop.loop;
@@ -161,3 +156,7 @@ Object.defineProperty(exports, "Path", {
 	enumerable: true,
 	get: function () { return path.Path; }
 });
+exports.createTransformer = transformer.createTransformer;
+exports.toJSON = transformer.toJSON;
+exports.toNative = transformer.toNative;
+exports.transformer = transformer.transformer;

package/dist/index.mjs

@@ -49,15 +49,12 @@ export { sleep } from './common/sleep.mjs';
 export { InvalidBytesInStringError, stringToBytes } from './common/stringToBytes.mjs';
 export { mimeType } from './common/mimeType.mjs';
 export { InvalidMillisecondInStringError, stringToMillisecond } from './common/stringToMillisecond.mjs';
-export { toJSON } from './common/toJSON.mjs';
-export { toTransform } from './common/toTransform.mjs';
 export { toWrappedValue } from './common/toWrappedValue.mjs';
 export { unwrap } from './common/unwrap.mjs';
 export { unwrapGroup } from './common/unwrapGroup.mjs';
 export { asyncLoop } from './common/asyncLoop.mjs';
 export { createAsyncRetry, useAsyncRetry } from './common/asyncRetry.mjs';
 export { isRuntimeWrappedValueKey, isWrappedValue, keyWrappedValue, wrapValue } from './common/wrapValue.mjs';
-export { toString } from './common/toString.mjs';
 export { innerPipe } from './common/innerPipe.mjs';
 export { asyncInnerPipe } from './common/asyncInnerPipe.mjs';
 export { loop } from './common/loop.mjs';
@@ -87,3 +84,4 @@ export { toCurriedPredicate } from './common/toCurriedPredicate.mjs';
 export { pipeCall } from './common/pipeCall.mjs';
 export { AssertsError, asserts } from './common/asserts.mjs';
 export { Path } from './common/path.mjs';
+export { createTransformer, toJSON, toNative, transformer } from './common/transformer.mjs';

package/dist/metadata.json

@@ -612,6 +612,15 @@
                 },
                 {
                   "name": "string.mjs"
+                },
+                {
+                  "name": "time.cjs"
+                },
+                {
+                  "name": "time.d.ts"
+                },
+                {
+                  "name": "time.mjs"
                 }
               ]
             },
@@ -1551,40 +1560,22 @@
           "name": "toCurriedPredicate.mjs"
         },
         {
-          "name": "toJSON.cjs"
-        },
-        {
-          "name": "toJSON.d.ts"
-        },
-        {
-          "name": "toJSON.mjs"
-        },
-        {
-          "name": "toString.cjs"
-        },
-        {
-          "name": "toString.d.ts"
-        },
-        {
-          "name": "toString.mjs"
-        },
-        {
-          "name": "toTransform.cjs"
+          "name": "toWrappedValue.cjs"
         },
         {
-          "name": "toTransform.d.ts"
+          "name": "toWrappedValue.d.ts"
         },
         {
-          "name": "toTransform.mjs"
+          "name": "toWrappedValue.mjs"
         },
         {
-          "name": "toWrappedValue.cjs"
+          "name": "transformer.cjs"
         },
         {
-          "name": "toWrappedValue.d.ts"
+          "name": "transformer.d.ts"
         },
         {
-          "name": "toWrappedValue.mjs"
+          "name": "transformer.mjs"
         },
         {
           "name": "truthy.cjs"
@@ -3032,16 +3023,16 @@
               "name": "month.d.ts"
             },
             {
-              "name": "spoolingDate.d.ts"
+              "name": "serializedTheDate.d.ts"
             },
             {
-              "name": "spoolingTime.d.ts"
+              "name": "serializedTheTime.d.ts"
             },
             {
-              "name": "theDate.d.ts"
+              "name": "spoolingDate.d.ts"
             },
             {
-              "name": "theTime.d.ts"
+              "name": "spoolingTime.d.ts"
             },
             {
               "name": "time.d.ts"
@@ -3096,24 +3087,6 @@
         {
           "name": "createOrThrow.mjs"
         },
-        {
-          "name": "createTheDate.cjs"
-        },
-        {
-          "name": "createTheDate.d.ts"
-        },
-        {
-          "name": "createTheDate.mjs"
-        },
-        {
-          "name": "createTheTime.cjs"
-        },
-        {
-          "name": "createTheTime.d.ts"
-        },
-        {
-          "name": "createTheTime.mjs"
-        },
         {
           "name": "createTime.cjs"
         },
@@ -3204,6 +3177,24 @@
         {
           "name": "isSafeTimeValue.mjs"
         },
+        {
+          "name": "isSerializedTheDate.cjs"
+        },
+        {
+          "name": "isSerializedTheDate.d.ts"
+        },
+        {
+          "name": "isSerializedTheDate.mjs"
+        },
+        {
+          "name": "isSerializedTheTime.cjs"
+        },
+        {
+          "name": "isSerializedTheTime.d.ts"
+        },
+        {
+          "name": "isSerializedTheTime.mjs"
+        },
         {
           "name": "isTime.cjs"
         },
@@ -3213,6 +3204,15 @@
         {
           "name": "isTime.mjs"
         },
+        {
+          "name": "kind.cjs"
+        },
+        {
+          "name": "kind.d.ts"
+        },
+        {
+          "name": "kind.mjs"
+        },
         {
           "name": "makeSafeTimestamp.cjs"
         },
@@ -3285,6 +3285,15 @@
         {
           "name": "round.mjs"
         },
+        {
+          "name": "serialize.cjs"
+        },
+        {
+          "name": "serialize.d.ts"
+        },
+        {
+          "name": "serialize.mjs"
+        },
         {
           "name": "sort.cjs"
         },
@@ -3303,6 +3312,24 @@
         {
           "name": "sortTimes.mjs"
         },
+        {
+          "name": "theDate.cjs"
+        },
+        {
+          "name": "theDate.d.ts"
+        },
+        {
+          "name": "theDate.mjs"
+        },
+        {
+          "name": "theTime.cjs"
+        },
+        {
+          "name": "theTime.d.ts"
+        },
+        {
+          "name": "theTime.mjs"
+        },
         {
           "name": "timezone.cjs"
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duplojs/utils",
-  "version": "1.4.57",
+  "version": "1.4.58",
   "author": {
     "name": "mathcovax",
     "url": "https://github.com/mathcovax"

package/dist/common/toJSON.cjs

@@ -1,37 +0,0 @@
-'use strict';
-
-/**
- * {@include common/toJSON/index.md}
- */
-function toJSON(value) {
-    if (typeof value === "string"
-        || typeof value === "number"
-        || value === null
-        || value === undefined) {
-        return value;
-    }
-    else if (typeof value === "object"
-        && "toJSON" in value
-        && typeof value.toJSON === "function") {
-        return value.toJSON();
-    }
-    else if (typeof value === "object"
-        && (!value.constructor
-            || value.constructor.name === "Object")) {
-        return Object
-            .entries(value)
-            .reduce((pv, [key, value]) => ({
-            ...pv,
-            [key]: toJSON(value),
-        }), {});
-    }
-    else if (value instanceof Array
-        && value.constructor.name === "Array") {
-        return value.map(toJSON);
-    }
-    else {
-        return undefined;
-    }
-}
-
-exports.toJSON = toJSON;

package/dist/common/toJSON.d.ts

@@ -1,44 +0,0 @@
-import { type AnyFunction } from "./types/anyFunction";
-import { type IsEqual } from "./types/isEqual";
-export type ToJSON<GenericValue extends unknown> = GenericValue extends number | string | null | undefined ? GenericValue : GenericValue extends ({
-    toJSON: AnyFunction;
-}) ? ReturnType<GenericValue["toJSON"]> : GenericValue extends [infer InferredFirst, ...infer InferredRest] ? [
-    ToJSON<InferredFirst>,
-    ...(ToJSON<InferredRest> extends infer InferredSubRest extends any[] ? IsEqual<InferredSubRest, never[]> extends false ? InferredSubRest : [] : [])
-] : GenericValue extends any[] ? ToJSON<GenericValue[number]>[] : GenericValue extends object ? {
-    [Prop in keyof GenericValue as GenericValue[Prop] extends AnyFunction ? never : Prop]: ToJSON<GenericValue[Prop]>;
-} : undefined;
-/**
- * The toJSON() function prepares a value for JSON serialization while respecting objects' toJSON methods, traversing arrays/tuples, and excluding functions.
- * 
- * Signature: `toJSON(value)` → returns a value
- * 
- * The input value is not mutated.
- * 
- * ```ts
- * const result = toJSON({
- * 	prop: 1,
- * 	prop1: "test",
- * 	prop2: new Date("2025-08-19T15:14:19.467Z"),
- * 	prop3: null,
- * 	prop4: undefined,
- * 	prop5: {
- * 		subProp: [{ prop1: 1 }],
- * 		subProp1: {
- * 			toJSON() {
- * 				return "test";
- * 			},
- * 		},
- * 	},
- * 	method() {
- * 		return void 0;
- * 	},
- * });
- * 
- * // type: { prop: number; prop1: string; prop2: string; prop3: null; prop4: undefined; prop5: { subProp: { prop1: number; }[]; subProp1: "test"; }; }
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/toJSON
- * 
- */
-export declare function toJSON<GenericValue extends unknown>(value: GenericValue): ToJSON<GenericValue>;

package/dist/common/toJSON.mjs

@@ -1,35 +0,0 @@
-/**
- * {@include common/toJSON/index.md}
- */
-function toJSON(value) {
-    if (typeof value === "string"
-        || typeof value === "number"
-        || value === null
-        || value === undefined) {
-        return value;
-    }
-    else if (typeof value === "object"
-        && "toJSON" in value
-        && typeof value.toJSON === "function") {
-        return value.toJSON();
-    }
-    else if (typeof value === "object"
-        && (!value.constructor
-            || value.constructor.name === "Object")) {
-        return Object
-            .entries(value)
-            .reduce((pv, [key, value]) => ({
-            ...pv,
-            [key]: toJSON(value),
-        }), {});
-    }
-    else if (value instanceof Array
-        && value.constructor.name === "Array") {
-        return value.map(toJSON);
-    }
-    else {
-        return undefined;
-    }
-}
-
-export { toJSON };

package/dist/common/toString.cjs

@@ -1,10 +0,0 @@
-'use strict';
-
-/**
- * {@include common/toString/index.md}
- */
-function toString(value) {
-    return `${value}`;
-}
-
-exports.toString = toString;

package/dist/common/toString.d.ts

@@ -1,17 +0,0 @@
-/**
- * The toString() function converts a literal (number, string, bigint, boolean, null, undefined) into a typed template string.
- * 
- * Signature: `toString(value)` → returns a value
- * 
- * The input value is not mutated.
- * 
- * ```ts
- * const result = toString(42n);
- * 
- * // type: "42"
- * ```
- * 
- * @see https://utils.duplojs.dev/en/v1/api/common/toString
- * 
- */
-export declare function toString<GenericValue extends number | string | bigint | boolean | null | undefined>(value: GenericValue): `${GenericValue}`;

package/dist/common/toString.mjs

@@ -1,8 +0,0 @@
-/**
- * {@include common/toString/index.md}
- */
-function toString(value) {
-    return `${value}`;
-}
-
-export { toString };

package/dist/common/toTransform.cjs

@@ -1,37 +0,0 @@
-'use strict';
-
-/**
- * {@include common/toTransform/index.md}
- */
-function toTransform(value) {
-    if (typeof value === "string"
-        || typeof value === "number"
-        || value === null
-        || value === undefined) {
-        return value;
-    }
-    else if (value
-        && typeof value === "object"
-        && "toTransform" in value
-        && typeof value.toTransform === "function") {
-        return (value.toTransform());
-    }
-    else if (typeof value === "object"
-        && (!value.constructor
-            || value.constructor.name === "Object")) {
-        return Object.entries(value)
-            .reduce((pv, [key, value]) => ({
-            ...pv,
-            [key]: toTransform(value),
-        }), {});
-    }
-    else if (value instanceof Array
-        && value.constructor.name === "Array") {
-        return value.map((subValue) => toTransform(subValue));
-    }
-    else {
-        return value;
-    }
-}
-
-exports.toTransform = toTransform;