@wcstack/timer 4.0.0-rc.8 → 4.0.0-rc.9

package/README.ja.md

@@ -100,6 +100,8 @@ npm install @wcstack/timer
 | `immediate` | boolean | `false` | 最初の tick を開始時点で発火（1インターバル待たない）。         |
 | `manual`    | boolean | `false` | 接続時に自動開始しない。コマンド / trigger で開始します。       |
 
+**`null` と `undefined`。** 属性に対応する入力（`interval`・`once`・`repeat`・`immediate`・`manual`）は、`null` を「クリア」として扱います。属性を外し、入力は既定値に戻ります。`undefined` は「値が無い」で、属性を最初の書き込みの前の状態 — マークアップに書かれた値、無ければ属性なし — に戻します。どちらも文字列 `"null"` / `"undefined"` として書くことはありません（`@wcstack/state` は `undefined` を書きませんが、React 19 は値のあった prop を外したときに書き、直接の代入でも届きます）。動作中のタイマーは、ほかの `interval` 変更と同じく、戻った値または既定値の周期にその場で張り直します。`trigger` はどちらも無視します。
+
 ## 観測プロパティ（出力）
 
 | プロパティ | イベント                    | 説明                                                          |

package/README.md

@@ -107,6 +107,8 @@ When `<wcs-timer>` is connected to the DOM, it automatically starts an interval
 | `immediate` | boolean | `false` | Fire one tick at start instead of waiting the first interval.      |
 | `manual`    | boolean | `false` | Do not auto-start on connect; start via command / trigger.        |
 
+**`null` and `undefined`.** The inputs backed by an attribute (`interval`, `once`, `repeat`, `immediate`, `manual`) take `null` as "clear": the attribute is removed and the input falls back to its default. `undefined` means "no value supplied": the attribute goes back to what it was before the first write — the value written in the markup, or none. Neither is ever written as the string `"null"` / `"undefined"`. (`@wcstack/state` never writes `undefined`; React 19 does when a prop that had a value is removed, and so can a direct assignment.) A running timer swaps to the restored or default `interval` in place, like any other `interval` change; `trigger` ignores both.
+
 ## Observable Properties (outputs)
 
 | Property  | Event                       | Description                                            |

package/dist/auto.min.js

@@ -1,2 +1,2 @@
-const t={triggerAttribute:"data-timertarget",tagNames:{timer:"wcs-timer"}};class e extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"tick",event:"wcs-timer:tick",semantics:"state",getter:t=>t.detail.count},{name:"elapsed",event:"wcs-timer:tick",semantics:"state",getter:t=>t.detail.elapsed},{name:"running",event:"wcs-timer:running-changed",semantics:"state"}],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 i=!1;function s(e){const i=e.target;if(!(i instanceof Element))return;const s=i.closest(`[${t.triggerAttribute}]`);if(!s)return;const n=s.getAttribute(t.triggerAttribute);if(!n)return;const r=customElements.get(t.tagNames.timer),a=document.getElementById(n);r&&a instanceof r&&(e.preventDefault(),a.start())}function n(t,e){let i=Object.getPrototypeOf(t);for(;null!==i;){const t=Object.getOwnPropertyDescriptor(i,e);if(void 0!==t)return"function"==typeof t.get||"function"==typeof t.set;i=Object.getPrototypeOf(i)}return!1}class r extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...e.wcBindable,properties:[...e.wcBindable.properties,{name:"trigger",event:"wcs-timer:trigger-changed",semantics:"state"}],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 e(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,s]of Object.entries(t))this.addEventListener(i,t=>{const i=this.hasAttribute("debug-states");for(const[n,r]of Object.entries(s(t.detail))){try{r?e.add(n):e.delete(n)}catch{}i&&this.toggleAttribute(`data-wcs-state-${n}`,r)}})}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(){!function(t){const e=t.constructor?.wcBindable,i=e?.inputs;if(void 0!==i)for(const e of i){const i=e.name;if(!Object.prototype.hasOwnProperty.call(t,i))continue;if(!n(t,i))continue;const s=t,r=s[i];delete s[i],s[i]=r}}(this),this.style.display="none",i||(i=!0,document.addEventListener("click",s)),this._connectedCallbackPromise=this._core.observe(),this.manual||this.start()}disconnectedCallback(){this._core.dispose()}}var a;!function(e=customElements){e.get(t.tagNames.timer)||e.define(t.tagNames.timer,r)}(a);
+const t={triggerAttribute:"data-timertarget",tagNames:{timer:"wcs-timer"}};class e extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"tick",event:"wcs-timer:tick",semantics:"state",getter:t=>t.detail.count},{name:"elapsed",event:"wcs-timer:tick",semantics:"state",getter:t=>t.detail.elapsed},{name:"running",event:"wcs-timer:running-changed",semantics:"state"}],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 i=!1;function n(e){const i=e.target;if(!(i instanceof Element))return;const n=i.closest(`[${t.triggerAttribute}]`);if(!n)return;const s=n.getAttribute(t.triggerAttribute);if(!s)return;const r=customElements.get(t.tagNames.timer),a=document.getElementById(s);r&&a instanceof r&&(e.preventDefault(),a.start())}function s(t,e){let i=Object.getPrototypeOf(t);for(;null!==i;){const t=Object.getOwnPropertyDescriptor(i,e);if(void 0!==t)return"function"==typeof t.get||"function"==typeof t.set;i=Object.getPrototypeOf(i)}return!1}const r=new WeakMap;function a(t,e){let i=r.get(t);return void 0===i&&(i=new Map,r.set(t,i)),i.has(e)||i.set(e,t.getAttribute(e)),i.get(e)}function c(t,e,i){null===i?t.removeAttribute(e):t.setAttribute(e,i)}function u(t,e,i){const n=a(t,e);c(t,e,void 0===i?n:null===i?null:String(i))}function l(t,e,i){const n=a(t,e);c(t,e,void 0===i?n:i?"":null)}class h extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...e.wcBindable,properties:[...e.wcBindable.properties,{name:"trigger",event:"wcs-timer:trigger-changed",semantics:"state"}],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 e(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,n]of Object.entries(t))this.addEventListener(i,t=>{const i=this.hasAttribute("debug-states");for(const[s,r]of Object.entries(n(t.detail))){try{r?e.add(s):e.delete(s)}catch{}i&&this.toggleAttribute(`data-wcs-state-${s}`,r)}})}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){u(this,"interval",t)}get once(){return this.hasAttribute("once")}set once(t){l(this,"once",t)}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){u(this,"repeat",t)}get immediate(){return this.hasAttribute("immediate")}set immediate(t){l(this,"immediate",t)}get manual(){return this.hasAttribute("manual")}set manual(t){l(this,"manual",t)}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(){!function(t){const e=t.constructor?.wcBindable,i=e?.inputs;if(void 0!==i)for(const e of i){const i=e.name;if(!Object.prototype.hasOwnProperty.call(t,i))continue;if(!s(t,i))continue;const n=t,r=n[i];delete n[i],n[i]=r}}(this),this.style.display="none",i||(i=!0,document.addEventListener("click",n)),this._connectedCallbackPromise=this._core.observe(),this.manual||this.start()}disconnectedCallback(){this._core.dispose()}}var o;!function(e=customElements){e.get(t.tagNames.timer)||e.define(t.tagNames.timer,h)}(o);
 //# sourceMappingURL=auto.min.js.map

