@duplojs/utils 1.4.57 → 1.4.59

package/dist/date/operators/subtractMinutes.mjs

@@ -1,6 +1,6 @@
 import { millisecondInOneMinute } from '../constants.mjs';
-import { createTheDate } from '../createTheDate.mjs';
-import { toNative } from '../toNative.mjs';
+import { TheDate } from '../theDate.mjs';
+import { toTimestamp } from '../toTimestamp.mjs';
 
 function subtractMinutes(...args) {
     if (args.length === 1) {
@@ -8,9 +8,7 @@ function subtractMinutes(...args) {
         return (input) => subtractMinutes(input, minute);
     }
     const [input, minute] = args;
-    const date = toNative(input);
-    date.setTime(date.getTime() - (minute * millisecondInOneMinute));
-    return createTheDate(date.getTime());
+    return TheDate.new(toTimestamp(input) - (minute * millisecondInOneMinute));
 }
 
 export { subtractMinutes };

package/dist/date/operators/subtractMonths.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var createTheDate = require('../createTheDate.cjs');
+var theDate = require('../theDate.cjs');
 var toNative = require('../toNative.cjs');
 
 function subtractMonths(...args) {
@@ -11,7 +11,7 @@ function subtractMonths(...args) {
     const [input, month] = args;
     const date = toNative.toNative(input);
     date.setUTCMonth(date.getUTCMonth() - month);
-    return createTheDate.createTheDate(date.getTime());
+    return theDate.TheDate.new(date.getTime());
 }
 
 exports.subtractMonths = subtractMonths;

package/dist/date/operators/subtractMonths.d.ts

@@ -1,29 +1,35 @@
-import type { TheDate } from "../types";
+import { TheDate } from "../theDate";
+import type { SerializedTheDate } from "../types";
 /**
- * Subtracts months from a date.
+ * Subtracts a number of calendar months from a date.
  * 
  * **Supported call styles:**
- * - Classic: `subtractMonths(input, month)` → returns a value
- * - Curried: `subtractMonths(month)` → returns a function waiting for the input
+ * - Classic: `subtractMonths(input, month)` → `TheDate`
+ * - Curried: `subtractMonths(month)` → `(input) => TheDate`
  * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`.
  * 
  * ```ts
  * const input = D.create("2024-06-30");
  * const result = D.subtractMonths(input, 2);
- * // result: "date1711843200000+"
+ * // result: TheDate
+ * 
+ * const serialized = D.serialize(result);
+ * // serialized: SerializedTheDate
  * 
  * pipe(
- * 	input,
+ * 	serialized,
  * 	D.subtractMonths(2),
- * ); // result: "date1711843200000+"
- * 
+ * ); // TheDate
  * ```
  * 
+ * @remarks
+ * - Uses UTC month arithmetic (`Date#setUTCMonth` behavior).
+ * 
  * @see https://utils.duplojs.dev/en/v1/api/date/subtractMonths
  * 
  * @namespace D
  * 
  */
-export declare function subtractMonths<GenericInput extends TheDate, GenericMonth extends number>(month: GenericMonth): (input: GenericInput) => TheDate;
-export declare function subtractMonths<GenericInput extends TheDate, GenericMonth extends number>(input: GenericInput, month: GenericMonth): TheDate;
+export declare function subtractMonths<GenericInput extends TheDate | SerializedTheDate, GenericMonth extends number>(month: GenericMonth): (input: GenericInput) => TheDate;
+export declare function subtractMonths<GenericInput extends TheDate | SerializedTheDate, GenericMonth extends number>(input: GenericInput, month: GenericMonth): TheDate;

package/dist/date/operators/subtractMonths.mjs

@@ -1,4 +1,4 @@
-import { createTheDate } from '../createTheDate.mjs';
+import { TheDate } from '../theDate.mjs';
 import { toNative } from '../toNative.mjs';
 
 function subtractMonths(...args) {
@@ -9,7 +9,7 @@ function subtractMonths(...args) {
     const [input, month] = args;
     const date = toNative(input);
     date.setUTCMonth(date.getUTCMonth() - month);
-    return createTheDate(date.getTime());
+    return TheDate.new(date.getTime());
 }
 
 export { subtractMonths };

package/dist/date/operators/subtractSeconds.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 var constants = require('../constants.cjs');
-var createTheDate = require('../createTheDate.cjs');
-var toNative = require('../toNative.cjs');
+var theDate = require('../theDate.cjs');
+var toTimestamp = require('../toTimestamp.cjs');
 
 function subtractSeconds(...args) {
     if (args.length === 1) {
@@ -10,9 +10,7 @@ function subtractSeconds(...args) {
         return (input) => subtractSeconds(input, second);
     }
     const [input, second] = args;
-    const date = toNative.toNative(input);
-    date.setTime(date.getTime() - (second * constants.millisecondsInOneSecond));
-    return createTheDate.createTheDate(date.getTime());
+    return theDate.TheDate.new(toTimestamp.toTimestamp(input) - (second * constants.millisecondsInOneSecond));
 }
 
 exports.subtractSeconds = subtractSeconds;

package/dist/date/operators/subtractSeconds.d.ts

@@ -1,23 +1,26 @@
-import type { TheDate } from "../types";
+import { TheDate } from "../theDate";
+import type { SerializedTheDate } from "../types";
 /**
- * Subtracts seconds from a date.
+ * Subtracts a number of seconds from a date.
  * 
  * **Supported call styles:**
- * - Classic: `subtractSeconds(input, second)` → returns a value
- * - Curried: `subtractSeconds(second)` → returns a function waiting for the input
+ * - Classic: `subtractSeconds(input, second)` → `TheDate`
+ * - Curried: `subtractSeconds(second)` → `(input) => TheDate`
  * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`.
  * 
  * ```ts
  * const input = D.create("2024-06-20");
  * const result = D.subtractSeconds(input, 30);
- * // result: "date1718841570000+"
+ * // result: TheDate
+ * 
+ * const serialized = D.serialize(result);
+ * // serialized: SerializedTheDate
  * 
  * pipe(
- * 	input,
+ * 	serialized,
  * 	D.subtractSeconds(30),
- * ); // result: "date1718841570000+"
- * 
+ * ); // TheDate
  * ```
  * 
  * @see https://utils.duplojs.dev/en/v1/api/date/subtractSeconds
@@ -25,5 +28,5 @@ import type { TheDate } from "../types";
  * @namespace D
  * 
  */
-export declare function subtractSeconds<GenericInput extends TheDate, GenericSecond extends number>(second: GenericSecond): (input: GenericInput) => TheDate;
-export declare function subtractSeconds<GenericInput extends TheDate, GenericSecond extends number>(input: GenericInput, second: GenericSecond): TheDate;
+export declare function subtractSeconds<GenericInput extends TheDate | SerializedTheDate, GenericSecond extends number>(second: GenericSecond): (input: GenericInput) => TheDate;
+export declare function subtractSeconds<GenericInput extends TheDate | SerializedTheDate, GenericSecond extends number>(input: GenericInput, second: GenericSecond): TheDate;

package/dist/date/operators/subtractSeconds.mjs

@@ -1,6 +1,6 @@
 import { millisecondsInOneSecond } from '../constants.mjs';
-import { createTheDate } from '../createTheDate.mjs';
-import { toNative } from '../toNative.mjs';
+import { TheDate } from '../theDate.mjs';
+import { toTimestamp } from '../toTimestamp.mjs';
 
 function subtractSeconds(...args) {
     if (args.length === 1) {
@@ -8,9 +8,7 @@ function subtractSeconds(...args) {
         return (input) => subtractSeconds(input, second);
     }
     const [input, second] = args;
-    const date = toNative(input);
-    date.setTime(date.getTime() - (second * millisecondsInOneSecond));
-    return createTheDate(date.getTime());
+    return TheDate.new(toTimestamp(input) - (second * millisecondsInOneSecond));
 }
 
 export { subtractSeconds };

package/dist/date/operators/subtractTime.cjs

@@ -1,9 +1,10 @@
 'use strict';
 
-var createTheDate = require('../createTheDate.cjs');
-var createTheTime = require('../createTheTime.cjs');
 var toTimestamp = require('../toTimestamp.cjs');
 var toTimeValue = require('../toTimeValue.cjs');
+var theDate = require('../theDate.cjs');
+var theTime = require('../theTime.cjs');
+var isSerializedTheTime = require('../isSerializedTheTime.cjs');
 
 function subtractTime(...args) {
     if (args.length === 1) {
@@ -11,11 +12,17 @@ function subtractTime(...args) {
         return (input) => subtractTime(input, time);
     }
     const [input, time] = args;
-    const timeTimestamp = toTimeValue.toTimeValue(time);
-    if (input.startsWith("date")) {
-        return createTheDate.createTheDate(toTimestamp.toTimestamp(input) - timeTimestamp);
+    const timeValue = toTimeValue.toTimeValue(time);
+    if (input instanceof theDate.TheDate) {
+        const timestamp = toTimestamp.toTimestamp(input);
+        return theDate.TheDate.new(timestamp - timeValue);
     }
-    return createTheTime.createTheTime(toTimeValue.toTimeValue(input) - timeTimestamp);
+    if (input instanceof theTime.TheTime || isSerializedTheTime.isSerializedTheTime(input)) {
+        const inputTimeValue = toTimeValue.toTimeValue(input);
+        return theTime.TheTime.new(inputTimeValue - timeValue);
+    }
+    const timestamp = toTimestamp.toTimestamp(input);
+    return theDate.TheDate.new(timestamp - timeValue);
 }
 
 exports.subtractTime = subtractTime;

package/dist/date/operators/subtractTime.d.ts

@@ -1,28 +1,30 @@
-import type { TheDate, TheTime } from "../types";
+import type { SerializedTheDate, SerializedTheTime } from "../types";
+import { TheDate } from "../theDate";
+import { TheTime } from "../theTime";
 /**
- * Subtracts a TheTime from a TheDate or TheTime.
+ * Subtracts a normalized duration (`TheTime` or `SerializedTheTime`) from a date.
  * 
  * **Supported call styles:**
- * - Classic: `subtractTime(input, time)` → returns a value
- * - Curried: `subtractTime(time)` → returns a function waiting for the input
+ * - Classic: `subtractTime(input, time)` → `TheDate | TheTime`
+ * - Curried: `subtractTime(time)` → `(input) => TheDate | TheTime`
  * 
- * The input value is not mutated.
+ * If `input` is `TheDate | SerializedTheDate`, the result is `TheDate`.
+ * The operator also supports `TheTime | SerializedTheTime` as input and returns `TheTime`.
  * 
  * ```ts
- * const date = D.createTheDate(0);
- * const time = D.createTheTime(3_600_000);
+ * const date = D.create("2024-06-20");
+ * const time = D.createTime(1, "hour");
  * 
  * const result = D.subtractTime(date, time);
- * // result: "date3600000-"
+ * // result: TheDate
  * 
- * const result2 = D.subtractTime("time5000+", "time2000+");
- * // result2: "time3000+"
+ * const result2 = D.subtractTime(time, D.createTime(30, "minute"));
+ * // result2: TheTime
  * 
- * const result3 = pipe(
+ * pipe(
  * 	date,
- * 	D.subtractTime("time1000+"),
- * );
- * // result3: "date3599000-"
+ * 	D.subtractTime(D.createTime(15, "minute")),
+ * ); // TheDate
  * ```
  * 
  * @see https://utils.duplojs.dev/en/v1/api/date/subtractTime
@@ -30,7 +32,7 @@ import type { TheDate, TheTime } from "../types";
  * @namespace D
  * 
  */
-export declare function subtractTime<GenericInput extends TheDate>(time: TheTime): (input: GenericInput) => TheDate;
-export declare function subtractTime<GenericInput extends TheTime>(time: TheTime): (input: GenericInput) => TheTime;
-export declare function subtractTime<GenericInput extends TheDate>(input: GenericInput, time: TheTime): TheDate;
-export declare function subtractTime<GenericInput extends TheTime>(input: GenericInput, time: TheTime): TheTime;
+export declare function subtractTime<GenericInput extends TheDate | SerializedTheDate>(time: TheTime | SerializedTheTime): (input: GenericInput) => TheDate;
+export declare function subtractTime<GenericInput extends TheTime | SerializedTheTime>(time: TheTime | SerializedTheTime): (input: GenericInput) => TheTime;
+export declare function subtractTime<GenericInput extends TheDate | SerializedTheDate>(input: GenericInput, time: TheTime | SerializedTheTime): TheDate;
+export declare function subtractTime<GenericInput extends TheTime | SerializedTheTime>(input: GenericInput, time: TheTime | SerializedTheTime): TheTime;

package/dist/date/operators/subtractTime.mjs

@@ -1,7 +1,8 @@
-import { createTheDate } from '../createTheDate.mjs';
-import { createTheTime } from '../createTheTime.mjs';
 import { toTimestamp } from '../toTimestamp.mjs';
 import { toTimeValue } from '../toTimeValue.mjs';
+import { TheDate } from '../theDate.mjs';
+import { TheTime } from '../theTime.mjs';
+import { isSerializedTheTime } from '../isSerializedTheTime.mjs';
 
 function subtractTime(...args) {
     if (args.length === 1) {
@@ -9,11 +10,17 @@ function subtractTime(...args) {
         return (input) => subtractTime(input, time);
     }
     const [input, time] = args;
-    const timeTimestamp = toTimeValue(time);
-    if (input.startsWith("date")) {
-        return createTheDate(toTimestamp(input) - timeTimestamp);
+    const timeValue = toTimeValue(time);
+    if (input instanceof TheDate) {
+        const timestamp = toTimestamp(input);
+        return TheDate.new(timestamp - timeValue);
     }
-    return createTheTime(toTimeValue(input) - timeTimestamp);
+    if (input instanceof TheTime || isSerializedTheTime(input)) {
+        const inputTimeValue = toTimeValue(input);
+        return TheTime.new(inputTimeValue - timeValue);
+    }
+    const timestamp = toTimestamp(input);
+    return TheDate.new(timestamp - timeValue);
 }
 
 export { subtractTime };

package/dist/date/operators/subtractWeeks.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 var constants = require('../constants.cjs');
-var createTheDate = require('../createTheDate.cjs');
-var toNative = require('../toNative.cjs');
+var theDate = require('../theDate.cjs');
+var toTimestamp = require('../toTimestamp.cjs');
 
 function subtractWeeks(...args) {
     if (args.length === 1) {
@@ -10,9 +10,7 @@ function subtractWeeks(...args) {
         return (input) => subtractWeeks(input, week);
     }
     const [input, week] = args;
-    const date = toNative.toNative(input);
-    date.setTime(date.getTime() - (week * constants.millisecondInOneWeek));
-    return createTheDate.createTheDate(date.getTime());
+    return theDate.TheDate.new(toTimestamp.toTimestamp(input) - (week * constants.millisecondInOneWeek));
 }
 
 exports.subtractWeeks = subtractWeeks;

package/dist/date/operators/subtractWeeks.d.ts

@@ -1,23 +1,26 @@
-import type { TheDate } from "../types";
+import { TheDate } from "../theDate";
+import type { SerializedTheDate } from "../types";
 /**
- * Subtracts weeks from a date.
+ * Subtracts a number of weeks from a date.
  * 
  * **Supported call styles:**
- * - Classic: `subtractWeeks(input, week)` → returns a value
- * - Curried: `subtractWeeks(week)` → returns a function waiting for the input
+ * - Classic: `subtractWeeks(input, week)` → `TheDate`
+ * - Curried: `subtractWeeks(week)` → `(input) => TheDate`
  * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`.
  * 
  * ```ts
  * const input = D.create("2024-06-30");
  * const result = D.subtractWeeks(input, 4);
- * // result: "date1716076800000+"
+ * // result: TheDate
+ * 
+ * const serialized = D.serialize(result);
+ * // serialized: SerializedTheDate
  * 
  * pipe(
- * 	input,
+ * 	serialized,
  * 	D.subtractWeeks(4),
- * ); // result: "date1716076800000+"
- * 
+ * ); // TheDate
  * ```
  * 
  * @see https://utils.duplojs.dev/en/v1/api/date/subtractWeeks
@@ -25,5 +28,5 @@ import type { TheDate } from "../types";
  * @namespace D
  * 
  */
-export declare function subtractWeeks<GenericInput extends TheDate, GenericWeek extends number>(week: GenericWeek): (input: GenericInput) => TheDate;
-export declare function subtractWeeks<GenericInput extends TheDate, GenericWeek extends number>(input: GenericInput, week: GenericWeek): TheDate;
+export declare function subtractWeeks<GenericInput extends TheDate | SerializedTheDate, GenericWeek extends number>(week: GenericWeek): (input: GenericInput) => TheDate;
+export declare function subtractWeeks<GenericInput extends TheDate | SerializedTheDate, GenericWeek extends number>(input: GenericInput, week: GenericWeek): TheDate;

package/dist/date/operators/subtractWeeks.mjs

@@ -1,6 +1,6 @@
 import { millisecondInOneWeek } from '../constants.mjs';
-import { createTheDate } from '../createTheDate.mjs';
-import { toNative } from '../toNative.mjs';
+import { TheDate } from '../theDate.mjs';
+import { toTimestamp } from '../toTimestamp.mjs';
 
 function subtractWeeks(...args) {
     if (args.length === 1) {
@@ -8,9 +8,7 @@ function subtractWeeks(...args) {
         return (input) => subtractWeeks(input, week);
     }
     const [input, week] = args;
-    const date = toNative(input);
-    date.setTime(date.getTime() - (week * millisecondInOneWeek));
-    return createTheDate(date.getTime());
+    return TheDate.new(toTimestamp(input) - (week * millisecondInOneWeek));
 }
 
 export { subtractWeeks };

package/dist/date/operators/subtractYears.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var createTheDate = require('../createTheDate.cjs');
+var theDate = require('../theDate.cjs');
 var toNative = require('../toNative.cjs');
 
 function subtractYears(...args) {
@@ -11,7 +11,7 @@ function subtractYears(...args) {
     const [input, year] = args;
     const date = toNative.toNative(input);
     date.setUTCFullYear(date.getUTCFullYear() - year);
-    return createTheDate.createTheDate(date.getTime());
+    return theDate.TheDate.new(date.getTime());
 }
 
 exports.subtractYears = subtractYears;

package/dist/date/operators/subtractYears.d.ts

@@ -1,29 +1,35 @@
-import type { TheDate } from "../types";
+import { TheDate } from "../theDate";
+import type { SerializedTheDate } from "../types";
 /**
- * Subtracts years from a date.
+ * Subtracts a number of calendar years from a date.
  * 
  * **Supported call styles:**
- * - Classic: `subtractYears(input, year)` → returns a value
- * - Curried: `subtractYears(year)` → returns a function waiting for the input
+ * - Classic: `subtractYears(input, year)` → `TheDate`
+ * - Curried: `subtractYears(year)` → `(input) => TheDate`
  * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`.
  * 
  * ```ts
  * const input = D.create("2024-06-20");
  * const result = D.subtractYears(input, 1);
- * // result: "date1687219200000+"
+ * // result: TheDate
+ * 
+ * const serialized = D.serialize(result);
+ * // serialized: SerializedTheDate
  * 
  * pipe(
- * 	input,
+ * 	serialized,
  * 	D.subtractYears(1),
- * ); // result: "date1687219200000+"
- * 
+ * ); // TheDate
  * ```
  * 
+ * @remarks
+ * - Uses UTC year arithmetic (`Date#setUTCFullYear` behavior).
+ * 
  * @see https://utils.duplojs.dev/en/v1/api/date/subtractYears
  * 
  * @namespace D
  * 
  */
-export declare function subtractYears<GenericInput extends TheDate, GenericYear extends number>(year: GenericYear): (input: GenericInput) => TheDate;
-export declare function subtractYears<GenericInput extends TheDate, GenericYear extends number>(input: GenericInput, year: GenericYear): TheDate;
+export declare function subtractYears<GenericInput extends TheDate | SerializedTheDate, GenericYear extends number>(year: GenericYear): (input: GenericInput) => TheDate;
+export declare function subtractYears<GenericInput extends TheDate | SerializedTheDate, GenericYear extends number>(input: GenericInput, year: GenericYear): TheDate;

package/dist/date/operators/subtractYears.mjs

@@ -1,4 +1,4 @@
-import { createTheDate } from '../createTheDate.mjs';
+import { TheDate } from '../theDate.mjs';
 import { toNative } from '../toNative.mjs';
 
 function subtractYears(...args) {
@@ -9,7 +9,7 @@ function subtractYears(...args) {
     const [input, year] = args;
     const date = toNative(input);
     date.setUTCFullYear(date.getUTCFullYear() - year);
-    return createTheDate(date.getTime());
+    return TheDate.new(date.getTime());
 }
 
 export { subtractYears };

package/dist/date/round.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+var theDate = require('./theDate.cjs');
 var toNative = require('./toNative.cjs');
 
 const stepMapper = {
@@ -19,8 +20,7 @@ const stepMapper = {
 function round(input, unit = "day") {
     const date = toNative.toNative(input);
     const timestamp = stepMapper[unit](date);
-    const isNegative = timestamp < 0;
-    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+    return theDate.TheDate.new(timestamp);
 }
 
 exports.round = round;

package/dist/date/round.d.ts

@@ -1,11 +1,12 @@
-import type { TheDate, Unit } from "./types";
+import { TheDate } from "./theDate";
+import type { SerializedTheDate, Unit } from "./types";
 export type RoundUnit = Exclude<Unit, "millisecond">;
 /**
- * Rounds a date to a unit.
+ * Rounds down a date to a UTC unit boundary.
  * 
- * Signature: `round(input, unit)` → returns a value
+ * Signature: `round(input, unit?)` → `TheDate`
  * 
- * The input value is not mutated.
+ * `input` accepts `TheDate` or `SerializedTheDate`. Default `unit` is `"day"`.
  * 
  * ```ts
  * const input = D.create("2024-06-20", {
@@ -14,25 +15,21 @@ export type RoundUnit = Exclude<Unit, "millisecond">;
  * 	second: "56",
  * 	millisecond: "789",
  * });
- * const result = D.round(input);
- * // result: "date1718841600000+"
  * 
- * const result2 = D.round(input, "month");
- * // result2: "date1717200000000+"
+ * const byDay = D.round(input);
+ * // byDay: TheDate
  * 
- * pipe(
- * 	input,
- * 	D.round,
- * ); // result: "date1718841600000+"
+ * const byMonth = D.round(input, "month");
+ * // byMonth: TheDate
  * 
  * ```
  * 
  * @remarks
- * - Rounds using the provided unit.
+ * - Supported units: `second`, `minute`, `hour`, `day`, `month`, `year`.
  * 
  * @see https://utils.duplojs.dev/en/v1/api/date/round
  * 
  * @namespace D
  * 
  */
-export declare function round(input: TheDate, unit?: RoundUnit): `date${number}-` | `date${number}+`;
+export declare function round(input: (TheDate | SerializedTheDate), unit?: RoundUnit): TheDate;

package/dist/date/round.mjs

@@ -1,3 +1,4 @@
+import { TheDate } from './theDate.mjs';
 import { toNative } from './toNative.mjs';
 
 const stepMapper = {
@@ -17,8 +18,7 @@ const stepMapper = {
 function round(input, unit = "day") {
     const date = toNative(input);
     const timestamp = stepMapper[unit](date);
-    const isNegative = timestamp < 0;
-    return `date${Math.abs(timestamp)}${isNegative ? "-" : "+"}`;
+    return TheDate.new(timestamp);
 }
 
 export { round };

package/dist/date/serialize.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+var theDate = require('./theDate.cjs');
+
+function serialize(input) {
+    if (input instanceof theDate.TheDate) {
+        const timestamp = input.getTime();
+        return `date${Math.abs(timestamp)}${timestamp > 0 ? "+" : "-"}`;
+    }
+    const number = input.toNative();
+    return `time${Math.abs(number)}${number > 0 ? "+" : "-"}`;
+}
+
+exports.serialize = serialize;

package/dist/date/serialize.d.ts

@@ -0,0 +1,41 @@
+import { TheDate } from "./theDate";
+import type { TheTime } from "./theTime";
+import type { SerializedTheTime } from "./types";
+import { type SerializedTheDate } from "./types/serializedTheDate";
+/**
+ * Serializes immutable date values into their string literal formats.
+ * 
+ * Supported call styles:
+ * - Classic: `serialize(input)` where `input` is `TheDate` or `TheTime`
+ * - Curried: not supported
+ * 
+ * `TheDate` values are serialized to `SerializedTheDate` (`date${number}${"+" | "-"}`), and `TheTime` values are serialized to `SerializedTheTime` (`time${number}${"+" | "-"}`).
+ * 
+ * ```ts
+ * const inputDate = D.create("2024-06-20");
+ * const resultDate = D.serialize(inputDate);
+ * // resultDate: SerializedTheDate
+ * 
+ * const inputTime = D.createTime(4, "day");
+ * const resultTime = D.serialize(inputTime);
+ * // resultTime: SerializedTheTime
+ * 
+ * const resultDate2 = D.serialize(
+ * 	D.create("2025-10-20"),
+ * );
+ * // resultDate2: SerializedTheDate
+ * 
+ * ```
+ * 
+ * @remarks
+ * - This function is the string bridge between immutable classes (`TheDate`, `TheTime`) and serialized literal types (`SerializedTheDate`, `SerializedTheTime`).
+ * 
+ * @see https://utils.duplojs.dev/en/v1/api/date/serialize
+ * @see https://utils.duplojs.dev/en/v1/api/date/theDate
+ * @see https://utils.duplojs.dev/en/v1/api/date/theTime
+ * 
+ * @namespace D
+ * 
+ */
+export declare function serialize(input: TheDate): SerializedTheDate;
+export declare function serialize(input: TheTime): SerializedTheTime;

package/dist/date/serialize.mjs

@@ -0,0 +1,12 @@
+import { TheDate } from './theDate.mjs';
+
+function serialize(input) {
+    if (input instanceof TheDate) {
+        const timestamp = input.getTime();
+        return `date${Math.abs(timestamp)}${timestamp > 0 ? "+" : "-"}`;
+    }
+    const number = input.toNative();
+    return `time${Math.abs(number)}${number > 0 ? "+" : "-"}`;
+}
+
+export { serialize };