@wcstack/timer 1.15.0 → 1.17.0

package/README.ja.md

@@ -135,6 +135,55 @@ npm install @wcstack/timer
 
 イベント委譲を使うため動的に追加された要素でも動作し、`closest()` によりネストした要素（ボタン内のアイコンなど）にも対応します。一致したクリックは `start()` の前に `event.preventDefault()` を呼ぶため、要素の既定動作は抑制されます。既定動作も必要な要素（実際の `<a href>` リンクや form 送信ボタンなど）には `data-timertarget` を付けないでください（キャンセルされます）。
 
+## `:state()` による CSS スタイリング
+
+`<wcs-timer>` は 1 つの boolean 出力ステートを
+[`ElementInternals` の `CustomStateSet`](https://developer.mozilla.org/ja/docs/Web/API/CustomStateSet)
+に反映します。そのため `data-wcs` バインディングやクラスの手動トグルなしに、CSS の
+`:state()` 疑似クラスで直接スタイリングできます。
+
+| ステート | on になる条件 |
+|----------|----------------|
+| `running` | `wcs-timer:running-changed` が `true` で発火（`false` でクリア） |
+
+`<wcs-timer>` には `error` イベントが無いため、`error` ステートは反映されません。
+
+```css
+wcs-timer:state(running) ~ .indicator { color: green; }
+```
+
+属性やクラスと異なり `:state()` は要素の外部から書き込めないため、この出力ステートが
+入力と混同される心配がありません。
+
+**対応ブラウザ**（新構文 `:state(x)`）: Chrome/Edge 125+、Safari 17.4+、Firefox 126+。
+非対応の環境ではステートが一切 set されないだけです — `:state()` セレクタがマッチしなく
+なりますが、`<wcs-timer>` 自体は通常どおり動作し続けます（graceful degradation・never-throw）。
+
+**SSR:** `:state()` は HTML にシリアライズできないため、サーバーレンダリングされた
+マークアップの初期ペイントにはこれらのステートは乗りません（`@wcstack/server` は無改変）。
+ハイドレーション前の見た目を制御したい場合は、代わりに `wcs-timer:not(:defined)` と組み合わせてください。
+
+### デバッグ
+
+カスタムステートは DevTools の Elements パネルには表示されず、`attachInternals()`
+は同一要素に 2 回呼べないため、コンソールから直接覗く手段がありません。そのための
+デバッグ専用の補助を 2 つ用意しています:
+
+- `el.debugStates` — 現在 on になっているステート名の**スナップショット**配列
+  （例: `["running"]`）。`wc-bindable` の一部ではなく（バインド対象ではない）、
+  形状も契約として保証されません — デバッグ用途にのみ使ってください。
+- `debug-states` 属性（opt-in・既定 OFF）は、ステート変化を要素の
+  `data-wcs-state-running` 属性にミラーします。
+  Elements パネルを開いておけば、トグルのたびにハイライトされます:
+
+  ```html
+  <wcs-timer interval="1000" debug-states></wcs-timer>
+  ```
+
+**CSS は `data-wcs-state-*` ではなく `:state()` に書いてください。** ミラーされた
+属性は、DevTools を開いた状態でステート変化を可視化するためだけのものであり、
+スタイリング用の正式なフックではありません。
+
 ## 設定
 
 `bootstrapTimer()` が `<wcs-timer>` を登録し、必要に応じて既定値を上書きします。部分的な設定を渡せます。

package/README.md

@@ -142,6 +142,57 @@ If `autoTrigger` is enabled (default), clicking an element carrying `data-timert
 
 Event delegation is used, so it also works for dynamically added elements, and `closest()` handles nested targets (e.g. an icon inside the button). A matched click calls `event.preventDefault()` before starting the timer, so the element's default action is suppressed — do not put `data-timertarget` on an element whose default action you also want (a real `<a href>` link, a form-submit button), as it will be cancelled.
 
+## CSS styling with `:state()`
+
+`<wcs-timer>` reflects one boolean output state onto its
+[`ElementInternals` `CustomStateSet`](https://developer.mozilla.org/en-US/docs/Web/API/CustomStateSet),
+so you can style it directly from CSS with the `:state()` pseudo-class — no
+`data-wcs` binding or extra class toggling required.
+
+| State | On when |
+|-------|---------|
+| `running` | `wcs-timer:running-changed` fires with `true` (cleared on `false`) |
+
+`<wcs-timer>` has no `error` event, so no `error` state is reflected.
+
+```css
+wcs-timer:state(running) ~ .indicator { color: green; }
+```
+
+Unlike attributes or classes, `:state()` cannot be written from outside the
+element, so there is no risk of confusing this output state with an input.
+
+**Browser support** (`:state(x)` syntax): Chrome/Edge 125+, Safari 17.4+,
+Firefox 126+. In older browsers the states are simply never set — `:state()`
+selectors never match, but `<wcs-timer>` itself keeps working normally
+(graceful degradation, never-throw).
+
+**SSR**: `:state()` cannot be serialized into HTML, so server-rendered markup
+never carries these states on first paint (`@wcstack/server` is unaffected).
+If you need to style the pre-hydration gap, pair your rule with
+`wcs-timer:not(:defined)` instead.
+
+### Debugging
+
+Custom states are invisible in DevTools' Elements panel and `attachInternals()`
+cannot be called twice, so there is no console way to inspect them directly.
+Two debug-only aids are provided for that:
+
+- `el.debugStates` — a **snapshot** array of the currently-on state names
+  (e.g. `["running"]`). It is not part of `wc-bindable` (not a bind target)
+  and its shape is not a guaranteed contract — use it for debugging only.
+- The `debug-states` attribute (opt-in, default off) mirrors state changes
+  onto a `data-wcs-state-running` attribute on the element, so the Elements
+  panel highlights it as it toggles:
+
+  ```html
+  <wcs-timer interval="1000" debug-states></wcs-timer>
+  ```
+
+**Write your CSS against `:state()`, not `data-wcs-state-*`.** The mirrored
+attribute exists purely to make state changes visible while debugging with
+DevTools open; it is not a supported styling hook.
+
 ## Configuration
 
 `bootstrapTimer()` registers `<wcs-timer>` and optionally overrides defaults. Pass a partial config:

package/dist/index.d.ts

@@ -159,7 +159,11 @@ declare class Timer extends HTMLElement {
     private _core;
     private _trigger;
     private _connectedCallbackPromise;
+    private _internals;
     constructor();
+    get debugStates(): string[];
+    private _initInternals;
+    private _wireStates;
     get connectedCallbackPromise(): Promise<void>;
     get interval(): number;
     set interval(value: number);

package/dist/index.esm.js

@@ -395,9 +395,62 @@ class Timer extends HTMLElement {
     _core;
     _trigger = false;
     _connectedCallbackPromise = Promise.resolve();
+    _internals = null;
     constructor() {
         super();
         this._core = new TimerCore(this);
+        this._internals = this._initInternals();
+        this._wireStates({
+            "wcs-timer:running-changed": (d) => ({ running: d === true }),
+        });
+    }
+    // CSS state reflection (:state()) — debug-only snapshot getter. NOT part of
+    // wc-bindable (not a bind target); see README "CSS styling with :state()".
+    // MUST NOT return the live CustomStateSet (that would let callers write
+    // states from outside, defeating the point of :state() being read-only).
+    get debugStates() {
+        return this._internals ? [...this._internals.states] : [];
+    }
+    _initInternals() {
+        // never-throw (async-io-node-guidelines.md §3.6): attachInternals is absent
+        // in happy-dom / older environments, and pre-125 Chromium rejects
+        // non-dashed state names from states.add() (probed and discarded here).
+        // Either case silently disables reflection — the component still works,
+        // it just doesn't expose :state() selectors.
+        try {
+            if (typeof this.attachInternals !== "function")
+                return null;
+            const internals = this.attachInternals();
+            internals.states.add("wcs-probe");
+            internals.states.delete("wcs-probe");
+            return internals;
+        }
+        catch {
+            return null;
+        }
+    }
+    _wireStates(map) {
+        if (this._internals === null)
+            return;
+        const states = this._internals.states;
+        for (const [event, toStates] of Object.entries(map)) {
+            this.addEventListener(event, (e) => {
+                const debug = this.hasAttribute("debug-states");
+                for (const [name, on] of Object.entries(toStates(e.detail))) {
+                    try {
+                        if (on) {
+                            states.add(name);
+                        }
+                        else {
+                            states.delete(name);
+                        }
+                    }
+                    catch { /* never-throw */ }
+                    if (debug)
+                        this.toggleAttribute(`data-wcs-state-${name}`, on);
+                }
+            });
+        }
     }
     // SSR (§4.1/§4.4): the Shell exposes the Core's readiness so a server-side
     // renderer can await the connect-time probe before snapshotting. The timer has

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/core/TimerCore.ts","../src/autoTrigger.ts","../src/components/Timer.ts","../src/registerComponents.ts","../src/bootstrapTimer.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  autoTrigger: boolean;\n  triggerAttribute: string;\n  tagNames: {\n    timer: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  autoTrigger: true,\n  triggerAttribute: \"data-timertarget\",\n  tagNames: {\n    timer: \"wcs-timer\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\n// Internal-only live handle to the mutable config. NOT part of the public API\n// (deliberately absent from exports.ts) — it is exported solely so sibling\n// modules in this package can read current settings cheaply. External consumers\n// must use getConfig() (returns a deep-frozen snapshot) / setConfig(). Mutating\n// this object directly bypasses the frozenConfig cache and is unsupported.\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (typeof partialConfig.autoTrigger === \"boolean\") {\n    _config.autoTrigger = partialConfig.autoTrigger;\n  }\n  if (typeof partialConfig.triggerAttribute === \"string\") {\n    _config.triggerAttribute = partialConfig.triggerAttribute;\n  }\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IWcBindable } from \"../types.js\";\n\nexport interface TimerStartOptions {\n  interval?: number;\n  repeat?: number;\n  immediate?: boolean;\n}\n\n/**\n * Headless timer primitive. A thin, framework-agnostic wrapper around\n * `setInterval` exposed through the wc-bindable protocol: it streams `tick`\n * (a monotonically increasing counter), `elapsed` (running time in ms) and a\n * `running` flag, and is driven by the `start` / `stop` / `reset` / `pause` /\n * `resume` commands.\n *\n * `tick` and `elapsed` are both surfaced via the single `wcs-timer:tick` event\n * (read through getters, mirroring how FetchCore exposes value/status from one\n * `wcs-fetch:response` event), so an observer that binds either property is\n * notified on every fire.\n */\nexport class TimerCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"tick\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\" },\n    ],\n    commands: [\n      { name: \"start\" },\n      { name: \"stop\" },\n      { name: \"reset\" },\n      { name: \"pause\" },\n      { name: \"resume\" },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _timerId: ReturnType<typeof setInterval> | null = null;\n\n  // Generation guard (§3.4): bumped on dispose() and at every async start\n  // (start()/resume()). A scheduled callback (setInterval/setTimeout) captures the\n  // generation live via `_gen`; a fire that was already queued when the timer was\n  // torn down — or superseded by a new run — has a stale gen and MUST NOT mutate\n  // state or dispatch on a disposed element. _clearTimer() removes the handle, but\n  // the guard is the belt-and-braces defense for a callback already in the queue.\n  private _gen = 0;\n  // Generation captured for the currently scheduled run, set at each async start\n  // (start()/resume()). A scheduled callback compares it against the live `_gen`;\n  // a stale callback (dispose() bumped `_gen` after this run was armed) bails.\n  private _runGen = 0;\n  // SSR (§3.8): the timer does no asynchronous probe, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  private _tick: number = 0;\n  private _running: boolean = false;\n  private _paused: boolean = false;\n\n  // `_tick` value captured at the start of the current run. `repeat` counts ticks\n  // *per run*, so the stop condition compares against this baseline rather than the\n  // cumulative `_tick` (which only resets on reset()). Without it, re-starting a\n  // completed bounded timer would stop after a single tick.\n  private _runStartTick: number = 0;\n\n  // Timer configuration (captured on start, reused by pause/resume).\n  // `_immediate` is intentionally NOT a field: it is per-run intent consumed\n  // entirely within start() (fire once, then schedule), so it lives as a local\n  // there rather than lingering as instance state no other method reads.\n  private _interval: number = 1000;\n  private _repeat: number = 0;       // 0 = unlimited\n\n  // Elapsed-time bookkeeping. `_accumulatedElapsed` holds the time folded from\n  // already-finished running segments; `_segmentStart` is the timestamp the\n  // current running segment began (null when not running). The live elapsed is\n  // the sum of the two — see _currentElapsed().\n  private _accumulatedElapsed: number = 0;\n  private _segmentStart: number | null = null;\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get tick(): number {\n    return this._tick;\n  }\n\n  get elapsed(): number {\n    return this._currentElapsed();\n  }\n\n  get running(): boolean {\n    return this._running;\n  }\n\n  // SSR readiness (§3.8): resolves after the first probe. The timer is\n  // command-driven with nothing to probe, so this is an already-resolved promise.\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  // Lifecycle (§3.5). The timer is command-driven (start/stop/...) with no\n  // ambient subscription to establish, so observe() is an idempotent no-op that\n  // resolves once ready (mirroring UploadCore). dispose() tears the timer down —\n  // it stops any running interval and bumps the generation so a callback already\n  // queued cannot fire onto a torn-down element.\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._gen++;\n    this.stop();\n  }\n\n  // --- State setters with event dispatch ---\n\n  private _dispatchTick(): void {\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:tick\", {\n      detail: { count: this._tick, elapsed: this._currentElapsed() },\n      bubbles: true,\n    }));\n  }\n\n  private _setRunning(running: boolean): void {\n    if (this._running === running) return;\n    this._running = running;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:running-changed\", {\n      detail: running,\n      bubbles: true,\n    }));\n  }\n\n  // --- Public API ---\n\n  start(options: TimerStartOptions = {}): void {\n    // Idempotent while running: a redundant start() must not stack a second\n    // setInterval (which would leak and double the tick rate). Reconfiguring an\n    // active timer is done via stop() + start().\n    if (this._running) return;\n\n    // start() begins a fresh running segment, so clear any lingering pause from a\n    // prior pause()-without-resume(). Without this, the timer would run while\n    // _paused stayed true, leaving pause() a no-op and letting resume() overwrite\n    // the live timer handle (leak + double fire).\n    this._paused = false;\n\n    // `interval` is persistent configuration: a non-positive / non-finite value\n    // (or an omitted option) keeps the previous interval (default 1000ms). The\n    // guard rejects values that would turn setInterval into a hot loop and make\n    // resume()'s `accumulated % interval` arithmetic produce NaN. The Shell already\n    // falls back to 1000 for invalid attributes; this is the backstop for direct\n    // Core API callers.\n    if (typeof options.interval === \"number\" && Number.isFinite(options.interval) && options.interval > 0) {\n      this._interval = options.interval;\n    }\n\n    // `repeat` / `immediate` are per-run intent, NOT persistent configuration:\n    // every start() re-establishes them from the options, defaulting to\n    // \"unlimited\" / \"no immediate fire\" when omitted. This keeps a bare start()\n    // after a bounded or one-shot run from silently inheriting the old bounds.\n    // `repeat` is a field (pause/resume/_fire read it across the run); `immediate`\n    // is consumed here and now, so it stays a local.\n    this._repeat = (typeof options.repeat === \"number\" && options.repeat > 0) ? options.repeat : 0;\n    const immediate = options.immediate === true;\n\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // Baseline this run's per-run repeat counting (set after _setRunning so a\n    // re-start of a completed bounded timer fires the full N ticks again).\n    this._runStartTick = this._tick;\n    // Capture this run's generation (§3.4): a scheduled fire that outlives a\n    // dispose() (which bumps `_gen`) is then recognised as stale and ignored.\n    this._runGen = ++this._gen;\n\n    // Fire immediately on start when requested. _fire() may stop the timer (when\n    // repeat is reached), so re-check _running before scheduling the interval.\n    if (immediate) {\n      this._fire();\n    }\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  }\n\n  // Swap the tick period of a live timer in place, WITHOUT re-running start().\n  // Unlike stop() + start(), this leaves the per-run repeat progress in flight\n  // (`_repeat` and its `_runStartTick` baseline) untouched, so a bounded\n  // `repeat=\"N\"` run is not re-baselined to fire N more times. It also never goes\n  // through start()'s `immediate` path, so an `immediate` timer does not fire an\n  // extra tick. Only re-arms the steady interval; pause()/resume() and reset() are\n  // unaffected. No-op when not running (interval is then plain config, captured on\n  // the next start) or when the new period is non-positive / non-finite (which\n  // would turn setInterval into a hot loop and break resume()'s modulo arithmetic).\n  changeInterval(interval: number): void {\n    if (!this._running) return;\n    if (!(typeof interval === \"number\" && Number.isFinite(interval) && interval > 0)) return;\n    if (interval === this._interval) return;\n    this._interval = interval;\n    // Re-arm the steady ticking at the new period. The current period's progress\n    // is intentionally discarded (the next tick is a full new interval away),\n    // matching the boundary reset of the previous stop()+start() behaviour.\n    this._clearTimer();\n    this._timerId = setInterval(this._fire, this._interval);\n  }\n\n  stop(): void {\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = false;\n    this._setRunning(false);\n  }\n\n  reset(): void {\n    this._clearTimer();\n    this._paused = false;\n    this._tick = 0;\n    this._accumulatedElapsed = 0;\n    this._segmentStart = null;\n    this._setRunning(false);\n    // Notify observers that the counter/elapsed have returned to zero.\n    this._dispatchTick();\n  }\n\n  pause(): void {\n    // Pause only a live timer; a no-op otherwise so it composes safely with the\n    // declarative lifecycle. Unlike stop(), it records `_paused` so resume() can\n    // tell an intentional pause from a full stop.\n    if (!this._running || this._paused) return;\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = true;\n    this._setRunning(false);\n  }\n\n  resume(): void {\n    if (!this._paused) return;\n    this._paused = false;\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // New scheduled run after a pause: capture its generation (§3.4) so a\n    // post-dispose() boundary/interval callback is recognised as stale.\n    this._runGen = ++this._gen;\n    // Invariant: `_interval` is fixed at start() and stays constant for the whole\n    // pause/resume cycle — changeInterval() only mutates it while *running* (never\n    // while paused), so the remainder arithmetic below can safely assume the same\n    // period was in effect across the paused segment. Consequence for the Shell:\n    // because the live interval-attribute path (attributeChangedCallback ->\n    // changeInterval) is gated on `running`, an `interval` change made *while\n    // paused* is silently not applied here; it is picked up only on the next\n    // start() as plain config. This is by design — see README \"Commands\".\n    // Resume seamlessly: a tick fires every `interval` ms of *running* time, so\n    // honour the partial period consumed before the pause. Wait only the\n    // remainder to the next boundary, then fall back to the steady interval.\n    // (`accumulated % interval === 0` — paused exactly on a boundary — yields a\n    // full interval, which is correct: the next tick is a whole period away.)\n    const remainder = this._interval - (this._accumulatedElapsed % this._interval);\n    this._timerId = setTimeout(this._onResumeBoundary, remainder);\n  }\n\n  // --- Internal ---\n\n  private _onResumeBoundary = (): void => {\n    // Stale-run guard (§3.4): a resume-boundary timeout that fires after dispose()\n    // belongs to a torn-down run — drop it without re-arming the interval.\n    if (this._runGen !== this._gen) return;\n    this._timerId = null;\n    this._fire();\n    // _fire() may have auto-stopped the timer (repeat reached); only re-arm the\n    // steady interval while still running.\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  };\n\n  private _fire = (): void => {\n    // Stale-run guard (§3.4): an interval callback queued before dispose() (which\n    // bumps `_gen`) must not tick or dispatch onto a torn-down element.\n    if (this._runGen !== this._gen) return;\n    this._tick++;\n    this._dispatchTick();\n\n    // Auto-stop once this run has fired the requested number of ticks (repeat=0\n    // runs forever). Counted per-run via `_runStartTick`, so a re-start after a\n    // completed bounded run fires N ticks again. `once` is expressed by the Shell\n    // as repeat=1.\n    if (this._repeat > 0 && (this._tick - this._runStartTick) >= this._repeat) {\n      this._clearTimer();\n      this._foldElapsed();\n      this._setRunning(false);\n    }\n  };\n\n  private _clearTimer(): void {\n    if (this._timerId !== null) {\n      // `_timerId` may hold a setInterval handle (steady ticking) or a setTimeout\n      // handle (the resume remainder). Clear both — per the HTML spec timers\n      // share one list and clearTimeout/clearInterval each remove the entry\n      // regardless of which call created it.\n      clearTimeout(this._timerId);\n      clearInterval(this._timerId);\n      this._timerId = null;\n    }\n  }\n\n  private _foldElapsed(): void {\n    if (this._segmentStart !== null) {\n      this._accumulatedElapsed += Date.now() - this._segmentStart;\n      this._segmentStart = null;\n    }\n  }\n\n  private _currentElapsed(): number {\n    return this._accumulatedElapsed +\n      (this._segmentStart !== null ? Date.now() - this._segmentStart : 0);\n  }\n}\n","import { config } from \"./config.js\";\nimport type { Timer } from \"./components/Timer.js\";\n\nlet registered = false;\n\nfunction handleClick(event: Event): void {\n  const target = event.target;\n  if (!(target instanceof Element)) return;\n\n  const triggerElement = target.closest<Element>(`[${config.triggerAttribute}]`);\n  if (!triggerElement) return;\n\n  const timerId = triggerElement.getAttribute(config.triggerAttribute);\n  if (!timerId) return;\n\n  // Resolve the registered constructor at call time instead of importing Timer\n  // as a value. The value import created a components/Timer.ts ⇄ autoTrigger.ts\n  // cycle (Timer.connectedCallback() calls registerAutoTrigger()). instanceof\n  // against the customElements registry keeps the exact same identity guarantee\n  // — only the registered <wcs-timer> class matches — without the import cycle.\n  const TimerCtor = customElements.get(config.tagNames.timer);\n  const timerElement = document.getElementById(timerId);\n  if (!TimerCtor || !(timerElement instanceof TimerCtor)) return;\n\n  // Suppress the element's default action so a timer can start without\n  // navigating. Intentional: do not attach data-timertarget to an element whose\n  // default action you also want (real <a href> link, form-submit button) — it\n  // will be cancelled. See README \"Optional DOM Triggering\".\n  event.preventDefault();\n  (timerElement as Timer).start();\n}\n\nexport function registerAutoTrigger(): void {\n  if (registered) return;\n  registered = true;\n  document.addEventListener(\"click\", handleClick);\n}\n\nexport function unregisterAutoTrigger(): void {\n  if (!registered) return;\n  registered = false;\n  document.removeEventListener(\"click\", handleClick);\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\n\nexport class Timer extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n  static wcBindable: IWcBindable = {\n    ...TimerCore.wcBindable,\n    properties: [\n      ...TimerCore.wcBindable.properties,\n      { name: \"trigger\", event: \"wcs-timer:trigger-changed\" },\n    ],\n    // Shell-level settable surface. `attribute` is a purely descriptive hint\n    // (per SPEC-extensions.md the binding core does not act on it) naming the\n    // mirrored HTML attribute, matching <wcs-geo> / <wcs-debounce>. `trigger` is a\n    // momentary command-property with no backing attribute, so it carries no hint\n    // (same as those packages). `start` / `stop` / `reset` / `pause` / `resume`\n    // commands are inherited from the Core above.\n    inputs: [\n      { name: \"interval\", attribute: \"interval\" },\n      { name: \"once\", attribute: \"once\" },\n      { name: \"repeat\", attribute: \"repeat\" },\n      { name: \"immediate\", attribute: \"immediate\" },\n      { name: \"manual\", attribute: \"manual\" },\n      { name: \"trigger\" },\n    ],\n  };\n  static get observedAttributes(): string[] { return [\"interval\"]; }\n\n  private _core: TimerCore;\n  private _trigger: boolean = false;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new TimerCore(this);\n  }\n\n  // SSR (§4.1/§4.4): the Shell exposes the Core's readiness so a server-side\n  // renderer can await the connect-time probe before snapshotting. The timer has\n  // no async probe (observe() resolves immediately), but the contract is uniform\n  // across IO nodes.\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Attribute accessors ---\n\n  get interval(): number {\n    const attr = this.getAttribute(\"interval\");\n    if (attr === null || attr.trim() === \"\") return 1000;\n    // Strict parse via Number() (unlike parseInt, \"100px\" -> NaN, not 100),\n    // matching <wcs-geo> / <wcs-debounce>. Fall back to the 1000ms default for any\n    // invalid period — not only NaN but also 0 / negative values, which would\n    // otherwise reach setInterval as a hot loop and break resume()'s modulo\n    // arithmetic in the Core.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 1000;\n  }\n\n  set interval(value: number) {\n    this.setAttribute(\"interval\", String(value));\n  }\n\n  get once(): boolean {\n    return this.hasAttribute(\"once\");\n  }\n\n  set once(value: boolean) {\n    if (value) {\n      this.setAttribute(\"once\", \"\");\n    } else {\n      this.removeAttribute(\"once\");\n    }\n  }\n\n  get repeat(): number {\n    const attr = this.getAttribute(\"repeat\");\n    if (attr === null || attr.trim() === \"\") return 0;\n    // Strict parse via Number() (\"3px\" -> NaN, not 3), matching <wcs-geo> /\n    // <wcs-debounce>. Normalise any non-positive / non-numeric value to 0\n    // (= unlimited), mirroring the `interval` getter. Without this a negative\n    // `repeat=\"-3\"` would leak through to start(); harmless today (Core treats\n    // `_repeat <= 0` as unlimited) but the asymmetry is a trap.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 0;\n  }\n\n  set repeat(value: number) {\n    this.setAttribute(\"repeat\", String(value));\n  }\n\n  get immediate(): boolean {\n    return this.hasAttribute(\"immediate\");\n  }\n\n  set immediate(value: boolean) {\n    if (value) {\n      this.setAttribute(\"immediate\", \"\");\n    } else {\n      this.removeAttribute(\"immediate\");\n    }\n  }\n\n  get manual(): boolean {\n    return this.hasAttribute(\"manual\");\n  }\n\n  set manual(value: boolean) {\n    if (value) {\n      this.setAttribute(\"manual\", \"\");\n    } else {\n      this.removeAttribute(\"manual\");\n    }\n  }\n\n  // --- Core delegated getters ---\n\n  get tick(): number {\n    return this._core.tick;\n  }\n\n  get elapsed(): number {\n    return this._core.elapsed;\n  }\n\n  get running(): boolean {\n    return this._core.running;\n  }\n\n  // --- Command property ---\n\n  get trigger(): boolean {\n    return this._trigger;\n  }\n\n  set trigger(value: boolean) {\n    // Momentary command-property: a false→true write starts the timer. Mirrors\n    // the trigger flag on <wcs-fetch> / <wcs-ws>. Prefer the command-token\n    // protocol (`command.start: $command.tick`) for state-driven starts; this\n    // exists mainly for the DOM click trigger and simple boolean bindings.\n    const v = !!value;\n    if (v) {\n      this._trigger = true;\n      this.start();\n      this._trigger = false;\n      // The `trigger-changed` event reports the momentary flag returning to\n      // false, i.e. that the trigger property *changed* — it is deliberately not\n      // gated on whether start() actually began a new run. This keeps the\n      // wcBindable `trigger` property's change-notification semantics consistent\n      // (every false→true write produces exactly one change-back event), even\n      // when start() was a no-op because the timer was already running.\n      this.dispatchEvent(new CustomEvent(\"wcs-timer:trigger-changed\", {\n        detail: false,\n        bubbles: true,\n      }));\n    }\n  }\n\n  // --- Commands ---\n\n  start(): void {\n    // `once` is sugar for \"fire exactly one tick\": map it to repeat=1, but let an\n    // explicit repeat attribute win when both are present.\n    const repeat = this.repeat > 0 ? this.repeat : (this.once ? 1 : 0);\n    this._core.start({\n      interval: this.interval,\n      repeat,\n      immediate: this.immediate,\n    });\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  reset(): void {\n    this._core.reset();\n  }\n\n  pause(): void {\n    this._core.pause();\n  }\n\n  resume(): void {\n    this._core.resume();\n  }\n\n  // --- Lifecycle ---\n\n  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void {\n    // Live interval changes swap the underlying setInterval period in place.\n    // `tick` / `elapsed` and the per-run `repeat` progress are preserved — we\n    // deliberately do NOT stop()+start(), which would re-run start() and\n    // re-evaluate per-run options (re-firing `immediate` and re-baselining\n    // `repeat`). `running` alone gates this: swapping the period is orthogonal to\n    // *how* the timer was started, so a `manual` timer the user has explicitly\n    // started gets live period changes too. A non-running timer needs no swap —\n    // its next start() picks up the new attribute as plain config.\n    if (name === \"interval\" && oldValue !== newValue && this.isConnected && this.running) {\n      this._core.changeInterval(this.interval);\n    }\n  }\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    if (config.autoTrigger) {\n      registerAutoTrigger();\n    }\n    // Establish monitoring (§3.5). observe() is a no-op that resolves once ready;\n    // expose it as connectedCallbackPromise for SSR.\n    this._connectedCallbackPromise = this._core.observe();\n    if (!this.manual) {\n      this.start();\n    }\n  }\n\n  disconnectedCallback(): void {\n    // dispose() stops the timer and bumps the generation so a callback already\n    // queued cannot fire onto a disconnected element (§3.5 / §4.4).\n    this._core.dispose();\n  }\n}\n","import { Timer } from \"./components/Timer.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.timer)) {\n    customElements.define(config.tagNames.timer, Timer);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapTimer(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/core/TimerCore.ts","../src/autoTrigger.ts","../src/components/Timer.ts","../src/registerComponents.ts","../src/bootstrapTimer.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  autoTrigger: boolean;\n  triggerAttribute: string;\n  tagNames: {\n    timer: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  autoTrigger: true,\n  triggerAttribute: \"data-timertarget\",\n  tagNames: {\n    timer: \"wcs-timer\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\n// Internal-only live handle to the mutable config. NOT part of the public API\n// (deliberately absent from exports.ts) — it is exported solely so sibling\n// modules in this package can read current settings cheaply. External consumers\n// must use getConfig() (returns a deep-frozen snapshot) / setConfig(). Mutating\n// this object directly bypasses the frozenConfig cache and is unsupported.\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (typeof partialConfig.autoTrigger === \"boolean\") {\n    _config.autoTrigger = partialConfig.autoTrigger;\n  }\n  if (typeof partialConfig.triggerAttribute === \"string\") {\n    _config.triggerAttribute = partialConfig.triggerAttribute;\n  }\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IWcBindable } from \"../types.js\";\n\nexport interface TimerStartOptions {\n  interval?: number;\n  repeat?: number;\n  immediate?: boolean;\n}\n\n/**\n * Headless timer primitive. A thin, framework-agnostic wrapper around\n * `setInterval` exposed through the wc-bindable protocol: it streams `tick`\n * (a monotonically increasing counter), `elapsed` (running time in ms) and a\n * `running` flag, and is driven by the `start` / `stop` / `reset` / `pause` /\n * `resume` commands.\n *\n * `tick` and `elapsed` are both surfaced via the single `wcs-timer:tick` event\n * (read through getters, mirroring how FetchCore exposes value/status from one\n * `wcs-fetch:response` event), so an observer that binds either property is\n * notified on every fire.\n */\nexport class TimerCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"tick\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\" },\n    ],\n    commands: [\n      { name: \"start\" },\n      { name: \"stop\" },\n      { name: \"reset\" },\n      { name: \"pause\" },\n      { name: \"resume\" },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _timerId: ReturnType<typeof setInterval> | null = null;\n\n  // Generation guard (§3.4): bumped on dispose() and at every async start\n  // (start()/resume()). A scheduled callback (setInterval/setTimeout) captures the\n  // generation live via `_gen`; a fire that was already queued when the timer was\n  // torn down — or superseded by a new run — has a stale gen and MUST NOT mutate\n  // state or dispatch on a disposed element. _clearTimer() removes the handle, but\n  // the guard is the belt-and-braces defense for a callback already in the queue.\n  private _gen = 0;\n  // Generation captured for the currently scheduled run, set at each async start\n  // (start()/resume()). A scheduled callback compares it against the live `_gen`;\n  // a stale callback (dispose() bumped `_gen` after this run was armed) bails.\n  private _runGen = 0;\n  // SSR (§3.8): the timer does no asynchronous probe, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  private _tick: number = 0;\n  private _running: boolean = false;\n  private _paused: boolean = false;\n\n  // `_tick` value captured at the start of the current run. `repeat` counts ticks\n  // *per run*, so the stop condition compares against this baseline rather than the\n  // cumulative `_tick` (which only resets on reset()). Without it, re-starting a\n  // completed bounded timer would stop after a single tick.\n  private _runStartTick: number = 0;\n\n  // Timer configuration (captured on start, reused by pause/resume).\n  // `_immediate` is intentionally NOT a field: it is per-run intent consumed\n  // entirely within start() (fire once, then schedule), so it lives as a local\n  // there rather than lingering as instance state no other method reads.\n  private _interval: number = 1000;\n  private _repeat: number = 0;       // 0 = unlimited\n\n  // Elapsed-time bookkeeping. `_accumulatedElapsed` holds the time folded from\n  // already-finished running segments; `_segmentStart` is the timestamp the\n  // current running segment began (null when not running). The live elapsed is\n  // the sum of the two — see _currentElapsed().\n  private _accumulatedElapsed: number = 0;\n  private _segmentStart: number | null = null;\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get tick(): number {\n    return this._tick;\n  }\n\n  get elapsed(): number {\n    return this._currentElapsed();\n  }\n\n  get running(): boolean {\n    return this._running;\n  }\n\n  // SSR readiness (§3.8): resolves after the first probe. The timer is\n  // command-driven with nothing to probe, so this is an already-resolved promise.\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  // Lifecycle (§3.5). The timer is command-driven (start/stop/...) with no\n  // ambient subscription to establish, so observe() is an idempotent no-op that\n  // resolves once ready (mirroring UploadCore). dispose() tears the timer down —\n  // it stops any running interval and bumps the generation so a callback already\n  // queued cannot fire onto a torn-down element.\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._gen++;\n    this.stop();\n  }\n\n  // --- State setters with event dispatch ---\n\n  private _dispatchTick(): void {\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:tick\", {\n      detail: { count: this._tick, elapsed: this._currentElapsed() },\n      bubbles: true,\n    }));\n  }\n\n  private _setRunning(running: boolean): void {\n    if (this._running === running) return;\n    this._running = running;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:running-changed\", {\n      detail: running,\n      bubbles: true,\n    }));\n  }\n\n  // --- Public API ---\n\n  start(options: TimerStartOptions = {}): void {\n    // Idempotent while running: a redundant start() must not stack a second\n    // setInterval (which would leak and double the tick rate). Reconfiguring an\n    // active timer is done via stop() + start().\n    if (this._running) return;\n\n    // start() begins a fresh running segment, so clear any lingering pause from a\n    // prior pause()-without-resume(). Without this, the timer would run while\n    // _paused stayed true, leaving pause() a no-op and letting resume() overwrite\n    // the live timer handle (leak + double fire).\n    this._paused = false;\n\n    // `interval` is persistent configuration: a non-positive / non-finite value\n    // (or an omitted option) keeps the previous interval (default 1000ms). The\n    // guard rejects values that would turn setInterval into a hot loop and make\n    // resume()'s `accumulated % interval` arithmetic produce NaN. The Shell already\n    // falls back to 1000 for invalid attributes; this is the backstop for direct\n    // Core API callers.\n    if (typeof options.interval === \"number\" && Number.isFinite(options.interval) && options.interval > 0) {\n      this._interval = options.interval;\n    }\n\n    // `repeat` / `immediate` are per-run intent, NOT persistent configuration:\n    // every start() re-establishes them from the options, defaulting to\n    // \"unlimited\" / \"no immediate fire\" when omitted. This keeps a bare start()\n    // after a bounded or one-shot run from silently inheriting the old bounds.\n    // `repeat` is a field (pause/resume/_fire read it across the run); `immediate`\n    // is consumed here and now, so it stays a local.\n    this._repeat = (typeof options.repeat === \"number\" && options.repeat > 0) ? options.repeat : 0;\n    const immediate = options.immediate === true;\n\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // Baseline this run's per-run repeat counting (set after _setRunning so a\n    // re-start of a completed bounded timer fires the full N ticks again).\n    this._runStartTick = this._tick;\n    // Capture this run's generation (§3.4): a scheduled fire that outlives a\n    // dispose() (which bumps `_gen`) is then recognised as stale and ignored.\n    this._runGen = ++this._gen;\n\n    // Fire immediately on start when requested. _fire() may stop the timer (when\n    // repeat is reached), so re-check _running before scheduling the interval.\n    if (immediate) {\n      this._fire();\n    }\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  }\n\n  // Swap the tick period of a live timer in place, WITHOUT re-running start().\n  // Unlike stop() + start(), this leaves the per-run repeat progress in flight\n  // (`_repeat` and its `_runStartTick` baseline) untouched, so a bounded\n  // `repeat=\"N\"` run is not re-baselined to fire N more times. It also never goes\n  // through start()'s `immediate` path, so an `immediate` timer does not fire an\n  // extra tick. Only re-arms the steady interval; pause()/resume() and reset() are\n  // unaffected. No-op when not running (interval is then plain config, captured on\n  // the next start) or when the new period is non-positive / non-finite (which\n  // would turn setInterval into a hot loop and break resume()'s modulo arithmetic).\n  changeInterval(interval: number): void {\n    if (!this._running) return;\n    if (!(typeof interval === \"number\" && Number.isFinite(interval) && interval > 0)) return;\n    if (interval === this._interval) return;\n    this._interval = interval;\n    // Re-arm the steady ticking at the new period. The current period's progress\n    // is intentionally discarded (the next tick is a full new interval away),\n    // matching the boundary reset of the previous stop()+start() behaviour.\n    this._clearTimer();\n    this._timerId = setInterval(this._fire, this._interval);\n  }\n\n  stop(): void {\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = false;\n    this._setRunning(false);\n  }\n\n  reset(): void {\n    this._clearTimer();\n    this._paused = false;\n    this._tick = 0;\n    this._accumulatedElapsed = 0;\n    this._segmentStart = null;\n    this._setRunning(false);\n    // Notify observers that the counter/elapsed have returned to zero.\n    this._dispatchTick();\n  }\n\n  pause(): void {\n    // Pause only a live timer; a no-op otherwise so it composes safely with the\n    // declarative lifecycle. Unlike stop(), it records `_paused` so resume() can\n    // tell an intentional pause from a full stop.\n    if (!this._running || this._paused) return;\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = true;\n    this._setRunning(false);\n  }\n\n  resume(): void {\n    if (!this._paused) return;\n    this._paused = false;\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // New scheduled run after a pause: capture its generation (§3.4) so a\n    // post-dispose() boundary/interval callback is recognised as stale.\n    this._runGen = ++this._gen;\n    // Invariant: `_interval` is fixed at start() and stays constant for the whole\n    // pause/resume cycle — changeInterval() only mutates it while *running* (never\n    // while paused), so the remainder arithmetic below can safely assume the same\n    // period was in effect across the paused segment. Consequence for the Shell:\n    // because the live interval-attribute path (attributeChangedCallback ->\n    // changeInterval) is gated on `running`, an `interval` change made *while\n    // paused* is silently not applied here; it is picked up only on the next\n    // start() as plain config. This is by design — see README \"Commands\".\n    // Resume seamlessly: a tick fires every `interval` ms of *running* time, so\n    // honour the partial period consumed before the pause. Wait only the\n    // remainder to the next boundary, then fall back to the steady interval.\n    // (`accumulated % interval === 0` — paused exactly on a boundary — yields a\n    // full interval, which is correct: the next tick is a whole period away.)\n    const remainder = this._interval - (this._accumulatedElapsed % this._interval);\n    this._timerId = setTimeout(this._onResumeBoundary, remainder);\n  }\n\n  // --- Internal ---\n\n  private _onResumeBoundary = (): void => {\n    // Stale-run guard (§3.4): a resume-boundary timeout that fires after dispose()\n    // belongs to a torn-down run — drop it without re-arming the interval.\n    if (this._runGen !== this._gen) return;\n    this._timerId = null;\n    this._fire();\n    // _fire() may have auto-stopped the timer (repeat reached); only re-arm the\n    // steady interval while still running.\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  };\n\n  private _fire = (): void => {\n    // Stale-run guard (§3.4): an interval callback queued before dispose() (which\n    // bumps `_gen`) must not tick or dispatch onto a torn-down element.\n    if (this._runGen !== this._gen) return;\n    this._tick++;\n    this._dispatchTick();\n\n    // Auto-stop once this run has fired the requested number of ticks (repeat=0\n    // runs forever). Counted per-run via `_runStartTick`, so a re-start after a\n    // completed bounded run fires N ticks again. `once` is expressed by the Shell\n    // as repeat=1.\n    if (this._repeat > 0 && (this._tick - this._runStartTick) >= this._repeat) {\n      this._clearTimer();\n      this._foldElapsed();\n      this._setRunning(false);\n    }\n  };\n\n  private _clearTimer(): void {\n    if (this._timerId !== null) {\n      // `_timerId` may hold a setInterval handle (steady ticking) or a setTimeout\n      // handle (the resume remainder). Clear both — per the HTML spec timers\n      // share one list and clearTimeout/clearInterval each remove the entry\n      // regardless of which call created it.\n      clearTimeout(this._timerId);\n      clearInterval(this._timerId);\n      this._timerId = null;\n    }\n  }\n\n  private _foldElapsed(): void {\n    if (this._segmentStart !== null) {\n      this._accumulatedElapsed += Date.now() - this._segmentStart;\n      this._segmentStart = null;\n    }\n  }\n\n  private _currentElapsed(): number {\n    return this._accumulatedElapsed +\n      (this._segmentStart !== null ? Date.now() - this._segmentStart : 0);\n  }\n}\n","import { config } from \"./config.js\";\nimport type { Timer } from \"./components/Timer.js\";\n\nlet registered = false;\n\nfunction handleClick(event: Event): void {\n  const target = event.target;\n  if (!(target instanceof Element)) return;\n\n  const triggerElement = target.closest<Element>(`[${config.triggerAttribute}]`);\n  if (!triggerElement) return;\n\n  const timerId = triggerElement.getAttribute(config.triggerAttribute);\n  if (!timerId) return;\n\n  // Resolve the registered constructor at call time instead of importing Timer\n  // as a value. The value import created a components/Timer.ts ⇄ autoTrigger.ts\n  // cycle (Timer.connectedCallback() calls registerAutoTrigger()). instanceof\n  // against the customElements registry keeps the exact same identity guarantee\n  // — only the registered <wcs-timer> class matches — without the import cycle.\n  const TimerCtor = customElements.get(config.tagNames.timer);\n  const timerElement = document.getElementById(timerId);\n  if (!TimerCtor || !(timerElement instanceof TimerCtor)) return;\n\n  // Suppress the element's default action so a timer can start without\n  // navigating. Intentional: do not attach data-timertarget to an element whose\n  // default action you also want (real <a href> link, form-submit button) — it\n  // will be cancelled. See README \"Optional DOM Triggering\".\n  event.preventDefault();\n  (timerElement as Timer).start();\n}\n\nexport function registerAutoTrigger(): void {\n  if (registered) return;\n  registered = true;\n  document.addEventListener(\"click\", handleClick);\n}\n\nexport function unregisterAutoTrigger(): void {\n  if (!registered) return;\n  registered = false;\n  document.removeEventListener(\"click\", handleClick);\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\n\nexport class Timer extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n  static wcBindable: IWcBindable = {\n    ...TimerCore.wcBindable,\n    properties: [\n      ...TimerCore.wcBindable.properties,\n      { name: \"trigger\", event: \"wcs-timer:trigger-changed\" },\n    ],\n    // Shell-level settable surface. `attribute` is a purely descriptive hint\n    // (per SPEC-extensions.md the binding core does not act on it) naming the\n    // mirrored HTML attribute, matching <wcs-geo> / <wcs-debounce>. `trigger` is a\n    // momentary command-property with no backing attribute, so it carries no hint\n    // (same as those packages). `start` / `stop` / `reset` / `pause` / `resume`\n    // commands are inherited from the Core above.\n    inputs: [\n      { name: \"interval\", attribute: \"interval\" },\n      { name: \"once\", attribute: \"once\" },\n      { name: \"repeat\", attribute: \"repeat\" },\n      { name: \"immediate\", attribute: \"immediate\" },\n      { name: \"manual\", attribute: \"manual\" },\n      { name: \"trigger\" },\n    ],\n  };\n  static get observedAttributes(): string[] { return [\"interval\"]; }\n\n  private _core: TimerCore;\n  private _trigger: boolean = false;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n  private _internals: ElementInternals | null = null;\n\n  constructor() {\n    super();\n    this._core = new TimerCore(this);\n    this._internals = this._initInternals();\n    this._wireStates({\n      \"wcs-timer:running-changed\": (d) => ({ running: d === true }),\n    });\n  }\n\n  // CSS state reflection (:state()) — debug-only snapshot getter. NOT part of\n  // wc-bindable (not a bind target); see README \"CSS styling with :state()\".\n  // MUST NOT return the live CustomStateSet (that would let callers write\n  // states from outside, defeating the point of :state() being read-only).\n  get debugStates(): string[] {\n    return this._internals ? [...this._internals.states] : [];\n  }\n\n  private _initInternals(): ElementInternals | null {\n    // never-throw (async-io-node-guidelines.md §3.6): attachInternals is absent\n    // in happy-dom / older environments, and pre-125 Chromium rejects\n    // non-dashed state names from states.add() (probed and discarded here).\n    // Either case silently disables reflection — the component still works,\n    // it just doesn't expose :state() selectors.\n    try {\n      if (typeof this.attachInternals !== \"function\") return null;\n      const internals = this.attachInternals();\n      internals.states.add(\"wcs-probe\");\n      internals.states.delete(\"wcs-probe\");\n      return internals;\n    } catch {\n      return null;\n    }\n  }\n\n  private _wireStates(map: Record<string, (detail: any) => Record<string, boolean>>): void {\n    if (this._internals === null) return;\n    const states = this._internals.states;\n    for (const [event, toStates] of Object.entries(map)) {\n      this.addEventListener(event, (e) => {\n        const debug = this.hasAttribute(\"debug-states\");\n        for (const [name, on] of Object.entries(toStates((e as CustomEvent).detail))) {\n          try {\n            if (on) { states.add(name); } else { states.delete(name); }\n          } catch { /* never-throw */ }\n          if (debug) this.toggleAttribute(`data-wcs-state-${name}`, on);\n        }\n      });\n    }\n  }\n\n  // SSR (§4.1/§4.4): the Shell exposes the Core's readiness so a server-side\n  // renderer can await the connect-time probe before snapshotting. The timer has\n  // no async probe (observe() resolves immediately), but the contract is uniform\n  // across IO nodes.\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Attribute accessors ---\n\n  get interval(): number {\n    const attr = this.getAttribute(\"interval\");\n    if (attr === null || attr.trim() === \"\") return 1000;\n    // Strict parse via Number() (unlike parseInt, \"100px\" -> NaN, not 100),\n    // matching <wcs-geo> / <wcs-debounce>. Fall back to the 1000ms default for any\n    // invalid period — not only NaN but also 0 / negative values, which would\n    // otherwise reach setInterval as a hot loop and break resume()'s modulo\n    // arithmetic in the Core.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 1000;\n  }\n\n  set interval(value: number) {\n    this.setAttribute(\"interval\", String(value));\n  }\n\n  get once(): boolean {\n    return this.hasAttribute(\"once\");\n  }\n\n  set once(value: boolean) {\n    if (value) {\n      this.setAttribute(\"once\", \"\");\n    } else {\n      this.removeAttribute(\"once\");\n    }\n  }\n\n  get repeat(): number {\n    const attr = this.getAttribute(\"repeat\");\n    if (attr === null || attr.trim() === \"\") return 0;\n    // Strict parse via Number() (\"3px\" -> NaN, not 3), matching <wcs-geo> /\n    // <wcs-debounce>. Normalise any non-positive / non-numeric value to 0\n    // (= unlimited), mirroring the `interval` getter. Without this a negative\n    // `repeat=\"-3\"` would leak through to start(); harmless today (Core treats\n    // `_repeat <= 0` as unlimited) but the asymmetry is a trap.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 0;\n  }\n\n  set repeat(value: number) {\n    this.setAttribute(\"repeat\", String(value));\n  }\n\n  get immediate(): boolean {\n    return this.hasAttribute(\"immediate\");\n  }\n\n  set immediate(value: boolean) {\n    if (value) {\n      this.setAttribute(\"immediate\", \"\");\n    } else {\n      this.removeAttribute(\"immediate\");\n    }\n  }\n\n  get manual(): boolean {\n    return this.hasAttribute(\"manual\");\n  }\n\n  set manual(value: boolean) {\n    if (value) {\n      this.setAttribute(\"manual\", \"\");\n    } else {\n      this.removeAttribute(\"manual\");\n    }\n  }\n\n  // --- Core delegated getters ---\n\n  get tick(): number {\n    return this._core.tick;\n  }\n\n  get elapsed(): number {\n    return this._core.elapsed;\n  }\n\n  get running(): boolean {\n    return this._core.running;\n  }\n\n  // --- Command property ---\n\n  get trigger(): boolean {\n    return this._trigger;\n  }\n\n  set trigger(value: boolean) {\n    // Momentary command-property: a false→true write starts the timer. Mirrors\n    // the trigger flag on <wcs-fetch> / <wcs-ws>. Prefer the command-token\n    // protocol (`command.start: $command.tick`) for state-driven starts; this\n    // exists mainly for the DOM click trigger and simple boolean bindings.\n    const v = !!value;\n    if (v) {\n      this._trigger = true;\n      this.start();\n      this._trigger = false;\n      // The `trigger-changed` event reports the momentary flag returning to\n      // false, i.e. that the trigger property *changed* — it is deliberately not\n      // gated on whether start() actually began a new run. This keeps the\n      // wcBindable `trigger` property's change-notification semantics consistent\n      // (every false→true write produces exactly one change-back event), even\n      // when start() was a no-op because the timer was already running.\n      this.dispatchEvent(new CustomEvent(\"wcs-timer:trigger-changed\", {\n        detail: false,\n        bubbles: true,\n      }));\n    }\n  }\n\n  // --- Commands ---\n\n  start(): void {\n    // `once` is sugar for \"fire exactly one tick\": map it to repeat=1, but let an\n    // explicit repeat attribute win when both are present.\n    const repeat = this.repeat > 0 ? this.repeat : (this.once ? 1 : 0);\n    this._core.start({\n      interval: this.interval,\n      repeat,\n      immediate: this.immediate,\n    });\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  reset(): void {\n    this._core.reset();\n  }\n\n  pause(): void {\n    this._core.pause();\n  }\n\n  resume(): void {\n    this._core.resume();\n  }\n\n  // --- Lifecycle ---\n\n  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void {\n    // Live interval changes swap the underlying setInterval period in place.\n    // `tick` / `elapsed` and the per-run `repeat` progress are preserved — we\n    // deliberately do NOT stop()+start(), which would re-run start() and\n    // re-evaluate per-run options (re-firing `immediate` and re-baselining\n    // `repeat`). `running` alone gates this: swapping the period is orthogonal to\n    // *how* the timer was started, so a `manual` timer the user has explicitly\n    // started gets live period changes too. A non-running timer needs no swap —\n    // its next start() picks up the new attribute as plain config.\n    if (name === \"interval\" && oldValue !== newValue && this.isConnected && this.running) {\n      this._core.changeInterval(this.interval);\n    }\n  }\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    if (config.autoTrigger) {\n      registerAutoTrigger();\n    }\n    // Establish monitoring (§3.5). observe() is a no-op that resolves once ready;\n    // expose it as connectedCallbackPromise for SSR.\n    this._connectedCallbackPromise = this._core.observe();\n    if (!this.manual) {\n      this.start();\n    }\n  }\n\n  disconnectedCallback(): void {\n    // dispose() stops the timer and bumps the generation so a callback already\n    // queued cannot fire onto a disconnected element (§3.5 / §4.4).\n    this._core.dispose();\n  }\n}\n","import { Timer } from \"./components/Timer.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.timer)) {\n    customElements.define(config.tagNames.timer, Timer);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapTimer(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n"],"names":[],"mappings":"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"}

