@zentauri-ui/zentauri-components 1.9.1 → 2.0.0

package/dist/hooks/useEventListener.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useEventListener/useEventListener.ts"],"names":["useRef","useEffect"],"mappings":";;;;;AAUA,SAAS,cACP,MAAA,EACoB;AACpB,EAAA,IAAI,WAAW,MAAA,EAAW;AAExB,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,IAAA,GAAO,MAAA;AAAA,EAChD;AACA,EAAA,IAAI,WAAW,IAAA,EAAM;AAEnB,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,kBAAkB,WAAA,EAAa;AACjC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,OAAA;AAChB;AAuCO,SAAS,gBAAA,CACd,SAAA,EACA,OAAA,EACA,MAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,UAAA,GAAaA,aAAO,OAAO,CAAA;AAEjC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AAAA,EACvB,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAIZ,EAAA,MAAM,UACJ,OAAO,OAAA,KAAY,SAAA,GAAY,OAAA,GAAW,SAAS,OAAA,IAAW,KAAA;AAChE,EAAA,MAAM,UAAU,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,WAAW,KAAA,GAAS,KAAA;AAC5E,EAAA,MAAM,OAAO,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,QAAQ,KAAA,GAAS,KAAA;AAEtE,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,IAAA,GAAO,cAAc,MAAM,CAAA;AACjC,IAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,eAAA,GAAkB,EAAE,OAAA,EAAS,OAAA,EAAS,IAAA,EAAK;AACjD,IAAA,MAAM,QAAA,GAAW,CAAC,KAAA,KAAiB;AACjC,MAAA,UAAA,CAAW,QAAQ,KAAK,CAAA;AAAA,IAC1B,CAAA;AACA,IAAA,IAAA,CAAK,gBAAA,CAAiB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAC1D,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,mBAAA,CAAoB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAAA,IAC/D,CAAA;AAAA,EACF,GAAG,CAAC,SAAA,EAAW,QAAQ,OAAA,EAAS,OAAA,EAAS,IAAI,CAAC,CAAA;AAChD","file":"useEventListener.js","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\n\nexport type UseEventListenerTarget =\n  | EventTarget\n  | RefObject<EventTarget | null>\n  | null;\n\nfunction resolveTarget(\n  target: UseEventListenerTarget | undefined,\n): EventTarget | null {\n  if (target === undefined) {\n    // No target specified — default to window.\n    return typeof window === \"undefined\" ? null : window;\n  }\n  if (target === null) {\n    // Explicit null — caller opts out; do not attach any listener.\n    return null;\n  }\n  if (target instanceof EventTarget) {\n    return target;\n  }\n  return target.current;\n}\n\n/**\n * Attaches a DOM event listener with automatic cleanup and a stable wrapper around the latest handler.\n *\n * - Defaults to `window`; pass an element, `document`, or a React ref object as `target`.\n * - Pass explicit `null` as `target` to skip attaching (useful for conditional subscriptions).\n * - The handler is kept in a ref, so passing a new inline function each render does not re-subscribe.\n * - Ref targets are resolved when the effect runs (after mount); if the ref is retargeted later,\n *   re-render with a state-backed node (or key the component) to re-subscribe.\n * - Pass `options` as individual booleans or a stable object reference to avoid re-subscribing on\n *   every render. Internally, `capture`, `passive`, and `once` are compared individually.\n *\n * @param eventName - DOM event name (typed against `WindowEventMap` / `DocumentEventMap` / `HTMLElementEventMap`).\n * @param handler - Listener invoked with the native event.\n * @param target - Event target, React ref to one, `undefined` for `window`, or `null` to skip.\n * @param options - Standard `addEventListener` options.\n */\nexport function useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  target?: Window | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  target: Document | RefObject<Document | null>,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<\n  K extends keyof HTMLElementEventMap,\n  T extends HTMLElement = HTMLElement,\n>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  target: T | RefObject<T | null> | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener(\n  eventName: string,\n  handler: (event: Event) => void,\n  target?: UseEventListenerTarget,\n  options?: boolean | AddEventListenerOptions,\n): void {\n  const handlerRef = useRef(handler);\n\n  useEffect(() => {\n    handlerRef.current = handler;\n  }, [handler]);\n\n  // Destructure options to stable primitives so an inline `{ passive: true }` object literal\n  // passed by callers does not cause the listener to be removed and re-added on every render.\n  const capture =\n    typeof options === \"boolean\" ? options : (options?.capture ?? false);\n  const passive = typeof options === \"object\" ? (options?.passive ?? false) : false;\n  const once = typeof options === \"object\" ? (options?.once ?? false) : false;\n\n  useEffect(() => {\n    const node = resolveTarget(target);\n    if (node == null) {\n      return;\n    }\n    const listenerOptions = { capture, passive, once };\n    const listener = (event: Event) => {\n      handlerRef.current(event);\n    };\n    node.addEventListener(eventName, listener, listenerOptions);\n    return () => {\n      node.removeEventListener(eventName, listener, listenerOptions);\n    };\n  }, [eventName, target, capture, passive, once]);\n}\n"]}

package/dist/hooks/useEventListener.mjs

@@ -0,0 +1,43 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useRef, useEffect } from 'react';
+
+function resolveTarget(target) {
+  if (target === void 0) {
+    return typeof window === "undefined" ? null : window;
+  }
+  if (target === null) {
+    return null;
+  }
+  if (target instanceof EventTarget) {
+    return target;
+  }
+  return target.current;
+}
+function useEventListener(eventName, handler, target, options) {
+  const handlerRef = useRef(handler);
+  useEffect(() => {
+    handlerRef.current = handler;
+  }, [handler]);
+  const capture = typeof options === "boolean" ? options : options?.capture ?? false;
+  const passive = typeof options === "object" ? options?.passive ?? false : false;
+  const once = typeof options === "object" ? options?.once ?? false : false;
+  useEffect(() => {
+    const node = resolveTarget(target);
+    if (node == null) {
+      return;
+    }
+    const listenerOptions = { capture, passive, once };
+    const listener = (event) => {
+      handlerRef.current(event);
+    };
+    node.addEventListener(eventName, listener, listenerOptions);
+    return () => {
+      node.removeEventListener(eventName, listener, listenerOptions);
+    };
+  }, [eventName, target, capture, passive, once]);
+}
+
+export { useEventListener };
+//# sourceMappingURL=useEventListener.mjs.map
+//# sourceMappingURL=useEventListener.mjs.map

package/dist/hooks/useEventListener.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useEventListener/useEventListener.ts"],"names":[],"mappings":";;;AAUA,SAAS,cACP,MAAA,EACoB;AACpB,EAAA,IAAI,WAAW,MAAA,EAAW;AAExB,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,GAAc,IAAA,GAAO,MAAA;AAAA,EAChD;AACA,EAAA,IAAI,WAAW,IAAA,EAAM;AAEnB,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,kBAAkB,WAAA,EAAa;AACjC,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,MAAA,CAAO,OAAA;AAChB;AAuCO,SAAS,gBAAA,CACd,SAAA,EACA,OAAA,EACA,MAAA,EACA,OAAA,EACM;AACN,EAAA,MAAM,UAAA,GAAa,OAAO,OAAO,CAAA;AAEjC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,UAAA,CAAW,OAAA,GAAU,OAAA;AAAA,EACvB,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAIZ,EAAA,MAAM,UACJ,OAAO,OAAA,KAAY,SAAA,GAAY,OAAA,GAAW,SAAS,OAAA,IAAW,KAAA;AAChE,EAAA,MAAM,UAAU,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,WAAW,KAAA,GAAS,KAAA;AAC5E,EAAA,MAAM,OAAO,OAAO,OAAA,KAAY,QAAA,GAAY,OAAA,EAAS,QAAQ,KAAA,GAAS,KAAA;AAEtE,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,IAAA,GAAO,cAAc,MAAM,CAAA;AACjC,IAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,eAAA,GAAkB,EAAE,OAAA,EAAS,OAAA,EAAS,IAAA,EAAK;AACjD,IAAA,MAAM,QAAA,GAAW,CAAC,KAAA,KAAiB;AACjC,MAAA,UAAA,CAAW,QAAQ,KAAK,CAAA;AAAA,IAC1B,CAAA;AACA,IAAA,IAAA,CAAK,gBAAA,CAAiB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAC1D,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,mBAAA,CAAoB,SAAA,EAAW,QAAA,EAAU,eAAe,CAAA;AAAA,IAC/D,CAAA;AAAA,EACF,GAAG,CAAC,SAAA,EAAW,QAAQ,OAAA,EAAS,OAAA,EAAS,IAAI,CAAC,CAAA;AAChD","file":"useEventListener.mjs","sourcesContent":["\"use client\";\n\nimport type { RefObject } from \"react\";\nimport { useEffect, useRef } from \"react\";\n\nexport type UseEventListenerTarget =\n  | EventTarget\n  | RefObject<EventTarget | null>\n  | null;\n\nfunction resolveTarget(\n  target: UseEventListenerTarget | undefined,\n): EventTarget | null {\n  if (target === undefined) {\n    // No target specified — default to window.\n    return typeof window === \"undefined\" ? null : window;\n  }\n  if (target === null) {\n    // Explicit null — caller opts out; do not attach any listener.\n    return null;\n  }\n  if (target instanceof EventTarget) {\n    return target;\n  }\n  return target.current;\n}\n\n/**\n * Attaches a DOM event listener with automatic cleanup and a stable wrapper around the latest handler.\n *\n * - Defaults to `window`; pass an element, `document`, or a React ref object as `target`.\n * - Pass explicit `null` as `target` to skip attaching (useful for conditional subscriptions).\n * - The handler is kept in a ref, so passing a new inline function each render does not re-subscribe.\n * - Ref targets are resolved when the effect runs (after mount); if the ref is retargeted later,\n *   re-render with a state-backed node (or key the component) to re-subscribe.\n * - Pass `options` as individual booleans or a stable object reference to avoid re-subscribing on\n *   every render. Internally, `capture`, `passive`, and `once` are compared individually.\n *\n * @param eventName - DOM event name (typed against `WindowEventMap` / `DocumentEventMap` / `HTMLElementEventMap`).\n * @param handler - Listener invoked with the native event.\n * @param target - Event target, React ref to one, `undefined` for `window`, or `null` to skip.\n * @param options - Standard `addEventListener` options.\n */\nexport function useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  target?: Window | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  target: Document | RefObject<Document | null>,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener<\n  K extends keyof HTMLElementEventMap,\n  T extends HTMLElement = HTMLElement,\n>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  target: T | RefObject<T | null> | null,\n  options?: boolean | AddEventListenerOptions,\n): void;\nexport function useEventListener(\n  eventName: string,\n  handler: (event: Event) => void,\n  target?: UseEventListenerTarget,\n  options?: boolean | AddEventListenerOptions,\n): void {\n  const handlerRef = useRef(handler);\n\n  useEffect(() => {\n    handlerRef.current = handler;\n  }, [handler]);\n\n  // Destructure options to stable primitives so an inline `{ passive: true }` object literal\n  // passed by callers does not cause the listener to be removed and re-added on every render.\n  const capture =\n    typeof options === \"boolean\" ? options : (options?.capture ?? false);\n  const passive = typeof options === \"object\" ? (options?.passive ?? false) : false;\n  const once = typeof options === \"object\" ? (options?.once ?? false) : false;\n\n  useEffect(() => {\n    const node = resolveTarget(target);\n    if (node == null) {\n      return;\n    }\n    const listenerOptions = { capture, passive, once };\n    const listener = (event: Event) => {\n      handlerRef.current(event);\n    };\n    node.addEventListener(eventName, listener, listenerOptions);\n    return () => {\n      node.removeEventListener(eventName, listener, listenerOptions);\n    };\n  }, [eventName, target, capture, passive, once]);\n}\n"]}

