cursedbelt 5.70.0 → 5.71.0

package/dist/react/notifications/binding.d.ts

@@ -39,8 +39,13 @@ export interface NotificationsBinding {
  * transport feeding rows in, and the store's config hooks pushing
  * read/dismiss back out.
  *
- *   const { store } = createNotificationsBinding();
- *   <NotificationBell store={store} />
+ *   const binding = useNotificationsBinding();   // in a component — never during render
+ *   if (binding) return <NotificationBell store={binding.store} />;
+ *
+ * 🔴 This function CONNECTS when called, so a component must not call it while
+ * rendering: React discards renders, and each discarded one would leak an open
+ * stream. {@link useNotificationsBinding} builds it in an effect and disposes it
+ * on unmount; call this directly only outside React, or as a page-long singleton.
  *
  * ── The one asymmetry worth knowing ─────────────────────────────────────────
  * Rows flow IN through the transport; acknowledgments flow OUT through these

package/dist/react/notifications/binding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../src/react/notifications/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAGpG,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,uBAAuB,EAA8B,MAAM,oBAAoB,CAAC;AAE9F;;gFAEgF;AAChF,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,GAC9D,4BAA4B,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,8BAA8B,CAAC;IACtC,qFAAqF;IACrF,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC1C,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,0BAA0B,CAAC;IACnC;oEACgE;IAChE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA4BtB"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../src/react/notifications/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAGpG,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,uBAAuB,EAA8B,MAAM,oBAAoB,CAAC;AAE9F;;gFAEgF;AAChF,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,GAC9D,4BAA4B,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,8BAA8B,CAAC;IACtC,qFAAqF;IACrF,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC1C,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,0BAA0B,CAAC;IACnC;oEACgE;IAChE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CA4BtB"}

package/dist/react/notifications/binding.js

@@ -7,8 +7,13 @@ import { notifyNotificationsChanged } from './pollTransport.js';
  * transport feeding rows in, and the store's config hooks pushing
  * read/dismiss back out.
  *
- *   const { store } = createNotificationsBinding();
- *   <NotificationBell store={store} />
+ *   const binding = useNotificationsBinding();   // in a component — never during render
+ *   if (binding) return <NotificationBell store={binding.store} />;
+ *
+ * 🔴 This function CONNECTS when called, so a component must not call it while
+ * rendering: React discards renders, and each discarded one would leak an open
+ * stream. {@link useNotificationsBinding} builds it in an effect and disposes it
+ * on unmount; call this directly only outside React, or as a page-long singleton.
  *
  * ── The one asymmetry worth knowing ─────────────────────────────────────────
  * Rows flow IN through the transport; acknowledgments flow OUT through these

package/dist/react/notifications/binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../src/react/notifications/binding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,uBAAuB,GAIxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAgC,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAoC9F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAuC,EAAE;IAEzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAElH,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,IAAsB,EAAQ,EAAE;QAC3D,KAAK,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/F,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,uBAAuB,CAAC;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACzE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;KAC/D,CAAC,CAAC;IAEH,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;QACjB,kCAAkC,CAAC,MAAM,EAAE;YACzC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SAC3C,CAAC,CAAC;IAEL,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../../src/react/notifications/binding.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,kCAAkC,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,uBAAuB,GAIxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAgC,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAoC9F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAuC,EAAE;IAEzC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IAElH,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,IAAsB,EAAQ,EAAE;QAC3D,KAAK,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/F,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,uBAAuB,CAAC;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACzE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;KAC/D,CAAC,CAAC;IAEH,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;QACjB,kCAAkC,CAAC,MAAM,EAAE;YACzC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SAC3C,CAAC,CAAC;IAEL,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE7D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/react/notifications/index.d.ts

