@bereasoftware/time-guard 2.7.2 → 2.9.0

package/dist/types/index.d.ts

@@ -577,6 +577,16 @@ export interface ITimeGuardPlugin {
     name: string;
     version: string;
     install(timeGuard: typeof TimeGuard, config?: unknown): void;
+    /**
+     * Reverses whatever install() did to `timeGuard`'s prototype/static
+     * surface (deleting added members, restoring wrapped ones). Optional
+     * for backward compatibility with plugins written before this hook
+     * existed — PluginManager.unuse()/clear() only call it if present, so
+     * omitting it just means re-registering the same plugin after a clear()
+     * stacks a new patch instead of starting clean (the pre-existing
+     * behavior, unchanged for plugins that don't implement this).
+     */
+    uninstall?(timeGuard: typeof TimeGuard): void;
 }
 /**
  * Factory interface

package/dist/vue/index.cjs

@@ -1,143 +1 @@
-/*! time-guard v2.7.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_core = require("../core-BIDjudpO.cjs");
-let vue = require("vue");
-//#region src/vue.ts
-/**
-* Unique symbol key for injecting TimeGuard global configuration.
-*/
-var TimeGuardConfigKey = Symbol("TimeGuardConfig");
-/**
-* Vue Directive for dynamically and reactively formatting dates.
-* Usage:
-* - `<span v-time-guard:format="date" data-pattern="YYYY-MM-DD"></span>`
-* - `<span v-time-guard:relative="date" data-locale="es"></span>`
-*/
-/** Internal WeakMap to track interval timers per element (avoids `any` casts). */
-var directiveTimerMap = /* @__PURE__ */ new WeakMap();
-var vTimeGuard = {
-	mounted(el, binding) {
-		updateDirective(el, binding);
-	},
-	updated(el, binding) {
-		updateDirective(el, binding);
-	},
-	unmounted(el) {
-		const timer = directiveTimerMap.get(el);
-		if (timer) {
-			clearInterval(timer);
-			directiveTimerMap.delete(el);
-		}
-	}
-};
-function updateDirective(el, binding) {
-	const existingTimer = directiveTimerMap.get(el);
-	if (existingTimer) {
-		clearInterval(existingTimer);
-		directiveTimerMap.delete(el);
-	}
-	const value = binding.value;
-	if (value === void 0 || value === null) {
-		el.textContent = "";
-		return;
-	}
-	const mode = binding.arg || "format";
-	const pattern = el.getAttribute("data-pattern") || "YYYY-MM-DD HH:mm:ss";
-	const locale = el.getAttribute("data-locale") || void 0;
-	const intervalMs = parseInt(el.getAttribute("data-interval") || "60000", 10);
-	const numeric = el.getAttribute("data-numeric") || void 0;
-	const render = () => {
-		try {
-			const tg = require_core.TimeGuard.from(value);
-			if (mode === "relative") {
-				const now = require_core.TimeGuard.now();
-				el.textContent = tg.since(now).humanize({
-					locale,
-					numeric
-				});
-			} else el.textContent = locale ? tg.locale(locale).format(pattern) : tg.format(pattern);
-		} catch {
-			el.textContent = String(value);
-		}
-	};
-	render();
-	if (mode === "relative" || el.getAttribute("data-live") === "true") directiveTimerMap.set(el, setInterval(render, intervalMs));
-}
-/**
-* Vue Plugin to register a global TimeGuard configuration and register v-time-guard directive.
-*/
-var TimeGuardVuePlugin = { install(app, options) {
-	app.provide(TimeGuardConfigKey, options);
-	app.directive("time-guard", vTimeGuard);
-} };
-/**
-* Vue Composable to create a reactive Ref of a TimeGuard instance.
-* Automatically updates when input or configuration changes.
-* Inherits global injected configuration as fallback.
-*/
-function useTimeGuard(input, config) {
-	const globalConfig = (0, vue.inject)(TimeGuardConfigKey, void 0);
-	const activeConfig = config ?? globalConfig;
-	const tg = (0, vue.ref)(require_core.TimeGuard.from(input, activeConfig));
-	(0, vue.watch)([() => input, () => activeConfig ? JSON.stringify(activeConfig) : void 0], () => {
-		tg.value = require_core.TimeGuard.from(input, activeConfig);
-	}, { deep: true });
-	return tg;
-}
-/**
-* Vue Composable to get a reactive TimeGuard Ref representing the current time.
-* Automatically updates on a specified interval (default: 1000ms).
-* Inherits global injected configuration as fallback.
-*/
-function useCurrentTime(options) {
-	const globalConfig = (0, vue.inject)(TimeGuardConfigKey, void 0);
-	const activeConfig = options?.config ?? globalConfig;
-	const interval = options?.interval ?? 1e3;
-	const time = (0, vue.ref)(require_core.TimeGuard.now(activeConfig));
-	const timer = setInterval(() => {
-		time.value = require_core.TimeGuard.now(activeConfig);
-	}, interval);
-	(0, vue.onUnmounted)(() => {
-		clearInterval(timer);
-	});
-	return time;
-}
-/**
-* Vue Composable that returns a reactive relative time Ref updating periodically.
-* Inherits global injected configuration as fallback.
-*/
-function useRelativeTime(date, options) {
-	const globalConfig = (0, vue.inject)(TimeGuardConfigKey, void 0);
-	const interval = options?.interval ?? 6e4;
-	const locale = options?.locale ?? globalConfig?.locale;
-	const numeric = options?.numeric;
-	const relative = (0, vue.ref)("");
-	const update = () => {
-		const tgDate = require_core.TimeGuard.from(date);
-		const now = require_core.TimeGuard.now();
-		relative.value = tgDate.since(now).humanize({
-			locale,
-			numeric
-		});
-	};
-	update();
-	const timer = setInterval(update, interval);
-	(0, vue.watch)([
-		() => date,
-		() => locale,
-		() => numeric
-	], () => {
-		update();
-	}, { deep: true });
-	(0, vue.onUnmounted)(() => {
-		clearInterval(timer);
-	});
-	return relative;
-}
-//#endregion
-exports.TimeGuardConfigKey = TimeGuardConfigKey;
-exports.TimeGuardVuePlugin = TimeGuardVuePlugin;
-exports.useCurrentTime = useCurrentTime;
-exports.useRelativeTime = useRelativeTime;
-exports.useTimeGuard = useTimeGuard;
-exports.vTimeGuard = vTimeGuard;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../core-BDQnStek.cjs");let t=require("vue");var n=Symbol(`TimeGuardConfig`),r=new WeakMap,i={mounted(e,t){a(e,t)},updated(e,t){a(e,t)},unmounted(e){let t=r.get(e);t&&(clearInterval(t),r.delete(e))}};function a(t,n){let i=r.get(t);i&&(clearInterval(i),r.delete(t));let a=n.value;if(a==null){t.textContent=``;return}let o=n.arg||`format`,s=t.getAttribute(`data-pattern`)||`YYYY-MM-DD HH:mm:ss`,c=t.getAttribute(`data-locale`)||void 0,l=parseInt(t.getAttribute(`data-interval`)||`60000`,10),u=t.getAttribute(`data-numeric`)||void 0,d=()=>{try{let n=e.i.from(a);if(o===`relative`){let r=e.i.now();t.textContent=n.since(r).humanize({locale:c,numeric:u})}else t.textContent=c?n.locale(c).format(s):n.format(s)}catch{t.textContent=String(a)}};d(),(o===`relative`||t.getAttribute(`data-live`)===`true`)&&r.set(t,setInterval(d,l))}var o={install(e,t){e.provide(n,t),e.directive(`time-guard`,i)}};function s(r,i){let a=(0,t.inject)(n,void 0),o=i??a,s=(0,t.ref)(e.i.from((0,t.toValue)(r),o));return(0,t.watch)([()=>(0,t.toValue)(r),()=>o?.locale,()=>o?.timezone,()=>o?.strict],()=>{s.value=e.i.from((0,t.toValue)(r),o)}),s}function c(r){let i=(0,t.inject)(n,void 0),a=r?.config??i,o=r?.interval??1e3,s=(0,t.ref)(e.i.now(a)),c=setInterval(()=>{s.value=e.i.now(a)},o);return(0,t.onUnmounted)(()=>{clearInterval(c)}),s}function l(r,i){let a=(0,t.inject)(n,void 0),o=i?.interval??6e4,s=i?.locale??a?.locale,c=i?.numeric,l=(0,t.ref)(``),u=()=>{l.value=e.o(r,{locale:s,numeric:c})};u();let d=setInterval(u,o);return(0,t.watch)([()=>r,()=>s,()=>c],()=>{u()},{deep:!0}),(0,t.onUnmounted)(()=>{clearInterval(d)}),l}exports.TimeGuardConfigKey=n,exports.TimeGuardVuePlugin=o,exports.useCurrentTime=c,exports.useRelativeTime=l,exports.useTimeGuard=s,exports.vTimeGuard=i;

