@xyo-network/react-event 2.78.0 → 2.78.1

package/dist/browser/index.cjs

@@ -1,2 +1,78 @@
-"use strict";var u=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var d=(t,e)=>{for(var o in e)u(t,o,{get:e[o],enumerable:!0})},f=(t,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of m(e))!D.call(t,a)&&a!==o&&u(t,a,{get:()=>e[a],enumerable:!(r=b(e,a))||r.enumerable});return t};var l=t=>f(u({},"__esModule",{value:!0}),t);var N={};d(N,{useCustomEvent:()=>c,useEvent:()=>h});module.exports=l(N);var v=require("@xylabs/assert"),i=require("react"),c=(t,e,o)=>{let r=o??(0,i.createRef)();return(0,i.useEffect)(()=>{let n=r?.current,s=e,T=s?E=>{let p=(0,v.assertEx)(E.detail,()=>"Event missing detail");s(p)&&E.stopPropagation()}:void 0;return T&&n&&n?.addEventListener(t,T),()=>{T&&n&&n?.removeEventListener(t,T)}}),[r,n=>{let s=new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!0,detail:n});r.current?.dispatchEvent(s)}]};var h=(t,e)=>{let[o,r]=c("xyo",t?n=>t(n.noun,n.verb,n.data):void 0,e);return[o,(n,s,T)=>r({data:T,noun:n,verb:s})]};
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  useCustomEvent: () => useCustomEvent,
+  useEvent: () => useEvent
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/hooks/useCustomEvent.ts
+var import_assert = require("@xylabs/assert");
+var import_react = require("react");
+var useCustomEvent = (type, listener, customRef) => {
+  const ref = customRef ?? (0, import_react.createRef)();
+  (0, import_react.useEffect)(() => {
+    const element = ref?.current;
+    const currentListener = listener;
+    const handler = currentListener ? (event) => {
+      const detail = (0, import_assert.assertEx)(event.detail, () => "Event missing detail");
+      const stop = currentListener(detail);
+      if (stop) {
+        event.stopPropagation();
+      }
+    } : void 0;
+    if (handler && element) {
+      element?.addEventListener(type, handler);
+    }
+    return () => {
+      if (handler && element) {
+        element?.removeEventListener(type, handler);
+      }
+    };
+  });
+  const dispatch = (detail) => {
+    const event = new CustomEvent(type, {
+      bubbles: true,
+      cancelable: true,
+      composed: true,
+      detail
+    });
+    ref.current?.dispatchEvent(event);
+  };
+  return [ref, dispatch];
+};
+
+// src/hooks/useEvent.ts
+var useEvent = (listener, sharableRef) => {
+  const [ref, customDispatch] = useCustomEvent(
+    "xyo",
+    listener ? (detail) => {
+      return listener(detail.noun, detail.verb, detail.data);
+    } : void 0,
+    sharableRef
+  );
+  const dispatch = (noun, verb, data) => {
+    return customDispatch({ data, noun, verb });
+  };
+  return [ref, dispatch];
+};
 //# sourceMappingURL=index.cjs.map