package/dist/index.esm.min.js

@@ -1,2 +1,2 @@
-const t={autoTrigger:!0,triggerAttribute:"data-timertarget",tagNames:{timer:"wcs-timer"}};function e(t){if(null===t||"object"!=typeof t)return t;Object.freeze(t);for(const i of Object.keys(t))e(t[i]);return t}function i(t){if(null===t||"object"!=typeof t)return t;const e={};for(const r of Object.keys(t))e[r]=i(t[r]);return e}let r=null;const s=t;function n(){return r||(r=e(i(t))),r}class a extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"tick",event:"wcs-timer:tick",getter:t=>t.detail.count},{name:"elapsed",event:"wcs-timer:tick",getter:t=>t.detail.elapsed},{name:"running",event:"wcs-timer:running-changed"}],commands:[{name:"start"},{name:"stop"},{name:"reset"},{name:"pause"},{name:"resume"}]};_target;_timerId=null;_gen=0;_runGen=0;_ready=Promise.resolve();_tick=0;_running=!1;_paused=!1;_runStartTick=0;_interval=1e3;_repeat=0;_accumulatedElapsed=0;_segmentStart=null;constructor(t){super(),this._target=t??this}get tick(){return this._tick}get elapsed(){return this._currentElapsed()}get running(){return this._running}get ready(){return this._ready}observe(){return this._ready}dispose(){this._gen++,this.stop()}_dispatchTick(){this._target.dispatchEvent(new CustomEvent("wcs-timer:tick",{detail:{count:this._tick,elapsed:this._currentElapsed()},bubbles:!0}))}_setRunning(t){this._running!==t&&(this._running=t,this._target.dispatchEvent(new CustomEvent("wcs-timer:running-changed",{detail:t,bubbles:!0})))}start(t={}){if(this._running)return;this._paused=!1,"number"==typeof t.interval&&Number.isFinite(t.interval)&&t.interval>0&&(this._interval=t.interval),this._repeat="number"==typeof t.repeat&&t.repeat>0?t.repeat:0;const e=!0===t.immediate;this._setRunning(!0),this._segmentStart=Date.now(),this._runStartTick=this._tick,this._runGen=++this._gen,e&&this._fire(),this._running&&(this._timerId=setInterval(this._fire,this._interval))}changeInterval(t){this._running&&"number"==typeof t&&Number.isFinite(t)&&t>0&&t!==this._interval&&(this._interval=t,this._clearTimer(),this._timerId=setInterval(this._fire,this._interval))}stop(){this._clearTimer(),this._foldElapsed(),this._paused=!1,this._setRunning(!1)}reset(){this._clearTimer(),this._paused=!1,this._tick=0,this._accumulatedElapsed=0,this._segmentStart=null,this._setRunning(!1),this._dispatchTick()}pause(){this._running&&!this._paused&&(this._clearTimer(),this._foldElapsed(),this._paused=!0,this._setRunning(!1))}resume(){if(!this._paused)return;this._paused=!1,this._setRunning(!0),this._segmentStart=Date.now(),this._runGen=++this._gen;const t=this._interval-this._accumulatedElapsed%this._interval;this._timerId=setTimeout(this._onResumeBoundary,t)}_onResumeBoundary=()=>{this._runGen===this._gen&&(this._timerId=null,this._fire(),this._running&&(this._timerId=setInterval(this._fire,this._interval)))};_fire=()=>{this._runGen===this._gen&&(this._tick++,this._dispatchTick(),this._repeat>0&&this._tick-this._runStartTick>=this._repeat&&(this._clearTimer(),this._foldElapsed(),this._setRunning(!1)))};_clearTimer(){null!==this._timerId&&(clearTimeout(this._timerId),clearInterval(this._timerId),this._timerId=null)}_foldElapsed(){null!==this._segmentStart&&(this._accumulatedElapsed+=Date.now()-this._segmentStart,this._segmentStart=null)}_currentElapsed(){return this._accumulatedElapsed+(null!==this._segmentStart?Date.now()-this._segmentStart:0)}}let u=!1;function c(t){const e=t.target;if(!(e instanceof Element))return;const i=e.closest(`[${s.triggerAttribute}]`);if(!i)return;const r=i.getAttribute(s.triggerAttribute);if(!r)return;const n=customElements.get(s.tagNames.timer),a=document.getElementById(r);n&&a instanceof n&&(t.preventDefault(),a.start())}class h extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...a.wcBindable,properties:[...a.wcBindable.properties,{name:"trigger",event:"wcs-timer:trigger-changed"}],inputs:[{name:"interval",attribute:"interval"},{name:"once",attribute:"once"},{name:"repeat",attribute:"repeat"},{name:"immediate",attribute:"immediate"},{name:"manual",attribute:"manual"},{name:"trigger"}]};static get observedAttributes(){return["interval"]}_core;_trigger=!1;_connectedCallbackPromise=Promise.resolve();constructor(){super(),this._core=new a(this)}get connectedCallbackPromise(){return this._connectedCallbackPromise}get interval(){const t=this.getAttribute("interval");if(null===t||""===t.trim())return 1e3;const e=Number(t);return Number.isFinite(e)&&e>0?e:1e3}set interval(t){this.setAttribute("interval",String(t))}get once(){return this.hasAttribute("once")}set once(t){t?this.setAttribute("once",""):this.removeAttribute("once")}get repeat(){const t=this.getAttribute("repeat");if(null===t||""===t.trim())return 0;const e=Number(t);return Number.isFinite(e)&&e>0?e:0}set repeat(t){this.setAttribute("repeat",String(t))}get immediate(){return this.hasAttribute("immediate")}set immediate(t){t?this.setAttribute("immediate",""):this.removeAttribute("immediate")}get manual(){return this.hasAttribute("manual")}set manual(t){t?this.setAttribute("manual",""):this.removeAttribute("manual")}get tick(){return this._core.tick}get elapsed(){return this._core.elapsed}get running(){return this._core.running}get trigger(){return this._trigger}set trigger(t){!!t&&(this._trigger=!0,this.start(),this._trigger=!1,this.dispatchEvent(new CustomEvent("wcs-timer:trigger-changed",{detail:!1,bubbles:!0})))}start(){const t=this.repeat>0?this.repeat:this.once?1:0;this._core.start({interval:this.interval,repeat:t,immediate:this.immediate})}stop(){this._core.stop()}reset(){this._core.reset()}pause(){this._core.pause()}resume(){this._core.resume()}attributeChangedCallback(t,e,i){"interval"===t&&e!==i&&this.isConnected&&this.running&&this._core.changeInterval(this.interval)}connectedCallback(){this.style.display="none",s.autoTrigger&&(u||(u=!0,document.addEventListener("click",c))),this._connectedCallbackPromise=this._core.observe(),this.manual||this.start()}disconnectedCallback(){this._core.dispose()}}function l(e){var i;e&&("boolean"==typeof(i=e).autoTrigger&&(t.autoTrigger=i.autoTrigger),"string"==typeof i.triggerAttribute&&(t.triggerAttribute=i.triggerAttribute),i.tagNames&&Object.assign(t.tagNames,i.tagNames),r=null),customElements.get(s.tagNames.timer)||customElements.define(s.tagNames.timer,h)}export{a as TimerCore,h as WcsTimer,l as bootstrapTimer,n as getConfig};
+const t={autoTrigger:!0,triggerAttribute:"data-timertarget",tagNames:{timer:"wcs-timer"}};function e(t){if(null===t||"object"!=typeof t)return t;Object.freeze(t);for(const i of Object.keys(t))e(t[i]);return t}function i(t){if(null===t||"object"!=typeof t)return t;const e={};for(const r of Object.keys(t))e[r]=i(t[r]);return e}let r=null;const s=t;function n(){return r||(r=e(i(t))),r}class a extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"tick",event:"wcs-timer:tick",getter:t=>t.detail.count},{name:"elapsed",event:"wcs-timer:tick",getter:t=>t.detail.elapsed},{name:"running",event:"wcs-timer:running-changed"}],commands:[{name:"start"},{name:"stop"},{name:"reset"},{name:"pause"},{name:"resume"}]};_target;_timerId=null;_gen=0;_runGen=0;_ready=Promise.resolve();_tick=0;_running=!1;_paused=!1;_runStartTick=0;_interval=1e3;_repeat=0;_accumulatedElapsed=0;_segmentStart=null;constructor(t){super(),this._target=t??this}get tick(){return this._tick}get elapsed(){return this._currentElapsed()}get running(){return this._running}get ready(){return this._ready}observe(){return this._ready}dispose(){this._gen++,this.stop()}_dispatchTick(){this._target.dispatchEvent(new CustomEvent("wcs-timer:tick",{detail:{count:this._tick,elapsed:this._currentElapsed()},bubbles:!0}))}_setRunning(t){this._running!==t&&(this._running=t,this._target.dispatchEvent(new CustomEvent("wcs-timer:running-changed",{detail:t,bubbles:!0})))}start(t={}){if(this._running)return;this._paused=!1,"number"==typeof t.interval&&Number.isFinite(t.interval)&&t.interval>0&&(this._interval=t.interval),this._repeat="number"==typeof t.repeat&&t.repeat>0?t.repeat:0;const e=!0===t.immediate;this._setRunning(!0),this._segmentStart=Date.now(),this._runStartTick=this._tick,this._runGen=++this._gen,e&&this._fire(),this._running&&(this._timerId=setInterval(this._fire,this._interval))}changeInterval(t){this._running&&"number"==typeof t&&Number.isFinite(t)&&t>0&&t!==this._interval&&(this._interval=t,this._clearTimer(),this._timerId=setInterval(this._fire,this._interval))}stop(){this._clearTimer(),this._foldElapsed(),this._paused=!1,this._setRunning(!1)}reset(){this._clearTimer(),this._paused=!1,this._tick=0,this._accumulatedElapsed=0,this._segmentStart=null,this._setRunning(!1),this._dispatchTick()}pause(){this._running&&!this._paused&&(this._clearTimer(),this._foldElapsed(),this._paused=!0,this._setRunning(!1))}resume(){if(!this._paused)return;this._paused=!1,this._setRunning(!0),this._segmentStart=Date.now(),this._runGen=++this._gen;const t=this._interval-this._accumulatedElapsed%this._interval;this._timerId=setTimeout(this._onResumeBoundary,t)}_onResumeBoundary=()=>{this._runGen===this._gen&&(this._timerId=null,this._fire(),this._running&&(this._timerId=setInterval(this._fire,this._interval)))};_fire=()=>{this._runGen===this._gen&&(this._tick++,this._dispatchTick(),this._repeat>0&&this._tick-this._runStartTick>=this._repeat&&(this._clearTimer(),this._foldElapsed(),this._setRunning(!1)))};_clearTimer(){null!==this._timerId&&(clearTimeout(this._timerId),clearInterval(this._timerId),this._timerId=null)}_foldElapsed(){null!==this._segmentStart&&(this._accumulatedElapsed+=Date.now()-this._segmentStart,this._segmentStart=null)}_currentElapsed(){return this._accumulatedElapsed+(null!==this._segmentStart?Date.now()-this._segmentStart:0)}}let u=!1;function c(t){const e=t.target;if(!(e instanceof Element))return;const i=e.closest(`[${s.triggerAttribute}]`);if(!i)return;const r=i.getAttribute(s.triggerAttribute);if(!r)return;const n=customElements.get(s.tagNames.timer),a=document.getElementById(r);n&&a instanceof n&&(t.preventDefault(),a.start())}class h extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...a.wcBindable,properties:[...a.wcBindable.properties,{name:"trigger",event:"wcs-timer:trigger-changed"}],inputs:[{name:"interval",attribute:"interval"},{name:"once",attribute:"once"},{name:"repeat",attribute:"repeat"},{name:"immediate",attribute:"immediate"},{name:"manual",attribute:"manual"},{name:"trigger"}]};static get observedAttributes(){return["interval"]}_core;_trigger=!1;_connectedCallbackPromise=Promise.resolve();_internals=null;constructor(){super(),this._core=new a(this),this._internals=this._initInternals(),this._wireStates({"wcs-timer:running-changed":t=>({running:!0===t})})}get debugStates(){return this._internals?[...this._internals.states]:[]}_initInternals(){try{if("function"!=typeof this.attachInternals)return null;const t=this.attachInternals();return t.states.add("wcs-probe"),t.states.delete("wcs-probe"),t}catch{return null}}_wireStates(t){if(null===this._internals)return;const e=this._internals.states;for(const[i,r]of Object.entries(t))this.addEventListener(i,t=>{const i=this.hasAttribute("debug-states");for(const[s,n]of Object.entries(r(t.detail))){try{n?e.add(s):e.delete(s)}catch{}i&&this.toggleAttribute(`data-wcs-state-${s}`,n)}})}get connectedCallbackPromise(){return this._connectedCallbackPromise}get interval(){const t=this.getAttribute("interval");if(null===t||""===t.trim())return 1e3;const e=Number(t);return Number.isFinite(e)&&e>0?e:1e3}set interval(t){this.setAttribute("interval",String(t))}get once(){return this.hasAttribute("once")}set once(t){t?this.setAttribute("once",""):this.removeAttribute("once")}get repeat(){const t=this.getAttribute("repeat");if(null===t||""===t.trim())return 0;const e=Number(t);return Number.isFinite(e)&&e>0?e:0}set repeat(t){this.setAttribute("repeat",String(t))}get immediate(){return this.hasAttribute("immediate")}set immediate(t){t?this.setAttribute("immediate",""):this.removeAttribute("immediate")}get manual(){return this.hasAttribute("manual")}set manual(t){t?this.setAttribute("manual",""):this.removeAttribute("manual")}get tick(){return this._core.tick}get elapsed(){return this._core.elapsed}get running(){return this._core.running}get trigger(){return this._trigger}set trigger(t){!!t&&(this._trigger=!0,this.start(),this._trigger=!1,this.dispatchEvent(new CustomEvent("wcs-timer:trigger-changed",{detail:!1,bubbles:!0})))}start(){const t=this.repeat>0?this.repeat:this.once?1:0;this._core.start({interval:this.interval,repeat:t,immediate:this.immediate})}stop(){this._core.stop()}reset(){this._core.reset()}pause(){this._core.pause()}resume(){this._core.resume()}attributeChangedCallback(t,e,i){"interval"===t&&e!==i&&this.isConnected&&this.running&&this._core.changeInterval(this.interval)}connectedCallback(){this.style.display="none",s.autoTrigger&&(u||(u=!0,document.addEventListener("click",c))),this._connectedCallbackPromise=this._core.observe(),this.manual||this.start()}disconnectedCallback(){this._core.dispose()}}function l(e){var i;e&&("boolean"==typeof(i=e).autoTrigger&&(t.autoTrigger=i.autoTrigger),"string"==typeof i.triggerAttribute&&(t.triggerAttribute=i.triggerAttribute),i.tagNames&&Object.assign(t.tagNames,i.tagNames),r=null),customElements.get(s.tagNames.timer)||customElements.define(s.tagNames.timer,h)}export{a as TimerCore,h as WcsTimer,l as bootstrapTimer,n as getConfig};
 //# sourceMappingURL=index.esm.min.js.map