package/dist/hooks/useFocusManagement.js

@@ -3,6 +3,7 @@
 
 var chunkGBWGVNDA_js = require('../chunk-GBWGVNDA.js');
 require('../chunk-UIYFEP3I.js');
+require('../chunk-PZ5AY32C.js');
 
 
 

package/dist/hooks/useFocusManagement.mjs

@@ -1,5 +1,6 @@
 "use client";
 export { useFocusManagement } from '../chunk-K6YI4FJO.mjs';
 import '../chunk-PMAF6FBF.mjs';
+import '../chunk-J5LGTIGS.mjs';
 //# sourceMappingURL=useFocusManagement.mjs.map
 //# sourceMappingURL=useFocusManagement.mjs.map

package/dist/hooks/useGeolocation/index.d.ts

@@ -0,0 +1,2 @@
+export { useGeolocation, type GeolocationCoordinatesSnapshot, type UseGeolocationParams, type UseGeolocationResult, } from "./useGeolocation";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useGeolocation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useGeolocation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,8BAA8B,EACnC,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC"}

package/dist/hooks/useGeolocation/useGeolocation.d.ts

@@ -0,0 +1,48 @@
+export type GeolocationCoordinatesSnapshot = {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    altitude: number | null;
+    altitudeAccuracy: number | null;
+    heading: number | null;
+    speed: number | null;
+    timestamp: number;
+};
+export type UseGeolocationParams = {
+    /** Start requesting the position (default `true`). Set `false` to defer the permission prompt. */
+    enabled?: boolean;
+    /** Keep watching for position updates instead of a one-shot read (default `true`). */
+    watch?: boolean;
+    /** `PositionOptions.enableHighAccuracy`. */
+    enableHighAccuracy?: boolean;
+    /** `PositionOptions.maximumAge` in milliseconds. */
+    maximumAge?: number;
+    /** `PositionOptions.timeout` in milliseconds. */
+    timeout?: number;
+};
+export type UseGeolocationResult = {
+    /** Whether `navigator.geolocation` exists in this browser. */
+    isSupported: boolean;
+    /** True while enabled and no position or error has arrived yet. */
+    loading: boolean;
+    /** Permission state from the Permissions API (`"unknown"` where unsupported or before resolution). */
+    permission: PermissionState | "unknown";
+    /** Latest position snapshot, or `null` before the first fix. */
+    position: GeolocationCoordinatesSnapshot | null;
+    /** Latest geolocation error, cleared when a new fix succeeds. */
+    error: GeolocationPositionError | null;
+};
+/**
+ * Browser geolocation with loading, error, and Permissions API state.
+ *
+ * - Requesting the position triggers the browser permission prompt; pass `enabled: false`
+ *   and flip it from a user gesture to avoid prompting on mount.
+ * - `watch: true` (default) uses `watchPosition` for live updates; `false` reads once.
+ * - `permission` mirrors `navigator.permissions.query({ name: "geolocation" })` including
+ *   change events, independent of whether a request is active.
+ *
+ * @param params - {@link UseGeolocationParams}
+ * @returns {@link UseGeolocationResult}
+ */
+export declare function useGeolocation(params?: UseGeolocationParams): UseGeolocationResult;
+//# sourceMappingURL=useGeolocation.d.ts.map

