@duplojs/utils 1.5.13 → 1.5.15

package/dist/clean/flag.d.ts

@@ -31,7 +31,7 @@ export interface FlagHandler<GenericEntity extends Entity = Entity, GenericName
      * 
      */
     getValue<GenericInputEntity extends GenericEntity & Flag<GenericName, GenericValue>>(entity: GenericInputEntity): GetKindValue<typeof flagKind, GenericInputEntity>[GenericName];
-    has<GenericInputEntity extends GenericEntity>(entity: GenericInputEntity): Extract<GenericInputEntity, Flag<GenericName, any>>;
+    has<GenericInputEntity extends GenericEntity>(entity: GenericInputEntity): entity is Extract<GenericInputEntity, Flag<GenericName, any>>;
 }
 export interface Flag<GenericName extends string = string, GenericValue extends unknown = never> extends Kind<typeof flagKind.definition, Record<GenericName, GenericValue>> {
 }

package/dist/common/path.d.ts

@@ -32,7 +32,7 @@ export declare namespace Path {
      */
     function getBaseName<GenericPath extends string>(path: GenericPath, params?: GetBaseNameParams): string | null;
     interface GetExtensionNameParams {
-        withDot: boolean;
+        withDot?: boolean;
     }
     /**
      * Returns the last extension of a path, with or without the leading dot.

package/dist/generator/asyncFlat.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+async function* asyncFlat(iterator, depth = 1) {
+    for await (const value of iterator) {
+        if (depth >= 1
+            && value
+            && typeof value === "object"
+            && (Symbol.iterator in value
+                || Symbol.asyncIterator in value)) {
+            yield* asyncFlat(value, depth - 1);
+        }
+        else {
+            yield value;
+        }
+    }
+}
+
+exports.asyncFlat = asyncFlat;

package/dist/generator/asyncFlat.d.ts

@@ -0,0 +1,18 @@
+import { type FlatAsyncIterator } from "./types";
+/**
+ * Flattens nested sync or async iterables into an async generator.
+ * 
+ * **Supported call styles:**
+ * - Classic: `asyncFlat(iterator, depth?)` → returns an async generator
+ * 
+ * By default, `asyncFlat` flattens one level.
+ * Use `depth` to control how many iterable levels are expanded.
+ * Sync iterables nested inside an async iterable are also flattened.
+ * 
+ * @see [`G.flat`](https://utils.duplojs.dev/en/v1/api/generator/flat) For sync iterables
+ * @see https://utils.duplojs.dev/en/v1/api/generator/asyncFlat
+ * 
+ * @namespace G
+ * 
+ */
+export declare function asyncFlat<GenericValue extends unknown, GenericDepth extends number = 1>(iterator: AsyncIterable<GenericValue> | Iterable<GenericValue>, depth?: GenericDepth): AsyncGenerator<FlatAsyncIterator<GenericValue, GenericDepth>, void, unknown>;

package/dist/generator/asyncFlat.mjs

@@ -0,0 +1,16 @@
+async function* asyncFlat(iterator, depth = 1) {
+    for await (const value of iterator) {
+        if (depth >= 1
+            && value
+            && typeof value === "object"
+            && (Symbol.iterator in value
+                || Symbol.asyncIterator in value)) {
+            yield* asyncFlat(value, depth - 1);
+        }
+        else {
+            yield value;
+        }
+    }
+}
+
+export { asyncFlat };

package/dist/generator/flat.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+function* flat(iterator, depth = 1) {
+    for (const value of iterator) {
+        if (depth >= 1
+            && value
+            && typeof value === "object"
+            && Symbol.iterator in value) {
+            yield* flat(value, depth - 1);
+        }
+        else {
+            yield value;
+        }
+    }
+}
+
+exports.flat = flat;

package/dist/generator/flat.d.ts

@@ -0,0 +1,36 @@
+import { type FlatIterator } from "./types";
+/**
+ * Flattens nested iterables into a single generator.
+ * 
+ * **Supported call styles:**
+ * - Classic: `flat(iterator, depth?)` → returns a generator
+ * 
+ * By default, `flat` flattens one level.
+ * Use `depth` to control how many iterable levels are expanded.
+ * Non-iterable values are yielded as-is.
+ * 
+ * ```ts
+ * const oneLevel = G.flat([[1, 2], [3, 4]]);
+ * // Generator<number, void, unknown>
+ * 
+ * const twoLevels = G.flat(
+ * 	[[[1], [2]], [[3], [4]]],
+ * 	2,
+ * );
+ * // Generator<number, void, unknown>
+ * 
+ * const keepLastLevel = G.flat(
+ * 	[[[1], [2]], [[3], [4]]],
+ * 	1,
+ * );
+ * // Generator<number[], void, unknown>
+ * 
+ * ```
+ * 
+ * @see [`G.asyncFlat`](https://utils.duplojs.dev/en/v1/api/generator/asyncFlat) For async iterables
+ * @see https://utils.duplojs.dev/en/v1/api/generator/flat
+ * 
+ * @namespace G
+ * 
+ */
+export declare function flat<GenericValue extends unknown, GenericDepth extends number = 1>(iterator: Iterable<GenericValue>, depth?: GenericDepth): Generator<FlatIterator<GenericValue, GenericDepth>, void, unknown>;

package/dist/generator/flat.mjs

@@ -0,0 +1,15 @@
+function* flat(iterator, depth = 1) {
+    for (const value of iterator) {
+        if (depth >= 1
+            && value
+            && typeof value === "object"
+            && Symbol.iterator in value) {
+            yield* flat(value, depth - 1);
+        }
+        else {
+            yield value;
+        }
+    }
+}
+
+export { flat };

package/dist/generator/index.cjs

@@ -14,6 +14,8 @@ var asyncChunk = require('./asyncChunk.cjs');
 var group = require('./group.cjs');
 var asyncGroup = require('./asyncGroup.cjs');
 var createExternalAsyncGenerator = require('./createExternalAsyncGenerator.cjs');
+var flat = require('./flat.cjs');
+var asyncFlat = require('./asyncFlat.cjs');
 
 /**
  * {@include generator/index.md}
@@ -35,3 +37,5 @@ exports.group = group.group;
 exports.groupOutput = group.groupOutput;
 exports.asyncGroup = asyncGroup.asyncGroup;
 exports.createExternalAsyncGenerator = createExternalAsyncGenerator.createExternalAsyncGenerator;
+exports.flat = flat.flat;
+exports.asyncFlat = asyncFlat.asyncFlat;

package/dist/generator/index.d.ts

@@ -25,6 +25,7 @@
  * @namespace G
  * 
  */
+export * from "./types";
 export * from "./map";
 export * from "./execute";
 export * from "./asyncMap";
@@ -39,3 +40,5 @@ export * from "./asyncChunk";
 export * from "./group";
 export * from "./asyncGroup";
 export * from "./createExternalAsyncGenerator";
+export * from "./flat";
+export * from "./asyncFlat";

package/dist/generator/index.mjs

@@ -12,6 +12,8 @@ export { asyncChunk } from './asyncChunk.mjs';
 export { group, groupOutput } from './group.mjs';
 export { asyncGroup } from './asyncGroup.mjs';
 export { createExternalAsyncGenerator } from './createExternalAsyncGenerator.mjs';
+export { flat } from './flat.mjs';
+export { asyncFlat } from './asyncFlat.mjs';
 
 /**
  * {@include generator/index.md}

package/dist/generator/types/flat.d.ts

@@ -0,0 +1,3 @@
+import { type IsEqual } from "../../common";
+export type FlatIterator<GenericValue extends unknown, GenericDepth extends number, Acc extends never[] = []> = IsEqual<Acc["length"], GenericDepth> extends true ? GenericValue : IsEqual<Acc["length"], 250> extends true ? GenericValue : GenericValue extends Iterable<infer InferredValue> ? FlatIterator<InferredValue, GenericDepth, [...Acc, never]> : GenericValue;
+export type FlatAsyncIterator<GenericValue extends unknown, GenericDepth extends number, Acc extends never[] = []> = IsEqual<Acc["length"], GenericDepth> extends true ? GenericValue : IsEqual<Acc["length"], 250> extends true ? GenericValue : GenericValue extends Iterable<infer InferredValue> ? FlatIterator<InferredValue, GenericDepth, [...Acc, never]> : GenericValue extends AsyncIterable<infer InferredValue> ? FlatIterator<InferredValue, GenericDepth, [...Acc, never]> : GenericValue;

package/dist/generator/types/index.d.ts

@@ -0,0 +1 @@
+export * from "./flat";

package/dist/metadata.json

@@ -3905,6 +3905,17 @@
     {
       "name": "generator",
       "files": [
+        {
+          "name": "types",
+          "files": [
+            {
+              "name": "flat.d.ts"
+            },
+            {
+              "name": "index.d.ts"
+            }
+          ]
+        },
         {
           "name": "asyncChunk.cjs"
         },
@@ -3923,6 +3934,15 @@
         {
           "name": "asyncFilter.mjs"
         },
+        {
+          "name": "asyncFlat.cjs"
+        },
+        {
+          "name": "asyncFlat.d.ts"
+        },
+        {
+          "name": "asyncFlat.mjs"
+        },
         {
           "name": "asyncGroup.cjs"
         },
@@ -3995,6 +4015,15 @@
         {
           "name": "filter.mjs"
         },
+        {
+          "name": "flat.cjs"
+        },
+        {
+          "name": "flat.d.ts"
+        },
+        {
+          "name": "flat.mjs"
+        },
         {
           "name": "group.cjs"
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duplojs/utils",
-  "version": "1.5.13",
+  "version": "1.5.15",
   "author": {
     "name": "mathcovax",
     "url": "https://github.com/mathcovax"