@@ -7,4 +7,5 @@ export { NotificationFeed, type NotificationFeedProps } from './NotificationFeed
 export { NotificationInbox, type NotificationInboxProps } from './NotificationInbox.js';
 export { createNotificationsPollTransport, NOTIFICATIONS_CHANGED_EVENT, type NotificationsListClient, type NotificationsPollTransportOptions, notifyNotificationsChanged, } from './pollTransport.js';
 export { createNotificationStore, type NotificationAction, type NotificationItem, type NotificationPushInput, type NotificationState, type NotificationStore, type NotificationStoreConfig, type NotificationTone, type NotificationTransport, type NotificationTransportSync, useNotificationStore, } from './notificationStore.js';
+export { useNotificationsBinding } from './useNotificationsBinding.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,GAClC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,KAAK,mCAAmC,GACzC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,GAClC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kCAAkC,EAClC,iBAAiB,EACjB,KAAK,mCAAmC,GACzC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/react/notifications/index.js

@@ -7,4 +7,5 @@ export { NotificationFeed } from './NotificationFeed.js';
 export { NotificationInbox } from './NotificationInbox.js';
 export { createNotificationsPollTransport, NOTIFICATIONS_CHANGED_EVENT, notifyNotificationsChanged, } from './pollTransport.js';
 export { createNotificationStore, useNotificationStore, } from './notificationStore.js';
+export { useNotificationsBinding } from './useNotificationsBinding.js';
 //# sourceMappingURL=index.js.map

package/dist/react/notifications/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,0BAA0B,GAI3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,GAIvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kCAAkC,EAClC,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAA8B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAA8B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAA+B,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAG3B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EAUvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EACL,0BAA0B,GAI3B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,GAIvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kCAAkC,EAClC,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAA8B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAA8B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAA+B,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,gCAAgC,EAChC,2BAA2B,EAG3B,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EAUvB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/react/notifications/useNotificationsBinding.d.ts

@@ -0,0 +1,24 @@
+import { type NotificationsBinding, type NotificationsBindingOptions } from './binding.js';
+/**
+ * The React way to hold a {@link createNotificationsBinding}: built when the
+ * component COMMITS, disposed when it unmounts, `null` until then.
+ *
+ *   const binding = useNotificationsBinding();
+ *   if (!binding) return <span aria-hidden className={BELL_BOX} />;
+ *   return <NotificationBell store={binding.store} />;
+ *
+ * 🔴 **Why this is a hook and not a `useMemo`.** `createNotificationsBinding`
+ * opens its stream (an EventSource plus a poll loop) the moment it is called,
+ * and React renders components it then throws away — a sibling suspending, an
+ * abandoned concurrent render, StrictMode's double render. Built during render,
+ * every discarded render left a stream open with nobody holding its `dispose`:
+ * panning family's tree leaked eight, six filled Chromium's per-host pool, and
+ * every later request on the page hung (forge task 2945). An effect only runs
+ * for a render React kept, and its cleanup is the dispose.
+ *
+ * `options` are read ONCE, when the binding is built — like `useState`'s
+ * initial value. A new object every render does not rebuild it; a callback in
+ * them should read changing state through a ref.
+ */
+export declare function useNotificationsBinding(options?: NotificationsBindingOptions): NotificationsBinding | null;
+//# sourceMappingURL=useNotificationsBinding.d.ts.map

package/dist/react/notifications/useNotificationsBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotificationsBinding.d.ts","sourceRoot":"","sources":["../../../src/react/notifications/useNotificationsBinding.ts"],"names":[],"mappings":"AACA,OAAO,EAA8B,KAAK,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEvH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,oBAAoB,GAAG,IAAI,CAU1G"}

package/dist/react/notifications/useNotificationsBinding.js

