@xyo-network/react-event 2.64.0 → 2.64.1

package/dist/browser/hooks/index.js

@@ -1,3 +1,55 @@
-export * from "./useCustomEvent";
-export * from "./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/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/index.ts"],"sourcesContent":["export * from './useCustomEvent'\nexport * from './useEvent'\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}
+{"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 = 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,UAAU,kBACZ,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,sBAAsB;AAC5D,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;;;AC5BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACI,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACJ;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/hooks/useCustomEvent.js

@@ -1,6 +1,7 @@
+// src/hooks/useCustomEvent.ts
 import { assertEx } from "@xylabs/assert";
 import { createRef, useEffect } from "react";
-const useCustomEvent = (type, listener, customRef) => {
+var useCustomEvent = (type, listener, customRef) => {
   const ref = customRef ?? createRef();
   useEffect(() => {
     const element = ref?.current;

package/dist/browser/hooks/useCustomEvent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/useCustomEvent.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 = 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"],"mappings":"AAAA,SAAS,gBAAgB;AACzB,SAAS,WAAsB,iBAAiB;AAIzC,MAAM,iBAAiB,CAC5B,MACA,UACA,cACwD;AACxD,QAAM,MAAM,aAAa,UAAoB;AAC7C,YAAU,MAAM;AACd,UAAM,UAAU,KAAK;AACrB,UAAM,kBAAkB;AACxB,UAAM,UAAU,kBACZ,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,sBAAsB;AAC5D,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;","names":[]}
+{"version":3,"sources":["../../../src/hooks/useCustomEvent.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 = 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"],"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,UAAU,kBACZ,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,sBAAsB;AAC5D,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;","names":[]}

package/dist/browser/hooks/useEvent.js

@@ -1,5 +1,41 @@
-import { useCustomEvent } from "./useCustomEvent";
-const useEvent = (listener, sharableRef) => {
+// 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) => {

package/dist/browser/hooks/useEvent.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/useEvent.ts"],"sourcesContent":["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":"AAEA,SAAS,sBAAsB;AAaxB,MAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACI,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACJ;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":[]}
+{"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 = 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,UAAU,kBACZ,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,sBAAsB;AAC5D,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;;;AC5BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACI,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACJ;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 @@
-export * from "./hooks";
+// 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/index.ts"],"sourcesContent":["export * from './hooks'\n"],"mappings":"AAAA,cAAc;","names":[]}
+{"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 = 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,UAAU,kBACZ,CAAC,UAA4C;AAC3C,YAAM,SAAS,SAAS,MAAM,QAAQ,sBAAsB;AAC5D,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;;;AC5BO,IAAM,WAAW,CACtB,UACA,gBACuD;AACvD,QAAM,CAAC,KAAK,cAAc,IAAI;AAAA,IAC5B;AAAA,IACA,WACI,CAAC,WAAuC;AACtC,aAAO,SAAS,OAAO,MAAM,OAAO,MAAM,OAAO,IAAI;AAAA,IACvD,IACA;AAAA,IACJ;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/docs.json

@@ -25,7 +25,7 @@
 							"fileName": "hooks/useEvent.ts",
 							"line": 9,
 							"character": 2,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L9"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L9"
 						}
 					],
 					"type": {
@@ -46,7 +46,7 @@
 							"fileName": "hooks/useEvent.ts",
 							"line": 10,
 							"character": 2,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L10"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L10"
 						}
 					],
 					"type": {
@@ -67,7 +67,7 @@
 							"fileName": "hooks/useEvent.ts",
 							"line": 11,
 							"character": 2,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L11"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L11"
 						}
 					],
 					"type": {
@@ -93,7 +93,7 @@
 					"fileName": "hooks/useEvent.ts",
 					"line": 8,
 					"character": 17,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L8"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L8"
 				}
 			],
 			"typeParameters": [
@@ -147,7 +147,7 @@
 					"fileName": "hooks/useCustomEvent.ts",
 					"line": 4,
 					"character": 12,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L4"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L4"
 				}
 			],
 			"typeParameters": [
@@ -176,7 +176,7 @@
 							"fileName": "hooks/useCustomEvent.ts",
 							"line": 4,
 							"character": 47,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L4"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L4"
 						}
 					],
 					"signatures": [
@@ -230,7 +230,7 @@
 					"fileName": "hooks/useEvent.ts",
 					"line": 14,
 					"character": 12,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L14"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L14"
 				}
 			],
 			"typeParameters": [
@@ -285,7 +285,7 @@
 							"fileName": "hooks/useEvent.ts",
 							"line": 14,
 							"character": 82,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L14"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L14"
 						}
 					],
 					"signatures": [
@@ -367,7 +367,7 @@
 					"fileName": "hooks/useEvent.ts",
 					"line": 5,
 					"character": 12,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L5"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L5"
 				}
 			],
 			"type": {
@@ -411,7 +411,7 @@
 					"fileName": "hooks/useEvent.ts",
 					"line": 6,
 					"character": 12,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L6"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L6"
 				}
 			],
 			"type": {
@@ -439,7 +439,7 @@
 					"fileName": "hooks/useCustomEvent.ts",
 					"line": 6,
 					"character": 13,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L6"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L6"
 				}
 			],
 			"signatures": [
@@ -454,7 +454,7 @@
 							"fileName": "hooks/useCustomEvent.ts",
 							"line": 6,
 							"character": 30,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L6"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useCustomEvent.ts#L6"
 						}
 					],
 					"typeParameter": [
@@ -600,7 +600,7 @@
 					"fileName": "hooks/useEvent.ts",
 					"line": 16,
 					"character": 13,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L16"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L16"
 				}
 			],
 			"signatures": [
@@ -615,7 +615,7 @@
 							"fileName": "hooks/useEvent.ts",
 							"line": 16,
 							"character": 24,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/d3056af66/packages/sdk/packages/event/src/hooks/useEvent.ts#L16"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/blob/ace39d815/packages/sdk/packages/event/src/hooks/useEvent.ts#L16"
 						}
 					],
 					"typeParameter": [

package/package.json

@@ -10,10 +10,10 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-react-js/issues"
   },
   "dependencies": {
-    "@xylabs/assert": "^2.12.13"
+    "@xylabs/assert": "^2.12.14"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "^3.0.78",
+    "@xylabs/ts-scripts-yarn3": "^3.0.79",
     "typescript": "^5.2.2"
   },
   "peerDependencies": {
@@ -71,6 +71,6 @@
   },
   "sideEffects": false,
   "types": "dist/browser/index.d.ts",
-  "version": "2.64.0",
+  "version": "2.64.1",
   "type": "module"
 }