senangwebs-epoch 1.1.4 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## 1.2.0
+
+- Add SSR-safe CommonJS and native ESM entry points with TypeScript declarations.
+  npm consumers explicitly initialize timers and import optional CSS; legacy
+  `dist/swe.js` retains the browser global and automatic initialization.
+- Fix countdowns across midnight, month ends, leap years and omitted units.
+  Days/hours use elapsed time; displayed years/months use clamped local calendars.
+- Accept zero and fractional durations; validate configuration before scheduling
+  or replacing an existing instance, including when autostart is disabled.
+- Use monotonic duration timing, preserve pause progress, and discard that progress
+  on stop. Completed countdowns now require reset before restarting.
+- Add lifecycle state, `destroy()`, `SWE.getInstance()`, and scoped `SWE.init()`.
+  Valid construction replaces old ownership, while repeated scans reuse timers.
+- Render and reset attribute-configured timers and all current-clock date fields.
+- Emit start/resume before the first tick; complete and render zero before
+  stop/end. Emit `swe:stop` on immediate completion as well. Isolate callback
+  failures and automatic-initialization errors through `swe:error`.
+- Support late script loading and elements from another document realm.
+- Refresh development dependencies, control package contents, build before
+  packing, and add unit, browser, declaration, package-consumer and CI checks.
+
+### Upgrading from 1.1.x
+
+- Add explicit `SWE.init()` after mounting if your npm application relied on
+  import-time automatic initialization. Script-tag users retain automatic setup.
+- Use `reset()` to restart a completed timer. `start()` on a paused timer resumes;
+  `stop()` followed by `start()` restarts the configured duration.
+- Expect totals to roll into visible units and positive seconds to round up.
+  Malformed numeric strings that were previously partially parsed now fail.
+- Subscribe to `swe:error` to observe callback/markup failures, and call `destroy()`
+  when removing a timer's component. Existing attribute/event names remain valid.

package/README.md

@@ -15,6 +15,8 @@ SenangWebs Epoch (SWE) is a lightweight JavaScript library for creating dynamic
 - Responsive design out of the box
 - Comprehensive event system
 - Pause, resume, and reset functionality
+- Explicit cleanup and instance ownership for dynamic pages
+- CommonJS, native ESM, and TypeScript declarations
 - Completed and expired countdowns stop cleanly and emit `swe:end` once
 - No external dependencies
 - Built-in default styling with CSS
@@ -28,15 +30,37 @@ SenangWebs Epoch (SWE) is a lightweight JavaScript library for creating dynamic
 npm install senangwebs-epoch
 ```
 
+ESM and bundlers:
+
+```javascript
+import SWE from 'senangwebs-epoch';
+import 'senangwebs-epoch/dist/swe.css'; // optional default styling
+
+const timer = new SWE(document.querySelector('#timer'), { duration: 60 });
+// Or explicitly initialize markup using data attributes:
+SWE.init(document);
+// When the component or page is removed:
+timer.destroy();
+```
+
+CommonJS uses `const SWE = require('senangwebs-epoch')`. Both npm entries can be
+imported during server rendering without a DOM; construct timers or call `init`
+only after mounting in a browser. npm imports do not scan the DOM, set a global,
+or load CSS automatically. No framework wrappers are required.
+
 ### Using a CDN
 
 Include SenangWebs Epoch directly in your HTML file:
 
 ```html
-<link rel="stylesheet" href="https://unpkg.com/senangwebs-epoch@latest/dist/swe.css">
-<script src="https://unpkg.com/senangwebs-epoch@latest/dist/swe.js"></script>
+<link rel="stylesheet" href="https://unpkg.com/senangwebs-epoch@1.2.0/dist/swe.css">
+<script src="https://unpkg.com/senangwebs-epoch@1.2.0/dist/swe.js"></script>
 ```
 
+The browser script exposes `window.SWE` and initializes `[data-swe]` elements
+when the DOM is ready, including when the script loads after DOM readiness.
+Version 1.2.0 URLs become available after the release is published.
+
 ## Usage
 
 1. Include the SWE CSS and JavaScript files in your HTML:
@@ -70,6 +94,13 @@ Include SenangWebs Epoch directly in your HTML file:
 </div>
 ```
 
