What's Changed

• Migrate some files to TS by@jdeniau in#2125
  • Iterator.ts
  • PairSorting.ts
  • toJS.ts
  • Math.ts
  • Hash.ts
• Extract CollectionHelperMethods and convert to TS by@jdeniau in#2131
• Use npmtrusted publishing only to avoid token stealing.

Documentation

• Fix/a11y issues by@lyannel in#2136
• Doc add Map.get signature update by@borracciaBlu in#2138
• fix(doc):minor-issues#2132 by@JayMeDotDot in#2133
• Fix algolia search by@jdeniau in#2135
• Typo in OrderedMap by@jdeniau in#2144

Internal

• chore: Sort all imports and activate eslint import rule by@jdeniau in#2119

New Contributors

• @JayMeDotDot made their first contribution in#2133
• @lyannel made their first contribution in#2136
• @borracciaBlu made their first contribution in#2138

Full Changelog:v5.1.3...v5.1.4

Contributors

What's Changed

TypeScript

• fix: allow readonly map entry constructor by@septs in#2123

Documentation

There has been a huge amount of changes in the documentation, mainly migrate from an autogenerated documentation from .d.ts file, to a proper documentation in markdown.
The playground has been included on nearly all method examples.
We added a page about browser extensions too:https://immutable-js.com/browser-extension/

• Doc as mdx instead of export from .d.ts file by@jdeniau in#2104
• Remove runkit by@jdeniau in#2107
• only one worker for REPL by@jdeniau in#2108
• Require to import by@jdeniau in#2109
• Add Inheritance cheatsheet section by@jdeniau in#2110
• Optimize SEO (google verification, canonical, noindex) by@jdeniau in#2112
• Upgrade devtools and fix worker by@jdeniau in#2111
• Add documentation about browser extension by@jdeniau in#2115
• fix responsive for width between 680px and 1024px and Add menu in mobile by@jdeniau in#2116
• doc: Better sidebar for v5 navigation by@jdeniau in#2118

Internal

• replace rimraf by a node script by@jdeniau in#2113
• remove warning for tseslint config by@jdeniau in#2114
• Use default tsconfig for tests by@jdeniau in#2055
• add tests for arrCopy by@jdeniau in#2120

New Contributors

• @septs made their first contribution in#2123

Full Changelog:v5.1.2...v5.1.3

Contributors

What's Changed

• Revert previous assertion as it introduced a regression by by@giggo1604 in#2100 and@jdeniau in#2102
• Merge should work with empty record by@jdeniau in#2103

Tooling

• Ensure files are properly builded by@jdeniau in#2081
• Better TypeScript configuration for jest by@jdeniau in#2087

Documentation

• move check-build-output to mjs file by@jdeniau in#2082
• Bump next from 14.2.24 to 14.2.26 by@dependabot in#2084
• Migrate from jasmine-check to fast-check by@jdeniau in#2083
• Add a playground / repl in the documentation by@jdeniau in#2089
• Fix issue with responsive by@jdeniau in#2090
• Dark mode for documentation by@jdeniau in#2091
• Upgrade doc website to next 15 by@jdeniau in#2092
• chore: update type tests by@mrazauskas in#2093
• Encode code to / decode code from the URL hash. by@jdeniau in#2096
• extract repl worker script to a proper file by@jdeniau in#2097
• Deep formatter in playground by@jdeniau in#2099

New Contributors

• @giggo1604 made their first contribution in#2100

Full Changelog:v5.1.1...v5.1.2

Contributors

What's Changed

Fix issue in builded types files in 5.1.0 due to cpy-cli upgrade

Full Changelog:v5.1.0...v5.1.1

What's Changed

• Add shuffle to list#2066 by@mazerty
• TypeScript: Better getInRetrievePath#2070 by@jdeniau
• Fix#1915 "Converting a Seq to a list causes RangeError (max call size exceeded)" by@alexvictoor in#2038
• TypeScript: Fix proper typings for Seq.concat()#2040 by@alexvictoor
• Fix Uncaught "TypeError: keyPath.slice is not a function" for ArrayLike method#2065 by@jdeniau

Internal

• Upgrade typescript and typescript-eslint#2046 by@jdeniau
• Upgrade to rollup 4#2049 by@jdeniau
• Start migrating codebase to TypeScript without any runtime change nor .d.ts change:
  • allow TS files to be compiled in src dir#2054 by@jdeniau
• add exception for code that should not happen in updateIn#2074 by@jdeniau
• Reformat Range.toString for readability#2075 by@Ustin.Vaskin

New Contributors

• @mazerty made their first contribution in#2066
• @ustinvaskin made their first contribution in#2075

Full Changelog:v5.0.2...v5.1.0

Contributors

What's Changed

• Fix List.VNode.removeAfter() / removeBefore() issue on some particular case by@alexvictoor in#2030

New Contributors

• @alexvictoor made their first contribution in#2030

Full Changelog:v5.0.2...v5.0.3

