# Unreleased

## Changelog

- [#527](https://github.com/nevware21/ts-async/pull/527) [Feature] Add `setMaxSyncPromiseChainDepth` to cap synchronous promise chain depth
  - New exported function `setMaxSyncPromiseChainDepth(maxDepth?: number)` allows configuring the maximum number of synchronous `.then()` continuations that may execute in a single turn before the chain is deferred via a microtask hop. Defaults to 200.
  - **Behavior change**: deep synchronous promise chains (longer than the configured max depth) will yield asynchronously once the limit is exceeded, meaning a `createSyncPromise`/`createSyncResolvedPromise` chain may remain pending temporarily for very deep/recursive chains.
  - Pass no argument (or `undefined`) to reset back to the default depth.
- [#528](https://github.com/nevware21/ts-async/pull/528) [BUG] Fix unbounded loop in timeout normalization and long-chain timeout propagation
  - `_normalizeTimeoutValue` unwrapped nested array timeout values with no iteration cap; a self-referential array (e.g. `const a: any[] = []; a[0] = a;`) passed as a timeout would loop forever. The unwrap loop is now capped at 5 iterations, falling back to the default timeout if no numeric value is found within that bound.
  - `createAsyncPromise` was re-wrapping the raw (potentially array) timeout as the chained promise's additional args on every `then()`/`catch()`/`finally()` link, growing an extra array-nesting level per link. Combined with the new depth cap this silently dropped an explicit timeout after ~5-6 chained calls. Fixed by normalizing the timeout once before it is stored, matching the existing `createIdlePromise` pattern, so nesting never exceeds one level regardless of chain length.
- [Feature] Add `setDisableFakeTimersDetection` to allow opting out of Sinon fake-timer fingerprinting
  - New exported function `setDisableFakeTimersDetection(disable?: boolean)` allows a consumer to force the library's internal Sinon-fake-timer detection (a patched `setTimeout.clock` fingerprint used to decide whether deferred continuations use a `0ms` timeout or a microtask) to always report "not present", so deferred work always uses a real microtask.
  - Default behavior (detection enabled) is unchanged when never called, or called with `undefined`. Any other value is coerced via `!!`.
  - See [Fake Timer Detection](./docs/README.md#fake-timer-detection) for full details and side effects.


# v0.6.1 May 31st, 2026

## Changelog

- [#517](https://github.com/nevware21/ts-async/pull/517) [CHORE] Address issues with `/*#__PURE__*/` annotations placed inside parens causing Rolldown/Vite 8 issues
  - /* #__PURE__*/ annotations in the published ESM/ES5 bundles are positioned inside the wrapping parentheses, between the open paren and the annotated expression. Rolldown, used by Vite 8 cannot associate the annotation with the expression that follows it, so the annotation is silently ignored and dead-code elimination does not kick in for the affected values.
- [#516](https://github.com/nevware21/ts-async/pull/516) [TASK] Update changelog

For full details see [v0.6.0...v0.6.1](https://github.com/nevware21/ts-async/compare/v0.6.0...v0.6.1)

# v0.6.0 May 30th, 2026

## Changelog

- [#508](https://github.com/nevware21/ts-async/pull/508) [Bug] Fix `IPromise.finally()` to await returned promises per ES2018 spec
  - `Promise.finally()` was ignoring the return value of the `onFinally` callback. Per the ES2018 specification (ECMA-262 §27.2.5.3), if `onFinally` returns a promise/thenable, the resulting promise must wait for it to settle before propagating the original value or reason. If the returned promise rejects, that rejection takes precedence.
- [#488](https://github.com/nevware21/ts-async/issues/488) [CHORE] Drop Node.js 16 from CI matrix and add Node.js 24
  - Node.js 16 is end-of-life and is no longer supported by key tooling dependencies (for example `puppeteer` and `@pnpm/error` require Node.js >= 18)
- [#499](https://github.com/nevware21/ts-async/issues/499) [BUG] Fix compilation errors for consumers using ES5-only TypeScript lib settings
  - Add `/// <reference lib="es2018" />` directive to published declaration file so consumers no longer need to manually add ES2018 libs to their tsconfig
  - Add `"lib": ["es2018", "dom"]` to build and test tsconfig files
  - Add post-processing script to restore reference directive stripped by api-extractor
- [#509](https://github.com/nevware21/ts-async/pull/509) [BUG] Fix `Promise.then()` behavior to ignore non-function handlers per Promises/A+ 2.2.1
- [#511](https://github.com/nevware21/ts-async/pull/511) [BUG] Fix `doFinally` fallback to await thenables returned by `onFinally`
- [#505](https://github.com/nevware21/ts-async/pull/505) [BUG] Ensure settled tasks are removed from scheduler queues when stale timeout is disabled
- [#514](https://github.com/nevware21/ts-async/pull/514) [REFACTOR] `setTimeout` used instead of microtask queue for promise resolution[#503](https://github.com/nevware21/ts-async/issues/503)
- [#450](https://github.com/nevware21/ts-async/pull/450) [CHORE] Bump `@nevware21` components to latest recommended versions
- [#430](https://github.com/nevware21/ts-async/pull/430) [TEST] Replace `chai` with `@nevware21/tripwire` for assertion testing

For full details see [v0.5.5...v0.6.0](https://github.com/nevware21/ts-async/compare/v0.5.5...v0.6.0)

# v0.5.5 Jan 5th, 2026

## Changelog

- [#420](https://github.com/nevware21/ts-async/issues/420) [REFACTOR] Fix signatures to use and return IPromise interface instead of Promise
  - Add isPlainObject validation to Promise tests to ensure different Promise implementations return expected object types
- [#363](https://github.com/nevware21/ts-async/issues/363) [BUG] Fix @sinonjs/samsam dependency compatibility issue
  - Downgrade sinon from v15.0.0 to v14.0.0 to resolve optional chaining syntax parsing error in browser tests
  - This fixes karma-typescript parser error: "Unexpected token (197:30)" in @sinonjs/samsam v8.0.3
  - Now uses @sinonjs/samsam v7.0.1 which is compatible with the karma-typescript parser

For full details see [v0.5.4...v0.5.5](https://github.com/nevware21/ts-async/compare/v0.5.4...v0.5.5)

# v0.5.4 Dec 14th, 2024

## Changelog

- [#241](https://github.com/nevware21/ts-async/issues/241) Update dependabot.yml
- [#242](https://github.com/nevware21/ts-async/issues/242) Bump actions/checkout from 2 to 4
- [#243](https://github.com/nevware21/ts-async/issues/243) Bump github/codeql-action from 2 to 3
- [#244](https://github.com/nevware21/ts-async/issues/244) Bump actions/configure-pages from 4 to 5
- [#247](https://github.com/nevware21/ts-async/issues/247) Bump rollup-plugin-istanbul from 4.0.0 to 5.0.0 in /lib
- [#246](https://github.com/nevware21/ts-async/issues/246) Bump @types/sinon from 10.0.20 to 17.0.3 in /lib
- [#249](https://github.com/nevware21/ts-async/issues/249) Bump nyc from 15.1.0 to 17.1.0 in /lib
- [#250](https://github.com/nevware21/ts-async/issues/250) Bump @rollup/plugin-typescript from 11.1.6 to 12.1.1 in /lib
- [#251](https://github.com/nevware21/ts-async/issues/251) Bump rollup from 3.29.5 to 4.26.0 in /lib
- [#245](https://github.com/nevware21/ts-async/issues/245) Bump codecov/codecov-action from 2 to 4
- [#254](https://github.com/nevware21/ts-async/issues/254) Bump @rollup/plugin-commonjs from 25.0.8 to 28.0.1 in /lib
- [#255](https://github.com/nevware21/ts-async/issues/255) Bump @microsoft/rush from 5.140.0 to 5.140.1
- [#257](https://github.com/nevware21/ts-async/issues/257) Update to use ts-build-tools instead of local
  - [#260](https://github.com/nevware21/ts-async/issues/260) Bump @nevware21/ts-build-tools to ^0.1.3
- [#259](https://github.com/nevware21/ts-async/issues/259) Bump codecov/codecov-action from 4 to 5
- [#267](https://github.com/nevware21/ts-async/issues/267) Create FUNDING.yml
  - [#268](https://github.com/nevware21/ts-async/issues/268) Update FUNDING.yml
- [#277](https://github.com/nevware21/ts-async/issues/277) [doc] TSDoc Error During Build
  - [#280](https://github.com/nevware21/ts-async/issues/280) [doc] TSDoc Error During Build #277
- [#281](https://github.com/nevware21/ts-async/issues/281) Bump @microsoft/rush from 5.140.1 to 5.147.0
- [#282](https://github.com/nevware21/ts-async/issues/282) Bump @nevware21/ts-utils from 0.11.5 to 0.11.6
- [#283](https://github.com/nevware21/ts-async/issues/283) Fixup rollup pure warnings


# v0.5.3 Oct 27th, 2024

## Changelog

- [#237](https://github.com/nevware21/ts-async/issues/237) [BUG] Sourcemap load errors in debugger from @nevware21 dependencies
  - Also Bumps ts-utils to 0.11.5
- [#218](https://github.com/nevware21/ts-async/pull/218) Bump @nevware21/grunt-ts-plugin from 0.4.5 to 0.4.6
- [#219](https://github.com/nevware21/ts-async/pull/219) Bump @nevware21/grunt-eslint-ts from 0.2.4 to 0.2.5
- [#220](https://github.com/nevware21/ts-async/pull/220) Bump @nevware/grunt-ts-plugin and grunt-es-plugin to 0.5.0
- [#229](https://github.com/nevware21/ts-async/pull/229) chore: Update codecov uploading
- [#230](https://github.com/nevware21/ts-async/pull/230) chore: Update to auto generate docs and remove typedoc from repo
- [#228](https://github.com/nevware21/ts-async/pull/228) chore: Update to ts-utils 0.11.4
- [#231](https://github.com/nevware21/ts-async/pull/231) Exclude typedoc folder
- [#232](https://github.com/nevware21/ts-async/pull/232) update @nevware21/grunt plugins from 0.5.0 to ^0.5.1
- [#233](https://github.com/nevware21/ts-async/pull/233) Update doAwait docs
- [#234](https://github.com/nevware21/ts-async/pull/234) Typeedoc: Fixup name issue
- [#235](https://github.com/nevware21/ts-async/pull/235) Bump puppeteer from 21.6.0 to 23.4.0
- [#236](https://github.com/nevware21/ts-async/pull/236) Bump @types/chai from 4.3.20 to 5.0.0

# v0.5.2 June 27th, 2024

## Changelog

- #173 Bump @microsoft/rush from 5.120.4 to 5.121.0
- #174 Bump @microsoft/rush from 5.121.0 to 5.122.0
- #183 Bump @microsoft/rush from 5.122.0 to 5.124.6
- #210 Update Copyright message to comply with LLC operating agreement
- #195 Bump nyc from 15.1.0 to 17.0.0
- #212 Bump @nevware21/ts-utils from 0.11.2 to 0.11.3
- #213 Bump typedoc from 0.25.13 to 0.26.2
- #214 Bump @microsoft/rush from 5.124.6 to 5.129.6

# v0.5.1 Apr 16th, 2024

## Changelog

- #165 Generate single unified es module for exports
  - Minification hints and optimizations for webpack using ts-utils 0.11.2
- #162 Bump @microsoft/rush from 5.118.7 to 5.120.0
- #164 Bump @microsoft/rush from 5.120.0 to 5.120.2
- #167 Bump @microsoft/rush from 5.120.2 to 5.120.4

# v0.5.0 Mar 29th, 2024

## Changelog

- #115 [Feature] Add size tests
- #116 [Bug] createAllPromise signature is different from native Promise.all
- #117 [Feature] Add Asynchronous helper functions
- #132 [Bug] Package sizes are too large
- #148 [Feature] Add Race and Any Promise support
- #149 Update rush.json to 5.118.1
- #119 Update generation for better Tree-Shaking

# v0.4.0 Dec 13th, 2023

## Changelog

- #108 [Bug] doAwaitResponse should return / handle any additional value returned by the callback function

# v0.3.0 Aug 17th, 2023

## Changelog

- #79 [Bug] remove typescript should not be a peer dependency
- #82 Bump @nevware21/ts-utils to minimum of 0.10.0
- #81 Bump @microsoft/rush to 5.102.0
- #74 Bump @typescript-eslint/eslint-plugin from 5.62.0 to 6.1.0

# v0.2.6 June 12th, 2023

## Changelog

- #65 [Bug] Dependency @nevware21/tools-pre-proc@0.1.0 cannot be resolved

# v0.2.5 June 11th, 2023

## Changelog

- #54 Add Pre-Processor to remove _debugLog from modules
  - This removes the debug / test code from the final generated packages (resulting in smaller production bundles)
- #57 Bump @rollup/plugin-commonjs from 24.1.0 to 25.0.0 in /lib
- #60 Bump @nevware21/ts-utils min version from 0.9.5 to 0.9.7
- #61 Bump @microsoft/rush from 5.98.0 to 5.99.0
- #62 Create SECURITY.md
- #63 Add Issue Templates

# v0.2.4 Apr 25th, 2023

## Changelog

- #50 [Bug] SCRIPT5009: 'Promise' is undefined
- #52 Update ts-utils to 0.9.5

# v0.2.3 Apr 24th, 2023

## Changelog

- #47 Add alias for Promise to avoid matching "new Promise"
- #46 Bump typedoc to ^0.24.4
- #45 Update release packaging and publishing steps
- #44 Bump @microsoft/rush from 5.97.0 to 5.97.1
- #39 Bump @microsoft/rush from 5.95.0 to 5.97.0

# v0.2.2 Mar 25th, 2023

## Changelog

- #36 [Packaging] The single module file is causing some packagere issues
  - Update ts-utils version to 0.9.3
  - Update rush to 5.95.0

# v0.2.1 Mar 2nd, 2023

## Changelog

- #27 [Bug] v0.2.0 of the scheduler is throwing an error when a waited task rejects
- #28 Update to ts-utils@0.8.1

# v0.2.0 Feb 26th, 2023

## Changelog

- #23 [Feature] Migrate Promise based Task Scheduler
  - Migrated the task scheduler from internal usage to public
  - Uses promises to sequence tasks

# v0.1.2 Feb 17th, 2023

## Changelog

- #18 [Bug] Version 0.1.1 does not support resolving a promise with a promise properly.
- #20 Update Packaging to create single rollup packages

# v0.1.1 Feb 5th, 2023

## Changelog

- #12 Update prep_release target to copy README.md to npm pack
- #13 Add root coverage config
- #14 Update npm pack to also copy LICENSE file
- #15 chore: Fix worker coverage reporting.

# v0.1.0 Jan 21st, 2023

## Changelog

- #1 Initial Implementation includes