slotlock 0.1.0 → 0.2.0

package/timezone.d.ts

@@ -14,6 +14,11 @@ export interface TimeZoneConverter {
      */
     wallFrameToUtc(wallFrameMs: number): Date;
 }
+/**
+ * Date.UTC remaps years 0..99 to 1900..1999. Slotlock accepts ISO calendar years down to 1,
+ * so construct UTC frames through setUTCFullYear instead of inheriting that legacy quirk.
+ */
+export declare function utcFrame(year: number, month: number, day: number, hour: number, minute: number, second: number, millisecond: number): Date;
 export declare function createTimeZoneConverter(timezone: string): TimeZoneConverter;
 export interface ZonedCalendarDate {
     /** Civil date of the instant in the zone, `YYYY-MM-DD`. */
@@ -41,4 +46,18 @@ export interface ZonedWallTime {
 export declare function zonedWallTime(instant: Date, timezone: string): ZonedWallTime;
 /** How far `timezone` is ahead of UTC at `instant`, in whole minutes (negative west of UTC). */
 export declare function zonedOffsetMinutes(instant: Date, timezone: string): number;
+/** A wall clock's fields, to the second. */
+export interface ZonedDateTimeFields {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+}
+/**
+ * The wall-clock fields an instant reads as in `timezone`, to the second: what a calendar writes
+ * beside a TZID. Reads through the cached formatters, as every conversion here does.
+ */
+export declare function zonedDateTimeFields(instant: Date, timezone: string): ZonedDateTimeFields;
 export declare function zonedDateTimeToUtc(value: LocalDateTime, timezone: string): Date;

package/timezone.js

@@ -3,7 +3,7 @@ const FOURTEEN_HOURS_MS = 14 * 60 * 60 * 1000;
  * Date.UTC remaps years 0..99 to 1900..1999. Slotlock accepts ISO calendar years down to 1,
  * so construct UTC frames through setUTCFullYear instead of inheriting that legacy quirk.
  */
-function utcFrame(year, month, day, hour, minute, second, millisecond) {
+export function utcFrame(year, month, day, hour, minute, second, millisecond) {
     const frame = new Date(0);
     frame.setUTCFullYear(year, month - 1, day);
     frame.setUTCHours(hour, minute, second, millisecond);
@@ -106,6 +106,21 @@ export function zonedWallTime(instant, timezone) {
 export function zonedOffsetMinutes(instant, timezone) {
     return Math.round((wallFrame(instant, timezone).getTime() - instant.getTime()) / 60_000);
 }
+/**
+ * The wall-clock fields an instant reads as in `timezone`, to the second: what a calendar writes
+ * beside a TZID. Reads through the cached formatters, as every conversion here does.
+ */
+export function zonedDateTimeFields(instant, timezone) {
+    const wall = wallFrame(instant, timezone);
+    return {
+        year: wall.getUTCFullYear(),
+        month: wall.getUTCMonth() + 1,
+        day: wall.getUTCDate(),
+        hour: wall.getUTCHours(),
+        minute: wall.getUTCMinutes(),
+        second: wall.getUTCSeconds(),
+    };
+}
 /** The instant shifted so its UTC fields read as the wall clock in `timezone`. */
 function wallFrame(instant, timezone) {
     const ms = instant.getTime();

package/types.d.ts

@@ -333,7 +333,10 @@ export interface CalendarHorizonRollCursor {
 export interface CalendarHorizonRollResult {
     /** Due recurring masters examined in deterministic order. */
     examined: number;
-    /** Masters atomically rematerialized to the requested window. */
+    /**
+     * Masters atomically rematerialized from the requested window's start through the later of their
+     * stored end and the window's: a roll never moves a series' end back.
+     */
     extended: number;
     /** Masters whose new occurrence collided; their previous coverage remains intact. */
     conflicts: number;

package/weekly-hours.js

@@ -1,11 +1,11 @@
 // Bookable hours: the one validator for weekly availability rules, and the conversion between rules
 // and a week of windows, the form people edit them in (two windows a day at most).
-import { expandRules } from './rules.js';
+import { SLOTLOCK_MAX_RULE_DURATION_MINUTES, expandRules } from './rules.js';
 /** Rules one schedule may hold: the server default, or one resource's own hours. */
 export const SLOTLOCK_MAX_AVAILABILITY_RULES = 50;
 const RULE_KEYS = new Set(['rrule', 'startMinutes', 'durationMinutes']);
 const MAX_RRULE_CHARACTERS = 500;
-const MAX_DURATION_MINUTES = 10_080;
+const MAX_DURATION_MINUTES = SLOTLOCK_MAX_RULE_DURATION_MINUTES;
 const DAY_MINUTES = 1_440;
 /** Two weeks every supported weekly rule produces a window in. */
 const SAMPLE = { start: new Date('2026-01-05T00:00:00Z'), end: new Date('2026-01-19T00:00:00Z') };