@hexclave/shared 1.0.0

package/dist/esm/hooks/use-async-callback.js

@@ -0,0 +1,38 @@
+import React from "react";
+import { captureError } from "../utils/errors.js";
+
+//#region src/hooks/use-async-callback.tsx
+function useAsyncCallback(callback, deps) {
+	const [error, setError] = React.useState(void 0);
+	const [loadingCount, setLoadingCount] = React.useState(0);
+	return [
+		React.useCallback(async (...args) => {
+			setLoadingCount((c) => c + 1);
+			try {
+				return await callback(...args);
+			} catch (e) {
+				setError(e);
+				throw e;
+			} finally {
+				setLoadingCount((c) => c - 1);
+			}
+		}, deps),
+		loadingCount > 0,
+		error
+	];
+}
+function useAsyncCallbackWithLoggedError(callback, deps) {
+	const [newCallback, loading] = useAsyncCallback(async (...args) => {
+		try {
+			return await callback(...args);
+		} catch (e) {
+			captureError("async-callback", e);
+			throw e;
+		}
+	}, deps);
+	return [newCallback, loading];
+}
+
+//#endregion
+export { useAsyncCallback, useAsyncCallbackWithLoggedError };
+//# sourceMappingURL=use-async-callback.js.map

package/dist/esm/hooks/use-async-callback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-async-callback.js","names":[],"sources":["../../../src/hooks/use-async-callback.tsx"],"sourcesContent":["import React from \"react\";\nimport { captureError } from \"../utils/errors\";\n\nexport function useAsyncCallback<A extends any[], R>(\n  callback: (...args: A) => Promise<R>,\n  deps: React.DependencyList\n): [cb: (...args: A) => Promise<R>, loading: boolean, error: unknown | undefined] {\n  const [error, setError] = React.useState<unknown | undefined>(undefined);\n  const [loadingCount, setLoadingCount] = React.useState(0);\n\n  const cb = React.useCallback(\n    async (...args: A) => {\n      setLoadingCount((c) => c + 1);\n      try {\n        return await callback(...args);\n      } catch (e) {\n        setError(e);\n        throw e;\n      } finally {\n        setLoadingCount((c) => c - 1);\n      }\n    },\n    deps,\n  );\n\n  return [cb, loadingCount > 0, error];\n}\n\nexport function useAsyncCallbackWithLoggedError<A extends any[], R>(\n  callback: (...args: A) => Promise<R>,\n  deps: React.DependencyList\n): [cb: (...args: A) => Promise<R>, loading: boolean] {\n  const [newCallback, loading] = useAsyncCallback<A, R>(async (...args) => {\n    try {\n      return await callback(...args);\n    } catch (e) {\n      captureError(\"async-callback\", e);\n      throw e;\n    }\n  }, deps);\n\n  return [newCallback, loading];\n}\n"],"mappings":";;;;AAGA,SAAgB,iBACd,UACA,MACgF;CAChF,MAAM,CAAC,OAAO,YAAY,MAAM,SAA8B,OAAU;CACxE,MAAM,CAAC,cAAc,mBAAmB,MAAM,SAAS,EAAE;AAiBzD,QAAO;EAfI,MAAM,YACf,OAAO,GAAG,SAAY;AACpB,oBAAiB,MAAM,IAAI,EAAE;AAC7B,OAAI;AACF,WAAO,MAAM,SAAS,GAAG,KAAK;YACvB,GAAG;AACV,aAAS,EAAE;AACX,UAAM;aACE;AACR,qBAAiB,MAAM,IAAI,EAAE;;KAGjC,KACD;EAEW,eAAe;EAAG;EAAM;;AAGtC,SAAgB,gCACd,UACA,MACoD;CACpD,MAAM,CAAC,aAAa,WAAW,iBAAuB,OAAO,GAAG,SAAS;AACvE,MAAI;AACF,UAAO,MAAM,SAAS,GAAG,KAAK;WACvB,GAAG;AACV,gBAAa,kBAAkB,EAAE;AACjC,SAAM;;IAEP,KAAK;AAER,QAAO,CAAC,aAAa,QAAQ"}

package/dist/esm/hooks/use-async-external-store.d.ts