package/dist/hooks/useGeolocation/useGeolocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGeolocation.d.ts","sourceRoot":"","sources":["../../../src/hooks/useGeolocation/useGeolocation.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,8BAA8B,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,kGAAkG;IAClG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sFAAsF;IACtF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,8DAA8D;IAC9D,WAAW,EAAE,OAAO,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,sGAAsG;IACtG,UAAU,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,gEAAgE;IAChE,QAAQ,EAAE,8BAA8B,GAAG,IAAI,CAAC;IAChD,iEAAiE;IACjE,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACxC,CAAC;AAgBF;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,oBAAyB,GAChC,oBAAoB,CAuGtB"}

package/dist/hooks/useGeolocation.js

@@ -0,0 +1,111 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function toSnapshot(position) {
+  const { coords } = position;
+  return {
+    latitude: coords.latitude,
+    longitude: coords.longitude,
+    accuracy: coords.accuracy,
+    altitude: coords.altitude,
+    altitudeAccuracy: coords.altitudeAccuracy,
+    heading: coords.heading,
+    speed: coords.speed,
+    timestamp: position.timestamp
+  };
+}
+function useGeolocation(params = {}) {
+  const {
+    enabled = true,
+    watch = true,
+    enableHighAccuracy,
+    maximumAge,
+    timeout
+  } = params;
+  const isSupported = typeof navigator !== "undefined" && "geolocation" in navigator;
+  const [permission, setPermission] = react.useState(
+    "unknown"
+  );
+  const [position, setPosition] = react.useState(null);
+  const [error, setError] = react.useState(null);
+  const [settled, setSettled] = react.useState(false);
+  react.useEffect(() => {
+    if (typeof navigator === "undefined" || navigator.permissions?.query == null) {
+      return;
+    }
+    let active = true;
+    let status;
+    const onChange = () => {
+      if (active && status) {
+        setPermission(status.state);
+      }
+    };
+    navigator.permissions.query({ name: "geolocation" }).then((result) => {
+      if (!active) {
+        return;
+      }
+      status = result;
+      setPermission(result.state);
+      result.addEventListener("change", onChange);
+    }).catch(() => {
+    });
+    return () => {
+      active = false;
+      status?.removeEventListener("change", onChange);
+    };
+  }, []);
+  react.useEffect(() => {
+    if (!enabled || !isSupported) {
+      return;
+    }
+    const geolocation = navigator.geolocation;
+    let active = true;
+    setSettled(false);
+    const onSuccess = (next) => {
+      if (!active) {
+        return;
+      }
+      setPosition(toSnapshot(next));
+      setError(null);
+      setSettled(true);
+    };
+    const onError = (nextError) => {
+      if (!active) {
+        return;
+      }
+      setError(nextError);
+      setSettled(true);
+    };
+    const options = {
+      enableHighAccuracy,
+      maximumAge,
+      timeout
+    };
+    let watchId;
+    if (watch) {
+      watchId = geolocation.watchPosition(onSuccess, onError, options);
+    } else {
+      geolocation.getCurrentPosition(onSuccess, onError, options);
+    }
+    return () => {
+      active = false;
+      if (watchId !== void 0) {
+        geolocation.clearWatch(watchId);
+      }
+    };
+  }, [enableHighAccuracy, enabled, isSupported, maximumAge, timeout, watch]);
+  return {
+    isSupported,
+    loading: enabled && isSupported && !settled,
+    permission,
+    position,
+    error
+  };
+}
+
+exports.useGeolocation = useGeolocation;
+//# sourceMappingURL=useGeolocation.js.map
+//# sourceMappingURL=useGeolocation.js.map

