@bereasoftware/time-guard 2.6.1 → 2.7.1

package/dist/angular/index.cjs

@@ -0,0 +1,148 @@
+/*! time-guard v2.7.1 | (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-BFdo248T.cjs");
+let _angular_core = require("@angular/core");
+let rxjs = require("rxjs");
+//#region src/angular.ts
+/**
+* Angular Injection Token to register global/default TimeGuard configurations.
+*/
+var TIME_GUARD_CONFIG = new _angular_core.InjectionToken("TIME_GUARD_CONFIG");
+/**
+* Angular Pipe to format a date/time using TimeGuard.
+* Supports global configuration overrides via DI.
+* Usage: `{{ date | timeGuardFormat:'YYYY-MM-DD':'es' }}`
+*/
+var TimeGuardFormatPipe = class {
+	globalConfig = (0, _angular_core.inject)(TIME_GUARD_CONFIG, { optional: true });
+	transform(value, pattern = "YYYY-MM-DD HH:mm:ss", locale) {
+		if (!value) return "";
+		try {
+			const tg = require_core.TimeGuard.from(value);
+			const activeLocale = locale || this.globalConfig?.locale;
+			if (activeLocale) return tg.locale(activeLocale).format(pattern);
+			return tg.format(pattern);
+		} catch {
+			return String(value);
+		}
+	}
+};
+/**
+* Angular Pipe for dynamic relative time humanization.
+* Supports global configuration overrides via DI.
+* Usage: `{{ date | timeGuardRelative:'es':'auto' }}`
+*/
+var TimeGuardRelativePipe = class {
+	globalConfig = (0, _angular_core.inject)(TIME_GUARD_CONFIG, { optional: true });
+	transform(value, locale, numeric) {
+		if (!value) return "";
+		try {
+			const tg = require_core.TimeGuard.from(value);
+			const now = require_core.TimeGuard.now();
+			const activeLocale = locale || this.globalConfig?.locale;
+			return tg.since(now).humanize({
+				locale: activeLocale,
+				numeric
+			});
+		} catch {
+			return String(value);
+		}
+	}
+};
+/**
+* Injectable Service to interact with TimeGuard.
+* Provides a high-performance reactive Observable of the current time
+* running outside Angular zone to optimize change detection ticks.
+* Supports global configuration overrides via DI.
+*/
+var TimeGuardService = class {
+	ngZone = (0, _angular_core.inject)(_angular_core.NgZone);
+	globalConfig = (0, _angular_core.inject)(TIME_GUARD_CONFIG, { optional: true });
+	/**
+	* Get an Observable of the current time, ticking on the specified interval.
+	*/
+	getCurrentTime(intervalMs = 1e3, config) {
+		const activeConfig = config ?? this.globalConfig ?? void 0;
+		return new rxjs.Observable((subscriber) => {
+			return this.ngZone.runOutsideAngular(() => {
+				subscriber.next(require_core.TimeGuard.now(activeConfig));
+				const intervalId = setInterval(() => {
+					this.ngZone.run(() => {
+						subscriber.next(require_core.TimeGuard.now(activeConfig));
+					});
+				}, intervalMs);
+				return () => {
+					clearInterval(intervalId);
+				};
+			});
+		}).pipe((0, rxjs.shareReplay)(1));
+	}
+};
+/**
+* Angular Pipe to dynamically tick and format dates at a custom interval.
+* Highly optimized, impure pipe utilizing TimeGuardService and ChangeDetectorRef.
+* Usage:
+* - Real-time clock: `{{ 'now' | timeGuardLiveFormat:'HH:mm:ss':1000 }}`
+* - Ticking static date: `{{ date | timeGuardLiveFormat:'YYYY-MM-DD HH:mm:ss':5000 }}`
+*/
+var TimeGuardLiveFormatPipe = class {
+	latestValue = "";
+	subscription;
+	lastInput;
+	lastPattern;
+	lastInterval;
+	lastLocale;
+	cdr = (0, _angular_core.inject)(_angular_core.ChangeDetectorRef);
+	timeGuardService = (0, _angular_core.inject)(TimeGuardService);
+	globalConfig = (0, _angular_core.inject)(TIME_GUARD_CONFIG, { optional: true });
+	transform(value, pattern = "YYYY-MM-DD HH:mm:ss", intervalMs = 1e3, locale) {
+		if (!value) return "";
+		if (value !== this.lastInput || pattern !== this.lastPattern || intervalMs !== this.lastInterval || locale !== this.lastLocale) {
+			this.ngOnDestroy();
+			this.lastInput = value;
+			this.lastPattern = pattern;
+			this.lastInterval = intervalMs;
+			this.lastLocale = locale;
+			const activeLocale = locale || this.globalConfig?.locale;
+			if (value === "now") this.subscription = this.timeGuardService.getCurrentTime(intervalMs).subscribe((now) => {
+				this.latestValue = activeLocale ? now.locale(activeLocale).format(pattern) : now.format(pattern);
+				this.cdr.markForCheck();
+			});
+			else this.subscription = this.timeGuardService.getCurrentTime(intervalMs).subscribe(() => {
+				try {
+					const tg = require_core.TimeGuard.from(value);
+					this.latestValue = activeLocale ? tg.locale(activeLocale).format(pattern) : tg.format(pattern);
+					this.cdr.markForCheck();
+				} catch {
+					this.latestValue = String(value);
+				}
+			});
+		}
+		return this.latestValue;
+	}
+	ngOnDestroy() {
+		if (this.subscription) {
+			this.subscription.unsubscribe();
+			this.subscription = void 0;
+		}
+	}
+};
+(0, _angular_core.Pipe)({
+	name: "timeGuardFormat",
+	pure: true
+})(TimeGuardFormatPipe);
+(0, _angular_core.Pipe)({
+	name: "timeGuardRelative",
+	pure: false
+})(TimeGuardRelativePipe);
+(0, _angular_core.Injectable)({ providedIn: "root" })(TimeGuardService);
+(0, _angular_core.Pipe)({
+	name: "timeGuardLiveFormat",
+	pure: false
+})(TimeGuardLiveFormatPipe);
+//#endregion
+exports.TIME_GUARD_CONFIG = TIME_GUARD_CONFIG;
+exports.TimeGuardFormatPipe = TimeGuardFormatPipe;
+exports.TimeGuardLiveFormatPipe = TimeGuardLiveFormatPipe;
+exports.TimeGuardRelativePipe = TimeGuardRelativePipe;
+exports.TimeGuardService = TimeGuardService;