@@ -0,0 +1,9 @@
+import { AsyncResult } from "../utils/results";
+
+//#region src/hooks/use-async-external-store.d.ts
+declare function useAsyncExternalStore<T>(subscribe: (callback: (t: T) => void) => (() => void)): AsyncResult<T, never> & {
+  status: "ok" | "pending";
+};
+//#endregion
+export { useAsyncExternalStore };
+//# sourceMappingURL=use-async-external-store.d.ts.map

package/dist/esm/hooks/use-async-external-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-async-external-store.d.ts","names":[],"sources":["../../../src/hooks/use-async-external-store.tsx"],"mappings":";;;iBAGgB,qBAAA,GAAA,CACd,SAAA,GAAY,QAAA,GAAW,CAAA,EAAG,CAAA,6BACzB,WAAA,CAAY,CAAA;EAAc,MAAA;AAAA"}

package/dist/esm/hooks/use-async-external-store.js

@@ -0,0 +1,20 @@
+import { useEffect, useState } from "react";
+import { AsyncResult } from "../utils/results.js";
+
+//#region src/hooks/use-async-external-store.tsx
+function useAsyncExternalStore(subscribe) {
+	const [isAvailable, setIsAvailable] = useState(false);
+	const [value, setValue] = useState();
+	useEffect(() => {
+		return subscribe((value) => {
+			setValue(() => value);
+			setIsAvailable(() => true);
+		});
+	}, [subscribe]);
+	if (isAvailable) return AsyncResult.ok(value);
+	else return AsyncResult.pending();
+}
+
+//#endregion
+export { useAsyncExternalStore };
+//# sourceMappingURL=use-async-external-store.js.map

package/dist/esm/hooks/use-async-external-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-async-external-store.js","names":[],"sources":["../../../src/hooks/use-async-external-store.tsx"],"sourcesContent":["import { useEffect, useState } from \"react\";\nimport { AsyncResult } from \"../utils/results\";\n\nexport function useAsyncExternalStore<T>(\n  subscribe: (callback: (t: T) => void) => (() => void),\n): AsyncResult<T, never> & { status: \"ok\" | \"pending\" } {\n  // sure, the \"sync\" in useSyncExternalStore refers to \"synchronize a store\" and not \"sync/async\", but it's too good of a name to pass up on\n\n  const [isAvailable, setIsAvailable] = useState(false);\n  const [value, setValue] = useState<T>();\n  useEffect(() => {\n    const unsubscribe = subscribe((value: T) => {\n      setValue(() => value);\n      setIsAvailable(() => true);\n    });\n    return unsubscribe;\n  }, [subscribe]);\n\n  if (isAvailable) {\n    return AsyncResult.ok(value as T);\n  } else {\n    return AsyncResult.pending();\n  }\n}\n"],"mappings":";;;;AAGA,SAAgB,sBACd,WACsD;CAGtD,MAAM,CAAC,aAAa,kBAAkB,SAAS,MAAM;CACrD,MAAM,CAAC,OAAO,YAAY,UAAa;AACvC,iBAAgB;AAKd,SAJoB,WAAW,UAAa;AAC1C,kBAAe,MAAM;AACrB,wBAAqB,KAAK;IAC1B;IAED,CAAC,UAAU,CAAC;AAEf,KAAI,YACF,QAAO,YAAY,GAAG,MAAW;KAEjC,QAAO,YAAY,SAAS"}

package/dist/esm/hooks/use-hash.d.ts

@@ -0,0 +1,5 @@
+//#region src/hooks/use-hash.d.ts
+declare const useHash: () => string;
+//#endregion
+export { useHash };
+//# sourceMappingURL=use-hash.d.ts.map

package/dist/esm/hooks/use-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hash.d.ts","names":[],"sources":["../../../src/hooks/use-hash.tsx"],"mappings":";cAGa,OAAA"}

package/dist/esm/hooks/use-hash.js