package/dist/auto.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto.min.js","sources":["../src/config.ts","../src/core/TimerCore.ts","../src/autoTrigger.ts","../src/protocol/upgradeProperties.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\n/** A misspelt option would otherwise do nothing: `bootstrapTimer` refuses it. */\nfunction invalid(key: string): never {\n  throw new Error(`[@wcstack/timer] bootstrapTimer: \"${key}\" is not one of its options, or not of the option's type.`);\n}\n\n/**\n * Applies the options given; an undefined value is left out. An option this package does not\n * have, a value of another type than its default (null, or an array for an object, included) or\n * a tag name it does not define throws, and then nothing is applied.\n */\nexport function setConfig(partialConfig: IWritableConfig): void {\n  const options = _config as unknown as Record<string, unknown>;\n  const tags = _config.tagNames as Record<string, string>;\n  const given = Object.entries(partialConfig).filter(([, value]) => value !== undefined);\n  const givenTags = Object.entries(partialConfig.tagNames ?? {}).filter(([, tag]) => tag !== undefined);\n  for (const [key, value] of given) {\n    const current = options[key];\n    if (!Object.hasOwn(options, key) || value === null || typeof value !== typeof current || Array.isArray(value) !== Array.isArray(current)) {\n      invalid(key);\n    }\n  }\n  for (const [name, tag] of givenTags) {\n    if (!Object.hasOwn(tags, name) || typeof tag !== \"string\") invalid(`tagNames.${name}`);\n  }\n  for (const [key, value] of given) {\n    if (key !== \"tagNames\") {\n      options[key] = value;\n    }\n  }\n  for (const [name, tag] of givenTags) tags[name] = tag as string;\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\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\", semantics: \"state\" },\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","// ===========================================================================\n// AUTO-GENERATED FILE - DO NOT EDIT.\n// Generated from /protocol/upgrade-properties.ts by scripts/sync-protocol-types.mjs.\n// Run `node scripts/sync-protocol-types.mjs` after editing the source.\n// ===========================================================================\n\n// custom element の property upgrade — `static wcBindable.inputs` に宣言した入力のうち、\n// 要素が upgrade される前に代入された own データプロパティを取り込み直す。\n//\n// なぜ必要か:\n//   未定義タグの要素は素の HTMLElement なので、`el.url = \"...\"` は own データプロパティを作る。\n//   upgrade 後にクラスの accessor が prototype へ入っても own プロパティが優先されるため、\n//   setter は二度と呼ばれず、値は要素へ届かないまま消える（エラーも警告も出ない）。\n//   常にプロパティ代入を行う framework（Angular の `[prop]`、Lit の `.prop=`、\n//   Solid の `prop:`、Vue の `.prop` 修飾子）× 遅延定義（autoloader / CDN / code-split）で\n//   常態的に起きる。docs/architecture-hardening/13-framework-adapter-binding-constraints.md §1.2。\n//\n// 安全側の判定:\n//   own プロパティがあっても、prototype チェーンに accessor が無ければ「シャドウ」ではなく\n//   その own プロパティ自体が正規の格納先なので触らない（public class field を壊さない）。\n//\n// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/upgrade-properties.ts), then run\n// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies\n// (packages/<pkg>/src/protocol/upgradeProperties.ts). Those copies are generated — do not edit them.\nimport { IWcBindable } from \"./wcBindable.js\";\n\nfunction hasAccessorOnPrototype(target: object, name: string): boolean {\n  let proto = Object.getPrototypeOf(target);\n  while (proto !== null) {\n    const descriptor = Object.getOwnPropertyDescriptor(proto, name);\n    if (descriptor !== undefined) {\n      return typeof descriptor.get === \"function\" || typeof descriptor.set === \"function\";\n    }\n    proto = Object.getPrototypeOf(proto);\n  }\n  return false;\n}\n\n/**\n * `connectedCallback` の先頭で呼ぶ。宣言済み input のうち upgrade 前の代入で\n * accessor をシャドウしている own プロパティを、delete → 再代入で setter に通し直す。\n *\n * - 冪等: 再代入は accessor を通るので own プロパティは残らず、2 回目以降は no-op。\n * - 宣言に `inputs` が無い要素、`wcBindable` を持たない要素では何もしない。\n * - 値の意味は変えない。今まで捨てられていた代入が届くようになる一方向の変化。\n */\nexport function upgradeProperties(element: object): void {\n  const declaration = (element as { constructor?: { wcBindable?: IWcBindable } }).constructor?.wcBindable;\n  const inputs = declaration?.inputs;\n  if (inputs === undefined) return;\n  for (const input of inputs) {\n    const name = input.name;\n    if (!Object.prototype.hasOwnProperty.call(element, name)) continue;\n    if (!hasAccessorOnPrototype(element, name)) continue;\n    const record = element as Record<string, unknown>;\n    const value = record[name];\n    delete record[name];\n    record[name] = value;\n  }\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\nimport { upgradeProperties } from \"../protocol/upgradeProperties.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\", semantics: \"state\" },\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    // upgrade 前に代入された input を取り込み直す（doc 13 §1.2 / Phase A1）\n    upgradeProperties(this);\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, registry?: CustomElementRegistry): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents(registry);\n}\n","import { Timer } from \"./components/Timer.js\";\nimport { config } from \"./config.js\";\n\n/**\n * Register this package's tags. Pass a scoped `CustomElementRegistry` to define\n * them for a single shadow tree -- scoped registries do not inherit the global\n * one, so a tree using one needs its own definitions.\n */\nexport function registerComponents(registry: CustomElementRegistry = customElements): void {\n  if (!registry.get(config.tagNames.timer)) {\n    registry.define(config.tagNames.timer, Timer);\n  }\n}\n"],"names":["config","triggerAttribute","tagNames","timer","TimerCore","EventTarget","static","protocol","version","properties","name","event","semantics","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","hasAccessorOnPrototype","proto","Object","getPrototypeOf","descriptor","getOwnPropertyDescriptor","undefined","set","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","element","declaration","input","prototype","hasOwnProperty","call","record","upgradeProperties","style","display","disconnectedCallback","registry","define","registerComponents"],"mappings":"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"}
+{"version":3,"file":"auto.min.js","sources":["../src/config.ts","../src/core/TimerCore.ts","../src/autoTrigger.ts","../src/protocol/upgradeProperties.ts","../src/protocol/inputAttribute.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\n/** A misspelt option would otherwise do nothing: `bootstrapTimer` refuses it. */\nfunction invalid(key: string): never {\n  throw new Error(`[@wcstack/timer] bootstrapTimer: \"${key}\" is not one of its options, or not of the option's type.`);\n}\n\n/**\n * Applies the options given; an undefined value is left out. An option this package does not\n * have, a value of another type than its default (null, or an array for an object, included) or\n * a tag name it does not define throws, and then nothing is applied.\n */\nexport function setConfig(partialConfig: IWritableConfig): void {\n  const options = _config as unknown as Record<string, unknown>;\n  const tags = _config.tagNames as Record<string, string>;\n  const given = Object.entries(partialConfig).filter(([, value]) => value !== undefined);\n  const givenTags = Object.entries(partialConfig.tagNames ?? {}).filter(([, tag]) => tag !== undefined);\n  for (const [key, value] of given) {\n    const current = options[key];\n    if (!Object.hasOwn(options, key) || value === null || typeof value !== typeof current || Array.isArray(value) !== Array.isArray(current)) {\n      invalid(key);\n    }\n  }\n  for (const [name, tag] of givenTags) {\n    if (!Object.hasOwn(tags, name) || typeof tag !== \"string\") invalid(`tagNames.${name}`);\n  }\n  for (const [key, value] of given) {\n    if (key !== \"tagNames\") {\n      options[key] = value;\n    }\n  }\n  for (const [name, tag] of givenTags) tags[name] = tag as string;\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\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\", semantics: \"state\" },\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","// ===========================================================================\n// AUTO-GENERATED FILE - DO NOT EDIT.\n// Generated from /protocol/upgrade-properties.ts by scripts/sync-protocol-types.mjs.\n// Run `node scripts/sync-protocol-types.mjs` after editing the source.\n// ===========================================================================\n\n// custom element の property upgrade — `static wcBindable.inputs` に宣言した入力のうち、\n// 要素が upgrade される前に代入された own データプロパティを取り込み直す。\n//\n// なぜ必要か:\n//   未定義タグの要素は素の HTMLElement なので、`el.url = \"...\"` は own データプロパティを作る。\n//   upgrade 後にクラスの accessor が prototype へ入っても own プロパティが優先されるため、\n//   setter は二度と呼ばれず、値は要素へ届かないまま消える（エラーも警告も出ない）。\n//   常にプロパティ代入を行う framework（Angular の `[prop]`、Lit の `.prop=`、\n//   Solid の `prop:`、Vue の `.prop` 修飾子）× 遅延定義（autoloader / CDN / code-split）で\n//   常態的に起きる。docs/architecture-hardening/13-framework-adapter-binding-constraints.md §1.2。\n//\n// 安全側の判定:\n//   own プロパティがあっても、prototype チェーンに accessor が無ければ「シャドウ」ではなく\n//   その own プロパティ自体が正規の格納先なので触らない（public class field を壊さない）。\n//\n// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/upgrade-properties.ts), then run\n// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies\n// (packages/<pkg>/src/protocol/upgradeProperties.ts). Those copies are generated — do not edit them.\nimport { IWcBindable } from \"./wcBindable.js\";\n\nfunction hasAccessorOnPrototype(target: object, name: string): boolean {\n  let proto = Object.getPrototypeOf(target);\n  while (proto !== null) {\n    const descriptor = Object.getOwnPropertyDescriptor(proto, name);\n    if (descriptor !== undefined) {\n      return typeof descriptor.get === \"function\" || typeof descriptor.set === \"function\";\n    }\n    proto = Object.getPrototypeOf(proto);\n  }\n  return false;\n}\n\n/**\n * `connectedCallback` の先頭で呼ぶ。宣言済み input のうち upgrade 前の代入で\n * accessor をシャドウしている own プロパティを、delete → 再代入で setter に通し直す。\n *\n * - 冪等: 再代入は accessor を通るので own プロパティは残らず、2 回目以降は no-op。\n * - 宣言に `inputs` が無い要素、`wcBindable` を持たない要素では何もしない。\n * - 値の意味は変えない。今まで捨てられていた代入が届くようになる一方向の変化。\n */\nexport function upgradeProperties(element: object): void {\n  const declaration = (element as { constructor?: { wcBindable?: IWcBindable } }).constructor?.wcBindable;\n  const inputs = declaration?.inputs;\n  if (inputs === undefined) return;\n  for (const input of inputs) {\n    const name = input.name;\n    if (!Object.prototype.hasOwnProperty.call(element, name)) continue;\n    if (!hasAccessorOnPrototype(element, name)) continue;\n    const record = element as Record<string, unknown>;\n    const value = record[name];\n    delete record[name];\n    record[name] = value;\n  }\n}\n","// ===========================================================================\n// AUTO-GENERATED FILE - DO NOT EDIT.\n// Generated from /protocol/input-attribute.ts by scripts/sync-protocol-types.mjs.\n// Run `node scripts/sync-protocol-types.mjs` after editing the source.\n// ===========================================================================\n\n// 属性へ反映する wc-bindable 入力の producer 側（SPEC-extensions § Producer guidance for inputs の P1〜P3）。\n// 入力の setter は属性をこの 2 関数で書く。それで次が揃う:\n//   - `undefined` は「値が無い」（P1）: 属性を、この関数で最初に書く前の状態 — マークアップに書かれた値、\n//     無ければ属性なし（= その入力の文書化した既定値）— へ戻す。applier プロファイルを宣言する binder は\n//     値の後の `undefined` を書き（A2）、React 19 も書き、直接の代入でも届く。\n//   - `null` はクリア（P2）: 属性なし、つまり文書化した既定値。\n//   - どちらも文字列 \"undefined\" / \"null\" として属性に入らない。\n//\n// 「最初に書く前」は、その最初の書き込みのときに読む（遅延）。upgrade 前に代入されたプロパティは\n// connectedCallback の upgradeProperties() が通し直すので、そのときにはパーサが書いた属性が揃っている。\n// 要素自身が setter を通さずに書いた属性は、最初の書き込みより前なら「最初の状態」に含まれる。\n//\n// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/input-attribute.ts), then run\n// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies\n// (packages/<pkg>/src/protocol/inputAttribute.ts). Those copies are generated — do not edit them.\n\nconst initialAttributes = new WeakMap<Element, Map<string, string | null>>();\n\n/** The attribute as it stood before the first write through these helpers. */\nfunction initialAttribute(el: Element, name: string): string | null {\n  let byName = initialAttributes.get(el);\n  if (byName === undefined) {\n    byName = new Map();\n    initialAttributes.set(el, byName);\n  }\n  if (!byName.has(name)) byName.set(name, el.getAttribute(name));\n  return byName.get(name) as string | null;\n}\n\nfunction writeAttribute(el: Element, name: string, value: string | null): void {\n  if (value === null) el.removeAttribute(name);\n  else el.setAttribute(name, value);\n}\n\n/**\n * A value attribute. `value` is written as `String(value)`; `null` removes the attribute;\n * `undefined` restores the attribute the element started with.\n */\nexport function reflectAttribute(el: Element, name: string, value: unknown): void {\n  const initial = initialAttribute(el, name);\n  writeAttribute(el, name, value === undefined ? initial : value === null ? null : String(value));\n}\n\n/**\n * A boolean attribute, present while `value` is truthy (`null` and `false` remove it);\n * `undefined` restores the attribute the element started with.\n */\nexport function reflectBooleanAttribute(el: Element, name: string, value: unknown): void {\n  const initial = initialAttribute(el, name);\n  writeAttribute(el, name, value === undefined ? initial : value ? \"\" : null);\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\nimport { upgradeProperties } from \"../protocol/upgradeProperties.js\";\nimport { reflectAttribute, reflectBooleanAttribute } from \"../protocol/inputAttribute.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\", semantics: \"state\" },\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  // Input setters never let setAttribute stringify null / undefined: `null`\n  // removes the attribute (the documented default), `undefined` restores the\n  // attribute the element started with (wc-bindable producer guidance P1;\n  // React 19 and a direct assignment deliver it, @wcstack/state does not).\n  // An `interval` write still goes through attributeChangedCallback, so a\n  // running timer swaps to the restored / default period in place.\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 | null | undefined) {\n    reflectAttribute(this, \"interval\", value);\n  }\n\n  get once(): boolean {\n    return this.hasAttribute(\"once\");\n  }\n\n  set once(value: boolean | null | undefined) {\n    reflectBooleanAttribute(this, \"once\", value);\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 | null | undefined) {\n    reflectAttribute(this, \"repeat\", value);\n  }\n\n  get immediate(): boolean {\n    return this.hasAttribute(\"immediate\");\n  }\n\n  set immediate(value: boolean | null | undefined) {\n    reflectBooleanAttribute(this, \"immediate\", value);\n  }\n\n  get manual(): boolean {\n    return this.hasAttribute(\"manual\");\n  }\n\n  set manual(value: boolean | null | undefined) {\n    reflectBooleanAttribute(this, \"manual\", value);\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    // upgrade 前に代入された input を取り込み直す（doc 13 §1.2 / Phase A1）\n    upgradeProperties(this);\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, registry?: CustomElementRegistry): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents(registry);\n}\n","import { Timer } from \"./components/Timer.js\";\nimport { config } from \"./config.js\";\n\n/**\n * Register this package's tags. Pass a scoped `CustomElementRegistry` to define\n * them for a single shadow tree -- scoped registries do not inherit the global\n * one, so a tree using one needs its own definitions.\n */\nexport function registerComponents(registry: CustomElementRegistry = customElements): void {\n  if (!registry.get(config.tagNames.timer)) {\n    registry.define(config.tagNames.timer, Timer);\n  }\n}\n"],"names":["config","triggerAttribute","tagNames","timer","TimerCore","EventTarget","static","protocol","version","properties","name","event","semantics","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","hasAccessorOnPrototype","proto","Object","getPrototypeOf","descriptor","getOwnPropertyDescriptor","undefined","set","initialAttributes","WeakMap","initialAttribute","el","byName","Map","has","writeAttribute","value","removeAttribute","setAttribute","reflectAttribute","initial","String","reflectBooleanAttribute","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","once","manual","trigger","attributeChangedCallback","oldValue","newValue","isConnected","connectedCallback","element","declaration","input","prototype","hasOwnProperty","call","record","upgradeProperties","style","display","disconnectedCallback","registry","define","registerComponents"],"mappings":"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"}

package/dist/index.d.ts

@@ -184,15 +184,15 @@ declare class Timer extends HTMLElement {
     private _wireStates;
     get connectedCallbackPromise(): Promise<void>;
     get interval(): number;
-    set interval(value: number);
+    set interval(value: number | null | undefined);
     get once(): boolean;
-    set once(value: boolean);
+    set once(value: boolean | null | undefined);
     get repeat(): number;
-    set repeat(value: number);
+    set repeat(value: number | null | undefined);
     get immediate(): boolean;
-    set immediate(value: boolean);
+    set immediate(value: boolean | null | undefined);
     get manual(): boolean;
-    set manual(value: boolean);
+    set manual(value: boolean | null | undefined);
     get tick(): number;
     get elapsed(): number;
     get running(): boolean;

package/dist/index.esm.js

@@ -431,6 +431,61 @@ function upgradeProperties(element) {
     }
 }
 
+// ===========================================================================
+// AUTO-GENERATED FILE - DO NOT EDIT.
+// Generated from /protocol/input-attribute.ts by scripts/sync-protocol-types.mjs.
+// Run `node scripts/sync-protocol-types.mjs` after editing the source.
+// ===========================================================================
+// 属性へ反映する wc-bindable 入力の producer 側（SPEC-extensions § Producer guidance for inputs の P1〜P3）。
+// 入力の setter は属性をこの 2 関数で書く。それで次が揃う:
+//   - `undefined` は「値が無い」（P1）: 属性を、この関数で最初に書く前の状態 — マークアップに書かれた値、
+//     無ければ属性なし（= その入力の文書化した既定値）— へ戻す。applier プロファイルを宣言する binder は
+//     値の後の `undefined` を書き（A2）、React 19 も書き、直接の代入でも届く。
+//   - `null` はクリア（P2）: 属性なし、つまり文書化した既定値。
+//   - どちらも文字列 "undefined" / "null" として属性に入らない。
+//
+// 「最初に書く前」は、その最初の書き込みのときに読む（遅延）。upgrade 前に代入されたプロパティは
+// connectedCallback の upgradeProperties() が通し直すので、そのときにはパーサが書いた属性が揃っている。
+// 要素自身が setter を通さずに書いた属性は、最初の書き込みより前なら「最初の状態」に含まれる。
+//
+// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/input-attribute.ts), then run
+// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies
+// (packages/<pkg>/src/protocol/inputAttribute.ts). Those copies are generated — do not edit them.
+const initialAttributes = new WeakMap();
+/** The attribute as it stood before the first write through these helpers. */
+function initialAttribute(el, name) {
+    let byName = initialAttributes.get(el);
+    if (byName === undefined) {
+        byName = new Map();
+        initialAttributes.set(el, byName);
+    }
+    if (!byName.has(name))
+        byName.set(name, el.getAttribute(name));
+    return byName.get(name);
+}
+function writeAttribute(el, name, value) {
+    if (value === null)
+        el.removeAttribute(name);
+    else
+        el.setAttribute(name, value);
+}
+/**
+ * A value attribute. `value` is written as `String(value)`; `null` removes the attribute;
+ * `undefined` restores the attribute the element started with.
+ */
+function reflectAttribute(el, name, value) {
+    const initial = initialAttribute(el, name);
+    writeAttribute(el, name, value === undefined ? initial : value === null ? null : String(value));
+}
+/**
+ * A boolean attribute, present while `value` is truthy (`null` and `false` remove it);
+ * `undefined` restores the attribute the element started with.
+ */
+function reflectBooleanAttribute(el, name, value) {
+    const initial = initialAttribute(el, name);
+    writeAttribute(el, name, value === undefined ? initial : value ? "" : null);
+}
+
 class Timer extends HTMLElement {
     static hasConnectedCallbackPromise = true;
     static wcBindable = {
@@ -523,6 +578,13 @@ class Timer extends HTMLElement {
         return this._connectedCallbackPromise;
     }
     // --- Attribute accessors ---
+    //
+    // Input setters never let setAttribute stringify null / undefined: `null`
+    // removes the attribute (the documented default), `undefined` restores the
+    // attribute the element started with (wc-bindable producer guidance P1;
+    // React 19 and a direct assignment deliver it, @wcstack/state does not).
+    // An `interval` write still goes through attributeChangedCallback, so a
+    // running timer swaps to the restored / default period in place.
     get interval() {
         const attr = this.getAttribute("interval");
         if (attr === null || attr.trim() === "")
@@ -536,18 +598,13 @@ class Timer extends HTMLElement {
         return (Number.isFinite(parsed) && parsed > 0) ? parsed : 1000;
     }
     set interval(value) {
-        this.setAttribute("interval", String(value));
+        reflectAttribute(this, "interval", value);
     }
     get once() {
         return this.hasAttribute("once");
     }
     set once(value) {
-        if (value) {
-            this.setAttribute("once", "");
-        }
-        else {
-            this.removeAttribute("once");
-        }
+        reflectBooleanAttribute(this, "once", value);
     }
     get repeat() {
         const attr = this.getAttribute("repeat");
@@ -562,29 +619,19 @@ class Timer extends HTMLElement {
         return (Number.isFinite(parsed) && parsed > 0) ? parsed : 0;
     }
     set repeat(value) {
-        this.setAttribute("repeat", String(value));
+        reflectAttribute(this, "repeat", value);
     }
     get immediate() {
         return this.hasAttribute("immediate");
     }
     set immediate(value) {
-        if (value) {
-            this.setAttribute("immediate", "");
-        }
-        else {
-            this.removeAttribute("immediate");
-        }
+        reflectBooleanAttribute(this, "immediate", value);
     }
     get manual() {
         return this.hasAttribute("manual");
     }
     set manual(value) {
-        if (value) {
-            this.setAttribute("manual", "");
-        }
-        else {
-            this.removeAttribute("manual");
-        }
+        reflectBooleanAttribute(this, "manual", value);
     }
     // --- Core delegated getters ---
     get tick() {

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/protocol/upgradeProperties.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\n/** A misspelt option would otherwise do nothing: `bootstrapTimer` refuses it. */\nfunction invalid(key: string): never {\n  throw new Error(`[@wcstack/timer] bootstrapTimer: \"${key}\" is not one of its options, or not of the option's type.`);\n}\n\n/**\n * Applies the options given; an undefined value is left out. An option this package does not\n * have, a value of another type than its default (null, or an array for an object, included) or\n * a tag name it does not define throws, and then nothing is applied.\n */\nexport function setConfig(partialConfig: IWritableConfig): void {\n  const options = _config as unknown as Record<string, unknown>;\n  const tags = _config.tagNames as Record<string, string>;\n  const given = Object.entries(partialConfig).filter(([, value]) => value !== undefined);\n  const givenTags = Object.entries(partialConfig.tagNames ?? {}).filter(([, tag]) => tag !== undefined);\n  for (const [key, value] of given) {\n    const current = options[key];\n    if (!Object.hasOwn(options, key) || value === null || typeof value !== typeof current || Array.isArray(value) !== Array.isArray(current)) {\n      invalid(key);\n    }\n  }\n  for (const [name, tag] of givenTags) {\n    if (!Object.hasOwn(tags, name) || typeof tag !== \"string\") invalid(`tagNames.${name}`);\n  }\n  for (const [key, value] of given) {\n    if (key !== \"tagNames\") {\n      options[key] = value;\n    }\n  }\n  for (const [name, tag] of givenTags) tags[name] = tag as string;\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\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\", semantics: \"state\" },\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","// ===========================================================================\n// AUTO-GENERATED FILE - DO NOT EDIT.\n// Generated from /protocol/upgrade-properties.ts by scripts/sync-protocol-types.mjs.\n// Run `node scripts/sync-protocol-types.mjs` after editing the source.\n// ===========================================================================\n\n// custom element の property upgrade — `static wcBindable.inputs` に宣言した入力のうち、\n// 要素が upgrade される前に代入された own データプロパティを取り込み直す。\n//\n// なぜ必要か:\n//   未定義タグの要素は素の HTMLElement なので、`el.url = \"...\"` は own データプロパティを作る。\n//   upgrade 後にクラスの accessor が prototype へ入っても own プロパティが優先されるため、\n//   setter は二度と呼ばれず、値は要素へ届かないまま消える（エラーも警告も出ない）。\n//   常にプロパティ代入を行う framework（Angular の `[prop]`、Lit の `.prop=`、\n//   Solid の `prop:`、Vue の `.prop` 修飾子）× 遅延定義（autoloader / CDN / code-split）で\n//   常態的に起きる。docs/architecture-hardening/13-framework-adapter-binding-constraints.md §1.2。\n//\n// 安全側の判定:\n//   own プロパティがあっても、prototype チェーンに accessor が無ければ「シャドウ」ではなく\n//   その own プロパティ自体が正規の格納先なので触らない（public class field を壊さない）。\n//\n// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/upgrade-properties.ts), then run\n// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies\n// (packages/<pkg>/src/protocol/upgradeProperties.ts). Those copies are generated — do not edit them.\nimport { IWcBindable } from \"./wcBindable.js\";\n\nfunction hasAccessorOnPrototype(target: object, name: string): boolean {\n  let proto = Object.getPrototypeOf(target);\n  while (proto !== null) {\n    const descriptor = Object.getOwnPropertyDescriptor(proto, name);\n    if (descriptor !== undefined) {\n      return typeof descriptor.get === \"function\" || typeof descriptor.set === \"function\";\n    }\n    proto = Object.getPrototypeOf(proto);\n  }\n  return false;\n}\n\n/**\n * `connectedCallback` の先頭で呼ぶ。宣言済み input のうち upgrade 前の代入で\n * accessor をシャドウしている own プロパティを、delete → 再代入で setter に通し直す。\n *\n * - 冪等: 再代入は accessor を通るので own プロパティは残らず、2 回目以降は no-op。\n * - 宣言に `inputs` が無い要素、`wcBindable` を持たない要素では何もしない。\n * - 値の意味は変えない。今まで捨てられていた代入が届くようになる一方向の変化。\n */\nexport function upgradeProperties(element: object): void {\n  const declaration = (element as { constructor?: { wcBindable?: IWcBindable } }).constructor?.wcBindable;\n  const inputs = declaration?.inputs;\n  if (inputs === undefined) return;\n  for (const input of inputs) {\n    const name = input.name;\n    if (!Object.prototype.hasOwnProperty.call(element, name)) continue;\n    if (!hasAccessorOnPrototype(element, name)) continue;\n    const record = element as Record<string, unknown>;\n    const value = record[name];\n    delete record[name];\n    record[name] = value;\n  }\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\nimport { upgradeProperties } from \"../protocol/upgradeProperties.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\", semantics: \"state\" },\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    // upgrade 前に代入された input を取り込み直す（doc 13 §1.2 / Phase A1）\n    upgradeProperties(this);\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\n/**\n * Register this package's tags. Pass a scoped `CustomElementRegistry` to define\n * them for a single shadow tree -- scoped registries do not inherit the global\n * one, so a tree using one needs its own definitions.\n */\nexport function registerComponents(registry: CustomElementRegistry = customElements): void {\n  if (!registry.get(config.tagNames.timer)) {\n    registry.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, registry?: CustomElementRegistry): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents(registry);\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/protocol/upgradeProperties.ts","../src/protocol/inputAttribute.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\n/** A misspelt option would otherwise do nothing: `bootstrapTimer` refuses it. */\nfunction invalid(key: string): never {\n  throw new Error(`[@wcstack/timer] bootstrapTimer: \"${key}\" is not one of its options, or not of the option's type.`);\n}\n\n/**\n * Applies the options given; an undefined value is left out. An option this package does not\n * have, a value of another type than its default (null, or an array for an object, included) or\n * a tag name it does not define throws, and then nothing is applied.\n */\nexport function setConfig(partialConfig: IWritableConfig): void {\n  const options = _config as unknown as Record<string, unknown>;\n  const tags = _config.tagNames as Record<string, string>;\n  const given = Object.entries(partialConfig).filter(([, value]) => value !== undefined);\n  const givenTags = Object.entries(partialConfig.tagNames ?? {}).filter(([, tag]) => tag !== undefined);\n  for (const [key, value] of given) {\n    const current = options[key];\n    if (!Object.hasOwn(options, key) || value === null || typeof value !== typeof current || Array.isArray(value) !== Array.isArray(current)) {\n      invalid(key);\n    }\n  }\n  for (const [name, tag] of givenTags) {\n    if (!Object.hasOwn(tags, name) || typeof tag !== \"string\") invalid(`tagNames.${name}`);\n  }\n  for (const [key, value] of given) {\n    if (key !== \"tagNames\") {\n      options[key] = value;\n    }\n  }\n  for (const [name, tag] of givenTags) tags[name] = tag as string;\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\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.count },\n      { name: \"elapsed\", event: \"wcs-timer:tick\", semantics: \"state\", getter: (e: Event) => (e as CustomEvent).detail.elapsed },\n      { name: \"running\", event: \"wcs-timer:running-changed\", semantics: \"state\" },\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","// ===========================================================================\n// AUTO-GENERATED FILE - DO NOT EDIT.\n// Generated from /protocol/upgrade-properties.ts by scripts/sync-protocol-types.mjs.\n// Run `node scripts/sync-protocol-types.mjs` after editing the source.\n// ===========================================================================\n\n// custom element の property upgrade — `static wcBindable.inputs` に宣言した入力のうち、\n// 要素が upgrade される前に代入された own データプロパティを取り込み直す。\n//\n// なぜ必要か:\n//   未定義タグの要素は素の HTMLElement なので、`el.url = \"...\"` は own データプロパティを作る。\n//   upgrade 後にクラスの accessor が prototype へ入っても own プロパティが優先されるため、\n//   setter は二度と呼ばれず、値は要素へ届かないまま消える（エラーも警告も出ない）。\n//   常にプロパティ代入を行う framework（Angular の `[prop]`、Lit の `.prop=`、\n//   Solid の `prop:`、Vue の `.prop` 修飾子）× 遅延定義（autoloader / CDN / code-split）で\n//   常態的に起きる。docs/architecture-hardening/13-framework-adapter-binding-constraints.md §1.2。\n//\n// 安全側の判定:\n//   own プロパティがあっても、prototype チェーンに accessor が無ければ「シャドウ」ではなく\n//   その own プロパティ自体が正規の格納先なので触らない（public class field を壊さない）。\n//\n// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/upgrade-properties.ts), then run\n// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies\n// (packages/<pkg>/src/protocol/upgradeProperties.ts). Those copies are generated — do not edit them.\nimport { IWcBindable } from \"./wcBindable.js\";\n\nfunction hasAccessorOnPrototype(target: object, name: string): boolean {\n  let proto = Object.getPrototypeOf(target);\n  while (proto !== null) {\n    const descriptor = Object.getOwnPropertyDescriptor(proto, name);\n    if (descriptor !== undefined) {\n      return typeof descriptor.get === \"function\" || typeof descriptor.set === \"function\";\n    }\n    proto = Object.getPrototypeOf(proto);\n  }\n  return false;\n}\n\n/**\n * `connectedCallback` の先頭で呼ぶ。宣言済み input のうち upgrade 前の代入で\n * accessor をシャドウしている own プロパティを、delete → 再代入で setter に通し直す。\n *\n * - 冪等: 再代入は accessor を通るので own プロパティは残らず、2 回目以降は no-op。\n * - 宣言に `inputs` が無い要素、`wcBindable` を持たない要素では何もしない。\n * - 値の意味は変えない。今まで捨てられていた代入が届くようになる一方向の変化。\n */\nexport function upgradeProperties(element: object): void {\n  const declaration = (element as { constructor?: { wcBindable?: IWcBindable } }).constructor?.wcBindable;\n  const inputs = declaration?.inputs;\n  if (inputs === undefined) return;\n  for (const input of inputs) {\n    const name = input.name;\n    if (!Object.prototype.hasOwnProperty.call(element, name)) continue;\n    if (!hasAccessorOnPrototype(element, name)) continue;\n    const record = element as Record<string, unknown>;\n    const value = record[name];\n    delete record[name];\n    record[name] = value;\n  }\n}\n","// ===========================================================================\n// AUTO-GENERATED FILE - DO NOT EDIT.\n// Generated from /protocol/input-attribute.ts by scripts/sync-protocol-types.mjs.\n// Run `node scripts/sync-protocol-types.mjs` after editing the source.\n// ===========================================================================\n\n// 属性へ反映する wc-bindable 入力の producer 側（SPEC-extensions § Producer guidance for inputs の P1〜P3）。\n// 入力の setter は属性をこの 2 関数で書く。それで次が揃う:\n//   - `undefined` は「値が無い」（P1）: 属性を、この関数で最初に書く前の状態 — マークアップに書かれた値、\n//     無ければ属性なし（= その入力の文書化した既定値）— へ戻す。applier プロファイルを宣言する binder は\n//     値の後の `undefined` を書き（A2）、React 19 も書き、直接の代入でも届く。\n//   - `null` はクリア（P2）: 属性なし、つまり文書化した既定値。\n//   - どちらも文字列 \"undefined\" / \"null\" として属性に入らない。\n//\n// 「最初に書く前」は、その最初の書き込みのときに読む（遅延）。upgrade 前に代入されたプロパティは\n// connectedCallback の upgradeProperties() が通し直すので、そのときにはパーサが書いた属性が揃っている。\n// 要素自身が setter を通さずに書いた属性は、最初の書き込みより前なら「最初の状態」に含まれる。\n//\n// SINGLE SOURCE OF TRUTH: edit only this file (/protocol/input-attribute.ts), then run\n// `node scripts/sync-protocol-types.mjs` to regenerate the per-package copies\n// (packages/<pkg>/src/protocol/inputAttribute.ts). Those copies are generated — do not edit them.\n\nconst initialAttributes = new WeakMap<Element, Map<string, string | null>>();\n\n/** The attribute as it stood before the first write through these helpers. */\nfunction initialAttribute(el: Element, name: string): string | null {\n  let byName = initialAttributes.get(el);\n  if (byName === undefined) {\n    byName = new Map();\n    initialAttributes.set(el, byName);\n  }\n  if (!byName.has(name)) byName.set(name, el.getAttribute(name));\n  return byName.get(name) as string | null;\n}\n\nfunction writeAttribute(el: Element, name: string, value: string | null): void {\n  if (value === null) el.removeAttribute(name);\n  else el.setAttribute(name, value);\n}\n\n/**\n * A value attribute. `value` is written as `String(value)`; `null` removes the attribute;\n * `undefined` restores the attribute the element started with.\n */\nexport function reflectAttribute(el: Element, name: string, value: unknown): void {\n  const initial = initialAttribute(el, name);\n  writeAttribute(el, name, value === undefined ? initial : value === null ? null : String(value));\n}\n\n/**\n * A boolean attribute, present while `value` is truthy (`null` and `false` remove it);\n * `undefined` restores the attribute the element started with.\n */\nexport function reflectBooleanAttribute(el: Element, name: string, value: unknown): void {\n  const initial = initialAttribute(el, name);\n  writeAttribute(el, name, value === undefined ? initial : value ? \"\" : null);\n}\n","import { config } from \"../config.js\";\nimport { IWcBindable } from \"../types.js\";\nimport { TimerCore } from \"../core/TimerCore.js\";\nimport { registerAutoTrigger } from \"../autoTrigger.js\";\nimport { upgradeProperties } from \"../protocol/upgradeProperties.js\";\nimport { reflectAttribute, reflectBooleanAttribute } from \"../protocol/inputAttribute.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\", semantics: \"state\" },\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  // Input setters never let setAttribute stringify null / undefined: `null`\n  // removes the attribute (the documented default), `undefined` restores the\n  // attribute the element started with (wc-bindable producer guidance P1;\n  // React 19 and a direct assignment deliver it, @wcstack/state does not).\n  // An `interval` write still goes through attributeChangedCallback, so a\n  // running timer swaps to the restored / default period in place.\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 | null | undefined) {\n    reflectAttribute(this, \"interval\", value);\n  }\n\n  get once(): boolean {\n    return this.hasAttribute(\"once\");\n  }\n\n  set once(value: boolean | null | undefined) {\n    reflectBooleanAttribute(this, \"once\", value);\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 | null | undefined) {\n    reflectAttribute(this, \"repeat\", value);\n  }\n\n  get immediate(): boolean {\n    return this.hasAttribute(\"immediate\");\n  }\n\n  set immediate(value: boolean | null | undefined) {\n    reflectBooleanAttribute(this, \"immediate\", value);\n  }\n\n  get manual(): boolean {\n    return this.hasAttribute(\"manual\");\n  }\n\n  set manual(value: boolean | null | undefined) {\n    reflectBooleanAttribute(this, \"manual\", value);\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    // upgrade 前に代入された input を取り込み直す（doc 13 §1.2 / Phase A1）\n    upgradeProperties(this);\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\n/**\n * Register this package's tags. Pass a scoped `CustomElementRegistry` to define\n * them for a single shadow tree -- scoped registries do not inherit the global\n * one, so a tree using one needs its own definitions.\n */\nexport function registerComponents(registry: CustomElementRegistry = customElements): void {\n  if (!registry.get(config.tagNames.timer)) {\n    registry.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, registry?: CustomElementRegistry): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents(registry);\n}\n"],"names":[],"mappings":"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"}

package/package.json

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