@item-enonic-types/lib-time 1.2.0 → 1.3.0

package/README.md

@@ -19,7 +19,7 @@ repositories {
 }
 
 dependencies {
-  include "no.item:lib-xp-time:1.1.0"
+  include "no.item:lib-xp-time:1.3.0"
 }
 ```
 
@@ -107,11 +107,32 @@ const time = today.format(formatter);
 // time = "tirsdag 21. februar 2023 12:15:30"
 ```
 
+*Example of using hte `LanguageRange` utility to find the preferred locale among the ones supported by the application.*
+
+```typescript
+import { LanguageRange, Locale } from "/lib/time";
+import { getSupportedLocales } from "/lib/xp/i18n";
+import type { Request, Response } from "@enonic-types/core";
+
+export function get(req: Request): Response {
+  const languageRange = LanguageRange.parse(req.headers["Accept-Language"]);
+  
+  const locale: string = Locale.filterTags(
+    languageRange, 
+    getSupportedLocales(["i18n/phrases"])
+  )[0];
+  
+  ...
+}
+
+```
+
 ### Constants exposed from `"/lib/time"`
 The following classes is exposed/exported from `"/lib/time"`:
 * `DateTimeFormatter`
 * `DayOfWeek`
 * `Instant`
+* `LanguageRange`
 * `LocalDate`
 * `LocalDateTime`
 * `Locale`
@@ -133,8 +154,6 @@ To build the project, run the following command
 enonic project build
 ```
 
-You will find the jar-file at _./build/libs/item.jar_
-
 ### Deploying locally
 
 To deploy to a local sandbox, run the following command
@@ -148,3 +167,9 @@ enonic project deploy
 ```bash
 ./gradlew publish -P com.enonic.xp.app.production=true
 ```
+
+### Deploy to npm
+
+```bash
+npm publish
+```

package/local-date-time.d.ts

@@ -66,4 +66,6 @@ export interface LocalDateTime {
     withNano(nano: number): LocalDateTime;
     withSecond(second: number): LocalDateTime;
     withYear(year: number): LocalDateTime;
+    toEpochSecond(offset: ZoneOffset): number;
+    toInstant(offset: ZoneOffset): Instant;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@item-enonic-types/lib-time",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Type definitions for lib-time",
   "license": "MIT",
   "files": [
@@ -9,19 +9,19 @@
     "tsconfig.json"
   ],
   "devDependencies": {
-    "@changesets/cli": "^2.27.12",
+    "@changesets/cli": "^2.29.8",
     "@item-enonic-types/lib-testing": "^7.13.0",
-    "@swc/core": "^1.10.14",
-    "@types/node": "^22.13.1",
-    "eslint": "^9.19.0",
-    "eslint-config-prettier": "^10.0.1",
-    "eslint-plugin-prettier": "^5.2.3",
-    "concurrently": "^9.1.2",
-    "glob": "^11.0.1",
-    "prettier": "^3.4.2",
-    "tsup": "^8.3.6",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.23.0"
+    "@swc/core": "^1.15.4",
+    "@types/node": "^25.0.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "concurrently": "^9.2.1",
+    "glob": "^13.0.0",
+    "prettier": "^3.7.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0"
   },
   "dependencies": {
     "@item-enonic-types/nashorn-env": "^0.0.2"

package/util.d.ts

@@ -32,7 +32,7 @@ export interface LocaleConstructor {
     UNICODE_LOCALE_EXTENSION: Locale;
     US: Locale;
     filter(priorityList: LanguageRange[], locales: Locale[]): Locale[];
-    filterTags(priorityList: LanguageRange[], tags: string[]): Locale[];
+    filterTags(priorityList: LanguageRange[], tags: string[]): string[];
     forLanguageTag(languageTag: string): Locale;
     getAvailableLocales(): Locale[];
     getDefault(): Locale;

package/zoned-date-time.d.ts

@@ -69,4 +69,6 @@ export interface ZonedDateTime {
     withZoneSameInstant(zone: ZoneId): ZonedDateTime;
     withZoneSameLocal(zone: ZoneId): ZonedDateTime;
     toString(): string;
+    toEpochSecond(): number;
+    toInstant(): Instant;
 }