@@ -0,0 +1,15 @@
+import { useSyncExternalStore } from "react";
+import { suspendIfSsr } from "../utils/react.js";
+
+//#region src/hooks/use-hash.tsx
+const useHash = () => {
+	suspendIfSsr("useHash");
+	return useSyncExternalStore((onChange) => {
+		const interval = setInterval(() => onChange(), 10);
+		return () => clearInterval(interval);
+	}, () => window.location.hash.substring(1));
+};
+
+//#endregion
+export { useHash };
+//# sourceMappingURL=use-hash.js.map

package/dist/esm/hooks/use-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hash.js","names":[],"sources":["../../../src/hooks/use-hash.tsx"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\nimport { suspendIfSsr } from \"../utils/react\";\n\nexport const useHash = () => {\n  suspendIfSsr(\"useHash\");\n  return useSyncExternalStore(\n    (onChange) => {\n      const interval = setInterval(() => onChange(), 10);\n      return () => clearInterval(interval);\n    },\n    () => window.location.hash.substring(1)\n  );\n};\n\n"],"mappings":";;;;AAGA,MAAa,gBAAgB;AAC3B,cAAa,UAAU;AACvB,QAAO,sBACJ,aAAa;EACZ,MAAM,WAAW,kBAAkB,UAAU,EAAE,GAAG;AAClD,eAAa,cAAc,SAAS;UAEhC,OAAO,SAAS,KAAK,UAAU,EAAE,CACxC"}

package/dist/esm/hooks/use-hover.d.ts

@@ -0,0 +1,8 @@
+//#region src/hooks/use-hover.d.ts
+declare function useHover<T extends HTMLElement>(ref: React.RefObject<T>, options?: {
+  onMouseEnter?: () => void;
+  onMouseLeave?: () => void;
+}): boolean;
+//#endregion
+export { useHover };
+//# sourceMappingURL=use-hover.d.ts.map

package/dist/esm/hooks/use-hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hover.d.ts","names":[],"sources":["../../../src/hooks/use-hover.tsx"],"mappings":";iBAGgB,QAAA,WAAmB,WAAA,CAAA,CACjC,GAAA,EAAK,KAAA,CAAM,SAAA,CAAU,CAAA,GACrB,OAAA;EACE,YAAA;EACA,YAAA;AAAA"}

package/dist/esm/hooks/use-hover.js

@@ -0,0 +1,59 @@
+import { useLayoutEffect } from "react";
+import { useRefState } from "../utils/react.js";
+
+//#region src/hooks/use-hover.tsx
+function useHover(ref, options = {}) {
+	const counter = useRefState(0);
+	useLayoutEffect(() => {
+		const el = ref.current;
+		if (!el) return;
+		let incr = 0;
+		let prevInside = false;
+		const contains = (r, x, y) => x >= r.left && x <= r.right && y >= r.top && y <= r.bottom;
+		const enter = () => {
+			incr++;
+			counter.set((c) => c + 1);
+			if (counter.current === 1) options.onMouseEnter?.();
+		};
+		const leave = () => {
+			incr--;
+			requestAnimationFrame(() => {
+				requestAnimationFrame(() => {
+					counter.set((c) => c - 1);
+					if (counter.current === 0) options.onMouseLeave?.();
+				});
+			});
+		};
+		const topMatchesTarget = (x, y) => {
+			const top = document.elementFromPoint(x, y);
+			return !!(top && (top === el || el.contains(top)));
+		};
+		const processPoint = (x, y) => {
+			const inside = contains(el.getBoundingClientRect(), x, y) && topMatchesTarget(x, y);
+			if (inside && !prevInside) enter();
+			else if (!inside && prevInside) leave();
+			prevInside = inside;
+		};
+		const onMove = (e) => {
+			if (e.pointerType !== "mouse") return;
+			const batch = e.getCoalescedEvents();
+			if (batch.length) for (let eventIndex = 0; eventIndex < batch.length - 1; eventIndex++) {
+				const e1 = batch[eventIndex];
+				const e2 = batch[eventIndex + 1];
+				const steps = 10;
+				for (let i = 0; i <= steps; i++) processPoint(e1.clientX + (e2.clientX - e1.clientX) * i / steps, e1.clientY + (e2.clientY - e1.clientY) * i / steps);
+			}
+			else processPoint(e.clientX, e.clientY);
+		};
+		window.addEventListener("pointermove", onMove, { passive: true });
+		return () => {
+			window.removeEventListener("pointermove", onMove);
+			counter.set((c) => c - incr);
+		};
+	}, []);
+	return counter.current > 0;
+}
+
+//#endregion
+export { useHover };
+//# sourceMappingURL=use-hover.js.map