package/dist/angular/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../angular'
+export {}

package/dist/angular/index.es.js

@@ -0,0 +1,143 @@
+/*! time-guard v2.7.1 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
+import { n as TimeGuard } from "../core-CyBR5PPd.js";
+import { ChangeDetectorRef, Injectable, InjectionToken, NgZone, Pipe, inject } from "@angular/core";
+import { Observable, shareReplay } from "rxjs";
+//#region src/angular.ts
+/**
+* Angular Injection Token to register global/default TimeGuard configurations.
+*/
+var TIME_GUARD_CONFIG = new InjectionToken("TIME_GUARD_CONFIG");
+/**
+* Angular Pipe to format a date/time using TimeGuard.
+* Supports global configuration overrides via DI.
+* Usage: `{{ date | timeGuardFormat:'YYYY-MM-DD':'es' }}`
+*/
+var TimeGuardFormatPipe = class {
+	globalConfig = inject(TIME_GUARD_CONFIG, { optional: true });
+	transform(value, pattern = "YYYY-MM-DD HH:mm:ss", locale) {
+		if (!value) return "";
+		try {
+			const tg = TimeGuard.from(value);
+			const activeLocale = locale || this.globalConfig?.locale;
+			if (activeLocale) return tg.locale(activeLocale).format(pattern);
+			return tg.format(pattern);
+		} catch {
+			return String(value);
+		}
+	}
+};
+/**
+* Angular Pipe for dynamic relative time humanization.
+* Supports global configuration overrides via DI.
+* Usage: `{{ date | timeGuardRelative:'es':'auto' }}`
+*/
+var TimeGuardRelativePipe = class {
+	globalConfig = inject(TIME_GUARD_CONFIG, { optional: true });
+	transform(value, locale, numeric) {
+		if (!value) return "";
+		try {
+			const tg = TimeGuard.from(value);
+			const now = TimeGuard.now();
+			const activeLocale = locale || this.globalConfig?.locale;
+			return tg.since(now).humanize({
+				locale: activeLocale,
+				numeric
+			});
+		} catch {
+			return String(value);
+		}
+	}
+};
+/**
+* Injectable Service to interact with TimeGuard.
+* Provides a high-performance reactive Observable of the current time
+* running outside Angular zone to optimize change detection ticks.
+* Supports global configuration overrides via DI.
+*/
+var TimeGuardService = class {
+	ngZone = inject(NgZone);
+	globalConfig = inject(TIME_GUARD_CONFIG, { optional: true });
+	/**
+	* Get an Observable of the current time, ticking on the specified interval.
+	*/
+	getCurrentTime(intervalMs = 1e3, config) {
+		const activeConfig = config ?? this.globalConfig ?? void 0;
+		return new Observable((subscriber) => {
+			return this.ngZone.runOutsideAngular(() => {
+				subscriber.next(TimeGuard.now(activeConfig));
+				const intervalId = setInterval(() => {
+					this.ngZone.run(() => {
+						subscriber.next(TimeGuard.now(activeConfig));
+					});
+				}, intervalMs);
+				return () => {
+					clearInterval(intervalId);
+				};
+			});
+		}).pipe(shareReplay(1));
+	}
+};
+/**
+* Angular Pipe to dynamically tick and format dates at a custom interval.
+* Highly optimized, impure pipe utilizing TimeGuardService and ChangeDetectorRef.
+* Usage:
+* - Real-time clock: `{{ 'now' | timeGuardLiveFormat:'HH:mm:ss':1000 }}`
+* - Ticking static date: `{{ date | timeGuardLiveFormat:'YYYY-MM-DD HH:mm:ss':5000 }}`
+*/
+var TimeGuardLiveFormatPipe = class {
+	latestValue = "";
+	subscription;
+	lastInput;
+	lastPattern;
+	lastInterval;
+	lastLocale;
+	cdr = inject(ChangeDetectorRef);
+	timeGuardService = inject(TimeGuardService);
+	globalConfig = inject(TIME_GUARD_CONFIG, { optional: true });
+	transform(value, pattern = "YYYY-MM-DD HH:mm:ss", intervalMs = 1e3, locale) {
+		if (!value) return "";
+		if (value !== this.lastInput || pattern !== this.lastPattern || intervalMs !== this.lastInterval || locale !== this.lastLocale) {
+			this.ngOnDestroy();
+			this.lastInput = value;
+			this.lastPattern = pattern;
+			this.lastInterval = intervalMs;
+			this.lastLocale = locale;
+			const activeLocale = locale || this.globalConfig?.locale;
+			if (value === "now") this.subscription = this.timeGuardService.getCurrentTime(intervalMs).subscribe((now) => {
+				this.latestValue = activeLocale ? now.locale(activeLocale).format(pattern) : now.format(pattern);
+				this.cdr.markForCheck();
+			});
+			else this.subscription = this.timeGuardService.getCurrentTime(intervalMs).subscribe(() => {
+				try {
+					const tg = TimeGuard.from(value);
+					this.latestValue = activeLocale ? tg.locale(activeLocale).format(pattern) : tg.format(pattern);
+					this.cdr.markForCheck();
+				} catch {
+					this.latestValue = String(value);
+				}
+			});
+		}
+		return this.latestValue;
+	}
+	ngOnDestroy() {
+		if (this.subscription) {
+			this.subscription.unsubscribe();
+			this.subscription = void 0;
+		}
+	}
+};
+Pipe({
+	name: "timeGuardFormat",
+	pure: true
+})(TimeGuardFormatPipe);
+Pipe({
+	name: "timeGuardRelative",
+	pure: false
+})(TimeGuardRelativePipe);
+Injectable({ providedIn: "root" })(TimeGuardService);
+Pipe({
+	name: "timeGuardLiveFormat",
+	pure: false
+})(TimeGuardLiveFormatPipe);
+//#endregion
+export { TIME_GUARD_CONFIG, TimeGuardFormatPipe, TimeGuardLiveFormatPipe, TimeGuardRelativePipe, TimeGuardService };

