date-vir 7.3.1 → 7.4.0

package/README.md

@@ -9,7 +9,7 @@ Full docs: http://electrovir.github.io/date-vir
 <!-- example-link: src/readme-examples/full-date.example.ts -->
 
 ```TypeScript
-import {FullDate, utcTimezone} from 'date-vir';
+import {type FullDate, utcTimezone} from 'date-vir';
 
 const myDate: FullDate = {
     year: 2023,

package/dist/date-operations/calculate-relative-date.d.ts

@@ -1,6 +1,6 @@
-import type { AnyDuration } from '@date-vir/duration';
-import { FullDate } from '../full-date/full-date-shape.js';
-import { Timezone } from '../timezone/timezones.js';
+import { type AnyDuration } from '@date-vir/duration';
+import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Calculates a new date starting at the given fullDate and adding the given offsets. Offsets can be
  * negative to go backwards in time.

package/dist/date-operations/combine-dates.d.ts

@@ -1,6 +1,6 @@
-import type { FullDatePart } from '../full-date/full-date-parts.js';
-import { DatePart, FullDate, TimePart } from '../full-date/full-date-shape.js';
-import type { Timezone } from '../timezone/timezones.js';
+import { type FullDatePart } from '../full-date/full-date-parts.js';
+import { type DatePart, type FullDate, type TimePart } from '../full-date/full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * An object containing date and/or time parts or neither. Used for {@link combineDateParts}
  *

package/dist/date-operations/date-position.d.ts

@@ -1,6 +1,6 @@
 import { DateUnit } from '@date-vir/duration';
 import { type FullDate } from '../full-date/full-date-shape.js';
-import { Timezone } from '../timezone/timezones.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Get the {@link DateUnit} value of a {@link FullDate}.
  *

package/dist/date-operations/diff-dates.d.ts

@@ -1,5 +1,5 @@
 import { type DurationBySelection, type DurationUnitSelection, type RoundOptions } from '@date-vir/duration';
-import { FullDate } from '../full-date/full-date-shape.js';
+import { type FullDate } from '../full-date/full-date-shape.js';
 /**
  * Diffs two dates and returns the diff in the specified unit or units. When a multiple units are
  * provided with the `units` input property, an array is returned with the full diff duration

package/dist/duration-shape.d.ts

@@ -0,0 +1,11 @@
+import { DurationUnit } from '@date-vir/duration';
+/**
+ * A shape definition for `AnyDuration`.
+ *
+ * @category Duration
+ */
+export declare const anyDurationShape: import("object-shape-tester").ShapeIndexedKeys<[{
+    keys: import("object-shape-tester").ShapeEnum<readonly [typeof DurationUnit]>;
+    values: number;
+    required: false;
+}]>;

package/dist/duration-shape.js

@@ -0,0 +1,12 @@
+import { DurationUnit } from '@date-vir/duration';
+import { enumShape, indexedKeys } from 'object-shape-tester';
+/**
+ * A shape definition for `AnyDuration`.
+ *
+ * @category Duration
+ */
+export const anyDurationShape = indexedKeys({
+    keys: enumShape(DurationUnit),
+    values: -1,
+    required: false,
+});

package/dist/extra-utils/has-date-props.d.ts

@@ -1,6 +1,6 @@
 import { type PartialWithUndefined, type SetRequiredAndNotNull } from '@augment-vir/common';
 import { type FullDate } from '../full-date/full-date-shape.js';
-import type { Timezone } from '../timezone/timezones.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Checks that the input has all the requested {@link FullDate} keys.
  *

package/dist/extra-utils/js-date-conversion.d.ts

@@ -1,4 +1,4 @@
-import { FullDate } from '../full-date/full-date-shape.js';
+import { type FullDate } from '../full-date/full-date-shape.js';
 /**
  * Convert a {@link FullDate} from a built-in JS
  * [`Date`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date).

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

@@ -1,6 +1,6 @@
-import { UtcIsoString } from '../formatting/string-format-types.js';
-import { FullDate } from '../full-date/full-date-shape.js';
-import { Timezone, UtcTimezone } from '../timezone/timezones.js';
+import { type UtcIsoString } from '../formatting/string-format-types.js';
+import { type FullDate } from '../full-date/full-date-shape.js';
+import { type Timezone, type UtcTimezone } from '../timezone/timezones.js';
 /**
  * Get the time right now as a UTC ISO.
  *

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

@@ -1,5 +1,5 @@
-import { FullDate } from '../full-date/full-date-shape.js';
-import { Timezone } from '../timezone/timezones.js';
+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.
  *

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

@@ -1,6 +1,6 @@
 import { TimeKey } from '../full-date/full-date-parts.js';
-import { FullDate } from '../full-date/full-date-shape.js';
-import { Timezone } from '../timezone/timezones.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.
  *

package/dist/formatting/html-input.d.ts

@@ -1,6 +1,6 @@
 import { FullDatePart } from '../full-date/full-date-parts.js';
-import { DatePart, FullDate } from '../full-date/full-date-shape.js';
-import { DateTimeString, DateTimeWithSeconds, JustDateString, JustTimeString, JustTimeWithSecondsString } from './string-format-types.js';
+import { type DatePart, type FullDate } from '../full-date/full-date-shape.js';
+import { type DateTimeString, type DateTimeWithSeconds, type JustDateString, type JustTimeString, type JustTimeWithSecondsString } from './string-format-types.js';
 /**
  * Only the date part of a {@link FullDate}, without timezone.
  *

package/dist/formatting/relative-string.d.ts

@@ -1,6 +1,6 @@
 import { type PartialWithUndefined } from '@augment-vir/common';
-import { AnyDuration, DurationUnitSelection } from '@date-vir/duration';
-import { FullDate } from '../full-date/full-date-shape.js';
+import { type AnyDuration, type DurationUnitSelection } from '@date-vir/duration';
+import { type FullDate } from '../full-date/full-date-shape.js';
 /**
  * Options for {@link toRelativeString}.
  *

package/dist/formatting/relative-string.js

@@ -1,6 +1,6 @@
 import { check } from '@augment-vir/assert';
 import { arrayToObject, filterMap } from '@augment-vir/common';
-import { DurationUnit, convertDuration, flattenUnitSelection, singularDurationUnitNames, } from '@date-vir/duration';
+import { convertDuration, DurationUnit, flattenUnitSelection, singularDurationUnitNames, } from '@date-vir/duration';
 import { diffDates } from '../date-operations/diff-dates.js';
 const defaultJustNowThresholds = {
     minutes: 1.5,
@@ -62,6 +62,7 @@ export function toRelativeString(datesOrDuration, units, options = {}) {
         return 'just now';
     }
     else if (options.useOnlyLargestUnit) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
         if (!unitValues[0]) {
             return '';
         }

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

@@ -1,6 +1,6 @@
-import type { SetOptionalAndNullable } from '@augment-vir/common';
-import { FullDate } from '../full-date/full-date-shape.js';
-import { JustDateString, JustTimeString, JustTimeWithSecondsString } from './string-format-types.js';
+import { type SetOptionalAndNullable } from '@augment-vir/common';
+import { type FullDate } from '../full-date/full-date-shape.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.
  *

package/dist/formatting/timestamp.d.ts

@@ -1,5 +1,5 @@
-import { FullDate } from '../full-date/full-date-shape.js';
-import { UtcIsoString } from './string-format-types.js';
+import { type FullDate } from '../full-date/full-date-shape.js';
+import { type UtcIsoString } from './string-format-types.js';
 /**
  * Convert a FullDate into a unix timestamp with milliseconds.
  *

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

@@ -1,6 +1,6 @@
-import { Timezone, UtcTimezone } from '../timezone/timezones.js';
-import { DateLike } from './date-like.js';
-import { FullDate } from './full-date-shape.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';
 /**
  * Parses the given {@link DateLike} and converts it into a {@link FullDate} instance with the user's
  * current timezone.

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

@@ -1,6 +1,6 @@
-import { DateTime } from 'luxon';
-import { Timezone } from '../timezone/timezones.js';
-import { FullDate } from './full-date-shape.js';
+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.
  *

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

@@ -1,6 +1,6 @@
-import { Overwrite, type SetRequired } from '@augment-vir/common';
+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 Simplify } from 'type-fest';
 import { Timezone } from '../timezone/timezones.js';
 /**
  * Time part of {@link FullDate} represented in a shape definition.

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

@@ -1,5 +1,5 @@
-import { Timezone } from '../timezone/timezones.js';
-import { FullDate } from './full-date-shape.js';
+import { type Timezone } from '../timezone/timezones.js';
+import { type FullDate } from './full-date-shape.js';
 /**
  * Asserts that the input is a valid {@link FullDate}.
  *

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

@@ -1,6 +1,6 @@
 import { DateTime } from 'luxon';
-import { Timezone } from '../timezone/timezones.js';
-import { FullDate } from './full-date-shape.js';
+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
  * complex operations on dates. It does, however, internally power a lot of date-vir functionality

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

@@ -1,5 +1,5 @@
-import { Timezone } from '../timezone/timezones.js';
-import { FullDate } from './full-date-shape.js';
+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
  * using {@link createFullDate} if possible.

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

@@ -1,5 +1,5 @@
 import { DateTime } from 'luxon';
-import { Timezone } from '../timezone/timezones.js';
+import { type Timezone } from '../timezone/timezones.js';
 /**
  * Tries extra known formats for parsing date strings, even those that browsers do not natively
  * support.

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

@@ -10,6 +10,18 @@ const knownStringFormats = [
     'LLL-y',
     // january-2021
     'LLLL-y',
+    // no padding
+    // Sat, 1 Jun 2025 6:23:21 +0000 (UTC)
+    'ccc, d LLL y H:mm:ss ZZZ (z)',
+    // all padding
+    // Sat, 01 Jun 2025 06:23:21 +0000 (UTC)
+    'ccc, dd LLL y HH:mm:ss ZZZ (z)',
+    // padded day
+    // Sat, 01 Jun 2025 6:23:21 +0000 (UTC)
+    'ccc, dd LLL y H:mm:ss ZZZ (z)',
+    // padded hour
+    // Sat, 01 Jun 2025 6:23:21 +0000 (UTC)
+    'ccc, d LLL y HH:mm:ss ZZZ (z)',
 ];
 /**
  * Tries extra known formats for parsing date strings, even those that browsers do not natively

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './date-operations/calculate-relative-date.js';
 export * from './date-operations/combine-dates.js';
 export * from './date-operations/date-position.js';
 export * from './date-operations/diff-dates.js';
+export * from './duration-shape.js';
 export * from './extra-utils/end.js';
 export * from './extra-utils/has-date-props.js';
 export * from './extra-utils/js-date-conversion.js';

package/dist/index.js

@@ -2,6 +2,7 @@ export * from './date-operations/calculate-relative-date.js';
 export * from './date-operations/combine-dates.js';
 export * from './date-operations/date-position.js';
 export * from './date-operations/diff-dates.js';
+export * from './duration-shape.js';
 export * from './extra-utils/end.js';
 export * from './extra-utils/has-date-props.js';
 export * from './extra-utils/js-date-conversion.js';

package/dist/timezone/timezone-checks.d.ts

@@ -1,4 +1,4 @@
-import { Timezone } from './timezones.js';
+import { type Timezone } from './timezones.js';
 /**
  * Asserts that the given input is a valid timezone name.
  *

package/dist/timezone/timezones.d.ts

@@ -1,4 +1,4 @@
-import type { ArrayElement } from '@augment-vir/common';
+import { type ArrayElement } from '@augment-vir/common';
 import { allTimezoneNames } from './timezone-names.js';
 /**
  * All possible timezone names.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "date-vir",
-    "version": "7.3.1",
+    "version": "7.4.0",
     "description": "Easy and explicit dates and times.",
     "keywords": [
         "date",
@@ -34,26 +34,26 @@
         "test:docs": "virmator docs check"
     },
     "dependencies": {
-        "@augment-vir/assert": "^31.10.0",
-        "@augment-vir/common": "^31.10.0",
-        "@date-vir/duration": "^7.3.1",
-        "@types/luxon": "^3.4.2",
-        "luxon": "^3.5.0",
-        "object-shape-tester": "^5.1.5",
-        "type-fest": "^4.37.0"
+        "@augment-vir/assert": "^31.28.0",
+        "@augment-vir/common": "^31.28.0",
+        "@date-vir/duration": "^7.4.0",
+        "@types/luxon": "^3.6.2",
+        "luxon": "^3.7.1",
+        "object-shape-tester": "^5.3.0",
+        "type-fest": "^4.41.0"
     },
     "devDependencies": {
-        "@augment-vir/test": "^31.10.0",
+        "@augment-vir/test": "^31.28.0",
         "@web/dev-server-esbuild": "^1.0.4",
-        "@web/test-runner": "^0.20.0",
+        "@web/test-runner": "^0.20.2",
         "@web/test-runner-commands": "^0.9.0",
-        "@web/test-runner-playwright": "^0.11.0",
+        "@web/test-runner-playwright": "^0.11.1",
         "@web/test-runner-visual-regression": "^0.10.0",
-        "element-vir": "^23.4.2",
+        "element-vir": "^26.5.8",
         "istanbul-smart-text-reporter": "^1.1.5",
         "markdown-code-example-inserter": "^3.0.3",
-        "typedoc": "^0.27.9",
-        "typescript": "^5.8.2"
+        "typedoc": "^0.28.7",
+        "typescript": "^5.8.3"
     },
     "engines": {
         "node": ">=22"