package/dist/hooks/useGeolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useGeolocation/useGeolocation.ts"],"names":["useState","useEffect"],"mappings":"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","file":"useGeolocation.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\nexport type GeolocationCoordinatesSnapshot = {\n  latitude: number;\n  longitude: number;\n  accuracy: number;\n  altitude: number | null;\n  altitudeAccuracy: number | null;\n  heading: number | null;\n  speed: number | null;\n  timestamp: number;\n};\n\nexport type UseGeolocationParams = {\n  /** Start requesting the position (default `true`). Set `false` to defer the permission prompt. */\n  enabled?: boolean;\n  /** Keep watching for position updates instead of a one-shot read (default `true`). */\n  watch?: boolean;\n  /** `PositionOptions.enableHighAccuracy`. */\n  enableHighAccuracy?: boolean;\n  /** `PositionOptions.maximumAge` in milliseconds. */\n  maximumAge?: number;\n  /** `PositionOptions.timeout` in milliseconds. */\n  timeout?: number;\n};\n\nexport type UseGeolocationResult = {\n  /** Whether `navigator.geolocation` exists in this browser. */\n  isSupported: boolean;\n  /** True while enabled and no position or error has arrived yet. */\n  loading: boolean;\n  /** Permission state from the Permissions API (`\"unknown\"` where unsupported or before resolution). */\n  permission: PermissionState | \"unknown\";\n  /** Latest position snapshot, or `null` before the first fix. */\n  position: GeolocationCoordinatesSnapshot | null;\n  /** Latest geolocation error, cleared when a new fix succeeds. */\n  error: GeolocationPositionError | null;\n};\n\nfunction toSnapshot(position: GeolocationPosition): GeolocationCoordinatesSnapshot {\n  const { coords } = position;\n  return {\n    latitude: coords.latitude,\n    longitude: coords.longitude,\n    accuracy: coords.accuracy,\n    altitude: coords.altitude,\n    altitudeAccuracy: coords.altitudeAccuracy,\n    heading: coords.heading,\n    speed: coords.speed,\n    timestamp: position.timestamp,\n  };\n}\n\n/**\n * Browser geolocation with loading, error, and Permissions API state.\n *\n * - Requesting the position triggers the browser permission prompt; pass `enabled: false`\n *   and flip it from a user gesture to avoid prompting on mount.\n * - `watch: true` (default) uses `watchPosition` for live updates; `false` reads once.\n * - `permission` mirrors `navigator.permissions.query({ name: \"geolocation\" })` including\n *   change events, independent of whether a request is active.\n *\n * @param params - {@link UseGeolocationParams}\n * @returns {@link UseGeolocationResult}\n */\nexport function useGeolocation(\n  params: UseGeolocationParams = {},\n): UseGeolocationResult {\n  const {\n    enabled = true,\n    watch = true,\n    enableHighAccuracy,\n    maximumAge,\n    timeout,\n  } = params;\n\n  const isSupported =\n    typeof navigator !== \"undefined\" && \"geolocation\" in navigator;\n\n  const [permission, setPermission] = useState<PermissionState | \"unknown\">(\n    \"unknown\",\n  );\n  const [position, setPosition] =\n    useState<GeolocationCoordinatesSnapshot | null>(null);\n  const [error, setError] = useState<GeolocationPositionError | null>(null);\n  const [settled, setSettled] = useState(false);\n\n  useEffect(() => {\n    if (\n      typeof navigator === \"undefined\" ||\n      navigator.permissions?.query == null\n    ) {\n      return;\n    }\n    let active = true;\n    let status: PermissionStatus | undefined;\n    const onChange = () => {\n      if (active && status) {\n        setPermission(status.state);\n      }\n    };\n    navigator.permissions\n      .query({ name: \"geolocation\" })\n      .then((result) => {\n        // Guard against the component unmounting before this promise resolves,\n        // which would otherwise attach a listener that can never be cleaned up.\n        if (!active) {\n          return;\n        }\n        status = result;\n        setPermission(result.state);\n        result.addEventListener(\"change\", onChange);\n      })\n      .catch(() => {\n        /* permissions API may reject for geolocation in some browsers */\n      });\n    return () => {\n      active = false;\n      status?.removeEventListener(\"change\", onChange);\n    };\n  }, []);\n\n  useEffect(() => {\n    if (!enabled || !isSupported) {\n      return;\n    }\n    const geolocation = navigator.geolocation;\n    let active = true;\n    setSettled(false);\n    const onSuccess = (next: GeolocationPosition) => {\n      if (!active) {\n        return;\n      }\n      setPosition(toSnapshot(next));\n      setError(null);\n      setSettled(true);\n    };\n    const onError = (nextError: GeolocationPositionError) => {\n      if (!active) {\n        return;\n      }\n      setError(nextError);\n      setSettled(true);\n    };\n    const options: PositionOptions = {\n      enableHighAccuracy,\n      maximumAge,\n      timeout,\n    };\n    let watchId: number | undefined;\n    if (watch) {\n      watchId = geolocation.watchPosition(onSuccess, onError, options);\n    } else {\n      geolocation.getCurrentPosition(onSuccess, onError, options);\n    }\n    return () => {\n      active = false;\n      if (watchId !== undefined) {\n        geolocation.clearWatch(watchId);\n      }\n    };\n  }, [enableHighAccuracy, enabled, isSupported, maximumAge, timeout, watch]);\n\n  return {\n    isSupported,\n    loading: enabled && isSupported && !settled,\n    permission,\n    position,\n    error,\n  };\n}\n"]}

package/dist/hooks/useGeolocation.mjs

