feat(collections): stabilize interleave

collections/deno.json

@@ -18,6 +18,7 @@
     "./find-single": "./find_single.ts",
     "./first-not-nullish-of": "./first_not_nullish_of.ts",
     "./includes-value": "./includes_value.ts",
+    "./interleave": "./interleave.ts",
     "./intersect": "./intersect.ts",
     "./invert-by": "./invert_by.ts",
     "./invert": "./invert.ts",
@@ -53,7 +54,6 @@
     "./unstable-drop-while": "./unstable_drop_while.ts",
     "./unstable-find-single": "./unstable_find_single.ts",
     "./unstable-first-not-nullish-of": "./unstable_first_not_nullish_of.ts",
-    "./unstable-interleave": "./unstable_interleave.ts",
     "./unstable-join-to-string": "./unstable_join_to_string.ts",
     "./unstable-map-not-nullish": "./unstable_map_not_nullish.ts",
     "./unstable-max-by": "./unstable_max_by.ts",

collections/unstable_interleave.ts → collections/interleave.ts

@@ -7,8 +7,6 @@
  * tuples, `interleave` continues until all input iterables are exhausted and
  * returns a flat array. All input iterables are consumed eagerly.
  *
- * @experimental **UNSTABLE**: New API, yet to be vetted.
- *
  * @typeParam T The tuple of element types in the input iterables.
  *
  * @param iterables The iterables to interleave.
@@ -17,7 +15,7 @@
  *
  * @example Basic usage
  * ```ts
- * import { interleave } from "@std/collections/unstable-interleave";
+ * import { interleave } from "@std/collections/interleave";
  * import { assertEquals } from "@std/assert";
  *
  * const numbers = [1, 2, 3];
@@ -28,7 +26,7 @@
  *
  * @example Unequal-length arrays
  * ```ts
- * import { interleave } from "@std/collections/unstable-interleave";
+ * import { interleave } from "@std/collections/interleave";
  * import { assertEquals } from "@std/assert";
  *
  * assertEquals(
@@ -39,7 +37,7 @@
  *
  * @example With iterables
  * ```ts
- * import { interleave } from "@std/collections/unstable-interleave";
+ * import { interleave } from "@std/collections/interleave";
  * import { assertEquals } from "@std/assert";
  *
  * assertEquals(

collections/unstable_interleave_test.ts → collections/interleave_test.ts

@@ -1,7 +1,7 @@
 // Copyright 2018-2026 the Deno authors. MIT license.
 
 import { assertEquals } from "@std/assert";
-import { interleave } from "./unstable_interleave.ts";
+import { interleave } from "./interleave.ts";
 
 Deno.test({
   name: "interleave() handles no arguments",

collections/mod.ts

@@ -43,6 +43,7 @@ export * from "./filter_values.ts";
 export * from "./find_single.ts";
 export * from "./first_not_nullish_of.ts";
 export * from "./includes_value.ts";
+export * from "./interleave.ts";
 export * from "./intersect.ts";
 export * from "./invert_by.ts";
 export * from "./invert.ts";