@wcstack/clipboard 1.32.0 → 2.0.0

package/README.ja.md

@@ -138,7 +138,7 @@ DOM の autoTrigger は書き込み（`writeText`）のみを起動します。
 
 > DOM トリガは**書き込み専用**です。クリックは常に `writeText` を起動し、読み取り（`readText` / `read`）を起動する経路はありません。読み取りは command-token または命令的呼び出しで起動してください。
 
-> DOM トリガによる `writeText` は fire-and-forget（`Promise` を await しません）ですが、決して reject しません。コピー失敗は他の書き込みと同様 `error` プロパティに現れます。autoTrigger の失敗を観測するには `error` をバインドしてください（例: `text: error.message@cb`）。
+> DOM トリガによる `writeText` は fire-and-forget（`Promise` を await しません）ですが、決して reject しません。コピー失敗は他の書き込みと同様 `error` プロパティに現れます。autoTrigger の失敗を観測するには `error` をバインドしてください（例: `<wcs-clipboard>` 側に `error: copyError`、表示側に `textContent: copyError.message`）。
 
 > **autoTrigger は既定で有効。** 最初に接続した `<wcs-clipboard>` が document レベルの `click` リスナーを 1 つ設置します（`data-clipboardtarget` 要素のクリックで `writeText` を起動）。DOM ショートカットを使わないなら bootstrap エントリで無効化してください:
 >

package/README.md

@@ -140,7 +140,7 @@ Add the `monitor` attribute to republish document `copy` / `cut` / `paste` as re
 
 > DOM triggers are **write-only**: a click always drives `writeText`. There is no DOM-trigger path for reads (`readText` / `read`) — drive reads from a command-token or imperatively.
 
-> A DOM-triggered `writeText` is fire-and-forget (its `Promise` is not awaited), but it never rejects: a failed copy surfaces through the `error` property like any other write. Bind `error` (e.g. `text: error.message@cb`) to observe autoTrigger failures.
+> A DOM-triggered `writeText` is fire-and-forget (its `Promise` is not awaited), but it never rejects: a failed copy surfaces through the `error` property like any other write. Bind `error` (e.g. `error: copyError` on the `<wcs-clipboard>`, then `textContent: copyError.message` where you display it) to observe autoTrigger failures.
 
 > **autoTrigger is on by default.** The first `<wcs-clipboard>` to connect installs a single **document-level `click` listener** (a click on a `data-clipboardtarget` element runs `writeText`). If you don't use the DOM shortcut, opt out via the bootstrap entry:
 >

package/dist/index.d.ts

@@ -356,5 +356,11 @@ declare const WCS_CLIPBOARD_ERROR_CODE: {
     readonly ClipboardError: "clipboard-error";
 };
 
+declare global {
+    interface HTMLElementTagNameMap {
+        "wcs-clipboard": WcsClipboard;
+    }
+}
+
 export { ClipboardCore, WCS_CLIPBOARD_ERROR_CODE, WcsClipboard, bootstrapClipboard, getConfig };
 export type { ClipboardPermissionState, IWritableConfig, IWritableTagNames, WcsClipboardCommands, WcsClipboardCoreCommands, WcsClipboardCoreValues, WcsClipboardErrorDetail, WcsClipboardInputs, WcsClipboardReadDetail, WcsClipboardReadItem, WcsClipboardValues, WcsIoErrorInfo, WcsIoErrorPhase };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/clipboard",
-  "version": "1.32.0",
+  "version": "2.0.0",
   "description": "Declarative clipboard component for Web Components. Framework-agnostic Clipboard API primitive via wc-bindable-protocol.",
   "type": "module",
   "main": "./dist/index.esm.js",