@@ -0,0 +1,35 @@
+import { useEffect, useRef, useState } from 'react';
+import { createNotificationsBinding } from './binding.js';
+/**
+ * The React way to hold a {@link createNotificationsBinding}: built when the
+ * component COMMITS, disposed when it unmounts, `null` until then.
+ *
+ *   const binding = useNotificationsBinding();
+ *   if (!binding) return <span aria-hidden className={BELL_BOX} />;
+ *   return <NotificationBell store={binding.store} />;
+ *
+ * 🔴 **Why this is a hook and not a `useMemo`.** `createNotificationsBinding`
+ * opens its stream (an EventSource plus a poll loop) the moment it is called,
+ * and React renders components it then throws away — a sibling suspending, an
+ * abandoned concurrent render, StrictMode's double render. Built during render,
+ * every discarded render left a stream open with nobody holding its `dispose`:
+ * panning family's tree leaked eight, six filled Chromium's per-host pool, and
+ * every later request on the page hung (forge task 2945). An effect only runs
+ * for a render React kept, and its cleanup is the dispose.
+ *
+ * `options` are read ONCE, when the binding is built — like `useState`'s
+ * initial value. A new object every render does not rebuild it; a callback in
+ * them should read changing state through a ref.
+ */
+export function useNotificationsBinding(options) {
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const [binding, setBinding] = useState(null);
+    useEffect(() => {
+        const next = createNotificationsBinding(optionsRef.current);
+        setBinding(next);
+        return next.dispose;
+    }, []);
+    return binding;
+}
+//# sourceMappingURL=useNotificationsBinding.js.map

package/dist/react/notifications/useNotificationsBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNotificationsBinding.js","sourceRoot":"","sources":["../../../src/react/notifications/useNotificationsBinding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAA+D,MAAM,cAAc,CAAC;AAEvH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAqC;IAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAA8B,IAAI,CAAC,CAAC;IAC1E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,0BAA0B,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5D,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt",
-	"version": "5.70.0",
+	"version": "5.71.0",
 	"license": "ISC",
 	"type": "module",
 	"description": "The React design system of the cursedbelt split — components, styles, theme. cursedbelt-core below it; server tier in cursedbelt-server.",

package/src/react/notifications/binding.ts