+Duration values are finite nonnegative seconds, including fractions such as
+`0.5`. Numeric strings use decimal digits with an optional fractional part,
+such as `60` or `0.5`; scientific and hexadecimal strings are rejected.
+Zero completes immediately when started. Empty values, malformed numbers,
+infinity, negative values, and values beyond the supported date range throw
+during construction, even with `autostart: false`.
+
 ### Current time display
 
 ```html
@@ -116,13 +147,30 @@ The format string determines zero-padding based on its length:
 | Second | `s` | `3` | Single digit second |
 | Second | `ss` | `03` | Two-digit second |
 
+Formatting sets a minimum width and never truncates values. Countdown values
+roll omitted units into the next visible unit: a minutes/seconds timer can show
+`90:00`; a days-only countdown shows total elapsed days. Years and months use
+local calendar arithmetic only when those units are present, clamping dates
+such as January 31 to the last day of February. Remaining days are 24-hour
+periods, including across daylight-saving changes. Positive remaining time is
+rounded up to the next second; completion occurs at the actual deadline.
+
+In current-clock mode all units show local calendar/time values, including the
+four-digit year and one-based month. Countdown years mean remaining years.
+
+Use ISO date-time strings with `T`. `2027-01-01T00:00:00` means midnight in the
+visitor's local timezone; `2027-01-01T00:00:00Z` means UTC, and
+`2027-01-01T00:00:00+08:00` specifies an offset. Date-only ISO strings follow
+JavaScript's UTC interpretation. Nonstandard date strings may parse differently
+between browsers and are not recommended. Numeric options are milliseconds
+since the Unix epoch, and `Date` options are also accepted.
+
 ### JavaScript Initialization
 
 ```javascript
 const timer = new SWE(element, {
     autostart: true,
     duration: 60, // for countdown-duration mode
-    countdownEnd: '2027-01-01T00:00:00', // ISO 8601, interpreted as local time
     onTick: () => {
         console.log('Timer ticked!');
     },
@@ -147,13 +195,42 @@ const timer = new SWE(element, {
 });
 ```
 
+For a deadline use `{ countdownEnd: '2027-01-01T00:00:00+08:00' }` instead of
+`duration`. Explicit options win over attributes; within each configuration
+source, a deadline wins over a duration, then current-clock mode. Configuration
+is normalized once, so changing attributes/options requires a replacement
+instance. Callbacks receive the timer as `this`; use regular functions to access
+it. Constructors synchronously render and may emit events when autostarting;
+attach DOM listeners before construction if you need the first events.
+
 ## Methods
 
-- `start()`: Start or resume the timer
-- `pause()`: Pause the timer
-- `resume()`: Resume the timer from paused state
-- `reset()`: Reset the timer to initial state
-- `stop()`: Stop the timer completely
+- `start()`: Start an idle/stopped timer or resume a paused timer. Running,
+  completed, and destroyed timers ignore this call.
+- `pause()`: Freeze a duration's remaining time. For deadlines and clocks,
+  pause rendering while real time continues.
+- `resume()`: Resume a paused timer. An elapsed deadline completes on resume.
+- `reset()`: Restore the configured display and begin again if autostart is
+  enabled. This is required to restart a completed countdown.
+- `stop()`: Stop an active timer and discard saved progress; the next start uses
+  the original duration or deadline. The displayed value is retained.
+- `destroy()`: Release scheduling and registration. Later control calls do
+  nothing; existing markup is retained.
+- `SWE.getInstance(element)`: Return the registered timer, or `undefined`.
+- `SWE.init(root = document)`: Initialize a document, element, or fragment,
+  including the root itself when marked `[data-swe]`. Return successfully
+  initialized/reused instances. Call after inserting new markup.
+
+`state` is `idle`, `running`, `paused`, `stopped`, `completed`, or `destroyed`.
+Repeated controls do not create duplicate intervals. Constructing a valid new
+timer on an owned element destroys the previous instance; invalid configuration
+leaves the previous instance working. `init` reuses existing timers.
+
+Duration timers use monotonic elapsed time and preserve fractional progress
+across pause/resume. Deadlines and clocks follow system time. Browser throttling
+may delay rendering/events, but each update recalculates the actual remaining
+time rather than subtracting a tick. These are display timers, not a server-side
+authority for authentication, pricing, or scheduled jobs.
 
 ## Events
 
@@ -177,11 +254,53 @@ Available events:
 - `swe:reset`
 - `swe:stop`
 - `swe:end`
+- `swe:error`
 
 `swe:end` is emitted once when a countdown reaches zero. A countdown that is
 already expired during initialization displays zero and does not leave a
 background interval running.
 
+Start/resume notifications precede the first tick. Completion sets `state` to
+`completed`, clears scheduling, and displays zero before emitting `swe:stop`
+and `swe:end` (including immediate completion). Reset emits stop when active,
+then reset, then start when autostart is enabled. Callbacks run before their
+corresponding bubbling DOM events, whose detail is `{ instance }`.
+
+Callback exceptions do not suppress the original DOM event or interrupt timer
+cleanup; they produce a bubbling `swe:error` event with `{ instance, error }`.
+`SWE.init` isolates invalid elements and emits the same error with
+`instance: null`, then continues scanning. Listen on the root before initializing:
+
+```javascript
+document.addEventListener('swe:error', event => {
+    console.error('Timer error:', event.detail.error);
+});
+```
+
+Lifecycle events are synchronous. Controls called inside callbacks take effect
+immediately, so only reset on completion when you intend to begin another run.
+
+## Accessibility
+
+Provide visible unit labels; format tokens are padding instructions, not
+accessible names. Keep per-second updates out of live announcements and report
+completion separately when it is meaningful:
+
+```html
+<div id="timer" role="timer" aria-live="off" aria-label="Remaining time">
+    <span data-swe-minute data-swe-format="mm"></span> minutes
+    <span data-swe-second data-swe-format="ss"></span> seconds
+</div>
+<p id="timer-status" role="status"></p>
+```
+
+```javascript
+new SWE(document.querySelector('#timer'), {
+    duration: 60,
+    onEnd() { document.querySelector('#timer-status').textContent = 'Timer finished'; }
+});
+```
+
 ## Styling
 
 SWE comes with default styles that can be customized using CSS:
@@ -203,17 +322,33 @@ SWE comes with default styles that can be customized using CSS:
 
 ## Browser Support
 
-SenangWebs Epoch works on all modern browsers, including:
-- Chrome
-- Firefox
-- Safari
-- Edge
-- Opera
+Targets the latest two major versions of Chrome, Edge, Firefox, Safari, and iOS
+Safari. Browser integration tests run on Playwright Chromium, Firefox, and WebKit;
+these do not replace device-specific verification. Build and CI use Node 22/24;
+Node timers without a DOM are not supported.
 
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
+```bash
+npm ci
+npm run build
+npm test
+npm run check:types
+npm run check:package
+npx playwright install chromium firefox webkit
+npm run test:browser
+npm audit
+```
+
+Ask before running unit tests when working under this repository's AGENTS.md
+instruction. `npm test` tests the built distribution; rebuild after source edits.
+`check:package` packs without scripts into a temporary fixture and verifies
+actual CJS/ESM imports, declarations, CSS resolution and a bundler consumer.
+Normal `npm pack`/`npm publish` runs the build through `prepack`. Commit rebuilt
+distribution files; CI checks that rebuilding produces no changes.
+
 ## License
 
 MIT License

package/dist/swe.cjs

@@ -0,0 +1 @@
+(()=>{"use strict";const t={d:(e,i)=>{if(Array.isArray(i))for(var n=0;n<i.length;){var s=i[n++],a=i[n++],o=0===a?{enumerable:!0,value:i[n++]}:{enumerable:!0,get:a};t.o(e,s)||Object.defineProperty(e,s,o)}else for(var s in i)t.o(i,s)&&!t.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:i[s]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)};let e={};const i=Symbol.for("senangwebs-epoch.instance"),n=["year","month","day","hour","minute","second"],s={day:864e5,hour:36e5,minute:6e4,second:1e3};function a(t,e,i){const n=t.ownerDocument&&t.ownerDocument.defaultView,s=n?n.CustomEvent:globalThis.CustomEvent;t.dispatchEvent(new s(`swe:${e}`,{bubbles:!0,detail:i}))}function o(t,e){const i=new Date(t.getTime());if(0===e)return i;const n=i.getDate();i.setDate(1),i.setMonth(i.getMonth()+e);const s=i.getFullYear(),a=[31,s%4!=0||s%100==0&&s%400!=0?28:29,31,30,31,30,31,31,30,31,30,31][i.getMonth()];return i.setDate(Math.min(n,a)),i}class r{constructor(t,e={}){const n=t&&t.ownerDocument&&t.ownerDocument.defaultView,s=n?n.HTMLElement:globalThis.HTMLElement;if(!(s&&t instanceof s))throw new Error("SWE: Invalid element provided");if(!e||"object"!=typeof e)throw new Error("SWE: Invalid options provided");this.element=t,this.options={...e,autostart:void 0===e.autostart||e.autostart},this._view=n||globalThis,this.mode=this.determineMode(),this._normalizeConfiguration(),this.setupElements(),this.intervalId=null,this.state="idle",this.isPaused=!1,this.startTime=null,this.endTime=null,this.pausedTimeRemaining=null,this._generation=0;const a=r.getInstance(t);a&&a.destroy(),t[i]=this,this._renderInitial(),this.options.autostart&&this.start()}static getInstance(t){return t&&t[i]&&"destroyed"!==t[i].state?t[i]:void 0}static init(t=globalThis.document){if(!t||"function"!=typeof t.querySelectorAll)throw new Error("SWE: init requires a DOM root");const e=[...t.querySelectorAll("[data-swe]")];"function"==typeof t.matches&&t.matches("[data-swe]")&&e.unshift(t);const i=[];return e.forEach(t=>{try{i.push(r.getInstance(t)||new r(t))}catch(e){a(t,"error",{instance:null,error:e})}}),i}determineMode(){if(void 0!==this.options.countdownEnd)return"countdown-end";if(void 0!==this.options.duration)return"countdown-duration";if(this.element.hasAttribute("data-swe-countdown-end"))return"countdown-end";if(this.element.hasAttribute("data-swe-countdown-duration"))return"countdown-duration";if(this.element.hasAttribute("data-swe-current"))return"current";throw new Error("SWE: Invalid mode - missing required configuration")}_normalizeConfiguration(){if("countdown-end"===this.mode){const t=void 0!==this.options.countdownEnd?this.options.countdownEnd:this.element.getAttribute("data-swe-countdown-end"),e="[object Date]"===Object.prototype.toString.call(t);if(null===t||""===t||"string"!=typeof t&&!e&&"number"!=typeof t)throw new Error("SWE: Invalid end date format");if(this._targetTime=new Date(t).getTime(),!Number.isFinite(this._targetTime))throw new Error("SWE: Invalid end date format")}else if("countdown-duration"===this.mode){const t=void 0!==this.options.duration?this.options.duration:this.element.getAttribute("data-swe-countdown-duration"),e="number"==typeof t||"string"==typeof t&&/^\s*\d+(?:\.\d+)?\s*$/.test(t)?Number(t):NaN;if(this._durationMilliseconds=1e3*e,!Number.isFinite(e)||e<0||!Number.isSafeInteger(Math.ceil(this._durationMilliseconds))||!Number.isFinite(new Date(Date.now()+this._durationMilliseconds).getTime()))throw new Error("SWE: Invalid duration")}}setupElements(){this.elements={},n.forEach(t=>{const e=`[data-swe-${t}]`,i=this.element.querySelectorAll?[...this.element.querySelectorAll(e)]:[this.element.querySelector(e)];this.elements[t]=i.find(t=>{if(!t)return!1;const e=t.closest&&t.closest("[data-swe]");return!e||e===this.element||!this.element.contains(e)})||null})}_now(){return this._view.performance?this._view.performance.now():Date.now()}_remaining(){return"countdown-duration"===this.mode?this._deadline-this._now():this._targetTime-Date.now()}_clearSchedule(){this._generation++,null!==this.intervalId&&this._view.clearInterval(this.intervalId),this.intervalId=null}_renderInitial(){"current"===this.mode?this.updateCurrentTimeDisplay(new Date):this.updateDisplay("countdown-duration"===this.mode?this._durationMilliseconds:Math.max(0,this._targetTime-Date.now()))}start(){if("paused"===this.state)return this.resume();["running","completed","destroyed"].includes(this.state)||this._begin("start")}_begin(t){if(this._clearSchedule(),this.state="running",this.isPaused=!1,this.startTime=Date.now(),"countdown-duration"===this.mode){const t=null===this.pausedTimeRemaining?this._durationMilliseconds:this.pausedTimeRemaining;this._deadline=this._now()+t,this.endTime=Date.now()+t,this.pausedTimeRemaining=null}else"countdown-end"===this.mode&&(this.endTime=this._targetTime);const e=this._generation;this.dispatchEvent(t),"running"===this.state&&e===this._generation&&(this._tick(),"running"===this.state&&e===this._generation&&(this.intervalId=this._view.setInterval(()=>{e===this._generation&&"running"===this.state&&this._tick()},1e3)))}_tick(){if("current"===this.mode)return this.updateCurrentTimeDisplay(new Date),void this.dispatchEvent("tick");const t=this._remaining();t<=0?(this._clearSchedule(),this.state="completed",this.isPaused=!1,this.pausedTimeRemaining=null,this.updateDisplay(0),this.dispatchEvent("stop"),this.dispatchEvent("end")):(this.updateDisplay(t),this.dispatchEvent("tick"))}pause(){"running"===this.state&&(this.pausedTimeRemaining="countdown-duration"===this.mode?Math.max(0,this._remaining()):null,this._clearSchedule(),this.state="paused",this.isPaused=!0,this.dispatchEvent("pause"))}resume(){"paused"===this.state&&this._begin("resume")}stop(){if("destroyed"===this.state||"completed"===this.state)return;const t="running"===this.state||"paused"===this.state;this._clearSchedule(),this.state="stopped",this.isPaused=!1,this.pausedTimeRemaining=null,this.endTime=null,t&&this.dispatchEvent("stop")}reset(){if("destroyed"===this.state)return;const t="running"===this.state||"paused"===this.state;this._clearSchedule(),this.state="idle",this.isPaused=!1,this.pausedTimeRemaining=null,this.startTime=null,this.endTime=null,this._renderInitial();const e=this._generation;t&&this.dispatchEvent("stop"),e===this._generation&&"idle"===this.state&&(this.dispatchEvent("reset"),this.options.autostart&&e===this._generation&&"idle"===this.state&&this.start())}destroy(){"destroyed"!==this.state&&(this._clearSchedule(),this.state="destroyed",this.isPaused=!1,this.pausedTimeRemaining=null,this.startTime=null,this.endTime=null,this.element[i]===this&&delete this.element[i],this.elements={})}dispatchEvent(t){const e=this.options[`on${t[0].toUpperCase()}${t.slice(1)}`];let i,n=!1;try{"function"==typeof e&&e.call(this)}catch(t){n=!0,i=t}a(this.element,t,{instance:this}),n&&a(this.element,"error",{instance:this,error:i})}updateDisplay(t){const e=this.calculateTimeUnits(t);n.forEach(t=>{this.elements[t]&&this.updateElement(this.elements[t],e[t])})}updateCurrentTimeDisplay(t){const e={year:t.getFullYear(),month:t.getMonth()+1,day:t.getDate(),hour:t.getHours(),minute:t.getMinutes(),second:t.getSeconds()};n.forEach(t=>{this.elements[t]&&this.updateElement(this.elements[t],e[t])})}updateElement(t,e){t.textContent=this.formatValue(e,t.getAttribute("data-swe-format"))}formatValue(t,e){return String(t).padStart(e?e.length:0,"0")}calculateTimeUnits(t){const e={year:0,month:0,day:0,hour:0,minute:0,second:0};let i=1e3*Math.ceil(Math.max(0,t)/1e3),n=new Date;const a=new Date(Math.min(864e13,n.getTime()+i));return["year","month"].forEach(t=>{if(!this.elements[t]||0===i)return;const s="year"===t?12:1,r=12*(a.getFullYear()-n.getFullYear())+a.getMonth()-n.getMonth();let h=Math.max(0,Math.floor(r/s)),d=o(n,h*s);(!Number.isFinite(d.getTime())||d>a)&&h>0&&(d=o(n,--h*s)),e[t]=h,n=d,i=Math.max(0,a.getTime()-n.getTime())}),["day","hour","minute","second"].forEach(t=>{this.elements[t]&&(e[t]=Math.floor(i/s[t]),i%=s[t])}),e}}const h=r;t.d(e,["default",0,h]),module.exports=e.default})();

package/dist/swe.d.cts

@@ -0,0 +1,66 @@
+declare namespace SWE {
+/** Options take precedence over data attributes. countdownEnd wins over duration. */
+interface SWEOptions {
+    autostart?: boolean;
+    /** Finite, nonnegative seconds; fractional seconds are supported. */
+    duration?: number | string;
+    countdownEnd?: string | number | Date;
+    onTick?: (this: SWE) => void;
+    onEnd?: (this: SWE) => void;
+    onStart?: (this: SWE) => void;
+    onPause?: (this: SWE) => void;
+    onResume?: (this: SWE) => void;
+    onReset?: (this: SWE) => void;
+    onStop?: (this: SWE) => void;
+}
+
+type SWEState = 'idle' | 'running' | 'paused' | 'stopped' | 'completed' | 'destroyed';
+type SWEMode = 'countdown-end' | 'countdown-duration' | 'current';
+interface SWEEventDetail { instance: SWE; }
+interface SWEErrorDetail { instance: SWE | null; error: unknown; }
+interface SWETimeUnits {
+    year: number; month: number; day: number; hour: number; minute: number; second: number;
+}
+
+
+}
+declare class SWE {
+    constructor(element: HTMLElement, options?: SWE.SWEOptions);
+    static init(root?: Document | Element | DocumentFragment): SWE[];
+    static getInstance(element: HTMLElement): SWE | undefined;
+    readonly element: HTMLElement;
+    readonly options: SWE.SWEOptions;
+    readonly mode: SWE.SWEMode;
+    readonly state: SWE.SWEState;
+    readonly isPaused: boolean;
+    readonly intervalId: number | null;
+    readonly startTime: number | null;
+    readonly endTime: number | null;
+    readonly pausedTimeRemaining: number | null;
+    readonly elements: Partial<Record<keyof SWE.SWETimeUnits, HTMLElement | null>>;
+    start(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    reset(): void;
+    destroy(): void;
+    calculateTimeUnits(milliseconds: number): SWE.SWETimeUnits;
+    formatValue(value: number, format?: string | null): string;
+    updateDisplay(milliseconds: number): void;
+    updateCurrentTimeDisplay(date: Date): void;
+}
+
+declare global {
+    interface HTMLElementEventMap {
+        'swe:start': CustomEvent<SWE.SWEEventDetail>;
+        'swe:tick': CustomEvent<SWE.SWEEventDetail>;
+        'swe:pause': CustomEvent<SWE.SWEEventDetail>;
+        'swe:resume': CustomEvent<SWE.SWEEventDetail>;
+        'swe:reset': CustomEvent<SWE.SWEEventDetail>;
+        'swe:stop': CustomEvent<SWE.SWEEventDetail>;
+        'swe:end': CustomEvent<SWE.SWEEventDetail>;
+        'swe:error': CustomEvent<SWE.SWEErrorDetail>;
+    }
+}
+
+export = SWE;

package/dist/swe.d.mts

@@ -0,0 +1,63 @@
+/** Options take precedence over data attributes. countdownEnd wins over duration. */
+export interface SWEOptions {
+    autostart?: boolean;
+    /** Finite, nonnegative seconds; fractional seconds are supported. */
+    duration?: number | string;
+    countdownEnd?: string | number | Date;
+    onTick?: (this: SWE) => void;
+    onEnd?: (this: SWE) => void;
+    onStart?: (this: SWE) => void;
+    onPause?: (this: SWE) => void;
+    onResume?: (this: SWE) => void;
+    onReset?: (this: SWE) => void;
+    onStop?: (this: SWE) => void;
+}
+
+export type SWEState = 'idle' | 'running' | 'paused' | 'stopped' | 'completed' | 'destroyed';
+export type SWEMode = 'countdown-end' | 'countdown-duration' | 'current';
+export interface SWEEventDetail { instance: SWE; }
+export interface SWEErrorDetail { instance: SWE | null; error: unknown; }
+export interface SWETimeUnits {
+    year: number; month: number; day: number; hour: number; minute: number; second: number;
+}
+
+declare class SWE {
+    constructor(element: HTMLElement, options?: SWEOptions);
+    static init(root?: Document | Element | DocumentFragment): SWE[];
+    static getInstance(element: HTMLElement): SWE | undefined;
+    readonly element: HTMLElement;
+    readonly options: SWEOptions;
+    readonly mode: SWEMode;
+    readonly state: SWEState;
+    readonly isPaused: boolean;
+    readonly intervalId: number | null;
+    readonly startTime: number | null;
+    readonly endTime: number | null;
+    readonly pausedTimeRemaining: number | null;
+    readonly elements: Partial<Record<keyof SWETimeUnits, HTMLElement | null>>;
+    start(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    reset(): void;
+    destroy(): void;
+    calculateTimeUnits(milliseconds: number): SWETimeUnits;
+    formatValue(value: number, format?: string | null): string;
+    updateDisplay(milliseconds: number): void;
+    updateCurrentTimeDisplay(date: Date): void;
+}
+
+declare global {
+    interface HTMLElementEventMap {
+        'swe:start': CustomEvent<SWEEventDetail>;
+        'swe:tick': CustomEvent<SWEEventDetail>;
+        'swe:pause': CustomEvent<SWEEventDetail>;
+        'swe:resume': CustomEvent<SWEEventDetail>;
+        'swe:reset': CustomEvent<SWEEventDetail>;
+        'swe:stop': CustomEvent<SWEEventDetail>;
+        'swe:end': CustomEvent<SWEEventDetail>;
+        'swe:error': CustomEvent<SWEErrorDetail>;
+    }
+}
+
+export default SWE;

package/dist/swe.d.ts

@@ -0,0 +1,63 @@
+/** Options take precedence over data attributes. countdownEnd wins over duration. */
+export interface SWEOptions {
+    autostart?: boolean;
+    /** Finite, nonnegative seconds; fractional seconds are supported. */
+    duration?: number | string;
+    countdownEnd?: string | number | Date;
+    onTick?: (this: SWE) => void;
+    onEnd?: (this: SWE) => void;
+    onStart?: (this: SWE) => void;
+    onPause?: (this: SWE) => void;
+    onResume?: (this: SWE) => void;
+    onReset?: (this: SWE) => void;
+    onStop?: (this: SWE) => void;
+}
+
+export type SWEState = 'idle' | 'running' | 'paused' | 'stopped' | 'completed' | 'destroyed';
+export type SWEMode = 'countdown-end' | 'countdown-duration' | 'current';
+export interface SWEEventDetail { instance: SWE; }
+export interface SWEErrorDetail { instance: SWE | null; error: unknown; }
+export interface SWETimeUnits {
+    year: number; month: number; day: number; hour: number; minute: number; second: number;
+}
+
+declare class SWE {
+    constructor(element: HTMLElement, options?: SWEOptions);
+    static init(root?: Document | Element | DocumentFragment): SWE[];
+    static getInstance(element: HTMLElement): SWE | undefined;
+    readonly element: HTMLElement;
+    readonly options: SWEOptions;
+    readonly mode: SWEMode;
+    readonly state: SWEState;
+    readonly isPaused: boolean;
+    readonly intervalId: number | null;
+    readonly startTime: number | null;
+    readonly endTime: number | null;
+    readonly pausedTimeRemaining: number | null;
+    readonly elements: Partial<Record<keyof SWETimeUnits, HTMLElement | null>>;
+    start(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    reset(): void;
+    destroy(): void;
+    calculateTimeUnits(milliseconds: number): SWETimeUnits;
+    formatValue(value: number, format?: string | null): string;
+    updateDisplay(milliseconds: number): void;
+    updateCurrentTimeDisplay(date: Date): void;
+}
+
+declare global {
+    interface HTMLElementEventMap {
+        'swe:start': CustomEvent<SWEEventDetail>;
+        'swe:tick': CustomEvent<SWEEventDetail>;
+        'swe:pause': CustomEvent<SWEEventDetail>;
+        'swe:resume': CustomEvent<SWEEventDetail>;
+        'swe:reset': CustomEvent<SWEEventDetail>;
+        'swe:stop': CustomEvent<SWEEventDetail>;
+        'swe:end': CustomEvent<SWEEventDetail>;
+        'swe:error': CustomEvent<SWEErrorDetail>;
+    }
+}
+
+export default SWE;

package/dist/swe.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.SWE=e():t.SWE=e()}(this,()=>(()=>{"use strict";var t={d:(e,n)=>{for(var i in n)t.o(n,i)&&!t.o(e,i)&&Object.defineProperty(e,i,{enumerable:!0,get:n[i]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};function n(t){return n="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},n(t)}function i(t,e){(null==e||e>t.length)&&(e=t.length);for(var n=0,i=Array(e);n<e;n++)i[n]=t[n];return i}function o(t,e){for(var n=0;n<e.length;n++){var i=e[n];i.enumerable=i.enumerable||!1,i.configurable=!0,"value"in i&&(i.writable=!0),Object.defineProperty(t,r(i.key),i)}}function r(t){var e=function(t){if("object"!=n(t)||!t)return t;var e=t[Symbol.toPrimitive];if(void 0!==e){var i=e.call(t,"string");if("object"!=n(i))return i;throw new TypeError("@@toPrimitive must return a primitive value.")}return String(t)}(t);return"symbol"==n(e)?e:e+""}t.d(e,{default:()=>s});var a=function(){return t=function t(e){var n=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};!function(t,e){if(!(t instanceof e))throw new TypeError("Cannot call a class as a function")}(this,t),this.element=e,this.options={autostart:void 0===n.autostart||n.autostart,duration:n.duration,countdownEnd:n.countdownEnd,onTick:n.onTick,onEnd:n.onEnd,onStart:n.onStart,onPause:n.onPause,onResume:n.onResume,onReset:n.onReset,onStop:n.onStop},this.intervalId=null,this.isPaused=!1,this.startTime=null,this.pausedTimeRemaining=null,this.endTime=null,this.initialize()},(e=[{key:"initialize",value:function(){if(!(this.element&&this.element instanceof HTMLElement))throw new Error("SWE: Invalid element provided");if(this.mode=this.determineMode(),this.setupElements(),this.options.autostart)this.start();else if("countdown-duration"===this.mode&&this.options.duration)this.updateDisplay(1e3*this.options.duration);else if("countdown-end"===this.mode&&this.options.countdownEnd){var t=new Date(this.options.countdownEnd),e=new Date,n=t.getTime()-e.getTime();this.updateDisplay(n>0?n:0)}}},{key:"determineMode",value:function(){if(this.options.countdownEnd)return"countdown-end";if(this.options.duration)return"countdown-duration";if(this.element.hasAttribute("data-swe-countdown-end"))return"countdown-end";if(this.element.hasAttribute("data-swe-countdown-duration"))return"countdown-duration";if(this.element.hasAttribute("data-swe-current"))return"current";if(this.options.countdownEnd)return"countdown-end";throw new Error("SWE: Invalid mode - missing required configuration")}},{key:"setupElements",value:function(){this.elements={year:this.element.querySelector("[data-swe-year]"),month:this.element.querySelector("[data-swe-month]"),day:this.element.querySelector("[data-swe-day]"),hour:this.element.querySelector("[data-swe-hour]"),minute:this.element.querySelector("[data-swe-minute]"),second:this.element.querySelector("[data-swe-second]")}}},{key:"start",value:function(){if(!this.intervalId){switch(this.isPaused=!1,this.startTime=Date.now(),this.mode){case"countdown-end":this.startCountdownToDate();break;case"countdown-duration":this.startCountdownDuration();break;case"current":this.startCurrentTime()}this.dispatchEvent("start")}}},{key:"startCountdownToDate",value:function(){var t=new Date(this.options.countdownEnd||this.element.getAttribute("data-swe-countdown-end"));if(isNaN(t.getTime()))throw new Error("SWE: Invalid end date format");this.endTime=t.getTime(),this.updateTimer()}},{key:"startCountdownDuration",value:function(){var t=this.options.duration||parseInt(this.element.getAttribute("data-swe-countdown-duration"),10);if(isNaN(t)||t<0)throw new Error("SWE: Invalid duration");null!==this.pausedTimeRemaining?this.endTime=Date.now()+this.pausedTimeRemaining:this.endTime=Date.now()+1e3*t,this.updateTimer()}},{key:"updateTimer",value:function(){var t=this,e=function(){var e=Date.now(),n=t.endTime-e;return n<=0?(t.stop(),t.updateDisplay(0),t.dispatchEvent("end"),!1):(t.updateDisplay(n),t.dispatchEvent("tick"),!0)};e()&&(this.intervalId=setInterval(e,1e3))}},{key:"startCurrentTime",value:function(){var t=this,e=function(){var e=new Date;t.updateCurrentTimeDisplay(e),t.dispatchEvent("tick")};e(),this.intervalId=setInterval(e,1e3)}},{key:"updateDisplay",value:function(t){var e=this,n=this.calculateTimeUnits(t);Object.entries(this.elements).forEach(function(t){var o=function(t,e){return function(t){if(Array.isArray(t))return t}(t)||function(t,e){var n=null==t?null:"undefined"!=typeof Symbol&&t[Symbol.iterator]||t["@@iterator"];if(null!=n){var i,o,r,a,s=[],u=!0,d=!1;try{if(r=(n=n.call(t)).next,0===e){if(Object(n)!==n)return;u=!1}else for(;!(u=(i=r.call(n)).done)&&(s.push(i.value),s.length!==e);u=!0);}catch(t){d=!0,o=t}finally{try{if(!u&&null!=n.return&&(a=n.return(),Object(a)!==a))return}finally{if(d)throw o}}return s}}(t,e)||function(t,e){if(t){if("string"==typeof t)return i(t,e);var n={}.toString.call(t).slice(8,-1);return"Object"===n&&t.constructor&&(n=t.constructor.name),"Map"===n||"Set"===n?Array.from(t):"Arguments"===n||/^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)?i(t,e):void 0}}(t,e)||function(){throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.")}()}(t,2),r=o[0],a=o[1];a&&e.updateElement(a,n[r])})}},{key:"updateCurrentTimeDisplay",value:function(t){this.elements.hour&&this.updateElement(this.elements.hour,t.getHours()),this.elements.minute&&this.updateElement(this.elements.minute,t.getMinutes()),this.elements.second&&this.updateElement(this.elements.second,t.getSeconds())}},{key:"updateElement",value:function(t,e){var n=t.getAttribute("data-swe-format");t.textContent=this.formatValue(e,n)}},{key:"formatValue",value:function(t,e){return e?t.toString().padStart(e.length,"0"):t.toString()}},{key:"calculateTimeUnits",value:function(t){var e=Math.floor(t/1e3),n=Math.floor(e/60),i=Math.floor(n/60),o=(Math.floor(i/24),new Date),r=new Date(o.getTime()+t),a=r.getFullYear()-o.getFullYear(),s=r.getMonth()-o.getMonth(),u=r.getDate()-o.getDate();return u<0&&(s--,u+=new Date(r.getFullYear(),r.getMonth(),0).getDate()),s<0&&(a--,s+=12),{year:a,month:s,day:u,hour:i%24,minute:n%60,second:e%60}}},{key:"dispatchEvent",value:function(t){var e="on".concat(t.charAt(0).toUpperCase()+t.slice(1));"function"==typeof this.options[e]&&this.options[e].call(this);var n=new CustomEvent("swe:".concat(t),{bubbles:!0,detail:{instance:this}});this.element.dispatchEvent(n)}},{key:"pause",value:function(){this.intervalId&&!this.isPaused&&(clearInterval(this.intervalId),this.intervalId=null,this.isPaused=!0,this.pausedTimeRemaining=this.endTime-Date.now(),this.dispatchEvent("pause"))}},{key:"resume",value:function(){if(this.isPaused){switch(this.isPaused=!1,this.startTime=Date.now(),this.mode){case"countdown-end":this.startCountdownToDate();break;case"countdown-duration":this.startCountdownDuration();break;case"current":this.startCurrentTime()}this.dispatchEvent("resume")}}},{key:"reset",value:function(){if(this.stop(),this.pausedTimeRemaining=null,this.endTime=null,"countdown-end"===this.mode&&this.options.countdownEnd){var t=new Date(this.options.countdownEnd),e=new Date,n=t.getTime()-e.getTime();this.updateDisplay(n>0?n:0)}else"countdown-duration"===this.mode&&this.options.duration&&this.updateDisplay(1e3*this.options.duration);this.dispatchEvent("reset"),this.options.autostart&&this.start()}},{key:"stop",value:function(){var t=null!==this.intervalId;this.intervalId&&(clearInterval(this.intervalId),this.intervalId=null),this.isPaused=!1,t&&this.dispatchEvent("stop")}}])&&o(t.prototype,e),Object.defineProperty(t,"prototype",{writable:!1}),t;var t,e}();document.addEventListener("DOMContentLoaded",function(){document.querySelectorAll("[data-swe]").forEach(function(t){new a(t)})});const s=a;return"undefined"!=typeof window&&(window.SWE=a),e.default})());
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.SWE=e():t.SWE=e()}(globalThis,()=>(()=>{"use strict";const t={d:(e,i)=>{for(var n in i)t.o(i,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:i[n]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)};let e={};t.d(e,{default:()=>d});const i=Symbol.for("senangwebs-epoch.instance"),n=["year","month","day","hour","minute","second"],s={day:864e5,hour:36e5,minute:6e4,second:1e3};function o(t,e,i){const n=t.ownerDocument&&t.ownerDocument.defaultView,s=n?n.CustomEvent:globalThis.CustomEvent;t.dispatchEvent(new s(`swe:${e}`,{bubbles:!0,detail:i}))}function a(t,e){const i=new Date(t.getTime());if(0===e)return i;const n=i.getDate();i.setDate(1),i.setMonth(i.getMonth()+e);const s=i.getFullYear(),o=[31,s%4!=0||s%100==0&&s%400!=0?28:29,31,30,31,30,31,31,30,31,30,31][i.getMonth()];return i.setDate(Math.min(n,o)),i}class r{constructor(t,e={}){const n=t&&t.ownerDocument&&t.ownerDocument.defaultView,s=n?n.HTMLElement:globalThis.HTMLElement;if(!(s&&t instanceof s))throw new Error("SWE: Invalid element provided");if(!e||"object"!=typeof e)throw new Error("SWE: Invalid options provided");this.element=t,this.options={...e,autostart:void 0===e.autostart||e.autostart},this._view=n||globalThis,this.mode=this.determineMode(),this._normalizeConfiguration(),this.setupElements(),this.intervalId=null,this.state="idle",this.isPaused=!1,this.startTime=null,this.endTime=null,this.pausedTimeRemaining=null,this._generation=0;const o=r.getInstance(t);o&&o.destroy(),t[i]=this,this._renderInitial(),this.options.autostart&&this.start()}static getInstance(t){return t&&t[i]&&"destroyed"!==t[i].state?t[i]:void 0}static init(t=globalThis.document){if(!t||"function"!=typeof t.querySelectorAll)throw new Error("SWE: init requires a DOM root");const e=[...t.querySelectorAll("[data-swe]")];"function"==typeof t.matches&&t.matches("[data-swe]")&&e.unshift(t);const i=[];return e.forEach(t=>{try{i.push(r.getInstance(t)||new r(t))}catch(e){o(t,"error",{instance:null,error:e})}}),i}determineMode(){if(void 0!==this.options.countdownEnd)return"countdown-end";if(void 0!==this.options.duration)return"countdown-duration";if(this.element.hasAttribute("data-swe-countdown-end"))return"countdown-end";if(this.element.hasAttribute("data-swe-countdown-duration"))return"countdown-duration";if(this.element.hasAttribute("data-swe-current"))return"current";throw new Error("SWE: Invalid mode - missing required configuration")}_normalizeConfiguration(){if("countdown-end"===this.mode){const t=void 0!==this.options.countdownEnd?this.options.countdownEnd:this.element.getAttribute("data-swe-countdown-end"),e="[object Date]"===Object.prototype.toString.call(t);if(null===t||""===t||"string"!=typeof t&&!e&&"number"!=typeof t)throw new Error("SWE: Invalid end date format");if(this._targetTime=new Date(t).getTime(),!Number.isFinite(this._targetTime))throw new Error("SWE: Invalid end date format")}else if("countdown-duration"===this.mode){const t=void 0!==this.options.duration?this.options.duration:this.element.getAttribute("data-swe-countdown-duration"),e="number"==typeof t||"string"==typeof t&&/^\s*\d+(?:\.\d+)?\s*$/.test(t)?Number(t):NaN;if(this._durationMilliseconds=1e3*e,!Number.isFinite(e)||e<0||!Number.isSafeInteger(Math.ceil(this._durationMilliseconds))||!Number.isFinite(new Date(Date.now()+this._durationMilliseconds).getTime()))throw new Error("SWE: Invalid duration")}}setupElements(){this.elements={},n.forEach(t=>{const e=`[data-swe-${t}]`,i=this.element.querySelectorAll?[...this.element.querySelectorAll(e)]:[this.element.querySelector(e)];this.elements[t]=i.find(t=>{if(!t)return!1;const e=t.closest&&t.closest("[data-swe]");return!e||e===this.element||!this.element.contains(e)})||null})}_now(){return this._view.performance?this._view.performance.now():Date.now()}_remaining(){return"countdown-duration"===this.mode?this._deadline-this._now():this._targetTime-Date.now()}_clearSchedule(){this._generation++,null!==this.intervalId&&this._view.clearInterval(this.intervalId),this.intervalId=null}_renderInitial(){"current"===this.mode?this.updateCurrentTimeDisplay(new Date):this.updateDisplay("countdown-duration"===this.mode?this._durationMilliseconds:Math.max(0,this._targetTime-Date.now()))}start(){if("paused"===this.state)return this.resume();["running","completed","destroyed"].includes(this.state)||this._begin("start")}_begin(t){if(this._clearSchedule(),this.state="running",this.isPaused=!1,this.startTime=Date.now(),"countdown-duration"===this.mode){const t=null===this.pausedTimeRemaining?this._durationMilliseconds:this.pausedTimeRemaining;this._deadline=this._now()+t,this.endTime=Date.now()+t,this.pausedTimeRemaining=null}else"countdown-end"===this.mode&&(this.endTime=this._targetTime);const e=this._generation;this.dispatchEvent(t),"running"===this.state&&e===this._generation&&(this._tick(),"running"===this.state&&e===this._generation&&(this.intervalId=this._view.setInterval(()=>{e===this._generation&&"running"===this.state&&this._tick()},1e3)))}_tick(){if("current"===this.mode)return this.updateCurrentTimeDisplay(new Date),void this.dispatchEvent("tick");const t=this._remaining();t<=0?(this._clearSchedule(),this.state="completed",this.isPaused=!1,this.pausedTimeRemaining=null,this.updateDisplay(0),this.dispatchEvent("stop"),this.dispatchEvent("end")):(this.updateDisplay(t),this.dispatchEvent("tick"))}pause(){"running"===this.state&&(this.pausedTimeRemaining="countdown-duration"===this.mode?Math.max(0,this._remaining()):null,this._clearSchedule(),this.state="paused",this.isPaused=!0,this.dispatchEvent("pause"))}resume(){"paused"===this.state&&this._begin("resume")}stop(){if("destroyed"===this.state||"completed"===this.state)return;const t="running"===this.state||"paused"===this.state;this._clearSchedule(),this.state="stopped",this.isPaused=!1,this.pausedTimeRemaining=null,this.endTime=null,t&&this.dispatchEvent("stop")}reset(){if("destroyed"===this.state)return;const t="running"===this.state||"paused"===this.state;this._clearSchedule(),this.state="idle",this.isPaused=!1,this.pausedTimeRemaining=null,this.startTime=null,this.endTime=null,this._renderInitial();const e=this._generation;t&&this.dispatchEvent("stop"),e===this._generation&&"idle"===this.state&&(this.dispatchEvent("reset"),this.options.autostart&&e===this._generation&&"idle"===this.state&&this.start())}destroy(){"destroyed"!==this.state&&(this._clearSchedule(),this.state="destroyed",this.isPaused=!1,this.pausedTimeRemaining=null,this.startTime=null,this.endTime=null,this.element[i]===this&&delete this.element[i],this.elements={})}dispatchEvent(t){const e=this.options[`on${t[0].toUpperCase()}${t.slice(1)}`];let i,n=!1;try{"function"==typeof e&&e.call(this)}catch(t){n=!0,i=t}o(this.element,t,{instance:this}),n&&o(this.element,"error",{instance:this,error:i})}updateDisplay(t){const e=this.calculateTimeUnits(t);n.forEach(t=>{this.elements[t]&&this.updateElement(this.elements[t],e[t])})}updateCurrentTimeDisplay(t){const e={year:t.getFullYear(),month:t.getMonth()+1,day:t.getDate(),hour:t.getHours(),minute:t.getMinutes(),second:t.getSeconds()};n.forEach(t=>{this.elements[t]&&this.updateElement(this.elements[t],e[t])})}updateElement(t,e){t.textContent=this.formatValue(e,t.getAttribute("data-swe-format"))}formatValue(t,e){return String(t).padStart(e?e.length:0,"0")}calculateTimeUnits(t){const e={year:0,month:0,day:0,hour:0,minute:0,second:0};let i=1e3*Math.ceil(Math.max(0,t)/1e3),n=new Date;const o=new Date(Math.min(864e13,n.getTime()+i));return["year","month"].forEach(t=>{if(!this.elements[t]||0===i)return;const s="year"===t?12:1,r=12*(o.getFullYear()-n.getFullYear())+o.getMonth()-n.getMonth();let h=Math.max(0,Math.floor(r/s)),d=a(n,h*s);(!Number.isFinite(d.getTime())||d>o)&&h>0&&(d=a(n,--h*s)),e[t]=h,n=d,i=Math.max(0,o.getTime()-n.getTime())}),["day","hour","minute","second"].forEach(t=>{this.elements[t]&&(e[t]=Math.floor(i/s[t]),i%=s[t])}),e}}const h=r;"undefined"!=typeof document&&("undefined"!=typeof window&&(window.SWE=h),"loading"===document.readyState?document.addEventListener("DOMContentLoaded",()=>h.init(document),{once:!0}):h.init(document));const d=h;return e=e.default,e})());

package/dist/swe.mjs

@@ -0,0 +1 @@
+const t={d:(e,i)=>{if(Array.isArray(i))for(var n=0;n<i.length;){var s=i[n++],a=i[n++],o=0===a?{enumerable:!0,value:i[n++]}:{enumerable:!0,get:a};t.o(e,s)||Object.defineProperty(e,s,o)}else for(var s in i)t.o(i,s)&&!t.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:i[s]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)};let e={};const i=Symbol.for("senangwebs-epoch.instance"),n=["year","month","day","hour","minute","second"],s={day:864e5,hour:36e5,minute:6e4,second:1e3};function a(t,e,i){const n=t.ownerDocument&&t.ownerDocument.defaultView,s=n?n.CustomEvent:globalThis.CustomEvent;t.dispatchEvent(new s(`swe:${e}`,{bubbles:!0,detail:i}))}function o(t,e){const i=new Date(t.getTime());if(0===e)return i;const n=i.getDate();i.setDate(1),i.setMonth(i.getMonth()+e);const s=i.getFullYear(),a=[31,s%4!=0||s%100==0&&s%400!=0?28:29,31,30,31,30,31,31,30,31,30,31][i.getMonth()];return i.setDate(Math.min(n,a)),i}class r{constructor(t,e={}){const n=t&&t.ownerDocument&&t.ownerDocument.defaultView,s=n?n.HTMLElement:globalThis.HTMLElement;if(!(s&&t instanceof s))throw new Error("SWE: Invalid element provided");if(!e||"object"!=typeof e)throw new Error("SWE: Invalid options provided");this.element=t,this.options={...e,autostart:void 0===e.autostart||e.autostart},this._view=n||globalThis,this.mode=this.determineMode(),this._normalizeConfiguration(),this.setupElements(),this.intervalId=null,this.state="idle",this.isPaused=!1,this.startTime=null,this.endTime=null,this.pausedTimeRemaining=null,this._generation=0;const a=r.getInstance(t);a&&a.destroy(),t[i]=this,this._renderInitial(),this.options.autostart&&this.start()}static getInstance(t){return t&&t[i]&&"destroyed"!==t[i].state?t[i]:void 0}static init(t=globalThis.document){if(!t||"function"!=typeof t.querySelectorAll)throw new Error("SWE: init requires a DOM root");const e=[...t.querySelectorAll("[data-swe]")];"function"==typeof t.matches&&t.matches("[data-swe]")&&e.unshift(t);const i=[];return e.forEach(t=>{try{i.push(r.getInstance(t)||new r(t))}catch(e){a(t,"error",{instance:null,error:e})}}),i}determineMode(){if(void 0!==this.options.countdownEnd)return"countdown-end";if(void 0!==this.options.duration)return"countdown-duration";if(this.element.hasAttribute("data-swe-countdown-end"))return"countdown-end";if(this.element.hasAttribute("data-swe-countdown-duration"))return"countdown-duration";if(this.element.hasAttribute("data-swe-current"))return"current";throw new Error("SWE: Invalid mode - missing required configuration")}_normalizeConfiguration(){if("countdown-end"===this.mode){const t=void 0!==this.options.countdownEnd?this.options.countdownEnd:this.element.getAttribute("data-swe-countdown-end"),e="[object Date]"===Object.prototype.toString.call(t);if(null===t||""===t||"string"!=typeof t&&!e&&"number"!=typeof t)throw new Error("SWE: Invalid end date format");if(this._targetTime=new Date(t).getTime(),!Number.isFinite(this._targetTime))throw new Error("SWE: Invalid end date format")}else if("countdown-duration"===this.mode){const t=void 0!==this.options.duration?this.options.duration:this.element.getAttribute("data-swe-countdown-duration"),e="number"==typeof t||"string"==typeof t&&/^\s*\d+(?:\.\d+)?\s*$/.test(t)?Number(t):NaN;if(this._durationMilliseconds=1e3*e,!Number.isFinite(e)||e<0||!Number.isSafeInteger(Math.ceil(this._durationMilliseconds))||!Number.isFinite(new Date(Date.now()+this._durationMilliseconds).getTime()))throw new Error("SWE: Invalid duration")}}setupElements(){this.elements={},n.forEach(t=>{const e=`[data-swe-${t}]`,i=this.element.querySelectorAll?[...this.element.querySelectorAll(e)]:[this.element.querySelector(e)];this.elements[t]=i.find(t=>{if(!t)return!1;const e=t.closest&&t.closest("[data-swe]");return!e||e===this.element||!this.element.contains(e)})||null})}_now(){return this._view.performance?this._view.performance.now():Date.now()}_remaining(){return"countdown-duration"===this.mode?this._deadline-this._now():this._targetTime-Date.now()}_clearSchedule(){this._generation++,null!==this.intervalId&&this._view.clearInterval(this.intervalId),this.intervalId=null}_renderInitial(){"current"===this.mode?this.updateCurrentTimeDisplay(new Date):this.updateDisplay("countdown-duration"===this.mode?this._durationMilliseconds:Math.max(0,this._targetTime-Date.now()))}start(){if("paused"===this.state)return this.resume();["running","completed","destroyed"].includes(this.state)||this._begin("start")}_begin(t){if(this._clearSchedule(),this.state="running",this.isPaused=!1,this.startTime=Date.now(),"countdown-duration"===this.mode){const t=null===this.pausedTimeRemaining?this._durationMilliseconds:this.pausedTimeRemaining;this._deadline=this._now()+t,this.endTime=Date.now()+t,this.pausedTimeRemaining=null}else"countdown-end"===this.mode&&(this.endTime=this._targetTime);const e=this._generation;this.dispatchEvent(t),"running"===this.state&&e===this._generation&&(this._tick(),"running"===this.state&&e===this._generation&&(this.intervalId=this._view.setInterval(()=>{e===this._generation&&"running"===this.state&&this._tick()},1e3)))}_tick(){if("current"===this.mode)return this.updateCurrentTimeDisplay(new Date),void this.dispatchEvent("tick");const t=this._remaining();t<=0?(this._clearSchedule(),this.state="completed",this.isPaused=!1,this.pausedTimeRemaining=null,this.updateDisplay(0),this.dispatchEvent("stop"),this.dispatchEvent("end")):(this.updateDisplay(t),this.dispatchEvent("tick"))}pause(){"running"===this.state&&(this.pausedTimeRemaining="countdown-duration"===this.mode?Math.max(0,this._remaining()):null,this._clearSchedule(),this.state="paused",this.isPaused=!0,this.dispatchEvent("pause"))}resume(){"paused"===this.state&&this._begin("resume")}stop(){if("destroyed"===this.state||"completed"===this.state)return;const t="running"===this.state||"paused"===this.state;this._clearSchedule(),this.state="stopped",this.isPaused=!1,this.pausedTimeRemaining=null,this.endTime=null,t&&this.dispatchEvent("stop")}reset(){if("destroyed"===this.state)return;const t="running"===this.state||"paused"===this.state;this._clearSchedule(),this.state="idle",this.isPaused=!1,this.pausedTimeRemaining=null,this.startTime=null,this.endTime=null,this._renderInitial();const e=this._generation;t&&this.dispatchEvent("stop"),e===this._generation&&"idle"===this.state&&(this.dispatchEvent("reset"),this.options.autostart&&e===this._generation&&"idle"===this.state&&this.start())}destroy(){"destroyed"!==this.state&&(this._clearSchedule(),this.state="destroyed",this.isPaused=!1,this.pausedTimeRemaining=null,this.startTime=null,this.endTime=null,this.element[i]===this&&delete this.element[i],this.elements={})}dispatchEvent(t){const e=this.options[`on${t[0].toUpperCase()}${t.slice(1)}`];let i,n=!1;try{"function"==typeof e&&e.call(this)}catch(t){n=!0,i=t}a(this.element,t,{instance:this}),n&&a(this.element,"error",{instance:this,error:i})}updateDisplay(t){const e=this.calculateTimeUnits(t);n.forEach(t=>{this.elements[t]&&this.updateElement(this.elements[t],e[t])})}updateCurrentTimeDisplay(t){const e={year:t.getFullYear(),month:t.getMonth()+1,day:t.getDate(),hour:t.getHours(),minute:t.getMinutes(),second:t.getSeconds()};n.forEach(t=>{this.elements[t]&&this.updateElement(this.elements[t],e[t])})}updateElement(t,e){t.textContent=this.formatValue(e,t.getAttribute("data-swe-format"))}formatValue(t,e){return String(t).padStart(e?e.length:0,"0")}calculateTimeUnits(t){const e={year:0,month:0,day:0,hour:0,minute:0,second:0};let i=1e3*Math.ceil(Math.max(0,t)/1e3),n=new Date;const a=new Date(Math.min(864e13,n.getTime()+i));return["year","month"].forEach(t=>{if(!this.elements[t]||0===i)return;const s="year"===t?12:1,r=12*(a.getFullYear()-n.getFullYear())+a.getMonth()-n.getMonth();let h=Math.max(0,Math.floor(r/s)),d=o(n,h*s);(!Number.isFinite(d.getTime())||d>a)&&h>0&&(d=o(n,--h*s)),e[t]=h,n=d,i=Math.max(0,a.getTime()-n.getTime())}),["day","hour","minute","second"].forEach(t=>{this.elements[t]&&(e[t]=Math.floor(i/s[t]),i%=s[t])}),e}}const h=r;t.d(e,["A",0,h]);const d=e.A;export{d as default};

package/index.js

@@ -4,4 +4,4 @@
  */
 
 // Export the main library
-module.exports = require('./dist/swe.js');
+module.exports = require('./dist/swe.cjs');