onomad 2.0.4 → 3.0.0

package/README.md

@@ -2,6 +2,24 @@
 
 TypeScript/JavaScript biblioteka za prikaz vremena u formatu optimizovanom za srpski jezik (npr: "pre 5 minuta"). Radi u browseru i na serveru (node.js / deno / bun).
 
+## Čemu sve ovo?
+
+JavaScript već ima ugrađeni Intl API za formatiranje vremena, ali rezultati nisu u potpunosti prilagođeni srpskom jeziku. Evo poređenja:
+
+| Intl.RelativeTimeFormat | Onomad |
+|-------------------------|--------|
+| pre 30 sekundi | malopre |
+| pre 1 minut | pre minut |
+| pre 5 minuta | pre 5 minuta |
+| pre 30 minuta | pre pola sata |
+| pre 1 sat | pre sat vremena |
+| pre 24 sata | juče |
+| pre 7 dana | pre nedelju dana |
+| pre 30 dana | pre mesec dana |
+| pre 365 dana | pre godinu dana |
+
+Onomad koristi prirodnije izraze koji su uobičajeni u svakodnevnom srpskom jeziku, kao što su `malopre`, `juče`, `pre pola sata` i `pre nedelju dana`, umesto doslovnih brojčanih prikaza.
+
 ## Instalacija
 
 ```bash
@@ -33,14 +51,6 @@ console.log(timeago(lastWeek)); // "pre nedelju dana"
 
 Onomad dolazi sa gotovom Vue komponentom koja automatski ažurira prikaz vremena.
 
-#### Instalacija
-
-```bash
-npm install onomad vue
-```
-
-#### Upotreba komponente
-
 ```vue
 <script setup lang="ts">
 import { TimeAgo } from 'onomad/vue';
@@ -55,28 +65,18 @@ const postDate = new Date(Date.now() - 5 * 60 * 1000);
 </template>
 ```
 
-Komponenta automatski ažurira prikazan tekst svakih 60 sekundi. Možete prilagoditi interval ažuriranja:
+Komponenta automatski ažurira prikazani tekst svakih 60 sekundi (podrazumevano). Možete prilagoditi interval ažuriranja u sekundama:
 
 ```vue
-<TimeAgo :date="postDate" :update-interval="5000" />
+<!-- Ažuriraj na svakih 30 sekundi -->
+<TimeAgo :date="postDate" :update-interval="120" />
 ```
 
-### Upotreba u Nuxt.js
-
-U Nuxt projektima, komponenta automatski radi bez dodatne konfiguracije:
+Možete takođe kontrolisati kada se automatsko ažuriranje zaustavlja koristeći `max-age-update` prop. Ako je vreme starije od određenog praga (u sekundama), interval neće biti pokrenut (podrazumevano: bez ograničenja):
 
 ```vue
-<script setup lang="ts">
-import { TimeAgo } from 'onomad/vue';
-
-const postDate = new Date(Date.now() - 5 * 60 * 1000);
-</script>
-
-<template>
-  <div>
-    <p>Objavljeno <TimeAgo :date="postDate" /></p>
-  </div>
-</template>
+<!-- Samo ažuriraj ako je vreme mlađe od 1 sat (3600 sekundi) -->
+<TimeAgo :date="postDate" :max-age-update="3600" />
 ```
 
 Za server-side rendering (SSR), komponenta će prikazati inicijalno vreme, a zatim će nastaviti sa ažuriranjem na klijentskoj strani.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onomad",
-  "version": "2.0.4",
+  "version": "3.0.0",
   "description": "Time formatting optimized for Serbian language",
   "type": "module",
   "main": "./dist/index.js",

package/src/vue/TimeAgo.vue

@@ -5,8 +5,10 @@ import { timeago } from 'onomad';
 const props = withDefaults(defineProps<{
   date: Date | string;
   updateInterval?: number;
+  maxAgeUpdate?: number;
 }>(), {
-  updateInterval: 60000
+  updateInterval: 60,
+  maxAgeUpdate: Infinity
 });
 
 const formattedTime = ref(timeago(new Date(props.date)));
@@ -16,8 +18,15 @@ const updateTime = () => {
   formattedTime.value = timeago(new Date(props.date));
 };
 
+const getAgeInMs = () => {
+  return Date.now() - new Date(props.date).getTime();
+};
+
 onMounted(() => {
-  intervalId = setInterval(updateTime, props.updateInterval);
+  const ageInMs = getAgeInMs();
+  if (ageInMs <= props.maxAgeUpdate * 1000) {
+    intervalId = setInterval(updateTime, props.updateInterval * 1000);
+  }
 });
 
 onUnmounted(() => {