date-vir 8.6.4 → 9.1.0

package/dist/extra-utils/override-date.d.ts

@@ -1,4 +1,5 @@
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Override the initial provided FullDate with all subsequent FullDate parts.
  *
@@ -6,7 +7,7 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  * @example
  *
  * ```ts
- * import {overrideDateParts, type FullDate} from 'date-vir';
+ * import {overrideDateParts, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -16,11 +17,11 @@ import { type FullDate } from '../full-date/full-date-shape.js';
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * overrideDateParts(exampleDate, {day: 20}, {second: 10});
- * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
-export declare function overrideDateParts<const SpecificTimezone extends string>(date: FullDate<SpecificTimezone>, ...overrides: Partial<FullDate<SpecificTimezone>>[]): FullDate<SpecificTimezone>;
+export declare function overrideDateParts<const SpecificTimezone extends Timezone>(date: FullDate<SpecificTimezone>, ...overrides: Partial<FullDate<SpecificTimezone>>[]): FullDate<SpecificTimezone>;

package/dist/extra-utils/override-date.js

@@ -5,7 +5,7 @@
  * @example
  *
  * ```ts
- * import {overrideDateParts, type FullDate} from 'date-vir';
+ * import {overrideDateParts, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -15,11 +15,11 @@
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * overrideDateParts(exampleDate, {day: 20}, {second: 10});
- * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 20, hour: 1, minute: 1, second: 10, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
 export function overrideDateParts(date, ...overrides) {

package/dist/extra-utils/zero.d.ts

@@ -1,5 +1,6 @@
 import { TimeKey } from '../full-date/full-date-parts.js';
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * A {@link FullDate} instance that has the lowest, valid, non-negative, value for each property.
  *
@@ -50,7 +51,7 @@ export declare const zeroTime: Pick<{
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -60,14 +61,14 @@ export declare const zeroTime: Pick<{
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearTime(exampleDate);
- * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: utcTimezone}`
  * ```
  */
-export declare function clearTime<const SpecificTimezone extends string>(inputFullDate: Readonly<FullDate<SpecificTimezone>>): FullDate<SpecificTimezone>;
+export declare function clearTime<const SpecificTimezone extends Timezone>(inputFullDate: Readonly<FullDate<SpecificTimezone>>): FullDate<SpecificTimezone>;
 /**
  * Clear all the selected parts of {@link FullDate} by setting them each to their lowest, valid
  * value. See {@link zeroDate} for the lowest valid values for each property.
@@ -76,7 +77,7 @@ export declare function clearTime<const SpecificTimezone extends string>(inputFu
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -86,17 +87,17 @@ export declare function clearTime<const SpecificTimezone extends string>(inputFu
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearParts(exampleDate, [
  *     'year',
  *     'day',
  * ]);
- * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
-export declare function clearParts<const SpecificTimezone extends string>(inputFullDate: Readonly<FullDate<SpecificTimezone>>, parts: ReadonlyArray<Exclude<keyof FullDate, 'timezone'>>): {
+export declare function clearParts<const SpecificTimezone extends Timezone>(inputFullDate: Readonly<FullDate<SpecificTimezone>>, parts: ReadonlyArray<Exclude<keyof FullDate, 'timezone'>>): {
     year: number;
     month: import("@date-vir/duration").MonthNumber;
     day: import("@date-vir/duration").DayOfMonth;

package/dist/extra-utils/zero.js

@@ -35,7 +35,7 @@ export const zeroTime = pickObjectKeys(zeroDate, getEnumValues(TimeKey));
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -45,11 +45,11 @@ export const zeroTime = pickObjectKeys(zeroDate, getEnumValues(TimeKey));
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearTime(exampleDate);
- * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: 'UTC'}`
+ * // `{year: 2024, month: 1, day: 5, hour: 0, minute: 0, second: 0, millisecond: 0, timezone: utcTimezone}`
  * ```
  */
 export function clearTime(inputFullDate) {
@@ -63,7 +63,7 @@ export function clearTime(inputFullDate) {
  * @example
  *
  * ```ts
- * import {clearTime, type FullDate} from 'date-vir';
+ * import {clearTime, type FullDate, utcTimezone} from 'date-vir';
  *
  * const exampleDate: Readonly<FullDate> = {
  *     year: 2024,
@@ -73,14 +73,14 @@ export function clearTime(inputFullDate) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * clearParts(exampleDate, [
  *     'year',
  *     'day',
  * ]);
- * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: 'UTC'}`
+ * // `{year: 0, month: 1, day: 1, hour: 1, minute: 1, second: 1, millisecond: 1, timezone: utcTimezone}`
  * ```
  */
 export function clearParts(inputFullDate, parts) {

package/dist/formatting/simple-strings.d.ts

@@ -1,5 +1,6 @@
 import { type SetOptionalAndNullable } from '@augment-vir/common';
 import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 import { type JustDateString, type JustTimeString, type JustTimeWithSecondsString } from './string-format-types.js';
 /**
  * Create a string based on just the date parts of a FullDate.
@@ -57,7 +58,7 @@ export type FullDateForParts = SetOptionalAndNullable<FullDate, 'millisecond'>;
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */
@@ -66,7 +67,7 @@ export declare function toDatePartStrings(fullDate: FullDateForParts, options: {
 }): {
     date: JustDateString;
     time: JustTimeWithSecondsString;
-    timezone: string;
+    timezone: Timezone;
 };
 /**
  * Splits a FullDate up into multiple formatted string representations.
@@ -98,7 +99,7 @@ export declare function toDatePartStrings(fullDate: FullDateForParts, options: {
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */
@@ -107,7 +108,7 @@ export declare function toDatePartStrings(fullDate: SetOptionalAndNullable<FullD
 }): {
     date: JustDateString;
     time: JustTimeString;
-    timezone: string;
+    timezone: Timezone;
 };
 /**
  * Splits a FullDate up into multiple formatted string representations.
@@ -139,7 +140,7 @@ export declare function toDatePartStrings(fullDate: SetOptionalAndNullable<FullD
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */
@@ -148,7 +149,7 @@ export declare function toDatePartStrings(fullDate: FullDateForParts, options: {
 }): {
     date: JustDateString;
     time: JustTimeWithSecondsString | JustTimeString;
-    timezone: string;
+    timezone: Timezone;
 };
 /**
  * Converts a date into a simple, unambiguous date string.

package/dist/formatting/simple-strings.js

@@ -67,7 +67,7 @@ export function toSimpleTimePartString(fullDate, includeSeconds) {
  * result = {
  *     date: '2024-04-24',
  *     time: '06:04:09',
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  * ```
  */

package/dist/formatting/timestamp.d.ts

@@ -8,7 +8,7 @@ import { type HttpDateString, type UtcIsoString } from './string-format-types.js
  * @example
  *
  * ```ts
- * import {toTimestamp} from 'date-vir';
+ * import {toTimestamp, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -18,7 +18,7 @@ import { type HttpDateString, type UtcIsoString } from './string-format-types.js
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toTimestamp(exampleDate); // `1704416461001`
@@ -37,7 +37,7 @@ export declare function toTimestamp(fullDate: FullDate): number;
  * @example
  *
  * ```ts
- * import {toUtcIsoString} from 'date-vir';
+ * import {toUtcIsoString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -47,7 +47,7 @@ export declare function toTimestamp(fullDate: FullDate): number;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toUtcIsoString(exampleDate); // `'2024-01-05T01:01:01.001Z'`
@@ -93,7 +93,7 @@ dateLike: Readonly<DateLike>): UtcIsoString;
  * @example
  *
  * ```ts
- * import {toHttpDateString} from 'date-vir';
+ * import {toHttpDateString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -103,7 +103,7 @@ dateLike: Readonly<DateLike>): UtcIsoString;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toHttpDateString(exampleDate); // `'Fri, 05 Jan 2024 01:01:01 GMT'`

package/dist/formatting/timestamp.js

@@ -8,7 +8,7 @@ import { utcTimezone } from '../timezone/timezones.js';
  * @example
  *
  * ```ts
- * import {toTimestamp} from 'date-vir';
+ * import {toTimestamp, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -18,7 +18,7 @@ import { utcTimezone } from '../timezone/timezones.js';
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toTimestamp(exampleDate); // `1704416461001`
@@ -39,7 +39,7 @@ export function toTimestamp(fullDate) {
  * @example
  *
  * ```ts
- * import {toUtcIsoString} from 'date-vir';
+ * import {toUtcIsoString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -49,7 +49,7 @@ export function toTimestamp(fullDate) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toUtcIsoString(exampleDate); // `'2024-01-05T01:01:01.001Z'`
@@ -105,7 +105,7 @@ dateLike) {
  * @example
  *
  * ```ts
- * import {toHttpDateString} from 'date-vir';
+ * import {toHttpDateString, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -115,7 +115,7 @@ dateLike) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
  * toHttpDateString(exampleDate); // `'Fri, 05 Jan 2024 01:01:01 GMT'`

package/dist/full-date/create-full-date.d.ts

@@ -1,4 +1,4 @@
-import { type UtcTimezone } from '../timezone/timezones.js';
+import { type Timezone, type UtcTimezone } from '../timezone/timezones.js';
 import { type DateLike } from './date-like.js';
 import { type FullDate } from './full-date-shape.js';
 /**
@@ -45,16 +45,16 @@ export declare function createUtcFullDate(dateLike: Readonly<DateLike>): FullDat
  * @example
  *
  * ```ts
- * import {createFullDate, timezones, utcTimezone} from 'date-vir';
+ * import {createFullDate, TimezoneName, utcTimezone} from 'date-vir';
  *
  * createFullDate('June 1, 2024', utcTimezone);
- * createFullDate(new Date(), timezones['Australia/Brisbane']);
- * createFullDate(112300120, timezones['Etc/GMT-11']);
+ * createFullDate(new Date(), TimezoneName['Australia/Brisbane']);
+ * createFullDate(112300120, TimezoneName['Etc/GMT-11']);
  * ```
  *
  * @throws Error: if a valid date cannot be created.
  */
-export declare function createFullDate<const SpecificTimezone extends string>(
+export declare function createFullDate<const SpecificTimezone extends Timezone>(
 /** The original date representation to be converted into a FullDate. */
 dateLike: Readonly<DateLike>, 
 /** The timezone that this date/time is meant for / originated from. */
@@ -67,7 +67,7 @@ timezone: SpecificTimezone): FullDate<SpecificTimezone>;
  * @example
  *
  * ```ts
- * import {toNewTimezone} from 'date-vir';
+ * import {toNewTimezone, TimezoneName, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -77,10 +77,10 @@ timezone: SpecificTimezone): FullDate<SpecificTimezone>;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
- * let result = toNewTimezone(exampleDate, timezones['Australia/Brisbane']);
+ * let result = toNewTimezone(exampleDate, TimezoneName['Australia/Brisbane']);
  * // output:
  * result = {
  *     year: 2024,
@@ -90,8 +90,8 @@ timezone: SpecificTimezone): FullDate<SpecificTimezone>;
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: timezones['Australia/Brisbane'],
+ *     timezone: TimezoneName['Australia/Brisbane'],
  * };
  * ```
  */
-export declare function toNewTimezone<const SpecificTimezone extends string>(fullDate: Readonly<FullDate>, timezone: SpecificTimezone): FullDate<SpecificTimezone>;
+export declare function toNewTimezone<const SpecificTimezone extends Timezone>(fullDate: Readonly<FullDate>, timezone: SpecificTimezone): FullDate<SpecificTimezone>;

package/dist/full-date/create-full-date.js

@@ -53,11 +53,11 @@ export function createUtcFullDate(dateLike) {
  * @example
  *
  * ```ts
- * import {createFullDate, timezones, utcTimezone} from 'date-vir';
+ * import {createFullDate, TimezoneName, utcTimezone} from 'date-vir';
  *
  * createFullDate('June 1, 2024', utcTimezone);
- * createFullDate(new Date(), timezones['Australia/Brisbane']);
- * createFullDate(112300120, timezones['Etc/GMT-11']);
+ * createFullDate(new Date(), TimezoneName['Australia/Brisbane']);
+ * createFullDate(112300120, TimezoneName['Etc/GMT-11']);
  * ```
  *
  * @throws Error: if a valid date cannot be created.
@@ -81,7 +81,7 @@ timezone) {
  * @example
  *
  * ```ts
- * import {toNewTimezone} from 'date-vir';
+ * import {toNewTimezone, TimezoneName, utcTimezone} from 'date-vir';
  *
  * const exampleDate: FullDate = {
  *     year: 2024,
@@ -91,10 +91,10 @@ timezone) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: 'UTC',
+ *     timezone: utcTimezone,
  * };
  *
- * let result = toNewTimezone(exampleDate, timezones['Australia/Brisbane']);
+ * let result = toNewTimezone(exampleDate, TimezoneName['Australia/Brisbane']);
  * // output:
  * result = {
  *     year: 2024,
@@ -104,7 +104,7 @@ timezone) {
  *     minute: 1,
  *     second: 1,
  *     millisecond: 1,
- *     timezone: timezones['Australia/Brisbane'],
+ *     timezone: TimezoneName['Australia/Brisbane'],
  * };
  * ```
  */

package/dist/full-date/date-like.d.ts

@@ -1,8 +1,9 @@
 import { type DateTime } from 'luxon';
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Types that can be converted into {@link FullDate} instances.
  *
  * @category Internal
  */
-export type DateLike<SpecificTimezone extends string = string> = string | Date | number | DateTime | FullDate<SpecificTimezone>;
+export type DateLike<SpecificTimezone extends Timezone = Timezone> = string | Date | number | DateTime | FullDate<SpecificTimezone>;

package/dist/full-date/full-date-shape.d.ts

@@ -1,6 +1,7 @@
 import { type Overwrite, type SetRequired } from '@augment-vir/common';
 import { type DayOfMonth, type Hour, type Minute, type MonthNumber, type Second } from '@date-vir/duration';
 import { type Simplify } from 'type-fest';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Time part of {@link FullDate} represented in a shape definition.
  *
@@ -16,14 +17,14 @@ export declare const timePartShape: import("object-shape-tester").Shape<{
     /** Millisecond of the second: 0-999 */
     millisecond: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<number>>;
     /** The timezone that this date/time is meant for / originated from. */
-    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<string>>;
+    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<Timezone>>;
 }>;
 /**
  * Time part of a {@link FullDate}.
  *
  * @category Internal
  */
-export type TimePart<SpecificTimezone extends string = string> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof timePartShape)['runtimeType']>;
+export type TimePart<SpecificTimezone extends Timezone = Timezone> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof timePartShape)['runtimeType']>;
 /**
  * Date part of {@link FullDate} represented in a shape definition.
  *
@@ -41,14 +42,14 @@ export declare const datePartShape: import("object-shape-tester").Shape<{
     /** A day of the month: 1-31 depending on the month */
     day: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<DayOfMonth>>;
     /** The timezone that this date/time is meant for / originated from. */
-    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<string>>;
+    timezone: import("object-shape-tester").Shape<import("@sinclair/typebox").TUnsafe<Timezone>>;
 }>;
 /**
  * Date part of {@link FullDate}.
  *
  * @category Internal
  */
-export type DatePart<SpecificTimezone extends string = string> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof datePartShape)['runtimeType']>;
+export type DatePart<SpecificTimezone extends Timezone = Timezone> = SetRequired<Partial<FullDate<SpecificTimezone>>, keyof (typeof datePartShape)['runtimeType']>;
 /**
  * The complete {@link FullDate} represented in a shape definition.
  *
@@ -59,12 +60,12 @@ export declare const fullDateShape: import("object-shape-tester").Shape<import("
     minute: Minute;
     second: Minute;
     millisecond: number;
-    timezone: string;
+    timezone: Timezone;
 } & {
     year: number;
     month: MonthNumber;
     day: DayOfMonth;
-    timezone: string;
+    timezone: Timezone;
 }>>>;
 /**
  * A serializable object that completely specifies how any given date should be represented,
@@ -75,7 +76,7 @@ export declare const fullDateShape: import("object-shape-tester").Shape<import("
  * @example
  *
  * ```ts
- * import {FullDate, timezones} from 'date-vir';
+ * import {FullDate, TimezoneName} from 'date-vir';
  *
  * const myDate: FullDate = {
  *     year: 2024,
@@ -87,11 +88,11 @@ export declare const fullDateShape: import("object-shape-tester").Shape<import("
  *     second: 12,
  *
  *     milliseconds: 94,
- *     timezone: timezones['Australia/Brisbane'],
+ *     timezone: TimezoneName['Australia/Brisbane'],
  * };
  * ```
  */
-export type FullDate<SpecificTimezone extends string = string> = Simplify<Overwrite<(typeof fullDateShape)['runtimeType'], {
+export type FullDate<SpecificTimezone extends Timezone = Timezone> = Simplify<Overwrite<(typeof fullDateShape)['runtimeType'], {
     second: Second;
     timezone: SpecificTimezone;
 }>>;

package/dist/full-date/is-valid-full-date.d.ts

@@ -1,3 +1,4 @@
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Asserts that the input is a valid {@link FullDate}.
@@ -17,4 +18,4 @@ export declare function isValidFullDate(input: unknown): input is FullDate;
  *
  * @category Assertion
  */
-export declare function hasTimezone<const SpecificTimezone extends string>(input: FullDate, timezone: SpecificTimezone): input is FullDate<SpecificTimezone>;
+export declare function hasTimezone<const SpecificTimezone extends Timezone>(input: FullDate, timezone: SpecificTimezone): input is FullDate<SpecificTimezone>;

package/dist/full-date/luxon-date-time-conversion.d.ts

@@ -1,4 +1,5 @@
 import { DateTime } from 'luxon';
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Converts a {@link FullDate} object into a Luxon DateTime library. This is only needed if you need
@@ -15,4 +16,4 @@ export declare function toLuxonDateTime(fullDateInput: Readonly<FullDate>): Date
  *
  * @category Internal
  */
-export declare function parseLuxonDateTime<const SpecificTimezone extends string>(dateTimeInput: Readonly<DateTime>, forcedTimezone?: SpecificTimezone): FullDate<SpecificTimezone>;
+export declare function parseLuxonDateTime<const SpecificTimezone extends Timezone>(dateTimeInput: Readonly<DateTime>, forcedTimezone?: SpecificTimezone): FullDate<SpecificTimezone>;

package/dist/full-date/luxon-date-time-conversion.js

@@ -1,4 +1,4 @@
-import { omitObjectKeys } from '@augment-vir/common';
+import { applyBrand, omitObjectKeys } from '@augment-vir/common';
 import { assertWrapDayOfMonth, assertWrapHour, assertWrapMillisecond, assertWrapMinute, assertWrapMonthNumber, assertWrapSecond, } from '@date-vir/duration';
 import { DateTime } from 'luxon';
 /**
@@ -30,6 +30,11 @@ export function parseLuxonDateTime(dateTimeInput, forcedTimezone) {
     if (!dateTimeInput.isValid) {
         throw new Error(`Invalid input: '${dateTimeInput.toISO()}'`);
     }
+    const zoneName = dateTimeInput.zoneName;
+    if (zoneName == undefined) {
+        throw new Error('Valid Luxon dates must have a timezone.');
+    }
+    const brandedZoneName = applyBrand(zoneName);
     return {
         day: assertWrapDayOfMonth(dateTimeInput.day),
         month: assertWrapMonthNumber(dateTimeInput.month),
@@ -38,6 +43,6 @@ export function parseLuxonDateTime(dateTimeInput, forcedTimezone) {
         minute: assertWrapMinute(dateTimeInput.minute),
         second: assertWrapSecond(dateTimeInput.second),
         millisecond: assertWrapMillisecond(dateTimeInput.millisecond),
-        timezone: forcedTimezone ?? dateTimeInput.zoneName,
+        timezone: forcedTimezone ?? brandedZoneName,
     };
 }

package/dist/full-date/maybe-create-date.d.ts

@@ -1,3 +1,4 @@
+import { type Timezone } from '../timezone/timezones.js';
 import { type DateLike } from './date-like.js';
 import { type FullDate } from './full-date-shape.js';
 /**
@@ -5,7 +6,7 @@ import { type FullDate } from './full-date-shape.js';
  * timezone. If the conversion fails or the input {@link DateLike} is empty, `undefined` is
  * returned.
  */
-export declare function maybeCreateFullDate<const SpecificTimezone extends string>(
+export declare function maybeCreateFullDate<const SpecificTimezone extends Timezone>(
 /** The original date representation to be converted into a FullDate. */
 dateLike: Readonly<DateLike> | undefined | null, 
 /** The timezone that this date/time is meant for / originated from. */

package/dist/full-date/parsing.d.ts

@@ -1,3 +1,4 @@
+import { type Timezone } from '../timezone/timezones.js';
 import { type FullDate } from './full-date-shape.js';
 /**
  * Parses any date string into a {@link FullDate} using the specified pattern and timezone. Prefer
@@ -11,7 +12,7 @@ import { type FullDate } from './full-date-shape.js';
  *
  * @category FullDate
  */
-export declare function parseDateStringWithPattern<const SpecificTimezone extends string>({ dateString, formatString, timezone, }: {
+export declare function parseDateStringWithPattern<const SpecificTimezone extends Timezone>({ dateString, formatString, timezone, }: {
     /** The date string to be parsed. */
     dateString: string;
     /**
@@ -29,4 +30,4 @@ export declare function parseDateStringWithPattern<const SpecificTimezone extend
  * @category FullDate
  * @category HTML
  */
-export declare function parseInputElementValue<const SpecificTimezone extends string>(elementOrValue: Readonly<Pick<HTMLInputElement, 'value'>> | string | null | undefined, timezone: SpecificTimezone): FullDate<SpecificTimezone> | undefined;
+export declare function parseInputElementValue<const SpecificTimezone extends Timezone>(elementOrValue: Readonly<Pick<HTMLInputElement, 'value'>> | string | null | undefined, timezone: SpecificTimezone): FullDate<SpecificTimezone> | undefined;

package/dist/full-date/string-parsing.d.ts

@@ -1,8 +1,9 @@
 import { DateTime } from 'luxon';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Tries extra known formats for parsing date strings, even those that browsers do not natively
  * support.
  *
  * @category Internal
  */
-export declare function parseDateString(dateString: string, timezone: string): DateTime | undefined;
+export declare function parseDateString(dateString: string, timezone: Timezone): DateTime | undefined;

package/dist/full-date/string-parsing.js

@@ -1,4 +1,3 @@
-/* eslint-disable @virmator/prefer-params-object */
 import { DateTime } from 'luxon';
 /**
  * These formats are for luxon, documented here: