# browser-focus

Wraps [`document.hasFocus()`](https://developer.mozilla.org/docs/Web/API/Document/hasFocus) plus the window `focus` / `blur` events as one global atom.

## Install

```bash
bun add @valdres/browser-focus
```

## Live example

▶ Live example: [https://valdres.dev/vue/plugins/browser-focus](https://valdres.dev/vue/plugins/browser-focus)

## Usage

```vue
<script setup>
import { useValue } from "valdres-vue"
import { focusAtom } from "@valdres/browser-focus"

const focused = useValue(focusAtom) // Ref<boolean>
</script>

<template>{{ focused ? "Focused" : "Blurred" }}</template>
```

## Exports

| Export      | Kind             | Type      |
| ----------- | ---------------- | --------- |
| `focusAtom` | atom (read-only) | `boolean` |

## Cross-framework

A global atom — works in every framework; only the read primitive's name changes (`useValue`, `createValue`, `injectValue`, `watch`, or `store.get` in plain JS). The `focus` / `blur` listeners attach on the first subscriber and detach when the last leaves. Returns `true` during SSR. Compose with `@valdres/browser-visibility` for a "user is present" signal (see `@valdres/browser-presence`).