datetime-lube 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.0.1
+
+### Fixed
+
+- `startOf` returned a day, week, month or year that began exactly where a forward jump of the clock
+  lands 1 ms late.
+- `stringToDate("-000000-01-01")` returned year 0 instead of an invalid `Date`, which ISO 8601 and
+  ECMAScript give `-000000`; it is invalid with and without a time zone.
+
 ## 1.0.0
 
 ### Breaking

package/package.json

@@ -4,9 +4,6 @@
     "url": "https://github.com/artxe/lube-series/issues"
   },
   "description": "Simplify Date Manipulation with Time Zones in JavaScript",
-  "devDependencies": {
-    "@typescript/native": "npm:typescript@^7.0.2"
-  },
   "engines": {
     "node": ">=18"
   },
@@ -55,10 +52,10 @@
       ]
     }
   },
-  "version": "1.0.0",
+  "version": "1.0.1",
   "scripts": {
     "dts": "node ../../scripts/tsc_with_clean.js datetime-lube",
     "lint": "pnpm -w lint",
-    "test": "pnpm -w exec vitest run --coverage test/datetime-lube"
+    "test": "pnpm -w exec vitest run test/datetime-lube"
   }
 }

package/src/add.js

@@ -51,19 +51,30 @@ function add_months(date, months, zone) {
  */
 function compile(sum) {
 	let steps = durations.get(sum)
-	if (steps) return steps
+	if (steps) {
+		return steps
+	}
 	steps = []
 	if (!/\S/.test(sum) || /\S/.test(
 		sum.replace(duration_regex, "")
-	)) throw new RangeError(
-		`add: Invalid duration "${String(sum)}"`
-	)
+	)) {
+		throw new RangeError(
+			`add: Invalid duration "${String(sum)}"`
+		)
+	}
 	for (const [ , value = "", unit = "" ] of sum.matchAll(duration_regex)) {
-		if (!+value) continue
-		if (unit == "W") steps.push("D", +value * 7)
-		else steps.push(unit, +value)
+		if (!+value) {
+			continue
+		}
+		if (unit == "W") {
+			steps.push("D", +value * 7)
+		} else {
+			steps.push(unit, +value)
+		}
+	}
+	if (durations.size >= 1000) {
+		durations.clear()
 	}
-	if (durations.size >= 1000) durations.clear()
 	durations.set(sum, steps)
 	return steps
 }