package/dist/esm/hooks/use-hover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hover.js","names":[],"sources":["../../../src/hooks/use-hover.tsx"],"sourcesContent":["import { useLayoutEffect } from \"react\";\nimport { useRefState } from \"../utils/react\";\n\nexport function useHover<T extends HTMLElement>(\n  ref: React.RefObject<T>,\n  options: {\n    onMouseEnter?: () => void,\n    onMouseLeave?: () => void,\n  } = {},\n): boolean {\n  // Internal counter: mouseenter++ / mouseleave-- (isHovering = counter > 0)\n  const counter = useRefState(0);\n\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    let incr = 0;\n    let prevInside = false;\n\n    const contains = (r: DOMRect, x: number, y: number) =>\n      x >= r.left && x <= r.right && y >= r.top && y <= r.bottom;\n\n    const enter = () => {\n      incr++;\n      counter.set(c => c + 1);\n      if (counter.current === 1) {\n        options.onMouseEnter?.();\n      }\n    };\n\n    const leave = () => {\n      incr--;\n      requestAnimationFrame(() => {\n        requestAnimationFrame(() => {\n          counter.set(c => c - 1);\n          if (counter.current === 0) {\n            options.onMouseLeave?.();\n          }\n        });\n      });\n    };\n\n    const topMatchesTarget = (x: number, y: number) => {\n      const top = document.elementFromPoint(x, y);\n      return !!(top && (top === el || el.contains(top)));\n    };\n\n    const processPoint = (x: number, y: number) => {\n      const rect = el.getBoundingClientRect();\n\n      // True “hoverability”: inside rect AND not occluded by others\n      const inside = contains(rect, x, y) && topMatchesTarget(x, y);\n      if (inside && !prevInside) {\n        enter();\n      } else if (!inside && prevInside) {\n        leave();\n      }\n      prevInside = inside;\n    };\n\n    const onMove = (e: PointerEvent) => {\n      if (e.pointerType !== \"mouse\") return; // keep it hover-only\n      // Use coalesced points when available\n      const batch = e.getCoalescedEvents();\n      if (batch.length) {\n        for (let eventIndex = 0; eventIndex < batch.length - 1; eventIndex++) {\n          const e1 = batch[eventIndex];\n          const e2 = batch[eventIndex + 1];\n          const steps = 10;\n          for (let i = 0; i <= steps; i++) {\n            processPoint(e1.clientX + (e2.clientX - e1.clientX) * i / steps, e1.clientY + (e2.clientY - e1.clientY) * i / steps);\n          }\n        }\n      } else {\n        processPoint(e.clientX, e.clientY);\n      }\n    };\n\n    window.addEventListener(\"pointermove\", onMove, { passive: true });\n\n    return () => {\n      window.removeEventListener(\"pointermove\", onMove);\n      counter.set(c => c - incr);\n    };\n  }, []);\n\n  return counter.current > 0;\n}\n"],"mappings":";;;;AAGA,SAAgB,SACd,KACA,UAGI,EAAE,EACG;CAET,MAAM,UAAU,YAAY,EAAE;AAE9B,uBAAsB;EACpB,MAAM,KAAK,IAAI;AACf,MAAI,CAAC,GAAI;EACT,IAAI,OAAO;EACX,IAAI,aAAa;EAEjB,MAAM,YAAY,GAAY,GAAW,MACvC,KAAK,EAAE,QAAQ,KAAK,EAAE,SAAS,KAAK,EAAE,OAAO,KAAK,EAAE;EAEtD,MAAM,cAAc;AAClB;AACA,WAAQ,KAAI,MAAK,IAAI,EAAE;AACvB,OAAI,QAAQ,YAAY,EACtB,SAAQ,gBAAgB;;EAI5B,MAAM,cAAc;AAClB;AACA,+BAA4B;AAC1B,gCAA4B;AAC1B,aAAQ,KAAI,MAAK,IAAI,EAAE;AACvB,SAAI,QAAQ,YAAY,EACtB,SAAQ,gBAAgB;MAE1B;KACF;;EAGJ,MAAM,oBAAoB,GAAW,MAAc;GACjD,MAAM,MAAM,SAAS,iBAAiB,GAAG,EAAE;AAC3C,UAAO,CAAC,EAAE,QAAQ,QAAQ,MAAM,GAAG,SAAS,IAAI;;EAGlD,MAAM,gBAAgB,GAAW,MAAc;GAI7C,MAAM,SAAS,SAHF,GAAG,uBAAuB,EAGT,GAAG,EAAE,IAAI,iBAAiB,GAAG,EAAE;AAC7D,OAAI,UAAU,CAAC,WACb,QAAO;YACE,CAAC,UAAU,WACpB,QAAO;AAET,gBAAa;;EAGf,MAAM,UAAU,MAAoB;AAClC,OAAI,EAAE,gBAAgB,QAAS;GAE/B,MAAM,QAAQ,EAAE,oBAAoB;AACpC,OAAI,MAAM,OACR,MAAK,IAAI,aAAa,GAAG,aAAa,MAAM,SAAS,GAAG,cAAc;IACpE,MAAM,KAAK,MAAM;IACjB,MAAM,KAAK,MAAM,aAAa;IAC9B,MAAM,QAAQ;AACd,SAAK,IAAI,IAAI,GAAG,KAAK,OAAO,IAC1B,cAAa,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,IAAI,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,IAAI,MAAM;;OAIxH,cAAa,EAAE,SAAS,EAAE,QAAQ;;AAItC,SAAO,iBAAiB,eAAe,QAAQ,EAAE,SAAS,MAAM,CAAC;AAEjE,eAAa;AACX,UAAO,oBAAoB,eAAe,OAAO;AACjD,WAAQ,KAAI,MAAK,IAAI,KAAK;;IAE3B,EAAE,CAAC;AAEN,QAAO,QAAQ,UAAU"}

