@stryke/fs 0.33.22 → 0.33.24

package/CHANGELOG.md

@@ -1,7 +1,35 @@
+![Storm Software's logo banner](https://public.storm-cdn.com/storm-software/banner-1280x320.gif)
+
+# Changelog for Stryke - Fs
+
+## [0.33.23](https://github.com/storm-software/stryke/releases/tag/fs%400.33.23) (12/18/2025)
+
+### Updated Dependencies
+
+- Updated **string-format** to **v0.12.27**
+- Updated **type-checks** to **v0.5.12**
+- Updated **convert** to **v0.6.27**
+- Updated **helpers** to **v0.9.29**
+- Updated **types** to **v0.10.26**
+- Updated **json** to **v0.9.30**
+- Updated **path** to **v0.23.0**
+
 ![Storm Software's logo banner](https://public.storm-cdn.com/storm-software/banner-1280x320-optimized.gif)
 
 # Changelog for Stryke - Fs
 
+## [0.33.22](https://github.com/storm-software/stryke/releases/tag/fs%400.33.22) (12/17/2025)
+
+### Updated Dependencies
+
+- Updated **string-format** to **v0.12.26**
+- Updated **type-checks** to **v0.5.11**
+- Updated **convert** to **v0.6.26**
+- Updated **helpers** to **v0.9.28**
+- Updated **types** to **v0.10.25**
+- Updated **json** to **v0.9.29**
+- Updated **path** to **v0.22.13**
+
 ## [0.33.21](https://github.com/storm-software/stryke/releases/tag/fs%400.33.21) (12/17/2025)
 
 ### Updated Dependencies

package/README.md

@@ -5,9 +5,9 @@
 
 <div align="center">
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x640-dark-optimized.gif">
-  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x640-light-optimized.gif">
-<img src="https://public.storm-cdn.com/storm-software/banner-1280x640-dark-optimized.gif" width="100%" alt="Storm Software" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x640-dark.gif">
+  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x640-light.gif">
+<img src="https://public.storm-cdn.com/storm-software/banner-1280x640-dark.gif" width="100%" alt="Storm Software" />
 </picture>
 </div>
 <br />
@@ -248,9 +248,9 @@ specification. Contributions of any kind welcome!
 
 <div align="center">
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x320-dark-optimized.webp">
-  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x320-light-optimized.webp">
-<img src="https://public.storm-cdn.com/storm-software/banner-1280x320-dark-optimized.webp" width="100%" alt="Storm Software" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x320-dark.webp">
+  <source media="(prefers-color-scheme: light)" srcset="https://public.storm-cdn.com/storm-software/banner-1280x320-light.webp">
+<img src="https://public.storm-cdn.com/storm-software/banner-1280x320-dark.webp" width="100%" alt="Storm Software" />
 </picture>
 </div>
 <br />

package/dist/path/src/append.cjs

@@ -1 +1 @@
-const e=require(`./cwd.cjs`),t=require(`./slash.cjs`),n=require(`./is-parent-path.cjs`),r=require(`./join-paths.cjs`);function i(i,a=e.cwd()){return t.slash(n.isParentPath(i,a)?i:r.joinPaths(a,i))}function a(e,t){return`${e}.${t.replace(/^\./,``)}`}exports.appendExtension=a,exports.appendPath=i;
+const e=require(`./cwd.cjs`),t=require(`./slash.cjs`),n=require(`./is-parent-path.cjs`),r=require(`./join-paths.cjs`);function i(i,a=e.cwd(),o={}){return t.slash(o.skipIfAlreadyParent!==!1&&n.isParentPath(i,a)?i:r.joinPaths(a,i))}function a(e,t){return`${e}.${t.replace(/^\./,``)}`}exports.appendExtension=a,exports.appendPath=i;

package/dist/path/src/append.mjs

@@ -1,2 +1,2 @@
-import{cwd as e}from"./cwd.mjs";import{slash as t}from"./slash.mjs";import{isParentPath as n}from"./is-parent-path.mjs";import{joinPaths as r}from"./join-paths.mjs";function i(i,a=e()){return t(n(i,a)?i:r(a,i))}function a(e,t){return`${e}.${t.replace(/^\./,``)}`}export{a as appendExtension,i as appendPath};
+import{cwd as e}from"./cwd.mjs";import{slash as t}from"./slash.mjs";import{isParentPath as n}from"./is-parent-path.mjs";import{joinPaths as r}from"./join-paths.mjs";function i(i,a=e(),o={}){return t(o.skipIfAlreadyParent!==!1&&n(i,a)?i:r(a,i))}function a(e,t){return`${e}.${t.replace(/^\./,``)}`}export{a as appendExtension,i as appendPath};
 //# sourceMappingURL=append.mjs.map

package/dist/path/src/append.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"append.mjs","names":[],"sources":["../../../../path/src/append.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { cwd } from \"./cwd\";\nimport { isParentPath } from \"./is-parent-path\";\nimport { joinPaths } from \"./join-paths\";\nimport { slash } from \"./slash\";\n\n/**\n * If not already a parent path, append the base path from the beginning of the given child path.\n *\n * @example\n * ```ts\n * appendPath(\"src/index.ts\", \"/home/user/project\");\n * // returns \"/home/user/project/src/index.ts\"\n *\n * appendPath(\"/user/dev/app.ts\", \"/user/dev\");\n * // returns \"/user/dev/app.ts\"\n * ```\n *\n * @param childPath - The child path to append to the {@link parentPath}\n * @param parentPath - The parent path to add the {@link childPath} to\n * @returns The {@link parentPath} with the {@link childPath} appended\n */\nexport function appendPath(\n  childPath: string,\n  parentPath: string = cwd()\n): string {\n  return slash(\n    !isParentPath(childPath, parentPath)\n      ? joinPaths(parentPath, childPath)\n      : childPath\n  );\n}\n\nexport const append = appendPath;\n\n/**\n * Append the extension to the given path.\n *\n * @example\n * ```ts\n * appendExtension(\"/home/user/project/src/index\", \".ts\");\n * // returns \"/home/user/project/src/index.ts\"\n * appendExtension(\"/home/user/project/src/index.ts\", \".js\");\n * // returns \"/home/user/project/src/index.ts.js\"\n * ```\n *\n * @param path - The path to append the extension to.\n * @param extension - The extension to append.\n * @returns The path with the appended extension.\n */\nexport function appendExtension(path: string, extension: string): string {\n  return `${path}.${extension.replace(/^\\./, \"\")}`;\n}\n"],"mappings":"qKAuCA,SAAgB,EACd,EACA,EAAqB,GAAK,CAClB,CACR,OAAO,EACJ,EAAa,EAAW,EAAW,CAEhC,EADA,EAAU,EAAY,EAAU,CAErC,CAoBH,SAAgB,EAAgB,EAAc,EAA2B,CACvE,MAAO,GAAG,EAAK,GAAG,EAAU,QAAQ,MAAO,GAAG"}
+{"version":3,"file":"append.mjs","names":[],"sources":["../../../../path/src/append.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { cwd } from \"./cwd\";\nimport { isParentPath } from \"./is-parent-path\";\nimport { joinPaths } from \"./join-paths\";\nimport { slash } from \"./slash\";\n\nexport interface AppendPathOptions {\n  /**\n   * If `true`, the function will skip appending if the `childPath` is already a child of the `parentPath`.\n   *\n   * @defaultValue true\n   */\n  skipIfAlreadyParent?: boolean;\n}\n\n/**\n * If not already a parent path, append the base path from the beginning of the given child path.\n *\n * @example\n * ```ts\n * appendPath(\"src/index.ts\", \"/home/user/project\");\n * // returns \"/home/user/project/src/index.ts\"\n *\n * appendPath(\"/user/dev/app.ts\", \"/user/dev\");\n * // returns \"/user/dev/app.ts\"\n *\n * appendPath(\"docs/readme.md\");\n * // returns \"<current_working_directory>/docs/readme.md\"\n *\n * appendPath(\"src/index.ts\", \"/home/user/project\", { skipIfAlreadyParent: false });\n * // returns \"/home/user/project/src/index.ts\"\n *\n * appendPath(\"/home/user/project/src/index.ts\", \"/home/user/project\", { skipIfAlreadyParent: false });\n * // returns \"/home/user/project/src/index.ts\"\n * ```\n *\n * @param childPath - The child path to append to the {@link parentPath}\n * @param parentPath - The parent path to add the {@link childPath} to\n * @param options - Options for appending the path\n * @returns The {@link parentPath} with the {@link childPath} appended\n */\nexport function appendPath(\n  childPath: string,\n  parentPath: string = cwd(),\n  options: AppendPathOptions = {}\n): string {\n  return slash(\n    options.skipIfAlreadyParent !== false && isParentPath(childPath, parentPath)\n      ? childPath\n      : joinPaths(parentPath, childPath)\n  );\n}\n\nexport const append = appendPath;\n\n/**\n * Append the extension to the given path.\n *\n * @example\n * ```ts\n * appendExtension(\"/home/user/project/src/index\", \".ts\");\n * // returns \"/home/user/project/src/index.ts\"\n * appendExtension(\"/home/user/project/src/index.ts\", \".js\");\n * // returns \"/home/user/project/src/index.ts.js\"\n * ```\n *\n * @param path - The path to append the extension to.\n * @param extension - The extension to append.\n * @returns The path with the appended extension.\n */\nexport function appendExtension(path: string, extension: string): string {\n  return `${path}.${extension.replace(/^\\./, \"\")}`;\n}\n"],"mappings":"qKA0DA,SAAgB,EACd,EACA,EAAqB,GAAK,CAC1B,EAA6B,EAAE,CACvB,CACR,OAAO,EACL,EAAQ,sBAAwB,IAAS,EAAa,EAAW,EAAW,CACxE,EACA,EAAU,EAAY,EAAU,CACrC,CAoBH,SAAgB,EAAgB,EAAc,EAA2B,CACvE,MAAO,GAAG,EAAK,GAAG,EAAU,QAAQ,MAAO,GAAG"}

package/dist/path/src/is-parent-path.cjs

@@ -1 +1 @@
-const e=require(`./slash.cjs`);function t(t,n){let r=e.slash(t.replace(/\\/g,`/`).replace(/\/$/,``)),i=e.slash(n.replace(/\\/g,`/`).replace(/\/$/,``));return r!==i&&r.startsWith(`${i}/`)}exports.isParentPath=t;
+const e=require(`./slash.cjs`);function t(t,n){let r=e.slash(t.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase(),i=e.slash(n.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase();return r!==i&&r.startsWith(`${i}/`)}exports.isParentPath=t;

package/dist/path/src/is-parent-path.mjs

@@ -1,2 +1,2 @@
-import{slash as e}from"./slash.mjs";function t(t,n){let r=e(t.replace(/\\/g,`/`).replace(/\/$/,``)),i=e(n.replace(/\\/g,`/`).replace(/\/$/,``));return r!==i&&r.startsWith(`${i}/`)}export{t as isParentPath};
+import{slash as e}from"./slash.mjs";function t(t,n){let r=e(t.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase(),i=e(n.replaceAll(/\\/g,`/`).replace(/\/*$/,``))?.toLowerCase();return r!==i&&r.startsWith(`${i}/`)}export{t as isParentPath};
 //# sourceMappingURL=is-parent-path.mjs.map

package/dist/path/src/is-parent-path.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"is-parent-path.mjs","names":[],"sources":["../../../../path/src/is-parent-path.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { slash } from \"./slash\";\n\n/**\n * Check if a given path is a parent of another path.\n *\n * @example\n * ```ts\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/index.ts\");\n * // returns false\n * ```\n *\n * @param childPath - The path to check if it is a child of the parent path.\n * @param parentPath - The path to check if it is a parent of the child path.\n * @returns `true` if `childPath` is a child of `parentPath`, otherwise `false`.\n */\nexport function isParentPath(childPath: string, parentPath: string): boolean {\n  const normalizedChild = slash(\n    childPath.replace(/\\\\/g, \"/\").replace(/\\/$/, \"\")\n  );\n  const normalizedParent = slash(\n    parentPath.replace(/\\\\/g, \"/\").replace(/\\/$/, \"\")\n  );\n\n  return (\n    normalizedChild !== normalizedParent &&\n    normalizedChild.startsWith(`${normalizedParent}/`)\n  );\n}\n"],"mappings":"oCAyCA,SAAgB,EAAa,EAAmB,EAA6B,CAC3E,IAAM,EAAkB,EACtB,EAAU,QAAQ,MAAO,IAAI,CAAC,QAAQ,MAAO,GAAG,CACjD,CACK,EAAmB,EACvB,EAAW,QAAQ,MAAO,IAAI,CAAC,QAAQ,MAAO,GAAG,CAClD,CAED,OACE,IAAoB,GACpB,EAAgB,WAAW,GAAG,EAAiB,GAAG"}
+{"version":3,"file":"is-parent-path.mjs","names":[],"sources":["../../../../path/src/is-parent-path.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { slash } from \"./slash\";\n\n/**\n * Check if a given path is a parent of another path.\n *\n * @example\n * ```ts\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project\");\n * // returns true\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/other\");\n * // returns false\n * isParentPath(\"/home/user/project/src/index.ts\", \"/home/user/project/src/index.ts\");\n * // returns false\n * ```\n *\n * @param childPath - The path to check if it is a child of the parent path.\n * @param parentPath - The path to check if it is a parent of the child path.\n * @returns `true` if `childPath` is a child of `parentPath`, otherwise `false`.\n */\nexport function isParentPath(childPath: string, parentPath: string): boolean {\n  const normalizedChild = slash(\n    childPath.replaceAll(/\\\\/g, \"/\").replace(/\\/*$/, \"\")\n  )?.toLowerCase();\n  const normalizedParent = slash(\n    parentPath.replaceAll(/\\\\/g, \"/\").replace(/\\/*$/, \"\")\n  )?.toLowerCase();\n\n  return (\n    normalizedChild !== normalizedParent &&\n    normalizedChild.startsWith(`${normalizedParent}/`)\n  );\n}\n"],"mappings":"oCAyCA,SAAgB,EAAa,EAAmB,EAA6B,CAC3E,IAAM,EAAkB,EACtB,EAAU,WAAW,MAAO,IAAI,CAAC,QAAQ,OAAQ,GAAG,CACrD,EAAE,aAAa,CACV,EAAmB,EACvB,EAAW,WAAW,MAAO,IAAI,CAAC,QAAQ,OAAQ,GAAG,CACtD,EAAE,aAAa,CAEhB,OACE,IAAoB,GACpB,EAAgB,WAAW,GAAG,EAAiB,GAAG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stryke/fs",
-  "version": "0.33.22",
+  "version": "0.33.24",
   "type": "module",
   "description": "A package containing various file system utilities that expand the functionality of NodeJs's built-in `fs` module.",
   "repository": {
@@ -103,16 +103,16 @@
     "./*": "./*"
   },
   "types": "./dist/index.d.cts",
-  "peerDependencies": { "nx": "^22.2.7" },
+  "peerDependencies": { "nx": "^22.3.1" },
   "peerDependenciesMeta": { "nx": { "optional": true } },
   "dependencies": {
     "@antfu/install-pkg": "^1.1.0",
     "@ltd/j-toml": "^1.38.0",
-    "@storm-software/config-tools": "^1.188.69",
-    "@stryke/convert": "^0.6.26",
-    "@stryke/helpers": "^0.9.28",
-    "@stryke/path": "^0.22.13",
-    "@stryke/string-format": "^0.12.26",
+    "@storm-software/config-tools": "^1.188.71",
+    "@stryke/convert": "^0.6.28",
+    "@stryke/helpers": "^0.9.30",
+    "@stryke/path": "^0.23.1",
+    "@stryke/string-format": "^0.12.28",
     "chalk": "^5.6.2",
     "defu": "^6.1.4",
     "glob": "^11.1.0",
@@ -124,10 +124,10 @@
   "devDependencies": {
     "@types/node": "^24.10.4",
     "@types/semver": "^7.7.1",
-    "nx": "^22.2.7",
+    "nx": "^22.3.1",
     "tinyexec": "^0.3.2",
     "tsdown": "^0.17.2"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "afcd140cfb0555b3dacd5ece701909f66c174068"
+  "gitHead": "ed86f49867133045cf1eb4626ca513043221d0af"
 }