@wcstack/idle 1.16.0

package/README.ja.md

@@ -0,0 +1,115 @@
+# @wcstack/idle
+
+`@wcstack/idle` は wcstack エコシステム向けのヘッドレスな Idle Detection コンポーネントです。
+
+視覚的な UI ウィジェットではありません。`IdleDetector`のlive なユーザー/画面状態をリアクティブな state に変える**非同期プリミティブノード**で、明示的でgesture駆動な権限コマンドの後段に位置します。
+
+`@wcstack/state` と組み合わせると、`<wcs-idle>` はパス契約で直接バインドできます:
+
+- **入力サーフェス**: `threshold`（ms、最小60000）
+- **出力 state サーフェス**: `userState`、`screenState`、`active`、`error`
+
+## なぜ存在するか — gesture-gated permission パターンの参照実装
+
+`IdleDetector.requestPermission()`は**静的メソッド**で、実際のuser gesture内から呼ぶ必要があります。`connectedCallback`はこの文脈の外なので、**本ノードはconnect時に自動startしません** — 呼び出し元が`requestPermission()` → `start()`を明示的に、典型的にはクリックハンドラから駆動します。
+
+> **`@wcstack/permission`との合成を推奨。** `navigator.permissions.query({name:"idle-detection"})`が既に存在するため、`<wcs-idle>`は`<wcs-permission name="idle-detection">`と併置して`granted`/`denied`/`prompt`状態を得てください。`<wcs-idle>`自身は実際のアイドル状態と一回限りの`requestPermission()`アクションだけを公開し、4値permission状態は重複実装しません。
+
+> **Chromium限定。** Firefox と Safari は`IdleDetector`を実装していません。
+
+## インストール
+
+```bash
+npm install @wcstack/idle
+```
+
+## クイックスタート
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/permission/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/idle/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      // start()前は在席とみなす: `wcs-idle:change`はstart()前は発火しないため、
+      // ここを`false`にすると実際には在席なのに初回ロード時点で常に「離席中」が
+      // 表示されてしまう(在席が単に未検知なだけ)。
+      presenceActive: true,
+      idleGranted: false,
+      async enableIdleDetection() {
+        const el = document.querySelector("wcs-idle");
+        const result = await el.requestPermission();
+        if (result === "granted") await el.start();
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-permission name="idle-detection" data-wcs="granted: idleGranted"></wcs-permission>
+<wcs-idle threshold="60000" data-wcs="active: presenceActive"></wcs-idle>
+
+<!-- 注意: ここに `disabled: idleGranted` をバインドしてはいけません——permission の
+     許可はページロードを跨いで永続化されるため、再訪問時にボタンが最初から無効になり
+     start()（このクリックが唯一の到達経路）が二度と実行できなくなります。許可済みでの
+     再クリックは無害です: requestPermission() は即座に "granted" を返し start() に進みます。 -->
+<button data-wcs="onclick: enableIdleDetection">離席検知を有効にする</button>
+<p>許可状態: <span data-wcs="textContent: idleGranted"></span></p>
+<template data-wcs="if: presenceActive|not">
+  <span class="badge">離席中</span>
+</template>
+```
+
+## 観測可能プロパティ（出力）
+
+| プロパティ    | イベント          | 説明 |
+| ------------- | ------------------ | ---- |
+| `userState`   | `wcs-idle:change`  | `"active"` \| `"idle"`、`start()`前は`null`。 |
+| `screenState` | `wcs-idle:change`  | `"locked"` \| `"unlocked"`、`start()`前は`null`。 |
+| `active`      | `wcs-idle:change`  | `userState === "active"`のとき`true`。 |
+| `error`       | `wcs-idle:error`   | 直近の`requestPermission()`/`start()`の失敗、無ければ`null`。 |
+
+## コマンド
+
+| コマンド             | 非同期 | 説明 |
+| -------------------- | ------ | ---- |
+| `requestPermission`  | はい   | 静的でgesture-gatedな`IdleDetector.requestPermission()`をラップ。**実際のuser gestureハンドラ内から呼ぶ必要があります。** never-throw: rejectは`"denied"`に倒れます。 |
+| `start`              | はい   | アイドル検知セッションを開始（`threshold`はms、最小60000）。後続の`start()`/`stop()`で上書きされます。 |
+| `stop`               | いいえ | 現在のセッションを停止。未開始でも安全に呼べます。 |
+
+## 属性 / 入力
+
+| 属性        | 型     | 既定値  | 説明 |
+| ----------- | ------ | ------- | ---- |
+| `threshold` | number | `60000` | `userState`が`"idle"`になるまでの最小アイドル時間（ms）。バリデーションなし——範囲外の値はブラウザ自身のrejectに委ねます。 |
+
+## 注意・制限
+
+- **connect時に自動startしません。** 上記「なぜ存在するか」を参照。
+- **permission状態を重複実装しません。** `<wcs-permission name="idle-detection">`と合成してください。
+- **Chromium限定、かつ secure context 限定です。** Firefox と Safari は`IdleDetector`自体を実装していません。Chromiumであっても`IdleDetector`は`[SecureContext]`専用インターフェースのため、平文の`http://`（`localhost`を除く）では`window.IdleDetector`自体が`undefined`になり——非対応ブラウザと同じ`unsupported`（`error`経由）の分岐に落ちます。
+- **Permissions-Policyでゲートされます。** アイドル検知は`idle-detection`のPermissions-Policyディレクティブ（既定allowlist: `self`）に支配されます。クロスオリジンの`<iframe>`内で`<wcs-idle>`を使うには、その`<iframe>`要素に`allow="idle-detection"`が必要です——無いと`requestPermission()`/`start()`は非対応ブラウザと同様に失敗します。
+- **`stop()`/切断では`userState`/`screenState`/`active`をリセットしません。** 次に`start()`が成功するまで直近の観測値を保持します——Generic Sensor族（`<wcs-gyroscope>`等）と同じ「直近の読み取り値を保持する」挙動です。
+
+## ヘッドレス利用（`IdleCore`）
+
+```typescript
+import { IdleCore } from "@wcstack/idle";
+
+const core = new IdleCore();
+core.addEventListener("wcs-idle:change", (e) => {
+  console.log((e as CustomEvent).detail); // { userState, screenState }
+});
+
+// 実際のuser gestureハンドラ内から:
+const result = await core.requestPermission();
+if (result === "granted") await core.start(60000);
+
+// 後始末:
+core.dispose();
+```
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,117 @@
+# @wcstack/idle
+
+`@wcstack/idle` is a headless Idle Detection component for the wcstack ecosystem.
+
+It is not a visual UI widget.
+It is an **async primitive node** that turns `IdleDetector`'s live user/screen state into reactive state, gated behind an explicit, gesture-driven permission command.
+
+With `@wcstack/state`, `<wcs-idle>` can be bound directly through path contracts:
+
+- **input surface**: `threshold` (ms, minimum 60000)
+- **output state surface**: `userState`, `screenState`, `active`, `error`
+
+## Why this exists — the reference implementation for gesture-gated permission
+
+`IdleDetector.requestPermission()` is a **static method** that must be called from within a real user gesture. `connectedCallback` runs outside that context, so **this node never auto-starts on connect** — the caller drives `requestPermission()` → `start()` explicitly, typically from a click handler.
+
+> **Compose with `@wcstack/permission`.** `navigator.permissions.query({name:"idle-detection"})` already exists — pair `<wcs-idle>` with `<wcs-permission name="idle-detection">` for `granted`/`denied`/`prompt` status. `<wcs-idle>` itself only exposes the actual idle state plus the one-time `requestPermission()` action; it does not duplicate the 4-value permission state.
+
+> **Chromium-only.** Firefox and Safari do not implement `IdleDetector`.
+
+## Install
+
+```bash
+npm install @wcstack/idle
+```
+
+## Quick Start
+
+```html
+<script type="module" src="https://esm.run/@wcstack/state/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/permission/auto"></script>
+<script type="module" src="https://esm.run/@wcstack/idle/auto"></script>
+
+<wcs-state>
+  <script type="module">
+    export default {
+      // Assume present until told otherwise: `wcs-idle:change` never fires
+      // before start(), so a `false` default here would show "Away" on
+      // every initial load even though presence is simply unknown yet.
+      presenceActive: true,
+      idleGranted: false,
+      async enableIdleDetection() {
+        const el = document.querySelector("wcs-idle");
+        const result = await el.requestPermission();
+        if (result === "granted") await el.start();
+      },
+    };
+  </script>
+</wcs-state>
+
+<wcs-permission name="idle-detection" data-wcs="granted: idleGranted"></wcs-permission>
+<wcs-idle threshold="60000" data-wcs="active: presenceActive"></wcs-idle>
+
+<!-- Note: don't bind `disabled: idleGranted` here — the grant persists across
+     page loads, so on a revisit the button would start out disabled and start()
+     (only reachable through this click) could never run. Re-clicking when
+     already granted is harmless: requestPermission() resolves "granted"
+     immediately and start() proceeds. -->
+<button data-wcs="onclick: enableIdleDetection">Enable presence detection</button>
+<p>Permission granted: <span data-wcs="textContent: idleGranted"></span></p>
+<template data-wcs="if: presenceActive|not">
+  <span class="badge">Away</span>
+</template>
+```
+
+## Observable Properties (outputs)
+
+| Property      | Event            | Description |
+| ------------- | ----------------- | ------------ |
+| `userState`   | `wcs-idle:change`  | `"active"` \| `"idle"`, or `null` before `start()`. |
+| `screenState` | `wcs-idle:change`  | `"locked"` \| `"unlocked"`, or `null` before `start()`. |
+| `active`      | `wcs-idle:change`  | `true` when `userState === "active"`. |
+| `error`       | `wcs-idle:error`   | The last `requestPermission()`/`start()` failure, or `null`. |
+
+## Commands
+
+| Command            | Async | Description |
+| ------------------- | ----- | ------------ |
+| `requestPermission` | yes   | Wraps the static, gesture-gated `IdleDetector.requestPermission()`. **Must be called from within a real user gesture handler.** Never-throw: a rejection resolves to `"denied"`. |
+| `start`             | yes   | Begin an idle-detection session (`threshold` in ms, minimum 60000). Superseded by a later `start()`/`stop()`. |
+| `stop`              | no    | Stop the current session. Safe to call when not started. |
+
+## Attributes / Inputs
+
+| Attribute   | Type   | Default | Description |
+| ----------- | ------ | ------- | ------------ |
+| `threshold` | number | `60000` | Minimum idle time (ms) before `userState` becomes `"idle"`. Not validated — an out-of-range value is left to the browser's own rejection. |
+
+## Notes & limitations
+
+- **Does not auto-start on connect.** See "Why this exists" above.
+- **Does not duplicate permission state.** Compose with `<wcs-permission name="idle-detection">`.
+- **Chromium-only, and secure-context-only.** Firefox and Safari do not implement `IdleDetector` at all. Even in Chromium, `IdleDetector` is a `[SecureContext]`-only interface, so over plain `http://` (other than `localhost`) `window.IdleDetector` itself is `undefined` — same as an unsupported browser, this falls into the `unsupported` (via `error`) path.
+- **Permissions-Policy gate.** Idle detection is governed by the `idle-detection` Permissions-Policy directive (default allowlist: `self`). Using `<wcs-idle>` inside a cross-origin `<iframe>` requires `allow="idle-detection"` on that `<iframe>` element — otherwise `requestPermission()`/`start()` fail the same way as an unsupported browser.
+- **`stop()`/disconnect does not reset `userState`/`screenState`/`active`.** They keep their last observed value until the next successful `start()` — the same "retain the last reading" behavior as the Generic Sensor family (`<wcs-gyroscope>` et al.).
+
+## Headless usage (`IdleCore`)
+
+```typescript
+import { IdleCore } from "@wcstack/idle";
+
+const core = new IdleCore();
+core.addEventListener("wcs-idle:change", (e) => {
+  console.log((e as CustomEvent).detail); // { userState, screenState }
+});
+
+// from within a real user gesture handler:
+const result = await core.requestPermission();
+if (result === "granted") await core.start(60000);
+
+// later:
+core.dispose();
+```
+
+## License
+
+MIT

package/dist/auto.js

@@ -0,0 +1,3 @@
+import { bootstrapIdle } from "./index.esm.js";
+
+bootstrapIdle();

package/dist/auto.min.js

@@ -0,0 +1 @@
+import{bootstrapIdle}from"./index.esm.min.js";bootstrapIdle();

package/dist/index.d.ts

@@ -0,0 +1,158 @@
+interface IWcBindableProperty {
+    readonly name: string;
+    readonly event: string;
+    readonly getter?: (event: Event) => any;
+}
+interface IWcBindableInput {
+    readonly name: string;
+    readonly attribute?: string;
+}
+interface IWcBindableCommand {
+    readonly name: string;
+    readonly async?: boolean;
+}
+interface IWcBindable {
+    readonly protocol: "wc-bindable";
+    readonly version: 1;
+    readonly properties: readonly IWcBindableProperty[];
+    readonly inputs?: readonly IWcBindableInput[];
+    readonly commands?: readonly IWcBindableCommand[];
+}
+
+interface ITagNames {
+    readonly idle: string;
+}
+interface IWritableTagNames {
+    idle?: string;
+}
+interface IConfig {
+    readonly tagNames: ITagNames;
+}
+interface IWritableConfig {
+    tagNames?: IWritableTagNames;
+}
+
+type IdleUserState = "active" | "idle";
+type IdleScreenState = "locked" | "unlocked";
+/**
+ * Value types for IdleCore (headless) — the observable state properties.
+ * Permission state (granted/denied/prompt) is intentionally NOT included here
+ * — compose with `<wcs-permission name="idle-detection">` instead
+ * (docs/idle-detection-tag-design.md §0/§2).
+ */
+interface WcsIdleCoreValues {
+    userState: IdleUserState | null;
+    screenState: IdleScreenState | null;
+    active: boolean;
+    error: any;
+}
+/**
+ * Value types for the Shell (`<wcs-idle>`) — identical observable surface to
+ * the Core.
+ */
+type WcsIdleValues = WcsIdleCoreValues;
+
+declare function bootstrapIdle(userConfig?: IWritableConfig): void;
+
+declare function getConfig(): IConfig;
+
+/**
+ * Headless Idle Detection primitive. A thin, framework-agnostic wrapper around
+ * `IdleDetector` exposed through the wc-bindable protocol.
+ *
+ * Reference implementation for batch2's "gesture-gated permission" archetype
+ * (docs/idle-detection-tag-design.md). `requestPermission()` wraps the static,
+ * user-gesture-gated `IdleDetector.requestPermission()` — this Core never
+ * calls it automatically; the caller must invoke it from within a real
+ * gesture handler.
+ *
+ * Deliberately does NOT track the 4-value permission state (prompt/granted/
+ * denied/unsupported) itself: `navigator.permissions.query({name:
+ * "idle-detection"})` exists, so compose with `<wcs-permission
+ * name="idle-detection">` for that instead (§0). This Core only exposes the
+ * actual idle state (userState/screenState) plus the one-time
+ * requestPermission()/start()/stop() actions.
+ */
+declare class IdleCore extends EventTarget {
+    static wcBindable: IWcBindable;
+    private _target;
+    private _userState;
+    private _screenState;
+    private _error;
+    private _detector;
+    private _abortController;
+    private _gen;
+    private _ready;
+    constructor(target?: EventTarget);
+    get ready(): Promise<void>;
+    get userState(): IdleUserState | null;
+    get screenState(): IdleScreenState | null;
+    get active(): boolean;
+    get error(): any;
+    observe(): Promise<void>;
+    dispose(): void;
+    private _api;
+    private _setState;
+    private _setError;
+    /**
+     * Wraps the static, user-gesture-gated `IdleDetector.requestPermission()`.
+     * MUST be invoked from within a real user gesture handler by the caller —
+     * this Core cannot manufacture one. never-throw: a gesture-context
+     * rejection resolves to `"denied"` and lands in `error`. Gesture violation
+     * and an actual "denied" outcome are not distinguished — both mean "not
+     * usable right now" (§4.1).
+     */
+    requestPermission(): Promise<"granted" | "denied">;
+    /**
+     * Start an idle-detection session. `threshold` (ms) must be >= 60000 per
+     * spec — not validated here (§3): an out-of-range value is left to the
+     * browser's own TypeError, which never-throw absorbs into `error`.
+     */
+    start(threshold?: number): Promise<void>;
+    /** Stop the current session (if any) and detach its listener. Safe to call when not started. */
+    stop(): void;
+    private _onChange;
+}
+
+/**
+ * `<wcs-idle>` — declarative Idle Detection API primitive.
+ *
+ * Does NOT auto-start on connect (docs/idle-detection-tag-design.md §6): the
+ * permission gate sits in front of `start()`, so an unconditional
+ * connectedCallback start would be guaranteed to fail before permission is
+ * granted. Callers drive `requestPermission()` → `start()` explicitly, e.g.
+ * from a click handler.
+ *
+ * Compose with `<wcs-permission name="idle-detection">` for prompt/granted/
+ * denied status — this Shell only exposes the actual idle state.
+ */
+declare class WcsIdle extends HTMLElement {
+    static hasConnectedCallbackPromise: boolean;
+    static wcBindable: IWcBindable;
+    private _core;
+    private _connectedCallbackPromise;
+    constructor();
+    /**
+     * Minimum idle time (ms) before `userState` becomes `"idle"`. This value is
+     * read only at `start()` time — there is no `attributeChangedCallback`
+     * (deliberately not declared in `observedAttributes`, mirroring
+     * `<wcs-gyroscope>`'s `frequency`), so mutating the attribute/property on an
+     * already-running session has no effect until the caller `stop()`s and
+     * `start()`s again.
+     */
+    get threshold(): number;
+    set threshold(value: number);
+    get userState(): IdleUserState | null;
+    get screenState(): IdleScreenState | null;
+    get active(): boolean;
+    get error(): any;
+    get connectedCallbackPromise(): Promise<void>;
+    requestPermission(): Promise<"granted" | "denied">;
+    start(threshold?: number): Promise<void>;
+    stop(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}
+
+export { IdleCore, WcsIdle, bootstrapIdle, getConfig };
+export type { IWritableConfig, IWritableTagNames, IdleScreenState, IdleUserState, WcsIdleCoreValues, WcsIdleValues };

package/dist/index.esm.js

@@ -0,0 +1,338 @@
+const _config = {
+    tagNames: {
+        idle: "wcs-idle",
+    },
+};
+function deepFreeze(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    Object.freeze(obj);
+    for (const key of Object.keys(obj)) {
+        deepFreeze(obj[key]);
+    }
+    return obj;
+}
+function deepClone(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    const clone = {};
+    for (const key of Object.keys(obj)) {
+        clone[key] = deepClone(obj[key]);
+    }
+    return clone;
+}
+let frozenConfig = null;
+const config = _config;
+function getConfig() {
+    if (!frozenConfig) {
+        frozenConfig = deepFreeze(deepClone(_config));
+    }
+    return frozenConfig;
+}
+function setConfig(partialConfig) {
+    if (partialConfig.tagNames) {
+        Object.assign(_config.tagNames, partialConfig.tagNames);
+    }
+    frozenConfig = null;
+}
+
+const MIN_THRESHOLD = 60000;
+/**
+ * Headless Idle Detection primitive. A thin, framework-agnostic wrapper around
+ * `IdleDetector` exposed through the wc-bindable protocol.
+ *
+ * Reference implementation for batch2's "gesture-gated permission" archetype
+ * (docs/idle-detection-tag-design.md). `requestPermission()` wraps the static,
+ * user-gesture-gated `IdleDetector.requestPermission()` — this Core never
+ * calls it automatically; the caller must invoke it from within a real
+ * gesture handler.
+ *
+ * Deliberately does NOT track the 4-value permission state (prompt/granted/
+ * denied/unsupported) itself: `navigator.permissions.query({name:
+ * "idle-detection"})` exists, so compose with `<wcs-permission
+ * name="idle-detection">` for that instead (§0). This Core only exposes the
+ * actual idle state (userState/screenState) plus the one-time
+ * requestPermission()/start()/stop() actions.
+ */
+class IdleCore extends EventTarget {
+    static wcBindable = {
+        protocol: "wc-bindable",
+        version: 1,
+        properties: [
+            { name: "userState", event: "wcs-idle:change", getter: (e) => e.detail.userState },
+            { name: "screenState", event: "wcs-idle:change", getter: (e) => e.detail.screenState },
+            {
+                name: "active",
+                event: "wcs-idle:change",
+                getter: (e) => e.detail.userState === "active",
+            },
+            // never-throw (§3.6): requestPermission()/start() failures land here
+            // instead of rejecting/throwing. Mirrors every other bidirectional IO
+            // node in this batch (fetch, share, screen-orientation).
+            { name: "error", event: "wcs-idle:error" },
+        ],
+        // No `inputs`: the Core has no settable `threshold` state — `threshold` is a
+        // per-call argument to `start(threshold)`, not a property/setter. The DOM-driven
+        // `threshold` input surface belongs to the Shell (which declares it and backs it
+        // with the `threshold` attribute), mirroring geolocation/intersection where the
+        // Core declares no inputs and the Shell adds them.
+        commands: [
+            { name: "requestPermission", async: true },
+            { name: "start", async: true },
+            { name: "stop" },
+        ],
+    };
+    _target;
+    _userState = null;
+    _screenState = null;
+    _error = null;
+    _detector = null;
+    _abortController = null;
+    // Generation guard (§3.4): bumped on dispose()/stop() and each start().
+    _gen = 0;
+    // SSR (§3.8): never auto-starts on connect, so there is no probe to await —
+    // readiness is always immediate (docs/idle-detection-tag-design.md §7).
+    _ready = Promise.resolve();
+    constructor(target) {
+        super();
+        this._target = target ?? this;
+    }
+    get ready() {
+        return this._ready;
+    }
+    get userState() {
+        return this._userState;
+    }
+    get screenState() {
+        return this._screenState;
+    }
+    get active() {
+        return this._userState === "active";
+    }
+    get error() {
+        return this._error;
+    }
+    // Lifecycle (§3.5). observe() is a synchronous no-op: unlike most IO nodes,
+    // this Core deliberately does NOT auto-start on connect (§6) — permission
+    // is gesture-gated, so attempting start() before it is granted is
+    // guaranteed to fail.
+    observe() {
+        return this._ready;
+    }
+    dispose() {
+        this.stop();
+    }
+    _api() {
+        const g = globalThis;
+        return typeof g.IdleDetector === "function" ? g.IdleDetector : undefined;
+    }
+    _setState(userState, screenState) {
+        if (this._userState === userState && this._screenState === screenState)
+            return;
+        this._userState = userState;
+        this._screenState = screenState;
+        this._target.dispatchEvent(new CustomEvent("wcs-idle:change", {
+            detail: { userState, screenState },
+            bubbles: true,
+        }));
+    }
+    _setError(error) {
+        if (this._error === error)
+            return;
+        this._error = error;
+        this._target.dispatchEvent(new CustomEvent("wcs-idle:error", {
+            detail: error,
+            bubbles: true,
+        }));
+    }
+    /**
+     * Wraps the static, user-gesture-gated `IdleDetector.requestPermission()`.
+     * MUST be invoked from within a real user gesture handler by the caller —
+     * this Core cannot manufacture one. never-throw: a gesture-context
+     * rejection resolves to `"denied"` and lands in `error`. Gesture violation
+     * and an actual "denied" outcome are not distinguished — both mean "not
+     * usable right now" (§4.1).
+     */
+    async requestPermission() {
+        const Ctor = this._api();
+        if (!Ctor) {
+            this._setError({ message: "IdleDetector is not supported in this browser" });
+            return "denied";
+        }
+        try {
+            const result = await Ctor.requestPermission();
+            // Symmetric with start()'s success path: any settled (non-throwing)
+            // outcome — granted or a plain "denied" — supersedes a stale error from
+            // an earlier attempt (e.g. a prior gesture-context rejection).
+            this._setError(null);
+            return result === "granted" ? "granted" : "denied";
+        }
+        catch (e) {
+            this._setError({ error: e });
+            return "denied";
+        }
+    }
+    /**
+     * Start an idle-detection session. `threshold` (ms) must be >= 60000 per
+     * spec — not validated here (§3): an out-of-range value is left to the
+     * browser's own TypeError, which never-throw absorbs into `error`.
+     */
+    async start(threshold = MIN_THRESHOLD) {
+        this.stop(); // supersede any in-flight session (mirrors FetchCore's "cancel then start")
+        const Ctor = this._api();
+        if (!Ctor) {
+            this._setError({ message: "IdleDetector is not supported in this browser" });
+            return;
+        }
+        const ac = new AbortController();
+        this._abortController = ac;
+        const gen = ++this._gen;
+        try {
+            const detector = new Ctor();
+            detector.addEventListener("change", this._onChange);
+            this._detector = detector;
+            await detector.start({ threshold, signal: ac.signal });
+            if (gen !== this._gen)
+                return; // stale (stop()/dispose() ran during the await)
+            this._setError(null);
+            this._setState(detector.userState, detector.screenState);
+        }
+        catch (e) {
+            // No separate AbortError check: stop()/dispose() bump `_gen` *before*
+            // calling `ac.abort()` (see stop() below), so a stop()-triggered
+            // AbortError always has a stale `gen` here and is already caught by
+            // the check above. The signal is private and never exposed, so an
+            // AbortError from any other source cannot occur.
+            if (gen !== this._gen)
+                return;
+            // Tear down the failed session's listener/controller (mirrors stop()):
+            // without this, the failed `_detector` stays wired to `_onChange` and a
+            // later `change` on that same (never-truly-started) instance would
+            // still write state, contradicting the error just recorded.
+            this._detector?.removeEventListener("change", this._onChange);
+            this._detector = null;
+            this._abortController = null;
+            this._setError({ error: e });
+        }
+    }
+    /** Stop the current session (if any) and detach its listener. Safe to call when not started. */
+    stop() {
+        this._gen++;
+        this._abortController?.abort();
+        this._abortController = null;
+        if (this._detector) {
+            this._detector.removeEventListener("change", this._onChange);
+            this._detector = null;
+        }
+    }
+    _onChange = (event) => {
+        const detector = event.target;
+        this._setState(detector.userState, detector.screenState);
+    };
+}
+
+/**
+ * `<wcs-idle>` — declarative Idle Detection API primitive.
+ *
+ * Does NOT auto-start on connect (docs/idle-detection-tag-design.md §6): the
+ * permission gate sits in front of `start()`, so an unconditional
+ * connectedCallback start would be guaranteed to fail before permission is
+ * granted. Callers drive `requestPermission()` → `start()` explicitly, e.g.
+ * from a click handler.
+ *
+ * Compose with `<wcs-permission name="idle-detection">` for prompt/granted/
+ * denied status — this Shell only exposes the actual idle state.
+ */
+class WcsIdle extends HTMLElement {
+    static hasConnectedCallbackPromise = true;
+    static wcBindable = {
+        ...IdleCore.wcBindable,
+        inputs: [
+            { name: "threshold", attribute: "threshold" },
+        ],
+        // Core の commands をそのまま継承（単一情報源）。
+        commands: IdleCore.wcBindable.commands,
+    };
+    _core;
+    _connectedCallbackPromise = Promise.resolve();
+    constructor() {
+        super();
+        this._core = new IdleCore(this);
+    }
+    // --- Attribute accessors ---
+    /**
+     * Minimum idle time (ms) before `userState` becomes `"idle"`. This value is
+     * read only at `start()` time — there is no `attributeChangedCallback`
+     * (deliberately not declared in `observedAttributes`, mirroring
+     * `<wcs-gyroscope>`'s `frequency`), so mutating the attribute/property on an
+     * already-running session has no effect until the caller `stop()`s and
+     * `start()`s again.
+     */
+    get threshold() {
+        const attr = this.getAttribute("threshold");
+        // An absent, empty, or whitespace-only attribute all mean "no value
+        // supplied" and must fall back to the default — without this check,
+        // `Number("")`/`Number("  ")` coerce to `0` (finite), which would slip
+        // past the `Number.isFinite` fallback below and silently return `0`
+        // instead of the documented 60000ms default.
+        if (attr === null || attr.trim() === "")
+            return 60000;
+        const n = Number(attr);
+        return Number.isFinite(n) ? n : 60000;
+    }
+    set threshold(value) {
+        this.setAttribute("threshold", String(value));
+    }
+    // --- Core delegated getters ---
+    get userState() {
+        return this._core.userState;
+    }
+    get screenState() {
+        return this._core.screenState;
+    }
+    get active() {
+        return this._core.active;
+    }
+    get error() {
+        return this._core.error;
+    }
+    get connectedCallbackPromise() {
+        return this._connectedCallbackPromise;
+    }
+    // --- Commands (delegated to Core) ---
+    requestPermission() {
+        return this._core.requestPermission();
+    }
+    start(threshold) {
+        return this._core.start(threshold ?? this.threshold);
+    }
+    stop() {
+        this._core.stop();
+    }
+    // --- Lifecycle ---
+    connectedCallback() {
+        this.style.display = "none";
+        // No auto-start (§6) — observe() is a synchronous no-op, kept only for
+        // API uniformity with other IO nodes' lifecycle.
+        this._connectedCallbackPromise = this._core.observe();
+    }
+    disconnectedCallback() {
+        this._core.dispose();
+    }
+}
+
+function registerComponents() {
+    if (!customElements.get(config.tagNames.idle)) {
+        customElements.define(config.tagNames.idle, WcsIdle);
+    }
+}
+
+function bootstrapIdle(userConfig) {
+    if (userConfig) {
+        setConfig(userConfig);
+    }
+    registerComponents();
+}
+
+export { IdleCore, WcsIdle, bootstrapIdle, getConfig };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/config.ts","../src/core/IdleCore.ts","../src/components/Idle.ts","../src/registerComponents.ts","../src/bootstrapIdle.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    idle: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    idle: \"wcs-idle\",\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\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IdleScreenState, IdleUserState, IWcBindable } from \"../types.js\";\n\ninterface IdleDetectorLike extends EventTarget {\n  userState: IdleUserState;\n  screenState: IdleScreenState;\n  start(options: { threshold: number; signal: AbortSignal }): Promise<void>;\n}\n\ninterface IdleDetectorCtor {\n  new (): IdleDetectorLike;\n  requestPermission(): Promise<\"granted\" | \"denied\">;\n}\n\nconst MIN_THRESHOLD = 60000;\n\n/**\n * Headless Idle Detection primitive. A thin, framework-agnostic wrapper around\n * `IdleDetector` exposed through the wc-bindable protocol.\n *\n * Reference implementation for batch2's \"gesture-gated permission\" archetype\n * (docs/idle-detection-tag-design.md). `requestPermission()` wraps the static,\n * user-gesture-gated `IdleDetector.requestPermission()` — this Core never\n * calls it automatically; the caller must invoke it from within a real\n * gesture handler.\n *\n * Deliberately does NOT track the 4-value permission state (prompt/granted/\n * denied/unsupported) itself: `navigator.permissions.query({name:\n * \"idle-detection\"})` exists, so compose with `<wcs-permission\n * name=\"idle-detection\">` for that instead (§0). This Core only exposes the\n * actual idle state (userState/screenState) plus the one-time\n * requestPermission()/start()/stop() actions.\n */\nexport class IdleCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"userState\", event: \"wcs-idle:change\", getter: (e: Event) => (e as CustomEvent).detail.userState },\n      { name: \"screenState\", event: \"wcs-idle:change\", getter: (e: Event) => (e as CustomEvent).detail.screenState },\n      {\n        name: \"active\",\n        event: \"wcs-idle:change\",\n        getter: (e: Event) => (e as CustomEvent).detail.userState === \"active\",\n      },\n      // never-throw (§3.6): requestPermission()/start() failures land here\n      // instead of rejecting/throwing. Mirrors every other bidirectional IO\n      // node in this batch (fetch, share, screen-orientation).\n      { name: \"error\", event: \"wcs-idle:error\" },\n    ],\n    // No `inputs`: the Core has no settable `threshold` state — `threshold` is a\n    // per-call argument to `start(threshold)`, not a property/setter. The DOM-driven\n    // `threshold` input surface belongs to the Shell (which declares it and backs it\n    // with the `threshold` attribute), mirroring geolocation/intersection where the\n    // Core declares no inputs and the Shell adds them.\n    commands: [\n      { name: \"requestPermission\", async: true },\n      { name: \"start\", async: true },\n      { name: \"stop\" },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _userState: IdleUserState | null = null;\n  private _screenState: IdleScreenState | null = null;\n  private _error: any = null;\n  private _detector: IdleDetectorLike | null = null;\n  private _abortController: AbortController | null = null;\n\n  // Generation guard (§3.4): bumped on dispose()/stop() and each start().\n  private _gen = 0;\n\n  // SSR (§3.8): never auto-starts on connect, so there is no probe to await —\n  // readiness is always immediate (docs/idle-detection-tag-design.md §7).\n  private _ready: Promise<void> = Promise.resolve();\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  get userState(): IdleUserState | null {\n    return this._userState;\n  }\n\n  get screenState(): IdleScreenState | null {\n    return this._screenState;\n  }\n\n  get active(): boolean {\n    return this._userState === \"active\";\n  }\n\n  get error(): any {\n    return this._error;\n  }\n\n  // Lifecycle (§3.5). observe() is a synchronous no-op: unlike most IO nodes,\n  // this Core deliberately does NOT auto-start on connect (§6) — permission\n  // is gesture-gated, so attempting start() before it is granted is\n  // guaranteed to fail.\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this.stop();\n  }\n\n  private _api(): IdleDetectorCtor | undefined {\n    const g = globalThis as any;\n    return typeof g.IdleDetector === \"function\" ? g.IdleDetector : undefined;\n  }\n\n  private _setState(userState: IdleUserState, screenState: IdleScreenState): void {\n    if (this._userState === userState && this._screenState === screenState) return;\n    this._userState = userState;\n    this._screenState = screenState;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-idle:change\", {\n      detail: { userState, screenState },\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: any): void {\n    if (this._error === error) return;\n    this._error = error;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-idle:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  /**\n   * Wraps the static, user-gesture-gated `IdleDetector.requestPermission()`.\n   * MUST be invoked from within a real user gesture handler by the caller —\n   * this Core cannot manufacture one. never-throw: a gesture-context\n   * rejection resolves to `\"denied\"` and lands in `error`. Gesture violation\n   * and an actual \"denied\" outcome are not distinguished — both mean \"not\n   * usable right now\" (§4.1).\n   */\n  async requestPermission(): Promise<\"granted\" | \"denied\"> {\n    const Ctor = this._api();\n    if (!Ctor) {\n      this._setError({ message: \"IdleDetector is not supported in this browser\" });\n      return \"denied\";\n    }\n    try {\n      const result = await Ctor.requestPermission();\n      // Symmetric with start()'s success path: any settled (non-throwing)\n      // outcome — granted or a plain \"denied\" — supersedes a stale error from\n      // an earlier attempt (e.g. a prior gesture-context rejection).\n      this._setError(null);\n      return result === \"granted\" ? \"granted\" : \"denied\";\n    } catch (e) {\n      this._setError({ error: e });\n      return \"denied\";\n    }\n  }\n\n  /**\n   * Start an idle-detection session. `threshold` (ms) must be >= 60000 per\n   * spec — not validated here (§3): an out-of-range value is left to the\n   * browser's own TypeError, which never-throw absorbs into `error`.\n   */\n  async start(threshold: number = MIN_THRESHOLD): Promise<void> {\n    this.stop(); // supersede any in-flight session (mirrors FetchCore's \"cancel then start\")\n\n    const Ctor = this._api();\n    if (!Ctor) {\n      this._setError({ message: \"IdleDetector is not supported in this browser\" });\n      return;\n    }\n\n    const ac = new AbortController();\n    this._abortController = ac;\n    const gen = ++this._gen;\n\n    try {\n      const detector = new Ctor();\n      detector.addEventListener(\"change\", this._onChange);\n      this._detector = detector;\n      await detector.start({ threshold, signal: ac.signal });\n      if (gen !== this._gen) return; // stale (stop()/dispose() ran during the await)\n      this._setError(null);\n      this._setState(detector.userState, detector.screenState);\n    } catch (e: any) {\n      // No separate AbortError check: stop()/dispose() bump `_gen` *before*\n      // calling `ac.abort()` (see stop() below), so a stop()-triggered\n      // AbortError always has a stale `gen` here and is already caught by\n      // the check above. The signal is private and never exposed, so an\n      // AbortError from any other source cannot occur.\n      if (gen !== this._gen) return;\n      // Tear down the failed session's listener/controller (mirrors stop()):\n      // without this, the failed `_detector` stays wired to `_onChange` and a\n      // later `change` on that same (never-truly-started) instance would\n      // still write state, contradicting the error just recorded.\n      this._detector?.removeEventListener(\"change\", this._onChange);\n      this._detector = null;\n      this._abortController = null;\n      this._setError({ error: e });\n    }\n  }\n\n  /** Stop the current session (if any) and detach its listener. Safe to call when not started. */\n  stop(): void {\n    this._gen++;\n    this._abortController?.abort();\n    this._abortController = null;\n    if (this._detector) {\n      this._detector.removeEventListener(\"change\", this._onChange);\n      this._detector = null;\n    }\n  }\n\n  private _onChange = (event: Event): void => {\n    const detector = event.target as IdleDetectorLike;\n    this._setState(detector.userState, detector.screenState);\n  };\n}\n","import { IdleScreenState, IdleUserState, IWcBindable } from \"../types.js\";\nimport { IdleCore } from \"../core/IdleCore.js\";\n\n/**\n * `<wcs-idle>` — declarative Idle Detection API primitive.\n *\n * Does NOT auto-start on connect (docs/idle-detection-tag-design.md §6): the\n * permission gate sits in front of `start()`, so an unconditional\n * connectedCallback start would be guaranteed to fail before permission is\n * granted. Callers drive `requestPermission()` → `start()` explicitly, e.g.\n * from a click handler.\n *\n * Compose with `<wcs-permission name=\"idle-detection\">` for prompt/granted/\n * denied status — this Shell only exposes the actual idle state.\n */\nexport class WcsIdle extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...IdleCore.wcBindable,\n    inputs: [\n      { name: \"threshold\", attribute: \"threshold\" },\n    ],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: IdleCore.wcBindable.commands,\n  };\n\n  private _core: IdleCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new IdleCore(this);\n  }\n\n  // --- Attribute accessors ---\n\n  /**\n   * Minimum idle time (ms) before `userState` becomes `\"idle\"`. This value is\n   * read only at `start()` time — there is no `attributeChangedCallback`\n   * (deliberately not declared in `observedAttributes`, mirroring\n   * `<wcs-gyroscope>`'s `frequency`), so mutating the attribute/property on an\n   * already-running session has no effect until the caller `stop()`s and\n   * `start()`s again.\n   */\n  get threshold(): number {\n    const attr = this.getAttribute(\"threshold\");\n    // An absent, empty, or whitespace-only attribute all mean \"no value\n    // supplied\" and must fall back to the default — without this check,\n    // `Number(\"\")`/`Number(\"  \")` coerce to `0` (finite), which would slip\n    // past the `Number.isFinite` fallback below and silently return `0`\n    // instead of the documented 60000ms default.\n    if (attr === null || attr.trim() === \"\") return 60000;\n    const n = Number(attr);\n    return Number.isFinite(n) ? n : 60000;\n  }\n\n  set threshold(value: number) {\n    this.setAttribute(\"threshold\", String(value));\n  }\n\n  // --- Core delegated getters ---\n\n  get userState(): IdleUserState | null {\n    return this._core.userState;\n  }\n\n  get screenState(): IdleScreenState | null {\n    return this._core.screenState;\n  }\n\n  get active(): boolean {\n    return this._core.active;\n  }\n\n  get error(): any {\n    return this._core.error;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Commands (delegated to Core) ---\n\n  requestPermission(): Promise<\"granted\" | \"denied\"> {\n    return this._core.requestPermission();\n  }\n\n  start(threshold?: number): Promise<void> {\n    return this._core.start(threshold ?? this.threshold);\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  // --- Lifecycle ---\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    // No auto-start (§6) — observe() is a synchronous no-op, kept only for\n    // API uniformity with other IO nodes' lifecycle.\n    this._connectedCallbackPromise = this._core.observe();\n  }\n\n  disconnectedCallback(): void {\n    this._core.dispose();\n  }\n}\n","import { WcsIdle } from \"./components/Idle.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.idle)) {\n    customElements.define(config.tagNames.idle, WcsIdle);\n  }\n}\n","import { setConfig } from \"./config.js\";\nimport { registerComponents } from \"./registerComponents.js\";\nimport { IWritableConfig } from \"./types.js\";\n\nexport function bootstrapIdle(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n"],"names":[],"mappings":"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"}