@@ -49,8 +49,13 @@ export interface NotificationsBinding {
  * transport feeding rows in, and the store's config hooks pushing
  * read/dismiss back out.
  *
- *   const { store } = createNotificationsBinding();
- *   <NotificationBell store={store} />
+ *   const binding = useNotificationsBinding();   // in a component — never during render
+ *   if (binding) return <NotificationBell store={binding.store} />;
+ *
+ * 🔴 This function CONNECTS when called, so a component must not call it while
+ * rendering: React discards renders, and each discarded one would leak an open
+ * stream. {@link useNotificationsBinding} builds it in an effect and disposes it
+ * on unmount; call this directly only outside React, or as a page-long singleton.
  *
  * ── The one asymmetry worth knowing ─────────────────────────────────────────
  * Rows flow IN through the transport; acknowledgments flow OUT through these

package/src/react/notifications/index.ts

@@ -40,3 +40,4 @@ export {
   type NotificationTransportSync,
   useNotificationStore,
 } from './notificationStore.js';
+export { useNotificationsBinding } from './useNotificationsBinding.js';

package/src/react/notifications/useNotificationsBinding.spec.tsx

@@ -0,0 +1,107 @@
+import { afterEach, describe, expect, test } from 'bun:test';
+import { act, cleanup, render } from '@testing-library/react';
+import { StrictMode, Suspense } from 'react';
+import type { NotificationsBindingClient } from './binding.js';
+import type { NotificationTransport } from './notificationStore.js';
+import { useNotificationsBinding } from './useNotificationsBinding.js';
+
+afterEach(cleanup);
+
+const client = {
+  queries: { list: async () => ({ items: [], hasMore: false }) },
+  mutations: {
+    markRead: async () => ({ changed: true }),
+    markAllRead: async () => ({ changed: 1 }),
+    setDone: async () => ({ changed: true }),
+    doneAll: async () => ({ changed: 1 }),
+    remove: async () => ({ changed: true }),
+  },
+} as unknown as NotificationsBindingClient;
+
+/** An inert transport that counts what it opened and what was closed — the
+ *  stand-in for the EventSource a leaked binding leaves holding a connection. */
+function countingTransport() {
+  const counts = { connects: 0, disposes: 0 };
+  const transport: NotificationTransport = {
+    connect: () => {
+      counts.connects += 1;
+      return () => {
+        counts.disposes += 1;
+      };
+    },
+  };
+  return { counts, transport, open: () => counts.connects - counts.disposes };
+}
+
+function Bell({ transport }: { transport: NotificationTransport }) {
+  const binding = useNotificationsBinding({ client, transport });
+  return <output>{binding ? 'bound' : 'pending'}</output>;
+}
+
+/** Suspends its first `times` renders, then renders nothing — the lazy
+ *  switcher next to family's bell that made React discard the bell's render. */
+function suspender(times: number) {
+  let left = times;
+  let release: () => void = () => {};
+  function Sibling(): null {
+    if (left > 0) {
+      throw new Promise<void>((resolve) => {
+        release = () => {
+          left -= 1;
+          resolve();
+        };
+      });
+    }
+    return null;
+  }
+  return { Sibling, release: () => release() };
+}
+
+describe('useNotificationsBinding', () => {
+  test('🔴 a render React throws away opens no stream — one binding, and it closes on unmount', async () => {
+    const { counts, transport, open } = countingTransport();
+    const { Sibling, release } = suspender(3);
+    const view = render(
+      <Suspense fallback={<span>loading</span>}>
+        <Bell transport={transport} />
+        <Sibling />
+      </Suspense>,
+    );
+    for (let retry = 0; retry < 3; retry += 1) {
+      await act(async () => {
+        release();
+        await Promise.resolve();
+      });
+    }
+
+    expect(view.getByText('bound')).toBeTruthy();
+    expect(counts.connects).toBe(1);
+    expect(open()).toBe(1);
+
+    view.unmount();
+    expect(open()).toBe(0);
+  });
+
+  test('StrictMode mounts twice and still leaves exactly one stream open', async () => {
+    const { transport, open } = countingTransport();
+    const view = render(
+      <StrictMode>
+        <Bell transport={transport} />
+      </StrictMode>,
+    );
+    await act(async () => {});
+    expect(view.getByText('bound')).toBeTruthy();
+    expect(open()).toBe(1);
+    view.unmount();
+    expect(open()).toBe(0);
+  });
+
+  test('a re-render with new options does not rebuild the binding', async () => {
+    const { counts, transport } = countingTransport();
+    const view = render(<Bell transport={transport} />);
+    await act(async () => {});
+    view.rerender(<Bell transport={transport} />);
+    await act(async () => {});
+    expect(counts.connects).toBe(1);
+  });
+});

package/src/react/notifications/useNotificationsBinding.ts

@@ -0,0 +1,35 @@
+import { useEffect, useRef, useState } from 'react';
+import { createNotificationsBinding, type NotificationsBinding, type NotificationsBindingOptions } from './binding.js';
+
+/**
+ * The React way to hold a {@link createNotificationsBinding}: built when the
+ * component COMMITS, disposed when it unmounts, `null` until then.
+ *
+ *   const binding = useNotificationsBinding();
+ *   if (!binding) return <span aria-hidden className={BELL_BOX} />;
+ *   return <NotificationBell store={binding.store} />;
+ *
+ * 🔴 **Why this is a hook and not a `useMemo`.** `createNotificationsBinding`
+ * opens its stream (an EventSource plus a poll loop) the moment it is called,
+ * and React renders components it then throws away — a sibling suspending, an
+ * abandoned concurrent render, StrictMode's double render. Built during render,
+ * every discarded render left a stream open with nobody holding its `dispose`:
+ * panning family's tree leaked eight, six filled Chromium's per-host pool, and
+ * every later request on the page hung (forge task 2945). An effect only runs
+ * for a render React kept, and its cleanup is the dispose.
+ *
+ * `options` are read ONCE, when the binding is built — like `useState`'s
+ * initial value. A new object every render does not rebuild it; a callback in
+ * them should read changing state through a ref.
+ */
+export function useNotificationsBinding(options?: NotificationsBindingOptions): NotificationsBinding | null {
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const [binding, setBinding] = useState<NotificationsBinding | null>(null);
+  useEffect(() => {
+    const next = createNotificationsBinding(optionsRef.current);
+    setBinding(next);
+    return next.dispose;
+  }, []);
+  return binding;
+}