## [4.2.2] - 10/15/2026

Documentation-only release. No code changes.

- **Demo URL**: the live demo moved to https://ravy.pro/tools/tabs-broadcast/demo (README link and
  `homepage` in `package.json` updated).

## [tabs-broadcast-nuxt 0.1.0] - 06/01/2026

- **Nuxt module**: added a companion package `tabs-broadcast-nuxt` (under `packages/nuxt`) that
  registers a client-only plugin and auto-imports a `useTabsBroadcast()` composable. The core
  `tabs-broadcast` package is unchanged and remains zero-dependency; the module lives in a separate
  npm workspace and is versioned/published independently.

## [4.2.1] - 06/01/2026

- Add favicon to demo page
- Fix demo page view

## [4.2.0] - 06/01/2026

Fix build and publish pipeline


## [4.1.0] - 06/01/2026

Quality, DX, and packaging release. No breaking changes — typed events are opt-in and the
generic defaults to permissive, so existing untyped code keeps working.

### Added

- **Typed events**: `TabsBroadcast<TEvents>` generic gives full autocomplete and payload
  type-checking on `on`/`once`/`emit` (wildcard listeners receive the payload union). Untyped
  usage is unchanged.
- **Named export**: `import { TabsBroadcast } from 'tabs-broadcast'` in addition to the default
  export; public types are re-exported from the entry point.
- **Tooling**: ESLint (flat config + typescript-eslint), Prettier, and `.editorconfig`, with
  `lint`/`lint:fix`/`format`/`format:check` scripts.
- **Tests**: split the monolithic suite into focused files (election storage/web-locks, dispatch,
  emit, security, config, lifecycle) with shared helpers; added a Web Locks test (mocked
  `navigator.locks`), type-level tests (`test:types`), and V8 coverage (`test:coverage`).
- **Docs**: rewritten README with a table of contents, quick start, configuration table, typed-events
  and browser-support sections, `deleteLayer` docs, and a 3.x→4.0 migration note; added
  `CONTRIBUTING.md`.
- `prepublishOnly` (build + test) and dual `.d.ts`/`.d.cts` type entries for clean ESM/CJS resolution.

### Changed

- **Internal refactor**: leader election split into strategy modules under `src/core/election/`
  (`webLocksElector`, `storageElector`, shared `baseElector`/`tabId`), with `tabsWorker` reduced to a
  thin facade. Public behavior and API unchanged.
- `package.json`: richer `description` and `keywords`, corrected `author` field (was non-standard
  `authors`), added `engines`, `unpkg`/`jsdelivr`, `exports` split into `import`/`require` type
  conditions, `homepage` points to the demo, and `CHANGELOG.md` is now published.
- Modernized JSDoc across the public API (added `@example`/`@returns`, dropped redundant type tags).

### Fixed

- README: corrected the `listenOwnChannel` default (`false`) and a stray colon, and fixed the author
  email link.

## [4.0.0] - 06/01/2026

Major release focused on correctness, primary-tab election robustness, and security
hardening. Includes breaking changes — see **Breaking** below.

### Breaking

- **Namespaced election state.** All primary/slave bookkeeping in `localStorage` (and the
  Web Locks name) is now namespaced per `channelName`. Independent instances using different
  `channelName`s no longer fight over a single, origin-wide primary slot. State written by
  3.x is not read by 4.0.
- **`listenOwnChannel` default is now `false`** (matches the documentation). Previously the
  code defaulted to `true` while the README documented `false`. Pass `listenOwnChannel: true`
  explicitly if you relied on the old behavior.
- **`onBecomePrimary` detail shape** is now `{ tabId }` (the `isPrimary` field was removed; the
  callback only fires when this tab *becomes* primary).

### Added

- **Web Locks API election.** When `navigator.locks` is available it is used to elect the
  primary tab. Leadership is held while the tab is alive and released automatically by the
  browser on close/crash — eliminating election races and stale `localStorage` entries.
- **Hardened `localStorage` fallback.** For environments without Web Locks: timestamped
  heartbeat claims with automatic stale-primary recovery and a deterministic tab-id tie-break
  so concurrent claims converge on a single primary.
- **Collision-resistant tab ids** via `crypto.randomUUID()` (with a time+random fallback),
  replacing the `Date.now()`-only id that could collide for tabs opened in the same millisecond.
- **Test suite** (Vitest + happy-dom): `npm test`.
- **Security guidance** in the README: incoming channel messages are untrusted input.

### Fixed

- **`off()` now actually removes listeners.** It previously discarded the filtered result, so
  listeners were never unregistered. It also no longer throws when given an unknown layer.
- **`disableInternalErrors: false` is now respected.** A `|| true` bug forced it to always be
  `true`, making internal error logging impossible to enable.
- **Initial primary tab is detected reliably.** A listener-registration ordering race meant a
  tab created on an already-loaded page (lazy init / SPA navigation) could stay `primary === false`
  and never fire `onBecomePrimary`. Primary status now flows through a single source of truth.
- **`emit()` and `primary` can no longer disagree** — both derive from the same election state.
- **`destroy()` no longer leaks listeners/timers.** It now tears down the worker's `storage`/
  `pagehide` listeners and heartbeat timer and relinquishes leadership.
- **SSR guard** uses `typeof window === 'undefined'` instead of `!window` (the latter throws a
  ReferenceError when `window` is undefined).

### Security

- Incoming `BroadcastChannel` messages are shape-validated; malformed messages are ignored.
- Incoming messages are only delivered to **already-registered** layers and can no longer
  create new layers in your instance (prevents memory growth from untrusted/foreign messages).

### Internal / tooling