package/dist/vue/index.es.js

@@ -1,137 +1,83 @@
-/*! time-guard v2.7.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
-import { n as TimeGuard } from "../core-DWPXk3rz.js";
-import { inject, onUnmounted, ref, watch } from "vue";
+/*! time-guard v2.9.0 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
+import { i as e, o as t } from "../core-GHK7isoa.js";
+import { inject as n, onUnmounted as r, ref as i, toValue as a, watch as o } from "vue";
 //#region src/vue.ts
-/**
-* Unique symbol key for injecting TimeGuard global configuration.
-*/
-var TimeGuardConfigKey = Symbol("TimeGuardConfig");
-/**
-* Vue Directive for dynamically and reactively formatting dates.
-* Usage:
-* - `<span v-time-guard:format="date" data-pattern="YYYY-MM-DD"></span>`
-* - `<span v-time-guard:relative="date" data-locale="es"></span>`
-*/
-/** Internal WeakMap to track interval timers per element (avoids `any` casts). */
-var directiveTimerMap = /* @__PURE__ */ new WeakMap();
-var vTimeGuard = {
-	mounted(el, binding) {
-		updateDirective(el, binding);
+var s = Symbol("TimeGuardConfig"), c = /* @__PURE__ */ new WeakMap(), l = {
+	mounted(e, t) {
+		u(e, t);
 	},
-	updated(el, binding) {
-		updateDirective(el, binding);
+	updated(e, t) {
+		u(e, t);
 	},
-	unmounted(el) {
-		const timer = directiveTimerMap.get(el);
-		if (timer) {
-			clearInterval(timer);
-			directiveTimerMap.delete(el);
-		}
+	unmounted(e) {
+		let t = c.get(e);
+		t && (clearInterval(t), c.delete(e));
 	}
 };
-function updateDirective(el, binding) {
-	const existingTimer = directiveTimerMap.get(el);
-	if (existingTimer) {
-		clearInterval(existingTimer);
-		directiveTimerMap.delete(el);
-	}
-	const value = binding.value;
-	if (value === void 0 || value === null) {
-		el.textContent = "";
+function u(t, n) {
+	let r = c.get(t);
+	r && (clearInterval(r), c.delete(t));
+	let i = n.value;
+	if (i == null) {
+		t.textContent = "";
 		return;
 	}
-	const mode = binding.arg || "format";
-	const pattern = el.getAttribute("data-pattern") || "YYYY-MM-DD HH:mm:ss";
-	const locale = el.getAttribute("data-locale") || void 0;
-	const intervalMs = parseInt(el.getAttribute("data-interval") || "60000", 10);
-	const numeric = el.getAttribute("data-numeric") || void 0;
-	const render = () => {
+	let a = n.arg || "format", o = t.getAttribute("data-pattern") || "YYYY-MM-DD HH:mm:ss", s = t.getAttribute("data-locale") || void 0, l = parseInt(t.getAttribute("data-interval") || "60000", 10), u = t.getAttribute("data-numeric") || void 0, d = () => {
 		try {
-			const tg = TimeGuard.from(value);
-			if (mode === "relative") {
-				const now = TimeGuard.now();
-				el.textContent = tg.since(now).humanize({
-					locale,
-					numeric
+			let n = e.from(i);
+			if (a === "relative") {
+				let r = e.now();
+				t.textContent = n.since(r).humanize({
+					locale: s,
+					numeric: u
 				});
-			} else el.textContent = locale ? tg.locale(locale).format(pattern) : tg.format(pattern);
+			} else t.textContent = s ? n.locale(s).format(o) : n.format(o);
 		} catch {
-			el.textContent = String(value);
+			t.textContent = String(i);
 		}
 	};
-	render();
-	if (mode === "relative" || el.getAttribute("data-live") === "true") directiveTimerMap.set(el, setInterval(render, intervalMs));
+	d(), (a === "relative" || t.getAttribute("data-live") === "true") && c.set(t, setInterval(d, l));
 }
-/**
-* Vue Plugin to register a global TimeGuard configuration and register v-time-guard directive.
-*/
-var TimeGuardVuePlugin = { install(app, options) {
-	app.provide(TimeGuardConfigKey, options);
-	app.directive("time-guard", vTimeGuard);
+var d = { install(e, t) {
+	e.provide(s, t), e.directive("time-guard", l);
 } };
-/**
-* Vue Composable to create a reactive Ref of a TimeGuard instance.
-* Automatically updates when input or configuration changes.
-* Inherits global injected configuration as fallback.
-*/
-function useTimeGuard(input, config) {
-	const globalConfig = inject(TimeGuardConfigKey, void 0);
-	const activeConfig = config ?? globalConfig;
-	const tg = ref(TimeGuard.from(input, activeConfig));
-	watch([() => input, () => activeConfig ? JSON.stringify(activeConfig) : void 0], () => {
-		tg.value = TimeGuard.from(input, activeConfig);
-	}, { deep: true });
-	return tg;
+function f(t, r) {
+	let c = n(s, void 0), l = r ?? c, u = i(e.from(a(t), l));
+	return o([
+		() => a(t),
+		() => l?.locale,
+		() => l?.timezone,
+		() => l?.strict
+	], () => {
+		u.value = e.from(a(t), l);
+	}), u;
 }
-/**
-* Vue Composable to get a reactive TimeGuard Ref representing the current time.
-* Automatically updates on a specified interval (default: 1000ms).
-* Inherits global injected configuration as fallback.
-*/
-function useCurrentTime(options) {
-	const globalConfig = inject(TimeGuardConfigKey, void 0);
-	const activeConfig = options?.config ?? globalConfig;
-	const interval = options?.interval ?? 1e3;
-	const time = ref(TimeGuard.now(activeConfig));
-	const timer = setInterval(() => {
-		time.value = TimeGuard.now(activeConfig);
-	}, interval);
-	onUnmounted(() => {
-		clearInterval(timer);
-	});
-	return time;
+function p(t) {
+	let a = n(s, void 0), o = t?.config ?? a, c = t?.interval ?? 1e3, l = i(e.now(o)), u = setInterval(() => {
+		l.value = e.now(o);
+	}, c);
+	return r(() => {
+		clearInterval(u);
+	}), l;
 }
-/**
-* Vue Composable that returns a reactive relative time Ref updating periodically.
-* Inherits global injected configuration as fallback.
-*/
-function useRelativeTime(date, options) {
-	const globalConfig = inject(TimeGuardConfigKey, void 0);
-	const interval = options?.interval ?? 6e4;
-	const locale = options?.locale ?? globalConfig?.locale;
-	const numeric = options?.numeric;
-	const relative = ref("");
-	const update = () => {
-		const tgDate = TimeGuard.from(date);
-		const now = TimeGuard.now();
-		relative.value = tgDate.since(now).humanize({
-			locale,
-			numeric
+function m(e, a) {
+	let c = n(s, void 0), l = a?.interval ?? 6e4, u = a?.locale ?? c?.locale, d = a?.numeric, f = i(""), p = () => {
+		f.value = t(e, {
+			locale: u,
+			numeric: d
 		});
 	};
-	update();
-	const timer = setInterval(update, interval);
-	watch([
-		() => date,
-		() => locale,
-		() => numeric
+	p();
+	let m = setInterval(p, l);
+	return o([
+		() => e,
+		() => u,
+		() => d
 	], () => {
-		update();
-	}, { deep: true });
-	onUnmounted(() => {
-		clearInterval(timer);
-	});
-	return relative;
+		p();
+	}, { deep: !0 }), r(() => {
+		clearInterval(m);
+	}), f;
 }
 //#endregion
-export { TimeGuardConfigKey, TimeGuardVuePlugin, useCurrentTime, useRelativeTime, useTimeGuard, vTimeGuard };
+export { s as TimeGuardConfigKey, d as TimeGuardVuePlugin, p as useCurrentTime, m as useRelativeTime, f as useTimeGuard, l as vTimeGuard };

package/dist/vue.d.ts

@@ -1,4 +1,4 @@
-import { Ref, Plugin, Directive } from 'vue';
+import { MaybeRefOrGetter, Ref, Plugin, Directive } from 'vue';
 import { TimeGuard, ITimeGuardConfig } from './core';
 /**
  * Unique symbol key for injecting TimeGuard global configuration.
@@ -11,10 +11,12 @@ export declare const vTimeGuard: Directive<HTMLElement, unknown>;
 export declare const TimeGuardVuePlugin: Plugin;
 /**
  * Vue Composable to create a reactive Ref of a TimeGuard instance.
- * Automatically updates when input or configuration changes.
+ * Automatically updates when input or configuration changes — input may be
+ * a plain value, a Ref, or a getter (anything toValue() accepts); passing a
+ * Ref/getter is what makes this actually reactive to that source changing.
  * Inherits global injected configuration as fallback.
  */
-export declare function useTimeGuard(input?: unknown, config?: ITimeGuardConfig): Ref<TimeGuard>;
+export declare function useTimeGuard(input?: MaybeRefOrGetter<unknown>, config?: ITimeGuardConfig): Ref<TimeGuard>;
 /**
  * Vue Composable to get a reactive TimeGuard Ref representing the current time.
  * Automatically updates on a specified interval (default: 1000ms).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bereasoftware/time-guard",
   "private": false,
-  "version": "2.7.2",
+  "version": "2.9.0",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/time-guard.cjs",
@@ -144,7 +144,7 @@
     "not IE 11",
     "> 1%"
   ],
-  "homepage": "https://github.com/Berea-Soft/time-guard#readme",
+  "homepage": "https://time-guard.bereasoft.com/",
   "scripts": {
     "dev:docs": "pnpm --prefix docs-app install && pnpm --prefix docs-app dev",
     "build:docs": "pnpm --prefix docs-app build",
@@ -168,8 +168,7 @@
     "prepare": "husky"
   },
   "dependencies": {
-    "@js-temporal/polyfill": "^0.5.1",
-    "vue-icons-plus": "^0.1.9"
+    "@js-temporal/polyfill": "^0.5.1"
   },
   "peerDependencies": {
     "@angular/core": ">=21.2.14",

package/dist/chunk-S8Y6Ng9i.cjs

@@ -1,36 +0,0 @@
-/*! time-guard v2.7.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-Object.defineProperty(exports, "__commonJSMin", {
-	enumerable: true,
-	get: function() {
-		return __commonJSMin;
-	}
-});
-Object.defineProperty(exports, "__toESM", {
-	enumerable: true,
-	get: function() {
-		return __toESM;
-	}
-});