@timekeeper-countdown/core 0.3.1 → 0.3.2

package/dist/{countdown-engine-DEKF_8iT.d.cts → countdown-snapshot-D0tGjU62.d.cts}

@@ -1,13 +1,3 @@
-/**
- * Time providers with fallbacks for critical APIs
- * Ensures the library works even without modern browser APIs
- */
-interface TimeProvider {
-    now(): number;
-    isHighResolution: boolean;
-    type: string;
-}
-
 declare const TimerState: Readonly<{
     IDLE: "IDLE";
     RUNNING: "RUNNING";
@@ -63,28 +53,5 @@ interface CountdownSnapshot {
     isRunning: boolean;
     isCompleted: boolean;
 }
-interface CountdownSubscription {
-    unsubscribe: () => void;
-}
-interface CountdownEngineOptions {
-    onSnapshot?: (snapshot: CountdownSnapshot) => void;
-    onStateChange?: (state: TimerState, snapshot: CountdownSnapshot) => void;
-    onError?: (error: Error) => void;
-    timeProvider?: TimeProvider | (() => number);
-    tickIntervalMs?: number;
-}
-interface CountdownEngineInstance {
-    start: () => boolean;
-    pause: () => boolean;
-    resume: () => boolean;
-    reset: (nextInitialSeconds?: number) => boolean;
-    stop: () => boolean;
-    setSeconds: (seconds: number) => void;
-    getSnapshot: () => CountdownSnapshot;
-    subscribe: (listener: (snapshot: CountdownSnapshot) => void) => CountdownSubscription;
-    destroy: () => void;
-}
-declare function buildSnapshot(initialSeconds: number, totalSeconds: number, state: TimerState): CountdownSnapshot;
-declare function CountdownEngine(initialSecondsInput: number, options?: CountdownEngineOptions): CountdownEngineInstance;
 
-export { type CountdownSnapshot as C, TimerState as T, CountdownEngine as a, buildSnapshot as b, type CountdownEngineInstance as c, type CountdownEngineOptions as d, type CountdownParts as e, type TimeProvider as f };
+export { type CountdownSnapshot as C, TimerState as T, type CountdownParts as a };

package/dist/{countdown-engine-DEKF_8iT.d.ts → countdown-snapshot-D0tGjU62.d.ts}

@@ -1,13 +1,3 @@
-/**
- * Time providers with fallbacks for critical APIs
- * Ensures the library works even without modern browser APIs
- */
-interface TimeProvider {
-    now(): number;
-    isHighResolution: boolean;
-    type: string;
-}
-
 declare const TimerState: Readonly<{
     IDLE: "IDLE";
     RUNNING: "RUNNING";
@@ -63,28 +53,5 @@ interface CountdownSnapshot {
     isRunning: boolean;
     isCompleted: boolean;
 }
-interface CountdownSubscription {
-    unsubscribe: () => void;
-}
-interface CountdownEngineOptions {
-    onSnapshot?: (snapshot: CountdownSnapshot) => void;
-    onStateChange?: (state: TimerState, snapshot: CountdownSnapshot) => void;
-    onError?: (error: Error) => void;
-    timeProvider?: TimeProvider | (() => number);
-    tickIntervalMs?: number;
-}
-interface CountdownEngineInstance {
-    start: () => boolean;
-    pause: () => boolean;
-    resume: () => boolean;
-    reset: (nextInitialSeconds?: number) => boolean;
-    stop: () => boolean;
-    setSeconds: (seconds: number) => void;
-    getSnapshot: () => CountdownSnapshot;
-    subscribe: (listener: (snapshot: CountdownSnapshot) => void) => CountdownSubscription;
-    destroy: () => void;
-}
-declare function buildSnapshot(initialSeconds: number, totalSeconds: number, state: TimerState): CountdownSnapshot;
-declare function CountdownEngine(initialSecondsInput: number, options?: CountdownEngineOptions): CountdownEngineInstance;
 
-export { type CountdownSnapshot as C, TimerState as T, CountdownEngine as a, buildSnapshot as b, type CountdownEngineInstance as c, type CountdownEngineOptions as d, type CountdownParts as e, type TimeProvider as f };
+export { type CountdownSnapshot as C, TimerState as T, type CountdownParts as a };

package/dist/format.cjs

@@ -1 +1 @@
-'use strict';function l(t){let a=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,o=a,s=Math.floor(o/31536e3);o-=s*31536e3;let m=Math.floor(o/604800);o-=m*604800;let u=Math.floor(o/86400);o-=u*86400;let f=Math.floor(o/3600);o-=f*3600;let i=Math.floor(o/60);return o-=i*60,{years:s,weeks:m,days:u,hours:f,minutes:i,seconds:o,totalDays:Math.floor(a/86400),totalHours:Math.floor(a/3600),totalMinutes:Math.floor(a/60)}}function S(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function F(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function n(t,a=2){return t.toString().padStart(a,"0")}function x(){let t=r=>l(S(F(r)));return {formatTime:r=>{let c=t(r);return {minutes:n(c.totalMinutes),seconds:n(c.seconds)}},formatMinutes:r=>n(t(r).minutes),formatSeconds:r=>n(t(r).seconds),formatHours:r=>n(t(r).hours),formatDays:r=>n(t(r).days),formatWeeks:r=>n(t(r).weeks),formatYears:r=>n(t(r).years)}}var e=x();function M(t){return e.formatTime(t)}function h(t){return e.formatMinutes(t)}function y(t){return e.formatSeconds(t)}function E(t){return e.formatHours(t)}function k(t){return e.formatDays(t)}function C(t){return e.formatWeeks(t)}function w(t){return e.formatYears(t)}exports.Formatter=x;exports.defaultFormatter=e;exports.formatDays=k;exports.formatHours=E;exports.formatMinutes=h;exports.formatSeconds=y;exports.formatTime=M;exports.formatWeeks=C;exports.formatYears=w;
+'use strict';function l(t){let a=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,o=a,s=Math.floor(o/31536e3);o-=s*31536e3;let m=Math.floor(o/604800);o-=m*604800;let u=Math.floor(o/86400);o-=u*86400;let f=Math.floor(o/3600);o-=f*3600;let i=Math.floor(o/60);return o-=i*60,{years:s,weeks:m,days:u,hours:f,minutes:i,seconds:o,totalDays:Math.floor(a/86400),totalHours:Math.floor(a/3600),totalMinutes:Math.floor(a/60)}}function S(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function F(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function n(t,a=2){return t.toString().padStart(a,"0")}function x(){let t=r=>l(S(F(r)));return {formatTime:r=>{let c=t(r);return {minutes:n(c.totalMinutes),seconds:n(c.seconds)}},formatMinutes:r=>n(t(r).minutes),formatSeconds:r=>n(t(r).seconds),formatHours:r=>n(t(r).hours),formatDays:r=>n(t(r).days),formatWeeks:r=>n(t(r).weeks),formatYears:r=>n(t(r).years)}}var e=x();function h(t){return e.formatTime(t)}function M(t){return e.formatMinutes(t)}function y(t){return e.formatSeconds(t)}function E(t){return e.formatHours(t)}function k(t){return e.formatDays(t)}function C(t){return e.formatWeeks(t)}function w(t){return e.formatYears(t)}exports.Formatter=x;exports.defaultFormatter=e;exports.formatDays=k;exports.formatHours=E;exports.formatMinutes=M;exports.formatSeconds=y;exports.formatTime=h;exports.formatWeeks=C;exports.formatYears=w;

package/dist/format.d.cts

@@ -1,4 +1,4 @@
-import { C as CountdownSnapshot } from './countdown-engine-DEKF_8iT.cjs';
+import { C as CountdownSnapshot } from './countdown-snapshot-D0tGjU62.cjs';
 
 type FormatTarget = number | Pick<CountdownSnapshot, 'totalSeconds'> | null | undefined;
 declare function Formatter(): {

package/dist/format.d.ts

@@ -1,4 +1,4 @@
-import { C as CountdownSnapshot } from './countdown-engine-DEKF_8iT.js';
+import { C as CountdownSnapshot } from './countdown-snapshot-D0tGjU62.js';
 
 type FormatTarget = number | Pick<CountdownSnapshot, 'totalSeconds'> | null | undefined;
 declare function Formatter(): {

package/dist/format.js

@@ -1 +1 @@
-function l(t){let a=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,o=a,s=Math.floor(o/31536e3);o-=s*31536e3;let m=Math.floor(o/604800);o-=m*604800;let u=Math.floor(o/86400);o-=u*86400;let f=Math.floor(o/3600);o-=f*3600;let i=Math.floor(o/60);return o-=i*60,{years:s,weeks:m,days:u,hours:f,minutes:i,seconds:o,totalDays:Math.floor(a/86400),totalHours:Math.floor(a/3600),totalMinutes:Math.floor(a/60)}}function S(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function F(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function n(t,a=2){return t.toString().padStart(a,"0")}function x(){let t=r=>l(S(F(r)));return {formatTime:r=>{let c=t(r);return {minutes:n(c.totalMinutes),seconds:n(c.seconds)}},formatMinutes:r=>n(t(r).minutes),formatSeconds:r=>n(t(r).seconds),formatHours:r=>n(t(r).hours),formatDays:r=>n(t(r).days),formatWeeks:r=>n(t(r).weeks),formatYears:r=>n(t(r).years)}}var e=x();function M(t){return e.formatTime(t)}function h(t){return e.formatMinutes(t)}function y(t){return e.formatSeconds(t)}function E(t){return e.formatHours(t)}function k(t){return e.formatDays(t)}function C(t){return e.formatWeeks(t)}function w(t){return e.formatYears(t)}export{x as Formatter,e as defaultFormatter,k as formatDays,E as formatHours,h as formatMinutes,y as formatSeconds,M as formatTime,C as formatWeeks,w as formatYears};
+function l(t){let a=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,o=a,s=Math.floor(o/31536e3);o-=s*31536e3;let m=Math.floor(o/604800);o-=m*604800;let u=Math.floor(o/86400);o-=u*86400;let f=Math.floor(o/3600);o-=f*3600;let i=Math.floor(o/60);return o-=i*60,{years:s,weeks:m,days:u,hours:f,minutes:i,seconds:o,totalDays:Math.floor(a/86400),totalHours:Math.floor(a/3600),totalMinutes:Math.floor(a/60)}}function S(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function F(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function n(t,a=2){return t.toString().padStart(a,"0")}function x(){let t=r=>l(S(F(r)));return {formatTime:r=>{let c=t(r);return {minutes:n(c.totalMinutes),seconds:n(c.seconds)}},formatMinutes:r=>n(t(r).minutes),formatSeconds:r=>n(t(r).seconds),formatHours:r=>n(t(r).hours),formatDays:r=>n(t(r).days),formatWeeks:r=>n(t(r).weeks),formatYears:r=>n(t(r).years)}}var e=x();function h(t){return e.formatTime(t)}function M(t){return e.formatMinutes(t)}function y(t){return e.formatSeconds(t)}function E(t){return e.formatHours(t)}function k(t){return e.formatDays(t)}function C(t){return e.formatWeeks(t)}function w(t){return e.formatYears(t)}export{x as Formatter,e as defaultFormatter,k as formatDays,E as formatHours,M as formatMinutes,y as formatSeconds,h as formatTime,C as formatWeeks,w as formatYears};

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';function W(){return {now:()=>performance.now(),isHighResolution:true,type:"performance"}}function X(){return {now:()=>Date.now(),isHighResolution:false,type:"date"}}function y(){let t,o=X();function n(){try{if(typeof performance<"u"&&typeof performance.now=="function"){let e=performance.now();if(typeof e=="number"&&Number.isFinite(e)&&!isNaN(e)&&e>=0&&e<=Number.MAX_SAFE_INTEGER){t=W();return}}throw new Error("performance.now() not available or invalid")}catch{t=o;}}return n(),{now:()=>{try{let e=t.now();if(typeof e=="number"&&Number.isFinite(e)&&!isNaN(e)&&e>=0&&e<=Number.MAX_SAFE_INTEGER)return e;throw new Error("Invalid time value returned")}catch{t!==o&&(t=o);try{let e=o.now();if(typeof e=="number"&&Number.isFinite(e)&&!isNaN(e)&&e>=0)return e}catch{}return 0}},get isHighResolution(){return t.isHighResolution},get type(){return t.type}}}function k(t,o=0){let n=typeof o=="number"&&Number.isFinite(o)&&o>=0?o:0;return ()=>{let e=t();return typeof e!="number"||!Number.isFinite(e)||e<n||(n=e),n}}y();var z=10,j=100;function B(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?j:Math.max(z,Math.floor(t))}function A(t,o,n={}){if(typeof t!="number"||!Number.isFinite(t))throw new Error("initialSeconds must be a finite number");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");let e=Math.floor(Math.max(0,t)),s=null,a=null,u=0,c=e,i=e,S=B(n.tickIntervalMs),g=y(),f=n.timeProvider??(()=>g.now()),l=()=>setInterval(()=>{try{if(a===null)return;let h=f()-a-u,D=Math.floor(h/1e3),r=Number.isFinite(D)?Math.min(i,Math.max(0,i-D)):i;e=r,r!==c&&(c=r,o.onTick(r)),r===0&&(d(),o.onComplete());}catch(p){d(),o.onError(p instanceof Error?p:new Error(String(p)));}},S),N=()=>{if(s||e<=0)return  false;try{if(a!==null&&e<i){let p=(i-e)*1e3;u=f()-a-p;}else a=f(),u=0,c=e;return s=l(),!0}catch(p){return o.onError(p instanceof Error?p:new Error(String(p))),false}},d=()=>{s&&(clearInterval(s),s=null);},b=()=>{d(),e=i,a=null,u=0,c=i;},v=p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));e=h,a=null,u=0,c=h;};return {start:N,stop:d,reset:b,setSeconds:v,setInitialValue:p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));i=h,v(h);},getTotalSeconds:()=>e,getInitialValue:()=>i,isRunning:()=>s!==null,destroy:()=>{d(),e=0,a=null,u=0;}}}var m=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"}),I={[m.IDLE]:{start:m.RUNNING},[m.RUNNING]:{pause:m.PAUSED,reset:m.IDLE,stop:m.STOPPED,complete:m.STOPPED},[m.PAUSED]:{resume:m.RUNNING,reset:m.IDLE,stop:m.STOPPED},[m.STOPPED]:{reset:m.IDLE}};function O(t){if(t!==void 0){if(typeof t!="object"||t===null)throw new Error("events must be an object");if(t.onStateChange!==void 0&&typeof t.onStateChange!="function")throw new Error("events.onStateChange must be a function")}let o=m.IDLE;function n(g){let f=I[o]?.[g];if(!f)return  false;o=f;try{t?.onStateChange?.(f);}catch{}return  true}function e(){return n("start")}function s(){return n("resume")}function a(){return n("pause")}function u(){return n("reset")}function c(){return n("stop")}function i(){return n("complete")}function S(){o===m.IDLE||o===m.STOPPED||n("stop");}return {start:e,resume:s,pause:a,reset:u,stop:c,complete:i,getCurrentState:()=>o,canStart:()=>!!I[o]?.start,canResume:()=>!!I[o]?.resume,canPause:()=>!!I[o]?.pause,isRunning:()=>o===m.RUNNING,destroy:S}}function x(t){let o=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,n=o,e=Math.floor(n/31536e3);n-=e*31536e3;let s=Math.floor(n/604800);n-=s*604800;let a=Math.floor(n/86400);n-=a*86400;let u=Math.floor(n/3600);n-=u*3600;let c=Math.floor(n/60);return n-=c*60,{years:e,weeks:s,days:a,hours:u,minutes:c,seconds:n,totalDays:Math.floor(o/86400),totalHours:Math.floor(o/3600),totalMinutes:Math.floor(o/60)}}function C(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function R(t){if(typeof t!="number"||!Number.isFinite(t)||!Number.isInteger(t))throw new Error("initialSeconds must be a finite, non-negative integer");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");return t}function J(t){let o;if(t)if(typeof t=="function")o=t;else if(typeof t.now=="function"){let n=t;o=()=>n.now();}else throw new Error("timeProvider must implement a now(): number method");else {let n=y();o=()=>n.now();}return k(o)}function P(t,o,n){let e=C(t),s=C(o),a=x(s);return {initialSeconds:e,totalSeconds:s,parts:a,state:n,isRunning:n===m.RUNNING,isCompleted:s===0&&n===m.STOPPED}}function F(t,o={}){let n=R(t),e=J(o.timeProvider),s=n,a=P(n,n,m.IDLE),u=new Set,c=r=>{try{o.onSnapshot?.(r);}catch{}for(let w of u)try{w(r);}catch{}},i=r=>{let w=r===m.STOPPED?0:l.getTotalSeconds();a=P(s,w,r);try{o.onStateChange?.(r,a);}catch{}c(a);},S=r=>{a=P(s,r,f.getCurrentState()),c(a);},g=r=>{try{o.onError?.(r);}catch{}},f=O({onStateChange:r=>{i(r);}}),l=A(n,{onTick:r=>{S(r);},onComplete:()=>{f.complete();},onError:r=>{g(r),f.stop();}},{timeProvider:e,tickIntervalMs:o.tickIntervalMs});return {start:()=>{if(!f.canStart())return  false;let r=l.start();return r&&f.start(),r},pause:()=>f.canPause()?(l.stop(),f.pause()):false,resume:()=>{if(!f.canResume())return  false;let r=l.start();return r&&f.resume(),r},reset:r=>{if(l.stop(),typeof r=="number"){let _=R(r);s=_,l.setInitialValue(_);}else s=n,l.reset();return f.reset()||S(l.getTotalSeconds()),true},stop:()=>{l.stop();let r=f.stop();return r&&l.setSeconds(0),r},setSeconds:r=>{let w=R(r);l.setSeconds(w),S(l.getTotalSeconds());},getSnapshot:()=>a,subscribe:r=>{u.add(r);try{r(a);}catch{}return {unsubscribe:()=>{u.delete(r);}}},destroy:()=>{l.destroy(),f.destroy(),u.clear(),a=P(s,0,m.STOPPED);}}}function Q(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function T(t,o=2){return t.toString().padStart(o,"0")}function M(){let t=i=>x(C(Q(i)));return {formatTime:i=>{let S=t(i);return {minutes:T(S.totalMinutes),seconds:T(S.seconds)}},formatMinutes:i=>T(t(i).minutes),formatSeconds:i=>T(t(i).seconds),formatHours:i=>T(t(i).hours),formatDays:i=>T(t(i).days),formatWeeks:i=>T(t(i).weeks),formatYears:i=>T(t(i).years)}}var E=M();function Z(t){return E.formatTime(t)}function $(t){return E.formatMinutes(t)}function tt(t){return E.formatSeconds(t)}function et(t){return E.formatHours(t)}function nt(t){return E.formatDays(t)}function ot(t){return E.formatWeeks(t)}function rt(t){return E.formatYears(t)}function it(t,o={}){let{onSnapshot:n,onStateChange:e,onError:s}=o;if(n!==void 0&&typeof n!="function")throw new Error("onSnapshot must be a function");if(e!==void 0&&typeof e!="function")throw new Error("onStateChange must be a function");if(s!==void 0&&typeof s!="function")throw new Error("onError must be a function");let a=M(),u=F(t,{onError:s}),c=u.getSnapshot(),i=c.state,S=Number.NaN,g=d=>{if(s)try{s(d);}catch{}},f=d=>{if(n)try{n(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},l=d=>{if(e)try{e(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},N=u.subscribe(d=>{c=d,d.state!==i&&(i=d.state,l(d.state)),d.totalSeconds!==S&&(S=d.totalSeconds,f(d));});return {start:()=>{u.start();},pause:()=>{u.pause();},resume:()=>{u.resume();},reset:d=>{u.reset(d);},stop:()=>{u.stop();},getSeconds:()=>a.formatSeconds(c.totalSeconds),getMinutes:()=>a.formatMinutes(c.totalSeconds),getHours:()=>a.formatHours(c.totalSeconds),getDays:()=>a.formatDays(c.totalSeconds),getWeeks:()=>a.formatWeeks(c.totalSeconds),getYears:()=>a.formatYears(c.totalSeconds),getCurrentState:()=>c.state,getSnapshot:()=>c,destroy:()=>{try{N.unsubscribe();}finally{u.destroy();}}}}exports.Countdown=it;exports.CountdownEngine=F;exports.Formatter=M;exports.TimerState=m;exports.buildSnapshot=P;exports.defaultFormatter=E;exports.formatDays=nt;exports.formatHours=et;exports.formatMinutes=$;exports.formatSeconds=tt;exports.formatTime=Z;exports.formatWeeks=ot;exports.formatYears=rt;
+'use strict';function V(){return {now:()=>performance.now(),isHighResolution:true,type:"performance"}}function X(){return {now:()=>Date.now(),isHighResolution:false,type:"date"}}function R(t){return Number.isFinite(t)&&t>=0&&t<=Number.MAX_SAFE_INTEGER}function y(){let t,n=X();function e(){try{if(typeof performance<"u"&&typeof performance.now=="function"){let r=performance.now();if(R(r)){t=V();return}}throw new Error("performance.now() not available or invalid")}catch{t=n;}}return e(),{now:()=>{try{let r=t.now();if(R(r))return r;throw new Error("Invalid time value returned")}catch{t!==n&&(t=n);try{let r=n.now();if(R(r))return r}catch{}return 0}},get isHighResolution(){return t.isHighResolution},get type(){return t.type}}}function A(t,n=0){let e=typeof n=="number"&&Number.isFinite(n)&&n>=0?n:0;return ()=>{let r=t();return typeof r!="number"||!Number.isFinite(r)||r<e||(e=r),e}}y();var j=10,B=100;function K(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?B:Math.max(j,Math.floor(t))}function O(t,n,e={}){if(typeof t!="number"||!Number.isFinite(t))throw new Error("initialSeconds must be a finite number");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");let r=Math.floor(Math.max(0,t)),a=null,s=null,u=0,c=r,i=r,S=K(e.tickIntervalMs),g=y(),f=e.timeProvider??(()=>g.now()),l=()=>setInterval(()=>{try{if(s===null)return;let h=f()-s-u,D=Math.floor(h/1e3),o=Number.isFinite(D)?Math.min(i,Math.max(0,i-D)):i;r=o,o!==c&&(c=o,n.onTick(o)),o===0&&(d(),n.onComplete());}catch(p){d(),n.onError(p instanceof Error?p:new Error(String(p)));}},S),I=()=>{if(a||r<=0)return  false;try{if(s!==null&&r<i){let p=(i-r)*1e3;u=f()-s-p;}else s=f(),u=0,c=r;return a=l(),!0}catch(p){return n.onError(p instanceof Error?p:new Error(String(p))),false}},d=()=>{a&&(clearInterval(a),a=null);},b=()=>{d(),r=i,s=null,u=0,c=i;},N=p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));r=h,s=null,u=0,c=h;};return {start:I,stop:d,reset:b,setSeconds:N,setInitialValue:p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));i=h,N(h);},getTotalSeconds:()=>r,getInitialValue:()=>i,isRunning:()=>a!==null,destroy:()=>{d(),r=0,s=null,u=0;}}}var m=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"}),x={[m.IDLE]:{start:m.RUNNING},[m.RUNNING]:{pause:m.PAUSED,reset:m.IDLE,stop:m.STOPPED,complete:m.STOPPED},[m.PAUSED]:{resume:m.RUNNING,reset:m.IDLE,stop:m.STOPPED},[m.STOPPED]:{reset:m.IDLE}};function H(t){if(t!==void 0){if(typeof t!="object"||t===null)throw new Error("events must be an object");if(t.onStateChange!==void 0&&typeof t.onStateChange!="function")throw new Error("events.onStateChange must be a function")}let n=m.IDLE;function e(g){let f=x[n]?.[g];if(!f)return  false;n=f;try{t?.onStateChange?.(f);}catch{}return  true}function r(){return e("start")}function a(){return e("resume")}function s(){return e("pause")}function u(){return e("reset")}function c(){return e("stop")}function i(){return e("complete")}function S(){n===m.IDLE||n===m.STOPPED||e("stop");}return {start:r,resume:a,pause:s,reset:u,stop:c,complete:i,getCurrentState:()=>n,canStart:()=>!!x[n]?.start,canResume:()=>!!x[n]?.resume,canPause:()=>!!x[n]?.pause,isRunning:()=>n===m.RUNNING,destroy:S}}function M(t){let n=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,e=n,r=Math.floor(e/31536e3);e-=r*31536e3;let a=Math.floor(e/604800);e-=a*604800;let s=Math.floor(e/86400);e-=s*86400;let u=Math.floor(e/3600);e-=u*3600;let c=Math.floor(e/60);return e-=c*60,{years:r,weeks:a,days:s,hours:u,minutes:c,seconds:e,totalDays:Math.floor(n/86400),totalHours:Math.floor(n/3600),totalMinutes:Math.floor(n/60)}}function C(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function F(t){if(typeof t!="number"||!Number.isFinite(t)||!Number.isInteger(t))throw new Error("initialSeconds must be a finite, non-negative integer");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");return t}function Q(t){let n;if(t)if(typeof t=="function")n=t;else if(typeof t.now=="function"){let e=t;n=()=>e.now();}else throw new Error("timeProvider must implement a now(): number method");else {let e=y();n=()=>e.now();}return A(n)}function P(t,n,e){let r=C(t),a=C(n),s=M(a);return {initialSeconds:r,totalSeconds:a,parts:s,state:e,isRunning:e===m.RUNNING,isCompleted:a===0&&e===m.STOPPED}}function k(t,n={}){let e=F(t),r=Q(n.timeProvider),a=e,s=P(e,e,m.IDLE),u=new Set,c=o=>{try{n.onSnapshot?.(o);}catch{}for(let w of u)try{w(o);}catch{}},i=o=>{let w=o===m.STOPPED?0:l.getTotalSeconds();s=P(a,w,o);try{n.onStateChange?.(o,s);}catch{}c(s);},S=o=>{s=P(a,o,f.getCurrentState()),c(s);},g=o=>{try{n.onError?.(o);}catch{}},f=H({onStateChange:o=>{i(o);}}),l=O(e,{onTick:o=>{S(o);},onComplete:()=>{f.complete();},onError:o=>{g(o),f.stop();}},{timeProvider:r,tickIntervalMs:n.tickIntervalMs});return {start:()=>{if(!f.canStart())return  false;let o=l.start();return o&&f.start(),o},pause:()=>f.canPause()?(l.stop(),f.pause()):false,resume:()=>{if(!f.canResume())return  false;let o=l.start();return o&&f.resume(),o},reset:o=>{if(l.stop(),typeof o=="number"){let _=F(o);a=_,l.setInitialValue(_);}else a=e,l.reset();return f.reset()||S(l.getTotalSeconds()),true},stop:()=>{l.stop();let o=f.stop();return o&&l.setSeconds(0),o},setSeconds:o=>{let w=F(o);l.setSeconds(w),S(l.getTotalSeconds());},getSnapshot:()=>s,subscribe:o=>{u.add(o);try{o(s);}catch{}return {unsubscribe:()=>{u.delete(o);}}},destroy:()=>{l.destroy(),f.destroy(),u.clear(),s=P(a,0,m.STOPPED);}}}function Z(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function T(t,n=2){return t.toString().padStart(n,"0")}function v(){let t=i=>M(C(Z(i)));return {formatTime:i=>{let S=t(i);return {minutes:T(S.totalMinutes),seconds:T(S.seconds)}},formatMinutes:i=>T(t(i).minutes),formatSeconds:i=>T(t(i).seconds),formatHours:i=>T(t(i).hours),formatDays:i=>T(t(i).days),formatWeeks:i=>T(t(i).weeks),formatYears:i=>T(t(i).years)}}var E=v();function $(t){return E.formatTime(t)}function tt(t){return E.formatMinutes(t)}function et(t){return E.formatSeconds(t)}function nt(t){return E.formatHours(t)}function ot(t){return E.formatDays(t)}function rt(t){return E.formatWeeks(t)}function it(t){return E.formatYears(t)}function st(t,n={}){let{onSnapshot:e,onStateChange:r,onError:a}=n;if(e!==void 0&&typeof e!="function")throw new Error("onSnapshot must be a function");if(r!==void 0&&typeof r!="function")throw new Error("onStateChange must be a function");if(a!==void 0&&typeof a!="function")throw new Error("onError must be a function");let s=v(),u=k(t,{onError:a}),c=u.getSnapshot(),i=c.state,S=Number.NaN,g=d=>{if(a)try{a(d);}catch{}},f=d=>{if(e)try{e(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},l=d=>{if(r)try{r(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},I=u.subscribe(d=>{c=d,d.state!==i&&(i=d.state,l(d.state)),d.totalSeconds!==S&&(S=d.totalSeconds,f(d));});return {start:()=>{u.start();},pause:()=>{u.pause();},resume:()=>{u.resume();},reset:d=>{u.reset(d);},stop:()=>{u.stop();},getSeconds:()=>s.formatSeconds(c.totalSeconds),getMinutes:()=>s.formatMinutes(c.totalSeconds),getHours:()=>s.formatHours(c.totalSeconds),getDays:()=>s.formatDays(c.totalSeconds),getWeeks:()=>s.formatWeeks(c.totalSeconds),getYears:()=>s.formatYears(c.totalSeconds),getCurrentState:()=>c.state,getSnapshot:()=>c,destroy:()=>{try{I.unsubscribe();}finally{u.destroy();}}}}exports.Countdown=st;exports.CountdownEngine=k;exports.Formatter=v;exports.TimerState=m;exports.buildSnapshot=P;exports.defaultFormatter=E;exports.formatDays=ot;exports.formatHours=nt;exports.formatMinutes=tt;exports.formatSeconds=et;exports.formatTime=$;exports.formatWeeks=rt;exports.formatYears=it;

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-import { C as CountdownSnapshot, T as TimerState } from './countdown-engine-DEKF_8iT.cjs';
-export { a as CountdownEngine, c as CountdownEngineInstance, d as CountdownEngineOptions, e as CountdownParts, b as buildSnapshot } from './countdown-engine-DEKF_8iT.cjs';
+import { C as CountdownSnapshot, T as TimerState } from './countdown-snapshot-D0tGjU62.cjs';
+export { a as CountdownParts } from './countdown-snapshot-D0tGjU62.cjs';
+import { T as TimeProvider } from './time-providers-BfABHfuG.cjs';
 export { FormatTarget, Formatter, defaultFormatter, formatDays, formatHours, formatMinutes, formatSeconds, formatTime, formatWeeks, formatYears } from './format.cjs';
 
 interface CountdownOptions {
@@ -25,4 +26,28 @@ interface CountdownInstance {
 }
 declare function Countdown(initialSeconds: number, options?: CountdownOptions): CountdownInstance;
 
-export { Countdown, type CountdownInstance, type CountdownOptions, CountdownSnapshot, TimerState };
+interface CountdownSubscription {
+    unsubscribe: () => void;
+}
+interface CountdownEngineOptions {
+    onSnapshot?: (snapshot: CountdownSnapshot) => void;
+    onStateChange?: (state: TimerState, snapshot: CountdownSnapshot) => void;
+    onError?: (error: Error) => void;
+    timeProvider?: TimeProvider | (() => number);
+    tickIntervalMs?: number;
+}
+interface CountdownEngineInstance {
+    start: () => boolean;
+    pause: () => boolean;
+    resume: () => boolean;
+    reset: (nextInitialSeconds?: number) => boolean;
+    stop: () => boolean;
+    setSeconds: (seconds: number) => void;
+    getSnapshot: () => CountdownSnapshot;
+    subscribe: (listener: (snapshot: CountdownSnapshot) => void) => CountdownSubscription;
+    destroy: () => void;
+}
+declare function buildSnapshot(initialSeconds: number, totalSeconds: number, state: TimerState): CountdownSnapshot;
+declare function CountdownEngine(initialSecondsInput: number, options?: CountdownEngineOptions): CountdownEngineInstance;
+
+export { Countdown, CountdownEngine, type CountdownEngineInstance, type CountdownEngineOptions, type CountdownInstance, type CountdownOptions, CountdownSnapshot, TimerState, buildSnapshot };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { C as CountdownSnapshot, T as TimerState } from './countdown-engine-DEKF_8iT.js';
-export { a as CountdownEngine, c as CountdownEngineInstance, d as CountdownEngineOptions, e as CountdownParts, b as buildSnapshot } from './countdown-engine-DEKF_8iT.js';
+import { C as CountdownSnapshot, T as TimerState } from './countdown-snapshot-D0tGjU62.js';
+export { a as CountdownParts } from './countdown-snapshot-D0tGjU62.js';
+import { T as TimeProvider } from './time-providers-BfABHfuG.js';
 export { FormatTarget, Formatter, defaultFormatter, formatDays, formatHours, formatMinutes, formatSeconds, formatTime, formatWeeks, formatYears } from './format.js';
 
 interface CountdownOptions {
@@ -25,4 +26,28 @@ interface CountdownInstance {
 }
 declare function Countdown(initialSeconds: number, options?: CountdownOptions): CountdownInstance;
 
-export { Countdown, type CountdownInstance, type CountdownOptions, CountdownSnapshot, TimerState };
+interface CountdownSubscription {
+    unsubscribe: () => void;
+}
+interface CountdownEngineOptions {
+    onSnapshot?: (snapshot: CountdownSnapshot) => void;
+    onStateChange?: (state: TimerState, snapshot: CountdownSnapshot) => void;
+    onError?: (error: Error) => void;
+    timeProvider?: TimeProvider | (() => number);
+    tickIntervalMs?: number;
+}
+interface CountdownEngineInstance {
+    start: () => boolean;
+    pause: () => boolean;
+    resume: () => boolean;
+    reset: (nextInitialSeconds?: number) => boolean;
+    stop: () => boolean;
+    setSeconds: (seconds: number) => void;
+    getSnapshot: () => CountdownSnapshot;
+    subscribe: (listener: (snapshot: CountdownSnapshot) => void) => CountdownSubscription;
+    destroy: () => void;
+}
+declare function buildSnapshot(initialSeconds: number, totalSeconds: number, state: TimerState): CountdownSnapshot;
+declare function CountdownEngine(initialSecondsInput: number, options?: CountdownEngineOptions): CountdownEngineInstance;
+
+export { Countdown, CountdownEngine, type CountdownEngineInstance, type CountdownEngineOptions, type CountdownInstance, type CountdownOptions, CountdownSnapshot, TimerState, buildSnapshot };

package/dist/index.js

@@ -1 +1 @@
-function W(){return {now:()=>performance.now(),isHighResolution:true,type:"performance"}}function X(){return {now:()=>Date.now(),isHighResolution:false,type:"date"}}function y(){let t,o=X();function n(){try{if(typeof performance<"u"&&typeof performance.now=="function"){let e=performance.now();if(typeof e=="number"&&Number.isFinite(e)&&!isNaN(e)&&e>=0&&e<=Number.MAX_SAFE_INTEGER){t=W();return}}throw new Error("performance.now() not available or invalid")}catch{t=o;}}return n(),{now:()=>{try{let e=t.now();if(typeof e=="number"&&Number.isFinite(e)&&!isNaN(e)&&e>=0&&e<=Number.MAX_SAFE_INTEGER)return e;throw new Error("Invalid time value returned")}catch{t!==o&&(t=o);try{let e=o.now();if(typeof e=="number"&&Number.isFinite(e)&&!isNaN(e)&&e>=0)return e}catch{}return 0}},get isHighResolution(){return t.isHighResolution},get type(){return t.type}}}function k(t,o=0){let n=typeof o=="number"&&Number.isFinite(o)&&o>=0?o:0;return ()=>{let e=t();return typeof e!="number"||!Number.isFinite(e)||e<n||(n=e),n}}y();var z=10,j=100;function B(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?j:Math.max(z,Math.floor(t))}function A(t,o,n={}){if(typeof t!="number"||!Number.isFinite(t))throw new Error("initialSeconds must be a finite number");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");let e=Math.floor(Math.max(0,t)),s=null,a=null,u=0,c=e,i=e,S=B(n.tickIntervalMs),g=y(),f=n.timeProvider??(()=>g.now()),l=()=>setInterval(()=>{try{if(a===null)return;let h=f()-a-u,D=Math.floor(h/1e3),r=Number.isFinite(D)?Math.min(i,Math.max(0,i-D)):i;e=r,r!==c&&(c=r,o.onTick(r)),r===0&&(d(),o.onComplete());}catch(p){d(),o.onError(p instanceof Error?p:new Error(String(p)));}},S),N=()=>{if(s||e<=0)return  false;try{if(a!==null&&e<i){let p=(i-e)*1e3;u=f()-a-p;}else a=f(),u=0,c=e;return s=l(),!0}catch(p){return o.onError(p instanceof Error?p:new Error(String(p))),false}},d=()=>{s&&(clearInterval(s),s=null);},b=()=>{d(),e=i,a=null,u=0,c=i;},v=p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));e=h,a=null,u=0,c=h;};return {start:N,stop:d,reset:b,setSeconds:v,setInitialValue:p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));i=h,v(h);},getTotalSeconds:()=>e,getInitialValue:()=>i,isRunning:()=>s!==null,destroy:()=>{d(),e=0,a=null,u=0;}}}var m=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"}),I={[m.IDLE]:{start:m.RUNNING},[m.RUNNING]:{pause:m.PAUSED,reset:m.IDLE,stop:m.STOPPED,complete:m.STOPPED},[m.PAUSED]:{resume:m.RUNNING,reset:m.IDLE,stop:m.STOPPED},[m.STOPPED]:{reset:m.IDLE}};function O(t){if(t!==void 0){if(typeof t!="object"||t===null)throw new Error("events must be an object");if(t.onStateChange!==void 0&&typeof t.onStateChange!="function")throw new Error("events.onStateChange must be a function")}let o=m.IDLE;function n(g){let f=I[o]?.[g];if(!f)return  false;o=f;try{t?.onStateChange?.(f);}catch{}return  true}function e(){return n("start")}function s(){return n("resume")}function a(){return n("pause")}function u(){return n("reset")}function c(){return n("stop")}function i(){return n("complete")}function S(){o===m.IDLE||o===m.STOPPED||n("stop");}return {start:e,resume:s,pause:a,reset:u,stop:c,complete:i,getCurrentState:()=>o,canStart:()=>!!I[o]?.start,canResume:()=>!!I[o]?.resume,canPause:()=>!!I[o]?.pause,isRunning:()=>o===m.RUNNING,destroy:S}}function x(t){let o=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,n=o,e=Math.floor(n/31536e3);n-=e*31536e3;let s=Math.floor(n/604800);n-=s*604800;let a=Math.floor(n/86400);n-=a*86400;let u=Math.floor(n/3600);n-=u*3600;let c=Math.floor(n/60);return n-=c*60,{years:e,weeks:s,days:a,hours:u,minutes:c,seconds:n,totalDays:Math.floor(o/86400),totalHours:Math.floor(o/3600),totalMinutes:Math.floor(o/60)}}function C(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function R(t){if(typeof t!="number"||!Number.isFinite(t)||!Number.isInteger(t))throw new Error("initialSeconds must be a finite, non-negative integer");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");return t}function J(t){let o;if(t)if(typeof t=="function")o=t;else if(typeof t.now=="function"){let n=t;o=()=>n.now();}else throw new Error("timeProvider must implement a now(): number method");else {let n=y();o=()=>n.now();}return k(o)}function P(t,o,n){let e=C(t),s=C(o),a=x(s);return {initialSeconds:e,totalSeconds:s,parts:a,state:n,isRunning:n===m.RUNNING,isCompleted:s===0&&n===m.STOPPED}}function F(t,o={}){let n=R(t),e=J(o.timeProvider),s=n,a=P(n,n,m.IDLE),u=new Set,c=r=>{try{o.onSnapshot?.(r);}catch{}for(let w of u)try{w(r);}catch{}},i=r=>{let w=r===m.STOPPED?0:l.getTotalSeconds();a=P(s,w,r);try{o.onStateChange?.(r,a);}catch{}c(a);},S=r=>{a=P(s,r,f.getCurrentState()),c(a);},g=r=>{try{o.onError?.(r);}catch{}},f=O({onStateChange:r=>{i(r);}}),l=A(n,{onTick:r=>{S(r);},onComplete:()=>{f.complete();},onError:r=>{g(r),f.stop();}},{timeProvider:e,tickIntervalMs:o.tickIntervalMs});return {start:()=>{if(!f.canStart())return  false;let r=l.start();return r&&f.start(),r},pause:()=>f.canPause()?(l.stop(),f.pause()):false,resume:()=>{if(!f.canResume())return  false;let r=l.start();return r&&f.resume(),r},reset:r=>{if(l.stop(),typeof r=="number"){let _=R(r);s=_,l.setInitialValue(_);}else s=n,l.reset();return f.reset()||S(l.getTotalSeconds()),true},stop:()=>{l.stop();let r=f.stop();return r&&l.setSeconds(0),r},setSeconds:r=>{let w=R(r);l.setSeconds(w),S(l.getTotalSeconds());},getSnapshot:()=>a,subscribe:r=>{u.add(r);try{r(a);}catch{}return {unsubscribe:()=>{u.delete(r);}}},destroy:()=>{l.destroy(),f.destroy(),u.clear(),a=P(s,0,m.STOPPED);}}}function Q(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function T(t,o=2){return t.toString().padStart(o,"0")}function M(){let t=i=>x(C(Q(i)));return {formatTime:i=>{let S=t(i);return {minutes:T(S.totalMinutes),seconds:T(S.seconds)}},formatMinutes:i=>T(t(i).minutes),formatSeconds:i=>T(t(i).seconds),formatHours:i=>T(t(i).hours),formatDays:i=>T(t(i).days),formatWeeks:i=>T(t(i).weeks),formatYears:i=>T(t(i).years)}}var E=M();function Z(t){return E.formatTime(t)}function $(t){return E.formatMinutes(t)}function tt(t){return E.formatSeconds(t)}function et(t){return E.formatHours(t)}function nt(t){return E.formatDays(t)}function ot(t){return E.formatWeeks(t)}function rt(t){return E.formatYears(t)}function it(t,o={}){let{onSnapshot:n,onStateChange:e,onError:s}=o;if(n!==void 0&&typeof n!="function")throw new Error("onSnapshot must be a function");if(e!==void 0&&typeof e!="function")throw new Error("onStateChange must be a function");if(s!==void 0&&typeof s!="function")throw new Error("onError must be a function");let a=M(),u=F(t,{onError:s}),c=u.getSnapshot(),i=c.state,S=Number.NaN,g=d=>{if(s)try{s(d);}catch{}},f=d=>{if(n)try{n(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},l=d=>{if(e)try{e(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},N=u.subscribe(d=>{c=d,d.state!==i&&(i=d.state,l(d.state)),d.totalSeconds!==S&&(S=d.totalSeconds,f(d));});return {start:()=>{u.start();},pause:()=>{u.pause();},resume:()=>{u.resume();},reset:d=>{u.reset(d);},stop:()=>{u.stop();},getSeconds:()=>a.formatSeconds(c.totalSeconds),getMinutes:()=>a.formatMinutes(c.totalSeconds),getHours:()=>a.formatHours(c.totalSeconds),getDays:()=>a.formatDays(c.totalSeconds),getWeeks:()=>a.formatWeeks(c.totalSeconds),getYears:()=>a.formatYears(c.totalSeconds),getCurrentState:()=>c.state,getSnapshot:()=>c,destroy:()=>{try{N.unsubscribe();}finally{u.destroy();}}}}export{it as Countdown,F as CountdownEngine,M as Formatter,m as TimerState,P as buildSnapshot,E as defaultFormatter,nt as formatDays,et as formatHours,$ as formatMinutes,tt as formatSeconds,Z as formatTime,ot as formatWeeks,rt as formatYears};
+function V(){return {now:()=>performance.now(),isHighResolution:true,type:"performance"}}function X(){return {now:()=>Date.now(),isHighResolution:false,type:"date"}}function R(t){return Number.isFinite(t)&&t>=0&&t<=Number.MAX_SAFE_INTEGER}function y(){let t,n=X();function e(){try{if(typeof performance<"u"&&typeof performance.now=="function"){let r=performance.now();if(R(r)){t=V();return}}throw new Error("performance.now() not available or invalid")}catch{t=n;}}return e(),{now:()=>{try{let r=t.now();if(R(r))return r;throw new Error("Invalid time value returned")}catch{t!==n&&(t=n);try{let r=n.now();if(R(r))return r}catch{}return 0}},get isHighResolution(){return t.isHighResolution},get type(){return t.type}}}function A(t,n=0){let e=typeof n=="number"&&Number.isFinite(n)&&n>=0?n:0;return ()=>{let r=t();return typeof r!="number"||!Number.isFinite(r)||r<e||(e=r),e}}y();var j=10,B=100;function K(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?B:Math.max(j,Math.floor(t))}function O(t,n,e={}){if(typeof t!="number"||!Number.isFinite(t))throw new Error("initialSeconds must be a finite number");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");let r=Math.floor(Math.max(0,t)),a=null,s=null,u=0,c=r,i=r,S=K(e.tickIntervalMs),g=y(),f=e.timeProvider??(()=>g.now()),l=()=>setInterval(()=>{try{if(s===null)return;let h=f()-s-u,D=Math.floor(h/1e3),o=Number.isFinite(D)?Math.min(i,Math.max(0,i-D)):i;r=o,o!==c&&(c=o,n.onTick(o)),o===0&&(d(),n.onComplete());}catch(p){d(),n.onError(p instanceof Error?p:new Error(String(p)));}},S),I=()=>{if(a||r<=0)return  false;try{if(s!==null&&r<i){let p=(i-r)*1e3;u=f()-s-p;}else s=f(),u=0,c=r;return a=l(),!0}catch(p){return n.onError(p instanceof Error?p:new Error(String(p))),false}},d=()=>{a&&(clearInterval(a),a=null);},b=()=>{d(),r=i,s=null,u=0,c=i;},N=p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));r=h,s=null,u=0,c=h;};return {start:I,stop:d,reset:b,setSeconds:N,setInitialValue:p=>{if(typeof p!="number"||!Number.isFinite(p))return;let h=Math.floor(Math.max(0,Math.min(p,Number.MAX_SAFE_INTEGER)));i=h,N(h);},getTotalSeconds:()=>r,getInitialValue:()=>i,isRunning:()=>a!==null,destroy:()=>{d(),r=0,s=null,u=0;}}}var m=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"}),x={[m.IDLE]:{start:m.RUNNING},[m.RUNNING]:{pause:m.PAUSED,reset:m.IDLE,stop:m.STOPPED,complete:m.STOPPED},[m.PAUSED]:{resume:m.RUNNING,reset:m.IDLE,stop:m.STOPPED},[m.STOPPED]:{reset:m.IDLE}};function H(t){if(t!==void 0){if(typeof t!="object"||t===null)throw new Error("events must be an object");if(t.onStateChange!==void 0&&typeof t.onStateChange!="function")throw new Error("events.onStateChange must be a function")}let n=m.IDLE;function e(g){let f=x[n]?.[g];if(!f)return  false;n=f;try{t?.onStateChange?.(f);}catch{}return  true}function r(){return e("start")}function a(){return e("resume")}function s(){return e("pause")}function u(){return e("reset")}function c(){return e("stop")}function i(){return e("complete")}function S(){n===m.IDLE||n===m.STOPPED||e("stop");}return {start:r,resume:a,pause:s,reset:u,stop:c,complete:i,getCurrentState:()=>n,canStart:()=>!!x[n]?.start,canResume:()=>!!x[n]?.resume,canPause:()=>!!x[n]?.pause,isRunning:()=>n===m.RUNNING,destroy:S}}function M(t){let n=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,e=n,r=Math.floor(e/31536e3);e-=r*31536e3;let a=Math.floor(e/604800);e-=a*604800;let s=Math.floor(e/86400);e-=s*86400;let u=Math.floor(e/3600);e-=u*3600;let c=Math.floor(e/60);return e-=c*60,{years:r,weeks:a,days:s,hours:u,minutes:c,seconds:e,totalDays:Math.floor(n/86400),totalHours:Math.floor(n/3600),totalMinutes:Math.floor(n/60)}}function C(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function F(t){if(typeof t!="number"||!Number.isFinite(t)||!Number.isInteger(t))throw new Error("initialSeconds must be a finite, non-negative integer");if(t<0)throw new Error("initialSeconds must be non-negative");if(t>Number.MAX_SAFE_INTEGER)throw new Error("initialSeconds exceeds maximum safe integer");return t}function Q(t){let n;if(t)if(typeof t=="function")n=t;else if(typeof t.now=="function"){let e=t;n=()=>e.now();}else throw new Error("timeProvider must implement a now(): number method");else {let e=y();n=()=>e.now();}return A(n)}function P(t,n,e){let r=C(t),a=C(n),s=M(a);return {initialSeconds:r,totalSeconds:a,parts:s,state:e,isRunning:e===m.RUNNING,isCompleted:a===0&&e===m.STOPPED}}function k(t,n={}){let e=F(t),r=Q(n.timeProvider),a=e,s=P(e,e,m.IDLE),u=new Set,c=o=>{try{n.onSnapshot?.(o);}catch{}for(let w of u)try{w(o);}catch{}},i=o=>{let w=o===m.STOPPED?0:l.getTotalSeconds();s=P(a,w,o);try{n.onStateChange?.(o,s);}catch{}c(s);},S=o=>{s=P(a,o,f.getCurrentState()),c(s);},g=o=>{try{n.onError?.(o);}catch{}},f=H({onStateChange:o=>{i(o);}}),l=O(e,{onTick:o=>{S(o);},onComplete:()=>{f.complete();},onError:o=>{g(o),f.stop();}},{timeProvider:r,tickIntervalMs:n.tickIntervalMs});return {start:()=>{if(!f.canStart())return  false;let o=l.start();return o&&f.start(),o},pause:()=>f.canPause()?(l.stop(),f.pause()):false,resume:()=>{if(!f.canResume())return  false;let o=l.start();return o&&f.resume(),o},reset:o=>{if(l.stop(),typeof o=="number"){let _=F(o);a=_,l.setInitialValue(_);}else a=e,l.reset();return f.reset()||S(l.getTotalSeconds()),true},stop:()=>{l.stop();let o=f.stop();return o&&l.setSeconds(0),o},setSeconds:o=>{let w=F(o);l.setSeconds(w),S(l.getTotalSeconds());},getSnapshot:()=>s,subscribe:o=>{u.add(o);try{o(s);}catch{}return {unsubscribe:()=>{u.delete(o);}}},destroy:()=>{l.destroy(),f.destroy(),u.clear(),s=P(a,0,m.STOPPED);}}}function Z(t){return typeof t=="number"?t:t&&typeof t.totalSeconds=="number"?t.totalSeconds:0}function T(t,n=2){return t.toString().padStart(n,"0")}function v(){let t=i=>M(C(Z(i)));return {formatTime:i=>{let S=t(i);return {minutes:T(S.totalMinutes),seconds:T(S.seconds)}},formatMinutes:i=>T(t(i).minutes),formatSeconds:i=>T(t(i).seconds),formatHours:i=>T(t(i).hours),formatDays:i=>T(t(i).days),formatWeeks:i=>T(t(i).weeks),formatYears:i=>T(t(i).years)}}var E=v();function $(t){return E.formatTime(t)}function tt(t){return E.formatMinutes(t)}function et(t){return E.formatSeconds(t)}function nt(t){return E.formatHours(t)}function ot(t){return E.formatDays(t)}function rt(t){return E.formatWeeks(t)}function it(t){return E.formatYears(t)}function st(t,n={}){let{onSnapshot:e,onStateChange:r,onError:a}=n;if(e!==void 0&&typeof e!="function")throw new Error("onSnapshot must be a function");if(r!==void 0&&typeof r!="function")throw new Error("onStateChange must be a function");if(a!==void 0&&typeof a!="function")throw new Error("onError must be a function");let s=v(),u=k(t,{onError:a}),c=u.getSnapshot(),i=c.state,S=Number.NaN,g=d=>{if(a)try{a(d);}catch{}},f=d=>{if(e)try{e(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},l=d=>{if(r)try{r(d);}catch(b){g(b instanceof Error?b:new Error(String(b)));}},I=u.subscribe(d=>{c=d,d.state!==i&&(i=d.state,l(d.state)),d.totalSeconds!==S&&(S=d.totalSeconds,f(d));});return {start:()=>{u.start();},pause:()=>{u.pause();},resume:()=>{u.resume();},reset:d=>{u.reset(d);},stop:()=>{u.stop();},getSeconds:()=>s.formatSeconds(c.totalSeconds),getMinutes:()=>s.formatMinutes(c.totalSeconds),getHours:()=>s.formatHours(c.totalSeconds),getDays:()=>s.formatDays(c.totalSeconds),getWeeks:()=>s.formatWeeks(c.totalSeconds),getYears:()=>s.formatYears(c.totalSeconds),getCurrentState:()=>c.state,getSnapshot:()=>c,destroy:()=>{try{I.unsubscribe();}finally{u.destroy();}}}}export{st as Countdown,k as CountdownEngine,v as Formatter,m as TimerState,P as buildSnapshot,E as defaultFormatter,ot as formatDays,nt as formatHours,tt as formatMinutes,et as formatSeconds,$ as formatTime,rt as formatWeeks,it as formatYears};

package/dist/testing-utils.cjs

@@ -1 +1 @@
-'use strict';var u=e=>!Number.isFinite(e)||e<0?0:e>Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(e);function M(e={}){let{startMs:n=0,tickMs:t=1e3,highResolution:a=true}=e,r=u(n),s=u(t);return {now:()=>r,advance:(i=s)=>(r=u(r+u(i)),r),set:i=>(r=u(i),r),reset:()=>(r=u(n),r),getTime:()=>r,isHighResolution:a,type:"fake"}}function R(e){return {now:()=>e.now(),isHighResolution:e.isHighResolution,type:e.type}}function h(e){let n=Number.isFinite(e)?Math.max(0,Math.floor(e)):0,t=n,a=Math.floor(t/31536e3);t-=a*31536e3;let r=Math.floor(t/604800);t-=r*604800;let s=Math.floor(t/86400);t-=s*86400;let m=Math.floor(t/3600);t-=m*3600;let p=Math.floor(t/60);return t-=p*60,{years:a,weeks:r,days:s,hours:m,minutes:p,seconds:t,totalDays:Math.floor(n/86400),totalHours:Math.floor(n/3600),totalMinutes:Math.floor(n/60)}}function c(e){return typeof e!="number"||!Number.isFinite(e)||e<=0?0:e>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(e)}var o=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"});({[o.IDLE]:{start:o.RUNNING},[o.RUNNING]:{pause:o.PAUSED,reset:o.IDLE,stop:o.STOPPED,complete:o.STOPPED},[o.PAUSED]:{resume:o.RUNNING,reset:o.IDLE,stop:o.STOPPED},[o.STOPPED]:{reset:o.IDLE}});function P(e={}){let n=c(e.initialSeconds??e.totalSeconds??0),t=c(e.totalSeconds??e.initialSeconds??0),a=e.state??(t>0?o.IDLE:o.STOPPED),r=h(t);return {initialSeconds:n,totalSeconds:t,parts:r,state:a,isRunning:a===o.RUNNING,isCompleted:t===0&&a===o.STOPPED}}function A(e={}){let{totalSeconds:n=0,step:t=1,count:a=1,initialSeconds:r}=e,s=c(n),m=c(t),p=c(a)||1,S=[];for(let f=0;f<p;f+=1){let i=Math.max(s-m*f,0);S.push(P({initialSeconds:r??s,totalSeconds:i,state:i===0?o.STOPPED:o.RUNNING}));}return S}var d=(e,n)=>n?`${e}: ${n}`:e;function U(e,n,t){if(e.state!==n)throw new Error(d(t??"Unexpected countdown state",`expected ${n} but received ${e.state}`))}function F(e,n){if(!e.isCompleted||e.totalSeconds!==0)throw new Error(d(n??"Countdown should be completed"))}function v(e,n,t=0,a){if(typeof n!="number"||!Number.isFinite(n))throw new Error("Expected remaining seconds must be a finite number");if(Math.abs(e.totalSeconds-Math.floor(n))>t)throw new Error(d(a??"Unexpected remaining seconds",`expected ${n}\xB1${t} but received ${e.totalSeconds}`))}exports.TimerState=o;exports.assertRemainingSeconds=v;exports.assertSnapshotCompleted=F;exports.assertSnapshotState=U;exports.buildSnapshot=P;exports.buildSnapshotSequence=A;exports.createFakeTimeProvider=M;exports.toTimeProvider=R;
+'use strict';var c=t=>!Number.isFinite(t)||t<0?0:t>Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t);function C(t={}){let{startMs:n=0,tickMs:e=1e3,highResolution:s=true}=t,r=c(n),i=c(e);return {now:()=>r,advance:(u=i)=>(r=c(r+c(u)),r),set:u=>(r=c(u),r),reset:()=>(r=c(n),r),getTime:()=>r,isHighResolution:s,type:"fake"}}function N(t){return {now:()=>t.now(),isHighResolution:t.isHighResolution,type:t.type}}var o=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"});({[o.IDLE]:{start:o.RUNNING},[o.RUNNING]:{pause:o.PAUSED,reset:o.IDLE,stop:o.STOPPED,complete:o.STOPPED},[o.PAUSED]:{resume:o.RUNNING,reset:o.IDLE,stop:o.STOPPED},[o.STOPPED]:{reset:o.IDLE}});function E(t){let n=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,e=n,s=Math.floor(e/31536e3);e-=s*31536e3;let r=Math.floor(e/604800);e-=r*604800;let i=Math.floor(e/86400);e-=i*86400;let m=Math.floor(e/3600);e-=m*3600;let d=Math.floor(e/60);return e-=d*60,{years:s,weeks:r,days:i,hours:m,minutes:d,seconds:e,totalDays:Math.floor(n/86400),totalHours:Math.floor(n/3600),totalMinutes:Math.floor(n/60)}}function a(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function T(t,n,e){let s=a(t),r=a(n),i=E(r);return {initialSeconds:s,totalSeconds:r,parts:i,state:e,isRunning:e===o.RUNNING,isCompleted:r===0&&e===o.STOPPED}}function g(t={}){let n=t.initialSeconds??t.totalSeconds??0,e=t.totalSeconds??t.initialSeconds??0,s=t.state??(a(e)>0?o.IDLE:o.STOPPED);return T(n,e,s)}function G(t={}){let{totalSeconds:n=0,step:e=1,count:s=1,initialSeconds:r}=t,i=a(n),m=a(e),d=a(s)||1,p=[];for(let S=0;S<d;S+=1){let u=Math.max(i-m*S,0);p.push(g({initialSeconds:r??i,totalSeconds:u,state:u===0?o.STOPPED:o.RUNNING}));}return p}var f=(t,n)=>n?`${t}: ${n}`:t;function $(t,n,e){if(t.state!==n)throw new Error(f(e??"Unexpected countdown state",`expected ${n} but received ${t.state}`))}function H(t,n){if(!t.isCompleted||t.totalSeconds!==0)throw new Error(f(n??"Countdown should be completed"))}function X(t,n,e=0,s){if(typeof n!="number"||!Number.isFinite(n))throw new Error("Expected remaining seconds must be a finite number");if(Math.abs(t.totalSeconds-Math.floor(n))>e)throw new Error(f(s??"Unexpected remaining seconds",`expected ${n}\xB1${e} but received ${t.totalSeconds}`))}exports.TimerState=o;exports.assertRemainingSeconds=X;exports.assertSnapshotCompleted=H;exports.assertSnapshotState=$;exports.buildSnapshot=g;exports.buildSnapshotSequence=G;exports.createFakeTimeProvider=C;exports.toTimeProvider=N;

package/dist/testing-utils.d.cts

@@ -1,4 +1,5 @@
-import { f as TimeProvider, T as TimerState, C as CountdownSnapshot } from './countdown-engine-DEKF_8iT.cjs';
+import { T as TimeProvider } from './time-providers-BfABHfuG.cjs';
+import { T as TimerState, C as CountdownSnapshot } from './countdown-snapshot-D0tGjU62.cjs';
 
 interface FakeTimeProvider extends TimeProvider {
     advance: (ms?: number) => number;

package/dist/testing-utils.d.ts

@@ -1,4 +1,5 @@
-import { f as TimeProvider, T as TimerState, C as CountdownSnapshot } from './countdown-engine-DEKF_8iT.js';
+import { T as TimeProvider } from './time-providers-BfABHfuG.js';
+import { T as TimerState, C as CountdownSnapshot } from './countdown-snapshot-D0tGjU62.js';
 
 interface FakeTimeProvider extends TimeProvider {
     advance: (ms?: number) => number;

package/dist/testing-utils.js

@@ -1 +1 @@
-var u=e=>!Number.isFinite(e)||e<0?0:e>Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(e);function M(e={}){let{startMs:n=0,tickMs:t=1e3,highResolution:a=true}=e,r=u(n),s=u(t);return {now:()=>r,advance:(i=s)=>(r=u(r+u(i)),r),set:i=>(r=u(i),r),reset:()=>(r=u(n),r),getTime:()=>r,isHighResolution:a,type:"fake"}}function R(e){return {now:()=>e.now(),isHighResolution:e.isHighResolution,type:e.type}}function h(e){let n=Number.isFinite(e)?Math.max(0,Math.floor(e)):0,t=n,a=Math.floor(t/31536e3);t-=a*31536e3;let r=Math.floor(t/604800);t-=r*604800;let s=Math.floor(t/86400);t-=s*86400;let m=Math.floor(t/3600);t-=m*3600;let p=Math.floor(t/60);return t-=p*60,{years:a,weeks:r,days:s,hours:m,minutes:p,seconds:t,totalDays:Math.floor(n/86400),totalHours:Math.floor(n/3600),totalMinutes:Math.floor(n/60)}}function c(e){return typeof e!="number"||!Number.isFinite(e)||e<=0?0:e>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(e)}var o=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"});({[o.IDLE]:{start:o.RUNNING},[o.RUNNING]:{pause:o.PAUSED,reset:o.IDLE,stop:o.STOPPED,complete:o.STOPPED},[o.PAUSED]:{resume:o.RUNNING,reset:o.IDLE,stop:o.STOPPED},[o.STOPPED]:{reset:o.IDLE}});function P(e={}){let n=c(e.initialSeconds??e.totalSeconds??0),t=c(e.totalSeconds??e.initialSeconds??0),a=e.state??(t>0?o.IDLE:o.STOPPED),r=h(t);return {initialSeconds:n,totalSeconds:t,parts:r,state:a,isRunning:a===o.RUNNING,isCompleted:t===0&&a===o.STOPPED}}function A(e={}){let{totalSeconds:n=0,step:t=1,count:a=1,initialSeconds:r}=e,s=c(n),m=c(t),p=c(a)||1,S=[];for(let f=0;f<p;f+=1){let i=Math.max(s-m*f,0);S.push(P({initialSeconds:r??s,totalSeconds:i,state:i===0?o.STOPPED:o.RUNNING}));}return S}var d=(e,n)=>n?`${e}: ${n}`:e;function U(e,n,t){if(e.state!==n)throw new Error(d(t??"Unexpected countdown state",`expected ${n} but received ${e.state}`))}function F(e,n){if(!e.isCompleted||e.totalSeconds!==0)throw new Error(d(n??"Countdown should be completed"))}function v(e,n,t=0,a){if(typeof n!="number"||!Number.isFinite(n))throw new Error("Expected remaining seconds must be a finite number");if(Math.abs(e.totalSeconds-Math.floor(n))>t)throw new Error(d(a??"Unexpected remaining seconds",`expected ${n}\xB1${t} but received ${e.totalSeconds}`))}export{o as TimerState,v as assertRemainingSeconds,F as assertSnapshotCompleted,U as assertSnapshotState,P as buildSnapshot,A as buildSnapshotSequence,M as createFakeTimeProvider,R as toTimeProvider};
+var c=t=>!Number.isFinite(t)||t<0?0:t>Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t);function C(t={}){let{startMs:n=0,tickMs:e=1e3,highResolution:s=true}=t,r=c(n),i=c(e);return {now:()=>r,advance:(u=i)=>(r=c(r+c(u)),r),set:u=>(r=c(u),r),reset:()=>(r=c(n),r),getTime:()=>r,isHighResolution:s,type:"fake"}}function N(t){return {now:()=>t.now(),isHighResolution:t.isHighResolution,type:t.type}}var o=Object.freeze({IDLE:"IDLE",RUNNING:"RUNNING",PAUSED:"PAUSED",STOPPED:"STOPPED"});({[o.IDLE]:{start:o.RUNNING},[o.RUNNING]:{pause:o.PAUSED,reset:o.IDLE,stop:o.STOPPED,complete:o.STOPPED},[o.PAUSED]:{resume:o.RUNNING,reset:o.IDLE,stop:o.STOPPED},[o.STOPPED]:{reset:o.IDLE}});function E(t){let n=Number.isFinite(t)?Math.max(0,Math.floor(t)):0,e=n,s=Math.floor(e/31536e3);e-=s*31536e3;let r=Math.floor(e/604800);e-=r*604800;let i=Math.floor(e/86400);e-=i*86400;let m=Math.floor(e/3600);e-=m*3600;let d=Math.floor(e/60);return e-=d*60,{years:s,weeks:r,days:i,hours:m,minutes:d,seconds:e,totalDays:Math.floor(n/86400),totalHours:Math.floor(n/3600),totalMinutes:Math.floor(n/60)}}function a(t){return typeof t!="number"||!Number.isFinite(t)||t<=0?0:t>=Number.MAX_SAFE_INTEGER?Number.MAX_SAFE_INTEGER:Math.floor(t)}function T(t,n,e){let s=a(t),r=a(n),i=E(r);return {initialSeconds:s,totalSeconds:r,parts:i,state:e,isRunning:e===o.RUNNING,isCompleted:r===0&&e===o.STOPPED}}function g(t={}){let n=t.initialSeconds??t.totalSeconds??0,e=t.totalSeconds??t.initialSeconds??0,s=t.state??(a(e)>0?o.IDLE:o.STOPPED);return T(n,e,s)}function G(t={}){let{totalSeconds:n=0,step:e=1,count:s=1,initialSeconds:r}=t,i=a(n),m=a(e),d=a(s)||1,p=[];for(let S=0;S<d;S+=1){let u=Math.max(i-m*S,0);p.push(g({initialSeconds:r??i,totalSeconds:u,state:u===0?o.STOPPED:o.RUNNING}));}return p}var f=(t,n)=>n?`${t}: ${n}`:t;function $(t,n,e){if(t.state!==n)throw new Error(f(e??"Unexpected countdown state",`expected ${n} but received ${t.state}`))}function H(t,n){if(!t.isCompleted||t.totalSeconds!==0)throw new Error(f(n??"Countdown should be completed"))}function X(t,n,e=0,s){if(typeof n!="number"||!Number.isFinite(n))throw new Error("Expected remaining seconds must be a finite number");if(Math.abs(t.totalSeconds-Math.floor(n))>e)throw new Error(f(s??"Unexpected remaining seconds",`expected ${n}\xB1${e} but received ${t.totalSeconds}`))}export{o as TimerState,X as assertRemainingSeconds,H as assertSnapshotCompleted,$ as assertSnapshotState,g as buildSnapshot,G as buildSnapshotSequence,C as createFakeTimeProvider,N as toTimeProvider};

package/dist/time-providers-BfABHfuG.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Time providers with fallbacks for critical APIs
+ * Ensures the library works even without modern browser APIs
+ */
+interface TimeProvider {
+    now(): number;
+    isHighResolution: boolean;
+    type: string;
+}
+
+export type { TimeProvider as T };

package/dist/time-providers-BfABHfuG.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Time providers with fallbacks for critical APIs
+ * Ensures the library works even without modern browser APIs
+ */
+interface TimeProvider {
+    now(): number;
+    isHighResolution: boolean;
+    type: string;
+}
+
+export type { TimeProvider as T };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timekeeper-countdown/core",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Lightweight countdown engine that powers the Timekeeper packages. Pure TypeScript with no runtime dependencies.",
   "keywords": [
     "countdown",