move Map upsert to stage 3

Author: zloirock

CHANGELOG.md

@@ -21,7 +21,16 @@
     - `Iterator.concat`
   - Moved to stage 3, [July 2025 TC39 meeting](https://github.com/tc39/proposals/commit/3eebab0f8594673dd08bc709d68c011016074c2e)
   - Added `/actual/` namespace entries, unconditional forced replacement changed to feature detection
+- [`Map` upsert proposal](https://github.com/tc39/proposal-upsert):
+  - Built-ins:
+    - `Map.prototype.getOrInsert`
+    - `Map.prototype.getOrInsertComputed`
+    - `WeakMap.prototype.getOrInsert`
+    - `WeakMap.prototype.getOrInsertComputed`
+  - Moved to stage 3, July 2025 TC39 meeting
+  - Added `/actual/` namespace entries, unconditional forced replacement changed to feature detection
 - Added missing dependencies to some entries of static `Iterator` methods
+- Fixed [Joint Iteration proposal](https://github.com/tc39/proposal-joint-iteration) in `/stage/` entries
 - Compat data improvements:
   - [`Uint8Array` to / from base64 and hex proposal](https://github.com/tc39/proposal-arraybuffer-base64) features marked as [supported from V8 ~ Chromium 140](https://issues.chromium.org/issues/42204568#comment37)
   - `%TypedArray%.prototype.with` marked as fixed in Safari 26.0

README.md

@@ -168,11 +168,11 @@ structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
       - [`Math.sumPrecise`](#mathsumprecise)
     - [Stage 3 proposals](#stage-3-proposals)
       - [`Iterator` sequencing](#iterator-sequencing)
+      - [`Map` upsert](#map-upsert)
       - [`JSON.parse` source text access](#jsonparse-source-text-access)
       - [`Symbol.metadata` for decorators metadata proposal](#symbolmetadata-for-decorators-metadata-proposal)
     - [Stage 2.7 proposals](#stage-27-proposals)
       - [Joint iteration](#joint-iteration)
-      - [`Map` upsert](#map-upsert)
     - [Stage 2 proposals](#stage-2-proposals)
       - [`AsyncIterator` helpers](#asynciterator-helpers)
       - [`Iterator.range`](#iteratorrange)
@@ -2712,6 +2712,42 @@ Iterator.concat([0, 1].values(), [2, 3], function * () {
 }()).toArray(); // => [0, 1, 2, 3, 4, 5]
 ```
 
+##### [`Map` upsert](https://github.com/thumbsupep/proposal-upsert)[⬆](#index)
+Modules [`esnext.map.get-or-insert`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.map.get-or-insert.js), [`esnext.map.get-or-insert-computed`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.map.get-or-insert-computed.js), [`esnext.weak-map.get-or-insert`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.weak-map.get-or-insert.js) and [`esnext.weak-map.get-or-insert-computed`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.weak-map.get-or-insert-computed.js)
+```ts
+class Map {
+  getOrInsert(key: any, value: any): any;
+  getOrInsertComputed(key: any, (key: any) => value: any): any;
+}
+
+class WeakMap {
+  getOrInsert(key: any, value: any): any;
+  getOrInsertComputed(key: any, (key: any) => value: any): any;
+}
+```
+[*CommonJS entry points:*](#commonjs-api)
+```
+core-js/proposals/map-upsert-v4
+core-js(-pure)/actual|full/map/get-or-insert
+core-js(-pure)/actual|full/map/get-or-insert-computed
+core-js(-pure)/actual|full/weak-map/get-or-insert
+core-js(-pure)/actual|full/weak-map/get-or-insert-computed
+```
+[*Examples*](https://tinyurl.com/2a54u5ux):
+```js
+const map = new Map([['a', 1]]);
+
+map.getOrInsert('a', 2); // => 1
+
+map.getOrInsert('b', 3); // => 3
+
+map.getOrInsertComputed('a', key => key); // => 1
+
+map.getOrInsertComputed('c', key => key); // => 'c'
+
+console.log(map); // => Map { 'a': 1, 'b': 3, 'c': 'c' }
+```
+
 ##### [`JSON.parse` source text access](https://github.com/tc39/proposal-json-parse-with-source)[⬆](#index)
 Modules [`esnext.json.is-raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.is-raw-json.js), [`esnext.json.parse`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.parse.js), [`esnext.json.raw-json`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.json.raw-json.js).
 ```ts
@@ -2827,42 +2863,6 @@ Iterator.zipKeyed({
  */
 ```
 
-##### [`Map` upsert](https://github.com/thumbsupep/proposal-upsert)[⬆](#index)
-Modules [`esnext.map.get-or-insert`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.map.get-or-insert.js), [`esnext.map.get-or-insert-computed`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.map.get-or-insert-computed.js), [`esnext.weak-map.get-or-insert`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.weak-map.get-or-insert.js) and [`esnext.weak-map.get-or-insert-computed`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.weak-map.get-or-insert-computed.js)
-```ts
-class Map {
-  getOrInsert(key: any, value: any): any;
-  getOrInsertComputed(key: any, (key: any) => value: any): any;
-}
-
-class WeakMap {
-  getOrInsert(key: any, value: any): any;
-  getOrInsertComputed(key: any, (key: any) => value: any): any;
-}
-```
-[*CommonJS entry points:*](#commonjs-api)
-```
-core-js/proposals/map-upsert-v4
-core-js(-pure)/full/map/get-or-insert
-core-js(-pure)/full/map/get-or-insert-computed
-core-js(-pure)/full/weak-map/get-or-insert
-core-js(-pure)/full/weak-map/get-or-insert-computed
-```
-[*Examples*](https://tinyurl.com/2a54u5ux):
-```js
-const map = new Map([['a', 1]]);
-
-map.getOrInsert('a', 2); // => 1
-
-map.getOrInsert('b', 3); // => 3
-
-map.getOrInsertComputed('a', key => key); // => 1
-
-map.getOrInsertComputed('c', key => key); // => 'c'
-
-console.log(map); // => Map { 'a': 1, 'b': 3, 'c': 'c' }
-```
-
 #### Stage 2 proposals[⬆](#index)
 [*CommonJS entry points:*](#commonjs-api)
 ```

packages/core-js/actual/map/get-or-insert-computed.js

@@ -0,0 +1,6 @@
+'use strict';
+require('../../modules/es.map');
+require('../../modules/esnext.map.get-or-insert-computed');
+var entryUnbind = require('../../internals/entry-unbind');
+
+module.exports = entryUnbind('Map', 'getOrInsertComputed');

packages/core-js/actual/map/get-or-insert.js

@@ -0,0 +1,6 @@
+'use strict';
+require('../../modules/es.map');
+require('../../modules/esnext.map.get-or-insert');
+var entryUnbind = require('../../internals/entry-unbind');
+
+module.exports = entryUnbind('Map', 'getOrInsert');

packages/core-js/actual/map/index.js

@@ -1,5 +1,7 @@
 'use strict';
 var parent = require('../../stable/map');
+require('../../modules/esnext.map.get-or-insert');
+require('../../modules/esnext.map.get-or-insert-computed');
 require('../../modules/esnext.map.group-by');
 
 module.exports = parent;

packages/core-js/actual/weak-map/get-or-insert-computed.js

@@ -0,0 +1,6 @@
+'use strict';
+require('../../modules/es.weak-map');
+require('../../modules/esnext.weak-map.get-or-insert-computed');
+var entryUnbind = require('../../internals/entry-unbind');
+
+module.exports = entryUnbind('WeakMap', 'getOrInsertComputed');

packages/core-js/actual/weak-map/get-or-insert.js

@@ -0,0 +1,6 @@
+'use strict';
+require('../../modules/es.weak-map');
+require('../../modules/esnext.weak-map.get-or-insert');
+var entryUnbind = require('../../internals/entry-unbind');
+
+module.exports = entryUnbind('WeakMap', 'getOrInsert');

packages/core-js/actual/weak-map/index.js

@@ -1,4 +1,6 @@
 'use strict';
 var parent = require('../../stable/weak-map');
+require('../../modules/esnext.weak-map.get-or-insert');
+require('../../modules/esnext.weak-map.get-or-insert-computed');
 
 module.exports = parent;

packages/core-js/full/map/get-or-insert-computed.js

@@ -1,6 +1,4 @@
 'use strict';
-require('../../modules/es.map');
-require('../../modules/esnext.map.get-or-insert-computed');
-var entryUnbind = require('../../internals/entry-unbind');
+var parent = require('../../actual/map/get-or-insert-computed');
 
-module.exports = entryUnbind('Map', 'getOrInsertComputed');
+module.exports = parent;

packages/core-js/full/map/get-or-insert.js

@@ -1,6 +1,4 @@
 'use strict';
-require('../../modules/es.map');
-require('../../modules/esnext.map.get-or-insert');
-var entryUnbind = require('../../internals/entry-unbind');
+var parent = require('../../actual/map/get-or-insert');
 
-module.exports = entryUnbind('Map', 'getOrInsert');
+module.exports = parent;