move joint iteration to stage 3

Author: zloirock

CHANGELOG.md

@@ -5,6 +5,12 @@
     - `Iterator.concat`
   - Moved to stable ES, [November 2025 TC39 meeting](https://github.com/tc39/proposals/commit/33be3cb6d6743c7cc8628c547423f49078c0b655)
   - Added `es.` namespace modules, `/es/` and `/stable/` namespaces entries
+- [Joint iteration proposal](https://github.com/tc39/proposal-joint-iteration):
+  - Built-ins:
+    - `Iterator.zip`
+    - `Iterator.zipKeyed`
+  - Moved to stage 3, November 2025 TC39 meeting
+  - Added `/actual/` namespace entries, unconditional forced replacement changed to feature detection
 - 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

@@ -169,12 +169,12 @@ 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)
+      - [Joint iteration](#joint-iteration)
       - [`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)
       - [`Iterator` chunking](#iterator-chunking)
-      - [Joint iteration](#joint-iteration)
     - [Stage 2 proposals](#stage-2-proposals)
       - [`AsyncIterator` helpers](#asynciterator-helpers)
       - [`Iterator.range`](#iteratorrange)
@@ -2705,6 +2705,57 @@ core-js/proposals/math-sum
 core-js(-pure)/stage/3
 ```
 
+##### [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
+class Iterator {
+  zip<T extends readonly Iterable<unknown>[]>(
+    iterables: T,
+    options?: {
+      mode?: 'shortest' | 'longest' | 'strict';
+      padding?: { [K in keyof T]?: T[K] extends Iterable<infer U> ? U : never };
+    }
+  ): IterableIterator<{ [K in keyof T]: T[K] extends Iterable<infer U> ? U : never }>;
+  zipKeyed<K extends PropertyKey, V extends Record<K, Iterable<unknown>>>(
+    iterables: V,
+    options?: {
+      mode?: 'shortest' | 'longest' | 'strict';
+      padding?: { [P in keyof V]?: V[P] extends Iterable<infer U> ? U : never };
+    }
+  ): IterableIterator<{ [P in keyof V]: V[P] extends Iterable<infer U> ? U : never }>;
+}
+```
+[*CommonJS entry points:*](#commonjs-api)
+```
+core-js/proposals/joint-iteration
+core-js(-pure)/actual|full/iterator/zip
+core-js(-pure)/actual|full/iterator/zip-keyed
+```
+[*Example*](https://tinyurl.com/vutnf2nu):
+```js
+Iterator.zip([
+  [0, 1, 2],
+  [3, 4, 5],
+]).toArray();  // => [[0, 3], [1, 4], [2, 5]]
+
+Iterator.zipKeyed({
+  a: [0, 1, 2],
+  b: [3, 4, 5, 6],
+  c: [7, 8, 9],
+}, {
+  mode: 'longest',
+  padding: { c: 10 },
+}).toArray();
+/*
+[
+  { a: 0,         b: 3, c: 7  },
+  { a: 1,         b: 4, c: 8  },
+  { a: 2,         b: 5, c: 9  },
+  { a: undefined, b: 6, c: 10 },
+];
+ */
+```
+
 ##### [`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
@@ -2833,57 +2884,6 @@ let windowsPartial = Array.from([0, 1].values().windows(3, 'allow-partial'));  /
 let windowsFull = Array.from([0, 1].values().windows(3));  // []
 ```
 
-##### [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
-class Iterator {
-  zip<T extends readonly Iterable<unknown>[]>(
-    iterables: T,
-    options?: {
-      mode?: 'shortest' | 'longest' | 'strict';
-      padding?: { [K in keyof T]?: T[K] extends Iterable<infer U> ? U : never };
-    }
-  ): IterableIterator<{ [K in keyof T]: T[K] extends Iterable<infer U> ? U : never }>;
-  zipKeyed<K extends PropertyKey, V extends Record<K, Iterable<unknown>>>(
-    iterables: V,
-    options?: {
-      mode?: 'shortest' | 'longest' | 'strict';
-      padding?: { [P in keyof V]?: V[P] extends Iterable<infer U> ? U : never };
-    }
-  ): IterableIterator<{ [P in keyof V]: V[P] extends Iterable<infer U> ? U : never }>;
-}
-```
-[*CommonJS entry points:*](#commonjs-api)
-```
-core-js/proposals/joint-iteration
-core-js(-pure)/full/iterator/zip
-core-js(-pure)/full/iterator/zip-keyed
-```
-[*Example*](https://tinyurl.com/vutnf2nu):
-```js
-Iterator.zip([
-  [0, 1, 2],
-  [3, 4, 5],
-]).toArray();  // => [[0, 3], [1, 4], [2, 5]]
-
-Iterator.zipKeyed({
-  a: [0, 1, 2],
-  b: [3, 4, 5, 6],
-  c: [7, 8, 9],
-}, {
-  mode: 'longest',
-  padding: { c: 10 },
-}).toArray();
-/*
-[
-  { a: 0,         b: 3, c: 7  },
-  { a: 1,         b: 4, c: 8  },
-  { a: 2,         b: 5, c: 9  },
-  { a: undefined, b: 6, c: 10 },
-];
- */
-```
-
 #### Stage 2 proposals[⬆](#index)
 [*CommonJS entry points:*](#commonjs-api)
 ```

docs/web/docs/features/proposals/joint-iteration.md

@@ -28,8 +28,8 @@ class Iterator {
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js/proposals/joint-iteration
-core-js(-pure)/full/iterator/zip
-core-js(-pure)/full/iterator/zip-keyed
+core-js(-pure)/actual|full/iterator/zip
+core-js(-pure)/actual|full/iterator/zip-keyed
 ```
 
 ## Example

docs/web/docs/menu.json

@@ -242,6 +242,10 @@
           {
             "title": "Stage 3 proposals",
             "children": [
+              {
+                "title": "Joint iteration",
+                "url": "{docs-version}/docs/features/proposals/joint-iteration"
+              },
               {
                 "title": "Map upsert",
                 "url": "{docs-version}/docs/features/proposals/map-upsert"
@@ -259,10 +263,6 @@
           {
             "title": "Stage 2.7 proposals",
             "children": [
-              {
-                "title": "Joint iteration",
-                "url": "{docs-version}/docs/features/proposals/joint-iteration"
-              },
               {
                 "title": "Iterator chunking",
                 "url": "{docs-version}/docs/features/proposals/iterator-chunking"

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

@@ -1,5 +1,6 @@
 'use strict';
 var parent = require('../../stable/iterator');
+require('../../modules/es.object.create');
 require('../../modules/es.promise');
 require('../../modules/esnext.iterator.constructor');
 require('../../modules/esnext.iterator.concat');
@@ -17,5 +18,7 @@ require('../../modules/esnext.iterator.some');
 require('../../modules/esnext.iterator.take');
 require('../../modules/esnext.iterator.to-array');
 require('../../modules/esnext.iterator.to-async');
+require('../../modules/esnext.iterator.zip');
+require('../../modules/esnext.iterator.zip-keyed');
 
 module.exports = parent;

packages/core-js/actual/iterator/zip-keyed.js

@@ -0,0 +1,24 @@
+'use strict';
+require('../../modules/es.array.iterator');
+require('../../modules/es.object.create');
+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.reflect.own-keys');
+require('../../modules/esnext.iterator.zip-keyed');
+require('../../modules/web.dom-collections.iterator');
+
+var entryUnbind = require('../../internals/entry-unbind');
+
+module.exports = entryUnbind('Iterator', 'zipKeyed');

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

@@ -0,0 +1,22 @@
+'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.zip');
+require('../../modules/web.dom-collections.iterator');
+
+var entryUnbind = require('../../internals/entry-unbind');
+
+module.exports = entryUnbind('Iterator', 'zip');

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

@@ -2,12 +2,10 @@
 var parent = require('../../actual/iterator');
 require('../../modules/esnext.iterator.chunks');
 require('../../modules/esnext.iterator.range');
-require('../../modules/esnext.iterator.sliding');
 require('../../modules/esnext.iterator.windows');
-require('../../modules/esnext.iterator.zip');
-require('../../modules/esnext.iterator.zip-keyed');
 // TODO: Remove from `core-js@4`
 require('../../modules/esnext.iterator.as-indexed-pairs');
 require('../../modules/esnext.iterator.indexed');
+require('../../modules/esnext.iterator.sliding');
 
 module.exports = parent;

packages/core-js/full/iterator/zip-keyed.js

@@ -1,27 +1,7 @@
 'use strict';
-require('../../modules/es.array.iterator');
-require('../../modules/es.object.create');
-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.reflect.own-keys');
+var parent = require('../../actual/iterator/zip-keyed');
 require('../../modules/esnext.iterator.chunks');
 require('../../modules/esnext.iterator.sliding');
 require('../../modules/esnext.iterator.windows');
-require('../../modules/esnext.iterator.zip-keyed');
-require('../../modules/web.dom-collections.iterator');
 
-var entryUnbind = require('../../internals/entry-unbind');
-
-module.exports = entryUnbind('Iterator', 'zipKeyed');
+module.exports = parent;

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

@@ -1,25 +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/zip');
 require('../../modules/esnext.iterator.chunks');
 require('../../modules/esnext.iterator.sliding');
 require('../../modules/esnext.iterator.windows');
-require('../../modules/esnext.iterator.zip');
-require('../../modules/web.dom-collections.iterator');
 
-var entryUnbind = require('../../internals/entry-unbind');
-
-module.exports = entryUnbind('Iterator', 'zip');
+module.exports = parent;