@@ -104,22 +115,28 @@ export default function(date, sum, zone) {
 	const steps = compile(sum)
 	check_zone("add", zone)
 	const result = new Date(time)
-	if (isNaN(time)) return result
+	if (isNaN(time)) {
+		return result
+	}
 	if (zone === undefined) {
 		for (let i = 0; i < steps.length; i += 2) {
 			const unit = /** @type {string} */(steps[i])/**/
 			const value = /** @type {number} */(steps[i + 1])/**/
 			const ms = unit_ms[unit]
-			if (ms) result.setTime(result.getTime() + value * ms)
-			else if (unit == "D") result.setDate(result.getDate() + value)
-			else result.setTime(
-				add_months(
-					result,
-					unit == "Y"
-						? value * 12
-						: value
-				).getTime()
-			)
+			if (ms) {
+				result.setTime(result.getTime() + value * ms)
+			} else if (unit == "D") {
+				result.setDate(result.getDate() + value)
+			} else {
+				result.setTime(
+					add_months(
+						result,
+						unit == "Y"
+							? value * 12
+							: value
+					).getTime()
+				)
+			}
 		}
 		return result
 	}

package/src/calendar.js

@@ -10,7 +10,9 @@ function days_of(year, month, day) {
 		year += Math.floor(month / 12)
 		month = (month % 12 + 12) % 12
 	}
-	if (month < 2) year--
+	if (month < 2) {
+		year--
+	}
 	const era = Math.floor(year / 400)
 	const yoe = year - era * 400
 	return era * 146097

package/src/date_to_string.js

@@ -20,18 +20,26 @@ const tokens = {
  */
 function compile(format) {
 	let parts = formats.get(format)
-	if (parts) return parts
+	if (parts) {
+		return parts
+	}
 	parts = []
 	let last = 0
 	for (const { 0: token, index = 0 } of format.matchAll(token_regex)) {
-		if (index > last) parts.push(format.slice(last, index))
+		if (index > last) {
+			parts.push(format.slice(last, index))
+		}
 		parts.push(
 			/** @type {number[]} */(tokens[token])/**/
 		)
 		last = index + token.length
 	}
-	if (last < format.length) parts.push(format.slice(last))
-	if (formats.size >= 1000) formats.clear()
+	if (last < format.length) {
+		parts.push(format.slice(last))
+	}
+	if (formats.size >= 1000) {
+		formats.clear()
+	}
 	formats.set(format, parts)
 	return parts
 }
@@ -86,7 +94,9 @@ export default function(
 ) {
 	const time = time_of("dateToString", date)
 	check_zone("dateToString", zone)
-	if (isNaN(time)) return "Invalid Date"
+	if (isNaN(time)) {
+		return "Invalid Date"
+	}
 	const fields = fields_of(date, zone)
 	const parts = compile(format)
 	let result = ""
@@ -98,7 +108,7 @@ export default function(
 					/** @type {number} */(fields[0])/**/
 				)
 				: pad(
-				/** @type {number} */(fields[/** @type {number} */(part[0])/**/])/**/ + /** @type {number} */(part[2])/**/,
+					/** @type {number} */(fields[/** @type {number} */(part[0])/**/])/**/ + /** @type {number} */(part[2])/**/,
 					/** @type {number} */(part[1])/**/
 				)
 	}

package/src/diff.js

@@ -42,7 +42,9 @@ function anchor_after(
 		/** @type {number} */(from_fields[6])/**/
 	]
 	const distance = wall_of_fields(fields) - to_wall
-	if (Math.abs(distance) >= 172800000) return distance
+	if (Math.abs(distance) >= 172800000) {
+		return distance
+	}
 	const time = date_of(fields, zone).getTime()
 	return isNaN(time)
 		? distance
@@ -71,13 +73,19 @@ function anchor_after(
 export default function(from, to, unit, zone) {
 	const start = time_of("diff", from)
 	const end = time_of("diff", to)
-	if (!units_of.has(unit)) throw new RangeError(
-		`diff: Invalid unit "${String(unit)}"`
-	)
+	if (!units_of.has(unit)) {
+		throw new RangeError(
+			`diff: Invalid unit "${String(unit)}"`
+		)
+	}
 	check_zone("diff", zone)
-	if (isNaN(start) || isNaN(end)) return NaN
+	if (isNaN(start) || isNaN(end)) {
+		return NaN
+	}
 	const ms = unit_ms[unit]
-	if (ms) return Math.trunc((end - start) / ms) + 0
+	if (ms) {
+		return Math.trunc((end - start) / ms) + 0
+	}
 	const from_fields = fields_of(from, zone)
 	const to_fields = fields_of(to, zone)
 	if (unit == "D" || unit == "W") {
@@ -99,8 +107,11 @@ export default function(from, to, unit, zone) {
 	const to_day = /** @type {number} */(to_fields[2])/**/
 	const from_day = /** @type {number} */(from_fields[2])/**/
 	if (Math.abs(to_day - from_day) > 2 && to_day < 27 && from_day < 27) {
-		if (months > 0 && to_day < from_day) months--
-		else if (months < 0 && to_day > from_day) months++
+		if (months > 0 && to_day < from_day) {
+			months--
+		} else if (months < 0 && to_day > from_day) {
+			months++
+		}
 	} else {
 		const to_wall = wall_of_fields(to_fields)
 		if (end >= start) {
@@ -111,14 +122,18 @@ export default function(from, to, unit, zone) {
 				to_wall,
 				end,
 				zone
-			) > 0) months--
+			) > 0) {
+				months--
+			}
 			if (anchor_after(
 				from_fields,
 				months + 1,
 				to_wall,
 				end,
 				zone
-			) <= 0) months++
+			) <= 0) {
+				months++
+			}
 		} else {
 			months = Math.min(months, 0)
 			while (months && anchor_after(
@@ -127,14 +142,18 @@ export default function(from, to, unit, zone) {
 				to_wall,
 				end,
 				zone
-			) < 0) months++
+			) < 0) {
+				months++
+			}
 			if (anchor_after(
 				from_fields,
 				months - 1,
 				to_wall,
 				end,
 				zone
-			) >= 0) months--
+			) >= 0) {
+				months--
+			}
 		}
 	}
 	return unit == "Y"

package/src/end_of.js

