fix: address v2 stack review findings

packages/common/src/async.ts

@@ -0,0 +1,23 @@
+export async function mapWithConcurrency<T, U>(
+  values: readonly T[],
+  concurrency: number,
+  mapper: (value: T, index: number) => Promise<U>,
+): Promise<U[]> {
+  if (!Number.isSafeInteger(concurrency) || concurrency < 1) {
+    throw new Error("Concurrency must be a positive integer");
+  }
+
+  const results: U[] = [];
+  let nextIndex = 0;
+  const workerCount = Math.min(concurrency, values.length);
+  const workers = Array.from({ length: workerCount }, async () => {
+    while (nextIndex < values.length) {
+      const index = nextIndex;
+      nextIndex += 1;
+      results[index] = await mapper(values[index] as T, index);
+    }
+  });
+
+  await Promise.all(workers);
+  return results;
+}

packages/common/src/index.ts

@@ -13,3 +13,4 @@ export * from "./theme";
 export * from "./function";
 export * from "./grid-algorithm";
 export * from "./id";
+export * from "./async";