@wcstack/notification 1.31.0 → 1.33.0

package/README.ja.md

@@ -285,6 +285,10 @@ notify.dispose();                // 購読を解除（開いている通知は
 
 Core の構造サーフェスは wcstack I/O ノード横断の規範です([async-io-node-guidelines §3.9](../../docs/async-io-node-guidelines.ja.md))。要素なしで signals に束縛するには [@wcstack/signals — Core を直接束縛する](../signals/README.ja.md#core-を直接束縛する要素なし) を参照。
 
+## アクセシビリティ
+
+**WCAG 2.2.1 Timing Adjustable（調整可能な制限時間）**: デスクトップ通知は時限コンテンツである — 表示時間は OS が決め、ユーザーは丸ごと見逃しうる（権限拒否・集中モード・単に他所を見ていた）。情報の*唯一の*置き場を通知にしてはならない: ページ内にミラーし（[`examples/state-notification-chat`](https://github.com/wcstack/wcstack/tree/main/examples/state-notification-chat) の `role="log"` 行のように）、同じ内容・操作へ後からも到達できるようにする。`notify` オプションの `requireInteraction` は、プラットフォームが尊重する環境では通知を閉じるまで表示し続ける — 本当に失効してはならない内容にはこれを使う。
+
 ## ライセンス
 
 MIT

package/README.md

@@ -287,6 +287,10 @@ notify.dispose();                // detach subscriptions (open notifications sta
 
 The structural Core surface is normative across wcstack IO nodes ([async-io-node-guidelines §3.9](../../docs/async-io-node-guidelines.md)); to bind it into signals with no element at all, see [@wcstack/signals — Binding a Core directly](../signals/README.md#binding-a-core-directly-no-element).
 
+## Accessibility
+
+**WCAG 2.2.1 Timing Adjustable**: a desktop notification is timed content — the OS decides how long it stays visible, and the user may miss it entirely (permission denied, do-not-disturb, or simply looking elsewhere). Never make a notification the *only* place information appears: mirror it in the page (a `role="log"` line, as [`examples/state-notification-chat`](https://github.com/wcstack/wcstack/tree/main/examples/state-notification-chat) does), and let the user reach the same content or action later. `requireInteraction` in the `notify` options keeps a notification on screen until dismissed where the platform honors it — use it when the content genuinely must not expire.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -409,5 +409,11 @@ declare const WCS_NOTIFY_ERROR_CODE: {
     readonly NotifyError: "notify-error";
 };
 
+declare global {
+    interface HTMLElementTagNameMap {
+        "wcs-notify": WcsNotify;
+    }
+}
+
 export { NotificationCore, WCS_NOTIFY_ERROR_CODE, WcsNotify, bootstrapNotification, getConfig };
 export type { IWritableConfig, IWritableTagNames, NotificationPermissionRaw, NotifyBackend, NotifyOptions, PermissionStateOrUnsupported, WcsIoErrorInfo, WcsIoErrorPhase, WcsNotifyClickDetail, WcsNotifyCommands, WcsNotifyCoreCommands, WcsNotifyCoreValues, WcsNotifyErrorDetail, WcsNotifyInputs, WcsNotifySwMessage, WcsNotifyValues };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wcstack/notification",
-  "version": "1.31.0",
+  "version": "1.33.0",
   "description": "Declarative desktop-notification component for Web Components. Framework-agnostic Notifications API wrapper via wc-bindable-protocol, with Service Worker support.",
   "type": "module",
   "main": "./dist/index.esm.js",