@@ -0,0 +1,109 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useState, useEffect } from 'react';
+
+function toSnapshot(position) {
+  const { coords } = position;
+  return {
+    latitude: coords.latitude,
+    longitude: coords.longitude,
+    accuracy: coords.accuracy,
+    altitude: coords.altitude,
+    altitudeAccuracy: coords.altitudeAccuracy,
+    heading: coords.heading,
+    speed: coords.speed,
+    timestamp: position.timestamp
+  };
+}
+function useGeolocation(params = {}) {
+  const {
+    enabled = true,
+    watch = true,
+    enableHighAccuracy,
+    maximumAge,
+    timeout
+  } = params;
+  const isSupported = typeof navigator !== "undefined" && "geolocation" in navigator;
+  const [permission, setPermission] = useState(
+    "unknown"
+  );
+  const [position, setPosition] = useState(null);
+  const [error, setError] = useState(null);
+  const [settled, setSettled] = useState(false);
+  useEffect(() => {
+    if (typeof navigator === "undefined" || navigator.permissions?.query == null) {
+      return;
+    }
+    let active = true;
+    let status;
+    const onChange = () => {
+      if (active && status) {
+        setPermission(status.state);
+      }
+    };
+    navigator.permissions.query({ name: "geolocation" }).then((result) => {
+      if (!active) {
+        return;
+      }
+      status = result;
+      setPermission(result.state);
+      result.addEventListener("change", onChange);
+    }).catch(() => {
+    });
+    return () => {
+      active = false;
+      status?.removeEventListener("change", onChange);
+    };
+  }, []);
+  useEffect(() => {
+    if (!enabled || !isSupported) {
+      return;
+    }
+    const geolocation = navigator.geolocation;
+    let active = true;
+    setSettled(false);
+    const onSuccess = (next) => {
+      if (!active) {
+        return;
+      }
+      setPosition(toSnapshot(next));
+      setError(null);
+      setSettled(true);
+    };
+    const onError = (nextError) => {
+      if (!active) {
+        return;
+      }
+      setError(nextError);
+      setSettled(true);
+    };
+    const options = {
+      enableHighAccuracy,
+      maximumAge,
+      timeout
+    };
+    let watchId;
+    if (watch) {
+      watchId = geolocation.watchPosition(onSuccess, onError, options);
+    } else {
+      geolocation.getCurrentPosition(onSuccess, onError, options);
+    }
+    return () => {
+      active = false;
+      if (watchId !== void 0) {
+        geolocation.clearWatch(watchId);
+      }
+    };
+  }, [enableHighAccuracy, enabled, isSupported, maximumAge, timeout, watch]);
+  return {
+    isSupported,
+    loading: enabled && isSupported && !settled,
+    permission,
+    position,
+    error
+  };
+}
+
+export { useGeolocation };
+//# sourceMappingURL=useGeolocation.mjs.map
+//# sourceMappingURL=useGeolocation.mjs.map

package/dist/hooks/useGeolocation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useGeolocation/useGeolocation.ts"],"names":[],"mappings":"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","file":"useGeolocation.mjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\nexport type GeolocationCoordinatesSnapshot = {\n  latitude: number;\n  longitude: number;\n  accuracy: number;\n  altitude: number | null;\n  altitudeAccuracy: number | null;\n  heading: number | null;\n  speed: number | null;\n  timestamp: number;\n};\n\nexport type UseGeolocationParams = {\n  /** Start requesting the position (default `true`). Set `false` to defer the permission prompt. */\n  enabled?: boolean;\n  /** Keep watching for position updates instead of a one-shot read (default `true`). */\n  watch?: boolean;\n  /** `PositionOptions.enableHighAccuracy`. */\n  enableHighAccuracy?: boolean;\n  /** `PositionOptions.maximumAge` in milliseconds. */\n  maximumAge?: number;\n  /** `PositionOptions.timeout` in milliseconds. */\n  timeout?: number;\n};\n\nexport type UseGeolocationResult = {\n  /** Whether `navigator.geolocation` exists in this browser. */\n  isSupported: boolean;\n  /** True while enabled and no position or error has arrived yet. */\n  loading: boolean;\n  /** Permission state from the Permissions API (`\"unknown\"` where unsupported or before resolution). */\n  permission: PermissionState | \"unknown\";\n  /** Latest position snapshot, or `null` before the first fix. */\n  position: GeolocationCoordinatesSnapshot | null;\n  /** Latest geolocation error, cleared when a new fix succeeds. */\n  error: GeolocationPositionError | null;\n};\n\nfunction toSnapshot(position: GeolocationPosition): GeolocationCoordinatesSnapshot {\n  const { coords } = position;\n  return {\n    latitude: coords.latitude,\n    longitude: coords.longitude,\n    accuracy: coords.accuracy,\n    altitude: coords.altitude,\n    altitudeAccuracy: coords.altitudeAccuracy,\n    heading: coords.heading,\n    speed: coords.speed,\n    timestamp: position.timestamp,\n  };\n}\n\n/**\n * Browser geolocation with loading, error, and Permissions API state.\n *\n * - Requesting the position triggers the browser permission prompt; pass `enabled: false`\n *   and flip it from a user gesture to avoid prompting on mount.\n * - `watch: true` (default) uses `watchPosition` for live updates; `false` reads once.\n * - `permission` mirrors `navigator.permissions.query({ name: \"geolocation\" })` including\n *   change events, independent of whether a request is active.\n *\n * @param params - {@link UseGeolocationParams}\n * @returns {@link UseGeolocationResult}\n */\nexport function useGeolocation(\n  params: UseGeolocationParams = {},\n): UseGeolocationResult {\n  const {\n    enabled = true,\n    watch = true,\n    enableHighAccuracy,\n    maximumAge,\n    timeout,\n  } = params;\n\n  const isSupported =\n    typeof navigator !== \"undefined\" && \"geolocation\" in navigator;\n\n  const [permission, setPermission] = useState<PermissionState | \"unknown\">(\n    \"unknown\",\n  );\n  const [position, setPosition] =\n    useState<GeolocationCoordinatesSnapshot | null>(null);\n  const [error, setError] = useState<GeolocationPositionError | null>(null);\n  const [settled, setSettled] = useState(false);\n\n  useEffect(() => {\n    if (\n      typeof navigator === \"undefined\" ||\n      navigator.permissions?.query == null\n    ) {\n      return;\n    }\n    let active = true;\n    let status: PermissionStatus | undefined;\n    const onChange = () => {\n      if (active && status) {\n        setPermission(status.state);\n      }\n    };\n    navigator.permissions\n      .query({ name: \"geolocation\" })\n      .then((result) => {\n        // Guard against the component unmounting before this promise resolves,\n        // which would otherwise attach a listener that can never be cleaned up.\n        if (!active) {\n          return;\n        }\n        status = result;\n        setPermission(result.state);\n        result.addEventListener(\"change\", onChange);\n      })\n      .catch(() => {\n        /* permissions API may reject for geolocation in some browsers */\n      });\n    return () => {\n      active = false;\n      status?.removeEventListener(\"change\", onChange);\n    };\n  }, []);\n\n  useEffect(() => {\n    if (!enabled || !isSupported) {\n      return;\n    }\n    const geolocation = navigator.geolocation;\n    let active = true;\n    setSettled(false);\n    const onSuccess = (next: GeolocationPosition) => {\n      if (!active) {\n        return;\n      }\n      setPosition(toSnapshot(next));\n      setError(null);\n      setSettled(true);\n    };\n    const onError = (nextError: GeolocationPositionError) => {\n      if (!active) {\n        return;\n      }\n      setError(nextError);\n      setSettled(true);\n    };\n    const options: PositionOptions = {\n      enableHighAccuracy,\n      maximumAge,\n      timeout,\n    };\n    let watchId: number | undefined;\n    if (watch) {\n      watchId = geolocation.watchPosition(onSuccess, onError, options);\n    } else {\n      geolocation.getCurrentPosition(onSuccess, onError, options);\n    }\n    return () => {\n      active = false;\n      if (watchId !== undefined) {\n        geolocation.clearWatch(watchId);\n      }\n    };\n  }, [enableHighAccuracy, enabled, isSupported, maximumAge, timeout, watch]);\n\n  return {\n    isSupported,\n    loading: enabled && isSupported && !settled,\n    permission,\n    position,\n    error,\n  };\n}\n"]}

