instrumentality 0.0.12 → 0.0.14

package/dist/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"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"}

package/dist/base.js

@@ -100,8 +100,6 @@ export const BASE122_ILLEGAL_INDEX = {
 };
 /** Shortened payload marker used when escaping an illegal 7-bit value and no subsequent 7-bit chunk is available (the current chunk is reused as payload). */
 export const BASE122_SHORT = 0b111;
-/** Lazy-initialized TextDecoder instance used for decoding base-122 encoded data. */
-let DECODER;
 /**
  * Encodes indexed data into a base-122 representation.
  *
@@ -142,7 +140,7 @@ export function encode122(data_) {
                 out[outIndex++] = 0b10000000 | (payload & 0b00111111);
         }
     }
-    return (DECODER ??= new TextDecoder("utf-8", { fatal: true })).decode(out.subarray(0, outIndex));
+    return new TextDecoder("utf-8", { fatal: true }).decode(out.subarray(0, outIndex));
 }
 /**
  * Decodes a base-122 encoded string back into its original byte representation.

package/dist/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAI/C;AAID;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAKrF;AAGD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAE1F;AAGD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,IAAI,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAEhG;AAID;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IAC9C,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;CACrC,EAAE,KAAK,SAAM,GAAG,IAAI,CASpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMjD"}
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAIzC;AAID;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAKrF;AAGD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAE1F;AAGD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAAE,IAAI,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAEhG;AAID;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE;IAC9C,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;CACrC,EAAE,KAAK,SAAM,GAAG,IAAI,CASpB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMjD"}

package/dist/dom.js

@@ -1,9 +1,9 @@
 /**
  * Resolves on `DOMContentLoaded` or immediately if the document is already ready.
  */
