Merge pull request #1383 from zloirock/iterator-sequencing-stage-3

Author: zloirock

CHANGELOG.md

@@ -16,6 +16,11 @@
     - `Math.sumPrecise`
   - Moved to stable ES, [July 2025 TC39 meeting](https://github.com/tc39/proposals/commit/2616413ace9074bfd444adee9501fae4c8d66fcb)
   - Added `es.` namespace module, `/es/` and `/stable/` namespaces entries
+- [`Iterator` sequencing proposal](https://github.com/tc39/proposal-iterator-sequencing):
+  - Built-ins:
+    - `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
 - Added missing dependencies to some entries of static `Iterator` methods
 - 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)

README.md

@@ -167,10 +167,10 @@ structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
       - [New `Set` methods](#new-set-methods)
       - [`Math.sumPrecise`](#mathsumprecise)
     - [Stage 3 proposals](#stage-3-proposals)
+      - [`Iterator` sequencing](#iterator-sequencing)
       - [`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)
-      - [`Iterator` sequencing](#iterator-sequencing)
       - [Joint iteration](#joint-iteration)
       - [`Map` upsert](#map-upsert)
     - [Stage 2 proposals](#stage-2-proposals)
@@ -2692,6 +2692,26 @@ core-js/proposals/math-sum
 core-js(-pure)/stage/3
 ```
 
+##### [`Iterator` sequencing](https://github.com/tc39/proposal-iterator-sequencing)[⬆](#index)
+Module [`esnext.iterator.concat`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.iterator.concat.js)
+```ts
+class Iterator {
+  concat(...items: Array<IterableObject>): Iterator<any>;
+}
+```
+[*CommonJS entry points:*](#commonjs-api)
+```
+core-js/proposals/iterator-sequencing
+core-js(-pure)/actual|full/iterator/concat
+```
+[*Example*](https://tinyurl.com/2522xjae):
+```js
+Iterator.concat([0, 1].values(), [2, 3], function * () {
+  yield 4;
+  yield 5;
+}()).toArray(); // => [0, 1, 2, 3, 4, 5]
+```
+
 ##### [`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
@@ -2756,26 +2776,6 @@ core-js(-pure)/actual|full/function/metadata
 core-js(-pure)/stage/2.7
 ```
 
-##### [`Iterator` sequencing](https://github.com/tc39/proposal-iterator-sequencing)[⬆](#index)
-Module [`esnext.iterator.concat`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.iterator.concat.js)
-```ts
-class Iterator {
-  concat(...items: Array<IterableObject>): Iterator<any>;
-}
-```
-[*CommonJS entry points:*](#commonjs-api)
-```
-core-js/proposals/iterator-sequencing
-core-js(-pure)/full/iterator/concat
-```
-[*Example*](https://tinyurl.com/2522xjae):
-```js
-Iterator.concat([0, 1].values(), [2, 3], function * () {
-  yield 4;
-  yield 5;
-}()).toArray(); // => [0, 1, 2, 3, 4, 5]
-```
-
 ##### [Joint iteration](https://github.com/tc39/proposal-joint-iteration)[⬆](#index)
 Modules [esnext.iterator.zip](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.iterator.zip.js), [esnext.iterator.zip-keyed](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.iterator.zip-keyed.js)
 ```ts

packages/core-js/actual/iterator/concat.js

@@ -0,0 +1,21 @@
+'use strict';
+require('../../modules/es.array.iterator');
+require('../../modules/es.object.to-string');
+require('../../modules/es.string.iterator');
+require('../../modules/es.iterator.constructor');
+require('../../modules/es.iterator.drop');
+require('../../modules/es.iterator.every');
+require('../../modules/es.iterator.filter');
+require('../../modules/es.iterator.find');
+require('../../modules/es.iterator.flat-map');
+require('../../modules/es.iterator.for-each');
+require('../../modules/es.iterator.map');
+require('../../modules/es.iterator.reduce');
+require('../../modules/es.iterator.some');
+require('../../modules/es.iterator.take');
+require('../../modules/es.iterator.to-array');
+require('../../modules/esnext.iterator.concat');
+require('../../modules/web.dom-collections.iterator');
+var path = require('../../internals/path');
+
+module.exports = path.Iterator.concat;

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

@@ -2,6 +2,7 @@
 var parent = require('../../stable/iterator');
 require('../../modules/es.promise');
 require('../../modules/esnext.iterator.constructor');
+require('../../modules/esnext.iterator.concat');
 require('../../modules/esnext.iterator.dispose');
 require('../../modules/esnext.iterator.drop');
 require('../../modules/esnext.iterator.every');

packages/core-js/full/iterator/concat.js

@@ -1,24 +1,7 @@
 'use strict';
-require('../../modules/es.array.iterator');
-require('../../modules/es.object.to-string');
-require('../../modules/es.string.iterator');
-require('../../modules/es.iterator.constructor');
-require('../../modules/es.iterator.drop');
-require('../../modules/es.iterator.every');
-require('../../modules/es.iterator.filter');
-require('../../modules/es.iterator.find');
-require('../../modules/es.iterator.flat-map');
-require('../../modules/es.iterator.for-each');
-require('../../modules/es.iterator.map');
-require('../../modules/es.iterator.reduce');
-require('../../modules/es.iterator.some');
-require('../../modules/es.iterator.take');
-require('../../modules/es.iterator.to-array');
+var parent = require('../../actual/iterator/concat');
 require('../../modules/esnext.iterator.chunks');
-require('../../modules/esnext.iterator.concat');
 require('../../modules/esnext.iterator.sliding');
 require('../../modules/esnext.iterator.windows');
-require('../../modules/web.dom-collections.iterator');
-var path = require('../../internals/path');
 
-module.exports = path.Iterator.concat;
+module.exports = parent;

packages/core-js/full/iterator/index.js

@@ -1,7 +1,6 @@
 'use strict';
 var parent = require('../../actual/iterator');
 require('../../modules/esnext.iterator.chunks');
-require('../../modules/esnext.iterator.concat');
 require('../../modules/esnext.iterator.range');
 require('../../modules/esnext.iterator.sliding');
 require('../../modules/esnext.iterator.windows');

packages/core-js/modules/esnext.iterator.concat.js

@@ -35,7 +35,7 @@ var IteratorProxy = createIteratorProxy(function () {
 
 // `Iterator.concat` method
 // https://github.com/tc39/proposal-iterator-sequencing
-$({ target: 'Iterator', stat: true, forced: true }, {
+$({ target: 'Iterator', stat: true }, {
   concat: function concat() {
     var length = arguments.length;
     var iterables = $Array(length);

packages/core-js/stage/2.7.js

@@ -1,7 +1,6 @@
 'use strict';
 var parent = require('./3');
 
-require('../proposals/iterator-sequencing');
 require('../proposals/map-upsert-v4');
 
 module.exports = parent;

packages/core-js/stage/3.js

@@ -2,6 +2,7 @@
 var parent = require('./4');
 
 require('../proposals/decorator-metadata-v2');
+require('../proposals/iterator-sequencing');
 require('../proposals/json-parse-with-source');
 // TODO: Obsolete versions, remove from `core-js@4`
 require('../proposals/array-grouping-stage-3');

tests/entries/unit.mjs

@@ -710,6 +710,7 @@ for (PATH of ['core-js-pure', 'core-js']) {
     ok(typeof load(NS, 'async-iterator/take') == 'function');
     ok(typeof load(NS, 'async-iterator/to-array') == 'function');
     ok(load(NS, 'function/metadata') === null);
+    ok(load(NS, 'iterator/concat')([2]).next().value === 2);
     ok(typeof load(NS, 'iterator/to-async') == 'function');
     ok(load(NS, 'json/is-raw-json')({}) === false);
     ok(load(NS, 'json/parse')('[42]', (key, value, { source }) => typeof value == 'number' ? source + source : value)[0] === '4242');
@@ -771,7 +772,6 @@ for (PATH of ['core-js-pure', 'core-js']) {
     ok(load(NS, 'function/virtual/un-this').call([].slice)([1, 2, 3], 1)[0] === 2);
     ok(typeof load(NS, 'iterator/as-indexed-pairs') == 'function');
     ok(typeof load(NS, 'iterator/indexed') == 'function');
-    ok(load(NS, 'iterator/concat')([2]).next().value === 2);
     ok(load(NS, 'iterator/range')(1, 2).next().value === 1);
     ok(typeof load(NS, 'iterator/chunks') == 'function');
     ok(typeof load(NS, 'iterator/sliding') == 'function');