package/dist/hooks/useHotkeys/index.d.ts

@@ -0,0 +1,2 @@
+export { useHotkeys, type HotkeyHandler, type UseHotkeysOptions, } from "./useHotkeys";
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/useHotkeys/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/useHotkeys/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC"}

package/dist/hooks/useHotkeys/useHotkeys.d.ts

@@ -0,0 +1,24 @@
+export type HotkeyHandler = (event: KeyboardEvent) => void;
+export type UseHotkeysOptions = {
+    /** Disable all bindings without unmounting (default `true`). */
+    enabled?: boolean;
+    /** Call `event.preventDefault()` on a match (default `true`). */
+    preventDefault?: boolean;
+    /** Fire even when typing in inputs, textareas, selects, or contentEditable (default `false`). */
+    allowInInputs?: boolean;
+};
+/**
+ * Binds keyboard shortcut combos (e.g. `"mod+k"`, `"ctrl+shift+p"`, `"escape"`) to handlers on `window`.
+ *
+ * - Combo syntax: modifier tokens (`ctrl`/`control`, `meta`/`cmd`/`command`, `alt`/`option`, `shift`,
+ *   `mod`) joined with `+` around a final key matched against `event.key` (use `space` for the spacebar).
+ * - `mod` matches Cmd on macOS *or* Ctrl elsewhere (it accepts either modifier).
+ * - Bindings are read from a ref on every keydown, so inline objects and closures stay fresh
+ *   without re-subscribing.
+ * - Shortcuts are suppressed while typing in form fields or contentEditable unless `allowInInputs`.
+ *
+ * @param bindings - Map of combo string → handler. The first matching combo wins per event.
+ * @param options - {@link UseHotkeysOptions}
+ */
+export declare function useHotkeys(bindings: Record<string, HotkeyHandler>, options?: UseHotkeysOptions): void;
+//# sourceMappingURL=useHotkeys.d.ts.map

package/dist/hooks/useHotkeys/useHotkeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHotkeys.d.ts","sourceRoot":"","sources":["../../../src/hooks/useHotkeys/useHotkeys.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iGAAiG;IACjG,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAoEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,OAAO,GAAE,iBAAsB,GAC9B,IAAI,CAgCN"}

package/dist/hooks/useHotkeys.js

@@ -0,0 +1,86 @@
+"use client";
+'use strict';
+
+require('../chunk-PZ5AY32C.js');
+var react = require('react');
+
+function parseHotkey(combo) {
+  const parsed = {
+    key: "",
+    ctrl: false,
+    meta: false,
+    alt: false,
+    shift: false,
+    mod: false
+  };
+  for (const raw of combo.split("+")) {
+    const token = raw.trim().toLowerCase();
+    if (token === "ctrl" || token === "control") {
+      parsed.ctrl = true;
+    } else if (token === "meta" || token === "cmd" || token === "command") {
+      parsed.meta = true;
+    } else if (token === "alt" || token === "option") {
+      parsed.alt = true;
+    } else if (token === "shift") {
+      parsed.shift = true;
+    } else if (token === "mod") {
+      parsed.mod = true;
+    } else {
+      parsed.key = token === "space" ? " " : token;
+    }
+  }
+  return parsed;
+}
+function matchesHotkey(event, hotkey) {
+  if (hotkey.key !== event.key.toLowerCase()) {
+    return false;
+  }
+  if (hotkey.mod) {
+    if (!event.ctrlKey && !event.metaKey) {
+      return false;
+    }
+  } else if (hotkey.ctrl !== event.ctrlKey || hotkey.meta !== event.metaKey) {
+    return false;
+  }
+  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;
+}
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) {
+    return false;
+  }
+  return target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT" || target.isContentEditable;
+}
+function useHotkeys(bindings, options = {}) {
+  const { enabled = true, preventDefault = true, allowInInputs = false } = options;
+  const bindingsRef = react.useRef(bindings);
+  react.useEffect(() => {
+    bindingsRef.current = bindings;
+  }, [bindings]);
+  react.useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    const onKeyDown = (event) => {
+      if (!allowInInputs && isEditableTarget(event.target)) {
+        return;
+      }
+      for (const [combo, handler] of Object.entries(bindingsRef.current)) {
+        if (matchesHotkey(event, parseHotkey(combo))) {
+          if (preventDefault) {
+            event.preventDefault();
+          }
+          handler(event);
+          return;
+        }
+      }
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => {
+      window.removeEventListener("keydown", onKeyDown);
+    };
+  }, [allowInInputs, enabled, preventDefault]);
+}
+
+exports.useHotkeys = useHotkeys;
+//# sourceMappingURL=useHotkeys.js.map
+//# sourceMappingURL=useHotkeys.js.map

