react-dismiss 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 react-dismiss
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 react-dismiss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,6 @@
 # react-dismiss
 
-A tiny React hook for dismissing UI on outside interaction or Escape.
-
-Tiny, dependency-free, SSR-safe, StrictMode-safe, TypeScript-first. Ideal for dropdowns, popovers, modals, menus, and overlays.
+A tiny React hook for dismissing UI when users interact outside or press Escape.
 
 ## Installation
 
@@ -18,223 +16,86 @@ pnpm add react-dismiss
 yarn add react-dismiss
 ```
 
-Requires `react >= 18` (peer dependency).
-
 ## Quick Start
 
 ```tsx
 import { useRef, useState } from "react";
 import { useDismiss } from "react-dismiss";
 
-function Dropdown() {
-  const [open, setOpen] = useState(false);
-  const ref = useRef<HTMLDivElement>(null);
+export function Dropdown() {
+  const [isOpen, setIsOpen] = useState(false);
+  const menuRef = useRef<HTMLDivElement>(null);
 
-  useDismiss(ref, () => {
-    setOpen(false);
-  });
+  useDismiss(menuRef, () => setIsOpen(false));
 
   return (
-    <div ref={ref}>
-      <button onClick={() => setOpen((v) => !v)}>Menu</button>
-      {open && <div>Dropdown content</div>}
+    <div ref={menuRef} style={{ position: "relative", display: "inline-block" }}>
+      <button onClick={() => setIsOpen((prev) => !prev)}>Toggle Menu</button>
+      {isOpen && (
+        <ul
+          style={{
+            position: "absolute",
+            top: "100%",
+            left: 0,
+            background: "#fff",
+            border: "1px solid #ccc",
+            padding: "8px",
+            listStyle: "none",
+          }}
+        >
+          <li>Profile</li>
+          <li>Settings</li>
+          <li>Log out</li>
+        </ul>
+      )}
     </div>
   );
 }
 ```
 
-## How It Works
-
-```
-Interaction inside element  → ignore
-Interaction outside element → onDismiss()
-Escape key                 → onDismiss()
-```
-
-- Outside detection uses `element.contains(event.target)` — descendants are considered inside. Safe when `ref.current === null`.
-- Escape handling listens for `keydown` with `key === "Escape"`.
-- Listeners are attached to `document` inside `useEffect` (no SSR side-effects).
-
 ## API
 
 ```ts
-useDismiss(ref, onDismiss, options?)
+useDismiss<T extends HTMLElement>(
+  ref: React.RefObject<T | null>,
+  onDismiss: () => void,
+  options?: UseDismissOptions
+): void
 ```
 
-### `ref`
-
-`React.RefObject<T extends HTMLElement>` — the element considered "inside". Attach it to the root of the dismissible UI.
-
-### `onDismiss`
-
-`() => void` — called on dismissal. Latest callback is always used (ref-stable). Errors are not swallowed.
-
-### `options`
+### Arguments
 
-| Option    | Type                         | Default         | Description                               |
-| --------- | ---------------------------- | --------------- | ----------------------------------------- |
-| `enabled` | `boolean`                    | `true`          | Master toggle. `false` removes listeners. |
-| `outside` | `boolean`                    | `true`          | Enable outside interaction dismissal.     |
-| `escape`  | `boolean`                    | `true`          | Enable Escape key dismissal.              |
-| `event`   | `"pointerdown"` \| `"click"` | `"pointerdown"` | DOM event for outside detection.          |
+- `ref`: `React.RefObject<T | null>` — React ref attached to the element considered "inside".
+- `onDismiss`: `() => void` — Callback invoked when dismissal triggers. Ref-stable internally so inline callbacks do not re-bind listeners.
+- `options`: `UseDismissOptions` (optional object):
+  - `enabled` (`boolean`, default: `true`): Master toggle to enable or disable dismissal listeners.
+  - `outside` (`boolean`, default: `true`): Whether outside pointer/click interactions trigger dismissal.
+  - `escape` (`boolean`, default: `true`): Whether pressing the `Escape` key triggers dismissal.
+  - `event` (`"pointerdown" | "click"`, default: `"pointerdown"`): DOM event used for outside interaction detection.
 
-All options are optional and can be toggled dynamically.
+### Returns
 
-## Options
+`void`
 
-```tsx
-// Disabled
-useDismiss(ref, close, { enabled: false });
-
-// Escape only
-useDismiss(ref, close, { outside: false });
-
-// Outside only
-useDismiss(ref, close, { escape: false });
-
-// Use click instead of pointerdown
-useDismiss(ref, close, { event: "click" });
-```
-
-## Examples
-
-### Dropdown
-
-```tsx
-const ref = useRef<HTMLDivElement>(null);
-useDismiss(ref, () => setOpen(false));
-```
-
-### Modal
-
-```tsx
-const ref = useRef<HTMLDivElement>(null);
-useDismiss(ref, closeModal);
-// Renders inside an overlay; Escape and outside click both close.
-```
-
-### Popover
-
-```tsx
-const ref = useRef<HTMLDivElement>(null);
-useDismiss(ref, () => setPopoverOpen(false));
-```
-
-### Search suggestions
-
-```tsx
-const ref = useRef<HTMLDivElement>(null);
-useDismiss(ref, () => setSuggestions([]));
-```
-
-### Escape-only (e.g., controlled modal where backdrop handles clicks)
-
-```tsx
-useDismiss(ref, close, { outside: false });
-```
-
-### Click event (when pointerdown is too eager)
-
-```tsx
-useDismiss(ref, close, { event: "click" });
-```
+## What It Handles
 
-See `examples/basic.tsx` for runnable demos.
+- Outside interactions (`pointerdown` or `click`) while ignoring clicks on descendants inside `ref`.
+- Escape key presses (`keydown` where `event.key === "Escape"`).
+- Null or unmounted refs without throwing errors.
+- Automatic event listener cleanup on component unmount or when options change.
+- SSR safe: guards document access and attaches listeners only inside client-side `useEffect`.
 
 ## TypeScript
 
-Fully typed, strict `no any`.
+Ships with built-in TypeScript declarations and generics (`dist/index.d.ts`), no extra `@types` packages required.
 
-```tsx
-const divRef = useRef<HTMLDivElement>(null);
-useDismiss(divRef, onDismiss); // infers HTMLDivElement
-
-const btnRef = useRef<HTMLButtonElement>(null);
-useDismiss(btnRef, onDismiss); // infers HTMLButtonElement
-```
-
-## SSR
-
-Safe for Next.js, Remix, Vite SSR, React Router. No browser globals are accessed at import time; listeners are registered inside `useEffect` only on the client.
-
-```tsx
-// This import never touches `document` at module init:
-import { useDismiss } from "react-dismiss";
-```
-
-## Accessibility
-
-> `react-dismiss` provides interaction detection, not complete accessibility behavior.
-
-You still need to handle:
-
-- Focus management / focus trapping for dialogs
-- `aria-expanded`, `aria-controls`, correct `role`
-- Keyboard navigation (arrow keys, tab order)
-- Screen-reader announcements
-
-Escape handling in this hook complements but does not replace those patterns. Pair it with proper ARIA:
-
-```tsx
-<button aria-expanded={open} aria-controls="menu">
-  Menu
-</button>
-<div id="menu" role="menu">{/* ... */}</div>
-```
-
-## Browser Support
-
-- Outside detection uses `PointerEvent` (`pointerdown`). All modern browsers support it (Chrome 55+, Firefox 59+, Safari 13+).
-- Fallback: pass `{ event: "click" }` if you must target older browsers.
-- Escape handling uses `keydown` + `key === "Escape"` (universally supported).
-
-## Bundle Size
-
-- ~1.3 KB uncompressed (`dist/index.js`), < 1 KB minified + gzipped.
-- Zero runtime dependencies.
-- Tree-shakeable (`sideEffects: false`).
-
-## Portals
-
-By default "inside" means descendants of `ref.current` (`element.contains`). Content rendered in a React portal outside that subtree is considered outside and will dismiss. If you need multiple "inside" roots, compose refs or lift the dismiss root to a common ancestor. A dedicated multi-root API is intentionally out of scope for v1.
-
-## Development
-
-```bash
-npm install
-npm run typecheck
-npm run lint
-npm run test:run
-npm run build
-```
-
-## Testing
-
-```bash
-npm run test        # watch
-npm run test:run    # single run
-```
-
-Tests cover outside/inside, Escape, other keys, null ref, enabled/outside/escape toggles, dynamic enable, event switching, stale closures, unmount cleanup, StrictMode, nested elements, multiple instances, and error propagation.
-
-## Building
-
-```bash
-npm run build       # tsup → dist/index.js, dist/index.cjs, dist/index.d.ts
-npm pack --dry-run  # inspect published contents
-```
-
-## Publishing
-
-```bash
-npm run check       # typecheck + lint + tests
-npm run build
-npm pack --dry-run  # verify files: dist/, README.md, LICENSE
-npm publish         # or OIDC trusted publishing via GitHub Actions
-```
+## Why This One
 
-Never commit secrets. If using GitHub Actions publishing, prefer OIDC over long-lived tokens.
+- **Zero dependencies**: Only requires `react` (>= 18) as a peer dependency.
+- **Tiny footprint**: ~1.3 KB uncompressed ESM/CJS build (< 1 KB minified + gzipped).
+- **Ref-stable callback**: Passing inline callback functions will not re-bind document listeners on re-render.
 
-## License
+## Links
 
-MIT — see [LICENSE](./LICENSE).
+- **npm**: [npmjs.com/package/react-dismiss](https://www.npmjs.com/package/react-dismiss)
+- **GitHub**: [github.com/parasraju/react-dismiss](https://github.com/parasraju/react-dismiss)

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useDismiss.ts"],"names":["useRef","useEffect"],"mappings":";;;;;AAGO,SAAS,UAAA,CACd,GAAA,EACA,SAAA,EACA,OAAA,GAA6B,EAAC,EACxB;AACN,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,IAAA;AAAA,IACV,OAAA,GAAU,IAAA;AAAA,IACV,MAAA,GAAS,IAAA;AAAA,IACT,KAAA,GAAQ;AAAA,GACV,GAAI,OAAA;AAEJ,EAAA,MAAM,YAAA,GAAeA,aAAO,SAAS,CAAA;AACrC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,YAAA,CAAa,OAAA,GAAU,SAAA;AAAA,EACzB,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AAEd,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,MAAA,EAAQ;AAIzB,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AAErC,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAa;AAClC,MAAA,MAAM,KAAK,GAAA,CAAI,OAAA;AACf,MAAA,IAAI,CAAC,EAAA,EAAI;AACT,MAAA,MAAM,SAAS,CAAA,CAAE,MAAA;AACjB,MAAA,IAAI,EAAE,kBAAkB,IAAA,CAAA,EAAO;AAC/B,MAAA,IAAI,EAAA,CAAG,QAAA,CAAS,MAAM,CAAA,EAAG;AACzB,MAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,IACvB,CAAA;AAEA,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAqB;AAC1C,MAAA,IAAI,CAAA,CAAE,QAAQ,QAAA,EAAU;AACtB,QAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,MACvB;AAAA,IACF,CAAA;AAEA,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,QAAA,CAAS,gBAAA,CAAiB,OAAO,aAAa,CAAA;AAAA,IAChD;AACA,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAAA,IACpD;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,QAAA,CAAS,mBAAA,CAAoB,OAAO,aAAa,CAAA;AAAA,MACnD;AACA,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,aAAa,CAAA;AAAA,MACvD;AAAA,IACF,CAAA;AAAA,EACF,GAAG,CAAC,GAAA,EAAK,SAAS,OAAA,EAAS,MAAA,EAAQ,KAAK,CAAC,CAAA;AAC3C","file":"index.cjs","sourcesContent":["import { useEffect, useRef } from \"react\";\nimport type { UseDismissOptions } from \"./types.js\";\n\nexport function useDismiss<T extends HTMLElement>(\n  ref: React.RefObject<T | null>,\n  onDismiss: () => void,\n  options: UseDismissOptions = {},\n): void {\n  const {\n    enabled = true,\n    outside = true,\n    escape = true,\n    event = \"pointerdown\",\n  } = options;\n\n  const onDismissRef = useRef(onDismiss);\n  useEffect(() => {\n    onDismissRef.current = onDismiss;\n  }, [onDismiss]);\n\n  useEffect(() => {\n    if (!enabled) return;\n    if (!outside && !escape) return;\n\n    // SSR guard: document is unavailable on server. Effect only runs on client,\n    // but guard keeps logic safe if environment is non-DOM.\n    if (typeof document === \"undefined\") return;\n\n    const handleOutside = (e: Event) => {\n      const el = ref.current;\n      if (!el) return;\n      const target = e.target;\n      if (!(target instanceof Node)) return;\n      if (el.contains(target)) return;\n      onDismissRef.current();\n    };\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") {\n        onDismissRef.current();\n      }\n    };\n\n    if (outside) {\n      document.addEventListener(event, handleOutside);\n    }\n    if (escape) {\n      document.addEventListener(\"keydown\", handleKeyDown);\n    }\n\n    return () => {\n      if (outside) {\n        document.removeEventListener(event, handleOutside);\n      }\n      if (escape) {\n        document.removeEventListener(\"keydown\", handleKeyDown);\n      }\n    };\n  }, [ref, enabled, outside, escape, event]);\n}\n"]}
+{"version":3,"sources":["../src/useDismiss.ts"],"names":["useRef","useEffect"],"mappings":";;;;;AAGO,SAAS,UAAA,CACd,GAAA,EACA,SAAA,EACA,OAAA,GAA6B,EAAC,EACxB;AACN,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,IAAA;AAAA,IACV,OAAA,GAAU,IAAA;AAAA,IACV,MAAA,GAAS,IAAA;AAAA,IACT,KAAA,GAAQ;AAAA,GACV,GAAI,OAAA;AAEJ,EAAA,MAAM,YAAA,GAAeA,aAAO,SAAS,CAAA;AACrC,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,YAAA,CAAa,OAAA,GAAU,SAAA;AAAA,EACzB,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AAEd,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,MAAA,EAAQ;AAIzB,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AAErC,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAa;AAClC,MAAA,MAAM,KAAK,GAAA,CAAI,OAAA;AACf,MAAA,IAAI,CAAC,EAAA,EAAI;AACT,MAAA,MAAM,SAAS,CAAA,CAAE,MAAA;AACjB,MAAA,IAAI,EAAE,kBAAkB,IAAA,CAAA,EAAO;AAC/B,MAAA,IAAI,EAAA,CAAG,QAAA,CAAS,MAAM,CAAA,EAAG;AACzB,MAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,IACvB,CAAA;AAEA,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAqB;AAC1C,MAAA,IAAI,CAAA,CAAE,QAAQ,QAAA,EAAU;AACtB,QAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,MACvB;AAAA,IACF,CAAA;AAEA,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,QAAA,CAAS,gBAAA,CAAiB,OAAO,aAAa,CAAA;AAAA,IAChD;AACA,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAAA,IACpD;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,QAAA,CAAS,mBAAA,CAAoB,OAAO,aAAa,CAAA;AAAA,MACnD;AACA,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,aAAa,CAAA;AAAA,MACvD;AAAA,IACF,CAAA;AAAA,EACF,GAAG,CAAC,GAAA,EAAK,SAAS,OAAA,EAAS,MAAA,EAAQ,KAAK,CAAC,CAAA;AAC3C","file":"index.cjs","sourcesContent":["import { useEffect, useRef } from \"react\";\r\nimport type { UseDismissOptions } from \"./types.js\";\r\n\r\nexport function useDismiss<T extends HTMLElement>(\r\n  ref: React.RefObject<T | null>,\r\n  onDismiss: () => void,\r\n  options: UseDismissOptions = {},\r\n): void {\r\n  const {\r\n    enabled = true,\r\n    outside = true,\r\n    escape = true,\r\n    event = \"pointerdown\",\r\n  } = options;\r\n\r\n  const onDismissRef = useRef(onDismiss);\r\n  useEffect(() => {\r\n    onDismissRef.current = onDismiss;\r\n  }, [onDismiss]);\r\n\r\n  useEffect(() => {\r\n    if (!enabled) return;\r\n    if (!outside && !escape) return;\r\n\r\n    // SSR guard: document is unavailable on server. Effect only runs on client,\r\n    // but guard keeps logic safe if environment is non-DOM.\r\n    if (typeof document === \"undefined\") return;\r\n\r\n    const handleOutside = (e: Event) => {\r\n      const el = ref.current;\r\n      if (!el) return;\r\n      const target = e.target;\r\n      if (!(target instanceof Node)) return;\r\n      if (el.contains(target)) return;\r\n      onDismissRef.current();\r\n    };\r\n\r\n    const handleKeyDown = (e: KeyboardEvent) => {\r\n      if (e.key === \"Escape\") {\r\n        onDismissRef.current();\r\n      }\r\n    };\r\n\r\n    if (outside) {\r\n      document.addEventListener(event, handleOutside);\r\n    }\r\n    if (escape) {\r\n      document.addEventListener(\"keydown\", handleKeyDown);\r\n    }\r\n\r\n    return () => {\r\n      if (outside) {\r\n        document.removeEventListener(event, handleOutside);\r\n      }\r\n      if (escape) {\r\n        document.removeEventListener(\"keydown\", handleKeyDown);\r\n      }\r\n    };\r\n  }, [ref, enabled, outside, escape, event]);\r\n}\r\n"]}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useDismiss.ts"],"names":[],"mappings":";;;AAGO,SAAS,UAAA,CACd,GAAA,EACA,SAAA,EACA,OAAA,GAA6B,EAAC,EACxB;AACN,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,IAAA;AAAA,IACV,OAAA,GAAU,IAAA;AAAA,IACV,MAAA,GAAS,IAAA;AAAA,IACT,KAAA,GAAQ;AAAA,GACV,GAAI,OAAA;AAEJ,EAAA,MAAM,YAAA,GAAe,OAAO,SAAS,CAAA;AACrC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,YAAA,CAAa,OAAA,GAAU,SAAA;AAAA,EACzB,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AAEd,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,MAAA,EAAQ;AAIzB,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AAErC,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAa;AAClC,MAAA,MAAM,KAAK,GAAA,CAAI,OAAA;AACf,MAAA,IAAI,CAAC,EAAA,EAAI;AACT,MAAA,MAAM,SAAS,CAAA,CAAE,MAAA;AACjB,MAAA,IAAI,EAAE,kBAAkB,IAAA,CAAA,EAAO;AAC/B,MAAA,IAAI,EAAA,CAAG,QAAA,CAAS,MAAM,CAAA,EAAG;AACzB,MAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,IACvB,CAAA;AAEA,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAqB;AAC1C,MAAA,IAAI,CAAA,CAAE,QAAQ,QAAA,EAAU;AACtB,QAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,MACvB;AAAA,IACF,CAAA;AAEA,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,QAAA,CAAS,gBAAA,CAAiB,OAAO,aAAa,CAAA;AAAA,IAChD;AACA,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAAA,IACpD;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,QAAA,CAAS,mBAAA,CAAoB,OAAO,aAAa,CAAA;AAAA,MACnD;AACA,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,aAAa,CAAA;AAAA,MACvD;AAAA,IACF,CAAA;AAAA,EACF,GAAG,CAAC,GAAA,EAAK,SAAS,OAAA,EAAS,MAAA,EAAQ,KAAK,CAAC,CAAA;AAC3C","file":"index.js","sourcesContent":["import { useEffect, useRef } from \"react\";\nimport type { UseDismissOptions } from \"./types.js\";\n\nexport function useDismiss<T extends HTMLElement>(\n  ref: React.RefObject<T | null>,\n  onDismiss: () => void,\n  options: UseDismissOptions = {},\n): void {\n  const {\n    enabled = true,\n    outside = true,\n    escape = true,\n    event = \"pointerdown\",\n  } = options;\n\n  const onDismissRef = useRef(onDismiss);\n  useEffect(() => {\n    onDismissRef.current = onDismiss;\n  }, [onDismiss]);\n\n  useEffect(() => {\n    if (!enabled) return;\n    if (!outside && !escape) return;\n\n    // SSR guard: document is unavailable on server. Effect only runs on client,\n    // but guard keeps logic safe if environment is non-DOM.\n    if (typeof document === \"undefined\") return;\n\n    const handleOutside = (e: Event) => {\n      const el = ref.current;\n      if (!el) return;\n      const target = e.target;\n      if (!(target instanceof Node)) return;\n      if (el.contains(target)) return;\n      onDismissRef.current();\n    };\n\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") {\n        onDismissRef.current();\n      }\n    };\n\n    if (outside) {\n      document.addEventListener(event, handleOutside);\n    }\n    if (escape) {\n      document.addEventListener(\"keydown\", handleKeyDown);\n    }\n\n    return () => {\n      if (outside) {\n        document.removeEventListener(event, handleOutside);\n      }\n      if (escape) {\n        document.removeEventListener(\"keydown\", handleKeyDown);\n      }\n    };\n  }, [ref, enabled, outside, escape, event]);\n}\n"]}
+{"version":3,"sources":["../src/useDismiss.ts"],"names":[],"mappings":";;;AAGO,SAAS,UAAA,CACd,GAAA,EACA,SAAA,EACA,OAAA,GAA6B,EAAC,EACxB;AACN,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,IAAA;AAAA,IACV,OAAA,GAAU,IAAA;AAAA,IACV,MAAA,GAAS,IAAA;AAAA,IACT,KAAA,GAAQ;AAAA,GACV,GAAI,OAAA;AAEJ,EAAA,MAAM,YAAA,GAAe,OAAO,SAAS,CAAA;AACrC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,YAAA,CAAa,OAAA,GAAU,SAAA;AAAA,EACzB,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AAEd,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,MAAA,EAAQ;AAIzB,IAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AAErC,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAa;AAClC,MAAA,MAAM,KAAK,GAAA,CAAI,OAAA;AACf,MAAA,IAAI,CAAC,EAAA,EAAI;AACT,MAAA,MAAM,SAAS,CAAA,CAAE,MAAA;AACjB,MAAA,IAAI,EAAE,kBAAkB,IAAA,CAAA,EAAO;AAC/B,MAAA,IAAI,EAAA,CAAG,QAAA,CAAS,MAAM,CAAA,EAAG;AACzB,MAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,IACvB,CAAA;AAEA,IAAA,MAAM,aAAA,GAAgB,CAAC,CAAA,KAAqB;AAC1C,MAAA,IAAI,CAAA,CAAE,QAAQ,QAAA,EAAU;AACtB,QAAA,YAAA,CAAa,OAAA,EAAQ;AAAA,MACvB;AAAA,IACF,CAAA;AAEA,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,QAAA,CAAS,gBAAA,CAAiB,OAAO,aAAa,CAAA;AAAA,IAChD;AACA,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,aAAa,CAAA;AAAA,IACpD;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,QAAA,CAAS,mBAAA,CAAoB,OAAO,aAAa,CAAA;AAAA,MACnD;AACA,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,aAAa,CAAA;AAAA,MACvD;AAAA,IACF,CAAA;AAAA,EACF,GAAG,CAAC,GAAA,EAAK,SAAS,OAAA,EAAS,MAAA,EAAQ,KAAK,CAAC,CAAA;AAC3C","file":"index.js","sourcesContent":["import { useEffect, useRef } from \"react\";\r\nimport type { UseDismissOptions } from \"./types.js\";\r\n\r\nexport function useDismiss<T extends HTMLElement>(\r\n  ref: React.RefObject<T | null>,\r\n  onDismiss: () => void,\r\n  options: UseDismissOptions = {},\r\n): void {\r\n  const {\r\n    enabled = true,\r\n    outside = true,\r\n    escape = true,\r\n    event = \"pointerdown\",\r\n  } = options;\r\n\r\n  const onDismissRef = useRef(onDismiss);\r\n  useEffect(() => {\r\n    onDismissRef.current = onDismiss;\r\n  }, [onDismiss]);\r\n\r\n  useEffect(() => {\r\n    if (!enabled) return;\r\n    if (!outside && !escape) return;\r\n\r\n    // SSR guard: document is unavailable on server. Effect only runs on client,\r\n    // but guard keeps logic safe if environment is non-DOM.\r\n    if (typeof document === \"undefined\") return;\r\n\r\n    const handleOutside = (e: Event) => {\r\n      const el = ref.current;\r\n      if (!el) return;\r\n      const target = e.target;\r\n      if (!(target instanceof Node)) return;\r\n      if (el.contains(target)) return;\r\n      onDismissRef.current();\r\n    };\r\n\r\n    const handleKeyDown = (e: KeyboardEvent) => {\r\n      if (e.key === \"Escape\") {\r\n        onDismissRef.current();\r\n      }\r\n    };\r\n\r\n    if (outside) {\r\n      document.addEventListener(event, handleOutside);\r\n    }\r\n    if (escape) {\r\n      document.addEventListener(\"keydown\", handleKeyDown);\r\n    }\r\n\r\n    return () => {\r\n      if (outside) {\r\n        document.removeEventListener(event, handleOutside);\r\n      }\r\n      if (escape) {\r\n        document.removeEventListener(\"keydown\", handleKeyDown);\r\n      }\r\n    };\r\n  }, [ref, enabled, outside, escape, event]);\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-dismiss",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A tiny React hook for dismissing UI when users interact outside or press Escape.",
   "keywords": [
     "react",
@@ -17,7 +17,7 @@
   "author": "",
   "repository": {
     "type": "git",
-    "url": "https://github.com/parasraju/react-dismiss.git"
+    "url": "git+https://github.com/parasraju/react-dismiss.git"
   },
   "bugs": {
     "url": "https://github.com/parasraju/react-dismiss/issues"