True Myth Versions Save

:rocket: Enhancement

• #609 Add support for TypeScript 5.2 (@chriskrycho)

:memo: Documentation

• #572 Fix docs for transposeArray (@chriskrycho)

:house: Internal

• #601 refactor: Remove duplicate tests in '/test/result.test.ts' (@royiro10)
• #585 Further work to fix pnpm usage in TS nightly (@chriskrycho)
• #584 More cleanup: pnpm references and prettierignore (@chriskrycho)
• #583 Fix CI for nightly TS run (@chriskrycho)

Committers: 2

• Chris Krycho (@chriskrycho)
• @royiro10

:bug: Bug Fix

• #570 Fix CJS import location in package exports map (@chriskrycho)

:house: Internal

• #569 Fix docs publishing GH Action (@chriskrycho)

Committers: 1

• Chris Krycho (@chriskrycho)

There is only one actual breaking change since 6.x: dropping support for Node versions earlier than Node 18 LTS. (While that is a small breaking change, around here we like taking care of technical details and SemVer.)

The main benefit here is adding back support for CJS consumption—though it still requires using a recent TS version with support for exports maps and using an appropriate module resolution mode. (We may be able to add support for more "classic" module resolution modes later, as a non-breaking change, with this in place—but make no guarantees!)

:boom: Breaking Change

• #562 [Breaking] Require Node 18, adopt pnpm, use latest release-it (@chriskrycho)

:rocket: Enhancement

• #567 Publish True Myth as a dual-mode package (ESM + CJS) (@chriskrycho)
• #561 Add type-safe Ok.cast() and Err.cast() methods (@chriskrycho)
• #552 Add support for TypeScript 5.0 and 5.1 (@dependabot[bot])
• #469 Add support for TypeScript 4.9 (@dependabot[bot])

:memo: Documentation

• #568 Upgrade to latest TypeDoc (@chriskrycho)

:house: Internal

• #566 Use pnpm in CI (@chriskrycho)

Committers: 3

• Chris Krycho (@chriskrycho)
• Josh Martinez (@jm4rtinez)
• @DaviDevMod

:rocket: Enhancement

• #438 Add explicit support for TS 4.8 (@chriskrycho)

:bug: Bug Fix

• #437 docs: include doc comments in published types (@chriskrycho)

:memo: Documentation

• #437 docs: include doc comments in published types (@chriskrycho)
• #434 Update readme with v6.x requirements (@bmakuh)

:house: Internal

• #436 chore: remove defunct parts of package (@chriskrycho)

Committers: 2

• Ben Makuh (@bmakuh)
• Chris Krycho (@chriskrycho)

:rocket: Enhancement

• Re-export Toolbelt from root for consumers not using TS 4.7’s exports support (@chriskrycho)

:house: Internal

• #388 Remove v5 CI configuration (@chriskrycho)

Committers: 1

• Chris Krycho (@chriskrycho)

There are two significant breaking changes in v6.0:

1. It now requires TypeScript 4.7+ and Node 14+. This allows us to use Node's exports syntax without hacks.
2. It removes items deprecated in the 4.x and 5.x cycles. This allows us to provide better tree-shaking. Previously, using either the Result or Maybe classes meant you also pulled in the other, since they had code to interoperate with each other. These now live only in the toolbelt module, along with the Array helpers.

To upgrade:

1. Update your project to at least Node 14 and TypeScript 4.7.

2. Switch from using any deprecated code to the supported replacements (as described in the docs for each deprecated function).

3. Set compilerOptions.module to Node16 or nodenext in your tsconfig.json. Note: this is the most significant breaking change here: it requires that every other TS package you consume also be compatible with the new mode, and if you are using True Myth in a library, cascades that requirement to your consumers as well.

4. Update to True Myth v6. :tada:

:boom: Breaking Change

• #357 Update publication mechanics with "exports" (@chriskrycho)
• #352 Update minimum Node to v14, add v18 (@chriskrycho)
• #252 Enable tree-shaking by removing deprecated code (@chriskrycho)
• #242 Improve performance by switching to a 'methods-first' implementation (@chriskrycho)