package/dist/esm/hooks/use-strict-memo.d.ts

@@ -0,0 +1,10 @@
+//#region src/hooks/use-strict-memo.d.ts
+/**
+ * Like memo, but minimizes recomputation of the value at all costs (instead of useMemo which recomputes whenever the renderer feels like it).
+ *
+ * The most recent value will be kept from garbage collection until one of the dependencies becomes unreachable. This may be true even after the component no longer renders. Be wary of memory leaks.
+ */
+declare function useStrictMemo<T>(callback: () => T, dependencies: any[]): T;
+//#endregion
+export { useStrictMemo };
+//# sourceMappingURL=use-strict-memo.d.ts.map

package/dist/esm/hooks/use-strict-memo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-strict-memo.d.ts","names":[],"sources":["../../../src/hooks/use-strict-memo.tsx"],"mappings":";;AA0IA;;;;iBAAgB,aAAA,GAAA,CAAiB,QAAA,QAAgB,CAAA,EAAG,YAAA,UAAsB,CAAA"}

package/dist/esm/hooks/use-strict-memo.js

@@ -0,0 +1,119 @@
+import { useId, useInsertionEffect } from "react";
+import { Result } from "../utils/results.js";
+
+//#region src/hooks/use-strict-memo.tsx
+const cached = /* @__PURE__ */ new Map();
+function unwrapFromInner(dependencies, inner) {
+	if (dependencies.length === 0 !== "isNotNestedMap" in inner) return Result.error(void 0);
+	if ("isNotNestedMap" in inner) if (dependencies.length === 0) return Result.ok(inner.value);
+	else return Result.error(void 0);
+	else if (dependencies.length === 0) return Result.error(void 0);
+	else {
+		const [key, ...rest] = dependencies;
+		const newInner = inner.get(key);
+		if (!newInner) return Result.error(void 0);
+		return unwrapFromInner(rest, newInner);
+	}
+}
+(void 0)?.test("unwrapFromInner", ({ expect }) => {
+	const nonNestedMap = {
+		isNotNestedMap: true,
+		value: "test"
+	};
+	const result1 = unwrapFromInner([], nonNestedMap);
+	expect(result1.status).toBe("ok");
+	if (result1.status === "ok") expect(result1.data).toBe("test");
+	expect(unwrapFromInner(["key"], nonNestedMap).status).toBe("error");
+	const nestedMap = new Map([["key", {
+		isNotNestedMap: true,
+		value: "test"
+	}]]);
+	expect(unwrapFromInner([], nestedMap).status).toBe("error");
+	const result2 = unwrapFromInner(["key"], nestedMap);
+	expect(result2.status).toBe("ok");
+	if (result2.status === "ok") expect(result2.data).toBe("test");
+	expect(unwrapFromInner(["wrongKey"], nestedMap).status).toBe("error");
+	const deeplyNestedMap = new Map([["key1", new Map([["key2", {
+		isNotNestedMap: true,
+		value: "nested"
+	}]])]]);
+	const result3 = unwrapFromInner(["key1", "key2"], deeplyNestedMap);
+	expect(result3.status).toBe("ok");
+	if (result3.status === "ok") expect(result3.data).toBe("nested");
+	expect(unwrapFromInner(["key1", "wrongKey"], deeplyNestedMap).status).toBe("error");
+});
+function wrapToInner(dependencies, value) {
+	if (dependencies.length === 0) return {
+		isNotNestedMap: true,
+		value
+	};
+	const [key, ...rest] = dependencies;
+	const inner = wrapToInner(rest, value);
+	return new (typeof key === "object" && key !== null || typeof key === "symbol" && Symbol.keyFor(key) === void 0 ? WeakMap : Map)([[key, inner]]);
+}
+(void 0)?.test("wrapToInner", ({ expect }) => {
+	expect(wrapToInner([], "test")).toEqual({
+		isNotNestedMap: true,
+		value: "test"
+	});
+	const singleResult = wrapToInner(["key"], "test");
+	expect(singleResult instanceof Map).toBe(true);
+	expect(singleResult.get("key")).toEqual({
+		isNotNestedMap: true,
+		value: "test"
+	});
+	const multiResult = wrapToInner(["key1", "key2"], "test");
+	expect(multiResult instanceof Map).toBe(true);
+	const innerMap = multiResult.get("key1");
+	expect(innerMap instanceof Map).toBe(true);
+	expect(innerMap.get("key2")).toEqual({
+		isNotNestedMap: true,
+		value: "test"
+	});
+	const obj = { test: true };
+	const objResult = wrapToInner([obj], "test");
+	expect(objResult instanceof WeakMap).toBe(true);
+	expect(objResult.get(obj)).toEqual({
+		isNotNestedMap: true,
+		value: "test"
+	});
+	const symbolObj = Symbol("test");
+	const symbolResult = wrapToInner([symbolObj], "test");
+	expect(symbolResult instanceof WeakMap).toBe(true);
+	expect(symbolResult.get(symbolObj)).toEqual({
+		isNotNestedMap: true,
+		value: "test"
+	});
+	const registeredSymbol = Symbol.for("test");
+	const registeredSymbolResult = wrapToInner([registeredSymbol], "test");
+	expect(registeredSymbolResult instanceof Map).toBe(true);
+	expect(registeredSymbolResult.get(registeredSymbol)).toEqual({
+		isNotNestedMap: true,
+		value: "test"
+	});
+});
+/**
+* Like memo, but minimizes recomputation of the value at all costs (instead of useMemo which recomputes whenever the renderer feels like it).
+*
+* The most recent value will be kept from garbage collection until one of the dependencies becomes unreachable. This may be true even after the component no longer renders. Be wary of memory leaks.
+*/
+function useStrictMemo(callback, dependencies) {
+	const id = useId();
+	useInsertionEffect(() => {
+		return () => {
+			cached.delete(id);
+		};
+	}, [id]);
+	const c = cached.get(id);
+	if (c) {
+		const unwrapped = unwrapFromInner(dependencies, c);
+		if (unwrapped.status === "ok") return unwrapped.data;
+	}
+	const value = callback();
+	cached.set(id, wrapToInner(dependencies, value));
+	return value;
+}
+
+//#endregion
+export { useStrictMemo };
+//# sourceMappingURL=use-strict-memo.js.map

