@jsenv/filesystem 3.2.2 → 4.0.0

package/README.md

@@ -1,18 +1,7 @@
-# Jsenv filesystem [![npm package](https://img.shields.io/npm/v/@jsenv/filesystem.svg?logo=npm&label=package)](https://www.npmjs.com/package/@jsenv/filesystem) [![github main](https://github.com/jsenv/filesystem/workflows/main/badge.svg)](https://github.com/jsenv/filesystem/actions?workflow=main) [![codecov coverage](https://codecov.io/gh/jsenv/filesystem/branch/main/graph/badge.svg)](https://codecov.io/gh/jsenv/filesystem)
+# Jsenv filesystem [![npm package](https://img.shields.io/npm/v/@jsenv/filesystem.svg?logo=npm&label=package)](https://www.npmjs.com/package/@jsenv/filesystem)
 
 Collection of functions to interact with filesystem in Node.js
 
-## Get a relative url
-
-```js
-import { urlToRelativeUrl } from "@jsenv/filesystem"
-
-const projectDirectoryUrl = "file:///project/"
-const jsFileUrl = "file:///project/src/file.js"
-const relativeUrl = urlToRelativeUrl(jsFileUrl, projectDirectoryUrl)
-console.log(relativeUrl) // "src/file.js"
-```
-
 ## List files using pattern matching
 
 ```js
@@ -87,7 +76,3 @@ unregister() // stop watching the directory changes
 ```console
 npm install @jsenv/filesystem
 ```
-
-# Development
-
-If you are part or want to be part of the developpers of this package, check [docs/development.md](./docs/development.md)

package/main.js

@@ -1,13 +1,3 @@
-// we won't internalize @jsenv/url-meta
-// so that @jsenv/url-meta does not becomes nodejs specific
-// but these functions could be inside this repository
-export {
-  applyPatternMatching,
-  normalizeStructuredMetaMap,
-  urlCanContainsMetaMatching,
-  urlToMeta,
-} from "@jsenv/url-meta"
-
 export { assertAndNormalizeDirectoryUrl } from "./src/assertAndNormalizeDirectoryUrl.js"
 export { assertAndNormalizeFileUrl } from "./src/assertAndNormalizeFileUrl.js"
 export { assertDirectoryPresence } from "./src/assertDirectoryPresence.js"
@@ -21,16 +11,11 @@ export { ensureParentDirectories } from "./src/ensureParentDirectories.js"
 export { ensureWindowsDriveLetter } from "./src/ensureWindowsDriveLetter.js"
 export { copyEntry } from "./src/copyEntry.js"
 export { copyDirectoryContent } from "./src/copyDirectoryContent.js"
-export { fileSystemPathToUrl } from "./src/fileSystemPathToUrl.js"
-export { fileSystemRootUrl } from "./src/fileSystemRootUrl.js"
 export { getRealFileSystemUrlSync } from "./src/getRealFileSystemUrlSync.js"
 export { grantPermissionsOnEntry } from "./src/grantPermissionsOnEntry.js"
-export { isFileSystemPath } from "./src/isFileSystemPath.js"
 export { listFilesMatching } from "./src/listFilesMatching.js"
-export { memoize } from "./src/memoize.js"
 export { moveDirectoryContent } from "./src/moveDirectoryContent.js"
 export { moveEntry } from "./src/moveEntry.js"
-export { moveUrl } from "./src/moveUrl.js"
 export { readDirectory } from "./src/readDirectory.js"
 export { readFile } from "./src/readFile.js"
 export { readFileSync } from "./src/readFileSync.js"
@@ -41,20 +26,7 @@ export { readSymbolicLink } from "./src/readSymbolicLink.js"
 export { registerDirectoryLifecycle } from "./src/registerDirectoryLifecycle.js"
 export { registerFileLifecycle } from "./src/registerFileLifecycle.js"
 export { removeEntry } from "./src/removeEntry.js"
-export { resolveDirectoryUrl } from "./src/resolveDirectoryUrl.js"
-export { resolveUrl } from "./src/resolveUrl.js"
 export { testEntryPermissions } from "./src/testEntryPermissions.js"
-export { urlIsInsideOf } from "./src/urlIsInsideOf.js"
-export { urlToBasename } from "./src/urlToBasename.js"
-export { urlToExtension } from "./src/urlToExtension.js"
-export { urlToFilename } from "./src/urlToFilename.js"
-export { urlToFileSystemPath } from "./src/urlToFileSystemPath.js"
-export { urlToOrigin } from "./src/urlToOrigin.js"
-export { urlToParentUrl } from "./src/urlToParentUrl.js"
-export { urlToPathname } from "./src/urlToPathname.js"
-export { urlToRelativeUrl } from "./src/urlToRelativeUrl.js"
-export { urlToRessource } from "./src/urlToRessource.js"
-export { urlToScheme } from "./src/urlToScheme.js"
 export { writeDirectory } from "./src/writeDirectory.js"
 export { writeFile } from "./src/writeFile.js"
 export { writeFileSync } from "./src/writeFileSync.js"

package/package.json

@@ -1,23 +1,20 @@
 {
   "name": "@jsenv/filesystem",
-  "version": "3.2.2",
-  "description": "Collection of functions to interact with filesystem in Node.js",
+  "version": "4.0.0",
   "license": "MIT",
-  "author": {
-    "name": "dmail",
-    "email": "dmaillard06@gmail.com",
-    "url": "https://twitter.com/damienmaillard"
-  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/jsenv/filesystem"
-  },
-  "engines": {
-    "node": ">=16.13.0"
+    "url": "https://github.com/jsenv/jsenv-core",
+    "directory": "packages/filesystem"
   },
   "publishConfig": {
     "access": "public"
   },
+  "author": {
+    "name": "dmail",
+    "email": "dmaillard06@gmail.com",
+    "url": "https://twitter.com/damienmaillard"
+  },
   "type": "module",
   "exports": {
     ".": {
@@ -25,34 +22,16 @@
     },
     "./*": "./*"
   },
-  "main": "./main.js",
   "files": [
     "/src/",
     "/main.js"
   ],
   "scripts": {
-    "eslint": "node ./node_modules/eslint/bin/eslint.js .",
-    "importmap": "node ./script/importmap/importmap.mjs",
-    "performance": "node --expose-gc ./script/performance/performance.mjs --log",
-    "test": "node ./script/test/test.mjs",
-    "test-with-coverage": "npm run test -- --coverage",
-    "prettier": "prettier --write ."
+    "test": "node --conditions=development ./test.mjs"
   },
   "dependencies": {
+    "@jsenv/urls": "1.1.0",
     "@jsenv/abort": "4.1.2",
-    "@jsenv/url-meta": "6.0.3"
-  },
-  "devDependencies": {
-    "@jsenv/assert": "2.4.1",
-    "@jsenv/core": "25.2.1",
-    "@jsenv/eslint-config": "16.0.9",
-    "@jsenv/github-release-package": "1.2.3",
-    "@jsenv/importmap-eslint-resolver": "5.2.2",
-    "@jsenv/importmap-node-module": "5.1.0",
-    "@jsenv/package-publish": "1.6.2",
-    "@jsenv/performance-impact": "2.2.1",
-    "eslint": "8.7.0",
-    "eslint-plugin-import": "2.25.4",
-    "prettier": "2.5.1"
+    "@jsenv/log": "1.6.3"
   }
 }

package/src/assertAndNormalizeDirectoryUrl.js

@@ -1,6 +1,8 @@
-import { ensureUrlTrailingSlash } from "./internal/ensureUrlTrailingSlash.js"
-import { isFileSystemPath } from "./isFileSystemPath.js"
-import { fileSystemPathToUrl } from "./fileSystemPathToUrl.js"
+import {
+  fileSystemPathToUrl,
+  isFileSystemPath,
+  ensurePathnameTrailingSlash,
+} from "@jsenv/urls"
 
 export const assertAndNormalizeDirectoryUrl = (value) => {
   let urlString
@@ -29,5 +31,5 @@ export const assertAndNormalizeDirectoryUrl = (value) => {
     throw new Error(`directoryUrl must starts with file://, received ${value}`)
   }
 
