### Install Development Dependencies

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Install all development dependencies for building from source using pnpm.

```bash
pnpm install
```

--------------------------------

### Install @zakj/no-sleep

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Install the package using npm.

```bash
npm install @zakj/no-sleep
```

--------------------------------

### Build Library from Source

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Build the library after installing development dependencies.

```bash
pnpm run build
```

--------------------------------

### Instantiate NoSleep with INoSleep Interface

Source: https://context7.com/zakj/nosleep.js/llms.txt

Demonstrates how to import and instantiate the NoSleep class, which adheres to the INoSleep interface. The specific implementation is chosen automatically based on the runtime environment.

```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep: import('@zakj/no-sleep').INoSleep = new NoSleep();

console.log(noSleep.enabled); // false
```

--------------------------------

### Create NoSleep Instance

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Instantiate a new NoSleep object.

```javascript
var noSleep = new NoSleep();
```

--------------------------------

### NoSleep Constructor

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Instantiate the NoSleep object to manage wake locks.

```APIDOC
## new NoSleep()

### Description
Creates a new instance of the NoSleep object.

### Usage
```javascript
var noSleep = new NoSleep();
```
```

--------------------------------

### NoSleep Constructor

Source: https://context7.com/zakj/nosleep.js/llms.txt

Instantiates the appropriate wake-lock implementation for the current runtime. The library automatically selects the best strategy based on the environment.

```APIDOC
## new NoSleep()

Instantiates the appropriate wake-lock implementation for the current runtime. In a browser with native Wake Lock API support (and iOS ≥ 18.4 for PWA mode), returns a `NoSleepNative` instance. On older iOS or browsers without `navigator.wakeLock`, returns a `NoSleepVideo` instance that injects a silent `<video>` element into `document.body`. In a non-browser (SSR) environment, returns a `NoSleepSSR` no-op.

### Request Example
```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();
// noSleep is one of: NoSleepNative | NoSleepVideo | NoSleepSSR
// selected automatically based on the runtime environment
```
```

--------------------------------

### Import ES6 Module

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Import the NoSleep ES6 module for use in your project.

```javascript
import NoSleep from '@zakj/no-sleep';
```

--------------------------------

### enable() - Enable Wake Lock

Source: https://context7.com/zakj/nosleep.js/llms.txt

Activates the wake lock. This method must be called from within a user-initiated event handler due to browser security requirements. It returns a Promise that resolves when the wake lock is active.

```APIDOC
## noSleep.enable()

Activates the wake lock. Must be called from within a user-initiated event handler (e.g., click, touchstart) due to browser security requirements. Returns a `Promise` for the native implementation; returns `Promise<void>` for the video fallback.

### Description
Activates the wake lock. Must be called from within a user-initiated event handler (e.g., click, touchstart) due to browser security requirements.

### Method
`enable(): Promise<void>`

### Request Example
```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();

document.getElementById('start-btn')!.addEventListener('click', async function handler() {
  // Must be called synchronously inside a user gesture
  await noSleep.enable();
  console.log('Wake lock active:', noSleep.enabled); // true

  // Remove listener if only needed once
  document.getElementById('start-btn')!.removeEventListener('click', handler);
});
```
```

--------------------------------

### Enable Wake Lock with User Event

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Enable wake lock. This function call must be wrapped in a user input event handler, such as a mouse or touch event.

```javascript
// Enable wake lock.
// (must be wrapped in a user input event handler e.g. a mouse or touch handler)
document.addEventListener(
  'click',
  function enableNoSleep() {
    document.removeEventListener('click', enableNoSleep, false);
    noSleep.enable();
  },
  false,
);
```

--------------------------------

### Automatic Wake Lock Implementation Selection

Source: https://context7.com/zakj/nosleep.js/llms.txt

Instantiates the NoSleep class. The library automatically selects the appropriate wake-lock implementation (NoSleepNative, NoSleepVideo, or NoSleepSSR) based on the current browser environment and iOS version.

```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();
// noSleep is one of: NoSleepNative | NoSleepVideo | NoSleepSSR
// selected automatically based on the runtime environment
```

--------------------------------

### SSR / Node.js Safe Usage of NoSleep

Source: https://context7.com/zakj/nosleep.js/llms.txt

When navigator is undefined (SSR, Node.js, or non-browser test environments), NoSleep resolves to NoSleepSSR. This provides the same interface but throws descriptive errors if enable() or disable() are mistakenly called. Importing the module is always safe.

```typescript
// Safe to import in a Next.js / Nuxt page — no runtime error at module load
import NoSleep from '@zakj/no-sleep';

// Guard before calling enable():
if (typeof navigator !== 'undefined') {
  const noSleep = new NoSleep();
  document.addEventListener('click', () => noSleep.enable(), { once: true });
}
```

--------------------------------

### Enable Wake Lock within User Gesture

Source: https://context7.com/zakj/nosleep.js/llms.txt

Activates the wake lock by calling `enable()`. This method must be invoked synchronously within a user-initiated event handler due to browser security restrictions. It returns a Promise that resolves when the wake lock is active.

```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();

document.getElementById('start-btn')!.addEventListener('click', async function handler() {
  // Must be called synchronously inside a user gesture
  await noSleep.enable();
  console.log('Wake lock active:', noSleep.enabled); // true

  // Remove listener if only needed once
  document.getElementById('start-btn')!.removeEventListener('click', handler);
});
```

--------------------------------

### enabled - State Property

Source: https://context7.com/zakj/nosleep.js/llms.txt