- Demo (`index.html`): removed a stray empty `<script>` element embedded in the logo SVG.
- CI (`publish.yml`): replaced the deprecated `::set-output` with `$GITHUB_OUTPUT`, switched
  `npm install` → `npm ci`, set the version via `npm version` (keeping the lockfile in sync),
  and normalized a leading `v` in the release tag.
- Fixed `package.json` `exports` ordering so the `types` condition is resolved first.

## [3.3.0] - 10/12/2025

- Make `layers` public
- Fix pack issue
- Update readme
- Update docs
- Update vite config
- Update src structure

## [3.2.3] - 04/28/2025

### Added
- **TypeScript Support**: Added comprehensive type definitions via `index.d.ts` for full type safety and IDE autocompletion.
- **Wildcard Listeners (`*`)**: Now you can listen to all events in a specific layer by using the `*` wildcard in the `on` method.
- **Emit to Multiple Layers**: The `emit` method now allows targeting multiple layers at once by passing an array of layer names.
- **Plugin System**: Introduced a `use` method to register plugins and extend the functionality of TabsBroadcast.
- **Destroy Delay**: The `destroy` method now supports an optional delay parameter, allowing deferred cleanup.

### Changed
- Enhanced the `on`, `off`, and `once` methods to support event handling within specific layers.
- The `isPrimary` method is now **deprecated**. Use the `primary` property for checking primary tab status.

### Fixed
- Minor bug fixes and optimizations for inter-tab communication stability.

### Documentation

- Add additional demo functionality

## [3.2.2] - 04/25/2025

- Fix pack issue

## [3.2.1]

- Vite version change to ^6.3.3
- Update readme

## [3.2.0]

### Layer Support
Added the concept of layers to enhance event handling. Events can now be grouped and isolated by layers, allowing for better separation and control in applications with micro-frontends or multiple components.

- Usage: Specify a layer when emitting or registering an event (on, once, emit). Events will trigger only within their designated layer.
- Performance Optimization: Using layers reduces memory usage and iteration counts in large-scale applications.

### Primary-Slave Tab Management:
- Improved to ensure consistent behavior across multiple tabs.
- Primary tab status is now accessible directly as a static property (primary) for easier checking without a separate method call.

### TypeScript Enhancements:
- Added more precise type definitions, improving integration with TypeScript projects.
- New TypeScript support provides better editor auto-completion and error detection, facilitating a smoother development experience.

### Updated Methods
- Extended on, once, onList, onceList, off, and emit: Each method now includes an optional layer parameter to designate event isolation by layer. This allows users to assign and listen to events in separate layers within the same application context.

### Config Updates
- Refined Configuration Options: channelName, listenOwnChannel, and emitByPrimaryOnly are now fully compatible with the new layer functionality, allowing multiple isolated instances in micro-frontend environments by simply setting the desired channelName.

### Improved Documentation

- Updated README to include comprehensive examples for all methods, configuration, and layer-based usage.
- Enhanced explanations on the benefits and use cases of the Primary-Slave model, including examples of how layers can be used to optimize communication across micro-frontends.

### Bug Fixes
- Context Preservation in Event Listeners: Fixed an issue where certain private methods were not correctly bound, causing errors in some browsers. All event listeners now maintain the correct class context.
- Improved Memory Management: Addressed a memory leak by ensuring BroadcastChannel instances are properly destroyed when calling destroy().

This version represents a major upgrade with layer-based event handling and improved Primary-Slave management. We recommend upgrading to leverage these new features, especially for applications with complex inter-tab communication or multi-frontend architectures.

## [3.1.10]

- Switch beforeunload to pagehide event

## [3.1.9]

- Change Github actions

## [3.1.8]

- Update Github workflow for auto-update docs

## [3.1.7]

- Remove primary tab key from localStorage on onBeforeUnload event

## [3.1.6]

- Fix document.readyState event. Now support SSR mode

## [3.1.5]

- Change http -> https in docs.
- Fix JS paths
- Add index.d.ts additional types

## [3.1.4]

- Update readme.md.
- Add min lib files

## [3.1.3]

- Remove `package-lock.json` from repo

## [3.1.2]

- Bug fixes

## [3.1.1]

- Update docs
- Rename props

## [3.1.0]

- Improved TypeScript Definitions: Enhanced type definitions for event handling, ensuring proper typing for `event.detail`.
- Singleton Pattern: Ensured `TabsBroadcast` maintains a single instance across the application.
- Code Optimization: Refactored and optimized the `TabsBroadcast` and `TabsWorker` classes, adding detailed comments and documentation for better understanding and maintenance.
- Event Handling Enhancements: Improved the event listener setup for primary status changes.
- Primary-Slave Management: Added robust handling for designating and transferring primary tab status.
- Detailed Documentation: Provided comprehensive documentation in the `readme.md` for better clarity on usage, installation, and examples.
- Demo URL: Added a demo URL (http://tabs-broadcast.ravy.pro) for users to see the library in action.
- Sponsorship Information: Added information on how to support the library development with a TRC20 wallet address.

## [3.0.3]

- Update homepage to https://ravy.pro

## [3.0.2]

- [fix] Update README.md for support LIST subscribes. Again
- Update jsDocs

## [3.0.1]

- [fix] Update README.md for support LIST subscribes

## [3.0.0]

- `TabsBroadcast` is now a constructor instead of a class instance.
- Added a new method `destroy` for closing opened broadcast channels.
- Added the `onList` method for quickly subscribing to multiple events.
- Added the `onceList` method for quickly subscribing to multiple one-time events.
- Arguments for `TabsBroadcast` now have default values.
- Added a property `channelName` for customizing channel names. Now you can have multiple parallel channels.
- Added a property `listenOwnChannel` to enable listening to the own channel from which the event was sent.
- Tests have been added to enhance the stability of the library.