package/dist/browser/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["export * from './hooks'\n","import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,oBAAAE,EAAA,aAAAC,IAAA,eAAAC,EAAAJ,GCAA,IAAAK,EAAyB,0BACzBC,EAAgD,iBAInCC,EAAiB,CAC5BC,EACAC,EACAC,IACwD,CACxD,IAAMC,EAAMD,MAAa,aAAoB,EAC7C,sBAAU,IAAM,CACd,IAAME,EAAUD,GAAK,QACfE,EAAkBJ,EAClBK,EACJD,EACGE,GAA4C,CAC3C,IAAMC,KAAS,YAASD,EAAM,OAAQ,IAAM,sBAAsB,EACrDF,EAAgBG,CAAM,GAEjCD,EAAM,gBAAgB,CAE1B,EACA,OAEJ,OAAID,GAAWF,GACbA,GAAS,iBAAiBJ,EAAMM,CAAO,EAElC,IAAM,CACPA,GAAWF,GACbA,GAAS,oBAAoBJ,EAAMM,CAAO,CAE9C,CACF,CAAC,EAUM,CAACH,EATwCK,GAAqB,CACnE,IAAMD,EAAQ,IAAI,YAAqBP,EAAM,CAC3C,QAAS,GACT,WAAY,GACZ,SAAU,GACV,OAAAQ,CACF,CAAC,EACDL,EAAI,SAAS,cAAcI,CAAK,CAClC,CACqB,CACvB,EC7BO,IAAME,EAAW,CACtBC,EACAC,IACuD,CACvD,GAAM,CAACC,EAAKC,CAAc,EAAIC,EAC5B,MACAJ,EACGK,GACQL,EAASK,EAAO,KAAMA,EAAO,KAAMA,EAAO,IAAI,EAEvD,OACFJ,CACF,EAKA,MAAO,CAACC,EAH6C,CAACI,EAAaC,EAAaC,IACvEL,EAAe,CAAE,KAAAK,EAAM,KAAAF,EAAM,KAAAC,CAAK,CAAC,CAEvB,CACvB","names":["src_exports","__export","useCustomEvent","useEvent","__toCommonJS","import_assert","import_react","useCustomEvent","type","listener","customRef","ref","element","currentListener","handler","event","detail","useEvent","listener","sharableRef","ref","customDispatch","useCustomEvent","detail","noun","verb","data"]}
+{"version":3,"sources":["../../src/index.ts","../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["export * from './hooks'\n","import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAyB;AACzB,mBAAgD;AAIzC,IAAM,iBAAiB,CAC5B,MACA,UACA,cACwD;AACxD,QAAM,MAAM,iBAAa,wBAAoB;AAC7C,8BAAU,MAAM;AACd,UAAM,UAAU,KAAK;AACrB,UAAM,kBAAkB;AACxB,UAAM,UACJ,kBACE,CAAC,UAA4C;AAC3C,YAAM,aAAS,wBAAS,MAAM,QAAQ,MAAM,sBAAsB;AAClE,YAAM,OAAO,gBAAgB,MAAM;AACnC,UAAI,MAAM;AACR,cAAM,gBAAgB;AAAA,MACxB;AAAA,IACF,IACA;AAEJ,QAAI,WAAW,SAAS;AACtB,eAAS,iBAAiB,MAAM,OAAO;AAAA,IACzC;AACA,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,iBAAS,oBAAoB,MAAM,OAAO;AAAA,MAC5C;AAAA,IACF;AAAA,EACF,CAAC;AACD,QAAM,WAAyC,CAAC,WAAqB;AACnE,UAAM,QAAQ,IAAI,YAAqB,MAAM;AAAA,MAC3C,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,QAAI,SAAS,cAAc,KAAK;AAAA,EAClC;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;;;AC7BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACE,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAA+C,CAAC,MAAa,MAAa,SAAiB;AAC/F,WAAO,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,EAC5C;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;","names":[]}

package/dist/browser/index.js

@@ -1,2 +1,55 @@
-import{assertEx as E}from"@xylabs/assert";import{createRef as v,useEffect as p}from"react";var i=(e,a,s)=>{let r=s??v();return p(()=>{let t=r?.current,n=a,o=n?T=>{let c=E(T.detail,()=>"Event missing detail");n(c)&&T.stopPropagation()}:void 0;return o&&t&&t?.addEventListener(e,o),()=>{o&&t&&t?.removeEventListener(e,o)}}),[r,t=>{let n=new CustomEvent(e,{bubbles:!0,cancelable:!0,composed:!0,detail:t});r.current?.dispatchEvent(n)}]};var h=(e,a)=>{let[s,r]=i("xyo",e?t=>e(t.noun,t.verb,t.data):void 0,a);return[s,(t,n,o)=>r({data:o,noun:t,verb:n})]};export{i as useCustomEvent,h as useEvent};
+// src/hooks/useCustomEvent.ts
+import { assertEx } from "@xylabs/assert";
+import { createRef, useEffect } from "react";
+var useCustomEvent = (type, listener, customRef) => {
+  const ref = customRef ?? createRef();
+  useEffect(() => {
+    const element = ref?.current;
+    const currentListener = listener;
+    const handler = currentListener ? (event) => {
+      const detail = assertEx(event.detail, () => "Event missing detail");
+      const stop = currentListener(detail);
+      if (stop) {
+        event.stopPropagation();
+      }
+    } : void 0;
+    if (handler && element) {
+      element?.addEventListener(type, handler);
+    }
+    return () => {
+      if (handler && element) {
+        element?.removeEventListener(type, handler);
+      }
+    };
+  });
+  const dispatch = (detail) => {
+    const event = new CustomEvent(type, {
+      bubbles: true,
+      cancelable: true,
+      composed: true,
+      detail
+    });
+    ref.current?.dispatchEvent(event);
+  };
+  return [ref, dispatch];
+};
+
+// src/hooks/useEvent.ts
+var useEvent = (listener, sharableRef) => {
+  const [ref, customDispatch] = useCustomEvent(
+    "xyo",
+    listener ? (detail) => {
+      return listener(detail.noun, detail.verb, detail.data);
+    } : void 0,
+    sharableRef
+  );
+  const dispatch = (noun, verb, data) => {
+    return customDispatch({ data, noun, verb });
+  };
+  return [ref, dispatch];
+};
+export {
+  useCustomEvent,
+  useEvent
+};
 //# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":"AAAA,OAAS,YAAAA,MAAgB,iBACzB,OAAS,aAAAC,EAAsB,aAAAC,MAAiB,QAIzC,IAAMC,EAAiB,CAC5BC,EACAC,EACAC,IACwD,CACxD,IAAMC,EAAMD,GAAaL,EAAoB,EAC7C,OAAAC,EAAU,IAAM,CACd,IAAMM,EAAUD,GAAK,QACfE,EAAkBJ,EAClBK,EACJD,EACGE,GAA4C,CAC3C,IAAMC,EAASZ,EAASW,EAAM,OAAQ,IAAM,sBAAsB,EACrDF,EAAgBG,CAAM,GAEjCD,EAAM,gBAAgB,CAE1B,EACA,OAEJ,OAAID,GAAWF,GACbA,GAAS,iBAAiBJ,EAAMM,CAAO,EAElC,IAAM,CACPA,GAAWF,GACbA,GAAS,oBAAoBJ,EAAMM,CAAO,CAE9C,CACF,CAAC,EAUM,CAACH,EATwCK,GAAqB,CACnE,IAAMD,EAAQ,IAAI,YAAqBP,EAAM,CAC3C,QAAS,GACT,WAAY,GACZ,SAAU,GACV,OAAAQ,CACF,CAAC,EACDL,EAAI,SAAS,cAAcI,CAAK,CAClC,CACqB,CACvB,EC7BO,IAAME,EAAW,CACtBC,EACAC,IACuD,CACvD,GAAM,CAACC,EAAKC,CAAc,EAAIC,EAC5B,MACAJ,EACGK,GACQL,EAASK,EAAO,KAAMA,EAAO,KAAMA,EAAO,IAAI,EAEvD,OACFJ,CACF,EAKA,MAAO,CAACC,EAH6C,CAACI,EAAaC,EAAaC,IACvEL,EAAe,CAAE,KAAAK,EAAM,KAAAF,EAAM,KAAAC,CAAK,CAAC,CAEvB,CACvB","names":["assertEx","createRef","useEffect","useCustomEvent","type","listener","customRef","ref","element","currentListener","handler","event","detail","useEvent","listener","sharableRef","ref","customDispatch","useCustomEvent","detail","noun","verb","data"]}
+{"version":3,"sources":["../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,WAAsB,iBAAiB;AAIzC,IAAM,iBAAiB,CAC5B,MACA,UACA,cACwD;AACxD,QAAM,MAAM,aAAa,UAAoB;AAC7C,YAAU,MAAM;AACd,UAAM,UAAU,KAAK;AACrB,UAAM,kBAAkB;AACxB,UAAM,UACJ,kBACE,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,MAAM,sBAAsB;AAClE,YAAM,OAAO,gBAAgB,MAAM;AACnC,UAAI,MAAM;AACR,cAAM,gBAAgB;AAAA,MACxB;AAAA,IACF,IACA;AAEJ,QAAI,WAAW,SAAS;AACtB,eAAS,iBAAiB,MAAM,OAAO;AAAA,IACzC;AACA,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,iBAAS,oBAAoB,MAAM,OAAO;AAAA,MAC5C;AAAA,IACF;AAAA,EACF,CAAC;AACD,QAAM,WAAyC,CAAC,WAAqB;AACnE,UAAM,QAAQ,IAAI,YAAqB,MAAM;AAAA,MAC3C,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,QAAI,SAAS,cAAc,KAAK;AAAA,EAClC;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;;;AC7BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACE,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAA+C,CAAC,MAAa,MAAa,SAAiB;AAC/F,WAAO,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,EAC5C;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;","names":[]}

package/dist/neutral/index.cjs

@@ -1,2 +1,78 @@
-"use strict";var u=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var d=(t,e)=>{for(var o in e)u(t,o,{get:e[o],enumerable:!0})},f=(t,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of m(e))!D.call(t,a)&&a!==o&&u(t,a,{get:()=>e[a],enumerable:!(r=b(e,a))||r.enumerable});return t};var l=t=>f(u({},"__esModule",{value:!0}),t);var N={};d(N,{useCustomEvent:()=>c,useEvent:()=>h});module.exports=l(N);var v=require("@xylabs/assert"),i=require("react"),c=(t,e,o)=>{let r=o??(0,i.createRef)();return(0,i.useEffect)(()=>{let n=r?.current,s=e,T=s?E=>{let p=(0,v.assertEx)(E.detail,()=>"Event missing detail");s(p)&&E.stopPropagation()}:void 0;return T&&n&&n?.addEventListener(t,T),()=>{T&&n&&n?.removeEventListener(t,T)}}),[r,n=>{let s=new CustomEvent(t,{bubbles:!0,cancelable:!0,composed:!0,detail:n});r.current?.dispatchEvent(s)}]};var h=(t,e)=>{let[o,r]=c("xyo",t?n=>t(n.noun,n.verb,n.data):void 0,e);return[o,(n,s,T)=>r({data:T,noun:n,verb:s})]};
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  useCustomEvent: () => useCustomEvent,
+  useEvent: () => useEvent
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/hooks/useCustomEvent.ts
+var import_assert = require("@xylabs/assert");
+var import_react = require("react");
+var useCustomEvent = (type, listener, customRef) => {
+  const ref = customRef ?? (0, import_react.createRef)();
+  (0, import_react.useEffect)(() => {
+    const element = ref?.current;
+    const currentListener = listener;
+    const handler = currentListener ? (event) => {
+      const detail = (0, import_assert.assertEx)(event.detail, () => "Event missing detail");
+      const stop = currentListener(detail);
+      if (stop) {
+        event.stopPropagation();
+      }
+    } : void 0;
+    if (handler && element) {
+      element?.addEventListener(type, handler);
+    }
+    return () => {
+      if (handler && element) {
+        element?.removeEventListener(type, handler);
+      }
+    };
+  });
+  const dispatch = (detail) => {
+    const event = new CustomEvent(type, {
+      bubbles: true,
+      cancelable: true,
+      composed: true,
+      detail
+    });
+    ref.current?.dispatchEvent(event);
+  };
+  return [ref, dispatch];
+};
+
+// src/hooks/useEvent.ts
+var useEvent = (listener, sharableRef) => {
+  const [ref, customDispatch] = useCustomEvent(
+    "xyo",
+    listener ? (detail) => {
+      return listener(detail.noun, detail.verb, detail.data);
+    } : void 0,
+    sharableRef
+  );
+  const dispatch = (noun, verb, data) => {
+    return customDispatch({ data, noun, verb });
+  };
+  return [ref, dispatch];
+};
 //# sourceMappingURL=index.cjs.map

package/dist/neutral/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["export * from './hooks'\n","import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,oBAAAE,EAAA,aAAAC,IAAA,eAAAC,EAAAJ,GCAA,IAAAK,EAAyB,0BACzBC,EAAgD,iBAInCC,EAAiB,CAC5BC,EACAC,EACAC,IACwD,CACxD,IAAMC,EAAMD,MAAa,aAAoB,EAC7C,sBAAU,IAAM,CACd,IAAME,EAAUD,GAAK,QACfE,EAAkBJ,EAClBK,EACJD,EACGE,GAA4C,CAC3C,IAAMC,KAAS,YAASD,EAAM,OAAQ,IAAM,sBAAsB,EACrDF,EAAgBG,CAAM,GAEjCD,EAAM,gBAAgB,CAE1B,EACA,OAEJ,OAAID,GAAWF,GACbA,GAAS,iBAAiBJ,EAAMM,CAAO,EAElC,IAAM,CACPA,GAAWF,GACbA,GAAS,oBAAoBJ,EAAMM,CAAO,CAE9C,CACF,CAAC,EAUM,CAACH,EATwCK,GAAqB,CACnE,IAAMD,EAAQ,IAAI,YAAqBP,EAAM,CAC3C,QAAS,GACT,WAAY,GACZ,SAAU,GACV,OAAAQ,CACF,CAAC,EACDL,EAAI,SAAS,cAAcI,CAAK,CAClC,CACqB,CACvB,EC7BO,IAAME,EAAW,CACtBC,EACAC,IACuD,CACvD,GAAM,CAACC,EAAKC,CAAc,EAAIC,EAC5B,MACAJ,EACGK,GACQL,EAASK,EAAO,KAAMA,EAAO,KAAMA,EAAO,IAAI,EAEvD,OACFJ,CACF,EAKA,MAAO,CAACC,EAH6C,CAACI,EAAaC,EAAaC,IACvEL,EAAe,CAAE,KAAAK,EAAM,KAAAF,EAAM,KAAAC,CAAK,CAAC,CAEvB,CACvB","names":["src_exports","__export","useCustomEvent","useEvent","__toCommonJS","import_assert","import_react","useCustomEvent","type","listener","customRef","ref","element","currentListener","handler","event","detail","useEvent","listener","sharableRef","ref","customDispatch","useCustomEvent","detail","noun","verb","data"]}
+{"version":3,"sources":["../../src/index.ts","../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["export * from './hooks'\n","import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAyB;AACzB,mBAAgD;AAIzC,IAAM,iBAAiB,CAC5B,MACA,UACA,cACwD;AACxD,QAAM,MAAM,iBAAa,wBAAoB;AAC7C,8BAAU,MAAM;AACd,UAAM,UAAU,KAAK;AACrB,UAAM,kBAAkB;AACxB,UAAM,UACJ,kBACE,CAAC,UAA4C;AAC3C,YAAM,aAAS,wBAAS,MAAM,QAAQ,MAAM,sBAAsB;AAClE,YAAM,OAAO,gBAAgB,MAAM;AACnC,UAAI,MAAM;AACR,cAAM,gBAAgB;AAAA,MACxB;AAAA,IACF,IACA;AAEJ,QAAI,WAAW,SAAS;AACtB,eAAS,iBAAiB,MAAM,OAAO;AAAA,IACzC;AACA,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,iBAAS,oBAAoB,MAAM,OAAO;AAAA,MAC5C;AAAA,IACF;AAAA,EACF,CAAC;AACD,QAAM,WAAyC,CAAC,WAAqB;AACnE,UAAM,QAAQ,IAAI,YAAqB,MAAM;AAAA,MAC3C,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,QAAI,SAAS,cAAc,KAAK;AAAA,EAClC;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;;;AC7BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACE,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAA+C,CAAC,MAAa,MAAa,SAAiB;AAC/F,WAAO,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,EAC5C;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;","names":[]}

package/dist/neutral/index.js

@@ -1,2 +1,55 @@
-import{assertEx as E}from"@xylabs/assert";import{createRef as v,useEffect as p}from"react";var i=(e,a,s)=>{let r=s??v();return p(()=>{let t=r?.current,n=a,o=n?T=>{let c=E(T.detail,()=>"Event missing detail");n(c)&&T.stopPropagation()}:void 0;return o&&t&&t?.addEventListener(e,o),()=>{o&&t&&t?.removeEventListener(e,o)}}),[r,t=>{let n=new CustomEvent(e,{bubbles:!0,cancelable:!0,composed:!0,detail:t});r.current?.dispatchEvent(n)}]};var h=(e,a)=>{let[s,r]=i("xyo",e?t=>e(t.noun,t.verb,t.data):void 0,a);return[s,(t,n,o)=>r({data:o,noun:t,verb:n})]};export{i as useCustomEvent,h as useEvent};
+// src/hooks/useCustomEvent.ts
+import { assertEx } from "@xylabs/assert";
+import { createRef, useEffect } from "react";
+var useCustomEvent = (type, listener, customRef) => {
+  const ref = customRef ?? createRef();
+  useEffect(() => {
+    const element = ref?.current;
+    const currentListener = listener;
+    const handler = currentListener ? (event) => {
+      const detail = assertEx(event.detail, () => "Event missing detail");
+      const stop = currentListener(detail);
+      if (stop) {
+        event.stopPropagation();
+      }
+    } : void 0;
+    if (handler && element) {
+      element?.addEventListener(type, handler);
+    }
+    return () => {
+      if (handler && element) {
+        element?.removeEventListener(type, handler);
+      }
+    };
+  });
+  const dispatch = (detail) => {
+    const event = new CustomEvent(type, {
+      bubbles: true,
+      cancelable: true,
+      composed: true,
+      detail
+    });
+    ref.current?.dispatchEvent(event);
+  };
+  return [ref, dispatch];
+};
+
+// src/hooks/useEvent.ts
+var useEvent = (listener, sharableRef) => {
+  const [ref, customDispatch] = useCustomEvent(
+    "xyo",
+    listener ? (detail) => {
+      return listener(detail.noun, detail.verb, detail.data);
+    } : void 0,
+    sharableRef
+  );
+  const dispatch = (noun, verb, data) => {
+    return customDispatch({ data, noun, verb });
+  };
+  return [ref, dispatch];
+};
+export {
+  useCustomEvent,
+  useEvent
+};
 //# sourceMappingURL=index.js.map

package/dist/neutral/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":"AAAA,OAAS,YAAAA,MAAgB,iBACzB,OAAS,aAAAC,EAAsB,aAAAC,MAAiB,QAIzC,IAAMC,EAAiB,CAC5BC,EACAC,EACAC,IACwD,CACxD,IAAMC,EAAMD,GAAaL,EAAoB,EAC7C,OAAAC,EAAU,IAAM,CACd,IAAMM,EAAUD,GAAK,QACfE,EAAkBJ,EAClBK,EACJD,EACGE,GAA4C,CAC3C,IAAMC,EAASZ,EAASW,EAAM,OAAQ,IAAM,sBAAsB,EACrDF,EAAgBG,CAAM,GAEjCD,EAAM,gBAAgB,CAE1B,EACA,OAEJ,OAAID,GAAWF,GACbA,GAAS,iBAAiBJ,EAAMM,CAAO,EAElC,IAAM,CACPA,GAAWF,GACbA,GAAS,oBAAoBJ,EAAMM,CAAO,CAE9C,CACF,CAAC,EAUM,CAACH,EATwCK,GAAqB,CACnE,IAAMD,EAAQ,IAAI,YAAqBP,EAAM,CAC3C,QAAS,GACT,WAAY,GACZ,SAAU,GACV,OAAAQ,CACF,CAAC,EACDL,EAAI,SAAS,cAAcI,CAAK,CAClC,CACqB,CACvB,EC7BO,IAAME,EAAW,CACtBC,EACAC,IACuD,CACvD,GAAM,CAACC,EAAKC,CAAc,EAAIC,EAC5B,MACAJ,EACGK,GACQL,EAASK,EAAO,KAAMA,EAAO,KAAMA,EAAO,IAAI,EAEvD,OACFJ,CACF,EAKA,MAAO,CAACC,EAH6C,CAACI,EAAaC,EAAaC,IACvEL,EAAe,CAAE,KAAAK,EAAM,KAAAF,EAAM,KAAAC,CAAK,CAAC,CAEvB,CACvB","names":["assertEx","createRef","useEffect","useCustomEvent","type","listener","customRef","ref","element","currentListener","handler","event","detail","useEvent","listener","sharableRef","ref","customDispatch","useCustomEvent","detail","noun","verb","data"]}
+{"version":3,"sources":["../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,WAAsB,iBAAiB;AAIzC,IAAM,iBAAiB,CAC5B,MACA,UACA,cACwD;AACxD,QAAM,MAAM,aAAa,UAAoB;AAC7C,YAAU,MAAM;AACd,UAAM,UAAU,KAAK;AACrB,UAAM,kBAAkB;AACxB,UAAM,UACJ,kBACE,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,MAAM,sBAAsB;AAClE,YAAM,OAAO,gBAAgB,MAAM;AACnC,UAAI,MAAM;AACR,cAAM,gBAAgB;AAAA,MACxB;AAAA,IACF,IACA;AAEJ,QAAI,WAAW,SAAS;AACtB,eAAS,iBAAiB,MAAM,OAAO;AAAA,IACzC;AACA,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,iBAAS,oBAAoB,MAAM,OAAO;AAAA,MAC5C;AAAA,IACF;AAAA,EACF,CAAC;AACD,QAAM,WAAyC,CAAC,WAAqB;AACnE,UAAM,QAAQ,IAAI,YAAqB,MAAM;AAAA,MAC3C,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,QAAI,SAAS,cAAc,KAAK;AAAA,EAClC;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;;;AC7BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACE,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAA+C,CAAC,MAAa,MAAa,SAAiB;AAC/F,WAAO,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,EAC5C;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;","names":[]}

package/dist/node/index.cjs

@@ -1,2 +1,84 @@
-"use strict";var u=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var D=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var m=(e,n)=>{for(var r in n)u(e,r,{get:n[r],enumerable:!0})},f=(e,n,r,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let s of D(n))!d.call(e,s)&&s!==r&&u(e,s,{get:()=>n[s],enumerable:!(o=b(n,s))||o.enumerable});return e};var l=e=>f(u({},"__esModule",{value:!0}),e);var N={};m(N,{useCustomEvent:()=>c,useEvent:()=>h});module.exports=l(N);var v=require("@xylabs/assert"),i=require("react"),c=(e,n,r)=>{let o=r??(0,i.createRef)();return(0,i.useEffect)(()=>{let t=o==null?void 0:o.current,T=n,a=T?E=>{let p=(0,v.assertEx)(E.detail,()=>"Event missing detail");T(p)&&E.stopPropagation()}:void 0;return a&&t&&(t==null||t.addEventListener(e,a)),()=>{a&&t&&(t==null||t.removeEventListener(e,a))}}),[o,t=>{var a;let T=new CustomEvent(e,{bubbles:!0,cancelable:!0,composed:!0,detail:t});(a=o.current)==null||a.dispatchEvent(T)}]};var h=(e,n)=>{let[r,o]=c("xyo",e?t=>e(t.noun,t.verb,t.data):void 0,n);return[r,(t,T,a)=>o({data:a,noun:t,verb:T})]};0&&(module.exports={useCustomEvent,useEvent});
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  useCustomEvent: () => useCustomEvent,
+  useEvent: () => useEvent
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/hooks/useCustomEvent.ts
+var import_assert = require("@xylabs/assert");
+var import_react = require("react");
+var useCustomEvent = (type, listener, customRef) => {
+  const ref = customRef ?? (0, import_react.createRef)();
+  (0, import_react.useEffect)(() => {
+    const element = ref == null ? void 0 : ref.current;
+    const currentListener = listener;
+    const handler = currentListener ? (event) => {
+      const detail = (0, import_assert.assertEx)(event.detail, () => "Event missing detail");
+      const stop = currentListener(detail);
+      if (stop) {
+        event.stopPropagation();
+      }
+    } : void 0;
+    if (handler && element) {
+      element == null ? void 0 : element.addEventListener(type, handler);
+    }
+    return () => {
+      if (handler && element) {
+        element == null ? void 0 : element.removeEventListener(type, handler);
+      }
+    };
+  });
+  const dispatch = (detail) => {
+    var _a;
+    const event = new CustomEvent(type, {
+      bubbles: true,
+      cancelable: true,
+      composed: true,
+      detail
+    });
+    (_a = ref.current) == null ? void 0 : _a.dispatchEvent(event);
+  };
+  return [ref, dispatch];
+};
+
+// src/hooks/useEvent.ts
+var useEvent = (listener, sharableRef) => {
+  const [ref, customDispatch] = useCustomEvent(
+    "xyo",
+    listener ? (detail) => {
+      return listener(detail.noun, detail.verb, detail.data);
+    } : void 0,
+    sharableRef
+  );
+  const dispatch = (noun, verb, data) => {
+    return customDispatch({ data, noun, verb });
+  };
+  return [ref, dispatch];
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCustomEvent,
+  useEvent
+});
 //# sourceMappingURL=index.cjs.map

package/dist/node/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["export * from './hooks'\n","import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,oBAAAE,EAAA,aAAAC,IAAA,eAAAC,EAAAJ,GCAA,IAAAK,EAAyB,0BACzBC,EAAgD,iBAInCC,EAAiB,CAC5BC,EACAC,EACAC,IACwD,CACxD,IAAMC,EAAMD,MAAa,aAAoB,EAC7C,sBAAU,IAAM,CACd,IAAME,EAAUD,GAAA,YAAAA,EAAK,QACfE,EAAkBJ,EAClBK,EACJD,EACGE,GAA4C,CAC3C,IAAMC,KAAS,YAASD,EAAM,OAAQ,IAAM,sBAAsB,EACrDF,EAAgBG,CAAM,GAEjCD,EAAM,gBAAgB,CAE1B,EACA,OAEJ,OAAID,GAAWF,IACbA,GAAA,MAAAA,EAAS,iBAAiBJ,EAAMM,IAE3B,IAAM,CACPA,GAAWF,IACbA,GAAA,MAAAA,EAAS,oBAAoBJ,EAAMM,GAEvC,CACF,CAAC,EAUM,CAACH,EATwCK,GAAqB,CAlCvE,IAAAC,EAmCI,IAAMF,EAAQ,IAAI,YAAqBP,EAAM,CAC3C,QAAS,GACT,WAAY,GACZ,SAAU,GACV,OAAAQ,CACF,CAAC,GACDC,EAAAN,EAAI,UAAJ,MAAAM,EAAa,cAAcF,EAC7B,CACqB,CACvB,EC7BO,IAAMG,EAAW,CACtBC,EACAC,IACuD,CACvD,GAAM,CAACC,EAAKC,CAAc,EAAIC,EAC5B,MACAJ,EACGK,GACQL,EAASK,EAAO,KAAMA,EAAO,KAAMA,EAAO,IAAI,EAEvD,OACFJ,CACF,EAKA,MAAO,CAACC,EAH6C,CAACI,EAAaC,EAAaC,IACvEL,EAAe,CAAE,KAAAK,EAAM,KAAAF,EAAM,KAAAC,CAAK,CAAC,CAEvB,CACvB","names":["src_exports","__export","useCustomEvent","useEvent","__toCommonJS","import_assert","import_react","useCustomEvent","type","listener","customRef","ref","element","currentListener","handler","event","detail","_a","useEvent","listener","sharableRef","ref","customDispatch","useCustomEvent","detail","noun","verb","data"]}
+{"version":3,"sources":["../../src/index.ts","../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["export * from './hooks'\n","import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAyB;AACzB,mBAAgD;AAIzC,IAAM,iBAAiB,CAC5B,MACA,UACA,cACwD;AACxD,QAAM,MAAM,iBAAa,wBAAoB;AAC7C,8BAAU,MAAM;AACd,UAAM,UAAU,2BAAK;AACrB,UAAM,kBAAkB;AACxB,UAAM,UACJ,kBACE,CAAC,UAA4C;AAC3C,YAAM,aAAS,wBAAS,MAAM,QAAQ,MAAM,sBAAsB;AAClE,YAAM,OAAO,gBAAgB,MAAM;AACnC,UAAI,MAAM;AACR,cAAM,gBAAgB;AAAA,MACxB;AAAA,IACF,IACA;AAEJ,QAAI,WAAW,SAAS;AACtB,yCAAS,iBAAiB,MAAM;AAAA,IAClC;AACA,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,2CAAS,oBAAoB,MAAM;AAAA,MACrC;AAAA,IACF;AAAA,EACF,CAAC;AACD,QAAM,WAAyC,CAAC,WAAqB;AAlCvE;AAmCI,UAAM,QAAQ,IAAI,YAAqB,MAAM;AAAA,MAC3C,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,cAAI,YAAJ,mBAAa,cAAc;AAAA,EAC7B;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;;;AC7BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACE,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAA+C,CAAC,MAAa,MAAa,SAAiB;AAC/F,WAAO,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,EAC5C;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;","names":[]}

package/dist/node/index.js

@@ -1,2 +1,56 @@
-import{assertEx as E}from"@xylabs/assert";import{createRef as v,useEffect as p}from"react";var i=(o,r,s)=>{let n=s??v();return p(()=>{let t=n==null?void 0:n.current,a=r,e=a?T=>{let c=E(T.detail,()=>"Event missing detail");a(c)&&T.stopPropagation()}:void 0;return e&&t&&(t==null||t.addEventListener(o,e)),()=>{e&&t&&(t==null||t.removeEventListener(o,e))}}),[n,t=>{var e;let a=new CustomEvent(o,{bubbles:!0,cancelable:!0,composed:!0,detail:t});(e=n.current)==null||e.dispatchEvent(a)}]};var h=(o,r)=>{let[s,n]=i("xyo",o?t=>o(t.noun,t.verb,t.data):void 0,r);return[s,(t,a,e)=>n({data:e,noun:t,verb:a})]};export{i as useCustomEvent,h as useEvent};
+// src/hooks/useCustomEvent.ts
+import { assertEx } from "@xylabs/assert";
+import { createRef, useEffect } from "react";
+var useCustomEvent = (type, listener, customRef) => {
+  const ref = customRef ?? createRef();
+  useEffect(() => {
+    const element = ref == null ? void 0 : ref.current;
+    const currentListener = listener;
+    const handler = currentListener ? (event) => {
+      const detail = assertEx(event.detail, () => "Event missing detail");
+      const stop = currentListener(detail);
+      if (stop) {
+        event.stopPropagation();
+      }
+    } : void 0;
+    if (handler && element) {
+      element == null ? void 0 : element.addEventListener(type, handler);
+    }
+    return () => {
+      if (handler && element) {
+        element == null ? void 0 : element.removeEventListener(type, handler);
+      }
+    };
+  });
+  const dispatch = (detail) => {
+    var _a;
+    const event = new CustomEvent(type, {
+      bubbles: true,
+      cancelable: true,
+      composed: true,
+      detail
+    });
+    (_a = ref.current) == null ? void 0 : _a.dispatchEvent(event);
+  };
+  return [ref, dispatch];
+};
+
+// src/hooks/useEvent.ts
+var useEvent = (listener, sharableRef) => {
+  const [ref, customDispatch] = useCustomEvent(
+    "xyo",
+    listener ? (detail) => {
+      return listener(detail.noun, detail.verb, detail.data);
+    } : void 0,
+    sharableRef
+  );
+  const dispatch = (noun, verb, data) => {
+    return customDispatch({ data, noun, verb });
+  };
+  return [ref, dispatch];
+};
+export {
+  useCustomEvent,
+  useEvent
+};
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":"AAAA,OAAS,YAAAA,MAAgB,iBACzB,OAAS,aAAAC,EAAsB,aAAAC,MAAiB,QAIzC,IAAMC,EAAiB,CAC5BC,EACAC,EACAC,IACwD,CACxD,IAAMC,EAAMD,GAAaL,EAAoB,EAC7C,OAAAC,EAAU,IAAM,CACd,IAAMM,EAAUD,GAAA,YAAAA,EAAK,QACfE,EAAkBJ,EAClBK,EACJD,EACGE,GAA4C,CAC3C,IAAMC,EAASZ,EAASW,EAAM,OAAQ,IAAM,sBAAsB,EACrDF,EAAgBG,CAAM,GAEjCD,EAAM,gBAAgB,CAE1B,EACA,OAEJ,OAAID,GAAWF,IACbA,GAAA,MAAAA,EAAS,iBAAiBJ,EAAMM,IAE3B,IAAM,CACPA,GAAWF,IACbA,GAAA,MAAAA,EAAS,oBAAoBJ,EAAMM,GAEvC,CACF,CAAC,EAUM,CAACH,EATwCK,GAAqB,CAlCvE,IAAAC,EAmCI,IAAMF,EAAQ,IAAI,YAAqBP,EAAM,CAC3C,QAAS,GACT,WAAY,GACZ,SAAU,GACV,OAAAQ,CACF,CAAC,GACDC,EAAAN,EAAI,UAAJ,MAAAM,EAAa,cAAcF,EAC7B,CACqB,CACvB,EC7BO,IAAMG,EAAW,CACtBC,EACAC,IACuD,CACvD,GAAM,CAACC,EAAKC,CAAc,EAAIC,EAC5B,MACAJ,EACGK,GACQL,EAASK,EAAO,KAAMA,EAAO,KAAMA,EAAO,IAAI,EAEvD,OACFJ,CACF,EAKA,MAAO,CAACC,EAH6C,CAACI,EAAaC,EAAaC,IACvEL,EAAe,CAAE,KAAAK,EAAM,KAAAF,EAAM,KAAAC,CAAK,CAAC,CAEvB,CACvB","names":["assertEx","createRef","useEffect","useCustomEvent","type","listener","customRef","ref","element","currentListener","handler","event","detail","_a","useEvent","listener","sharableRef","ref","customDispatch","useCustomEvent","detail","noun","verb","data"]}
+{"version":3,"sources":["../../src/hooks/useCustomEvent.ts","../../src/hooks/useEvent.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { createRef, RefObject, useEffect } from 'react'\n\nexport type CustomEventDispatch<T = unknown> = (detail: T) => boolean | void\n\nexport const useCustomEvent = <TElement extends HTMLElement, TDetail = unknown>(\n  type: string,\n  listener?: CustomEventDispatch<TDetail>,\n  customRef?: RefObject<TElement>,\n): [RefObject<TElement>, CustomEventDispatch<TDetail>] => {\n  const ref = customRef ?? createRef<TElement>()\n  useEffect(() => {\n    const element = ref?.current\n    const currentListener = listener\n    const handler =\n      currentListener ?\n        (event: CustomEventInit<TDetail> & Event) => {\n          const detail = assertEx(event.detail, () => 'Event missing detail')\n          const stop = currentListener(detail)\n          if (stop) {\n            event.stopPropagation()\n          }\n        }\n      : undefined\n\n    if (handler && element) {\n      element?.addEventListener(type, handler)\n    }\n    return () => {\n      if (handler && element) {\n        element?.removeEventListener(type, handler)\n      }\n    }\n  })\n  const dispatch: CustomEventDispatch<TDetail> = (detail?: TDetail) => {\n    const event = new CustomEvent<TDetail>(type, {\n      bubbles: true,\n      cancelable: true,\n      composed: true,\n      detail,\n    })\n    ref.current?.dispatchEvent(event)\n  }\n  return [ref, dispatch]\n}\n","import { RefObject } from 'react'\n\nimport { useCustomEvent } from './useCustomEvent'\n\nexport type EventNoun = 'payload' | 'boundwitness' | 'address' | 'hash' | 'signature' | 'schema'\nexport type EventVerb = 'click' | 'favorite'\n\nexport interface Event<TNoun = EventNoun, TVerb = EventVerb, TData = string> {\n  data?: TData\n  noun: TNoun\n  verb: TVerb\n}\n\nexport type EventDispatch<TNoun = EventNoun, TVerb = EventVerb, TData = string> = (noun: TNoun, verb: TVerb, data?: TData) => boolean | void\n\nexport const useEvent = <T extends HTMLElement, TNoun = EventNoun, TVerb = EventVerb, TData = string>(\n  listener?: EventDispatch<TNoun, TVerb, TData>,\n  sharableRef?: RefObject<T>,\n): [RefObject<T>, EventDispatch<TNoun, TVerb, TData>] => {\n  const [ref, customDispatch] = useCustomEvent<T, Event<TNoun, TVerb, TData>>(\n    'xyo',\n    listener ?\n      (detail: Event<TNoun, TVerb, TData>) => {\n        return listener(detail.noun, detail.verb, detail.data)\n      }\n    : undefined,\n    sharableRef,\n  )\n\n  const dispatch: EventDispatch<TNoun, TVerb, TData> = (noun: TNoun, verb: TVerb, data?: TData) => {\n    return customDispatch({ data, noun, verb })\n  }\n  return [ref, dispatch]\n}\n"],"mappings":";AAAA,SAAS,gBAAgB;AACzB,SAAS,WAAsB,iBAAiB;AAIzC,IAAM,iBAAiB,CAC5B,MACA,UACA,cACwD;AACxD,QAAM,MAAM,aAAa,UAAoB;AAC7C,YAAU,MAAM;AACd,UAAM,UAAU,2BAAK;AACrB,UAAM,kBAAkB;AACxB,UAAM,UACJ,kBACE,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,MAAM,sBAAsB;AAClE,YAAM,OAAO,gBAAgB,MAAM;AACnC,UAAI,MAAM;AACR,cAAM,gBAAgB;AAAA,MACxB;AAAA,IACF,IACA;AAEJ,QAAI,WAAW,SAAS;AACtB,yCAAS,iBAAiB,MAAM;AAAA,IAClC;AACA,WAAO,MAAM;AACX,UAAI,WAAW,SAAS;AACtB,2CAAS,oBAAoB,MAAM;AAAA,MACrC;AAAA,IACF;AAAA,EACF,CAAC;AACD,QAAM,WAAyC,CAAC,WAAqB;AAlCvE;AAmCI,UAAM,QAAQ,IAAI,YAAqB,MAAM;AAAA,MAC3C,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,cAAI,YAAJ,mBAAa,cAAc;AAAA,EAC7B;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;;;AC7BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACE,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAA+C,CAAC,MAAa,MAAa,SAAiB;AAC/F,WAAO,eAAe,EAAE,MAAM,MAAM,KAAK,CAAC;AAAA,EAC5C;AACA,SAAO,CAAC,KAAK,QAAQ;AACvB;","names":[]}

package/package.json

@@ -10,10 +10,10 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/issues"
   },
   "dependencies": {
-    "@xylabs/assert": "^3.5.1"
+    "@xylabs/assert": "^3.5.2"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "^3.11.8",
+    "@xylabs/ts-scripts-yarn3": "^3.11.12",
     "typescript": "^5.5.2"
   },
   "peerDependencies": {
@@ -71,6 +71,6 @@
   },
   "sideEffects": false,
   "types": "dist/browser/index.d.ts",
-  "version": "2.78.0",
+  "version": "2.78.1",
   "type": "module"
 }