@@ -40,11 +40,15 @@ const units_of = new Set(
  */
 export default function(date, unit, zone) {
 	const time = time_of("endOf", date)
-	if (!units_of.has(unit)) throw new RangeError(
-		`endOf: Invalid unit "${String(unit)}"`
-	)
+	if (!units_of.has(unit)) {
+		throw new RangeError(
+			`endOf: Invalid unit "${String(unit)}"`
+		)
+	}
 	check_zone("endOf", zone)
-	if (isNaN(time)) return new Date(NaN)
+	if (isNaN(time)) {
+		return new Date(NaN)
+	}
 	const ms = unit_ms[unit]
 	if (ms) {
 		if (zone !== undefined) {
@@ -66,8 +70,10 @@ export default function(date, unit, zone) {
 		const result = new Date(time + rest - 1)
 		if (
 			result.getTimezoneOffset() == date.getTimezoneOffset()
-			&& result.getSeconds() == (ms > 1000 ? 59 : date.getSeconds())
-		) return result
+				&& result.getSeconds() == (ms > 1000 ? 59 : date.getSeconds())
+		) {
+			return result
+		}
 		result.setTime(unit_end(time, ms))
 		return result
 	}
@@ -102,16 +108,23 @@ export default function(date, unit, zone) {
 	}
 	const offset = offset_in(time, zone)
 	const fields = fields_of_wall(time + offset)
-	if (unit == "W") fields[2] = /** @type {number} */(fields[2])/**/ + 7 - (/** @type {number} */(fields[7])/**/ + 6) % 7
-	else fields[from - 1] = /** @type {number} */(fields[from - 1])/**/ + 1
-	for (let i = from; i < 7; i++) fields[i] = i == 2 ? 1 : 0
+	if (unit == "W") {
+		fields[2] = /** @type {number} */(fields[2])/**/ + 7 - (/** @type {number} */(fields[7])/**/ + 6) % 7
+	} else {
+		fields[from - 1] = /** @type {number} */(fields[from - 1])/**/ + 1
+	}
+	for (let i = from; i < 7; i++) {
+		fields[i] = i == 2 ? 1 : 0
+	}
 	const wall = wall_of_fields(fields)
 	if (zone !== undefined) {
 		const next = offset_of(wall - offset, zone)
 		if (
 			next == offset
-			|| wall - next > time && offset_of(wall - next, zone) == next
-		) return new Date(wall - next - 1)
+				|| wall - next > time && offset_of(wall - next, zone) == next
+		) {
+			return new Date(wall - next - 1)
+		}
 		end = instant_of(wall, zone) - 1
 	}
 	return new Date(end_at(wall, end, time, zone))

package/src/start_of.js

@@ -36,11 +36,15 @@ const units_of = new Set(
  */
 export default function(date, unit, zone) {
 	const time = time_of("startOf", date)
-	if (!units_of.has(unit)) throw new RangeError(
-		`startOf: Invalid unit "${String(unit)}"`
-	)
+	if (!units_of.has(unit)) {
+		throw new RangeError(
+			`startOf: Invalid unit "${String(unit)}"`
+		)
+	}
 	check_zone("startOf", zone)
-	if (isNaN(time)) return new Date(NaN)
+	if (isNaN(time)) {
+		return new Date(NaN)
+	}
 	const ms = unit_ms[unit]
 	if (ms) {
 		if (zone !== undefined) {
@@ -60,8 +64,10 @@ export default function(date, unit, zone) {
 		const result = new Date(time - rest)
 		if (
 			result.getTimezoneOffset() == date.getTimezoneOffset()
-			&& result.getSeconds() == (ms > 1000 ? 0 : date.getSeconds())
-		) return result
+				&& result.getSeconds() == (ms > 1000 ? 0 : date.getSeconds())
+		) {
+			return result
+		}
 		result.setTime(unit_start(time, ms))
 		return result
 	}
@@ -84,15 +90,23 @@ export default function(date, unit, zone) {
 			0,
 			0
 		)
-		if (result.getTime() <= time && !(result.getHours() || result.getMinutes() || result.getSeconds())) return result
+		if (result.getTime() <= time && !(result.getHours() || result.getMinutes() || result.getSeconds())) {
+			return result
+		}
 	}
 	const fields = fields_of(date, zone)
-	if (unit == "W") fields[2] = /** @type {number} */(fields[2])/**/ - (/** @type {number} */(fields[7])/**/ + 6) % 7
-	for (let i = from; i < 7; i++) fields[i] = i == 2 ? 1 : 0
+	if (unit == "W") {
+		fields[2] = /** @type {number} */(fields[2])/**/ - (/** @type {number} */(fields[7])/**/ + 6) % 7
+	}
+	for (let i = from; i < 7; i++) {
+		fields[i] = i == 2 ? 1 : 0
+	}
 	const wall = wall_of_fields(fields)
 	if (zone !== undefined) {
 		const start = instant_of(wall, zone, true)
-		if (start <= time) return new Date(start)
+		if (start <= time) {
+			return new Date(start)
+		}
 	}
 	const before = offset_in(wall - 86400000, zone)
 	const guess = wall - before
@@ -100,10 +114,12 @@ export default function(date, unit, zone) {
 	const earliest = after == before
 		? wall - offset_in(time, zone)
 		: wall - after
-	if (!(earliest >= -8.64e15)) return new Date(NaN)
+	if (!(earliest >= -8.64e15)) {
+		return new Date(NaN)
+	}
 	return new Date(
 		transition_of(
-			earliest,
+			earliest - 1,
 			after == before || guess > time
 				? time
 				: guess,

package/src/string_to_date.js

@@ -22,22 +22,30 @@ const zone_regex = /(?<![a-z])(?:[cemp][ds]t|gmt|utc?|z)(?![a-z])|(?:\s|[ap]m|\d
  */
 function compile(format) {
 	let parts = formats.get(format)
-	if (parts) return parts
+	if (parts) {
+		return parts
+	}
 	parts = []
 	let last = 0
 	for (const { 0: token, index = 0 } of format.matchAll(token_regex)) {
-		if (index > last) parts.push(
-			[ ...format.slice(last, index) ].length
-		)
+		if (index > last) {
+			parts.push(
+				[ ...format.slice(last, index) ].length
+			)
+		}
 		parts.push(
 			/** @type {number[]} */(tokens[token])/**/
 		)
 		last = index + token.length
 	}
-	if (last < format.length) parts.push(
-		[ ...format.slice(last) ].length
-	)
-	if (formats.size >= 1000) formats.clear()
+	if (last < format.length) {
+		parts.push(
+			[ ...format.slice(last) ].length
+		)
+	}
+	if (formats.size >= 1000) {
+		formats.clear()
+	}
 	formats.set(format, parts)
 	return parts
 }
@@ -47,9 +55,14 @@ function compile(format) {
  */
 function out_of_range(match) {
 	const [ , year, month, day, hour, minute, second ] = match
-	if (month === undefined) return false
+	if (month === undefined) {
+		return false
+	}
 	const index = +month - 1
-	return index < 0 || index > 11 || day !== undefined && (+day < 1 || +day > last_day(+(year ?? 0), index)) || +(hour ?? 0) > (+(minute ?? 0) || +(second ?? 0) || +(match[7] ?? 0)
+	return index < 0 || index > 11 || day !== undefined && (+day < 1 || +day > last_day(
+		+/** @type {string} */(year)/**/,
+		index
+	)) || +(hour ?? 0) > (+(minute ?? 0) || +(second ?? 0) || +(match[7] ?? 0)
 		? 23
 		: 24) || +(minute ?? 0) > 59 || +(second ?? 0) > 59
 }
@@ -88,26 +101,39 @@ function out_of_range(match) {
  * @example stringToDate("2024-07-15 09:00", "YYYY-MM-DD HH:mm", "Asia/Seoul")
  */
 export default function(date, format, zone) {
-	if (typeof date != "string") throw new TypeError(
-		`stringToDate: Expected a string, got ${date === null ? "null" : typeof date}`
-	)
+	if (typeof date != "string") {
+		throw new TypeError(
+			`stringToDate: Expected a string, got ${date === null ? "null" : typeof date}`
+		)
+	}
 	check_zone("stringToDate", zone)
 	if (format === undefined) {
 		const native = new Date(date)
 		const valid = !isNaN(native.getTime())
-		if (!valid && zone === undefined) return native
+		if (!valid && zone === undefined) {
+			return native
+		}
 		const match = iso_regex.exec(date)
-		if (match && out_of_range(match)) return new Date(NaN)
+		if (match && out_of_range(match)) {
+			return new Date(NaN)
+		}
 		const parsed = match?.[8] === ""
 			? match
 			: null
 		if (parsed) {
-			if (zone === undefined && parsed[4] !== undefined) return native
-			if (!valid && isNaN(Date.parse(`${date}Z`))) return native
+			if (parsed[1] == "-000000") {
+				return new Date(NaN)
+			}
+			if (zone === undefined && parsed[4] !== undefined) {
+				return native
+			}
+			if (!valid && isNaN(Date.parse(`${date}Z`))) {
+				return native
+			}
 			const fraction = parsed[7]
 			return date_of(
 				[
-					+(parsed[1] ?? NaN),
+					+/** @type {string} */(parsed[1])/**/,
 					+(parsed[2] ?? 1) - 1,
 					+(parsed[3] ?? 1),
 					+(parsed[4] ?? 0),
@@ -120,11 +146,17 @@ export default function(date, format, zone) {
 				zone
 			)
 		}
-		if (zone === undefined) return native
+		if (zone === undefined) {
+			return native
+		}
 		const text = date.replace(comment_regex, "")
-		if (zone_regex.test(text)) return native
+		if (zone_regex.test(text)) {
+			return native
+		}
 		const wall = new Date(`${text} GMT`)
-		if (!valid && isNaN(wall.getTime())) return native
+		if (!valid && isNaN(wall.getTime())) {
+			return native
+		}
 		return date_of(
 			isNaN(wall.getTime())
 				? fields_of(native)
@@ -157,15 +189,23 @@ export default function(date, format, zone) {
 			length = 6
 			min = -271821
 		}
-		while (text.length < length && date.charCodeAt(index) > 47 && date.charCodeAt(index) < 58) text += date[index++]
-		if (!text || sign && (text.length < 6 || sign == "-" && !+text)) return new Date(NaN)
+		while (text.length < length && date.charCodeAt(index) > 47 && date.charCodeAt(index) < 58) {
+			text += date[index++]
+		}
+		if (!text || sign && (text.length < 6 || sign == "-" && !+text)) {
+			return new Date(NaN)
+		}
 		if (part[0] == 6) {
-			while (date.charCodeAt(index) > 47 && date.charCodeAt(index) < 58) index++
+			while (date.charCodeAt(index) > 47 && date.charCodeAt(index) < 58) {
+				index++
+			}
 		}
 		const value = part[0] == 6
 			? +text.padEnd(3, "0")
 			: +(sign + text)
-		if (value > /** @type {number} */(part[3])/**/ || value < min) return new Date(NaN)
+		if (value > /** @type {number} */(part[3])/**/ || value < min) {
+			return new Date(NaN)
+		}
 		fields[/** @type {number} */(part[0])/**/] = /** @type {number} */(part[0])/**/ == 1
 			? value - 1
 			: value
@@ -173,6 +213,8 @@ export default function(date, format, zone) {
 	if (index != date.length || /** @type {number} */(fields[2])/**/ > last_day(
 		/** @type {number} */(fields[0])/**/,
 		/** @type {number} */(fields[1])/**/
-	)) return new Date(NaN)
+	)) {
+		return new Date(NaN)
+	}
 	return date_of(fields, zone)
 }

package/src/zone.js

@@ -7,9 +7,12 @@ const formatters = new Map()
 /**
  * @param {string} name
  * @param {string=} zone
+ * @returns {void}
  */
 function check_zone(name, zone) {
-	if (zone === undefined || formatters.has(zone)) return
+	if (zone === undefined || formatters.has(zone)) {
+		return
+	}
 	try {
 		formatter_of(zone)
 	} catch (error) {
@@ -25,9 +28,11 @@ function check_zone(name, zone) {
  * @returns {Date}
  */
 function date_of(fields, zone) {
-	if (zone !== undefined) return new Date(
-		instant_of(wall_of_fields(fields), zone)
-	)
+	if (zone !== undefined) {
+		return new Date(
+			instant_of(wall_of_fields(fields), zone)
+		)
+	}
 	const year = /** @type {number} */(fields[0])/**/
 	if (year >= 0 && year < 100) {
 		const date = new Date(0)
@@ -58,10 +63,14 @@ function date_of(fields, zone) {
  * @returns {number}
  */
 function end_at(wall, end, time, zone) {
-	if (end < time) return wall - offset_in(time, zone) - 1
+	if (end < time) {
+		return wall - offset_in(time, zone) - 1
+	}
 	const next = end + 1
 	const offset = offset_in(next, zone)
-	if (next + offset == wall || offset_in(end, zone) != offset) return end
+	if (next + offset == wall || offset_in(end, zone) != offset) {
+		return end
+	}
 	const transition = transition_of(time, next, zone)
 	return transition + offset_in(transition, zone) >= wall
 		? transition - 1
@@ -73,16 +82,18 @@ function end_at(wall, end, time, zone) {
  * @returns {number[]}
  */
 function fields_of(date, zone) {
-	if (zone === undefined) return [
-		date.getFullYear(),
-		date.getMonth(),
-		date.getDate(),
-		date.getHours(),
-		date.getMinutes(),
-		date.getSeconds(),
-		date.getMilliseconds(),
-		date.getDay()
-	]
+	if (zone === undefined) {
+		return [
+			date.getFullYear(),
+			date.getMonth(),
+			date.getDate(),
+			date.getHours(),
+			date.getMinutes(),
+			date.getSeconds(),
+			date.getMilliseconds(),
+			date.getDay()
+		]
+	}
 	const time = date.getTime()
 	return fields_of_wall(time + offset_of(time, zone))
 }
@@ -92,7 +103,9 @@ function fields_of(date, zone) {
  */
 function formatter_of(zone) {
 	let formatter = formatters.get(zone)
-	if (formatter) return formatter
+	if (formatter) {
+		return formatter
+	}
 	formatter = new Intl.DateTimeFormat(
 		"en-US",
 		{
@@ -105,10 +118,14 @@ function formatter_of(zone) {
 	if (known) {
 		formatter = known
 	} else {
-		if (canonical.size >= 1000) canonical.clear()
+		if (canonical.size >= 1000) {
+			canonical.clear()
+		}
 		canonical.set(name, formatter)
 	}
-	if (formatters.size >= 1000) formatters.clear()
+	if (formatters.size >= 1000) {
+		formatters.clear()
+	}
 	formatters.set(zone, formatter)
 	return formatter
 }
@@ -122,7 +139,9 @@ function instant_of(wall, zone, exact) {
 	const before = offset_of(wall - 86400000, zone)
 	const guess = wall - before
 	const offset = offset_of(guess, zone)
-	if (offset == before) return guess
+	if (offset == before) {
+		return guess
+	}
 	const candidate = wall - offset
 	return offset_of(candidate, zone) == offset
 		? candidate
@@ -155,10 +174,12 @@ function offset_of(time, zone) {
 					: 8.64e15
 		)
 	)
-	if (!match) return 0
+	if (!match) {
+		return 0
+	}
 	return (match[1] == "-" ? -1 : 1) * (
-		(+(match[2] ?? 0) * 60 + +(match[3] ?? 0)) * 60000
-		+ +(match[4] ?? 0) * 1000
+		(+/** @type {string} */(match[2])/**/ * 60 + +/** @type {string} */(match[3])/**/) * 60000
+			+ +(match[4] ?? 0) * 1000
 	)
 }
 /**
@@ -171,8 +192,11 @@ function transition_of(from, to, zone) {
 	const offset = offset_in(to, zone)
 	while (to - from > 1) {
 		const middle = Math.floor((from + to) / 2)
-		if (offset_in(middle, zone) == offset) to = middle
-		else from = middle
+		if (offset_in(middle, zone) == offset) {
+			to = middle
+		} else {
+			from = middle
+		}
 	}
 	return to
 }
@@ -190,11 +214,17 @@ function unit_end(time, ms, zone) {
 	for (;;) {
 		const offset = offset_in(at, zone)
 		const end = (bucket + 1) * ms - offset - 1
-		if (!(end <= 8.64e15)) return NaN
-		if (offset_in(end, zone) == offset) return end
+		if (!(end <= 8.64e15)) {
+			return NaN
+		}
+		if (offset_in(end, zone) == offset) {
+			return end
+		}
 		const transition = transition_of(at, end, zone)
 		const wall = transition + offset_in(transition, zone)
-		if (Math.floor(wall / ms) != bucket || wall <= transition - 1 + offset) return transition - 1
+		if (Math.floor(wall / ms) != bucket || wall <= transition - 1 + offset) {
+			return transition - 1
+		}
 		at = transition
 	}
 }
@@ -212,12 +242,18 @@ function unit_start(time, ms, zone) {
 	for (;;) {
 		const offset = offset_in(at, zone)
 		const start = bucket * ms - offset
-		if (!(start >= -8.64e15)) return NaN
-		if (offset_in(start, zone) == offset) return start
+		if (!(start >= -8.64e15)) {
+			return NaN
+		}
+		if (offset_in(start, zone) == offset) {
+			return start
+		}
 		const transition = transition_of(start, at, zone)
 		const before = transition - 1
 		const wall = before + offset_in(before, zone)
-		if (Math.floor(wall / ms) != bucket || wall >= transition + offset) return transition
+		if (Math.floor(wall / ms) != bucket || wall >= transition + offset) {
+			return transition
+		}
 		at = before
 	}
 }

package/types/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../src/add.js"],"names":[],"mappings":"AAqEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAzBjB,IAyBiB,EAAE,GAAG,EAxBtB,MAwBsB,EAAE,IAAI,AAVpC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUH,GAT1B,IAAI,CAuDhB"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../src/add.js"],"names":[],"mappings":"AAgFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAzBjB,IAyBiB,EAAE,GAAG,EAxBtB,MAwBsB,EAAE,IAAI,AAVpC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUH,GAT1B,IAAI,CA6DhB"}

package/types/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.js"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,iBAAS,OAAO,CAAC,IAAI,EALV,MAKU,EAAE,KAAK,EAJjB,MAIiB,EAAE,GAAG,EAHtB,MAGsB,GAFpB,MAAM,CAmBlB;AACD;;;GAGG;AACH,iBAAS,cAAc,CAAC,IAAI,EAHjB,MAGiB,GAFf,MAAM,EAAE,CA6BpB;AACD;;;;GAIG;AACH,iBAAS,QAAQ,CAAC,IAAI,EAJX,MAIW,EAAE,KAAK,EAHlB,MAGkB,GAFhB,MAAM,CAMlB;AACD;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAHnB,MAAM,EAGa,GAFjB,MAAM,CAYlB;AACD,OAAO,EACN,OAAO,EACP,cAAc,EACd,QAAQ,EACR,cAAc,EACd,CAAA"}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.js"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,iBAAS,OAAO,CAAC,IAAI,EALV,MAKU,EAAE,KAAK,EAJjB,MAIiB,EAAE,GAAG,EAHtB,MAGsB,GAFpB,MAAM,CAqBlB;AACD;;;GAGG;AACH,iBAAS,cAAc,CAAC,IAAI,EAHjB,MAGiB,GAFf,MAAM,EAAE,CA6BpB;AACD;;;;GAIG;AACH,iBAAS,QAAQ,CAAC,IAAI,EAJX,MAIW,EAAE,KAAK,EAHlB,MAGkB,GAFhB,MAAM,CAMlB;AACD;;;GAGG;AACH,iBAAS,cAAc,CAAC,MAAM,EAHnB,MAAM,EAGa,GAFjB,MAAM,CAYlB;AACD,OAAO,EACN,OAAO,EACP,cAAc,EACd,QAAQ,EACR,cAAc,EACd,CAAA"}

package/types/date_to_string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date_to_string.d.ts","sourceRoot":"","sources":["../src/date_to_string.js"],"names":[],"mappings":"AAsDA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,OAAO,WACb,IAAI,EAxBM,IAwBN,EACJ,MAAM,AAxBJ,CAaA,EAbQ,MAAM,YAwBkB,EAClC,IAAI,AAZF,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAYrC,GAXQ,MAAM,CAgClB"}
+{"version":3,"file":"date_to_string.d.ts","sourceRoot":"","sources":["../src/date_to_string.js"],"names":[],"mappings":"AA8DA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,OAAO,WACb,IAAI,EAxBM,IAwBN,EACJ,MAAM,AAxBJ,CAaA,EAbQ,MAAM,YAwBkB,EAClC,IAAI,AAZF,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAYrC,GAXQ,MAAM,CAkClB"}

package/types/diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.js"],"names":[],"mappings":"AAkDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAhBjB,IAgBiB,EAAE,EAAE,EAfrB,IAeqB,EAAE,IAAI,EAd3B,OAAO,cAAc,EAAE,IAcI,EAAE,IAAI,AAVzC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUE,GAT/B,MAAM,CAiFlB"}
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.js"],"names":[],"mappings":"AAoDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAhBjB,IAgBiB,EAAE,EAAE,EAfrB,IAeqB,EAAE,IAAI,EAd3B,OAAO,cAAc,EAAE,IAcI,EAAE,IAAI,AAVzC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUE,GAT/B,MAAM,CAkGlB"}

package/types/end_of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"end_of.d.ts","sourceRoot":"","sources":["../src/end_of.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAfjB,IAeiB,EAAE,IAAI,EAdvB,OAAO,CAAC,OAAO,cAAc,EAAE,IAAI,EAAE,KAAK,CAcnB,EAAE,IAAI,AAVrC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUF,GAT3B,IAAI,CAsFhB"}
+{"version":3,"file":"end_of.d.ts","sourceRoot":"","sources":["../src/end_of.js"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAfjB,IAeiB,EAAE,IAAI,EAdvB,OAAO,CAAC,OAAO,cAAc,EAAE,IAAI,EAAE,KAAK,CAcnB,EAAE,IAAI,AAVrC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUF,GAT3B,IAAI,CAmGhB"}

package/types/start_of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start_of.d.ts","sourceRoot":"","sources":["../src/start_of.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAfjB,IAeiB,EAAE,IAAI,EAdvB,OAAO,CAAC,OAAO,cAAc,EAAE,IAAI,EAAE,KAAK,CAcnB,EAAE,IAAI,AAVrC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUF,GAT3B,IAAI,CAqFhB"}
+{"version":3,"file":"start_of.d.ts","sourceRoot":"","sources":["../src/start_of.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAfjB,IAeiB,EAAE,IAAI,EAdvB,OAAO,CAAC,OAAO,cAAc,EAAE,IAAI,EAAE,KAAK,CAcnB,EAAE,IAAI,AAVrC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YAUF,GAT3B,IAAI,CAqGhB"}

package/types/string_to_date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string_to_date.d.ts","sourceRoot":"","sources":["../src/string_to_date.js"],"names":[],"mappings":"AAuDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAvBjB,MAuBiB,EAAE,MAAM,AAtBjC,CAaA,EAbQ,MAAM,YAsBmB,EAAE,IAAI,AATvC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YASA,GAR7B,IAAI,CAgGhB"}
+{"version":3,"file":"string_to_date.d.ts","sourceRoot":"","sources":["../src/string_to_date.js"],"names":[],"mappings":"AAoEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,OAAO,WAAU,IAAI,EAvBjB,MAuBiB,EAAE,MAAM,AAtBjC,CAaA,EAbQ,MAAM,YAsBmB,EAAE,IAAI,AATvC,CACA,EADQ,OAAO,cAAc,EAAE,QAAQ,YASA,GAR7B,IAAI,CA6HhB"}

package/types/zone.d.ts

@@ -1,6 +1,7 @@
 /**
  * @param {string} name
  * @param {string=} zone
+ * @returns {void}
  */
 declare function check_zone(name: string, zone?: string | undefined): void;
 /**

package/types/zone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../src/zone.js"],"names":[],"mappings":"AAMA;;;GAGG;AACH,iBAAS,UAAU,CAAC,IAAI,EAHb,MAGa,EAAE,IAAI,AAF3B,CACF,EADU,MAAM,YAEa,QAU7B;AACD;;;;GAIG;AACH,iBAAS,OAAO,CAAC,MAAM,EAJZ,MAAM,EAIM,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,IAAI,CA2BhB;AACD;;;;;;GAMG;AACH,iBAAS,MAAM,CAAC,IAAI,EANT,MAMS,EAAE,GAAG,EALd,MAKc,EAAE,IAAI,EAJpB,MAIoB,EAAE,IAAI,AAHlC,CACA,EADQ,MAAM,YAGoB,GAFxB,MAAM,CAWlB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,IAIY,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,MAAM,EAAE,CAepB;AA2BD;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,IAAI,EALb,MAKa,EAAE,IAAI,EAJnB,MAImB,EAAE,KAAK,AAHlC,CACA,EADQ,OAAO,YAGmB,GAFxB,MAAM,CAalB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,MAIY,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,MAAM,CAMlB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,MAIY,EAAE,IAAI,EAHlB,MAGkB,GAFhB,MAAM,CAiBlB;AACD;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,IAAI,EALhB,MAKgB,EAAE,EAAE,EAJpB,MAIoB,EAAE,IAAI,AAHlC,CACA,EADQ,MAAM,YAGoB,GAFxB,MAAM,CAUlB;AACD;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,IAAI,EALX,MAKW,EAAE,EAAE,EAJf,MAIe,EAAE,IAAI,AAH7B,CACA,EADQ,MAAM,YAGe,GAFnB,MAAM,CAiBlB;AACD;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,IAAI,EALb,MAKa,EAAE,EAAE,EAJjB,MAIiB,EAAE,IAAI,AAH/B,CACA,EADQ,MAAM,YAGiB,GAFrB,MAAM,CAkBlB;AACD,OAAO,EACN,UAAU,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,QAAQ,EACR,UAAU,EACV,CAAA"}
+{"version":3,"file":"zone.d.ts","sourceRoot":"","sources":["../src/zone.js"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,iBAAS,UAAU,CAAC,IAAI,EAJb,MAIa,EAAE,IAAI,AAH3B,CACA,EADQ,MAAM,YAGa,GAFjB,IAAI,CAchB;AACD;;;;GAIG;AACH,iBAAS,OAAO,CAAC,MAAM,EAJZ,MAAM,EAIM,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,IAAI,CA6BhB;AACD;;;;;;GAMG;AACH,iBAAS,MAAM,CAAC,IAAI,EANT,MAMS,EAAE,GAAG,EALd,MAKc,EAAE,IAAI,EAJpB,MAIoB,EAAE,IAAI,AAHlC,CACA,EADQ,MAAM,YAGoB,GAFxB,MAAM,CAelB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,IAIY,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,MAAM,EAAE,CAiBpB;AAiCD;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,IAAI,EALb,MAKa,EAAE,IAAI,EAJnB,MAImB,EAAE,KAAK,AAHlC,CACA,EADQ,OAAO,YAGmB,GAFxB,MAAM,CAelB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,MAIY,EAAE,IAAI,AAH1B,CACA,EADQ,MAAM,YAGY,GAFhB,MAAM,CAMlB;AACD;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAJZ,MAIY,EAAE,IAAI,EAHlB,MAGkB,GAFhB,MAAM,CAmBlB;AACD;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,IAAI,EALhB,MAKgB,EAAE,EAAE,EAJpB,MAIoB,EAAE,IAAI,AAHlC,CACA,EADQ,MAAM,YAGoB,GAFxB,MAAM,CAalB;AACD;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,IAAI,EALX,MAKW,EAAE,EAAE,EAJf,MAIe,EAAE,IAAI,AAH7B,CACA,EADQ,MAAM,YAGe,GAFnB,MAAM,CAuBlB;AACD;;;;;GAKG;AACH,iBAAS,UAAU,CAAC,IAAI,EALb,MAKa,EAAE,EAAE,EAJjB,MAIiB,EAAE,IAAI,AAH/B,CACA,EADQ,MAAM,YAGiB,GAFrB,MAAM,CAwBlB;AACD,OAAO,EACN,UAAU,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,QAAQ,EACR,UAAU,EACV,CAAA"}