package/dist/esm/hooks/use-strict-memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-strict-memo.js","names":[],"sources":["../../../src/hooks/use-strict-memo.tsx"],"sourcesContent":["import { useId, useInsertionEffect, useMemo } from \"react\";\nimport { Result } from \"../utils/results\";\n\ntype CacheInner = Map<unknown, CacheInner> | WeakMap<WeakKey, CacheInner> | { isNotNestedMap: true, value: any };\n\nconst cached = new Map<string, CacheInner>();\n\nfunction unwrapFromInner(dependencies: any[], inner: CacheInner): Result<any, void> {\n  if ((dependencies.length === 0) !== (\"isNotNestedMap\" in inner)) {\n    return Result.error(undefined);\n  }\n  if (\"isNotNestedMap\" in inner) {\n    if (dependencies.length === 0) {\n      return Result.ok(inner.value);\n    } else {\n      return Result.error(undefined);\n    }\n  } else {\n    if (dependencies.length === 0) {\n      return Result.error(undefined);\n    } else {\n      const [key, ...rest] = dependencies;\n      const newInner = inner.get(key);\n      if (!newInner) {\n        return Result.error(undefined);\n      }\n      return unwrapFromInner(rest, newInner);\n    }\n  }\n}\nimport.meta.vitest?.test(\"unwrapFromInner\", ({ expect }) => {\n  // Test with empty dependencies and non-nested map\n  const nonNestedMap = { isNotNestedMap: true, value: \"test\" } as CacheInner;\n  const result1 = unwrapFromInner([], nonNestedMap);\n  expect(result1.status).toBe(\"ok\");\n  if (result1.status === \"ok\") {\n    expect(result1.data).toBe(\"test\");\n  }\n\n  // Test with non-empty dependencies and non-nested map (should error)\n  expect(unwrapFromInner([\"key\"], nonNestedMap).status).toBe(\"error\");\n\n  // Test with empty dependencies and nested map (should error)\n  const nestedMap = new Map([[\"key\", { isNotNestedMap: true, value: \"test\" } as CacheInner]]) as CacheInner;\n  expect(unwrapFromInner([], nestedMap).status).toBe(\"error\");\n\n  // Test with matching dependencies and nested map\n  const result2 = unwrapFromInner([\"key\"], nestedMap);\n  expect(result2.status).toBe(\"ok\");\n  if (result2.status === \"ok\") {\n    expect(result2.data).toBe(\"test\");\n  }\n\n  // Test with non-matching dependencies and nested map\n  expect(unwrapFromInner([\"wrongKey\"], nestedMap).status).toBe(\"error\");\n\n  // Test with deeply nested map\n  const deeplyNestedMap = new Map([\n    [\"key1\", new Map([\n      [\"key2\", { isNotNestedMap: true, value: \"nested\" } as CacheInner]\n    ]) as CacheInner]\n  ]) as CacheInner;\n\n  const result3 = unwrapFromInner([\"key1\", \"key2\"], deeplyNestedMap);\n  expect(result3.status).toBe(\"ok\");\n  if (result3.status === \"ok\") {\n    expect(result3.data).toBe(\"nested\");\n  }\n\n  // Test with partial match in deeply nested map\n  expect(unwrapFromInner([\"key1\", \"wrongKey\"], deeplyNestedMap).status).toBe(\"error\");\n});\n\nfunction wrapToInner(dependencies: any[], value: any): CacheInner {\n  if (dependencies.length === 0) {\n    return { isNotNestedMap: true, value };\n  }\n  const [key, ...rest] = dependencies;\n  const inner = wrapToInner(rest, value);\n\n  const isObject = (typeof key === \"object\" && key !== null);\n  const isUnregisteredSymbol = (typeof key === \"symbol\" && Symbol.keyFor(key) === undefined);\n  const isWeak = isObject || isUnregisteredSymbol;\n  const mapType = isWeak ? WeakMap : Map;\n\n  return new mapType([[key, inner]]);\n}\nimport.meta.vitest?.test(\"wrapToInner\", ({ expect }) => {\n  // Test with empty dependencies\n  const emptyResult = wrapToInner([], \"test\");\n  expect(emptyResult).toEqual({ isNotNestedMap: true, value: \"test\" });\n\n  // Test with single string dependency\n  const singleResult = wrapToInner([\"key\"], \"test\");\n  expect(singleResult instanceof Map).toBe(true);\n  // Need to cast to access Map methods\n  const singleMap = singleResult as Map<unknown, CacheInner>;\n  expect(singleMap.get(\"key\")).toEqual({ isNotNestedMap: true, value: \"test\" });\n\n  // Test with multiple string dependencies\n  const multiResult = wrapToInner([\"key1\", \"key2\"], \"test\");\n  expect(multiResult instanceof Map).toBe(true);\n  // Need to cast to access Map methods\n  const multiMap = multiResult as Map<unknown, CacheInner>;\n  const innerMap = multiMap.get(\"key1\") as Map<unknown, CacheInner>;\n  expect(innerMap instanceof Map).toBe(true);\n  expect(innerMap.get(\"key2\")).toEqual({ isNotNestedMap: true, value: \"test\" });\n\n  // Test with object dependency (should use WeakMap)\n  const obj = { test: true };\n  const objResult = wrapToInner([obj], \"test\");\n  expect(objResult instanceof WeakMap).toBe(true);\n  // Need to cast to access WeakMap methods\n  const objMap = objResult as WeakMap<WeakKey, CacheInner>;\n  expect(objMap.get(obj)).toEqual({ isNotNestedMap: true, value: \"test\" });\n\n  // Test with unregistered symbol dependency (should use WeakMap)\n  const symbolObj = Symbol(\"test\");\n  const symbolResult = wrapToInner([symbolObj], \"test\");\n  expect(symbolResult instanceof WeakMap).toBe(true);\n  // Need to cast to access WeakMap methods\n  const symbolMap = symbolResult as WeakMap<WeakKey, CacheInner>;\n  expect(symbolMap.get(symbolObj as unknown as object)).toEqual({ isNotNestedMap: true, value: \"test\" });\n\n  // Test with registered symbol dependency (should use Map)\n  const registeredSymbol = Symbol.for(\"test\");\n  const registeredSymbolResult = wrapToInner([registeredSymbol], \"test\");\n  expect(registeredSymbolResult instanceof Map).toBe(true);\n  // Need to cast to access Map methods\n  const registeredSymbolMap = registeredSymbolResult as Map<unknown, CacheInner>;\n  expect(registeredSymbolMap.get(registeredSymbol)).toEqual({ isNotNestedMap: true, value: \"test\" });\n});\n\n/**\n * Like memo, but minimizes recomputation of the value at all costs (instead of useMemo which recomputes whenever the renderer feels like it).\n *\n * The most recent value will be kept from garbage collection until one of the dependencies becomes unreachable. This may be true even after the component no longer renders. Be wary of memory leaks.\n */\nexport function useStrictMemo<T>(callback: () => T, dependencies: any[]): T {\n  const id = useId();\n  useInsertionEffect(() => {\n    return () => {\n      cached.delete(id);\n    };\n  }, [id]);\n\n  const c = cached.get(id);\n  if (c) {\n    const unwrapped = unwrapFromInner(dependencies, c);\n    if (unwrapped.status === \"ok\") {\n      return unwrapped.data;\n    }\n  }\n  const value = callback();\n  cached.set(id, wrapToInner(dependencies, value));\n  return value;\n}\n"],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+import { HexclaveAdminInterface } from "./interface/admin-interface";
+import { HexclaveClientInterface } from "./interface/client-interface";
+import { HexclaveServerInterface } from "./interface/server-interface";
+import { KnownError, KnownErrors } from "./known-errors";
+export { HexclaveAdminInterface, HexclaveClientInterface, HexclaveServerInterface, KnownError, KnownErrors };

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+import { HexclaveAdminInterface } from "./interface/admin-interface.js";
+import { HexclaveClientInterface } from "./interface/client-interface.js";
+import { HexclaveServerInterface } from "./interface/server-interface.js";
+import { KnownError, KnownErrors } from "./known-errors.js";
+
+export { HexclaveAdminInterface, HexclaveClientInterface, HexclaveServerInterface, KnownError, KnownErrors };