build: implement Array.fromAsync for async iterable support

packages/util/src/@prototypes/array.ts

@@ -0,0 +1,30 @@
+async function fromAsync<T>(
+  iterableOrArrayLike: AsyncIterable<T> | Iterable<T | PromiseLike<T>> | ArrayLike<T | PromiseLike<T>>,
+) {
+  const array: T[] = [];
+  for await (const element of await iterableOrArrayLike as AsyncGenerator<PromiseLike<T>>) {
+    array.push(await element);
+  }
+  return array;
+}
+
+async function mappedFromAsync<T, U>(
+  iterableOrArrayLike: AsyncIterable<T> | Iterable<T | PromiseLike<T>> | ArrayLike<T | PromiseLike<T>>,
+  mapFn: (value: Awaited<T>, index: number) => U,
+) {
+  const array: U[] = [];
+  for await (const element of await iterableOrArrayLike as AsyncGenerator<PromiseLike<T>>) {
+    array.push(mapFn(await element, array.length));
+  }
+  return array;
+}
+
+/**
+ * Designed for Node.js 20 compatibility
+ */
+Array.fromAsync ??= <T, U>(
+  iterableOrArrayLike: AsyncIterable<T> | Iterable<T | PromiseLike<T>> | ArrayLike<T | PromiseLike<T>>,
+  mapFn?: (value: Awaited<T>, index: number) => U,
+) => typeof mapFn === "function"
+    ? mappedFromAsync(iterableOrArrayLike, mapFn)
+    : fromAsync(iterableOrArrayLike);

packages/util/src/@prototypes/index.ts

@@ -0,0 +1 @@
+import "./array";

packages/util/src/glob/fsGlob.ts

@@ -1,7 +1,6 @@
 import { type Dirent } from "fs";
 import { stat } from "fs/promises";
 import { join } from "path";
-import { asyncGeneratorToArray } from "../utils/array";
 import { DISCLOUD_IGNORE_FILENAME } from "./constants";
 import { Ignore } from "./ignore";
 import type { FSGlobOptions, FSGlobOptionsWithFileTypes, FSGlobOptionsWithoutFileTypes } from "./types";
@@ -10,7 +9,7 @@ export function fsGlob(pattern: string | string[], options?: FSGlobOptionsWithou
 export function fsGlob(pattern: string | string[], options?: FSGlobOptionsWithFileTypes): Promise<Dirent[]>
 export function fsGlob(pattern: string | string[], options?: FSGlobOptions): Promise<Array<string | Dirent>>
 export function fsGlob(pattern: string | string[], options?: any): Promise<unknown> {
-  return asyncGeneratorToArray(fsGlobIterate(pattern, options));
+  return Array.fromAsync(fsGlobIterate(pattern, options));
 }
 
 export function fsGlobIterate(pattern: string | string[], options?: FSGlobOptionsWithoutFileTypes): AsyncGenerator<string>

packages/util/src/glob/glob.ts

@@ -1,11 +1,10 @@
 import * as globMudule from "glob";
 import { type } from "os";
-import { asyncGeneratorToArray } from "../utils/array";
 import { DISCLOUD_IGNORE_FILENAME } from "./constants";
 import { Ignore } from "./ignore";
 
 export function glob(pattern: string | string[], cwd?: string) {
-  return asyncGeneratorToArray(globIterate(pattern, cwd));
+  return Array.fromAsync(globIterate(pattern, cwd));
 }
 
 export async function* globIterate(pattern: string | string[], cwd?: string) {

packages/util/src/glob/ignore.ts

@@ -4,7 +4,6 @@ import { globIterate } from "glob";
 import { globifyGitIgnore } from "globify-gitignore";
 import { dirname } from "path";
 import { joinWithRoot } from "../path";
-import { asyncGeneratorToArray } from "../utils/array";
 
 export class Ignore {
   static async globify(content: string, directory?: string, absolute?: boolean) {
@@ -58,7 +57,7 @@ export class Ignore {
   ) { }
 
   getIgnorePatterns(cwd?: string) {
-    return asyncGeneratorToArray(this._getIgnoreIterate(cwd)).then((value) => value.flat());
+    return Array.fromAsync(this._getIgnoreIterate(cwd)).then((value) => value.flat());
   }
 
   protected async* _getIgnoreIterate(cwd?: string) {

packages/util/src/index.ts

@@ -1,4 +1,5 @@
 import "source-map-support/register";
+import "./@prototypes";
 
 export * from "./BitField";
 export * from "./config";