package/dist/hooks/useHotkeys.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useHotkeys/useHotkeys.ts"],"names":["useRef","useEffect"],"mappings":"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","file":"useHotkeys.js","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\nexport type HotkeyHandler = (event: KeyboardEvent) => void;\n\nexport type UseHotkeysOptions = {\n  /** Disable all bindings without unmounting (default `true`). */\n  enabled?: boolean;\n  /** Call `event.preventDefault()` on a match (default `true`). */\n  preventDefault?: boolean;\n  /** Fire even when typing in inputs, textareas, selects, or contentEditable (default `false`). */\n  allowInInputs?: boolean;\n};\n\ntype ParsedHotkey = {\n  key: string;\n  ctrl: boolean;\n  meta: boolean;\n  alt: boolean;\n  shift: boolean;\n  mod: boolean;\n};\n\nfunction parseHotkey(combo: string): ParsedHotkey {\n  const parsed: ParsedHotkey = {\n    key: \"\",\n    ctrl: false,\n    meta: false,\n    alt: false,\n    shift: false,\n    mod: false,\n  };\n  for (const raw of combo.split(\"+\")) {\n    const token = raw.trim().toLowerCase();\n    if (token === \"ctrl\" || token === \"control\") {\n      parsed.ctrl = true;\n    } else if (token === \"meta\" || token === \"cmd\" || token === \"command\") {\n      parsed.meta = true;\n    } else if (token === \"alt\" || token === \"option\") {\n      parsed.alt = true;\n    } else if (token === \"shift\") {\n      parsed.shift = true;\n    } else if (token === \"mod\") {\n      parsed.mod = true;\n    } else {\n      parsed.key = token === \"space\" ? \" \" : token;\n    }\n  }\n  return parsed;\n}\n\nfunction matchesHotkey(event: KeyboardEvent, hotkey: ParsedHotkey): boolean {\n  if (hotkey.key !== event.key.toLowerCase()) {\n    return false;\n  }\n  if (hotkey.mod) {\n    if (!event.ctrlKey && !event.metaKey) {\n      return false;\n    }\n  } else if (\n    hotkey.ctrl !== event.ctrlKey ||\n    hotkey.meta !== event.metaKey\n  ) {\n    return false;\n  }\n  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;\n}\n\nfunction isEditableTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) {\n    return false;\n  }\n  return (\n    target.tagName === \"INPUT\" ||\n    target.tagName === \"TEXTAREA\" ||\n    target.tagName === \"SELECT\" ||\n    target.isContentEditable\n  );\n}\n\n/**\n * Binds keyboard shortcut combos (e.g. `\"mod+k\"`, `\"ctrl+shift+p\"`, `\"escape\"`) to handlers on `window`.\n *\n * - Combo syntax: modifier tokens (`ctrl`/`control`, `meta`/`cmd`/`command`, `alt`/`option`, `shift`,\n *   `mod`) joined with `+` around a final key matched against `event.key` (use `space` for the spacebar).\n * - `mod` matches Cmd on macOS *or* Ctrl elsewhere (it accepts either modifier).\n * - Bindings are read from a ref on every keydown, so inline objects and closures stay fresh\n *   without re-subscribing.\n * - Shortcuts are suppressed while typing in form fields or contentEditable unless `allowInInputs`.\n *\n * @param bindings - Map of combo string → handler. The first matching combo wins per event.\n * @param options - {@link UseHotkeysOptions}\n */\nexport function useHotkeys(\n  bindings: Record<string, HotkeyHandler>,\n  options: UseHotkeysOptions = {},\n): void {\n  const { enabled = true, preventDefault = true, allowInInputs = false } =\n    options;\n  const bindingsRef = useRef(bindings);\n\n  useEffect(() => {\n    bindingsRef.current = bindings;\n  }, [bindings]);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (!allowInInputs && isEditableTarget(event.target)) {\n        return;\n      }\n      for (const [combo, handler] of Object.entries(bindingsRef.current)) {\n        if (matchesHotkey(event, parseHotkey(combo))) {\n          if (preventDefault) {\n            event.preventDefault();\n          }\n          handler(event);\n          return;\n        }\n      }\n    };\n    window.addEventListener(\"keydown\", onKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", onKeyDown);\n    };\n  }, [allowInInputs, enabled, preventDefault]);\n}\n"]}

package/dist/hooks/useHotkeys.mjs