package/dist/angular.d.ts

@@ -0,0 +1,59 @@
+import { PipeTransform, InjectionToken, OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
+import { TimeGuard, FormatPreset, ITimeGuardConfig } from './core';
+/**
+ * Angular Injection Token to register global/default TimeGuard configurations.
+ */
+export declare const TIME_GUARD_CONFIG: InjectionToken<ITimeGuardConfig>;
+/**
+ * Angular Pipe to format a date/time using TimeGuard.
+ * Supports global configuration overrides via DI.
+ * Usage: `{{ date | timeGuardFormat:'YYYY-MM-DD':'es' }}`
+ */
+export declare class TimeGuardFormatPipe implements PipeTransform {
+    private globalConfig;
+    transform(value: unknown, pattern?: string | FormatPreset, locale?: string): string;
+}
+/**
+ * Angular Pipe for dynamic relative time humanization.
+ * Supports global configuration overrides via DI.
+ * Usage: `{{ date | timeGuardRelative:'es':'auto' }}`
+ */
+export declare class TimeGuardRelativePipe implements PipeTransform {
+    private globalConfig;
+    transform(value: unknown, locale?: string, numeric?: 'always' | 'auto'): string;
+}
+/**
+ * Injectable Service to interact with TimeGuard.
+ * Provides a high-performance reactive Observable of the current time
+ * running outside Angular zone to optimize change detection ticks.
+ * Supports global configuration overrides via DI.
+ */
+export declare class TimeGuardService {
+    private ngZone;
+    private globalConfig;
+    /**
+     * Get an Observable of the current time, ticking on the specified interval.
+     */
+    getCurrentTime(intervalMs?: number, config?: ITimeGuardConfig): Observable<TimeGuard>;
+}
+/**
+ * Angular Pipe to dynamically tick and format dates at a custom interval.
+ * Highly optimized, impure pipe utilizing TimeGuardService and ChangeDetectorRef.
+ * Usage:
+ * - Real-time clock: `{{ 'now' | timeGuardLiveFormat:'HH:mm:ss':1000 }}`
+ * - Ticking static date: `{{ date | timeGuardLiveFormat:'YYYY-MM-DD HH:mm:ss':5000 }}`
+ */
+export declare class TimeGuardLiveFormatPipe implements PipeTransform, OnDestroy {
+    private latestValue;
+    private subscription?;
+    private lastInput?;
+    private lastPattern?;
+    private lastInterval?;
+    private lastLocale?;
+    private cdr;
+    private timeGuardService;
+    private globalConfig;
+    transform(value: unknown, pattern?: string | FormatPreset, intervalMs?: number, locale?: string): string;
+    ngOnDestroy(): void;
+}