@opencxh/domain 1.233.1 → 1.234.0

package/dist/entities/planning/pattern.d.ts

@@ -42,10 +42,14 @@ export interface WorkPattern {
     updatedAt?: number;
 }
 /**
- * Whole calendar days between two instants.
+ * Whole days between two instants, rounded.
  *
- * Counted through `Date`, not by dividing milliseconds: two days a year are 23 or 25 hours long,
- * and a rotation that slips a day every March is a rota nobody trusts again.
+ * **Deliberately timezone-free.** An earlier version normalised both sides to local noon, which
+ * reads the *evaluating* machine's clock — and the two timestamps come from the browser. On a
+ * UTC server a CEST Monday midnight floors to the previous Sunday, the week walks eight days
+ * instead of seven, and the eighth wraps onto cycle day zero: five eight-hour days silently
+ * became six. Rounding the raw difference needs no shared timezone and absorbs the 23- and
+ * 25-hour days of a daylight-saving change on its own.
  */
 export declare function calendarDaysBetween(from: number, to: number): number;
 /** Which day of the cycle a date falls on. Negative offsets wrap the right way round. */