@dereekb/date 13.2.1 → 13.3.0

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@dereekb/date",
-  "version": "13.2.1",
+  "version": "13.3.0",
   "peerDependencies": {
-    "@dereekb/rxjs": "13.2.1",
-    "@dereekb/util": "13.2.1",
+    "@dereekb/rxjs": "13.3.0",
+    "@dereekb/util": "13.3.0",
     "@vvo/tzdb": "^6.0.0",
     "arktype": "^2.2.0",
     "date-fns": "^4.0.0",
@@ -13,7 +13,7 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@dereekb/rxjs": "13.2.1"
+    "@dereekb/rxjs": "13.3.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/src/lib/date/date.cell.index.d.ts

@@ -1,4 +1,4 @@
-import { type Maybe, type SortCompareFunction, type RequiredOnKeys, type ArrayOrValue, type UniqueModel, type IndexNumber, type FactoryWithRequiredInput, type DateRelativeState } from '@dereekb/util';
+import { type Maybe, type SortCompareFunction, type ArrayOrValue, type UniqueModel, type IndexNumber, type FactoryWithRequiredInput, type DateRelativeState } from '@dereekb/util';
 import { type DateCell, type DateOrDateCellIndex, type DateCellIndex } from './date.cell';
 import { type DateRange } from './date.range';
 /**
@@ -10,7 +10,7 @@ export interface DateCellRange extends DateCell {
      *
      * If not provided, assumes this has no range and starts/ends at the same index, i.
      */
-    to?: DateCellIndex;
+    to?: Maybe<DateCellIndex>;
 }
 /**
  * Returns true if the input is a DateCellRange.
@@ -101,7 +101,7 @@ export type DateOrDateRangeOrDateCellIndexOrDateCellRange = DateRange | DateOrDa
  * @param i - starting cell index
  * @param to - ending cell index (inclusive); defaults to `i`
  */
-export declare function dateCellRange(i: number, to?: number): DateCellRangeWithRange;
+export declare function dateCellRange(i: number, to?: Maybe<number>): DateCellRangeWithRange;
 /**
  * Creates a single-cell {@link DateCellRangeWithRange} where both `i` and `to` equal the given index.
  *
@@ -159,7 +159,9 @@ export declare function sortDateCellRanges<T extends DateCellRange>(input: T[]):
 /**
  * DateCellRange that is known to have a to value.
  */
-export type DateCellRangeWithRange = RequiredOnKeys<DateCellRange, 'to'>;
+export type DateCellRangeWithRange = Omit<DateCellRange, 'to'> & {
+    to: DateCellIndex;
+};
 /**
  * Merges an array of {@link DateCell} or {@link DateCellRange} values into the smallest set of
  * contiguous {@link DateCellRangeWithRange} values. Adjacent or overlapping ranges are combined.

package/src/lib/date/date.model.d.ts

@@ -16,35 +16,35 @@ export declare const knownTimezoneType: import("arktype/internal/variants/string
 /**
  * ArkType DTO schema for {@link DateDurationSpan}.
  *
- * Parses date strings from JSON/DTO input into Date objects using `string.date.parse`.
+ * Accepts both Date objects and date strings (parsed via `string.date.parse`).
  * Use this schema when validating and converting serialized data (e.g., API responses, JSON payloads)
- * into the corresponding runtime types.
+ * or runtime Date objects into the corresponding runtime types.
  */
 export declare const dateDurationSpanType: import("arktype/internal/variants/object.ts").ObjectType<{
-    startsAt: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    startsAt: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     duration: number;
 }, {}>;
 /**
  * ArkType DTO schema for {@link DateRange}.
  *
- * Parses date strings from JSON/DTO input into Date objects using `string.date.parse`.
+ * Accepts both Date objects and date strings (parsed via `string.date.parse`).
  * Use this schema when validating and converting serialized data (e.g., API responses, JSON payloads)
- * into the corresponding runtime types.
+ * or runtime Date objects into the corresponding runtime types.
  */
 export declare const dateRangeType: import("arktype/internal/variants/object.ts").ObjectType<{
-    start: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
-    end: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    start: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
+    end: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
 }, {}>;
 /**
  * ArkType DTO schema for {@link DateRangeParams}.
  *
- * Parses date strings from JSON/DTO input into Date objects using `string.date.parse`.
+ * Accepts both Date objects and date strings (parsed via `string.date.parse`).
  * Use this schema when validating and converting serialized data (e.g., API responses, JSON payloads)
- * into the corresponding runtime types.
+ * or runtime Date objects into the corresponding runtime types.
  */
 export declare const dateRangeParamsType: import("arktype/internal/variants/object.ts").ObjectType<{
     type: DateRangeType;
-    date: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    date: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     distance?: number | undefined;
 }, {}>;
 /**
@@ -71,25 +71,25 @@ export declare const dateCellRangeType: import("arktype/internal/variants/object
 /**
  * ArkType DTO schema for {@link DateCellTiming}.
  *
- * Parses date strings from JSON/DTO input into Date objects using `string.date.parse`.
+ * Accepts both Date objects and date strings (parsed via `string.date.parse`).
  * Use this schema when validating and converting serialized data (e.g., API responses, JSON payloads)
- * into the corresponding runtime types.
+ * or runtime Date objects into the corresponding runtime types.
  */
 export declare const dateCellTimingType: import("arktype/internal/variants/object.ts").ObjectType<{
-    startsAt: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    startsAt: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     duration: number;
-    end: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    end: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     timezone: string;
 }, {}>;
 /**
  * ArkType DTO schema for {@link CalendarDate}.
  *
- * Parses date strings from JSON/DTO input into Date objects using `string.date.parse`.
+ * Accepts both Date objects and date strings (parsed via `string.date.parse`).
  * Use this schema when validating and converting serialized data (e.g., API responses, JSON payloads)
- * into the corresponding runtime types.
+ * or runtime Date objects into the corresponding runtime types.
  */
 export declare const calendarDateType: import("arktype/internal/variants/object.ts").ObjectType<{
-    startsAt: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    startsAt: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     duration: number;
     type: CalendarDateType;
 }, {}>;
@@ -108,27 +108,27 @@ export declare const dateCellScheduleType: import("arktype/internal/variants/obj
 /**
  * ArkType DTO schema for {@link ModelRecurrenceInfo}.
  *
- * Parses date strings from JSON/DTO input into Date objects using `string.date.parse`.
+ * Accepts both Date objects and date strings (parsed via `string.date.parse`).
  * Use this schema when validating and converting serialized data (e.g., API responses, JSON payloads)
- * into the corresponding runtime types.
+ * or runtime Date objects into the corresponding runtime types.
  */
 export declare const modelRecurrenceInfoType: import("arktype/internal/variants/object.ts").ObjectType<{
     rrule: string;
-    start: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
-    end: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    start: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
+    end: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     timezone?: string | undefined;
     forever?: boolean | undefined;
 }, {}>;
 /**
  * ArkType DTO schema that validates a value is a valid {@link DateCellTiming}.
  *
- * Parses date strings from JSON/DTO input into Date objects, then validates the resulting timing
+ * Accepts both Date objects and date strings (parsed via `string.date.parse`), then validates the resulting timing
  * using {@link isValidDateCellTiming}.
  */
 export declare const validDateCellTimingType: import("arktype/internal/variants/object.ts").ObjectType<{
-    startsAt: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    startsAt: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     duration: number;
-    end: (In: string) => import("arktype/internal/attributes.ts").To<Date>;
+    end: Date | ((In: string) => import("arktype/internal/attributes.ts").To<Date>);
     timezone: string;
 }, {}>;
 /**