@reliverse/relifso 1.4.2 → 1.4.3

package/README.md

@@ -129,6 +129,71 @@ console.log(config); // { hello: 'world' }
 await remove(".reliverse");
 ```
 
+## Run Example
+
+Install this repository locally and run the example by using `bun dev`:
+
+```bash
+$ bun e-mod.ts
+✓   Running examples with Bun...
+Created directory ./tests-runtime
+[env] writeJson was successfully executed in Bun (for JSON)
+Wrote JSON tests-runtime\config.json
+[env] readJson was successfully executed in Bun
+Read JSON {"hello":"world","ts":"2025-06-02T19:01:53.291Z"}
+[env] copy was successfully executed in Bun
+Moved → Copied (with overwrite) tests-runtime\config.old.json → tests-runtime\config.copy.json
+[env] readFile was successfully executed in Bun
+Wrote & read text file Hello Relifso!
+[env] writeFile was successfully executed in Bun
+[env] writeFile was successfully executed in Bun
+Ensured nested & output files
+[env] writeJson was successfully executed in Bun (for JSON)
+[env] readJson was successfully executed in Bun
+writeJson / readJson round-trip {"foo":"bar"}
+[env] writeJson was successfully executed in Bun (for JSONC)
+Wrote JSONC tests-runtime\config.jsonc
+[env] readJson was successfully executed in Bun
+Read JSONC {
+  "name": "relifso",
+  "version": "1.0.0",
+  "features": [
+    "file operations",
+    "directory operations",
+    "JSONC support"
+  ],
+  "settings": {
+    "debug": true,
+    "verbose": false
+  }
+}
+Emptied directory tests-runtime\empty-me
+[env] writeFileSync was successfully executed in Bun
+[env] writeJsonSync was successfully executed in Bun (for JSON)
+Sync JSON round-trip {"sync":true}
+[env] copySync was successfully executed in Bun
+copySync → moveSync → removeSync chain complete
+Directory structure via dive
+ • tests-runtime\config-sync.json
+ • tests-runtime\config.copy.json
+ • tests-runtime\config.jsonc
+ • tests-runtime\config.old.json
+ • tests-runtime\config2.json
+ • tests-runtime\hello.txt
+ • tests-runtime\nested\deep\file.txt
+ • tests-runtime\output-file.txt
+Directory structure via diveSync
+ • tests-runtime\config-sync.json
+ • tests-runtime\config.copy.json
+ • tests-runtime\config.jsonc
+ • tests-runtime\config.old.json
+ • tests-runtime\config2.json
+ • tests-runtime\hello.txt
+ • tests-runtime\nested\deep\file.txt
+ • tests-runtime\output-file.txt
+Removed directory ./tests-runtime
+```
+
 ## Sync vs Async vs Legacy
 
 You choose your flavor:

package/bin/impl/copy.d.ts

@@ -1,7 +1,7 @@
 export interface CopyOptions {
-    /** Whether to overwrite existing files. Default: true */
+    /** @deprecated Use `overwrite` instead. This option will be removed in a future. */
     force?: boolean;
-    /** Whether to overwrite existing files. Alias for force. Default: true */
+    /** Whether to overwrite existing files. Default: true */
     overwrite?: boolean;
     /** @deprecated Use `overwrite`. */
     clobber?: boolean;

package/bin/impl/copy.js

@@ -29,7 +29,7 @@ export function copySync(src, dest, options = {}) {
   const {
     overwrite = options.clobber ?? true,
     force = true,
-    recursive = false,
+    recursive = true,
     dereference = false,
     errorOnExist = false,
     ensureSource = true,
@@ -124,7 +124,7 @@ export async function copy(src, dest, options = {}) {
   const {
     overwrite = options.clobber ?? true,
     force = true,
-    recursive = false,
+    recursive = true,
     dereference = false,
     errorOnExist = false,
     ensureSource = true,

package/bin/impl/move.d.ts

@@ -1,4 +1,7 @@
 export interface MoveOptions {
+    /** @deprecated Use `overwrite` instead. This option will be removed in a future. */
+    force?: boolean;
+    /** Whether to overwrite existing files. Default: false */
     overwrite?: boolean;
     /** @deprecated Use `overwrite`. */
     clobber?: boolean;

package/package.json

@@ -5,7 +5,7 @@
   "license": "MIT",
   "name": "@reliverse/relifso",
   "type": "module",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "keywords": [
     "fs",
     "file",