package/dist/index.esm.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.min.js","sources":["../src/config.ts","../src/core/TimerCore.ts","../src/autoTrigger.ts","../src/components/Timer.ts","../src/bootstrapTimer.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  autoTrigger: boolean;\n  triggerAttribute: string;\n  tagNames: {\n    timer: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  autoTrigger: true,\n  triggerAttribute: \"data-timertarget\",\n  tagNames: {\n    timer: \"wcs-timer\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\n// Internal-only live handle to the mutable config. NOT part of the public API\n// (deliberately absent from exports.ts) — it is exported solely so sibling\n// modules in this package can read current settings cheaply. External consumers\n// must use getConfig() (returns a deep-frozen snapshot) / setConfig(). Mutating\n// this object directly bypasses the frozenConfig cache and is unsupported.\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (typeof partialConfig.autoTrigger === \"boolean\") {\n    _config.autoTrigger = partialConfig.autoTrigger;\n  }\n  if (typeof partialConfig.triggerAttribute === \"string\") {\n    _config.triggerAttribute = partialConfig.triggerAttribute;\n  }\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IWcBindable } from \"../types.js\";\n\nexport interface TimerStartOptions {\n  interval?: number;\n  repeat?: number;\n  immediate?: boolean;\n}\n\n/**\n * Headless timer primitive. A thin, framework-agnostic wrapper around\n * `setInterval` exposed through the wc-bindable protocol: it streams `tick`\n * (a monotonically increasing counter), `elapsed` (running time in ms) and a\n * `running` flag, and is driven by the `start` / `stop` / `reset` / `pause` /\n * `resume` commands.\n *\n * `tick` and `elapsed` are both surfaced via the single `wcs-timer:tick` event\n * (read through getters, mirroring how FetchCore exposes value/status from one\n * `wcs-fetch:response` event), so an observer that binds either property is\n * notified on every fire.\n */\nexport class TimerCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"tick\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\" },\n    ],\n    commands: [\n      { name: \"start\" },\n      { name: \"stop\" },\n      { name: \"reset\" },\n      { name: \"pause\" },\n      { name: \"resume\" },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _timerId: ReturnType<typeof setInterval> | null = null;\n\n  // Generation guard (§3.4): bumped on dispose() and at every async start\n  // (start()/resume()). A scheduled callback (setInterval/setTimeout) captures the\n  // generation live via `_gen`; a fire that was already queued when the timer was\n  // torn down — or superseded by a new run — has a stale gen and MUST NOT mutate\n  // state or dispatch on a disposed element. _clearTimer() removes the handle, but\n  // the guard is the belt-and-braces defense for a callback already in the queue.\n  private _gen = 0;\n  // Generation captured for the currently scheduled run, set at each async start\n  // (start()/resume()). A scheduled callback compares it against the live `_gen`;\n  // a stale callback (dispose() bumped `_gen` after this run was armed) bails.\n  private _runGen = 0;\n  // SSR (§3.8): the timer does no asynchronous probe, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  private _tick: number = 0;\n  private _running: boolean = false;\n  private _paused: boolean = false;\n\n  // `_tick` value captured at the start of the current run. `repeat` counts ticks\n  // *per run*, so the stop condition compares against this baseline rather than the\n  // cumulative `_tick` (which only resets on reset()). Without it, re-starting a\n  // completed bounded timer would stop after a single tick.\n  private _runStartTick: number = 0;\n\n  // Timer configuration (captured on start, reused by pause/resume).\n  // `_immediate` is intentionally NOT a field: it is per-run intent consumed\n  // entirely within start() (fire once, then schedule), so it lives as a local\n  // there rather than lingering as instance state no other method reads.\n  private _interval: number = 1000;\n  private _repeat: number = 0;       // 0 = unlimited\n\n  // Elapsed-time bookkeeping. `_accumulatedElapsed` holds the time folded from\n  // already-finished running segments; `_segmentStart` is the timestamp the\n  // current running segment began (null when not running). The live elapsed is\n  // the sum of the two — see _currentElapsed().\n  private _accumulatedElapsed: number = 0;\n  private _segmentStart: number | null = null;\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get tick(): number {\n    return this._tick;\n  }\n\n  get elapsed(): number {\n    return this._currentElapsed();\n  }\n\n  get running(): boolean {\n    return this._running;\n  }\n\n  // SSR readiness (§3.8): resolves after the first probe. The timer is\n  // command-driven with nothing to probe, so this is an already-resolved promise.\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  // Lifecycle (§3.5). The timer is command-driven (start/stop/...) with no\n  // ambient subscription to establish, so observe() is an idempotent no-op that\n  // resolves once ready (mirroring UploadCore). dispose() tears the timer down —\n  // it stops any running interval and bumps the generation so a callback already\n  // queued cannot fire onto a torn-down element.\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._gen++;\n    this.stop();\n  }\n\n  // --- State setters with event dispatch ---\n\n  private _dispatchTick(): void {\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:tick\", {\n      detail: { count: this._tick, elapsed: this._currentElapsed() },\n      bubbles: true,\n    }));\n  }\n\n  private _setRunning(running: boolean): void {\n    if (this._running === running) return;\n    this._running = running;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:running-changed\", {\n      detail: running,\n      bubbles: true,\n    }));\n  }\n\n  // --- Public API ---\n\n  start(options: TimerStartOptions = {}): void {\n    // Idempotent while running: a redundant start() must not stack a second\n    // setInterval (which would leak and double the tick rate). Reconfiguring an\n    // active timer is done via stop() + start().\n    if (this._running) return;\n\n    // start() begins a fresh running segment, so clear any lingering pause from a\n    // prior pause()-without-resume(). Without this, the timer would run while\n    // _paused stayed true, leaving pause() a no-op and letting resume() overwrite\n    // the live timer handle (leak + double fire).\n    this._paused = false;\n\n    // `interval` is persistent configuration: a non-positive / non-finite value\n    // (or an omitted option) keeps the previous interval (default 1000ms). The\n    // guard rejects values that would turn setInterval into a hot loop and make\n    // resume()'s `accumulated % interval` arithmetic produce NaN. The Shell already\n    // falls back to 1000 for invalid attributes; this is the backstop for direct\n    // Core API callers.\n    if (typeof options.interval === \"number\" && Number.isFinite(options.interval) && options.interval > 0) {\n      this._interval = options.interval;\n    }\n\n    // `repeat` / `immediate` are per-run intent, NOT persistent configuration:\n    // every start() re-establishes them from the options, defaulting to\n    // \"unlimited\" / \"no immediate fire\" when omitted. This keeps a bare start()\n    // after a bounded or one-shot run from silently inheriting the old bounds.\n    // `repeat` is a field (pause/resume/_fire read it across the run); `immediate`\n    // is consumed here and now, so it stays a local.\n    this._repeat = (typeof options.repeat === \"number\" && options.repeat > 0) ? options.repeat : 0;\n    const immediate = options.immediate === true;\n\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // Baseline this run's per-run repeat counting (set after _setRunning so a\n    // re-start of a completed bounded timer fires the full N ticks again).\n    this._runStartTick = this._tick;\n    // Capture this run's generation (§3.4): a scheduled fire that outlives a\n    // dispose() (which bumps `_gen`) is then recognised as stale and ignored.\n    this._runGen = ++this._gen;\n\n    // Fire immediately on start when requested. _fire() may stop the timer (when\n    // repeat is reached), so re-check _running before scheduling the interval.\n    if (immediate) {\n      this._fire();\n    }\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  }\n\n  // Swap the tick period of a live timer in place, WITHOUT re-running start().\n  // Unlike stop() + start(), this leaves the per-run repeat progress in flight\n  // (`_repeat` and its `_runStartTick` baseline) untouched, so a bounded\n  // `repeat=\"N\"` run is not re-baselined to fire N more times. It also never goes\n  // through start()'s `immediate` path, so an `immediate` timer does not fire an\n  // extra tick. Only re-arms the steady interval; pause()/resume() and reset() are\n  // unaffected. No-op when not running (interval is then plain config, captured on\n  // the next start) or when the new period is non-positive / non-finite (which\n  // would turn setInterval into a hot loop and break resume()'s modulo arithmetic).\n  changeInterval(interval: number): void {\n    if (!this._running) return;\n    if (!(typeof interval === \"number\" && Number.isFinite(interval) && interval > 0)) return;\n    if (interval === this._interval) return;\n    this._interval = interval;\n    // Re-arm the steady ticking at the new period. The current period's progress\n    // is intentionally discarded (the next tick is a full new interval away),\n    // matching the boundary reset of the previous stop()+start() behaviour.\n    this._clearTimer();\n    this._timerId = setInterval(this._fire, this._interval);\n  }\n\n  stop(): void {\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = false;\n    this._setRunning(false);\n  }\n\n  reset(): void {\n    this._clearTimer();\n    this._paused = false;\n    this._tick = 0;\n    this._accumulatedElapsed = 0;\n    this._segmentStart = null;\n    this._setRunning(false);\n    // Notify observers that the counter/elapsed have returned to zero.\n    this._dispatchTick();\n  }\n\n  pause(): void {\n    // Pause only a live timer; a no-op otherwise so it composes safely with the\n    // declarative lifecycle. Unlike stop(), it records `_paused` so resume() can\n    // tell an intentional pause from a full stop.\n    if (!this._running || this._paused) return;\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = true;\n    this._setRunning(false);\n  }\n\n  resume(): void {\n    if (!this._paused) return;\n    this._paused = false;\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // New scheduled run after a pause: capture its generation (§3.4) so a\n    // post-dispose() boundary/interval callback is recognised as stale.\n    this._runGen = ++this._gen;\n    // Invariant: `_interval` is fixed at start() and stays constant for the whole\n    // pause/resume cycle — changeInterval() only mutates it while *running* (never\n    // while paused), so the remainder arithmetic below can safely assume the same\n    // period was in effect across the paused segment. Consequence for the Shell:\n    // because the live interval-attribute path (attributeChangedCallback ->\n    // changeInterval) is gated on `running`, an `interval` change made *while\n    // paused* is silently not applied here; it is picked up only on the next\n    // start() as plain config. This is by design — see README \"Commands\".\n    // Resume seamlessly: a tick fires every `interval` ms of *running* time, so\n    // honour the partial period consumed before the pause. Wait only the\n    // remainder to the next boundary, then fall back to the steady interval.\n    // (`accumulated % interval === 0` — paused exactly on a boundary — yields a\n    // full interval, which is correct: the next tick is a whole period away.)\n    const remainder = this._interval - (this._accumulatedElapsed % this._interval);\n    this._timerId = setTimeout(this._onResumeBoundary, remainder);\n  }\n\n  // --- Internal ---\n\n  private _onResumeBoundary = (): void => {\n    // Stale-run guard (§3.4): a resume-boundary timeout that fires after dispose()\n    // belongs to a torn-down run — drop it without re-arming the interval.\n    if (this._runGen !== this._gen) return;\n    this._timerId = null;\n    this._fire();\n    // _fire() may have auto-stopped the timer (repeat reached); only re-arm the\n    // steady interval while still running.\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  };\n\n  private _fire = (): void => {\n    // Stale-run guard (§3.4): an interval callback queued before dispose() (which\n    // bumps `_gen`) must not tick or dispatch onto a torn-down element.\n    if (this._runGen !== this._gen) return;\n    this._tick++;\n    this._dispatchTick();\n\n    // Auto-stop once this run has fired the requested number of ticks (repeat=0\n    // runs forever). Counted per-run via `_runStartTick`, so a re-start after a\n    // completed bounded run fires N ticks again. `once` is expressed by the Shell\n    // as repeat=1.\n    if (this._repeat > 0 && (this._tick - this._runStartTick) >= this._repeat) {\n      this._clearTimer();\n      this._foldElapsed();\n      this._setRunning(false);\n    }\n  };\n\n  private _clearTimer(): void {\n    if (this._timerId !== null) {\n      // `_timerId` may hold a setInterval handle (steady ticking) or a setTimeout\n      // handle (the resume remainder). Clear both — per the HTML spec timers\n      // share one list and clearTimeout/clearInterval each remove the entry\n      // regardless of which call created it.\n      clearTimeout(this._timerId);\n      clearInterval(this._timerId);\n      this._timerId = null;\n    }\n  }\n\n  private _foldElapsed(): void {\n    if (this._segmentStart !== null) {\n      this._accumulatedElapsed += Date.now() - this._segmentStart;\n      this._segmentStart = null;\n    }\n  }\n\n  private _currentElapsed(): number {\n    return this._accumulatedElapsed +\n      (this._segmentStart !== null ? Date.now() - this._segmentStart : 0);\n  }\n}\n","import { config } from \"./config.js\";\nimport type { Timer } from \"./components/Timer.js\";\n\nlet registered = false;\n\nfunction handleClick(event: Event): void {\n  const target = event.target;\n  if (!(target instanceof Element)) return;\n\n  const triggerElement = target.closest<Element>(`[${config.triggerAttribute}]`);\n  if (!triggerElement) return;\n\n  const timerId = triggerElement.getAttribute(config.triggerAttribute);\n  if (!timerId) return;\n\n  // Resolve the registered constructor at call time instead of importing Timer\n  // as a value. The value import created a components/Timer.ts ⇄ autoTrigger.ts\n  // cycle (Timer.connectedCallback() calls registerAutoTrigger()). instanceof\n  // against the customElements registry keeps the exact same identity guarantee\n  // — only the registered <wcs-timer> class matches — without the import cycle.\n  const TimerCtor = customElements.get(config.tagNames.timer);\n  const timerElement = document.getElementById(timerId);\n  if (!TimerCtor || !(timerElement instanceof TimerCtor)) return;\n\n  // Suppress the element's default action so a timer can start without\n  // navigating. Intentional: do not attach data-timertarget to an element whose\n  // default action you also want (real <a href> link, form-submit button) — it\n  // will be cancelled. See README \"Optional DOM Triggering\".\n  event.preventDefault();\n  (timerElement as Timer).start();\n}\n\nexport function registerAutoTrigger(): void {\n  if (registered) return;\n  registered = true;\n  document.addEventListener(\"click\", handleClick);\n}\n\nexport function unregisterAutoTrigger(): void {\n  if (!registered) return;\n  registered = false;\n  document.removeEventListener(\"click\", handleClick);\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\n\nexport class Timer extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n  static wcBindable: IWcBindable = {\n    ...TimerCore.wcBindable,\n    properties: [\n      ...TimerCore.wcBindable.properties,\n      { name: \"trigger\", event: \"wcs-timer:trigger-changed\" },\n    ],\n    // Shell-level settable surface. `attribute` is a purely descriptive hint\n    // (per SPEC-extensions.md the binding core does not act on it) naming the\n    // mirrored HTML attribute, matching <wcs-geo> / <wcs-debounce>. `trigger` is a\n    // momentary command-property with no backing attribute, so it carries no hint\n    // (same as those packages). `start` / `stop` / `reset` / `pause` / `resume`\n    // commands are inherited from the Core above.\n    inputs: [\n      { name: \"interval\", attribute: \"interval\" },\n      { name: \"once\", attribute: \"once\" },\n      { name: \"repeat\", attribute: \"repeat\" },\n      { name: \"immediate\", attribute: \"immediate\" },\n      { name: \"manual\", attribute: \"manual\" },\n      { name: \"trigger\" },\n    ],\n  };\n  static get observedAttributes(): string[] { return [\"interval\"]; }\n\n  private _core: TimerCore;\n  private _trigger: boolean = false;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new TimerCore(this);\n  }\n\n  // SSR (§4.1/§4.4): the Shell exposes the Core's readiness so a server-side\n  // renderer can await the connect-time probe before snapshotting. The timer has\n  // no async probe (observe() resolves immediately), but the contract is uniform\n  // across IO nodes.\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Attribute accessors ---\n\n  get interval(): number {\n    const attr = this.getAttribute(\"interval\");\n    if (attr === null || attr.trim() === \"\") return 1000;\n    // Strict parse via Number() (unlike parseInt, \"100px\" -> NaN, not 100),\n    // matching <wcs-geo> / <wcs-debounce>. Fall back to the 1000ms default for any\n    // invalid period — not only NaN but also 0 / negative values, which would\n    // otherwise reach setInterval as a hot loop and break resume()'s modulo\n    // arithmetic in the Core.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 1000;\n  }\n\n  set interval(value: number) {\n    this.setAttribute(\"interval\", String(value));\n  }\n\n  get once(): boolean {\n    return this.hasAttribute(\"once\");\n  }\n\n  set once(value: boolean) {\n    if (value) {\n      this.setAttribute(\"once\", \"\");\n    } else {\n      this.removeAttribute(\"once\");\n    }\n  }\n\n  get repeat(): number {\n    const attr = this.getAttribute(\"repeat\");\n    if (attr === null || attr.trim() === \"\") return 0;\n    // Strict parse via Number() (\"3px\" -> NaN, not 3), matching <wcs-geo> /\n    // <wcs-debounce>. Normalise any non-positive / non-numeric value to 0\n    // (= unlimited), mirroring the `interval` getter. Without this a negative\n    // `repeat=\"-3\"` would leak through to start(); harmless today (Core treats\n    // `_repeat <= 0` as unlimited) but the asymmetry is a trap.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 0;\n  }\n\n  set repeat(value: number) {\n    this.setAttribute(\"repeat\", String(value));\n  }\n\n  get immediate(): boolean {\n    return this.hasAttribute(\"immediate\");\n  }\n\n  set immediate(value: boolean) {\n    if (value) {\n      this.setAttribute(\"immediate\", \"\");\n    } else {\n      this.removeAttribute(\"immediate\");\n    }\n  }\n\n  get manual(): boolean {\n    return this.hasAttribute(\"manual\");\n  }\n\n  set manual(value: boolean) {\n    if (value) {\n      this.setAttribute(\"manual\", \"\");\n    } else {\n      this.removeAttribute(\"manual\");\n    }\n  }\n\n  // --- Core delegated getters ---\n\n  get tick(): number {\n    return this._core.tick;\n  }\n\n  get elapsed(): number {\n    return this._core.elapsed;\n  }\n\n  get running(): boolean {\n    return this._core.running;\n  }\n\n  // --- Command property ---\n\n  get trigger(): boolean {\n    return this._trigger;\n  }\n\n  set trigger(value: boolean) {\n    // Momentary command-property: a false→true write starts the timer. Mirrors\n    // the trigger flag on <wcs-fetch> / <wcs-ws>. Prefer the command-token\n    // protocol (`command.start: $command.tick`) for state-driven starts; this\n    // exists mainly for the DOM click trigger and simple boolean bindings.\n    const v = !!value;\n    if (v) {\n      this._trigger = true;\n      this.start();\n      this._trigger = false;\n      // The `trigger-changed` event reports the momentary flag returning to\n      // false, i.e. that the trigger property *changed* — it is deliberately not\n      // gated on whether start() actually began a new run. This keeps the\n      // wcBindable `trigger` property's change-notification semantics consistent\n      // (every false→true write produces exactly one change-back event), even\n      // when start() was a no-op because the timer was already running.\n      this.dispatchEvent(new CustomEvent(\"wcs-timer:trigger-changed\", {\n        detail: false,\n        bubbles: true,\n      }));\n    }\n  }\n\n  // --- Commands ---\n\n  start(): void {\n    // `once` is sugar for \"fire exactly one tick\": map it to repeat=1, but let an\n    // explicit repeat attribute win when both are present.\n    const repeat = this.repeat > 0 ? this.repeat : (this.once ? 1 : 0);\n    this._core.start({\n      interval: this.interval,\n      repeat,\n      immediate: this.immediate,\n    });\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  reset(): void {\n    this._core.reset();\n  }\n\n  pause(): void {\n    this._core.pause();\n  }\n\n  resume(): void {\n    this._core.resume();\n  }\n\n  // --- Lifecycle ---\n\n  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void {\n    // Live interval changes swap the underlying setInterval period in place.\n    // `tick` / `elapsed` and the per-run `repeat` progress are preserved — we\n    // deliberately do NOT stop()+start(), which would re-run start() and\n    // re-evaluate per-run options (re-firing `immediate` and re-baselining\n    // `repeat`). `running` alone gates this: swapping the period is orthogonal to\n    // *how* the timer was started, so a `manual` timer the user has explicitly\n    // started gets live period changes too. A non-running timer needs no swap —\n    // its next start() picks up the new attribute as plain config.\n    if (name === \"interval\" && oldValue !== newValue && this.isConnected && this.running) {\n      this._core.changeInterval(this.interval);\n    }\n  }\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    if (config.autoTrigger) {\n      registerAutoTrigger();\n    }\n    // Establish monitoring (§3.5). observe() is a no-op that resolves once ready;\n    // expose it as connectedCallbackPromise for SSR.\n    this._connectedCallbackPromise = this._core.observe();\n    if (!this.manual) {\n      this.start();\n    }\n  }\n\n  disconnectedCallback(): void {\n    // dispose() stops the timer and bumps the generation so a callback already\n    // queued cannot fire onto a disconnected element (§3.5 / §4.4).\n    this._core.dispose();\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapTimer(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { Timer } from \"./components/Timer.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.timer)) {\n    customElements.define(config.tagNames.timer, Timer);\n  }\n}\n"],"names":["_config","autoTrigger","triggerAttribute","tagNames","timer","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","TimerCore","EventTarget","static","protocol","version","properties","name","event","getter","e","detail","count","elapsed","commands","_target","_timerId","_gen","_runGen","_ready","Promise","resolve","_tick","_running","_paused","_runStartTick","_interval","_repeat","_accumulatedElapsed","_segmentStart","constructor","target","super","this","tick","_currentElapsed","running","ready","observe","dispose","stop","_dispatchTick","dispatchEvent","CustomEvent","bubbles","_setRunning","start","options","interval","Number","isFinite","repeat","immediate","Date","now","_fire","setInterval","changeInterval","_clearTimer","_foldElapsed","reset","pause","resume","remainder","setTimeout","_onResumeBoundary","clearTimeout","clearInterval","registered","handleClick","Element","triggerElement","closest","timerId","getAttribute","TimerCtor","customElements","get","timerElement","document","getElementById","preventDefault","Timer","HTMLElement","wcBindable","inputs","attribute","observedAttributes","_core","_trigger","_connectedCallbackPromise","connectedCallbackPromise","attr","trim","parsed","value","setAttribute","String","once","hasAttribute","removeAttribute","manual","trigger","attributeChangedCallback","oldValue","newValue","isConnected","connectedCallback","style","display","addEventListener","disconnectedCallback","bootstrapTimer","userConfig","partialConfig","assign","define"],"mappings":"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"}
+{"version":3,"file":"index.esm.min.js","sources":["../src/config.ts","../src/core/TimerCore.ts","../src/autoTrigger.ts","../src/components/Timer.ts","../src/bootstrapTimer.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  autoTrigger: boolean;\n  triggerAttribute: string;\n  tagNames: {\n    timer: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  autoTrigger: true,\n  triggerAttribute: \"data-timertarget\",\n  tagNames: {\n    timer: \"wcs-timer\",\n  },\n};\n\nfunction deepFreeze<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  Object.freeze(obj);\n  for (const key of Object.keys(obj)) {\n    deepFreeze((obj as Record<string, unknown>)[key]);\n  }\n  return obj;\n}\n\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  const clone: Record<string, unknown> = {};\n  for (const key of Object.keys(obj)) {\n    clone[key] = deepClone((obj as Record<string, unknown>)[key]);\n  }\n  return clone as T;\n}\n\nlet frozenConfig: IConfig | null = null;\n\n// Internal-only live handle to the mutable config. NOT part of the public API\n// (deliberately absent from exports.ts) — it is exported solely so sibling\n// modules in this package can read current settings cheaply. External consumers\n// must use getConfig() (returns a deep-frozen snapshot) / setConfig(). Mutating\n// this object directly bypasses the frozenConfig cache and is unsupported.\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (typeof partialConfig.autoTrigger === \"boolean\") {\n    _config.autoTrigger = partialConfig.autoTrigger;\n  }\n  if (typeof partialConfig.triggerAttribute === \"string\") {\n    _config.triggerAttribute = partialConfig.triggerAttribute;\n  }\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IWcBindable } from \"../types.js\";\n\nexport interface TimerStartOptions {\n  interval?: number;\n  repeat?: number;\n  immediate?: boolean;\n}\n\n/**\n * Headless timer primitive. A thin, framework-agnostic wrapper around\n * `setInterval` exposed through the wc-bindable protocol: it streams `tick`\n * (a monotonically increasing counter), `elapsed` (running time in ms) and a\n * `running` flag, and is driven by the `start` / `stop` / `reset` / `pause` /\n * `resume` commands.\n *\n * `tick` and `elapsed` are both surfaced via the single `wcs-timer:tick` event\n * (read through getters, mirroring how FetchCore exposes value/status from one\n * `wcs-fetch:response` event), so an observer that binds either property is\n * notified on every fire.\n */\nexport class TimerCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"tick\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\" },\n    ],\n    commands: [\n      { name: \"start\" },\n      { name: \"stop\" },\n      { name: \"reset\" },\n      { name: \"pause\" },\n      { name: \"resume\" },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _timerId: ReturnType<typeof setInterval> | null = null;\n\n  // Generation guard (§3.4): bumped on dispose() and at every async start\n  // (start()/resume()). A scheduled callback (setInterval/setTimeout) captures the\n  // generation live via `_gen`; a fire that was already queued when the timer was\n  // torn down — or superseded by a new run — has a stale gen and MUST NOT mutate\n  // state or dispatch on a disposed element. _clearTimer() removes the handle, but\n  // the guard is the belt-and-braces defense for a callback already in the queue.\n  private _gen = 0;\n  // Generation captured for the currently scheduled run, set at each async start\n  // (start()/resume()). A scheduled callback compares it against the live `_gen`;\n  // a stale callback (dispose() bumped `_gen` after this run was armed) bails.\n  private _runGen = 0;\n  // SSR (§3.8): the timer does no asynchronous probe, so readiness is immediate.\n  private _ready: Promise<void> = Promise.resolve();\n\n  private _tick: number = 0;\n  private _running: boolean = false;\n  private _paused: boolean = false;\n\n  // `_tick` value captured at the start of the current run. `repeat` counts ticks\n  // *per run*, so the stop condition compares against this baseline rather than the\n  // cumulative `_tick` (which only resets on reset()). Without it, re-starting a\n  // completed bounded timer would stop after a single tick.\n  private _runStartTick: number = 0;\n\n  // Timer configuration (captured on start, reused by pause/resume).\n  // `_immediate` is intentionally NOT a field: it is per-run intent consumed\n  // entirely within start() (fire once, then schedule), so it lives as a local\n  // there rather than lingering as instance state no other method reads.\n  private _interval: number = 1000;\n  private _repeat: number = 0;       // 0 = unlimited\n\n  // Elapsed-time bookkeeping. `_accumulatedElapsed` holds the time folded from\n  // already-finished running segments; `_segmentStart` is the timestamp the\n  // current running segment began (null when not running). The live elapsed is\n  // the sum of the two — see _currentElapsed().\n  private _accumulatedElapsed: number = 0;\n  private _segmentStart: number | null = null;\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get tick(): number {\n    return this._tick;\n  }\n\n  get elapsed(): number {\n    return this._currentElapsed();\n  }\n\n  get running(): boolean {\n    return this._running;\n  }\n\n  // SSR readiness (§3.8): resolves after the first probe. The timer is\n  // command-driven with nothing to probe, so this is an already-resolved promise.\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  // Lifecycle (§3.5). The timer is command-driven (start/stop/...) with no\n  // ambient subscription to establish, so observe() is an idempotent no-op that\n  // resolves once ready (mirroring UploadCore). dispose() tears the timer down —\n  // it stops any running interval and bumps the generation so a callback already\n  // queued cannot fire onto a torn-down element.\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this._gen++;\n    this.stop();\n  }\n\n  // --- State setters with event dispatch ---\n\n  private _dispatchTick(): void {\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:tick\", {\n      detail: { count: this._tick, elapsed: this._currentElapsed() },\n      bubbles: true,\n    }));\n  }\n\n  private _setRunning(running: boolean): void {\n    if (this._running === running) return;\n    this._running = running;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-timer:running-changed\", {\n      detail: running,\n      bubbles: true,\n    }));\n  }\n\n  // --- Public API ---\n\n  start(options: TimerStartOptions = {}): void {\n    // Idempotent while running: a redundant start() must not stack a second\n    // setInterval (which would leak and double the tick rate). Reconfiguring an\n    // active timer is done via stop() + start().\n    if (this._running) return;\n\n    // start() begins a fresh running segment, so clear any lingering pause from a\n    // prior pause()-without-resume(). Without this, the timer would run while\n    // _paused stayed true, leaving pause() a no-op and letting resume() overwrite\n    // the live timer handle (leak + double fire).\n    this._paused = false;\n\n    // `interval` is persistent configuration: a non-positive / non-finite value\n    // (or an omitted option) keeps the previous interval (default 1000ms). The\n    // guard rejects values that would turn setInterval into a hot loop and make\n    // resume()'s `accumulated % interval` arithmetic produce NaN. The Shell already\n    // falls back to 1000 for invalid attributes; this is the backstop for direct\n    // Core API callers.\n    if (typeof options.interval === \"number\" && Number.isFinite(options.interval) && options.interval > 0) {\n      this._interval = options.interval;\n    }\n\n    // `repeat` / `immediate` are per-run intent, NOT persistent configuration:\n    // every start() re-establishes them from the options, defaulting to\n    // \"unlimited\" / \"no immediate fire\" when omitted. This keeps a bare start()\n    // after a bounded or one-shot run from silently inheriting the old bounds.\n    // `repeat` is a field (pause/resume/_fire read it across the run); `immediate`\n    // is consumed here and now, so it stays a local.\n    this._repeat = (typeof options.repeat === \"number\" && options.repeat > 0) ? options.repeat : 0;\n    const immediate = options.immediate === true;\n\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // Baseline this run's per-run repeat counting (set after _setRunning so a\n    // re-start of a completed bounded timer fires the full N ticks again).\n    this._runStartTick = this._tick;\n    // Capture this run's generation (§3.4): a scheduled fire that outlives a\n    // dispose() (which bumps `_gen`) is then recognised as stale and ignored.\n    this._runGen = ++this._gen;\n\n    // Fire immediately on start when requested. _fire() may stop the timer (when\n    // repeat is reached), so re-check _running before scheduling the interval.\n    if (immediate) {\n      this._fire();\n    }\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  }\n\n  // Swap the tick period of a live timer in place, WITHOUT re-running start().\n  // Unlike stop() + start(), this leaves the per-run repeat progress in flight\n  // (`_repeat` and its `_runStartTick` baseline) untouched, so a bounded\n  // `repeat=\"N\"` run is not re-baselined to fire N more times. It also never goes\n  // through start()'s `immediate` path, so an `immediate` timer does not fire an\n  // extra tick. Only re-arms the steady interval; pause()/resume() and reset() are\n  // unaffected. No-op when not running (interval is then plain config, captured on\n  // the next start) or when the new period is non-positive / non-finite (which\n  // would turn setInterval into a hot loop and break resume()'s modulo arithmetic).\n  changeInterval(interval: number): void {\n    if (!this._running) return;\n    if (!(typeof interval === \"number\" && Number.isFinite(interval) && interval > 0)) return;\n    if (interval === this._interval) return;\n    this._interval = interval;\n    // Re-arm the steady ticking at the new period. The current period's progress\n    // is intentionally discarded (the next tick is a full new interval away),\n    // matching the boundary reset of the previous stop()+start() behaviour.\n    this._clearTimer();\n    this._timerId = setInterval(this._fire, this._interval);\n  }\n\n  stop(): void {\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = false;\n    this._setRunning(false);\n  }\n\n  reset(): void {\n    this._clearTimer();\n    this._paused = false;\n    this._tick = 0;\n    this._accumulatedElapsed = 0;\n    this._segmentStart = null;\n    this._setRunning(false);\n    // Notify observers that the counter/elapsed have returned to zero.\n    this._dispatchTick();\n  }\n\n  pause(): void {\n    // Pause only a live timer; a no-op otherwise so it composes safely with the\n    // declarative lifecycle. Unlike stop(), it records `_paused` so resume() can\n    // tell an intentional pause from a full stop.\n    if (!this._running || this._paused) return;\n    this._clearTimer();\n    this._foldElapsed();\n    this._paused = true;\n    this._setRunning(false);\n  }\n\n  resume(): void {\n    if (!this._paused) return;\n    this._paused = false;\n    this._setRunning(true);\n    this._segmentStart = Date.now();\n    // New scheduled run after a pause: capture its generation (§3.4) so a\n    // post-dispose() boundary/interval callback is recognised as stale.\n    this._runGen = ++this._gen;\n    // Invariant: `_interval` is fixed at start() and stays constant for the whole\n    // pause/resume cycle — changeInterval() only mutates it while *running* (never\n    // while paused), so the remainder arithmetic below can safely assume the same\n    // period was in effect across the paused segment. Consequence for the Shell:\n    // because the live interval-attribute path (attributeChangedCallback ->\n    // changeInterval) is gated on `running`, an `interval` change made *while\n    // paused* is silently not applied here; it is picked up only on the next\n    // start() as plain config. This is by design — see README \"Commands\".\n    // Resume seamlessly: a tick fires every `interval` ms of *running* time, so\n    // honour the partial period consumed before the pause. Wait only the\n    // remainder to the next boundary, then fall back to the steady interval.\n    // (`accumulated % interval === 0` — paused exactly on a boundary — yields a\n    // full interval, which is correct: the next tick is a whole period away.)\n    const remainder = this._interval - (this._accumulatedElapsed % this._interval);\n    this._timerId = setTimeout(this._onResumeBoundary, remainder);\n  }\n\n  // --- Internal ---\n\n  private _onResumeBoundary = (): void => {\n    // Stale-run guard (§3.4): a resume-boundary timeout that fires after dispose()\n    // belongs to a torn-down run — drop it without re-arming the interval.\n    if (this._runGen !== this._gen) return;\n    this._timerId = null;\n    this._fire();\n    // _fire() may have auto-stopped the timer (repeat reached); only re-arm the\n    // steady interval while still running.\n    if (this._running) {\n      this._timerId = setInterval(this._fire, this._interval);\n    }\n  };\n\n  private _fire = (): void => {\n    // Stale-run guard (§3.4): an interval callback queued before dispose() (which\n    // bumps `_gen`) must not tick or dispatch onto a torn-down element.\n    if (this._runGen !== this._gen) return;\n    this._tick++;\n    this._dispatchTick();\n\n    // Auto-stop once this run has fired the requested number of ticks (repeat=0\n    // runs forever). Counted per-run via `_runStartTick`, so a re-start after a\n    // completed bounded run fires N ticks again. `once` is expressed by the Shell\n    // as repeat=1.\n    if (this._repeat > 0 && (this._tick - this._runStartTick) >= this._repeat) {\n      this._clearTimer();\n      this._foldElapsed();\n      this._setRunning(false);\n    }\n  };\n\n  private _clearTimer(): void {\n    if (this._timerId !== null) {\n      // `_timerId` may hold a setInterval handle (steady ticking) or a setTimeout\n      // handle (the resume remainder). Clear both — per the HTML spec timers\n      // share one list and clearTimeout/clearInterval each remove the entry\n      // regardless of which call created it.\n      clearTimeout(this._timerId);\n      clearInterval(this._timerId);\n      this._timerId = null;\n    }\n  }\n\n  private _foldElapsed(): void {\n    if (this._segmentStart !== null) {\n      this._accumulatedElapsed += Date.now() - this._segmentStart;\n      this._segmentStart = null;\n    }\n  }\n\n  private _currentElapsed(): number {\n    return this._accumulatedElapsed +\n      (this._segmentStart !== null ? Date.now() - this._segmentStart : 0);\n  }\n}\n","import { config } from \"./config.js\";\nimport type { Timer } from \"./components/Timer.js\";\n\nlet registered = false;\n\nfunction handleClick(event: Event): void {\n  const target = event.target;\n  if (!(target instanceof Element)) return;\n\n  const triggerElement = target.closest<Element>(`[${config.triggerAttribute}]`);\n  if (!triggerElement) return;\n\n  const timerId = triggerElement.getAttribute(config.triggerAttribute);\n  if (!timerId) return;\n\n  // Resolve the registered constructor at call time instead of importing Timer\n  // as a value. The value import created a components/Timer.ts ⇄ autoTrigger.ts\n  // cycle (Timer.connectedCallback() calls registerAutoTrigger()). instanceof\n  // against the customElements registry keeps the exact same identity guarantee\n  // — only the registered <wcs-timer> class matches — without the import cycle.\n  const TimerCtor = customElements.get(config.tagNames.timer);\n  const timerElement = document.getElementById(timerId);\n  if (!TimerCtor || !(timerElement instanceof TimerCtor)) return;\n\n  // Suppress the element's default action so a timer can start without\n  // navigating. Intentional: do not attach data-timertarget to an element whose\n  // default action you also want (real <a href> link, form-submit button) — it\n  // will be cancelled. See README \"Optional DOM Triggering\".\n  event.preventDefault();\n  (timerElement as Timer).start();\n}\n\nexport function registerAutoTrigger(): void {\n  if (registered) return;\n  registered = true;\n  document.addEventListener(\"click\", handleClick);\n}\n\nexport function unregisterAutoTrigger(): void {\n  if (!registered) return;\n  registered = false;\n  document.removeEventListener(\"click\", handleClick);\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\n\nexport class Timer extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n  static wcBindable: IWcBindable = {\n    ...TimerCore.wcBindable,\n    properties: [\n      ...TimerCore.wcBindable.properties,\n      { name: \"trigger\", event: \"wcs-timer:trigger-changed\" },\n    ],\n    // Shell-level settable surface. `attribute` is a purely descriptive hint\n    // (per SPEC-extensions.md the binding core does not act on it) naming the\n    // mirrored HTML attribute, matching <wcs-geo> / <wcs-debounce>. `trigger` is a\n    // momentary command-property with no backing attribute, so it carries no hint\n    // (same as those packages). `start` / `stop` / `reset` / `pause` / `resume`\n    // commands are inherited from the Core above.\n    inputs: [\n      { name: \"interval\", attribute: \"interval\" },\n      { name: \"once\", attribute: \"once\" },\n      { name: \"repeat\", attribute: \"repeat\" },\n      { name: \"immediate\", attribute: \"immediate\" },\n      { name: \"manual\", attribute: \"manual\" },\n      { name: \"trigger\" },\n    ],\n  };\n  static get observedAttributes(): string[] { return [\"interval\"]; }\n\n  private _core: TimerCore;\n  private _trigger: boolean = false;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n  private _internals: ElementInternals | null = null;\n\n  constructor() {\n    super();\n    this._core = new TimerCore(this);\n    this._internals = this._initInternals();\n    this._wireStates({\n      \"wcs-timer:running-changed\": (d) => ({ running: d === true }),\n    });\n  }\n\n  // CSS state reflection (:state()) — debug-only snapshot getter. NOT part of\n  // wc-bindable (not a bind target); see README \"CSS styling with :state()\".\n  // MUST NOT return the live CustomStateSet (that would let callers write\n  // states from outside, defeating the point of :state() being read-only).\n  get debugStates(): string[] {\n    return this._internals ? [...this._internals.states] : [];\n  }\n\n  private _initInternals(): ElementInternals | null {\n    // never-throw (async-io-node-guidelines.md §3.6): attachInternals is absent\n    // in happy-dom / older environments, and pre-125 Chromium rejects\n    // non-dashed state names from states.add() (probed and discarded here).\n    // Either case silently disables reflection — the component still works,\n    // it just doesn't expose :state() selectors.\n    try {\n      if (typeof this.attachInternals !== \"function\") return null;\n      const internals = this.attachInternals();\n      internals.states.add(\"wcs-probe\");\n      internals.states.delete(\"wcs-probe\");\n      return internals;\n    } catch {\n      return null;\n    }\n  }\n\n  private _wireStates(map: Record<string, (detail: any) => Record<string, boolean>>): void {\n    if (this._internals === null) return;\n    const states = this._internals.states;\n    for (const [event, toStates] of Object.entries(map)) {\n      this.addEventListener(event, (e) => {\n        const debug = this.hasAttribute(\"debug-states\");\n        for (const [name, on] of Object.entries(toStates((e as CustomEvent).detail))) {\n          try {\n            if (on) { states.add(name); } else { states.delete(name); }\n          } catch { /* never-throw */ }\n          if (debug) this.toggleAttribute(`data-wcs-state-${name}`, on);\n        }\n      });\n    }\n  }\n\n  // SSR (§4.1/§4.4): the Shell exposes the Core's readiness so a server-side\n  // renderer can await the connect-time probe before snapshotting. The timer has\n  // no async probe (observe() resolves immediately), but the contract is uniform\n  // across IO nodes.\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Attribute accessors ---\n\n  get interval(): number {\n    const attr = this.getAttribute(\"interval\");\n    if (attr === null || attr.trim() === \"\") return 1000;\n    // Strict parse via Number() (unlike parseInt, \"100px\" -> NaN, not 100),\n    // matching <wcs-geo> / <wcs-debounce>. Fall back to the 1000ms default for any\n    // invalid period — not only NaN but also 0 / negative values, which would\n    // otherwise reach setInterval as a hot loop and break resume()'s modulo\n    // arithmetic in the Core.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 1000;\n  }\n\n  set interval(value: number) {\n    this.setAttribute(\"interval\", String(value));\n  }\n\n  get once(): boolean {\n    return this.hasAttribute(\"once\");\n  }\n\n  set once(value: boolean) {\n    if (value) {\n      this.setAttribute(\"once\", \"\");\n    } else {\n      this.removeAttribute(\"once\");\n    }\n  }\n\n  get repeat(): number {\n    const attr = this.getAttribute(\"repeat\");\n    if (attr === null || attr.trim() === \"\") return 0;\n    // Strict parse via Number() (\"3px\" -> NaN, not 3), matching <wcs-geo> /\n    // <wcs-debounce>. Normalise any non-positive / non-numeric value to 0\n    // (= unlimited), mirroring the `interval` getter. Without this a negative\n    // `repeat=\"-3\"` would leak through to start(); harmless today (Core treats\n    // `_repeat <= 0` as unlimited) but the asymmetry is a trap.\n    const parsed = Number(attr);\n    return (Number.isFinite(parsed) && parsed > 0) ? parsed : 0;\n  }\n\n  set repeat(value: number) {\n    this.setAttribute(\"repeat\", String(value));\n  }\n\n  get immediate(): boolean {\n    return this.hasAttribute(\"immediate\");\n  }\n\n  set immediate(value: boolean) {\n    if (value) {\n      this.setAttribute(\"immediate\", \"\");\n    } else {\n      this.removeAttribute(\"immediate\");\n    }\n  }\n\n  get manual(): boolean {\n    return this.hasAttribute(\"manual\");\n  }\n\n  set manual(value: boolean) {\n    if (value) {\n      this.setAttribute(\"manual\", \"\");\n    } else {\n      this.removeAttribute(\"manual\");\n    }\n  }\n\n  // --- Core delegated getters ---\n\n  get tick(): number {\n    return this._core.tick;\n  }\n\n  get elapsed(): number {\n    return this._core.elapsed;\n  }\n\n  get running(): boolean {\n    return this._core.running;\n  }\n\n  // --- Command property ---\n\n  get trigger(): boolean {\n    return this._trigger;\n  }\n\n  set trigger(value: boolean) {\n    // Momentary command-property: a false→true write starts the timer. Mirrors\n    // the trigger flag on <wcs-fetch> / <wcs-ws>. Prefer the command-token\n    // protocol (`command.start: $command.tick`) for state-driven starts; this\n    // exists mainly for the DOM click trigger and simple boolean bindings.\n    const v = !!value;\n    if (v) {\n      this._trigger = true;\n      this.start();\n      this._trigger = false;\n      // The `trigger-changed` event reports the momentary flag returning to\n      // false, i.e. that the trigger property *changed* — it is deliberately not\n      // gated on whether start() actually began a new run. This keeps the\n      // wcBindable `trigger` property's change-notification semantics consistent\n      // (every false→true write produces exactly one change-back event), even\n      // when start() was a no-op because the timer was already running.\n      this.dispatchEvent(new CustomEvent(\"wcs-timer:trigger-changed\", {\n        detail: false,\n        bubbles: true,\n      }));\n    }\n  }\n\n  // --- Commands ---\n\n  start(): void {\n    // `once` is sugar for \"fire exactly one tick\": map it to repeat=1, but let an\n    // explicit repeat attribute win when both are present.\n    const repeat = this.repeat > 0 ? this.repeat : (this.once ? 1 : 0);\n    this._core.start({\n      interval: this.interval,\n      repeat,\n      immediate: this.immediate,\n    });\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  reset(): void {\n    this._core.reset();\n  }\n\n  pause(): void {\n    this._core.pause();\n  }\n\n  resume(): void {\n    this._core.resume();\n  }\n\n  // --- Lifecycle ---\n\n  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void {\n    // Live interval changes swap the underlying setInterval period in place.\n    // `tick` / `elapsed` and the per-run `repeat` progress are preserved — we\n    // deliberately do NOT stop()+start(), which would re-run start() and\n    // re-evaluate per-run options (re-firing `immediate` and re-baselining\n    // `repeat`). `running` alone gates this: swapping the period is orthogonal to\n    // *how* the timer was started, so a `manual` timer the user has explicitly\n    // started gets live period changes too. A non-running timer needs no swap —\n    // its next start() picks up the new attribute as plain config.\n    if (name === \"interval\" && oldValue !== newValue && this.isConnected && this.running) {\n      this._core.changeInterval(this.interval);\n    }\n  }\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    if (config.autoTrigger) {\n      registerAutoTrigger();\n    }\n    // Establish monitoring (§3.5). observe() is a no-op that resolves once ready;\n    // expose it as connectedCallbackPromise for SSR.\n    this._connectedCallbackPromise = this._core.observe();\n    if (!this.manual) {\n      this.start();\n    }\n  }\n\n  disconnectedCallback(): void {\n    // dispose() stops the timer and bumps the generation so a callback already\n    // queued cannot fire onto a disconnected element (§3.5 / §4.4).\n    this._core.dispose();\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapTimer(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { Timer } from \"./components/Timer.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.timer)) {\n    customElements.define(config.tagNames.timer, Timer);\n  }\n}\n"],"names":["_config","autoTrigger","triggerAttribute","tagNames","timer","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","TimerCore","EventTarget","static","protocol","version","properties","name","event","getter","e","detail","count","elapsed","commands","_target","_timerId","_gen","_runGen","_ready","Promise","resolve","_tick","_running","_paused","_runStartTick","_interval","_repeat","_accumulatedElapsed","_segmentStart","constructor","target","super","this","tick","_currentElapsed","running","ready","observe","dispose","stop","_dispatchTick","dispatchEvent","CustomEvent","bubbles","_setRunning","start","options","interval","Number","isFinite","repeat","immediate","Date","now","_fire","setInterval","changeInterval","_clearTimer","_foldElapsed","reset","pause","resume","remainder","setTimeout","_onResumeBoundary","clearTimeout","clearInterval","registered","handleClick","Element","triggerElement","closest","timerId","getAttribute","TimerCtor","customElements","get","timerElement","document","getElementById","preventDefault","Timer","HTMLElement","wcBindable","inputs","attribute","observedAttributes","_core","_trigger","_connectedCallbackPromise","_internals","_initInternals","_wireStates","d","debugStates","states","attachInternals","internals","add","delete","map","toStates","entries","addEventListener","debug","hasAttribute","on","toggleAttribute","connectedCallbackPromise","attr","trim","parsed","value","setAttribute","String","once","removeAttribute","manual","trigger","attributeChangedCallback","oldValue","newValue","isConnected","connectedCallback","style","display","disconnectedCallback","bootstrapTimer","userConfig","partialConfig","assign","define"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/timer",
-  "version": "1.15.0",
+  "version": "1.17.0",
   "description": "Declarative timer component for Web Components. Framework-agnostic interval/timeout primitive via wc-bindable-protocol.",
   "type": "module",
   "main": "./dist/index.esm.js",