A boolean property that indicates whether the wake lock is currently active. It is updated automatically when `enable()` resolves or when the browser releases the lock.

```APIDOC
## noSleep.enabled

Boolean flag reflecting whether the wake lock is currently active. Updated automatically when `enable()` resolves or when the underlying `WakeLockSentinel` is released by the browser (e.g., on tab visibility change). The `NoSleepNative` implementation re-acquires the lock automatically when the page becomes visible again.

### Description
Boolean flag reflecting whether the wake lock is currently active.

### Property
`enabled: boolean`

### Request Example
```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();
console.log(noSleep.enabled); // false

document.addEventListener('click', async () => {
  await noSleep.enable();
  console.log(noSleep.enabled); // true

  // Simulate checking state elsewhere
  setTimeout(() => {
    if (!noSleep.enabled) {
      console.warn('Wake lock was released (e.g., tab went to background)');
    }
  }, 5000);
}, { once: true });
```
```

--------------------------------

### Enable Wake Lock

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Enables the wake lock to prevent the screen from sleeping. This function must be called within a user input event handler.

```APIDOC
## noSleep.enable()

### Description
Enables the wake lock. This prevents the device's screen from dimming or sleeping. 

**Important:** This method must be invoked within a user-initiated event handler (e.g., a click or touch event) due to browser security policies.

### Method
`enable()`

### Usage Example
```javascript
// Assuming 'noSleep' is an instance of NoSleep
document.addEventListener(
  'click',
  function enableNoSleep() {
    document.removeEventListener('click', enableNoSleep, false);
    noSleep.enable();
  },
  false
);
```
```

--------------------------------

### Automatic Visibility Re-acquisition with NoSleepNative

Source: https://context7.com/zakj/nosleep.js/llms.txt

When using the native Wake Lock API, browsers automatically release the lock when the page is hidden. NoSleepNative automatically re-acquires the lock when the page becomes visible again.

```typescript
import NoSleep from '@zakj/no-sleep';

// If navigator.wakeLock is available, NoSleepNative is used internally.
// Visibility and fullscreen re-acquisition are set up automatically.
const noSleep = new NoSleep();

document.addEventListener('click', async () => {
  await noSleep.enable();
  // If the user switches tabs and returns, the wake lock is re-acquired
  // automatically — no manual re-enable required.
}, { once: true });
```

--------------------------------

### Check Wake Lock State

Source: https://context7.com/zakj/nosleep.js/llms.txt

Checks the `enabled` boolean property to determine if the wake lock is currently active. This state is updated automatically when `enable()` resolves or if the browser releases the lock. The native implementation attempts to re-acquire the lock when the tab becomes visible.

```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();
console.log(noSleep.enabled); // false

document.addEventListener('click', async () => {
  await noSleep.enable();
  console.log(noSleep.enabled); // true

  // Simulate checking state elsewhere
  setTimeout(() => {
    if (!noSleep.enabled) {
      console.warn('Wake lock was released (e.g., tab went to background)');
    }
  }, 5000);
}, { once: true });
```

--------------------------------

### Disable Wake Lock

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Disables the wake lock, allowing the screen to sleep normally.

```APIDOC
## noSleep.disable()

### Description
Disables the wake lock, allowing the screen to dim and sleep according to the device's settings.

This function does not need to be wrapped in a user input event handler.

### Method
`disable()`

### Usage Example
```javascript
// Assuming 'noSleep' is an instance of NoSleep
noSleep.disable();
```
```

--------------------------------

### disable() - Disable Wake Lock

Source: https://context7.com/zakj/nosleep.js/llms.txt

Releases the wake lock and allows the display to sleep again. This method is safe to call at any time, regardless of user interaction.

```APIDOC
## noSleep.disable()

Releases the wake lock and allows the display to sleep again. Safe to call at any time, with or without a user gesture.

### Description
Releases the wake lock and allows the display to sleep again.

### Method
`disable(): void`

### Request Example
```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();

// Enable on start
document.addEventListener('click', async function enableOnce() {
  document.removeEventListener('click', enableOnce);
  await noSleep.enable();
  console.log('Wake lock enabled:', noSleep.enabled); // true
}, { once: true });

// Disable when done (e.g., media playback ends)
document.getElementById('stop-btn')!.addEventListener('click', () => {
  noSleep.disable();
  console.log('Wake lock enabled:', noSleep.enabled); // false
});
```
```

--------------------------------

### Disable Wake Lock

Source: https://github.com/zakj/nosleep.js/blob/main/README.md

Disable wake lock at some point in the future. This does not require a user input event handler.

```javascript
// Disable wake lock at some point in the future.
// (does not need to be wrapped in any user input event handler)
noSleep.disable();
```

--------------------------------

### Disable Wake Lock

Source: https://context7.com/zakj/nosleep.js/llms.txt

Releases the wake lock, allowing the display to sleep again. This function can be safely called at any time, regardless of user interaction. It updates the `enabled` state property.

```typescript
import NoSleep from '@zakj/no-sleep';

const noSleep = new NoSleep();

// Enable on start
document.addEventListener('click', async function enableOnce() {
  document.removeEventListener('click', enableOnce);
  await noSleep.enable();
  console.log('Wake lock enabled:', noSleep.enabled); // true
}, false);

// Disable when done (e.g., media playback ends)
document.getElementById('stop-btn')!.addEventListener('click', () => {
  noSleep.disable();
  console.log('Wake lock enabled:', noSleep.enabled); // false
});
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.