@@ -0,0 +1,84 @@
+"use client";
+import '../chunk-J5LGTIGS.mjs';
+import { useRef, useEffect } from 'react';
+
+function parseHotkey(combo) {
+  const parsed = {
+    key: "",
+    ctrl: false,
+    meta: false,
+    alt: false,
+    shift: false,
+    mod: false
+  };
+  for (const raw of combo.split("+")) {
+    const token = raw.trim().toLowerCase();
+    if (token === "ctrl" || token === "control") {
+      parsed.ctrl = true;
+    } else if (token === "meta" || token === "cmd" || token === "command") {
+      parsed.meta = true;
+    } else if (token === "alt" || token === "option") {
+      parsed.alt = true;
+    } else if (token === "shift") {
+      parsed.shift = true;
+    } else if (token === "mod") {
+      parsed.mod = true;
+    } else {
+      parsed.key = token === "space" ? " " : token;
+    }
+  }
+  return parsed;
+}
+function matchesHotkey(event, hotkey) {
+  if (hotkey.key !== event.key.toLowerCase()) {
+    return false;
+  }
+  if (hotkey.mod) {
+    if (!event.ctrlKey && !event.metaKey) {
+      return false;
+    }
+  } else if (hotkey.ctrl !== event.ctrlKey || hotkey.meta !== event.metaKey) {
+    return false;
+  }
+  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;
+}
+function isEditableTarget(target) {
+  if (!(target instanceof HTMLElement)) {
+    return false;
+  }
+  return target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT" || target.isContentEditable;
+}
+function useHotkeys(bindings, options = {}) {
+  const { enabled = true, preventDefault = true, allowInInputs = false } = options;
+  const bindingsRef = useRef(bindings);
+  useEffect(() => {
+    bindingsRef.current = bindings;
+  }, [bindings]);
+  useEffect(() => {
+    if (!enabled) {
+      return;
+    }
+    const onKeyDown = (event) => {
+      if (!allowInInputs && isEditableTarget(event.target)) {
+        return;
+      }
+      for (const [combo, handler] of Object.entries(bindingsRef.current)) {
+        if (matchesHotkey(event, parseHotkey(combo))) {
+          if (preventDefault) {
+            event.preventDefault();
+          }
+          handler(event);
+          return;
+        }
+      }
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => {
+      window.removeEventListener("keydown", onKeyDown);
+    };
+  }, [allowInInputs, enabled, preventDefault]);
+}
+
+export { useHotkeys };
+//# sourceMappingURL=useHotkeys.mjs.map
+//# sourceMappingURL=useHotkeys.mjs.map

package/dist/hooks/useHotkeys.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useHotkeys/useHotkeys.ts"],"names":[],"mappings":"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","file":"useHotkeys.mjs","sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\n\nexport type HotkeyHandler = (event: KeyboardEvent) => void;\n\nexport type UseHotkeysOptions = {\n  /** Disable all bindings without unmounting (default `true`). */\n  enabled?: boolean;\n  /** Call `event.preventDefault()` on a match (default `true`). */\n  preventDefault?: boolean;\n  /** Fire even when typing in inputs, textareas, selects, or contentEditable (default `false`). */\n  allowInInputs?: boolean;\n};\n\ntype ParsedHotkey = {\n  key: string;\n  ctrl: boolean;\n  meta: boolean;\n  alt: boolean;\n  shift: boolean;\n  mod: boolean;\n};\n\nfunction parseHotkey(combo: string): ParsedHotkey {\n  const parsed: ParsedHotkey = {\n    key: \"\",\n    ctrl: false,\n    meta: false,\n    alt: false,\n    shift: false,\n    mod: false,\n  };\n  for (const raw of combo.split(\"+\")) {\n    const token = raw.trim().toLowerCase();\n    if (token === \"ctrl\" || token === \"control\") {\n      parsed.ctrl = true;\n    } else if (token === \"meta\" || token === \"cmd\" || token === \"command\") {\n      parsed.meta = true;\n    } else if (token === \"alt\" || token === \"option\") {\n      parsed.alt = true;\n    } else if (token === \"shift\") {\n      parsed.shift = true;\n    } else if (token === \"mod\") {\n      parsed.mod = true;\n    } else {\n      parsed.key = token === \"space\" ? \" \" : token;\n    }\n  }\n  return parsed;\n}\n\nfunction matchesHotkey(event: KeyboardEvent, hotkey: ParsedHotkey): boolean {\n  if (hotkey.key !== event.key.toLowerCase()) {\n    return false;\n  }\n  if (hotkey.mod) {\n    if (!event.ctrlKey && !event.metaKey) {\n      return false;\n    }\n  } else if (\n    hotkey.ctrl !== event.ctrlKey ||\n    hotkey.meta !== event.metaKey\n  ) {\n    return false;\n  }\n  return hotkey.alt === event.altKey && hotkey.shift === event.shiftKey;\n}\n\nfunction isEditableTarget(target: EventTarget | null): boolean {\n  if (!(target instanceof HTMLElement)) {\n    return false;\n  }\n  return (\n    target.tagName === \"INPUT\" ||\n    target.tagName === \"TEXTAREA\" ||\n    target.tagName === \"SELECT\" ||\n    target.isContentEditable\n  );\n}\n\n/**\n * Binds keyboard shortcut combos (e.g. `\"mod+k\"`, `\"ctrl+shift+p\"`, `\"escape\"`) to handlers on `window`.\n *\n * - Combo syntax: modifier tokens (`ctrl`/`control`, `meta`/`cmd`/`command`, `alt`/`option`, `shift`,\n *   `mod`) joined with `+` around a final key matched against `event.key` (use `space` for the spacebar).\n * - `mod` matches Cmd on macOS *or* Ctrl elsewhere (it accepts either modifier).\n * - Bindings are read from a ref on every keydown, so inline objects and closures stay fresh\n *   without re-subscribing.\n * - Shortcuts are suppressed while typing in form fields or contentEditable unless `allowInInputs`.\n *\n * @param bindings - Map of combo string → handler. The first matching combo wins per event.\n * @param options - {@link UseHotkeysOptions}\n */\nexport function useHotkeys(\n  bindings: Record<string, HotkeyHandler>,\n  options: UseHotkeysOptions = {},\n): void {\n  const { enabled = true, preventDefault = true, allowInInputs = false } =\n    options;\n  const bindingsRef = useRef(bindings);\n\n  useEffect(() => {\n    bindingsRef.current = bindings;\n  }, [bindings]);\n\n  useEffect(() => {\n    if (!enabled) {\n      return;\n    }\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (!allowInInputs && isEditableTarget(event.target)) {\n        return;\n      }\n      for (const [combo, handler] of Object.entries(bindingsRef.current)) {\n        if (matchesHotkey(event, parseHotkey(combo))) {\n          if (preventDefault) {\n            event.preventDefault();\n          }\n          handler(event);\n          return;\n        }\n      }\n    };\n    window.addEventListener(\"keydown\", onKeyDown);\n    return () => {\n      window.removeEventListener(\"keydown\", onKeyDown);\n    };\n  }, [allowInInputs, enabled, preventDefault]);\n}\n"]}