:rocket: Enhancement

• #360 Decrease Unit implementation runtime size (@chriskrycho)
• #356 Improve toString handling (forward-port from v5) (@chriskrycho)
• #351 More forward ports (@chriskrycho)
• #275 One fewer assignment in Nothing construction (@chriskrycho)
• #252 Enable tree-shaking by removing deprecated code (@chriskrycho)
• #251 [Forward] Deprecate Maybe.head for 6.0, preferring Maybe.first (@chriskrycho)
• #250 [Forward] Deprecate non-Toolbelt versions of toolbelt utils (@chriskrycho)
• #249 [Forward] Introduce true-myth/toolbelt module for better tree shaking (@chriskrycho)
• #242 Improve performance by switching to a 'methods-first' implementation (@chriskrycho)

:bug: Bug Fix

• #351 More forward ports (@chriskrycho)
• #276 Finish forward-porting null/undefined reversion (@chriskrycho)
• #274 Forward port more fixes (@chriskrycho)
• 5.1.1 regression: type inference for Result.ok (@krivachy)

:memo: Documentation

• #387 Prep for v6 release (@chriskrycho)
• #383 Incorporate TS 4.7 and next in support matrix (@chriskrycho)
• #355 Update the CHANGELOG and package.json to actual current (@chriskrycho)
• #350 Improve doc comments on Maybe and Toolbelt (@chriskrycho)
• #317 Forward-port CI, docs updates (@chriskrycho)
• #267 [Forward] Fix out-of-date parts of README (@chriskrycho)

:house: Internal

• #387 Final updates (@chriskrycho)
• #386 Drop preversion npm script (@chriskrycho)
• #384 Simplify exports definitions for types (@chriskrycho)
• #383 Incorporate TS 4.7 and next in support matrix (@chriskrycho)
• #377 Add option to run Nightly TS run manually (@chriskrycho)
• #376 Use 'Node16' to support TS 4.7 (@chriskrycho)
• #362 Add Code of Conduct and Contributing guide (@chriskrycho)
• #359 Actually run yarn so TypeDoc is available (@chriskrycho)
• #358 Switch docs publishing to use gh-pages on release (@chriskrycho)
• #353 Use Omit rather than Exclude + keyof in Maybe (@chriskrycho)
• #354 Use Omit rather than Exclude + keyof in Maybe (@chriskrycho)
• #264 [Forward] no ESLint (@chriskrycho)
• #242 Improve performance by switching to a 'methods-first' implementation (@chriskrycho)

Committers: 2

• Akos Krivachy (@krivachy)
• Chris Krycho (@chriskrycho)

This is the final release for v5.x, and only exists to make sure there are fully overlapping supported TypeScript versions for True Myth v5 and v6. See the release notes for the upcoming v6.0 release for upgrade notes.

:rocket: Enhancement

• #382 v5.x: Add Node 18 and TS 4.7 (@chriskrycho)

:house: Internal

• #385 v5.x: Drop preversion npm script (@chriskrycho)
• #361 Add conduct and contributing (v5.x) (@chriskrycho)
• #354 Use Omit rather than Exclude + keyof in Maybe (@chriskrycho)

Committers: 1

• Chris Krycho (@chriskrycho)

:bug: Bug Fix

• #336 Require narrowing before exposing wrapped values (@screendriver)

Committers: 1

• Christian Rackerseder (@screendriver)

:rocket: Enhancement

• #349 Add support for TypeScript 4.7 (@chriskrycho)
• #334 Export pure isErr() function (@screendriver)
• #332 Export pure isNothing() function (@screendriver)
• #333 Export pure isOk() function (@screendriver)
• #331 Export pure isJust() function (@screendriver)

:bug: Bug Fix

• #335 Add missing readonly variants modifiers (@screendriver)

Committers: 2

• Chris Krycho (@chriskrycho)
• Christian Rackerseder (@screendriver)

:rocket: Enhancement

• #299 feat(maybe/find): type narrowing via predicates (@buschtoens)

Committers: 1

• Jan Buschtöns (@buschtoens)