@bereasoftware/time-guard 2.7.2 → 2.9.0

package/dist/solid/index.es.js

@@ -1,122 +1,42 @@
-/*! time-guard v2.7.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
-import { n as TimeGuard, r as TimeRange } from "../core-DWPXk3rz.js";
-import { createEffect, createSignal, onCleanup } from "solid-js";
+/*! 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, s as n } from "../core-GHK7isoa.js";
+import { createEffect as r, createSignal as i, onCleanup as a } from "solid-js";
 //#region src/solid.ts
-/**
-* TimeGuard — SolidJS Integration
-*
-* Provides reactive signal-based wrappers for TimeGuard using Solid's
-* fine-grained reactivity system. All hooks return signals (`Accessor`)
-* that automatically update without re-rendering the entire component tree.
-*
-* @example
-* ```tsx
-* import { useCurrentTime, useRelativeTime } from '@bereasoftware/time-guard/solid';
-*
-* function Clock() {
-*   const now = useCurrentTime({ interval: 1000 });
-*   const relative = useRelativeTime('2026-05-20T08:00:00');
-*
-*   return (
-*     <div>
-*       <h1>{now().format('HH:mm:ss')}</h1>
-*       <p>Published: {relative()}</p>
-*     </div>
-*   );
-* }
-* ```
-*/
-/**
-* Context key for providing global TimeGuard configuration.
-* Use Solid's `createContext` + `useContext` at the app level.
-*/
-var TimeGuardConfigContext = Symbol("TimeGuardConfig");
-/**
-* Creates a reactive signal of a TimeGuard instance.
-* The signal updates reactively when `input` changes.
-*
-* ```tsx
-* const tg = useTimeGuard('2026-05-20');
-* return <p>{tg().format('dddd, DD MMMM YYYY')}</p>;
-* ```
-*/
-function useTimeGuard(input, config) {
-	const [tg, setTg] = createSignal(TimeGuard.from(input, config));
-	createEffect(() => {
-		const _input = input;
-		setTg(() => TimeGuard.from(_input, config));
-	});
-	return tg;
+var o = Symbol("TimeGuardConfig");
+function s(e) {
+	return typeof e == "function" ? e() : e;
 }
-/**
-* Creates a signal of the current time that ticks on a specified interval
-* (default 1000ms). Clears the interval on cleanup.
-*
-* ```tsx
-* const now = useCurrentTime({ interval: 1000 });
-* return <p>{now().format('HH:mm:ss')}</p>;
-* ```
-*/
-function useCurrentTime(options) {
-	const interval = options?.interval ?? 1e3;
-	const config = options?.config;
-	const [time, setTime] = createSignal(TimeGuard.now(config));
-	const timer = setInterval(() => {
-		setTime(TimeGuard.now(config));
-	}, interval);
-	onCleanup(() => {
-		clearInterval(timer);
-	});
-	return time;
+function c(t, n) {
+	let [a, o] = i(e.from(s(t), n));
+	return r(() => {
+		o(() => e.from(s(t), n));
+	}), a;
 }
-/**
-* Creates a signal of a relative time string that recalculates periodically
-* (default every 60s).
-*
-* ```tsx
-* const relative = useRelativeTime('2026-05-20T08:00:00', { locale: 'es' });
-* return <p>{relative()}</p>;
-* ```
-*/
-function useRelativeTime(date, options) {
-	const interval = options?.interval ?? 6e4;
-	const locale = options?.locale;
-	const numeric = options?.numeric;
-	const compute = () => {
-		const tgDate = TimeGuard.from(date);
-		const now = TimeGuard.now();
-		return tgDate.since(now).humanize({
-			locale,
-			numeric
-		});
-	};
-	const [relative, setRelative] = createSignal(compute());
-	const timer = setInterval(() => {
-		setRelative(compute());
-	}, interval);
-	onCleanup(() => {
-		clearInterval(timer);
-	});
-	return relative;
+function l(t) {
+	let n = t?.interval ?? 1e3, r = t?.config, [o, s] = i(e.now(r)), c = setInterval(() => {
+		s(e.now(r));
+	}, n);
+	return a(() => {
+		clearInterval(c);
+	}), o;
 }
-/**
-* Creates a signal of a TimeRange instance.
-*
-* ```tsx
-* const range = useTimeRange('2026-05-20', '2026-06-01');
-* return <p>Duration: {range().humanize()}</p>;
-* ```
-*/
-function useTimeRange(start, end, config) {
-	const [range, setRange] = createSignal(new TimeRange(TimeGuard.from(start, config), TimeGuard.from(end, config)));
-	createEffect(() => {
-		const _start = start;
-		const _end = end;
-		const startTg = TimeGuard.from(_start, config);
-		const endTg = TimeGuard.from(_end, config);
-		setRange(() => new TimeRange(startTg, endTg));
-	});
-	return range;
+function u(e, n) {
+	let r = n?.interval ?? 6e4, o = n?.locale, s = n?.numeric, c = () => t(e, {
+		locale: o,
+		numeric: s
+	}), [l, u] = i(c()), d = setInterval(() => {
+		u(c());
+	}, r);
+	return a(() => {
+		clearInterval(d);
+	}), l;
+}
+function d(e, t, a) {
+	let [o, s] = i(n(e, t, a));
+	return r(() => {
+		let r = e, i = t;
+		s(() => n(r, i, a));
+	}), o;
 }
 //#endregion
-export { TimeGuardConfigContext, useCurrentTime, useRelativeTime, useTimeGuard, useTimeRange };
+export { o as TimeGuardConfigContext, l as useCurrentTime, u as useRelativeTime, c as useTimeGuard, d as useTimeRange };

package/dist/solid.d.ts

@@ -7,10 +7,13 @@ import { TimeGuard, ITimeGuardConfig, TimeRange } from './core';
 export declare const TimeGuardConfigContext: unique symbol;
 /**
  * Creates a reactive signal of a TimeGuard instance.
- * The signal updates reactively when `input` changes.
+ * The signal updates reactively when `input` changes — pass an Accessor
+ * (e.g. a signal getter) for `input` to make this actually track it; a
+ * plain value is used once and won't update on its own.
  *
  * ```tsx
- * const tg = useTimeGuard('2026-05-20');
+ * const [dateStr, setDateStr] = createSignal('2026-05-20');
+ * const tg = useTimeGuard(dateStr); // note: dateStr, not dateStr()
  * return <p>{tg().format('dddd, DD MMMM YYYY')}</p>;
  * ```
  */

package/dist/svelte/index.cjs

@@ -1,398 +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");
-Array.isArray;
-Array.prototype.indexOf;
-Array.prototype.includes;
-Array.from;
-Array.prototype;
-var noop = () => {};
-/** @param {Array<() => void>} arr */
-function run_all(arr) {
-	for (var i = 0; i < arr.length; i++) arr[i]();
-}
-//#endregion
-//#region node_modules/.pnpm/svelte@5.55.9_@typescript-eslint+types@8.59.4/node_modules/svelte/src/internal/client/constants.js
-var CLEAN = 1024;
-var DIRTY = 2048;
-var MAYBE_DIRTY = 4096;
-/**
-* 'Transparent' effects do not create a transition boundary.
-* This is on a block effect 99% of the time but may also be on a branch effect if its parent block effect was pruned
-*/
-var EFFECT_TRANSPARENT = 65536;
-var EFFECT_PRESERVED = 1 << 19;
-new class StaleReactionError extends Error {
-	name = "StaleReactionError";
-	message = "The reaction that called `getAbortSignal()` was re-run or destroyed";
-}();
-globalThis.document?.contentType;
-//#endregion
-//#region node_modules/.pnpm/svelte@5.55.9_@typescript-eslint+types@8.59.4/node_modules/svelte/src/internal/client/reactivity/equality.js
-/**
-* @param {unknown} a
-* @param {unknown} b
-* @returns {boolean}
-*/
-function safe_not_equal(a, b) {
-	return a != a ? b == b : a !== b || a !== null && typeof a === "object" || typeof a === "function";
-}
-~(DIRTY | MAYBE_DIRTY | CLEAN);
-//#endregion
-//#region node_modules/.pnpm/svelte@5.55.9_@typescript-eslint+types@8.59.4/node_modules/svelte/src/store/utils.js
-/** @import { Readable } from './public' */
-/**
-* @template T
-* @param {Readable<T> | null | undefined} store
-* @param {(value: T) => void} run
-* @param {(value: T) => void} [invalidate]
-* @returns {() => void}
-*/
-function subscribe_to_store(store, run, invalidate) {
-	if (store == null) {
-		run(void 0);
-		if (invalidate) invalidate(void 0);
-		return noop;
-	}
-	const unsub = untrack(() => store.subscribe(run, invalidate));
-	return unsub.unsubscribe ? () => unsub.unsubscribe() : unsub;
-}
-//#endregion
-//#region node_modules/.pnpm/svelte@5.55.9_@typescript-eslint+types@8.59.4/node_modules/svelte/src/store/shared/index.js
-/** @import { Readable, StartStopNotifier, Subscriber, Unsubscriber, Updater, Writable } from '../public.js' */
-/** @import { Stores, StoresValues, SubscribeInvalidateTuple } from '../private.js' */
-/**
-* @type {Array<SubscribeInvalidateTuple<any> | any>}
-*/
-var subscriber_queue = [];
-/**
-* Creates a `Readable` store that allows reading by subscription.
-*
-* @template T
-* @param {T} [value] initial value
-* @param {StartStopNotifier<T>} [start]
-* @returns {Readable<T>}
-*/
-function readable(value, start) {
-	return { subscribe: writable(value, start).subscribe };
-}
-/**
-* Create a `Writable` store that allows both updating and reading by subscription.
-*
-* @template T
-* @param {T} [value] initial value
-* @param {StartStopNotifier<T>} [start]
-* @returns {Writable<T>}
-*/
-function writable(value, start = noop) {
-	/** @type {Unsubscriber | null} */
-	let stop = null;
-	/** @type {Set<SubscribeInvalidateTuple<T>>} */
-	const subscribers = /* @__PURE__ */ new Set();
-	/**
-	* @param {T} new_value
-	* @returns {void}
-	*/
-	function set(new_value) {
-		if (safe_not_equal(value, new_value)) {
-			value = new_value;
-			if (stop) {
-				const run_queue = !subscriber_queue.length;
-				for (const subscriber of subscribers) {
-					subscriber[1]();
-					subscriber_queue.push(subscriber, value);
-				}
-				if (run_queue) {
-					for (let i = 0; i < subscriber_queue.length; i += 2) subscriber_queue[i][0](subscriber_queue[i + 1]);
-					subscriber_queue.length = 0;
-				}
-			}
-		}
-	}
-	/**
-	* @param {Updater<T>} fn
-	* @returns {void}
-	*/
-	function update(fn) {
-		set(fn(value));
-	}
-	/**
-	* @param {Subscriber<T>} run
-	* @param {() => void} [invalidate]
-	* @returns {Unsubscriber}
-	*/
-	function subscribe(run, invalidate = noop) {
-		/** @type {SubscribeInvalidateTuple<T>} */
-		const subscriber = [run, invalidate];
-		subscribers.add(subscriber);
-		if (subscribers.size === 1) stop = start(set, update) || noop;
-		run(value);
-		return () => {
-			subscribers.delete(subscriber);
-			if (subscribers.size === 0 && stop) {
-				stop();
-				stop = null;
-			}
-		};
-	}
-	return {
-		set,
-		update,
-		subscribe
-	};
-}
-/**
-* Derived value store by synchronizing one or more readable stores and
-* applying an aggregation function over its input values.
-*
-* @template {Stores} S
-* @template T
-* @overload
-* @param {S} stores
-* @param {(values: StoresValues<S>, set: (value: T) => void, update: (fn: Updater<T>) => void) => Unsubscriber | void} fn
-* @param {T} [initial_value]
-* @returns {Readable<T>}
-*/
-/**
-* Derived value store by synchronizing one or more readable stores and
-* applying an aggregation function over its input values.
-*
-* @template {Stores} S
-* @template T
-* @overload
-* @param {S} stores
-* @param {(values: StoresValues<S>) => T} fn
-* @param {T} [initial_value]
-* @returns {Readable<T>}
-*/
-/**
-* @template {Stores} S
-* @template T
-* @param {S} stores
-* @param {Function} fn
-* @param {T} [initial_value]
-* @returns {Readable<T>}
-*/
-function derived(stores, fn, initial_value) {
-	const single = !Array.isArray(stores);
-	/** @type {Array<Readable<any>>} */
-	const stores_array = single ? [stores] : stores;
-	if (!stores_array.every(Boolean)) throw new Error("derived() expects stores as input, got a falsy value");
-	const auto = fn.length < 2;
-	return readable(initial_value, (set, update) => {
-		let started = false;
-		/** @type {T[]} */
-		const values = [];
-		let pending = 0;
-		let cleanup = noop;
-		const sync = () => {
-			if (pending) return;
-			cleanup();
-			const result = fn(single ? values[0] : values, set, update);
-			if (auto) set(result);
-			else cleanup = typeof result === "function" ? result : noop;
-		};
-		const unsubscribers = stores_array.map((store, i) => subscribe_to_store(store, (value) => {
-			values[i] = value;
-			pending &= ~(1 << i);
-			if (started) sync();
-		}, () => {
-			pending |= 1 << i;
-		}));
-		started = true;
-		sync();
-		return function stop() {
-			run_all(unsubscribers);
-			cleanup();
-			started = false;
-		};
-	});
-}
-EFFECT_TRANSPARENT | EFFECT_PRESERVED;
-//#endregion
-//#region node_modules/.pnpm/svelte@5.55.9_@typescript-eslint+types@8.59.4/node_modules/svelte/src/internal/client/runtime.js
-var untracking = false;
-/**
-* When used inside a [`$derived`](https://svelte.dev/docs/svelte/$derived) or [`$effect`](https://svelte.dev/docs/svelte/$effect),
-* any state read inside `fn` will not be treated as a dependency.
-*
-* ```ts
-* $effect(() => {
-*   // this will run when `data` changes, but not when `time` changes
-*   save(data, {
-*     timestamp: untrack(() => time)
-*   });
-* });
-* ```
-* @template T
-* @param {() => T} fn
-* @returns {T}
-*/
-function untrack(fn) {
-	var previous_untracking = untracking;
-	try {
-		untracking = true;
-		return fn();
-	} finally {
-		untracking = previous_untracking;
-	}
-}
-//#endregion
-//#region src/svelte.ts
-/**
-* TimeGuard — Svelte 5 Integration
-*
-* Provides reactive stores and lifecycle-managed wrappers for TimeGuard.
-* Compatible with both Svelte 4 (`$store` auto-subscription) and
-* Svelte 5 (`$state` + `get()` from stores).
-*
-* @example
-* ```svelte
-* <script lang="ts">
-*   import { useCurrentTime, useRelativeTime } from '@bereasoftware/time-guard/svelte';
-*
-*   const now = useCurrentTime({ interval: 1000 });
-*   const relative = useRelativeTime('2026-05-20T08:00:00');
-* <\/script>
-*
-* <h1>{$now.format('HH:mm:ss')}</h1>
-* <p>Published: {$relative}</p>
-* ```
-*/
-/**
-* Duck-type check: is this a Svelte store (has `subscribe`)?
-*/
-function isStore(val) {
-	return typeof val === "object" && val !== null && "subscribe" in val && typeof val.subscribe === "function";
-}
-/**
-* Coerce a plain value or a store into a Readable store.
-*/
-function toStore(val) {
-	return isStore(val) ? val : readable(val);
-}
-/**
-* Injection-key symbol to retrieve a global TimeGuard configuration
-* provided at the app root. Consumers use `getContext(TimeGuardConfigKey)`.
-*/
-var TimeGuardConfigKey = Symbol("TimeGuardConfig");
-/**
-* Creates a reactive readable store of a TimeGuard instance.
-* Automatically updates when `input` changes (supports both plain values
-* and Svelte stores as input — pass a `Readable` for full reactivity).
-* Integrates global config from `getContext(TimeGuardConfigKey)` as fallback.
-*
-* ```svelte
-* <script>
-*   import { writable } from 'svelte/store';
-*   import { useTimeGuard } from '@bereasoftware/time-guard/svelte';
-*   import { TimeGuard } from '@bereasoftware/time-guard';
-*
-*   // Static input — no reactivity needed
-*   const tg = useTimeGuard('2026-05-20');
-*
-*   // Reactive input — pass a store
-*   const dateStore = writable('2026-05-20');
-*   const tg2 = useTimeGuard(dateStore);
-* <\/script>
-*
-* <p>{$tg.format('dddd, DD MMMM YYYY')}</p>
-* <p>{$tg2.format('dddd, DD MMMM YYYY')}</p>
-* ```
-*/
-function useTimeGuard(input, config) {
-	if (isStore(input)) return derived(input, ($val) => require_core.TimeGuard.from($val, config));
-	return readable(require_core.TimeGuard.from(input, config));
-}
-/**
-* Creates a readable store of the current time that ticks on a specified
-* interval (default 1000ms). Automatically clears the interval on
-* component destroy.
-*
-* ```svelte
-* <script>
-*   import { useCurrentTime } from '@bereasoftware/time-guard/svelte';
-*   const now = useCurrentTime({ interval: 1000 });
-* <\/script>
-* <p>{$now.format('HH:mm:ss')}</p>
-* ```
-*/
-function useCurrentTime(options) {
-	const interval = options?.interval ?? 1e3;
-	const config = options?.config;
-	const store = writable(require_core.TimeGuard.now(config), () => {
-		const timer = setInterval(() => {
-			store.set(require_core.TimeGuard.now(config));
-		}, interval);
-		return () => {
-			clearInterval(timer);
-		};
-	});
-	return { subscribe: store.subscribe };
-}
-/**
-* Creates a readable store of a relative time string that recalculates
-* periodically (default every 60s).
-*
-* ```svelte
-* <script>
-*   import { useRelativeTime } from '@bereasoftware/time-guard/svelte';
-*   const relative = useRelativeTime('2026-05-20T08:00:00', { locale: 'es' });
-* <\/script>
-* <p>{$relative}</p>
-* ```
-*/
-function useRelativeTime(date, options) {
-	const interval = options?.interval ?? 6e4;
-	const locale = options?.locale;
-	const numeric = options?.numeric;
-	const compute = () => {
-		const tgDate = require_core.TimeGuard.from(date);
-		const now = require_core.TimeGuard.now();
-		return tgDate.since(now).humanize({
-			locale,
-			numeric
-		});
-	};
-	const store = writable(compute(), () => {
-		const timer = setInterval(() => {
-			store.set(compute());
-		}, interval);
-		return () => {
-			clearInterval(timer);
-		};
-	});
-	return { subscribe: store.subscribe };
-}
-/**
-* Creates a readable store of a TimeRange instance.
-* Recalculates reactively when `start` or `end` change (supports both
-* plain values and Svelte stores).
-*
-* ```svelte
-* <script>
-*   import { writable } from 'svelte/store';
-*   import { useTimeRange } from '@bereasoftware/time-guard/svelte';
-*
-*   // Static range
-*   const range = useTimeRange('2026-05-20', '2026-06-01');
-*
-*   // Reactive range
-*   const start = writable('2026-05-20');
-*   const end = writable('2026-06-01');
-*   const range2 = useTimeRange(start, end);
-* <\/script>
-*
-* <p>Duration: {$range.toDuration().humanize()}</p>
-*/
-function useTimeRange(start, end, config) {
-	return derived([toStore(start), toStore(end)], ([$start, $end]) => {
-		return new require_core.TimeRange(require_core.TimeGuard.from($start, config), require_core.TimeGuard.from($end, config));
-	});
-}
-//#endregion
-exports.TimeGuardConfigKey = TimeGuardConfigKey;
-exports.useCurrentTime = useCurrentTime;
-exports.useRelativeTime = useRelativeTime;
-exports.useTimeGuard = useTimeGuard;
-exports.useTimeRange = useTimeRange;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../core-BDQnStek.cjs");Array.isArray,Array.prototype.indexOf,Array.prototype.includes,Array.from,Array.prototype;var t=()=>{};function n(e){for(var t=0;t<e.length;t++)e[t]()}var r=1024,i=2048,a=4096,o=65536,s=1<<19;new class extends Error{name=`StaleReactionError`;message="The reaction that called `getAbortSignal()` was re-run or destroyed"},globalThis.document?.contentType;function c(e,t){return e==e?e!==t||typeof e==`object`&&!!e||typeof e==`function`:t==t}~(i|a|r);function l(e,n,r){if(e==null)return n(void 0),r&&r(void 0),t;let i=h(()=>e.subscribe(n,r));return i.unsubscribe?()=>i.unsubscribe():i}var u=[];function d(e,t){return{subscribe:f(e,t).subscribe}}function f(e,n=t){let r=null,i=new Set;function a(t){if(c(e,t)&&(e=t,r)){let t=!u.length;for(let t of i)t[1](),u.push(t,e);if(t){for(let e=0;e<u.length;e+=2)u[e][0](u[e+1]);u.length=0}}}function o(t){a(t(e))}function s(s,c=t){let l=[s,c];return i.add(l),i.size===1&&(r=n(a,o)||t),s(e),()=>{i.delete(l),i.size===0&&r&&(r(),r=null)}}return{set:a,update:o,subscribe:s}}function p(e,r,i){let a=!Array.isArray(e),o=a?[e]:e;if(!o.every(Boolean))throw Error(`derived() expects stores as input, got a falsy value`);let s=r.length<2;return d(i,(e,i)=>{let c=!1,u=[],d=0,f=t,p=()=>{if(d)return;f();let n=r(a?u[0]:u,e,i);s?e(n):f=typeof n==`function`?n:t},m=o.map((e,t)=>l(e,e=>{u[t]=e,d&=~(1<<t),c&&p()},()=>{d|=1<<t}));return c=!0,p(),function(){n(m),f(),c=!1}})}o|s;var m=!1;function h(e){var t=m;try{return m=!0,e()}finally{m=t}}function g(e){return typeof e==`object`&&!!e&&`subscribe`in e&&typeof e.subscribe==`function`}function _(e){return g(e)?e:d(e)}var v=Symbol(`TimeGuardConfig`);function y(t,n){return g(t)?p(t,t=>e.i.from(t,n)):d(e.i.from(t,n))}function b(t){let n=t?.interval??1e3,r=t?.config,i=f(e.i.now(r),()=>{let t=setInterval(()=>{i.set(e.i.now(r))},n);return()=>{clearInterval(t)}});return{subscribe:i.subscribe}}function x(t,n){let r=n?.interval??6e4,i=n?.locale,a=n?.numeric,o=()=>e.o(t,{locale:i,numeric:a}),s=f(o(),()=>{let e=setInterval(()=>{s.set(o())},r);return()=>{clearInterval(e)}});return{subscribe:s.subscribe}}function S(t,n,r){return p([_(t),_(n)],([t,n])=>e.s(t,n,r))}exports.TimeGuardConfigKey=v,exports.useCurrentTime=b,exports.useRelativeTime=x,exports.useTimeGuard=y,exports.useTimeRange=S;