-export async function onceReady() {
+export function onceReady() {
     if (document.readyState === "complete" || document.readyState === "interactive")
-        return;
+        return Promise.resolve();
     return new Promise(r => document.addEventListener("DOMContentLoaded", () => r(), { once: true }));
 }
 /**

package/dist/road.d.ts

@@ -25,18 +25,6 @@ export { resolveStat as resStat };
  */
 export declare function resolveDirent(dirent: fs.Dirent): typeof File | typeof Folder | typeof BlockDevice | typeof CharacterDevice | typeof SymbolicLink | typeof Fifo | typeof Socket;
 export { resolveDirent as resDirent };
-/**
- * Creates the appropriate subclass of {@link Road} based on the file mode of the specified path.
- *
- * @param path_ The path to follow.
- * @returns A new instance of {@link Road}.
- * @throws If {@link fp.lstat}/{@link fs.lstatSync} fails to retrieved the status of {@link path_}.
- */
-export declare function factory(path_: string): Promise<BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink>;
-export { factory as fac, factory as mk };
-/** Sync version of {@link factory}. */
-export declare function factorySync(path_: string): BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink;
-export { factorySync as facSync, factorySync as mkSync };
 /**
  * A map that keeps track of locked roads to prevent concurrent modifications.
  *
@@ -129,8 +117,8 @@ export declare abstract class Road {
     moveSync(into_: Folder): void;
     rename(newName_: string): Promise<void>;
     renameSync(newName_: string): void;
-    abstract check(): Promise<boolean>;
-    abstract checkSync(): boolean;
+    abstract check(throwOnError_: boolean): Promise<boolean>;
+    abstract checkSync(throwOnError_: boolean): boolean;
     /** Type narrowing for {@link File} (similar to `instanceof` without unnecessary runtime checks). */
     isFile(): this is File;
     /** Type narrowing for {@link Folder} (similar to `instanceof` without unnecessary runtime checks). */
@@ -156,6 +144,18 @@ export declare abstract class Road {
 }
 /** Constructor type for a subclass of {@link Road}. */
 export type road_t<T extends Road> = new (...args_: ConstructorParameters<typeof Road>) => T;
+/**
+ * Creates the appropriate subclass of {@link Road} based on the file mode of the specified path.
+ *
+ * @param path_ The path to follow.
+ * @returns A new instance of {@link Road}.
+ * @throws If {@link fp.lstat}/{@link fs.lstatSync} fails to retrieved the status of {@link path_}.
+ */
+export declare function road(path_: string): Promise<BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink>;
+export { road as fac, road as mk, road as factory };
+/** Sync version of {@link road}. */
+export declare function roadSync(path_: string): BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink;
+export { roadSync as facSync, roadSync as mkSync, roadSync as factorySync };
 /** Subclass of {@link Road} that represents a file. */
 export declare class File extends Road {
     /**
@@ -208,13 +208,13 @@ export declare class File extends Road {
     truncWritePastSync(offset_: number, data_: Buffer | string): void;
     append(data_: Buffer | string, options_?: fs.WriteFileOptions): Promise<void>;
     appendSync(data_: Buffer | string, options_?: fs.WriteFileOptions): void;
-    check(): Promise<boolean>;
-    checkSync(): boolean;
+    check(throwOnError_: boolean): Promise<boolean>;
+    checkSync(throwOnError_: boolean): boolean;
     isFile(): this is File;
 }
 export declare function file(...args: ConstructorParameters<typeof File>): File;
 /** Helper type for filtering {@link Road} instances. */
-export type filter_t<T extends Road> = ((road: Road) => road is T);
+export type filter_t<T extends Road> = ((found: Road) => found is T);
 export declare class Folder extends Road {
     static create(at_: string): Promise<Folder>;
     static readonly mk: typeof Folder.create;
@@ -236,9 +236,9 @@ export declare class Folder extends Road {
     walkSync<T extends Road>(filter_: filter_t<T>): Iterable<T>;
     walkSync(filter_: (r: Road) => boolean): Iterable<Road>;
     find(name_: string): Promise<Road | null>;
-    find<T extends Road>(name_: string, expect_: road_t<T>): Promise<T | null>;
+    find<T extends Road>(name_: string, filter_: filter_t<T>): Promise<T | null>;
     findSync(name_: string): Road | null;
-    findSync<T extends Road>(name_: string, expect_: road_t<T>): T | null;
+    findSync<T extends Road>(name_: string, filter_: filter_t<T>): T | null;
     add<T extends Road>(name_: string, createable_: {
         mk: (at: string) => Promise<T>;
     }): Promise<T>;
@@ -253,19 +253,20 @@ export declare class Folder extends Road {
     }, cb_: (r: T) => void): void;
     size(): Promise<number>;
     sizeSync(): number;
-    check(): Promise<boolean>;
-    checkSync(): boolean;
+    check(throwOnError_: boolean): Promise<boolean>;
+    checkSync(throwOnError_: boolean): boolean;
     isFolder(): this is Folder;
     isDir(): this is Folder;
     isDirectory(): this is Folder;
 }
 export declare function folder(...args: ConstructorParameters<typeof Folder>): Folder;
 export declare function dir(...args: ConstructorParameters<typeof Folder>): Folder;
+export declare function directory(...args: ConstructorParameters<typeof Folder>): Folder;
 export declare function sysRoot(): Folder;
 export declare function home(): Folder;
 export declare function tmp(): Folder;
 export declare function here(): Folder;
-export { Folder as Dir, Folder as Directory, Folder as Dict, Folder as Dictionary };
+export { Folder as Dir, Folder as Directory };
 export declare class SymbolicLink extends Road {
     static create(at_: string, target_: string | Road): Promise<SymbolicLink>;
     static readonly mk: typeof SymbolicLink.create;
@@ -279,61 +280,67 @@ export declare class SymbolicLink extends Road {
     sizeSync(): number;
     delete(): Promise<void>;
     deleteSync(): void;
-    check(): Promise<boolean>;
-    checkSync(): boolean;
+    check(throwOnError_: boolean): Promise<boolean>;
+    checkSync(throwOnError_: boolean): boolean;
     isSymlink(): this is SymbolicLink;
     isSymbolicLink(): this is SymbolicLink;
 }
 export { SymbolicLink as Symlink };
 export declare function symlink(...args: ConstructorParameters<typeof SymbolicLink>): SymbolicLink;
+/**
+ * Represents a system-level resource that is not subject to modification.
+ * All modification operations will throw an error.
+ *
+ * One could say 'this road truly is *unusable*.' hehe
+ */
 export declare abstract class UnusableRoad extends Road {
-    readonly mutable: false;
+    readonly mutable: never;
     size(): Promise<0>;
     sizeSync(): 0;
     error(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be locked */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be locked */
     lock(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be locked */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be locked */
     lockSync(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be deleted */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be deleted */
     delete(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be deleted */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be deleted */
     deleteSync(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be moved */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be moved */
     move(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be moved */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be moved */
     moveSync(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be copied */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be copied */
     copy(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be copied */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be copied */
     copySync(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be renamed */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be renamed */
     rename(): never;
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be renamed */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be renamed */
     renameSync(): never;
     isUnusable(): this is UnusableRoad;
 }
 export declare class BlockDevice extends UnusableRoad {
-    check(): Promise<boolean>;
-    checkSync(): boolean;
+    check(throwOnError_: boolean): Promise<boolean>;
+    checkSync(throwOnError_: boolean): boolean;
     isBlockDevice(): this is BlockDevice;
 }
 export declare function blockDevice(...args: ConstructorParameters<typeof BlockDevice>): BlockDevice;
 export declare class CharacterDevice extends UnusableRoad {
-    check(): Promise<boolean>;
-    checkSync(): boolean;
+    check(throwOnError_: boolean): Promise<boolean>;
+    checkSync(throwOnError_: boolean): boolean;
     isCharacterDevice(): this is CharacterDevice;
 }
 export declare function characterDevice(...args: ConstructorParameters<typeof CharacterDevice>): CharacterDevice;
 export declare class Fifo extends UnusableRoad {
-    check(): Promise<boolean>;
-    checkSync(): boolean;
+    check(throwOnError_: boolean): Promise<boolean>;
+    checkSync(throwOnError_: boolean): boolean;
     isFifo(): this is Fifo;
 }
 export declare function fifo(...args: ConstructorParameters<typeof Fifo>): Fifo;
 export declare class Socket extends UnusableRoad {
-    check(): Promise<boolean>;
-    checkSync(): boolean;
+    check(throwOnError_: boolean): Promise<boolean>;
+    checkSync(throwOnError_: boolean): boolean;
     isSocket(): this is Socket;
 }
 export declare function socket(...args: ConstructorParameters<typeof Socket>): Socket;

package/dist/road.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"road.d.ts","sourceRoot":"","sources":["../src/road.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"road.d.ts","sourceRoot":"","sources":["../src/road.ts"],"names":[],"mappings":"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"}

package/dist/road.js

@@ -57,22 +57,6 @@ export function resolveDirent(dirent) {
     throw new Err(`Unknown dirent type for ${dirent.name}`);
 }
 export { resolveDirent as resDirent };
-/**
- * Creates the appropriate subclass of {@link Road} based on the file mode of the specified path.
- *
- * @param path_ The path to follow.
- * @returns A new instance of {@link Road}.
- * @throws If {@link fp.lstat}/{@link fs.lstatSync} fails to retrieved the status of {@link path_}.
- */
-export async function factory(path_) {
-    return new (resolveStat((await fp.lstat(path_)).mode))(path_, false);
-}
-export { factory as fac, factory as mk };
-/** Sync version of {@link factory}. */
-export function factorySync(path_) {
-    return new (resolveStat(fs.lstatSync(path_).mode))(path_, false);
-}
-export { factorySync as facSync, factorySync as mkSync };
 /**
  * A map that keeps track of locked roads to prevent concurrent modifications.
  *
@@ -116,7 +100,7 @@ export class Road {
      */
     constructor(path_, typeCheck_) {
         this.pointsTo = ph.resolve(path_);
-        if (typeCheck_ && !this.checkSync())
+        if (typeCheck_ && !this.checkSync(true))
             throw new Err(`Type mismatch: '${this.isAt}'`);
     }
     /** @returns An instance of {@link Folder} representing the parent directory of the current road. */
@@ -161,7 +145,9 @@ export class Road {
         try {
             await l.previous;
         }
-        catch { }
+        catch {
+            null;
+        }
         return l;
     }
     lockSync() {
@@ -180,7 +166,7 @@ export class Road {
     async untilAccessible(abs, expectMode = fsc.F_OK, cb_) {
         const watcher = fs.watch(this.isAt);
         try {
-            for await (let _ of on(watcher, 'change', { signal: abs })) {
+            for await (const _ of on(watcher, 'change', { signal: abs })) {
                 try {
                     await fp.access(this.isAt, expectMode);
                     return;
@@ -207,7 +193,7 @@ export class Road {
     async onChange(abs_, cb_) {
         const watcher = fs.watch(this.isAt);
         try {
-            for await (let _ of on(watcher, 'change', { signal: abs_ }))
+            for await (const _ of on(watcher, 'change', { signal: abs_ }))
                 return await cb_?.() ?? null;
             return null;
         }
@@ -289,6 +275,18 @@ export class Road {
     /** Type narrowing for {@link Socket} (similar to `instanceof` without unnecessary runtime checks). */
     isSocket() { return false; }
 }
+/**
+ * Creates the appropriate subclass of {@link Road} based on the file mode of the specified path.
+ *
+ * @param path_ The path to follow.
+ * @returns A new instance of {@link Road}.
+ * @throws If {@link fp.lstat}/{@link fs.lstatSync} fails to retrieved the status of {@link path_}.
+ */
+export async function road(path_) { return new (resolveStat((await fp.lstat(path_)).mode))(path_, false); }
+export { road as fac, road as mk, road as factory };
+/** Sync version of {@link road}. */
+export function roadSync(path_) { return new (resolveStat((fs.lstatSync(path_).mode)))(path_, false); }
+export { roadSync as facSync, roadSync as mkSync, roadSync as factorySync };
 /** Subclass of {@link Road} that represents a file. */
 export class File extends Road {
     /**
@@ -326,7 +324,7 @@ export class File extends Road {
     /** The file name without its extension. */
     get noExt() { return ph.basename(this.isAt, this.ext); }
     async read(options_) {
-        return fp.readFile(this.isAt, options_);
+        return await fp.readFile(this.isAt, options_);
     }
     readSync(options_) {
         return fs.readFileSync(this.isAt, options_);
@@ -408,11 +406,15 @@ export class File extends Road {
             try {
                 iter1.return?.(undefined);
             }
-            catch { }
+            catch {
+                null;
+            }
             try {
                 iter2.return?.(undefined);
             }
-            catch { }
+            catch {
+                null;
+            }
         }
     }
     async hash(algorithm_ = "sha256", options_, encoding_) {
@@ -507,16 +509,20 @@ export class File extends Road {
         using _ = this.lockSync();
         fs.appendFileSync(this.isAt, data_, options_);
     }
-    async check() { try {
+    async check(throwOnError_) { try {
         return (await fp.lstat(this.isAt)).isFile();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
-    checkSync() { try {
+    checkSync(throwOnError_) { try {
         return fs.lstatSync(this.isAt).isFile();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
     isFile() { return true; }
@@ -584,12 +590,10 @@ export class Folder extends Road {
                 yield* entry.walkSync(filter_);
         }
     }
-    async find(name_, expect_) {
+    async find(name_, filter_) {
         try {
-            const found = await factory(this.join(name_));
-            if (!expect_)
-                return found;
-            if (found instanceof expect_)
+            const found = await road(this.join(name_));
+            if (!filter_ || filter_(found))
                 return found;
             return null;
         }
@@ -597,45 +601,43 @@ export class Folder extends Road {
             return null;
         }
     }
-    findSync(name_, expect_) {
+    findSync(name_, filter_) {
         try {
-            const found = factorySync(this.join(name_));
-            if (!expect_)
-                return found;
-            if (found instanceof expect_)
+            const found = roadSync(this.join(name_));
+            if (!filter_ || filter_(found))
                 return found;
             return null;
         }
-        catch (e) {
+        catch {
             return null;
         }
     }
     async add(name_, createable_) {
         const newPath = this.join(name_);
         await createable_.mk(newPath);
-        return (await factory(newPath));
+        return (await road(newPath));
     }
     addSync(name_, createable_) {
         const newPath = this.join(name_);
         createable_.mkSync(newPath);
-        return factorySync(newPath);
+        return roadSync(newPath);
     }
     async borrow(createable_, cb_) {
-        const path = this.join(`instrumentality@${crypto.randomUUID()}`);
+        const created = await createable_.mk(this.join(`instrumentality@${crypto.randomUUID()}`));
         try {
-            await cb_(await createable_.mk(path));
+            await cb_(created);
         }
         finally {
-            await fp.rm(path, { recursive: true, force: true });
+            await fp.rm(created.isAt, { recursive: true, force: true });
         }
     }
     borrowSync(createable_, cb_) {
-        const path = this.join(`instrumentality@${crypto.randomUUID()}`);
+        const created = createable_.mkSync(this.join(`instrumentality@${crypto.randomUUID()}`));
         try {
-            cb_(createable_.mkSync(path));
+            cb_(created);
         }
         finally {
-            fs.rmSync(path, { recursive: true, force: true });
+            fs.rmSync(created.isAt, { recursive: true, force: true });
         }
     }
     async size() {
@@ -650,16 +652,20 @@ export class Folder extends Road {
             size += entry.sizeSync();
         return size;
     }
-    async check() { try {
+    async check(throwOnError_) { try {
         return (await fp.lstat(this.isAt)).isDirectory();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
-    checkSync() { try {
+    checkSync(throwOnError_) { try {
         return fs.lstatSync(this.isAt).isDirectory();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
     isFolder() { return true; }
@@ -668,11 +674,12 @@ export class Folder extends Road {
 }
 export function folder(...args) { return new Folder(...args); }
 export function dir(...args) { return new Folder(...args); }
+export function directory(...args) { return new Folder(...args); }
 export function sysRoot() { return new Folder(ph.parse(process.cwd()).root, false); }
 export function home() { return new Folder(os.homedir(), false); }
 export function tmp() { return new Folder(os.tmpdir(), false); }
 export function here() { return new Folder(process.cwd(), false); }
-export { Folder as Dir, Folder as Directory, Folder as Dict, Folder as Dictionary };
+export { Folder as Dir, Folder as Directory };
 export class SymbolicLink extends Road {
     static async create(at_, target_) {
         try {
@@ -695,10 +702,10 @@ export class SymbolicLink extends Road {
     }
     static mkSync = SymbolicLink.createSync;
     async target() {
-        return factory(ph.resolve(ph.dirname(this.isAt), await fp.readlink(this.isAt)));
+        return await road(ph.resolve(ph.dirname(this.isAt), await fp.readlink(this.isAt)));
     }
     targetSync() {
-        return factorySync(ph.resolve(ph.dirname(this.isAt), fs.readlinkSync(this.isAt)));
+        return roadSync(ph.resolve(ph.dirname(this.isAt), fs.readlinkSync(this.isAt)));
     }
     async retarget(to_) {
         using _ = await this.lock();
@@ -720,16 +727,20 @@ export class SymbolicLink extends Road {
         using _ = this.lockSync();
         fs.unlinkSync(this.isAt);
     }
-    async check() { try {
+    async check(throwOnError_) { try {
         return (await fp.lstat(this.isAt)).isSymbolicLink();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
-    checkSync() { try {
+    checkSync(throwOnError_) { try {
         return fs.lstatSync(this.isAt).isSymbolicLink();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
     isSymlink() { return true; }
@@ -737,92 +748,114 @@ export class SymbolicLink extends Road {
 }
 export { SymbolicLink as Symlink };
 export function symlink(...args) { return new SymbolicLink(...args); }
+/**
+ * Represents a system-level resource that is not subject to modification.
+ * All modification operations will throw an error.
+ *
+ * One could say 'this road truly is *unusable*.' hehe
+ */
 export class UnusableRoad extends Road {
     mutable = false; // Modification will cause system issues (e.g. deleting a device file)
-    async size() { return 0; }
+    size() { return Promise.resolve(0); }
     sizeSync() { return 0; }
     error() { throw new Err(`${this.constructor.name} at '${this.isAt}' is a system-level resource thus not subject to modification.`); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be locked */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be locked */
     lock() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be locked */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be locked */
     lockSync() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be deleted */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be deleted */
     delete() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be deleted */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be deleted */
     deleteSync() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be moved */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be moved */
     move() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be moved */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be moved */
     moveSync() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be copied */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be copied */
     copy() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be copied */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be copied */
     copySync() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be renamed */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be renamed */
     rename() { return this.error(); }
-    /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be renamed */
+    /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be renamed */
     renameSync() { return this.error(); }
     isUnusable() { return true; }
 }
 export class BlockDevice extends UnusableRoad {
-    async check() { try {
+    async check(throwOnError_) { try {
         return (await fp.lstat(this.isAt)).isBlockDevice();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
-    checkSync() { try {
+    checkSync(throwOnError_) { try {
         return fs.lstatSync(this.isAt).isBlockDevice();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
     isBlockDevice() { return true; }
 }
 export function blockDevice(...args) { return new BlockDevice(...args); }
 export class CharacterDevice extends UnusableRoad {
-    async check() { try {
+    async check(throwOnError_) { try {
         return (await fp.lstat(this.isAt)).isCharacterDevice();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
-    checkSync() { try {
+    checkSync(throwOnError_) { try {
         return fs.lstatSync(this.isAt).isCharacterDevice();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
     isCharacterDevice() { return true; }
 }
 export function characterDevice(...args) { return new CharacterDevice(...args); }
 export class Fifo extends UnusableRoad {
-    async check() { try {
+    async check(throwOnError_) { try {
         return (await fp.lstat(this.isAt)).isFIFO();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
-    checkSync() { try {
+    checkSync(throwOnError_) { try {
         return fs.lstatSync(this.isAt).isFIFO();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
     isFifo() { return true; }
 }
 export function fifo(...args) { return new Fifo(...args); }
 export class Socket extends UnusableRoad {
-    async check() { try {
+    async check(throwOnError_) { try {
         return (await fp.lstat(this.isAt)).isSocket();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
-    checkSync() { try {
+    checkSync(throwOnError_) { try {
         return fs.lstatSync(this.isAt).isSocket();
     }
-    catch {
+    catch (e) {
+        if (throwOnError_)
+            throw e;
         return false;
     } }
     isSocket() { return true; }

package/package.json

@@ -5,7 +5,7 @@
     "url": "https://github.com/clerkburk/instrumentality.git"
   },
   "type": "module",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "main": "./dist/base.js",
   "types": "./dist/base.d.ts",
   "devDependencies": {

package/src/base.ts

@@ -177,10 +177,6 @@ export const BASE122_ILLEGAL_INDEX: Readonly<Record<number, number>> = {
 export const BASE122_SHORT = 0b111 as const
 
 
-/** Lazy-initialized TextDecoder instance used for decoding base-122 encoded data. */
-let DECODER: TextDecoder
-
-
 /**
  * Encodes indexed data into a base-122 representation.
  *
@@ -223,7 +219,7 @@ export function encode122(data_: ArrayLike<number>): string {
       out[outIndex++] = 0b10000000 | (payload & 0b00111111)
     }
   }
-  return (DECODER ??= new TextDecoder("utf-8", { fatal: true })).decode(out.subarray(0, outIndex))
+  return new TextDecoder("utf-8", { fatal: true }).decode(out.subarray(0, outIndex))
 }
 
 

package/src/dom.ts

@@ -1,9 +1,9 @@
 /**
  * Resolves on `DOMContentLoaded` or immediately if the document is already ready.
  */
-export async function onceReady(): Promise<void> {
+export function onceReady(): Promise<void> {
   if (document.readyState === "complete" || document.readyState === "interactive")
-    return
+    return Promise.resolve()
   return new Promise(r => document.addEventListener("DOMContentLoaded", () => r(), { once: true }))
 }
 

package/src/road.ts

@@ -57,25 +57,6 @@ export { resolveDirent as resDirent }
 
 
 
-/**
- * Creates the appropriate subclass of {@link Road} based on the file mode of the specified path.
- *
- * @param path_ The path to follow.
- * @returns A new instance of {@link Road}.
- * @throws If {@link fp.lstat}/{@link fs.lstatSync} fails to retrieved the status of {@link path_}.
- */
-export async function factory(path_: string) {
-  return new (resolveStat((await fp.lstat(path_)).mode))(path_, false)
-}
-export { factory as fac, factory as mk }
-/** Sync version of {@link factory}. */
-export function factorySync(path_: string) {
-  return new (resolveStat(fs.lstatSync(path_).mode))(path_, false)
-}
-export { factorySync as facSync, factorySync as mkSync }
-
-
-
 /**
  * A map that keeps track of locked roads to prevent concurrent modifications.
  * 
@@ -124,7 +105,7 @@ export abstract class Road {
    */
   constructor(path_: string, typeCheck_: boolean) {
     this.pointsTo = ph.resolve(path_)
-    if (typeCheck_ && !this.checkSync())
+    if (typeCheck_ && !this.checkSync(true))
       throw new Err(`Type mismatch: '${this.isAt}'`)
   }
 
@@ -168,7 +149,7 @@ export abstract class Road {
   }
   async lock(): Promise<Disposable> {
     const l = this.reserveLock(true)
-    try { await l.previous } catch {}
+    try { await l.previous } catch { null }
     return l
   }
   lockSync(): Disposable {
@@ -188,7 +169,7 @@ export abstract class Road {
   async untilAccessible(abs: AbortSignal, expectMode = fsc.F_OK, cb_?: (err: unknown) => unknown): Promise<void> {
     const watcher = fs.watch(this.isAt)
     try {
-      for await (let _ of on(watcher, 'change', { signal: abs })) {
+      for await (const _ of on(watcher, 'change', { signal: abs })) {
         try {
           await fp.access(this.isAt, expectMode)
           return
@@ -209,7 +190,7 @@ export abstract class Road {
   async onChange<T>(abs_: AbortSignal, cb_?: () => T) {
     const watcher = fs.watch(this.isAt)
     try {
-      for await (let _ of on(watcher, 'change', { signal: abs_ }))
+      for await (const _ of on(watcher, 'change', { signal: abs_ }))
         return await cb_?.() ?? null
       return null
     }
@@ -272,8 +253,8 @@ export abstract class Road {
   }
 
   // jsdocs for the abstract methods are in the subclasses
-  abstract check(): Promise<boolean>
-  abstract checkSync(): boolean
+  abstract check(throwOnError_: boolean): Promise<boolean>
+  abstract checkSync(throwOnError_: boolean): boolean
 
   /** Type narrowing for {@link File} (similar to `instanceof` without unnecessary runtime checks). */
   isFile(): this is File { return false as const }
@@ -298,9 +279,30 @@ export abstract class Road {
   /** Type narrowing for {@link Socket} (similar to `instanceof` without unnecessary runtime checks). */
   isSocket(): this is Socket { return false as const }
 }
+
+
+
 /** Constructor type for a subclass of {@link Road}. */
 export type road_t<T extends Road> = new (...args_: ConstructorParameters<typeof Road>) => T
 
+  
+
+
+
+/**
+ * Creates the appropriate subclass of {@link Road} based on the file mode of the specified path.
+ *
+ * @param path_ The path to follow.
+ * @returns A new instance of {@link Road}.
+ * @throws If {@link fp.lstat}/{@link fs.lstatSync} fails to retrieved the status of {@link path_}.
+ */
+export async function road(path_: string) { return new (resolveStat((await fp.lstat(path_)).mode))(path_, false) }
+export { road as fac, road as mk, road as factory }
+/** Sync version of {@link road}. */
+export function roadSync(path_: string) { return new (resolveStat((fs.lstatSync(path_).mode)))(path_, false) }
+export { roadSync as facSync, roadSync as mkSync, roadSync as factorySync }
+
+
 
 
 /** Subclass of {@link Road} that represents a file. */
@@ -342,7 +344,7 @@ export class File extends Road {
   async read(): Promise<Buffer>
   async read(options_: Parameters<typeof fp.readFile>[1]): Promise<string>
   async read(options_?: Parameters<typeof fp.readFile>[1]): Promise<Buffer | string> {
-    return fp.readFile(this.isAt, options_!)
+    return await fp.readFile(this.isAt, options_!)
   }
   readSync(): Buffer
   readSync(options_: Parameters<typeof fs.readFileSync>[1]): string
@@ -406,8 +408,8 @@ export class File extends Road {
       }
     }
     finally {
-      try { iter1.return?.(undefined) } catch {}
-      try { iter2.return?.(undefined) } catch {}
+      try { iter1.return?.(undefined) } catch { null }
+      try { iter2.return?.(undefined) } catch { null }
     }
   }
 
@@ -501,8 +503,8 @@ export class File extends Road {
     fs.appendFileSync(this.isAt, data_, options_)
   }
 
-  async check(): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isFile() } catch { return false } }
-  checkSync(): boolean { try { return fs.lstatSync(this.isAt).isFile() } catch { return false } }
+  async check(throwOnError_: boolean): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isFile() } catch (e) { if (throwOnError_) throw e; return false } }
+  checkSync(throwOnError_: boolean): boolean { try { return fs.lstatSync(this.isAt).isFile() } catch (e) { if (throwOnError_) throw e; return false } }
 
   override isFile(): this is File { return true as const }
 }
@@ -513,7 +515,8 @@ export function file(...args: ConstructorParameters<typeof File>): File { return
 
 
 /** Helper type for filtering {@link Road} instances. */
-export type filter_t<T extends Road> = ((road: Road) => road is T)
+export type filter_t<T extends Road> = ((found: Road) => found is T)
+
 
 export class Folder extends Road {
   static async create(at_: string) {
@@ -591,52 +594,46 @@ export class Folder extends Road {
   }
 
   async find(name_: string): Promise<Road | null>
-  async find<T extends Road>(name_: string, expect_: road_t<T>): Promise<T | null>
-  async find<T extends Road>(name_: string, expect_?: road_t<T>): Promise<Road | T | null> {
+  async find<T extends Road>(name_: string, filter_: filter_t<T>): Promise<T | null>
+  async find<T extends Road>(name_: string, filter_?: filter_t<T>): Promise<Road | T | null> {
     try {
-      const found = await factory(this.join(name_))
-      if (!expect_)
+      const found = await road(this.join(name_))
+      if (!filter_ || filter_(found))
         return found
-      if (found instanceof expect_)
-        return found as T
       return null
-    }
-    catch { return null }
+    } catch { return null }
   }
   findSync(name_: string): Road | null
-  findSync<T extends Road>(name_: string, expect_: road_t<T>): T | null
-  findSync<T extends Road>(name_: string, expect_?: road_t<T>): Road | T | null {
+  findSync<T extends Road>(name_: string, filter_: filter_t<T>): T | null
+  findSync<T extends Road>(name_: string, filter_?: filter_t<T>): Road | T | null {
     try {
-      const found = factorySync(this.join(name_))
-      if (!expect_)
+      const found = roadSync(this.join(name_))
+      if (!filter_ || filter_(found))
         return found
-      if (found instanceof expect_)
-        return found as T
       return null
-    }
-    catch(e: unknown) { return null }
+    } catch { return null }
   }
 
   async add<T extends Road>(name_: string, createable_: { mk: (at: string) => Promise<T> }): Promise<T> {
     const newPath = this.join(name_)
     await createable_.mk(newPath)
-    return (await factory(newPath)) as unknown as T
+    return (await road(newPath)) as unknown as T
   }
   addSync<T extends Road>(name_: string, createable_: { mkSync: (at: string) => T }): T {
     const newPath = this.join(name_)
     createable_.mkSync(newPath)
-    return factorySync(newPath) as unknown as T
+    return roadSync(newPath) as unknown as T
   }
 
   async borrow<T extends Road>(createable_: { mk: (at: string) => Promise<T> }, cb_: (r: T) => Promise<void> | void): Promise<void> {
-    const path = this.join(`instrumentality@${crypto.randomUUID()}`)
-    try { await cb_(await createable_.mk(path)) }
-    finally { await fp.rm(path, { recursive: true, force: true }) }
+    const created = await createable_.mk(this.join(`instrumentality@${crypto.randomUUID()}`))
+    try { await cb_(created) }
+    finally { await fp.rm(created.isAt, { recursive: true, force: true }) }
   }
   borrowSync<T extends Road>(createable_: { mkSync: (at: string) => T }, cb_: (r: T) => void): void {
-    const path = this.join(`instrumentality@${crypto.randomUUID()}`)
-    try { cb_(createable_.mkSync(path)) }
-    finally { fs.rmSync(path, { recursive: true, force: true }) }
+    const created = createable_.mkSync(this.join(`instrumentality@${crypto.randomUUID()}`))
+    try { cb_(created) }
+    finally { fs.rmSync(created.isAt, { recursive: true, force: true }) }
   }
 
   async size(): Promise<number> {
@@ -652,8 +649,8 @@ export class Folder extends Road {
     return size
   }
 
-  async check(): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isDirectory() } catch { return false } }
-  checkSync(): boolean { try { return fs.lstatSync(this.isAt).isDirectory() } catch { return false } }
+  async check(throwOnError_: boolean): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isDirectory() } catch (e) { if (throwOnError_) throw e; return false } }
+  checkSync(throwOnError_: boolean): boolean { try { return fs.lstatSync(this.isAt).isDirectory() } catch (e) { if (throwOnError_) throw e; return false } }
 
   override isFolder(): this is Folder { return true as const }
   override isDir(): this is Folder { return true as const }
@@ -663,13 +660,14 @@ export class Folder extends Road {
 
 export function folder(...args: ConstructorParameters<typeof Folder>): Folder { return new Folder(...args) }
 export function dir(...args: ConstructorParameters<typeof Folder>): Folder { return new Folder(...args) }
+export function directory(...args: ConstructorParameters<typeof Folder>): Folder { return new Folder(...args) }
 
 
 export function sysRoot() { return new Folder(ph.parse(process.cwd()).root, false) }
 export function home() { return new Folder(os.homedir(), false) }
 export function tmp() { return new Folder(os.tmpdir(), false) }
 export function here() { return new Folder(process.cwd(), false) }
-export { Folder as Dir, Folder as Directory, Folder as Dict, Folder as Dictionary }
+export { Folder as Dir, Folder as Directory }
 
 
 
@@ -688,10 +686,10 @@ export class SymbolicLink extends Road {
   static readonly mkSync: typeof SymbolicLink.createSync = SymbolicLink.createSync
 
   async target() {
-    return factory(ph.resolve(ph.dirname(this.isAt), await fp.readlink(this.isAt)))
+    return await road(ph.resolve(ph.dirname(this.isAt), await fp.readlink(this.isAt)))
   }
   targetSync() {
-    return factorySync(ph.resolve(ph.dirname(this.isAt), fs.readlinkSync(this.isAt)))
+    return roadSync(ph.resolve(ph.dirname(this.isAt), fs.readlinkSync(this.isAt)))
   }
   async retarget(to_: Road) {
     using _ = await this.lock()
@@ -716,8 +714,8 @@ export class SymbolicLink extends Road {
     fs.unlinkSync(this.isAt)
   }
 
-  async check(): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isSymbolicLink() } catch { return false } }
-  checkSync(): boolean { try { return fs.lstatSync(this.isAt).isSymbolicLink() } catch { return false } }
+  async check(throwOnError_: boolean): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isSymbolicLink() } catch (e) { if (throwOnError_) throw e; return false } }
+  checkSync(throwOnError_: boolean): boolean { try { return fs.lstatSync(this.isAt).isSymbolicLink() } catch (e) { if (throwOnError_) throw e; return false } }
 
   override isSymlink(): this is SymbolicLink { return true as const }
   override isSymbolicLink(): this is SymbolicLink { return true as const }
@@ -731,55 +729,60 @@ export function symlink(...args: ConstructorParameters<typeof SymbolicLink>): Sy
 
 
 
+/**
+ * Represents a system-level resource that is not subject to modification.
+ * All modification operations will throw an error.
+ * 
+ * One could say 'this road truly is *unusable*.' hehe
+ */
 export abstract class UnusableRoad extends Road {
-  override readonly mutable = false as const // Modification will cause system issues (e.g. deleting a device file)
-  async size(): Promise<0> { return 0 }
+  override readonly mutable: never = false as never // Modification will cause system issues (e.g. deleting a device file)
+  size(): Promise<0> { return Promise.resolve(0) }
   sizeSync(): 0 { return 0 }
   error(): never { throw new Err(`${this.constructor.name} at '${this.isAt}' is a system-level resource thus not subject to modification.`) }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be locked */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be locked */
   override lock(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be locked */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be locked */
   override lockSync(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be deleted */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be deleted */
   override delete(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be deleted */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be deleted */
   override deleteSync(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be moved */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be moved */
   override move(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be moved */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be moved */
   override moveSync(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be copied */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be copied */
   override copy(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be copied */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be copied */
   override copySync(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be renamed */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be renamed */
   override rename(): never { return this.error() }
-  /** @deprecated System-level resources (UnusableRoad) can't/shouldn't be renamed */
+  /** @deprecated System-level resources ({@link UnusableRoad}) can't/shouldn't be renamed */
   override renameSync(): never { return this.error() }
-
   override isUnusable(): this is UnusableRoad { return true as const }
 }
 export class BlockDevice extends UnusableRoad {
-  async check(): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isBlockDevice() } catch { return false } }
-  checkSync(): boolean { try { return fs.lstatSync(this.isAt).isBlockDevice() } catch { return false } }
+  async check(throwOnError_: boolean): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isBlockDevice() } catch (e) { if (throwOnError_) throw e; return false } }
+  checkSync(throwOnError_: boolean): boolean { try { return fs.lstatSync(this.isAt).isBlockDevice() } catch (e) { if (throwOnError_) throw e; return false } }
   override isBlockDevice(): this is BlockDevice { return true as const }
 }
 export function blockDevice(...args: ConstructorParameters<typeof BlockDevice>): BlockDevice { return new BlockDevice(...args) }
 export class CharacterDevice extends UnusableRoad {
-  async check(): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isCharacterDevice() } catch { return false } }
-  checkSync(): boolean { try { return fs.lstatSync(this.isAt).isCharacterDevice() } catch { return false } }
+  async check(throwOnError_: boolean): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isCharacterDevice() } catch (e) { if (throwOnError_) throw e; return false } }
+  checkSync(throwOnError_: boolean): boolean { try { return fs.lstatSync(this.isAt).isCharacterDevice() } catch (e) { if (throwOnError_) throw e; return false } }
   override isCharacterDevice(): this is CharacterDevice { return true as const }
 }
 export function characterDevice(...args: ConstructorParameters<typeof CharacterDevice>): CharacterDevice { return new CharacterDevice(...args) }
 export class Fifo extends UnusableRoad {
-  async check(): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isFIFO() } catch { return false } }
-  checkSync(): boolean { try { return fs.lstatSync(this.isAt).isFIFO() } catch { return false } }
+  async check(throwOnError_: boolean): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isFIFO() } catch (e) { if (throwOnError_) throw e; return false } }
+  checkSync(throwOnError_: boolean): boolean { try { return fs.lstatSync(this.isAt).isFIFO() } catch (e) { if (throwOnError_) throw e; return false } }
   override isFifo(): this is Fifo { return true as const }
 }
 export function fifo(...args: ConstructorParameters<typeof Fifo>): Fifo { return new Fifo(...args) }
 export class Socket extends UnusableRoad {
-  async check(): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isSocket() } catch { return false } }
-  checkSync(): boolean { try { return fs.lstatSync(this.isAt).isSocket() } catch { return false } }
+  async check(throwOnError_: boolean): Promise<boolean> { try { return (await fp.lstat(this.isAt)).isSocket() } catch (e) { if (throwOnError_) throw e; return false } }
+  checkSync(throwOnError_: boolean): boolean { try { return fs.lstatSync(this.isAt).isSocket() } catch (e) { if (throwOnError_) throw e; return false } }
   override isSocket(): this is Socket { return true as const }
 }
 export function socket(...args: ConstructorParameters<typeof Socket>): Socket { return new Socket(...args) }