chore: add readFileJson, rename internal URL#asDir to URL#dir

.task/internal/fs.js

@@ -12,15 +12,32 @@ export const copydir = async function copydir(src, dst) {
 
 		for (const dirent of await readdir(src, { withFileTypes: true })) {
 			await (dirent.isDirectory() ? copydir : copyFile)(
-				src.asDir.to(dirent.name),
-				dst.asDir.to(dirent.name)
+				src.dir.to(dirent.name),
+				dst.dir.to(dirent.name)
 			)
 		}
 	}
 
 	copydir(URL.from(src), URL.from(dst))
 }
 
+/** Asynchronously reads a file as parsed JSON. */
+export const readFileJson = {
+	async readFileJson(/** @type {import('fs').PathLike | fs.FileHandle} */ path) {
+		const json = await fs.readFile(path, 'utf8')
+
+		/** @type {JSONValue} */
+		const data = JSON.parse(json)
+
+		return data
+	}
+}.readFileJson
+
 fs.copydir = copydir
+fs.readFileJson = readFileJson
+
+/** @typedef { string | number | boolean | null | JSONArray | JSONObject } JSONValue */
+/** @typedef { JSONValue[] } JSONArray */
+/** @typedef {{ [k: string]: JSONValue }} JSONObject */
 
 export default fs

.task/internal/url.js

@@ -13,7 +13,7 @@ export default class URL extends globalThis.URL {
 		return this.href.endsWith(searchString, length)
 	}
 
-	get asDir() {
+	get dir() {
 		return new URL(this.href + '/')
 	}