xjs-node 3.1.1 → 3.2.1

package/README.md

@@ -1,7 +1,7 @@
 [![npm][npm-badge]][npm-url] [![CI][ci-badge]][ci-url] [![publish][publish-badge]][publish-url]
 
 # Overview
-Library modules for nodejs + typescript that bundled general-purpose implementations.  
+Library modules for nodejs + typescript that bundle general-purpose implementations.  
 This module focuses on implementation that extends nodejs builtin modules, and dependency is only [xjs-common](https://github.com/begyyal/xjs_common).
 
 # Install

package/build/func/u-file.d.ts

@@ -6,7 +6,7 @@ export declare namespace UFile {
      * this returns boolean whether mkdir was executed or not.
      */
     function mkdir(p: MaybeArray<string>): boolean;
-    function write(p: MaybeArray<string>, c: string): Promise<void>;
+    function write(p: MaybeArray<string>, c: string | NodeJS.ArrayBufferView): Promise<void>;
     /**
      * remove a file. default is no error if the file to be removed doesn't exist.
      * @param p path of the file. if passed as an array those are joined.
@@ -29,7 +29,11 @@ export declare namespace UFile {
     function readAsJson<T = any>(p: MaybeArray<string>, d?: any, encoding?: BufferEncoding): Promise<T>;
     function cp(from: MaybeArray<string>, to: MaybeArray<string>): Promise<void>;
     function mv(from: MaybeArray<string>, to: MaybeArray<string>): Promise<void>;
-    function ls(p: MaybeArray<string>): string[];
+    function ls(p: MaybeArray<string>, withStats: true): {
+        fname: string;
+        stats: fs.Stats;
+    }[];
+    function ls(p: MaybeArray<string>, withStats?: boolean): string[];
     /**
      * check availability to export a file with specified directory and file name.
      * if it doesn't, this retries to check after appending incremental number to the filename excluding an extension (e.g. `aaa_1.txt`).

package/build/func/u-file.js

@@ -120,11 +120,12 @@ var UFile;
         });
     }
     UFile.mv = mv;
-    function ls(p) {
+    function ls(p, withStats) {
         const pt = (0, u_1.joinPath)(p);
         if (!pt || !fs.statSync(pt).isDirectory())
             throw new xjs_common_1.XjsErr(s_errCode, "Specified path for ls is not directory.");
-        return fs.readdirSync(pt);
+        const fnames = fs.readdirSync(pt);
+        return withStats ? fnames.map(f => ({ fname: f, stats: status([pt, f]) })) : fnames;
     }
     UFile.ls = ls;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "xjs-node",
-  "version": "3.1.1",
-  "description": "library modules for nodejs + typescript that bundled general-purpose implementations.",
+  "version": "3.2.1",
+  "description": "library modules for nodejs + typescript that bundle general-purpose implementations.",
   "repository": {
     "type": "git",
     "url": "https://github.com/begyyal/xjs_node"
@@ -33,7 +33,8 @@
   "devDependencies": {
     "@types/node": "^24.2.1",
     "tsx": "^4.20.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.8.3",
+    "xjs-test": "^1.1.0"
   },
   "dependencies": {
     "xjs-common": "^13.6.1"