@sveltebase/i18n 0.4.2 → 0.4.3

package/README.md

@@ -39,8 +39,23 @@ export const languages = [
     messages: {
       "app-title": "My app",
       "welcome": "Welcome, {name}",
+
       "just-now": "Just now",
+
       "minutes-ago": "{minutes} minutes ago",
+      "hours-ago": "{hours} hours ago",
+      "days-ago": "{days} days ago",
+      "weeks-ago": "{weeks} weeks ago",
+      "months-ago": "{months} months ago",
+      "years-ago": "{years} years ago",
+
+      "in-minutes": "in {minutes} minutes",
+      "in-hours": "in {hours} hours",
+      "in-days": "in {days} days",
+      "in-weeks": "in {weeks} weeks",
+      "in-months": "in {months} months",
+      "in-years": "in {years} years",
+
       "today-at": "Today at {time}",
       "yesterday-at": "Yesterday at {time}"
     }
@@ -51,8 +66,23 @@ export const languages = [
     messages: {
       "app-title": "Mening ilovam",
       "welcome": "Xush kelibsiz, {name}",
+
       "just-now": "Hozirgina",
+
       "minutes-ago": "{minutes} daqiqa oldin",
+      "hours-ago": "{hours} soat oldin",
+      "days-ago": "{days} kun oldin",
+      "weeks-ago": "{weeks} hafta oldin",
+      "months-ago": "{months} oy oldin",
+      "years-ago": "{years} yil oldin",
+
+      "in-minutes": "{minutes} daqiqadan keyin",
+      "in-hours": "{hours} soatdan keyin",
+      "in-days": "{days} kundan keyin",
+      "in-weeks": "{weeks} haftadan keyin",
+      "in-months": "{months} oydan keyin",
+      "in-years": "{years} yildan keyin",
+
       "today-at": "Bugun {time} da",
       "yesterday-at": "Kecha {time} da"
     }
@@ -272,6 +302,7 @@ const format = getFormat();
 
 format(new Date(), { preset: "full" });
 format(new Date(), { preset: "custom", withTime: true });
+format(Date.now() - 1000 * 60 * 5, { preset: "relative" });
 format("13:45:00", { preset: "timestring" });
 ```
 
@@ -295,11 +326,19 @@ console.log(i18n.currentLanguage.label);
 
 - `default`
 - `custom`
+- `relative`
 - `birthday`
 - `month`
 - `timestring`
 - `full`
 
+### Preset notes
+
+- `relative` always returns relative text for both past and future values. It does not fall back to an absolute date.
+- `custom` can still mix relative labels such as `just-now` or `today-at` with locale-aware absolute dates for older values.
+- `full` returns a full locale-aware date and optionally time.
+- `timestring` is for time-only string values such as `"08:30:00"`.
+
 ### Example
 
 ```ts
@@ -308,9 +347,73 @@ const format = getFormat();
 format(new Date(), { preset: "month" });
 format(new Date(), { preset: "birthday" });
 format(new Date(), { preset: "full", withTime: true });
+format(Date.now() - 1000 * 60 * 5, { preset: "relative" });
 format("08:30:00", { preset: "timestring" });
 ```
 
+## Required locale strings for relative formatting
+
+If you use `preset: "relative"`, make sure every locale provides these message keys:
+
+- `just-now`
+- `minutes-ago`
+- `hours-ago`
+- `days-ago`
+- `weeks-ago`
+- `months-ago`
+- `years-ago`
+- `in-minutes`
+- `in-hours`
+- `in-days`
+- `in-weeks`
+- `in-months`
+- `in-years`
+
+Example:
+
+```ts
+const languages = [
+  {
+    code: "en",
+    label: "English",
+    messages: {
+      "just-now": "Just now",
+      "minutes-ago": "{minutes} minutes ago",
+      "hours-ago": "{hours} hours ago",
+      "days-ago": "{days} days ago",
+      "weeks-ago": "{weeks} weeks ago",
+      "months-ago": "{months} months ago",
+      "years-ago": "{years} years ago",
+      "in-minutes": "in {minutes} minutes",
+      "in-hours": "in {hours} hours",
+      "in-days": "in {days} days",
+      "in-weeks": "in {weeks} weeks",
+      "in-months": "in {months} months",
+      "in-years": "in {years} years"
+    }
+  },
+  {
+    code: "uz",
+    label: "O‘zbekcha",
+    messages: {
+      "just-now": "Hozirgina",
+      "minutes-ago": "{minutes} daqiqa oldin",
+      "hours-ago": "{hours} soat oldin",
+      "days-ago": "{days} kun oldin",
+      "weeks-ago": "{weeks} hafta oldin",
+      "months-ago": "{months} oy oldin",
+      "years-ago": "{years} yil oldin",
+      "in-minutes": "{minutes} daqiqadan keyin",
+      "in-hours": "{hours} soatdan keyin",
+      "in-days": "{days} kundan keyin",
+      "in-weeks": "{weeks} haftadan keyin",
+      "in-months": "{months} oydan keyin",
+      "in-years": "{years} yildan keyin"
+    }
+  }
+] as const;
+```
+
 ## Type safety
 
 When your language array is declared with `as const`, locale codes are inferred automatically.

package/dist/index.d.ts

@@ -13,7 +13,7 @@ type LanguageDefinition<TLocale extends string = string, TMessages extends Messa
     messages: TMessages;
 };
 type FormatOptions = {
-    preset?: "default" | "custom" | "birthday" | "month" | "timestring" | "full";
+    preset?: "default" | "custom" | "birthday" | "month" | "timestring" | "full" | "relative";
     withTime?: boolean;
 };
 

package/dist/index.js

@@ -44,6 +44,36 @@ function formatTimeWithDateFns(value, format) {
   const minutes = String(value.getMinutes()).padStart(2, "0");
   return `${hours}:${minutes}`;
 }
+function formatRelativeDate(value, t) {
+  const now = new SvelteDate();
+  const diffMinutes = Math.floor((value.getTime() - now.getTime()) / 6e4);
+  const absMinutes = Math.abs(diffMinutes);
+  if (absMinutes < 1) {
+    return t("just-now");
+  }
+  const isFuture = diffMinutes > 0;
+  if (absMinutes < 60) {
+    return isFuture ? t("in-minutes", { minutes: absMinutes }) : t("minutes-ago", { minutes: absMinutes });
+  }
+  const absHours = Math.floor(absMinutes / 60);
+  if (absHours < 24) {
+    return isFuture ? t("in-hours", { hours: absHours }) : t("hours-ago", { hours: absHours });
+  }
+  const absDays = Math.floor(absHours / 24);
+  if (absDays < 7) {
+    return isFuture ? t("in-days", { days: absDays }) : t("days-ago", { days: absDays });
+  }
+  const absWeeks = Math.floor(absDays / 7);
+  if (absDays < 30) {
+    return isFuture ? t("in-weeks", { weeks: absWeeks }) : t("weeks-ago", { weeks: absWeeks });
+  }
+  const absMonths = Math.floor(absDays / 30);
+  if (absDays < 365) {
+    return isFuture ? t("in-months", { months: absMonths }) : t("months-ago", { months: absMonths });
+  }
+  const absYears = Math.floor(absDays / 365);
+  return isFuture ? t("in-years", { years: absYears }) : t("years-ago", { years: absYears });
+}
 var UZ_WEEKDAYS = [
   "Yakshanba",
   "Dushanba",
@@ -119,6 +149,9 @@ function createFormatForLocale(languages, locale, fallbackLocale, timeZone = "As
       });
     }
     const date = toDate(value);
+    if (preset === "relative") {
+      return formatRelativeDate(date, t);
+    }
     if (preset === "full") {
       return locale === "uz" ? formatUzDate(date, true, withTime) : formatter.dateTime(date, {
         year: "numeric",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sveltebase/i18n",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -18,7 +18,7 @@
     }
   },
   "dependencies": {
-    "@sveltebase/state": "0.4.2",
+    "@sveltebase/state": "0.4.3",
     "use-intl": "^4.4.0"
   },
   "peerDependencies": {