@effected/walker 0.20.0 → 0.20.1

package/Walker.js

@@ -1,32 +1,11 @@
 import { Effect, FileSystem, Option, Path } from "effect";
 
 // src/Walker.ts
-const ascend = (start, options) => Effect.gen(function* () {
-	const path = yield* Path.Path;
-	const maxDepth = options?.maxDepth ?? 256;
-	if (!Number.isInteger(maxDepth) || maxDepth < 1) return yield* Effect.die(/* @__PURE__ */ new Error(`Walker.ascend: maxDepth must be a positive integer, received ${maxDepth}`));
-	if (options?.stopAt !== void 0 && !path.isAbsolute(options.stopAt)) return yield* Effect.die(/* @__PURE__ */ new Error(`Walker.ascend: stopAt must be an absolute path, received ${JSON.stringify(options.stopAt)} (ascending from ${JSON.stringify(start)})`));
-	const ceiling = options?.stopAt === void 0 ? void 0 : path.resolve(options.stopAt);
-	const dirs = [];
-	let current = start;
-	for (let depth = 0; depth < maxDepth; depth++) {
-		dirs.push(current);
-		if (ceiling !== void 0 && (current === ceiling || path.resolve(current) === ceiling)) break;
-		const parent = path.dirname(current);
-		if (parent === current) break;
-		current = parent;
-	}
-	return dirs;
-});
-const ascendWithin = (start, ceiling, options) => Effect.gen(function* () {
-	if (Option.isNone(ceiling)) return yield* ascend(start, options);
-	return yield* ascendToPhysical(start, ceiling.value, options);
-});
 const ascendToPhysical = (start, ceiling, options) => Effect.gen(function* () {
 	const fs = yield* FileSystem.FileSystem;
 	const path = yield* Path.Path;
 	if (!path.isAbsolute(ceiling)) return yield* Effect.die(/* @__PURE__ */ new Error(`Walker.ascendWithin: ceiling must be an absolute path, received ${JSON.stringify(ceiling)} (ascending from ${JSON.stringify(start)})`));
-	const dirs = yield* ascend(start, {
+	const dirs = yield* Walker.ascend(start, {
 		...options,
 		stopAt: ceiling
 	});
@@ -34,27 +13,16 @@ const ascendToPhysical = (start, ceiling, options) => Effect.gen(function* () {
 	if (last !== void 0 && path.resolve(last) === path.resolve(ceiling)) return dirs;
 	const physical = yield* Effect.option(fs.realPath(ceiling));
 	if (Option.isNone(physical)) return dirs;
-	const hit = yield* findRoot(dirs, (dir) => Effect.map(fs.realPath(dir), (real) => real === physical.value));
+	const hit = yield* Walker.findRoot(dirs, (dir) => Effect.map(fs.realPath(dir), (real) => real === physical.value));
 	return Option.isSome(hit) ? dirs.slice(0, dirs.indexOf(hit.value) + 1) : dirs;
 });
-const firstMatch = (candidates, predicate) => Effect.gen(function* () {
-	for (const candidate of candidates) if (yield* Effect.catch(predicate(candidate), () => Effect.succeed(false))) return Option.some(candidate);
-	return Option.none();
-});
-const findUpward = (dirs, candidatesFor) => Effect.gen(function* () {
-	const fs = yield* FileSystem.FileSystem;
-	const candidates = [];
-	for (const dir of dirs) candidates.push(...candidatesFor(dir));
-	return yield* firstMatch(candidates, (candidate) => fs.exists(candidate));
-});
-const findRoot = (dirs, isRoot) => firstMatch(dirs, isRoot);
 /**
 * Upward path traversal primitives: the directory chain from a start path to the
 * root, and first-match scans over it.
 *
 * @public
 */
-var Walker = class {
+var Walker = class Walker {
 	constructor() {}
 	/**
 	* Ascend from `start` toward the filesystem root, yielding each directory,
@@ -90,7 +58,25 @@ var Walker = class {
 	* // Requires `Path` from the platform layer.
 	* ```
 	*/
-	static ascend = ascend;
+	static ascend(start, options) {
+		return Effect.gen(function* () {
+			const path = yield* Path.Path;
+			const maxDepth = options?.maxDepth ?? 256;
+			if (!Number.isInteger(maxDepth) || maxDepth < 1) return yield* Effect.die(/* @__PURE__ */ new Error(`Walker.ascend: maxDepth must be a positive integer, received ${maxDepth}`));
+			if (options?.stopAt !== void 0 && !path.isAbsolute(options.stopAt)) return yield* Effect.die(/* @__PURE__ */ new Error(`Walker.ascend: stopAt must be an absolute path, received ${JSON.stringify(options.stopAt)} (ascending from ${JSON.stringify(start)})`));
+			const ceiling = options?.stopAt === void 0 ? void 0 : path.resolve(options.stopAt);
+			const dirs = [];
+			let current = start;
+			for (let depth = 0; depth < maxDepth; depth++) {
+				dirs.push(current);
+				if (ceiling !== void 0 && (current === ceiling || path.resolve(current) === ceiling)) break;
+				const parent = path.dirname(current);
+				if (parent === current) break;
+				current = parent;
+			}
+			return dirs;
+		});
+	}
 	/**
 	* {@link Walker.ascend} bounded by a PHYSICAL ceiling: stops at the nearest
 	* directory whose real path is the ceiling's real path, inclusive.
@@ -118,7 +104,12 @@ var Walker = class {
 	* A present ceiling must be absolute; a relative one **dies**, for the
 	* reasons {@link AscendOptions.stopAt} gives.
 	*/
-	static ascendWithin = ascendWithin;
+	static ascendWithin(start, ceiling, options) {
+		return Effect.gen(function* () {
+			if (Option.isNone(ceiling)) return yield* Walker.ascend(start, options);
+			return yield* ascendToPhysical(start, ceiling.value, options);
+		});
+	}
 	/**
 	* The first candidate whose `predicate` reports true, or `Option.none()`.
 	*
@@ -133,7 +124,12 @@ var Walker = class {
 	* programmer error and surfaces as a defect. Do not change this to
 	* `Effect.catchCause` — the distinction is load-bearing.
 	*/
-	static firstMatch = firstMatch;
+	static firstMatch(candidates, predicate) {
+		return Effect.gen(function* () {
+			for (const candidate of candidates) if (yield* Effect.catch(predicate(candidate), () => Effect.succeed(false))) return Option.some(candidate);
+			return Option.none();
+		});
+	}
 	/**
 	* The first existing path among the candidates `candidatesFor` produces for each
 	* directory in `dirs`, scanned in order. Nearer directories win.
@@ -142,7 +138,14 @@ var Walker = class {
 	* Candidates materialize up front, bounded by `dirs.length × candidatesFor`'s
 	* output — a few hundred strings under the default `maxDepth`.
 	*/
-	static findUpward = findUpward;
+	static findUpward(dirs, candidatesFor) {
+		return Effect.gen(function* () {
+			const fs = yield* FileSystem.FileSystem;
+			const candidates = [];
+			for (const dir of dirs) candidates.push(...candidatesFor(dir));
+			return yield* Walker.firstMatch(candidates, (candidate) => fs.exists(candidate));
+		});
+	}
 	/**
 	* The first directory in `dirs` that `isRoot` accepts.
 	*
@@ -151,7 +154,9 @@ var Walker = class {
 	* identity. `isRoot` is a caller-supplied marker test (a `.git` entry, a
 	* `pnpm-workspace.yaml`), and its failures are absorbed per directory.
 	*/
-	static findRoot = findRoot;
+	static findRoot(dirs, isRoot) {
+		return Walker.firstMatch(dirs, isRoot);
+	}
 };
 
 export { Walker };

package/index.d.ts

@@ -530,7 +530,7 @@ export declare class Walker {
    * // Requires `Path` from the platform layer.
    * ```
    */
-  static readonly ascend: (start: string, options?: AscendOptions) => Effect.Effect<ReadonlyArray<string>, never, Path.Path>;
+  static ascend(start: string, options?: AscendOptions): Effect.Effect<ReadonlyArray<string>, never, Path.Path>;
   /**
    * {@link Walker.ascend} bounded by a PHYSICAL ceiling: stops at the nearest
    * directory whose real path is the ceiling's real path, inclusive.
@@ -558,7 +558,7 @@ export declare class Walker {
    * A present ceiling must be absolute; a relative one **dies**, for the
    * reasons {@link AscendOptions.stopAt} gives.
    */
-  static readonly ascendWithin: (start: string, ceiling: Option.Option<string>, options?: Pick<AscendOptions, "maxDepth">) => Effect.Effect<ReadonlyArray<string>, never, FileSystem.FileSystem | Path.Path>;
+  static ascendWithin(start: string, ceiling: Option.Option<string>, options?: Pick<AscendOptions, "maxDepth">): Effect.Effect<ReadonlyArray<string>, never, FileSystem.FileSystem | Path.Path>;
   /**
    * The first candidate whose `predicate` reports true, or `Option.none()`.
    *
@@ -573,7 +573,7 @@ export declare class Walker {
    * programmer error and surfaces as a defect. Do not change this to
    * `Effect.catchCause` — the distinction is load-bearing.
    */
-  static readonly firstMatch: <E, R>(candidates: ReadonlyArray<string>, predicate: (candidate: string) => Effect.Effect<boolean, E, R>) => Effect.Effect<Option.Option<string>, never, R>;
+  static firstMatch<E, R>(candidates: ReadonlyArray<string>, predicate: (candidate: string) => Effect.Effect<boolean, E, R>): Effect.Effect<Option.Option<string>, never, R>;
   /**
    * The first existing path among the candidates `candidatesFor` produces for each
    * directory in `dirs`, scanned in order. Nearer directories win.
@@ -582,7 +582,7 @@ export declare class Walker {
    * Candidates materialize up front, bounded by `dirs.length × candidatesFor`'s
    * output — a few hundred strings under the default `maxDepth`.
    */
-  static readonly findUpward: (dirs: ReadonlyArray<string>, candidatesFor: (dir: string) => ReadonlyArray<string>) => Effect.Effect<Option.Option<string>, never, FileSystem.FileSystem>;
+  static findUpward(dirs: ReadonlyArray<string>, candidatesFor: (dir: string) => ReadonlyArray<string>): Effect.Effect<Option.Option<string>, never, FileSystem.FileSystem>;
   /**
    * The first directory in `dirs` that `isRoot` accepts.
    *
@@ -591,7 +591,7 @@ export declare class Walker {
    * identity. `isRoot` is a caller-supplied marker test (a `.git` entry, a
    * `pnpm-workspace.yaml`), and its failures are absorbed per directory.
    */
-  static readonly findRoot: <E, R>(dirs: ReadonlyArray<string>, isRoot: (dir: string) => Effect.Effect<boolean, E, R>) => Effect.Effect<Option.Option<string>, never, R>;
+  static findRoot<E, R>(dirs: ReadonlyArray<string>, isRoot: (dir: string) => Effect.Effect<boolean, E, R>): Effect.Effect<Option.Option<string>, never, R>;
 }
 export type { AscendOptions, CompileAndExpandOptions, DescendOptions, DescendRecordOptions, DescendResult, UnreadableDirectory };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@effected/walker",
-	"version": "0.20.0",
+	"version": "0.20.1",
 	"private": false,
 	"description": "Path traversal as Effect primitives: ascend a directory chain to the first matching candidate, or descend a tree expanding a glob against the filesystem.",
 	"keywords": [

package/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.59.1"
+      "packageVersion": "7.59.4"
     }
   ]
 }