Contributors

Changed

• Fix wrong path for esm module after fix in 5.0.1

Full Changelog:v5.0.1...v5.0.2

What's Changed

Fixes

• Fix circular dependency issue with ESM build by@iambumblehead in#2035

Internal

• Upgrade TSTyche by@mrazauskas in#2034

Full Changelog:v5.0.0...v5.0.1

Contributors

Breaking changes

To sum up, thebig change in 5.0 is a Typescript change related toMap that is typed closer to the JS object. This is a huge change for TS users, but do not impact the runtime behavior. (seeImprove TypeScript definition forMap for more details)

Other breaking changes are:

[BREAKING] Remove deprecated methods:

Released in 5.0.0-rc.1

• Map.of('k', 'v'): useMap([ [ 'k', 'v' ] ]) orMap({ k: 'v' })
• Collection.isIterable: useisIterable directly
• Collection.isKeyed: useisKeyed directly
• Collection.isIndexed: useisIndexed directly
• Collection.isAssociative: useisAssociative directly
• Collection.isOrdered: useisOrdered directly

[BREAKING]OrdererMap andOrderedSet hashCode implementation has been fixed

Released in 5.0.0-rc.1

Fix issue implementation ofhashCode forOrdererMap andOrderedSet where equal objects might not return the samehashCode.

Changed in#2005

[BREAKING] Range function needs at least two defined parameters

Released in 5.0.0-beta.5

Range withundefined would end in an infinite loop. Now, you need to define at least the start and end values.

If you need an infinite range, you can useRange(0, Infinity).

Changed in#1967 by@jdeniau

[Minor BC break] Remove default export

Released in 5.0.0-beta.1

Immutable does not export a default object containing all it's API anymore.
As a drawback, you can notimmport Immutable directly:

- import Immutable from 'immutable';+ import { List, Map } from 'immutable';- const l = Immutable.List([Immutable.Map({ a: 'A' })]);+ const l = List([Map({ a: 'A' })]);

If you want the non-recommanded, but shorter migration path, you can do this:

- import Immutable from 'immutable';+ import * as Immutable from 'immutable';  const l = Immutable.List([Immutable.Map({ a: 'A' })]);

[TypeScript Break] Improve TypeScript definition forMap

Released in 5.0.0-beta.1

If you do use TypeScript, then this change does not impact you : no runtime change here.
But if you use Map with TypeScript, this is a HUGE change !
Imagine the following code

constm=Map({length:3,1:'one'});

This was previously typed asMap<string, string | number>

and return type ofm.get('length') orm.get('inexistant') was typed asstring | number | undefined.

This madeMap really unusable with TypeScript.

Now the Map is typed like this:

MapOf<{length:number;1:string;}>

and the return type ofm.get('length') is typed asnumber.

The return ofm.get('inexistant') throw the TypeScript error:

Argument of type '"inexistant"' is not assignable to parameter of type '1 | "length"

If you want to keep the old definition

This is a minor BC for TS users, so if you want to keep the old definition, you can declare you Map like this:

constm=Map<string,string|number>({length:3,1:'one'});

If you need to type the Map with a larger definition

You might want to declare a wider definition, you can type your Map like this:

typeMyMapType={length:number;1:string|null;optionalProperty?:string;};constm=Map<MyMapType>({length:3,1:'one'});

Keep in mind that theMapOf will try to be consistant with the simple TypeScript object, so you can not do this:

Map({a:'a'}).set('b','b');Map({a:'a'}).delete('a');

Like a simple object, it will only work if the type is forced:

Map<{a:string;b?:string}>({a:'a'}).set('b','b');// b is forced in type and optionalMap<{a?:string}>({a:'a'}).delete('a');// you can only delete an optional key

Are allMap methods implemented ?

For now, onlyget,getIn,set,update,delete,remove,toJS,toJSON methods are implemented. All other methods will fallback to the basicMap definition. Other method definition will be added later, but as some might be really complex, we prefer the progressive enhancement on the most used functions.

Fixes

• Fix type inference for first() and last()#2001 by@butchler
• Fix issue with empty list that is a singleton#2004 by@jdeniau
• Map and Set sort and sortBy return type#2013 by@jdeniau

Internal

• [Internal] Migrating TS type tests from dtslint toTSTyche#1988 and#1991 by@mrazauskas.
  Special thanks to@arnfaldur that migrated every type tests to tsd just before that.
• [internal] Upgrade to rollup 3.x#1965 by@jdeniau
• [internal] upgrade tooling (TS, eslint) and documentation packages:#1971,#1972,#1973,#1974,#1975,#1976,#1977,#1978,#1979,#1980,#1981

Full Changelog:v4.3.3...v5.0.0

What's Changed

• Map and Set sort and sortBy return type by@jdeniau in#2013
• Try to fix issue with empty list that is a singleton by@jdeniau in#2004

Full Changelog:v5.0.0-beta.5...v5.0.0-rc.2

Contributors