@wcstack/worker 1.15.0 → 1.16.0

package/README.ja.md

@@ -123,6 +123,17 @@ npm install @wcstack/worker
 
 DOM トリガは**常に文字列を post します** — リテラルの `data-worker-text`、または解決された要素の `value` / `textContent`。これは単純なテキストペイロードのための利便機能であり、意図的に値のパース・型変換・構造化を行いません。structured clone データ（オブジェクト、typed array、transferable）を送るには、command-token プロトコル（`command.post: $command.run`）経由で `post` を起動するか、命令的に `element.post(data, transfer?)` を呼んでください。
 
+> **autoTrigger は既定で有効。** 最初に接続した `<wcs-worker>` が document レベルの `click` リスナーを 1 つ設置します（`data-worker-target` 要素のクリックで参照先 worker に post し、`event.preventDefault()` を呼ぶ）。DOM ショートカットを使わないなら bootstrap エントリで無効化してください:
+>
+> ```js
+> import { bootstrapWorker, getConfig } from "@wcstack/worker";
+> bootstrapWorker({ autoTrigger: false });      // document クリックリスナーを設置しない
+> bootstrapWorker({ triggerAttribute: "data-run" }); // トリガ属性名を変更（既定: data-worker-target）
+> getConfig();                                   // 実効設定（deep-frozen）を読む
+> ```
+>
+> `bootstrapWorker()` は要素が接続される前に呼んでください。（`setConfig` は内部用。設定は `bootstrapWorker` 経由で行います。）
+
 ## 観測可能なプロパティ（出力）
 
 | プロパティ | イベント                      | 説明                                                                                 |

package/README.md

@@ -123,6 +123,17 @@ The duality in one element: `post` is wired from a command-token, and an incomin
 
 The DOM trigger **always posts a string** — the literal `data-worker-text`, or the resolved element's `value` / `textContent`. It is a convenience for simple text payloads and intentionally does not parse, coerce, or structure the value. To send structured-clone data (objects, typed arrays, transferables), drive `post` via the command-token protocol (`command.post: $command.run`) or call `element.post(data, transfer?)` imperatively.
 
+> **autoTrigger is on by default.** The first `<wcs-worker>` to connect installs a single **document-level `click` listener** (a click on a `data-worker-target` element posts to the referenced worker, calling `event.preventDefault()`). If you don't use the DOM shortcut, opt out via the bootstrap entry:
+>
+> ```js
+> import { bootstrapWorker, getConfig } from "@wcstack/worker";
+> bootstrapWorker({ autoTrigger: false });      // no document click listener
+> bootstrapWorker({ triggerAttribute: "data-run" }); // rename the trigger attribute (default: data-worker-target)
+> getConfig();                                   // read the effective (deep-frozen) config
+> ```
+>
+> Call `bootstrapWorker()` before the elements connect. (`setConfig` is internal; configure through `bootstrapWorker`.)
+
 ## Observable Properties (outputs)
 
 | Property  | Event                         | Description                                                                          |

package/package.json

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