-  return ensureUrlTrailingSlash(urlString)
+  return ensurePathnameTrailingSlash(urlString)
 }

package/src/assertAndNormalizeFileUrl.js

@@ -1,5 +1,4 @@
-import { isFileSystemPath } from "./isFileSystemPath.js"
-import { fileSystemPathToUrl } from "./fileSystemPathToUrl.js"
+import { fileSystemPathToUrl, isFileSystemPath } from "@jsenv/urls"
 
 export const assertAndNormalizeFileUrl = (value, baseUrl) => {
   let urlString

package/src/assertDirectoryPresence.js

@@ -1,6 +1,6 @@
-import { statsToType } from "./internal/statsToType.js"
+import { urlToFileSystemPath } from "@jsenv/urls"
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
+import { statsToType } from "./internal/statsToType.js"
 import { readEntryStat } from "./readEntryStat.js"
 
 export const assertDirectoryPresence = async (source) => {

package/src/assertFilePresence.js

@@ -1,6 +1,6 @@
-import { statsToType } from "./internal/statsToType.js"
+import { urlToFileSystemPath } from "@jsenv/urls"
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
+import { statsToType } from "./internal/statsToType.js"
 import { readEntryStat } from "./readEntryStat.js"
 
 export const assertFilePresence = async (source) => {

package/src/collectDirectoryMatchReport.js

@@ -1,21 +1,15 @@
 import { Abort } from "@jsenv/abort"
-import {
-  normalizeStructuredMetaMap,
-  urlCanContainsMetaMatching,
-  urlToMeta,
-} from "@jsenv/url-meta"
 
-import { ensureUrlTrailingSlash } from "./internal/ensureUrlTrailingSlash.js"
+import { URL_META, urlToRelativeUrl } from "@jsenv/urls"
 import { assertAndNormalizeDirectoryUrl } from "./assertAndNormalizeDirectoryUrl.js"
 import { readDirectory } from "./readDirectory.js"
 import { readEntryStat } from "./readEntryStat.js"
-import { urlToRelativeUrl } from "./urlToRelativeUrl.js"
 import { comparePathnames } from "./comparePathnames.js"
 
 export const collectDirectoryMatchReport = async ({
   signal = new AbortController().signal,
   directoryUrl,
-  structuredMetaMap,
+  associations,
   predicate,
 }) => {
   const matchingArray = []
@@ -25,10 +19,7 @@ export const collectDirectoryMatchReport = async ({
   if (typeof predicate !== "function") {
     throw new TypeError(`predicate must be a function, got ${predicate}`)
   }
-  const structuredMetaMapNormalized = normalizeStructuredMetaMap(
-    structuredMetaMap,
-    rootDirectoryUrl,
-  )
+  associations = URL_META.resolveAssociations(associations, rootDirectoryUrl)
 
   const collectOperation = Abort.startOperation()
   collectOperation.addAbortSignal(signal)
@@ -63,14 +54,16 @@ export const collectDirectoryMatchReport = async ({
           const subDirectoryUrl = `${directoryChildNodeUrl}/`
 
           if (
-            !urlCanContainsMetaMatching({
+            !URL_META.urlChildMayMatch({
               url: subDirectoryUrl,
-              structuredMetaMap: structuredMetaMapNormalized,
+              associations,
               predicate,
             })
           ) {
             ignoredArray.push({
-              relativeUrl: ensureUrlTrailingSlash(relativeUrl),
+              relativeUrl: relativeUrl.endsWith("/")
+                ? relativeUrl
+                : `${relativeUrl}/`,
               fileStats: directoryChildNodeStats,
             })
 
@@ -82,9 +75,9 @@ export const collectDirectoryMatchReport = async ({
         }
 
         if (directoryChildNodeStats.isFile()) {
-          const meta = urlToMeta({
+          const meta = URL_META.applyAssociations({
             url: directoryChildNodeUrl,
-            structuredMetaMap: structuredMetaMapNormalized,
+            associations,
           })
           if (!predicate(meta)) {
             ignoredArray.push({

package/src/collectFiles.js

@@ -1,30 +1,22 @@
 import { Abort } from "@jsenv/abort"
-import {
-  normalizeStructuredMetaMap,
-  urlCanContainsMetaMatching,
-  urlToMeta,
-} from "@jsenv/url-meta"
+import { URL_META, urlToRelativeUrl } from "@jsenv/urls"
 
 import { assertAndNormalizeDirectoryUrl } from "./assertAndNormalizeDirectoryUrl.js"
 import { readDirectory } from "./readDirectory.js"
 import { readEntryStat } from "./readEntryStat.js"
-import { urlToRelativeUrl } from "./urlToRelativeUrl.js"
 import { comparePathnames } from "./comparePathnames.js"
 
 export const collectFiles = async ({
   signal = new AbortController().signal,
   directoryUrl,
-  structuredMetaMap,
+  associations,
   predicate,
 }) => {
   const rootDirectoryUrl = assertAndNormalizeDirectoryUrl(directoryUrl)
   if (typeof predicate !== "function") {
     throw new TypeError(`predicate must be a function, got ${predicate}`)
   }
-  const structuredMetaMapNormalized = normalizeStructuredMetaMap(
-    structuredMetaMap,
-    rootDirectoryUrl,
-  )
+  associations = URL_META.resolveAssociations(associations, rootDirectoryUrl)
 
   const collectOperation = Abort.startOperation()
   collectOperation.addAbortSignal(signal)
@@ -56,9 +48,9 @@ export const collectFiles = async ({
           const subDirectoryUrl = `${directoryChildNodeUrl}/`
 
           if (
-            !urlCanContainsMetaMatching({
+            !URL_META.urlChildMayMatch({
               url: subDirectoryUrl,
-              structuredMetaMap: structuredMetaMapNormalized,
+              associations,
               predicate,
             })
           ) {
@@ -70,9 +62,9 @@ export const collectFiles = async ({
         }
 
         if (directoryChildNodeStats.isFile()) {
-          const meta = urlToMeta({
+          const meta = URL_META.applyAssociations({
             url: directoryChildNodeUrl,
-            structuredMetaMap: structuredMetaMapNormalized,
+            associations,
           })
           if (!predicate(meta)) return
 

package/src/copyDirectoryContent.js

@@ -1,10 +1,9 @@
 import { Abort } from "@jsenv/abort"
+import { urlToFileSystemPath, resolveUrl } from "@jsenv/urls"
 
 import { assertAndNormalizeDirectoryUrl } from "./assertAndNormalizeDirectoryUrl.js"
 import { readEntryStat } from "./readEntryStat.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 import { readSymbolicLink } from "./readSymbolicLink.js"
-import { resolveUrl } from "./resolveUrl.js"
 import { readDirectory } from "./readDirectory.js"
 import { copyEntry } from "./copyEntry.js"
 import { urlTargetsSameFileSystemPath } from "./internal/urlTargetsSameFileSystemPath.js"

package/src/copyEntry.js

@@ -1,14 +1,18 @@
 import { copyFile as copyFileNode } from "node:fs"
 import { Abort } from "@jsenv/abort"
+import {
+  resolveUrl,
+  urlToRelativeUrl,
+  ensurePathnameTrailingSlash,
+  urlIsInsideOf,
+  urlToFileSystemPath,
+} from "@jsenv/urls"
 
 import { urlTargetsSameFileSystemPath } from "./internal/urlTargetsSameFileSystemPath.js"
 import { statsToType } from "./internal/statsToType.js"
-import { ensureUrlTrailingSlash } from "./internal/ensureUrlTrailingSlash.js"
-import { resolveUrl } from "./resolveUrl.js"
 import { binaryFlagsToPermissions } from "./internal/permissions.js"
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
 import { writeDirectory } from "./writeDirectory.js"
-import { urlToRelativeUrl } from "./urlToRelativeUrl.js"
 import { readEntryStat } from "./readEntryStat.js"
 import { ensureParentDirectories } from "./ensureParentDirectories.js"
 import { writeEntryPermissions } from "./writeEntryPermissions.js"
@@ -16,9 +20,7 @@ import { writeEntryModificationTime } from "./writeEntryModificationTime.js"
 import { readDirectory } from "./readDirectory.js"
 import { readSymbolicLink } from "./readSymbolicLink.js"
 import { writeSymbolicLink } from "./writeSymbolicLink.js"
-import { urlIsInsideOf } from "./urlIsInsideOf.js"
 import { removeEntry } from "./removeEntry.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 
 export const copyEntry = async ({
   signal = new AbortController().signal,
@@ -70,7 +72,7 @@ export const copyEntry = async ({
   }
 
   if (sourceStats.isDirectory()) {
-    toUrl = ensureUrlTrailingSlash(toUrl)
+    toUrl = ensurePathnameTrailingSlash(toUrl)
   }
 
   const copyOperation = Abort.startOperation()
@@ -83,7 +85,7 @@ export const copyEntry = async ({
     } else if (stats.isSymbolicLink()) {
       await visitSymbolicLink(url, stats)
     } else if (stats.isDirectory()) {
-      await visitDirectory(ensureUrlTrailingSlash(url), stats)
+      await visitDirectory(ensurePathnameTrailingSlash(url), stats)
     }
   }
 

package/src/ensureEmptyDirectory.js

@@ -1,6 +1,6 @@
-import { statsToType } from "./internal/statsToType.js"
+import { urlToFileSystemPath } from "@jsenv/urls"
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
+import { statsToType } from "./internal/statsToType.js"
 import { writeDirectory } from "./writeDirectory.js"
 import { readEntryStat } from "./readEntryStat.js"
 import { removeEntry } from "./removeEntry.js"

package/src/ensureParentDirectories.js

@@ -1,7 +1,7 @@
 import { dirname } from "node:path"
+import { urlToFileSystemPath } from "@jsenv/urls"
 
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 import { writeDirectory } from "./writeDirectory.js"
 
 export const ensureParentDirectories = async (destination) => {

package/src/ensureWindowsDriveLetter.js

@@ -1,4 +1,4 @@
-import { fileSystemPathToUrl } from "./fileSystemPathToUrl.js"
+import { fileSystemPathToUrl } from "@jsenv/urls"
 
 const isWindows = process.platform === "win32"
 const baseUrlFallback = fileSystemPathToUrl(process.cwd())

package/src/getRealFileSystemUrlSync.js

@@ -1,7 +1,5 @@
 import { readdirSync, realpathSync } from "node:fs"
-
-import { fileSystemPathToUrl } from "./fileSystemPathToUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
+import { fileSystemPathToUrl, urlToFileSystemPath } from "@jsenv/urls"
 
 export const getRealFileSystemUrlSync = (
   fileUrl,

package/src/listFilesMatching.js

@@ -8,15 +8,11 @@ export const listFilesMatching = async ({
   if (typeof patterns !== "object" || patterns === null) {
     throw new TypeError(`patterns must be an object, got ${patterns}`)
   }
-
   const fileDatas = await collectFiles({
     signal,
     directoryUrl,
-    structuredMetaMap: {
-      matches: patterns,
-    },
+    associations: { matches: patterns },
     predicate: ({ matches }) => matches,
   })
-
   return fileDatas.map(({ url }) => url)
 }

package/src/moveDirectoryContent.js

@@ -1,10 +1,9 @@
 import { Abort } from "@jsenv/abort"
+import { urlToFileSystemPath, resolveUrl } from "@jsenv/urls"
 
 import { assertAndNormalizeDirectoryUrl } from "./assertAndNormalizeDirectoryUrl.js"
 import { readEntryStat } from "./readEntryStat.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 import { readSymbolicLink } from "./readSymbolicLink.js"
-import { resolveUrl } from "./resolveUrl.js"
 import { readDirectory } from "./readDirectory.js"
 import { moveEntry } from "./moveEntry.js"
 import { urlTargetsSameFileSystemPath } from "./internal/urlTargetsSameFileSystemPath.js"

package/src/moveEntry.js

@@ -1,11 +1,10 @@
 import { rename } from "node:fs"
 import { Abort } from "@jsenv/abort"
+import { urlToFileSystemPath, resolveUrl } from "@jsenv/urls"
 
 import { urlTargetsSameFileSystemPath } from "./internal/urlTargetsSameFileSystemPath.js"
 import { statsToType } from "./internal/statsToType.js"
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
-import { resolveUrl } from "./resolveUrl.js"
 import { ensureParentDirectories } from "./ensureParentDirectories.js"
 import { removeEntry } from "./removeEntry.js"
 import { copyEntry } from "./copyEntry.js"

package/src/readDirectory.js

@@ -1,6 +1,6 @@
-import { readdir } from "fs"
+import { readdir } from "node:fs"
+import { urlToFileSystemPath } from "@jsenv/urls"
 import { assertAndNormalizeDirectoryUrl } from "./assertAndNormalizeDirectoryUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 
 export const readDirectory = async (url, { emfileMaxWait = 1000 } = {}) => {
   const directoryUrl = assertAndNormalizeDirectoryUrl(url)

package/src/readEntryPermissions.js

@@ -4,10 +4,10 @@
  */
 
 import { promises } from "node:fs"
+import { urlToFileSystemPath } from "@jsenv/urls"
 
 import { binaryFlagsToPermissions } from "./internal/permissions.js"
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 
 const { stat } = promises
 

package/src/readEntryStat.js

@@ -4,9 +4,9 @@
  */
 
 import { lstat, stat } from "node:fs"
+import { urlToFileSystemPath } from "@jsenv/urls"
 
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 import { writeEntryPermissions } from "./writeEntryPermissions.js"
 
 const isWindows = process.platform === "win32"

package/src/readFile.js

@@ -1,12 +1,18 @@
-import { promisify } from "node:util"
 import { readFile as readFileNode } from "node:fs"
 
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
 
-const readFilePromisified = promisify(readFileNode)
 export const readFile = async (value, { as = "buffer" } = {}) => {
   const fileUrl = assertAndNormalizeFileUrl(value)
-  const buffer = await readFilePromisified(new URL(fileUrl))
+  const buffer = await new Promise((resolve, reject) => {
+    readFileNode(new URL(fileUrl), (error, buffer) => {
+      if (error) {
+        reject(error)
+      } else {
+        resolve(buffer)
+      }
+    })
+  })
   if (as === "buffer") {
     return buffer
   }

package/src/readSymbolicLink.js

@@ -4,26 +4,22 @@
  */
 
 import { readlink } from "node:fs"
+import { isFileSystemPath, fileSystemPathToUrl } from "@jsenv/urls"
 
-import { replaceBackSlashesWithSlashes } from "./internal/replaceBackSlashesWithSlashes.js"
 import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
-import { fileSystemPathToUrl } from "./fileSystemPathToUrl.js"
-import { isFileSystemPath } from "./isFileSystemPath.js"
 
 export const readSymbolicLink = (url) => {
   const symbolicLinkUrl = assertAndNormalizeFileUrl(url)
-  const symbolicLinkPath = urlToFileSystemPath(symbolicLinkUrl)
 
   return new Promise((resolve, reject) => {
-    readlink(symbolicLinkPath, (error, resolvedPath) => {
+    readlink(new URL(symbolicLinkUrl), (error, resolvedPath) => {
       if (error) {
         reject(error)
       } else {
         resolve(
           isFileSystemPath(resolvedPath)
             ? fileSystemPathToUrl(resolvedPath)
-            : replaceBackSlashesWithSlashes(resolvedPath),
+            : resolvedPath.replace(/\\/g, "/"), // replace back slashes with slashes
         )
       }
     })

package/src/registerDirectoryLifecycle.js

@@ -1,18 +1,11 @@
 import { readdirSync, statSync } from "node:fs"
-import {
-  normalizeStructuredMetaMap,
-  urlCanContainsMetaMatching,
-  urlToMeta,
-} from "@jsenv/url-meta"
+import { URL_META, urlToFileSystemPath, urlToRelativeUrl } from "@jsenv/urls"
 
 import { assertAndNormalizeDirectoryUrl } from "./assertAndNormalizeDirectoryUrl.js"
 import { statsToType } from "./internal/statsToType.js"
 import { guardTooFastSecondCall } from "./internal/guard_second_call.js"
-import { replaceBackSlashesWithSlashes } from "./internal/replaceBackSlashesWithSlashes.js"
 import { createWatcher } from "./internal/createWatcher.js"
 import { trackRessources } from "./internal/trackRessources.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
-import { urlToRelativeUrl } from "./urlToRelativeUrl.js"
 
 const isLinux = process.platform === "linux"
 // linux does not support recursive option
@@ -65,16 +58,16 @@ export const registerDirectoryLifecycle = (
     }
   }
 
-  const structuredMetaMap = normalizeStructuredMetaMap(
+  const associations = URL_META.resolveAssociations(
     { watch: watchPatterns },
     sourceUrl,
   )
   const getWatchPatternValue = ({ url, type }) => {
     if (type === "directory") {
       let firstMeta = false
-      urlCanContainsMetaMatching({
+      URL_META.urlChildMayMatch({
         url: `${url}/`,
-        structuredMetaMap,
+        associations,
         predicate: ({ watch }) => {
           if (watch) {
             firstMeta = watch
@@ -84,11 +77,8 @@ export const registerDirectoryLifecycle = (
       })
       return firstMeta
     }
-    const filesystemEntryMeta = urlToMeta({
-      url,
-      structuredMetaMap,
-    })
-    return filesystemEntryMeta.watch
+    const { watch } = URL_META.applyAssociations({ url, associations })
+    return watch
   }
   const tracker = trackRessources()
   const infoMap = new Map()
@@ -260,7 +250,10 @@ export const registerDirectoryLifecycle = (
         watcher.on("change", (eventType, filename) => {
           handleDirectoryEvent({
             directoryRelativeUrl: entryInfo.relativeUrl,
-            filename: filename ? replaceBackSlashesWithSlashes(filename) : "",
+            filename: filename
+              ? // replace back slashes with slashes
+                filename.replace(/\\/g, "/")
+              : "",
             eventType,
           })
         })
@@ -348,7 +341,7 @@ const fileSystemPathToDirectoryRelativeUrlAndFilename = (path) => {
     }
   }
 
-  const normalizedPath = replaceBackSlashesWithSlashes(path)
+  const normalizedPath = path.replace(/\\/g, "/") // replace back slashes with slashes
   const slashLastIndex = normalizedPath.lastIndexOf("/")
   if (slashLastIndex === -1) {
     return {

package/src/registerFileLifecycle.js

@@ -1,12 +1,12 @@
 import { statSync } from "node:fs"
 import { dirname, basename } from "node:path"
+import { urlToFileSystemPath } from "@jsenv/urls"
 
+import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
 import { guardTooFastSecondCall } from "./internal/guard_second_call.js"
 import { statsToType } from "./internal/statsToType.js"
 import { createWatcher } from "./internal/createWatcher.js"
 import { trackRessources } from "./internal/trackRessources.js"
-import { assertAndNormalizeFileUrl } from "./assertAndNormalizeFileUrl.js"
-import { urlToFileSystemPath } from "./urlToFileSystemPath.js"
 
 export const registerFileLifecycle = (
   source,