move Iterator sequencing proposal to stable ES

Author: zloirock

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 ### Unreleased
+- [`Iterator` sequencing proposal](https://github.com/tc39/proposal-iterator-sequencing):
+  - Built-ins:
+    - `Iterator.concat`
+  - Moved to stable ES, November 2025 TC39 meeting
+  - Added `es.` namespace modules, `/es/` and `/stable/` namespaces entries
 - Fixed increasing `.size` in `URLSearchParams.prototype.append` polyfill in IE8-
 - Compat data improvements:
   - [`Iterator.concat`](https://github.com/tc39/proposal-iterator-sequencing) marked as [shipped in FF147](https://bugzilla.mozilla.org/show_bug.cgi?id=1986672#c4)

README.md

@@ -145,6 +145,7 @@ structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
       - [Explicit Resource Management](#explicit-resource-management)
       - [`Float16` methods](#float16-methods)
       - [`Iterator` helpers](#iterator-helpers)
+      - [`Iterator` sequencing](#iterator-sequencing)
       - [`Object.values` / `Object.entries`](#objectvalues--objectentries)
       - [`Object.fromEntries`](#objectfromentries)
       - [`Object.getOwnPropertyDescriptors`](#objectgetownpropertydescriptors)
@@ -168,7 +169,6 @@ 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)
       - [`Map` upsert](#map-upsert)
       - [`JSON.parse` source text access](#jsonparse-source-text-access)
       - [`Symbol.metadata` for decorators metadata proposal](#symbolmetadata-for-decorators-metadata-proposal)
@@ -869,9 +869,10 @@ await Array.fromAsync((async function * () { yield * [1, 2, 3]; })(), i => i **
 ```
 
 #### ECMAScript: Iterator[⬆](#index)
-Modules [`es.iterator.constructor`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.constructor.js), [`es.iterator.dispose`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.dispose.js), [`es.iterator.drop`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.drop.js), [`es.iterator.every`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.every.js), [`es.iterator.filter`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.filter.js), [`es.iterator.find`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.find.js), [`es.iterator.flat-map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.flat-map.js), [`es.iterator.for-each`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.for-each.js), [`es.iterator.from`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.from.js), [`es.iterator.map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.map.js), [`es.iterator.reduce`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.reduce.js), [`es.iterator.some`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.some.js), [`es.iterator.take`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.take.js), [`es.iterator.to-array`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.to-array.js)
+Modules [`es.iterator.constructor`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.constructor.js), [`es.iterator.concat`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.concat.js), [`es.iterator.dispose`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.dispose.js), [`es.iterator.drop`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.drop.js), [`es.iterator.every`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.every.js), [`es.iterator.filter`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.filter.js), [`es.iterator.find`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.find.js), [`es.iterator.flat-map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.flat-map.js), [`es.iterator.for-each`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.for-each.js), [`es.iterator.from`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.from.js), [`es.iterator.map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.map.js), [`es.iterator.reduce`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.reduce.js), [`es.iterator.some`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.some.js), [`es.iterator.take`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.take.js), [`es.iterator.to-array`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.to-array.js)
 ```ts
 class Iterator {
+  static concat(...items: Array<IterableObject>): Iterator<any>;
   static from(iterable: Iterable<any> | Iterator<any>): Iterator<any>;
   drop(limit: uint): Iterator<any>;
   every(callbackfn: (value: any, counter: uint) => boolean): boolean;
@@ -891,6 +892,7 @@ class Iterator {
 [*CommonJS entry points:*](#commonjs-api)
 ```
 core-js(-pure)/es|stable|actual|full/iterator
+core-js(-pure)/es|stable|actual|full/iterator/concat
 core-js(-pure)/es|stable|actual|full/iterator/dispose
 core-js(-pure)/es|stable|actual|full/iterator/drop
 core-js(-pure)/es|stable|actual|full/iterator/every
@@ -905,7 +907,7 @@ core-js(-pure)/es|stable|actual|full/iterator/some
 core-js(-pure)/es|stable|actual|full/iterator/take
 core-js(-pure)/es|stable|actual|full/iterator/to-array
 ```
-[Examples](https://tinyurl.com/249jw4e4):
+[Examples](https://tinyurl.com/24af2z7v):
 ```js
 [1, 2, 3, 4, 5, 6, 7].values()
   .drop(1)
@@ -917,6 +919,11 @@ core-js(-pure)/es|stable|actual|full/iterator/to-array
 Iterator.from({
   next: () => ({ done: Math.random() > 0.9, value: Math.random() * 10 | 0 }),
 }).toArray(); // => [7, 6, 3, 0, 2, 8]
+
+Iterator.concat([0, 1].values(), [2, 3], function * () {
+  yield 4;
+  yield 5;
+}()).toArray(); // => [0, 1, 2, 3, 4, 5]
 ```
 
 > [!WARNING]
@@ -2428,6 +2435,17 @@ class Iterator {
 core-js/proposals/iterator-helpers-stage-3-2
 ```
 
+##### [`Iterator` sequencing](https://github.com/tc39/proposal-iterator-sequencing)[⬆](#index)
+```ts
+class Iterator {
+  static concat(...items: Array<IterableObject>): Iterator<any>;
+}
+```
+[*CommonJS entry points:*](#commonjs-api)
+```
+core-js/proposals/iterator-sequencing
+```
+
 ##### [`Object.values` / `Object.entries`](https://github.com/tc39/proposal-object-values-entries)[⬆](#index)
 ```ts
 class Object {
@@ -2687,26 +2705,6 @@ 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 {
-  static 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]
-```
-
 ##### [`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

docs/web/docs/features/ecmascript/iterator.md

@@ -1,10 +1,11 @@
 # ECMAScript: Iterator
 ## Modules 
-[`es.iterator.constructor`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.constructor.js), [`es.iterator.dispose`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.dispose.js), [`es.iterator.drop`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.drop.js), [`es.iterator.every`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.every.js), [`es.iterator.filter`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.filter.js), [`es.iterator.find`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.find.js), [`es.iterator.flat-map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.flat-map.js), [`es.iterator.for-each`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.for-each.js), [`es.iterator.from`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.from.js), [`es.iterator.map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.map.js), [`es.iterator.reduce`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.reduce.js), [`es.iterator.some`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.some.js), [`es.iterator.take`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.take.js), [`es.iterator.to-array`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.to-array.js)
+[`es.iterator.constructor`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.constructor.js), [`es.iterator.concat`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.concat.js), [`es.iterator.dispose`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.dispose.js), [`es.iterator.drop`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.drop.js), [`es.iterator.every`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.every.js), [`es.iterator.filter`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.filter.js), [`es.iterator.find`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.find.js), [`es.iterator.flat-map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.flat-map.js), [`es.iterator.for-each`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.for-each.js), [`es.iterator.from`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.from.js), [`es.iterator.map`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.map.js), [`es.iterator.reduce`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.reduce.js), [`es.iterator.some`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.some.js), [`es.iterator.take`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.take.js), [`es.iterator.to-array`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.to-array.js)
 
 ## Built-ins signatures
 ```ts
 class Iterator {
+  static concat(...items: Array<IterableObject>): Iterator<any>;
   static from(iterable: Iterable<any> | Iterator<any>): Iterator<any>;
   drop(limit: uint): Iterator<any>;
   every(callbackfn: (value: any, counter: uint) => boolean): boolean;
@@ -25,6 +26,7 @@ class Iterator {
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```
 core-js(-pure)/es|stable|actual|full/iterator
+core-js(-pure)/es|stable|actual|full/iterator/concat
 core-js(-pure)/es|stable|actual|full/iterator/dispose
 core-js(-pure)/es|stable|actual|full/iterator/drop
 core-js(-pure)/es|stable|actual|full/iterator/every
@@ -52,6 +54,11 @@ core-js(-pure)/es|stable|actual|full/iterator/to-array
 Iterator.from({
   next: () => ({ done: Math.random() > 0.9, value: Math.random() * 10 | 0 }),
 }).toArray(); // => [7, 6, 3, 0, 2, 8]
+
+Iterator.concat([0, 1].values(), [2, 3], function * () {
+  yield 4;
+  yield 5;
+}()).toArray(); // => [0, 1, 2, 3, 4, 5]
 ```
 
 > [!WARNING]

docs/web/docs/features/proposals/iterator-sequencing.md

@@ -3,7 +3,7 @@
 [Proposal repo](https://github.com/tc39/proposal-iterator-sequencing)
 
 ## Modules 
-[`esnext.iterator.concat`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/esnext.iterator.concat.js)
+[`es.iterator.concat`](https://github.com/zloirock/core-js/blob/master/packages/core-js/modules/es.iterator.concat.js)
 
 ## Built-ins signatures
 ```ts
@@ -15,7 +15,7 @@ class Iterator {
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js/proposals/iterator-sequencing
-core-js(-pure)/actual|full/iterator/concat
+core-js(-pure)/es|stable|actual|full/iterator/concat
 ```
 
 ## Example

docs/web/docs/menu.json

@@ -145,6 +145,10 @@
                 "title": "Iterator helpers",
                 "url": "{docs-version}/docs/features/proposals/iterator-helpers"
               },
+              {
+                "title": "Iterator sequencing",
+                "url": "{docs-version}/docs/features/proposals/iterator-sequencing"
+              },
               {
                 "title": "Object.values / Object.entries",
                 "url": "{docs-version}/docs/features/proposals/object-values-entries"
@@ -238,10 +242,6 @@
           {
             "title": "Stage 3 proposals",
             "children": [
-              {
-                "title": "Iterator sequencing",
-                "url": "{docs-version}/docs/features/proposals/iterator-sequencing"
-              },
               {
                 "title": "Map upsert",
                 "url": "{docs-version}/docs/features/proposals/map-upsert"

packages/core-js-compat/src/data.mjs

@@ -685,6 +685,9 @@ export const data = {
     firefox: '131',
     safari: '18.4',
   },
+  'es.iterator.concat': {
+    firefox: '147',
+  },
   'es.iterator.dispose': {
     bun: '1.3.0',
     // reverted in https://issues.chromium.org/issues/42203506#comment25
@@ -2506,9 +2509,8 @@ export const data = {
   },
   'esnext.iterator.chunks': {
   },
-  'esnext.iterator.concat': {
-    firefox: '147',
-  },
+  // TODO: Remove from `core-js@4`
+  'esnext.iterator.concat': null,
   // TODO: Remove from `core-js@4`
   'esnext.iterator.dispose': null,
   // TODO: Remove from `core-js@4`
@@ -3167,6 +3169,7 @@ export const renamed = new Map([
   ['esnext.error.is-error', 'es.error.is-error'],
   ['esnext.global-this', 'es.global-this'],
   ['esnext.iterator.constructor', 'es.iterator.constructor'],
+  ['esnext.iterator.concat', 'es.iterator.concat'],
   ['esnext.iterator.dispose', 'es.iterator.dispose'],
   ['esnext.iterator.drop', 'es.iterator.drop'],
   ['esnext.iterator.every', 'es.iterator.every'],

packages/core-js-compat/src/modules-by-versions.mjs

@@ -311,4 +311,7 @@ export default {
     'es.uint8-array.to-base64',
     'es.uint8-array.to-hex',
   ],
+  3.47: [
+    'es.iterator.concat',
+  ],
 };

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

@@ -1,21 +1,5 @@
 '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('../../stable/iterator/concat');
 require('../../modules/esnext.iterator.concat');
-require('../../modules/web.dom-collections.iterator');
-var path = require('../../internals/path');
 
-module.exports = path.Iterator.concat;
+module.exports = parent;

packages/core-js/es/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/es.iterator.concat');
+require('../../modules/web.dom-collections.iterator');
+var path = require('../../internals/path');
+
+module.exports = path.Iterator.concat;

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

@@ -3,6 +3,7 @@ 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.concat');
 require('../../modules/es.iterator.dispose');
 require('../../modules/es.iterator.drop');
 require('../../modules/es.iterator.every');