package/dist/index.esm.min.js

@@ -0,0 +1,2 @@
+const e={tagNames:{idle:"wcs-idle"}};function t(e){if(null===e||"object"!=typeof e)return e;Object.freeze(e);for(const r of Object.keys(e))t(e[r]);return e}function r(e){if(null===e||"object"!=typeof e)return e;const t={};for(const s of Object.keys(e))t[s]=r(e[s]);return t}let s=null;const n=e;function i(){return s||(s=t(r(e))),s}class o extends EventTarget{static wcBindable={protocol:"wc-bindable",version:1,properties:[{name:"userState",event:"wcs-idle:change",getter:e=>e.detail.userState},{name:"screenState",event:"wcs-idle:change",getter:e=>e.detail.screenState},{name:"active",event:"wcs-idle:change",getter:e=>"active"===e.detail.userState},{name:"error",event:"wcs-idle:error"}],commands:[{name:"requestPermission",async:!0},{name:"start",async:!0},{name:"stop"}]};_target;_userState=null;_screenState=null;_error=null;_detector=null;_abortController=null;_gen=0;_ready=Promise.resolve();constructor(e){super(),this._target=e??this}get ready(){return this._ready}get userState(){return this._userState}get screenState(){return this._screenState}get active(){return"active"===this._userState}get error(){return this._error}observe(){return this._ready}dispose(){this.stop()}_api(){const e=globalThis;return"function"==typeof e.IdleDetector?e.IdleDetector:void 0}_setState(e,t){this._userState===e&&this._screenState===t||(this._userState=e,this._screenState=t,this._target.dispatchEvent(new CustomEvent("wcs-idle:change",{detail:{userState:e,screenState:t},bubbles:!0})))}_setError(e){this._error!==e&&(this._error=e,this._target.dispatchEvent(new CustomEvent("wcs-idle:error",{detail:e,bubbles:!0})))}async requestPermission(){const e=this._api();if(!e)return this._setError({message:"IdleDetector is not supported in this browser"}),"denied";try{const t=await e.requestPermission();return this._setError(null),"granted"===t?"granted":"denied"}catch(e){return this._setError({error:e}),"denied"}}async start(e=6e4){this.stop();const t=this._api();if(!t)return void this._setError({message:"IdleDetector is not supported in this browser"});const r=new AbortController;this._abortController=r;const s=++this._gen;try{const n=new t;if(n.addEventListener("change",this._onChange),this._detector=n,await n.start({threshold:e,signal:r.signal}),s!==this._gen)return;this._setError(null),this._setState(n.userState,n.screenState)}catch(e){if(s!==this._gen)return;this._detector?.removeEventListener("change",this._onChange),this._detector=null,this._abortController=null,this._setError({error:e})}}stop(){this._gen++,this._abortController?.abort(),this._abortController=null,this._detector&&(this._detector.removeEventListener("change",this._onChange),this._detector=null)}_onChange=e=>{const t=e.target;this._setState(t.userState,t.screenState)}}class a extends HTMLElement{static hasConnectedCallbackPromise=!0;static wcBindable={...o.wcBindable,inputs:[{name:"threshold",attribute:"threshold"}],commands:o.wcBindable.commands};_core;_connectedCallbackPromise=Promise.resolve();constructor(){super(),this._core=new o(this)}get threshold(){const e=this.getAttribute("threshold");if(null===e||""===e.trim())return 6e4;const t=Number(e);return Number.isFinite(t)?t:6e4}set threshold(e){this.setAttribute("threshold",String(e))}get userState(){return this._core.userState}get screenState(){return this._core.screenState}get active(){return this._core.active}get error(){return this._core.error}get connectedCallbackPromise(){return this._connectedCallbackPromise}requestPermission(){return this._core.requestPermission()}start(e){return this._core.start(e??this.threshold)}stop(){this._core.stop()}connectedCallback(){this.style.display="none",this._connectedCallbackPromise=this._core.observe()}disconnectedCallback(){this._core.dispose()}}function c(t){var r;t&&((r=t).tagNames&&Object.assign(e.tagNames,r.tagNames),s=null),customElements.get(n.tagNames.idle)||customElements.define(n.tagNames.idle,a)}export{o as IdleCore,a as WcsIdle,c as bootstrapIdle,i as getConfig};
+//# sourceMappingURL=index.esm.min.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.min.js","sources":["../src/config.ts","../src/core/IdleCore.ts","../src/components/Idle.ts","../src/bootstrapIdle.ts","../src/registerComponents.ts"],"sourcesContent":["import { IConfig, IWritableConfig } from \"./types.js\";\n\ninterface IInternalConfig extends IConfig {\n  tagNames: {\n    idle: string;\n  };\n}\n\nconst _config: IInternalConfig = {\n  tagNames: {\n    idle: \"wcs-idle\",\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\nexport const config: IConfig = _config as IConfig;\n\nexport function getConfig(): IConfig {\n  if (!frozenConfig) {\n    frozenConfig = deepFreeze(deepClone(_config));\n  }\n  return frozenConfig;\n}\n\nexport function setConfig(partialConfig: IWritableConfig): void {\n  if (partialConfig.tagNames) {\n    Object.assign(_config.tagNames, partialConfig.tagNames);\n  }\n  frozenConfig = null;\n}\n","import { IdleScreenState, IdleUserState, IWcBindable } from \"../types.js\";\n\ninterface IdleDetectorLike extends EventTarget {\n  userState: IdleUserState;\n  screenState: IdleScreenState;\n  start(options: { threshold: number; signal: AbortSignal }): Promise<void>;\n}\n\ninterface IdleDetectorCtor {\n  new (): IdleDetectorLike;\n  requestPermission(): Promise<\"granted\" | \"denied\">;\n}\n\nconst MIN_THRESHOLD = 60000;\n\n/**\n * Headless Idle Detection primitive. A thin, framework-agnostic wrapper around\n * `IdleDetector` exposed through the wc-bindable protocol.\n *\n * Reference implementation for batch2's \"gesture-gated permission\" archetype\n * (docs/idle-detection-tag-design.md). `requestPermission()` wraps the static,\n * user-gesture-gated `IdleDetector.requestPermission()` — this Core never\n * calls it automatically; the caller must invoke it from within a real\n * gesture handler.\n *\n * Deliberately does NOT track the 4-value permission state (prompt/granted/\n * denied/unsupported) itself: `navigator.permissions.query({name:\n * \"idle-detection\"})` exists, so compose with `<wcs-permission\n * name=\"idle-detection\">` for that instead (§0). This Core only exposes the\n * actual idle state (userState/screenState) plus the one-time\n * requestPermission()/start()/stop() actions.\n */\nexport class IdleCore extends EventTarget {\n  static wcBindable: IWcBindable = {\n    protocol: \"wc-bindable\",\n    version: 1,\n    properties: [\n      { name: \"userState\", event: \"wcs-idle:change\", getter: (e: Event) => (e as CustomEvent).detail.userState },\n      { name: \"screenState\", event: \"wcs-idle:change\", getter: (e: Event) => (e as CustomEvent).detail.screenState },\n      {\n        name: \"active\",\n        event: \"wcs-idle:change\",\n        getter: (e: Event) => (e as CustomEvent).detail.userState === \"active\",\n      },\n      // never-throw (§3.6): requestPermission()/start() failures land here\n      // instead of rejecting/throwing. Mirrors every other bidirectional IO\n      // node in this batch (fetch, share, screen-orientation).\n      { name: \"error\", event: \"wcs-idle:error\" },\n    ],\n    // No `inputs`: the Core has no settable `threshold` state — `threshold` is a\n    // per-call argument to `start(threshold)`, not a property/setter. The DOM-driven\n    // `threshold` input surface belongs to the Shell (which declares it and backs it\n    // with the `threshold` attribute), mirroring geolocation/intersection where the\n    // Core declares no inputs and the Shell adds them.\n    commands: [\n      { name: \"requestPermission\", async: true },\n      { name: \"start\", async: true },\n      { name: \"stop\" },\n    ],\n  };\n\n  private _target: EventTarget;\n  private _userState: IdleUserState | null = null;\n  private _screenState: IdleScreenState | null = null;\n  private _error: any = null;\n  private _detector: IdleDetectorLike | null = null;\n  private _abortController: AbortController | null = null;\n\n  // Generation guard (§3.4): bumped on dispose()/stop() and each start().\n  private _gen = 0;\n\n  // SSR (§3.8): never auto-starts on connect, so there is no probe to await —\n  // readiness is always immediate (docs/idle-detection-tag-design.md §7).\n  private _ready: Promise<void> = Promise.resolve();\n\n  constructor(target?: EventTarget) {\n    super();\n    this._target = target ?? this;\n  }\n\n  get ready(): Promise<void> {\n    return this._ready;\n  }\n\n  get userState(): IdleUserState | null {\n    return this._userState;\n  }\n\n  get screenState(): IdleScreenState | null {\n    return this._screenState;\n  }\n\n  get active(): boolean {\n    return this._userState === \"active\";\n  }\n\n  get error(): any {\n    return this._error;\n  }\n\n  // Lifecycle (§3.5). observe() is a synchronous no-op: unlike most IO nodes,\n  // this Core deliberately does NOT auto-start on connect (§6) — permission\n  // is gesture-gated, so attempting start() before it is granted is\n  // guaranteed to fail.\n  observe(): Promise<void> {\n    return this._ready;\n  }\n\n  dispose(): void {\n    this.stop();\n  }\n\n  private _api(): IdleDetectorCtor | undefined {\n    const g = globalThis as any;\n    return typeof g.IdleDetector === \"function\" ? g.IdleDetector : undefined;\n  }\n\n  private _setState(userState: IdleUserState, screenState: IdleScreenState): void {\n    if (this._userState === userState && this._screenState === screenState) return;\n    this._userState = userState;\n    this._screenState = screenState;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-idle:change\", {\n      detail: { userState, screenState },\n      bubbles: true,\n    }));\n  }\n\n  private _setError(error: any): void {\n    if (this._error === error) return;\n    this._error = error;\n    this._target.dispatchEvent(new CustomEvent(\"wcs-idle:error\", {\n      detail: error,\n      bubbles: true,\n    }));\n  }\n\n  /**\n   * Wraps the static, user-gesture-gated `IdleDetector.requestPermission()`.\n   * MUST be invoked from within a real user gesture handler by the caller —\n   * this Core cannot manufacture one. never-throw: a gesture-context\n   * rejection resolves to `\"denied\"` and lands in `error`. Gesture violation\n   * and an actual \"denied\" outcome are not distinguished — both mean \"not\n   * usable right now\" (§4.1).\n   */\n  async requestPermission(): Promise<\"granted\" | \"denied\"> {\n    const Ctor = this._api();\n    if (!Ctor) {\n      this._setError({ message: \"IdleDetector is not supported in this browser\" });\n      return \"denied\";\n    }\n    try {\n      const result = await Ctor.requestPermission();\n      // Symmetric with start()'s success path: any settled (non-throwing)\n      // outcome — granted or a plain \"denied\" — supersedes a stale error from\n      // an earlier attempt (e.g. a prior gesture-context rejection).\n      this._setError(null);\n      return result === \"granted\" ? \"granted\" : \"denied\";\n    } catch (e) {\n      this._setError({ error: e });\n      return \"denied\";\n    }\n  }\n\n  /**\n   * Start an idle-detection session. `threshold` (ms) must be >= 60000 per\n   * spec — not validated here (§3): an out-of-range value is left to the\n   * browser's own TypeError, which never-throw absorbs into `error`.\n   */\n  async start(threshold: number = MIN_THRESHOLD): Promise<void> {\n    this.stop(); // supersede any in-flight session (mirrors FetchCore's \"cancel then start\")\n\n    const Ctor = this._api();\n    if (!Ctor) {\n      this._setError({ message: \"IdleDetector is not supported in this browser\" });\n      return;\n    }\n\n    const ac = new AbortController();\n    this._abortController = ac;\n    const gen = ++this._gen;\n\n    try {\n      const detector = new Ctor();\n      detector.addEventListener(\"change\", this._onChange);\n      this._detector = detector;\n      await detector.start({ threshold, signal: ac.signal });\n      if (gen !== this._gen) return; // stale (stop()/dispose() ran during the await)\n      this._setError(null);\n      this._setState(detector.userState, detector.screenState);\n    } catch (e: any) {\n      // No separate AbortError check: stop()/dispose() bump `_gen` *before*\n      // calling `ac.abort()` (see stop() below), so a stop()-triggered\n      // AbortError always has a stale `gen` here and is already caught by\n      // the check above. The signal is private and never exposed, so an\n      // AbortError from any other source cannot occur.\n      if (gen !== this._gen) return;\n      // Tear down the failed session's listener/controller (mirrors stop()):\n      // without this, the failed `_detector` stays wired to `_onChange` and a\n      // later `change` on that same (never-truly-started) instance would\n      // still write state, contradicting the error just recorded.\n      this._detector?.removeEventListener(\"change\", this._onChange);\n      this._detector = null;\n      this._abortController = null;\n      this._setError({ error: e });\n    }\n  }\n\n  /** Stop the current session (if any) and detach its listener. Safe to call when not started. */\n  stop(): void {\n    this._gen++;\n    this._abortController?.abort();\n    this._abortController = null;\n    if (this._detector) {\n      this._detector.removeEventListener(\"change\", this._onChange);\n      this._detector = null;\n    }\n  }\n\n  private _onChange = (event: Event): void => {\n    const detector = event.target as IdleDetectorLike;\n    this._setState(detector.userState, detector.screenState);\n  };\n}\n","import { IdleScreenState, IdleUserState, IWcBindable } from \"../types.js\";\nimport { IdleCore } from \"../core/IdleCore.js\";\n\n/**\n * `<wcs-idle>` — declarative Idle Detection API primitive.\n *\n * Does NOT auto-start on connect (docs/idle-detection-tag-design.md §6): the\n * permission gate sits in front of `start()`, so an unconditional\n * connectedCallback start would be guaranteed to fail before permission is\n * granted. Callers drive `requestPermission()` → `start()` explicitly, e.g.\n * from a click handler.\n *\n * Compose with `<wcs-permission name=\"idle-detection\">` for prompt/granted/\n * denied status — this Shell only exposes the actual idle state.\n */\nexport class WcsIdle extends HTMLElement {\n  static hasConnectedCallbackPromise = true;\n\n  static wcBindable: IWcBindable = {\n    ...IdleCore.wcBindable,\n    inputs: [\n      { name: \"threshold\", attribute: \"threshold\" },\n    ],\n    // Core の commands をそのまま継承（単一情報源）。\n    commands: IdleCore.wcBindable.commands,\n  };\n\n  private _core: IdleCore;\n  private _connectedCallbackPromise: Promise<void> = Promise.resolve();\n\n  constructor() {\n    super();\n    this._core = new IdleCore(this);\n  }\n\n  // --- Attribute accessors ---\n\n  /**\n   * Minimum idle time (ms) before `userState` becomes `\"idle\"`. This value is\n   * read only at `start()` time — there is no `attributeChangedCallback`\n   * (deliberately not declared in `observedAttributes`, mirroring\n   * `<wcs-gyroscope>`'s `frequency`), so mutating the attribute/property on an\n   * already-running session has no effect until the caller `stop()`s and\n   * `start()`s again.\n   */\n  get threshold(): number {\n    const attr = this.getAttribute(\"threshold\");\n    // An absent, empty, or whitespace-only attribute all mean \"no value\n    // supplied\" and must fall back to the default — without this check,\n    // `Number(\"\")`/`Number(\"  \")` coerce to `0` (finite), which would slip\n    // past the `Number.isFinite` fallback below and silently return `0`\n    // instead of the documented 60000ms default.\n    if (attr === null || attr.trim() === \"\") return 60000;\n    const n = Number(attr);\n    return Number.isFinite(n) ? n : 60000;\n  }\n\n  set threshold(value: number) {\n    this.setAttribute(\"threshold\", String(value));\n  }\n\n  // --- Core delegated getters ---\n\n  get userState(): IdleUserState | null {\n    return this._core.userState;\n  }\n\n  get screenState(): IdleScreenState | null {\n    return this._core.screenState;\n  }\n\n  get active(): boolean {\n    return this._core.active;\n  }\n\n  get error(): any {\n    return this._core.error;\n  }\n\n  get connectedCallbackPromise(): Promise<void> {\n    return this._connectedCallbackPromise;\n  }\n\n  // --- Commands (delegated to Core) ---\n\n  requestPermission(): Promise<\"granted\" | \"denied\"> {\n    return this._core.requestPermission();\n  }\n\n  start(threshold?: number): Promise<void> {\n    return this._core.start(threshold ?? this.threshold);\n  }\n\n  stop(): void {\n    this._core.stop();\n  }\n\n  // --- Lifecycle ---\n\n  connectedCallback(): void {\n    this.style.display = \"none\";\n    // No auto-start (§6) — observe() is a synchronous no-op, kept only for\n    // API uniformity with other IO nodes' lifecycle.\n    this._connectedCallbackPromise = this._core.observe();\n  }\n\n  disconnectedCallback(): void {\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 bootstrapIdle(userConfig?: IWritableConfig): void {\n  if (userConfig) {\n    setConfig(userConfig);\n  }\n  registerComponents();\n}\n","import { WcsIdle } from \"./components/Idle.js\";\nimport { config } from \"./config.js\";\n\nexport function registerComponents(): void {\n  if (!customElements.get(config.tagNames.idle)) {\n    customElements.define(config.tagNames.idle, WcsIdle);\n  }\n}\n"],"names":["_config","tagNames","idle","deepFreeze","obj","Object","freeze","key","keys","deepClone","clone","frozenConfig","config","getConfig","IdleCore","EventTarget","static","protocol","version","properties","name","event","getter","e","detail","userState","screenState","commands","async","_target","_userState","_screenState","_error","_detector","_abortController","_gen","_ready","Promise","resolve","constructor","target","super","this","ready","active","error","observe","dispose","stop","_api","g","globalThis","IdleDetector","undefined","_setState","dispatchEvent","CustomEvent","bubbles","_setError","requestPermission","Ctor","message","result","start","threshold","ac","AbortController","gen","detector","addEventListener","_onChange","signal","removeEventListener","abort","WcsIdle","HTMLElement","wcBindable","inputs","attribute","_core","_connectedCallbackPromise","attr","getAttribute","trim","n","Number","isFinite","value","setAttribute","String","connectedCallbackPromise","connectedCallback","style","display","disconnectedCallback","bootstrapIdle","userConfig","partialConfig","assign","customElements","get","define"],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@wcstack/idle",
+  "version": "1.16.0",
+  "description": "Declarative Idle Detection component for Web Components. Framework-agnostic IdleDetector wrapper via wc-bindable-protocol.",
+  "type": "module",
+  "main": "./dist/index.esm.js",
+  "module": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.esm.js"
+    },
+    "./auto": "./dist/auto.min.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean": "rimraf dist .tsc-out",
+    "build": "rimraf dist .tsc-out && tsc && rollup -c",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "prepublishOnly": "npm run build && npm run test:coverage"
+  },
+  "keywords": [
+    "web-components",
+    "idle-detection",
+    "presence",
+    "custom-elements",
+    "wc-bindable",
+    "declarative",
+    "zero-dependencies",
+    "framework-agnostic"
+  ],
+  "author": "mogera551",
+  "homepage": "https://wcstack.github.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wcstack/wcstack.git",
+    "directory": "packages/idle"
+  },
+  "bugs": {
+    "url": "https://github.com/wcstack/wcstack/issues"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@vitest/coverage-v8": "^4.0.15",
+    "@vitest/ui": "^4.0.15",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "happy-dom": "^20.0.11",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.22.4",
+    "rollup-plugin-dts": "^6.1.1",
+    "rollup-plugin-copy": "^3.5.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0",
+    "vitest": "^4.0.15"
+  }
+}