# Changelog

All notable changes to `js-queue` are documented here.

## Unreleased

## 3.1.1 — 2026-08-23

### Added

- Nine consumer-level Behavioral scenarios, an independent `test:behavioral` command, shared Node and Chrome coverage wiring, and a dedicated published test inventory.
- Native-browser acceptance evidence in real Chrome for the bare `js-queue` and `js-queue/stack` imports plus the internal bare `easy-stack` dependency.
- A packed-consumer conflict test that poisons an incompatible root `easy-stack` and proves the declared nested `2.1.0` executes through every ESM and CommonJS stack path.

### Changed

- Browser documentation, examples, Playground, testing, migration, and site guidance now state that js-queue works with bundlers and without a bundler.
- Publish the complete normal-layout and conflicting nested-dependency import maps, including the scoped mapping that preserves the package dependency boundary.
- Deploy and statically verify the explicit import maps and all mapped JavaScript files used by the live no-bundler examples.

## 3.1.0 — 2026-08-21

### Added

- A dedicated browser Playground backed by the canonical queue module, deterministic FIFO controls, state and execution views, and related JavaScript that follows every activity.
- A focused `vanilla-test` Playground controller suite and GitHub Pages deployment contracts for the new route and module.
- Ninety-two non-overlapping `vanilla-test` checks organized into independently runnable Unit, Functional, Integration, and Regression layers, with a dedicated documentation page for every layer.
- Reproducible WeakMap-versus-private-field benchmarks, two compact charts, and a focused Performance page.

### Changed

- Replace queue WeakMap state with private instance fields while preserving the public FIFO contract.
- Resolve native ESM and CommonJS consumers through the same synchronous `queue.js` and `stack.js` sources.
- Raise the supported runtime floor to Node.js 22.13 and verify that exact release in CI.
- Update the stack entry to `easy-stack` 2.1.0.

### Removed

- Remove the duplicate `queue.cjs` and `stack.cjs` Node builds.
- Remove pre-22 compatibility jobs and their fallback test command.

## 3.0.0 — 2026-08-16

### Added

- Native ESM default and named exports.
- Conditional CommonJS entry points for the queue and stack.
- `size` and `running` read-only state.
- Atomic task validation in `add()` and `contents` replacement.
- Recoverable idle state after a synchronous task error.
- A shared Node/browser suite powered by `vanilla-test` 2.1.1.
- Independent native V8 coverage gates for Node and Google Chrome.
- Cross-platform and historical-runtime CI, package smoke checks, and GitHub Pages deployment.
- A dependency-free local server with path-containment and malformed-request checks.
- A generated repository header and nine-page static documentation site.
- Migration, testing, browser, examples, patterns, stack, and API documentation.

### Changed

- `add()` now returns the queue for chaining.
- Queue methods are class prototype methods instead of enumerable instance properties.
- The minimum supported Node.js release is 12.22.0.
- The package homepage now points to the GitHub Pages documentation.
- The stack entry now pins the modernized `easy-stack` 2.0.0 contract, including native ESM/CommonJS support and observable state.

### Preserved

- First-in-first-out execution.
- Automatic start after `add()` by default.
- Explicit `this.next()` task hand-off.
- `autoRun`, `stop`, `contents`, and `clear()` behavior.
- CommonJS `require('js-queue')` usage.
- Classic browser `<script>` usage through `queue-vanilla.js`.
- LIFO access through `js-queue/stack` and `js-queue/stack.js`.

## 2.0.2 — 2020

- Updated `easy-stack` and exposed it through `stack.js`.