@gesslar/toolkit 3.17.0 → 3.20.0

package/types/node/index.d.ts

@@ -10,7 +10,7 @@ export { default as Util } from "./lib/Util.js";
 export { default as Cache } from "./lib/Cache.js";
 export { default as DirectoryObject } from "./lib/DirectoryObject.js";
 export { default as FileObject } from "./lib/FileObject.js";
-export { default as FS } from "./lib/FileSystem.js";
+export { default as FileSystem } from "./lib/FileSystem.js";
 export { default as Glog } from "./lib/Glog.js";
 export { default as Notify } from "./lib/Notify.js";
 export { default as TempDirectoryObject } from "./lib/TempDirectoryObject.js";

package/types/node/lib/DirectoryObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirectoryObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/DirectoryObject.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH;IA2DE;;;;;;;;;OASG;IACH,kBALa,eAAe,CAO3B;IA3CD;;;;OAIG;IACH,uBAFW,MAAM,OAAC,EA0BjB;IA2BD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,aALa,KAAK,CAAC,MAAM,CAAC,CAOzB;IAED;;;;;;;;;;;;OAYG;IACH,cARa,eAAe,GAAC,IAAI,CAsBhC;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAmBD;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAZW,MAAM,GACJ,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,GAAC,WAAW,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,GAAC,gBAAgB,CAAC,CAAA;KAAC,CAAC,CA0CjH;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAZW,MAAM,GACJ,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,GAAC,WAAW,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,GAAC,gBAAgB,CAAC,CAAA;KAAC,CAAC,CA6CjH;IAED;;;;;;;;;;;;OAYG;IACH,uBARW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAuBzB;IAyBD;;;;;;;;;;;;;;;OAeG;IACH,cAZa,eAAe,CAc3B;IAED;;;;;;;;;;;;;;OAcG;IACH,UARa,OAAO,CAAC,IAAI,CAAC,CAkBzB;IAED;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAQ5B;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAO5B;IAUD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAdW,MAAM,GACJ,eAAe,CAqB3B;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAbW,MAAM,GACJ,UAAU,GAAC,WAAW,CAsBlC;;CACF;eAxkBc,iBAAiB;uBACT,iBAAiB;wBAGhB,kBAAkB"}
+{"version":3,"file":"DirectoryObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/DirectoryObject.js"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH;IA2DE;;;;;;;;;OASG;IACH,kBALa,eAAe,CAO3B;IA3CD;;;;OAIG;IACH,uBAFW,MAAM,OAAC,EA0BjB;IA2BD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,MAAM,CAIlB;IAED;;;;;;;OAOG;IACH,aALa,KAAK,CAAC,MAAM,CAAC,CAOzB;IAED;;;;;;;;;;;;OAYG;IACH,cARa,eAAe,GAAC,IAAI,CAsBhC;IAED;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAmBD;;;;;;;;;;;;;;;;;;OAkBG;IACH,WAZW,MAAM,GACJ,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,GAAC,WAAW,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,GAAC,gBAAgB,CAAC,CAAA;KAAC,CAAC,CA0CjH;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,WAZW,MAAM,GACJ,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,UAAU,GAAC,WAAW,CAAC,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC,eAAe,GAAC,gBAAgB,CAAC,CAAA;KAAC,CAAC,CAgDjH;IAED;;;;;;;;;;;;OAYG;IACH,uBARW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAuBzB;IAyBD;;;;;;;;;;;;;;;OAeG;IACH,cAZa,eAAe,CAc3B;IAED;;;;;;;;;;;;;;OAcG;IACH,UARa,OAAO,CAAC,IAAI,CAAC,CAkBzB;IAED;;;;;OAKG;IACH,kBAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAQ5B;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAO5B;IAUD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,kBAdW,MAAM,GACJ,eAAe,CAqB3B;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,cAbW,MAAM,GACJ,UAAU,GAAC,WAAW,CAsBlC;;CACF;eA3kBc,iBAAiB;uBACT,iBAAiB;wBAGhB,kBAAkB"}

package/types/node/lib/FileObject.d.ts

@@ -22,6 +22,16 @@ export default class FileObject extends FS {
     static dataLoaderConfig: {
         [key: string]: Array<typeof JSON5 | typeof YAML>;
     };
+    /**
+     * Strip root from absolute path to make it relative.
+     * Used for virtual filesystem path resolution.
+     *
+     * @private
+     * @static
+     * @param {string} pathName - The path to convert
+     * @returns {string} Path with root stripped, or original if already relative
+     */
+    private static "__#private@#absoluteToRelative";
     /**
      * Constructs a FileObject instance.
      *

package/types/node/lib/FileObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/FileObject.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;GAaG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IA0BF;;;;;OAKG;IACH,uBAHW,MAAM,WACN,eAAe,GAAC,MAAM,GAAC,IAAI,EA4DrC;IAaD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IACD;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,cAFa,eAAe,CAI3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,YAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC,MAAM,OAAC,CAAC,CAU5B;IAED;;;;;OAKG;IACH,YAFa,OAAO,CAAC,IAAI,OAAC,CAAC,CAU1B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;;;OAWG;IACH,cARa,OAAO,CAAC,MAAM,CAAC,CAe3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAwBzB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAkC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;OASG;IACH,UAPa,OAAO,CAAC,IAAI,CAAC,CAczB;;CACF;eA5dc,iBAAiB;4BADJ,sBAAsB"}
+{"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/FileObject.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;GAaG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IA0BF;;;;;;;;OAQG;IACH,gDAOC;IAED;;;;;OAKG;IACH,uBAHW,MAAM,WACN,eAAe,GAAC,MAAM,GAAC,IAAI,EA6DrC;IAaD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,GAAG,CAIf;IAED;;;;OAIG;IACH,YAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,cAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,iBAFa,MAAM,CAIlB;IACD;;;;OAIG;IACH,cAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,cAFa,eAAe,CAI3B;IAED;;;;OAIG;IACH,kBAFa,MAAM,CAIlB;IAED;;;;OAIG;IACH,WAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAED;;;;OAIG;IACH,YAFa,OAAO,CAAC,OAAO,CAAC,CAU5B;IAiBD;;;;OAIG;IACH,QAFa,OAAO,CAAC,MAAM,OAAC,CAAC,CAU5B;IAED;;;;;OAKG;IACH,YAFa,OAAO,CAAC,IAAI,OAAC,CAAC,CAU1B;IAED;;;;;OAKG;IACH,gBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;;;OAWG;IACH,cARa,OAAO,CAAC,MAAM,CAAC,CAe3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAwBzB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAiC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAS3B;IAED;;;;;;;;;OASG;IACH,UAPa,OAAO,CAAC,IAAI,CAAC,CAczB;;CACF;eA9ec,iBAAiB;4BADJ,sBAAsB"}

package/types/node/lib/FileSystem.d.ts

@@ -40,7 +40,19 @@ export default class FileSystem {
      * @param {FileObject|DirectoryObject} to - The target file or directory object
      * @returns {string} The relative path from `from` to `to`, or the absolute path if not reachable
      */
-    static relativeOrAbsolutePath(from: FileObject | DirectoryObject, to: FileObject | DirectoryObject): string;
+    static relativeOrAbsolute(from: FileObject | DirectoryObject, to: FileObject | DirectoryObject): string;
+    /**
+     * Computes the relative path from one file or directory to another.
+     *
+     * If the target is outside the source (i.e., the relative path starts with
+     * ".."), returns the absolute path to the target instead.
+     *
+     * @static
+     * @param {string} from - The source file or directory object
+     * @param {string} to - The target file or directory object
+     * @returns {string} The relative path from `from` to `to`, or the absolute path if not reachable
+     */
+    static relativeOrAbsolutePath(from: string, to: string): string;
     /**
      * Merge two paths by finding overlapping segments and combining them
      * efficiently
@@ -156,21 +168,6 @@ export default class FileSystem {
      * FS.virtualToRealPath(regular) // "/home/user/file.txt"
      */
     static virtualToRealPath(fileOrDirectoryObject: FileObject | DirectoryObject): string;
-    /**
-     * Convert an absolute path to a relative format by removing the root component.
-     * By default, keeps a leading separator (making it "absolute-like relative").
-     * Use forceActuallyRelative to get a truly relative path without leading separator.
-     *
-     * @static
-     * @param {string} pathToCheck - The path to convert (returned unchanged if already relative)
-     * @param {boolean} [forceActuallyRelative=false] - If true, removes leading separator for truly relative path
-     * @returns {string} The relative path (with or without leading separator based on forceActuallyRelative)
-     * @example
-     * FS.absoluteToRelative("/home/user/docs") // "/home/user/docs" (with leading /)
-     * FS.absoluteToRelative("/home/user/docs", true) // "home/user/docs" (truly relative)
-     * FS.absoluteToRelative("relative/path") // "relative/path" (unchanged)
-     */
-    static absoluteToRelative(pathToCheck: string, forceActuallyRelative?: boolean): string;
     /**
      * Compute the relative path from another file or directory to this instance.
      *

package/types/node/lib/FileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../../src/node/lib/FileSystem.js"],"names":[],"mappings":"AA0BA;;GAEG;AACH;IACE,kCAAwB;IACxB,uCAAkC;IAClC,mBAAsB;IAsBtB;;;;;;OAMG;IACH,4BAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;;;;;;OAUG;IACH,oCAJW,UAAU,GAAC,eAAe,MAC1B,UAAU,GAAC,eAAe,GACxB,MAAM,CAYlB;IAED;;;;;;;;;OASG;IACH,oCALW,MAAM,SACN,MAAM,QACN,MAAM,GACJ,MAAM,CA0BlB;IAED;;;;;;;;OAQG;IACH,6BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAmClB;IAED;;;;;;;;;;;;OAYG;IACH,+BATW,MAAM,aACN,MAAM,GACJ,OAAO,CAcnB;IAED;;;;;;;;;;;;;;OAcG;IACH,4BATW,MAAM,MACN,MAAM,QACN,MAAM,GACJ,MAAM,GAAC,IAAI,CAwBvB;IAED;;;;;;;;;;;;;;;OAeG;IACH,+BAXW,MAAM,MACN,MAAM,QACN,MAAM,GACJ,MAAM,GAAC,IAAI,CA+BvB;IAED;;;;;OAKG;IAEH;;;;;;;OAOG;IACH,2BAJW,MAAM;;;;cATH,MAAM;;;;aACN,MAAM;;;;aACN,MAAM;MAenB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,gDAZW,UAAU,GAAC,eAAe,GACxB,MAAM,CAiClB;IAED;;;;;;;;;;;;;OAaG;IACH,uCARW,MAAM,0BACN,OAAO,GACL,MAAM,CAkBlB;IA/VD;;;;;;;;;OASG;IACH,kCAJW,UAAU,GAAC,eAAe,GACxB,MAAM,CAWlB;CA8UF;yBAjXa,OAAO,iBAAiB,EAAE,OAAO;8BACjC,OAAO,sBAAsB,EAAE,OAAO"}
+{"version":3,"file":"FileSystem.d.ts","sourceRoot":"","sources":["../../../src/node/lib/FileSystem.js"],"names":[],"mappings":"AA0BA;;GAEG;AACH;IACE,kCAAwB;IACxB,uCAAkC;IAClC,mBAAsB;IAsBtB;;;;;;OAMG;IACH,4BAHW,MAAM,GACJ,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;;;;;;OAUG;IACH,gCAJW,UAAU,GAAC,eAAe,MAC1B,UAAU,GAAC,eAAe,GACxB,MAAM,CAYlB;IAED;;;;;;;;;;OAUG;IACH,oCAJW,MAAM,MACN,MAAM,GACJ,MAAM,CAQlB;IAED;;;;;;;;;OASG;IACH,oCALW,MAAM,SACN,MAAM,QACN,MAAM,GACJ,MAAM,CA0BlB;IAED;;;;;;;;OAQG;IACH,6BAJW,MAAM,UACN,MAAM,GACJ,MAAM,CAmClB;IAED;;;;;;;;;;;;OAYG;IACH,+BATW,MAAM,aACN,MAAM,GACJ,OAAO,CAcnB;IAED;;;;;;;;;;;;;;OAcG;IACH,4BATW,MAAM,MACN,MAAM,QACN,MAAM,GACJ,MAAM,GAAC,IAAI,CAwBvB;IAED;;;;;;;;;;;;;;;OAeG;IACH,+BAXW,MAAM,MACN,MAAM,QACN,MAAM,GACJ,MAAM,GAAC,IAAI,CA+BvB;IAED;;;;;OAKG;IAEH;;;;;;;OAOG;IACH,2BAJW,MAAM;;;;cATH,MAAM;;;;aACN,MAAM;;;;aACN,MAAM;MAenB;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,gDAZW,UAAU,GAAC,eAAe,GACxB,MAAM,CAiClB;IAtVD;;;;;;;;;OASG;IACH,kCAJW,UAAU,GAAC,eAAe,GACxB,MAAM,CAWlB;CAqUF;yBAxWa,OAAO,iBAAiB,EAAE,OAAO;8BACjC,OAAO,sBAAsB,EAAE,OAAO"}

package/types/node/lib/Glog.d.ts

@@ -1,29 +1,32 @@
-export namespace loggerColours {
-    let debug: string[];
-    let info: string;
-    let warn: string;
-    let error: string;
-    let success: string;
-    let reset: string;
-}
-export namespace logSymbols {
-    let debug_1: string;
-    export { debug_1 as debug };
-    let info_1: string;
-    export { info_1 as info };
-    let warn_1: string;
-    export { warn_1 as warn };
-    let error_1: string;
-    export { error_1 as error };
-    let success_1: string;
-    export { success_1 as success };
-}
+/**
+ * Default colour configuration for logger output using @gesslar/colours format
+ *
+ * @type {object}
+ * @property {string[]} debug - Array of 5 colour codes for debug levels 0-4
+ * @property {string} info - Colour code for info messages
+ * @property {string} warn - Colour code for warning messages
+ * @property {string} error - Colour code for error messages
+ * @property {string} success - Colour code for success messages
+ * @property {string} reset - Colour reset code
+ */
+export const loggerColours: object;
+/**
+ * Symbol characters used for log level tags when colours are disabled or tagsAsStrings is false
+ *
+ * @type {object}
+ * @property {string} debug - Symbol for debug messages
+ * @property {string} info - Symbol for info messages
+ * @property {string} warn - Symbol for warning messages
+ * @property {string} error - Symbol for error messages
+ * @property {string} success - Symbol for success messages
+ */
+export const logSymbols: object;
 declare const _default: typeof Glog;
 export default _default;
 declare class Glog {
     static logLevel: number;
     static logPrefix: string;
-    static colors: any;
+    static colours: any;
     static stackTrace: boolean;
     static name: string;
     static tagsAsStrings: boolean;
@@ -49,17 +52,17 @@ declare class Glog {
      */
     static withName(name: string): typeof Glog;
     /**
-     * Enable colors for global usage
-     * Merges with existing color configuration (can pass partial config)
+     * Enable colours for global usage
+     * Merges with existing colour configuration (can pass partial config)
      * Shape: {debug?: string[], info?: string, warn?: string, error?: string, reset?: string}
-     * - debug: Array of 5 color codes [level0, level1, level2, level3, level4]
-     * - info, warn, error, reset: Single color code strings
+     * - debug: Array of 5 colour codes [level0, level1, level2, level3, level4]
+     * - info, warn, error, reset: Single colour code strings
      * Uses @gesslar/colours format like "{F196}"
      *
-     * @param {object} [colors=loggerColours] - Color configuration object (partial or complete)
+     * @param {object} [colours=loggerColours] - Colour configuration object (partial or complete)
      * @returns {typeof Glog} The Glog class for chaining
      */
-    static withColors(colors?: object): typeof Glog;
+    static withColours(colours?: object): typeof Glog;
     /**
      * Enable stack trace extraction for global usage
      *
@@ -74,6 +77,17 @@ declare class Glog {
      * @returns {typeof Glog} The Glog class for chaining
      */
     static withTagsAsStrings(enabled?: boolean): typeof Glog;
+    /**
+     * Create a temporary scoped logger with a custom prefix for a single chain (static version)
+     * The prefix replaces all formatting (name, tags) with just the prefix + message
+     *
+     * @param {string} prefix - Temporary prefix to use (e.g., "=>", "  ", "-->")
+     * @returns {object} Temporary logger with all standard methods
+     * @example
+     * Glog.use("=>").info("Indented message")  // => Indented message
+     * Glog.info("Back to normal")               // [Log] i Back to normal
+     */
+    static use(prefix: string): object;
     /**
      * Create a new Glog instance with fluent configuration
      *
@@ -89,12 +103,12 @@ declare class Glog {
      */
     static execute(...args: unknown[]): void;
     /**
-     * Static version of colorize for global usage
+     * Static version of colourize for global usage
      *
      * @param {Array<string>} strings - Template strings
      * @param {...unknown} values - Template values
      */
-    static colorize(strings: Array<string>, ...values: unknown[]): void;
+    static colourize(strings: Array<string>, ...values: unknown[]): void;
     /**
      * Static success method
      *
@@ -147,50 +161,178 @@ declare class Glog {
         quotedStrings?: boolean;
     }): void;
     /**
-     * Set a color alias for convenient usage
+     * Set a colour alias for convenient usage
      *
      * @param {string} alias - Alias name
-     * @param {string} colorCode - Color code (e.g., "{F196}" or "{<B}")
+     * @param {string} colourCode - Colour code (e.g., "{F196}" or "{<B}")
      * @returns {Glog} The Glog class for chaining.
      */
-    static setAlias(alias: string, colorCode: string): Glog;
+    static setAlias(alias: string, colourCode: string): Glog;
     /**
      * Static raw logger that outputs without name/tag formatting
      *
      * @returns {object} Raw logger interface
+     * @returns {Function} return.debug - Raw debug output function
+     * @returns {Function} return.info - Raw info output function
+     * @returns {Function} return.warn - Raw warning output function
+     * @returns {Function} return.error - Raw error output function
+     * @returns {Function} return.log - Raw log output function
+     * @returns {Function} return.success - Raw success output function
+     * @returns {Function} return.table - Raw table output function
+     * @returns {Function} return.group - Raw group start function
+     * @returns {Function} return.groupEnd - Raw group end function
      */
     static get raw(): object;
-    constructor(options?: {});
-    setOptions(options: any): this;
-    withName(name: any): this;
-    withLogLevel(level: any): this;
-    withPrefix(prefix: any): this;
-    /**
-     * Enable colors for this logger instance
-     * Merges with existing color configuration (can pass partial config)
+    /**
+     * Create a new Glog logger instance with optional configuration
+     *
+     * @param {object} [options={}] - Configuration options
+     * @param {string} [options.name] - Logger name to display in output
+     * @param {number} [options.debugLevel] - Debug verbosity level (0-5, default: 0)
+     * @param {number} [options.logLevel] - Alias for debugLevel
+     * @param {string} [options.prefix] - Prefix to prepend to all log messages
+     * @param {object} [options.colours] - Colour configuration object
+     * @param {boolean} [options.stackTrace=false] - Enable stack trace extraction
+     * @param {boolean} [options.tagsAsStrings=false] - Use string tags instead of symbols
+     * @param {boolean} [options.displayName=true] - Display logger name in output
+     * @param {string} [options.env] - Environment mode ("extension" for VSCode integration)
+     */
+    constructor(options?: {
+        name?: string;
+        debugLevel?: number;
+        logLevel?: number;
+        prefix?: string;
+        colours?: object;
+        stackTrace?: boolean;
+        tagsAsStrings?: boolean;
+        displayName?: boolean;
+        env?: string;
+    });
+    /**
+     * Set configuration options for this logger instance
+     *
+     * @param {object} options - Configuration options
+     * @param {string} [options.name] - Logger name to display in output
+     * @param {number} [options.debugLevel] - Debug verbosity level (0-5)
+     * @param {number} [options.logLevel] - Alias for debugLevel
+     * @param {string} [options.prefix] - Prefix to prepend to all log messages
+     * @param {object} [options.colours] - Colour configuration object
+     * @param {boolean} [options.stackTrace] - Enable stack trace extraction
+     * @param {boolean} [options.tagsAsStrings] - Use string tags instead of symbols
+     * @param {boolean} [options.displayName] - Display logger name in output
+     * @returns {Glog} This Glog instance for chaining
+     */
+    setOptions(options: {
+        name?: string;
+        debugLevel?: number;
+        logLevel?: number;
+        prefix?: string;
+        colours?: object;
+        stackTrace?: boolean;
+        tagsAsStrings?: boolean;
+        displayName?: boolean;
+    }): Glog;
+    /**
+     * Set the logger name for this instance
+     *
+     * @param {string} name - Logger name to display in output
+     * @returns {Glog} This Glog instance for chaining
+     */
+    withName(name: string): Glog;
+    /**
+     * Set the log level for this instance (0-5)
+     *
+     * @param {number} level - Log level (0 = off, 1-5 = increasing verbosity)
+     * @returns {Glog} This Glog instance for chaining
+     */
+    withLogLevel(level: number): Glog;
+    /**
+     * Set the log prefix for this instance
+     *
+     * @param {string} prefix - Prefix to prepend to all log messages
+     * @returns {Glog} This Glog instance for chaining
+     */
+    withPrefix(prefix: string): Glog;
+    /**
+     * Enable colours for this logger instance
+     * Merges with existing colour configuration (can pass partial config)
      * Shape: {debug?: string[], info?: string, warn?: string, error?: string, reset?: string}
-     * - debug: Array of 5 color codes [level0, level1, level2, level3, level4]
-     * - info, warn, error, reset: Single color code strings
+     * - debug: Array of 5 colour codes [level0, level1, level2, level3, level4]
+     * - info, warn, error, reset: Single colour code strings
      * Uses @gesslar/colours format like "{F196}"
      *
-     * @param {object} [colors=loggerColours] - Color configuration object (partial or complete)
+     * @param {object} [colours=loggerColours] - Colour configuration object (partial or complete)
+     * @returns {Glog} This Glog instance for chaining
+     */
+    withColours(colours?: object): Glog;
+    /**
+     * Enable or disable stack trace extraction for this instance
+     *
+     * @param {boolean} [enabled=true] - Whether to enable stack traces
+     * @returns {Glog} This Glog instance for chaining
+     */
+    withStackTrace(enabled?: boolean): Glog;
+    /**
+     * Use tag names as strings instead of symbols for this instance
+     *
+     * @param {boolean} [enabled=false] - Whether to use string tags
+     * @returns {Glog} This Glog instance for chaining
+     */
+    withTagsAsStrings(enabled?: boolean): Glog;
+    /**
+     * Disable displaying the logger name in output for this instance
+     *
      * @returns {Glog} This Glog instance for chaining
      */
-    withColors(colors?: object): Glog;
-    withStackTrace(enabled?: boolean): this;
-    withTagsAsStrings(enabled?: boolean): this;
-    noDisplayName(): this;
+    noDisplayName(): Glog;
+    /**
+     * Create a temporary scoped logger with a custom prefix for a single chain
+     * The prefix replaces all formatting (name, tags) with just the prefix + message
+     *
+     * @param {string} prefix - Temporary prefix to use (e.g., "=>", "  ", "-->")
+     * @returns {object} Temporary logger with all standard methods
+     * @example
+     * logger.use("=>").info("Indented message")  // => Indented message
+     * logger.info("Back to normal")               // [MyApp] i Back to normal
+     */
+    use(prefix: string): object;
+    /**
+     * Get the current logger name
+     *
+     * @returns {string} The logger name
+     */
     get name(): string;
+    /**
+     * Get the current debug level
+     *
+     * @returns {number} The debug level (0-5)
+     */
     get debugLevel(): number;
-    get options(): {
-        name: string;
-        debugLevel: number;
-        prefix: string;
-        colors: any;
-        stackTrace: boolean;
-    };
-    extractFileFunction(): string;
-    newDebug(tag: any): any;
+    /**
+     * Get the current logger options configuration
+     *
+     * @returns {object} The logger options
+     * @returns {string} return.name - Logger name
+     * @returns {number} return.debugLevel - Debug level
+     * @returns {string} return.prefix - Log prefix
+     * @returns {object} return.colours - Colour configuration
+     * @returns {boolean} return.stackTrace - Stack trace enabled
+     */
+    get options(): object;
+    /**
+     * Extract file and function information from stack trace
+     *
+     * @private
+     * @returns {string} Caller tag
+     */
+    private extractFileFunction;
+    /**
+     * Create a new debug function with a specific tag
+     *
+     * @param {string} tag - Tag to prepend to debug messages
+     * @returns {Function} Debug function with the tag
+     */
+    newDebug(tag: string): Function;
     /**
      * Log a debug message with specified verbosity level.
      * Level 0 means debug OFF - use levels 1-4 for actual debug output.
@@ -202,20 +344,44 @@ declare class Glog {
      * @throws {Error} If level < 1 (level 0 = debug OFF)
      */
     debug(message: string, level?: number, ...arg: unknown[]): void;
-    info(message: any, ...arg: any[]): void;
-    warn(message: any, ...arg: any[]): void;
-    error(message: any, ...arg: any[]): void;
-    execute(...args: any[]): void;
     /**
-     * Log a colorized message using template literals
+     * Log an informational message
+     *
+     * @param {string} message - Info message to log
+     * @param {...unknown} arg - Additional arguments to log
+     */
+    info(message: string, ...arg: unknown[]): void;
+    /**
+     * Log a warning message
+     *
+     * @param {string} message - Warning message to log
+     * @param {...unknown} arg - Additional arguments to log
+     */
+    warn(message: string, ...arg: unknown[]): void;
+    /**
+     * Log an error message
+     *
+     * @param {string} message - Error message to log
+     * @param {...unknown} arg - Additional arguments to log
+     */
+    error(message: string, ...arg: unknown[]): void;
+    /**
+     * Instance execute method for configured loggers
+     * Can be called as: logger(data) or logger(level, data)
+     *
+     * @param {...unknown} args - Arguments (optional level number, then data)
+     */
+    execute(...args: unknown[]): void;
+    /**
+     * Log a colourized message using template literals
      *
      * @param {Array<string>} strings - Template strings
      * @param {...unknown} values - Template values
-     * @example logger.colorize`{success}Operation completed{/} in {bold}${time}ms{/}`
+     * @example logger.colourize`{success}Operation completed{/} in {bold}${time}ms{/}`
      */
-    colorize(strings: Array<string>, ...values: unknown[]): void;
+    colourize(strings: Array<string>, ...values: unknown[]): void;
     /**
-     * Log a success message with green color
+     * Log a success message with green colour
      *
      * @param {string} message - Success message
      * @param {...unknown} args - Additional arguments
@@ -275,6 +441,15 @@ declare class Glog {
      * Get a raw logger that outputs without name/tag formatting
      *
      * @returns {object} Raw logger interface
+     * @returns {Function} return.debug - Raw debug output function
+     * @returns {Function} return.info - Raw info output function
+     * @returns {Function} return.warn - Raw warning output function
+     * @returns {Function} return.error - Raw error output function
+     * @returns {Function} return.log - Raw log output function
+     * @returns {Function} return.success - Raw success output function
+     * @returns {Function} return.table - Raw table output function
+     * @returns {Function} return.group - Raw group start function
+     * @returns {Function} return.groupEnd - Raw group end function
      */
     get raw(): object;
     #private;

package/types/node/lib/Glog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Glog.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Glog.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAuDA;IAEE,wBAAmB;IACnB,yBAAqB;IACrB,mBAAoB;IACpB,2BAAyB;IACzB,oBAAgB;IAChB,8BAA4B;IAgD5B;;;;;OAKG;IACH,4BAHW,MAAM,GACJ,OAAO,IAAI,CAMvB;IAED;;;;;OAKG;IACH,0BAHW,MAAM,GACJ,OAAO,IAAI,CAMvB;IAED;;;;;OAKG;IACH,sBAHW,MAAM,GACJ,OAAO,IAAI,CAMvB;IAED;;;;;;;;;;OAUG;IACH,2BAHW,MAAM,GACJ,OAAO,IAAI,CAMvB;IAED;;;;;OAKG;IACH,gCAHW,OAAO,GACL,OAAO,IAAI,CAMvB;IAED;;;;;OAKG;IACH,mCAHW,OAAO,GACL,OAAO,IAAI,CAMvB;IAID;;;;;OAKG;IACH,wBAHW,MAAM,GACJ,IAAI,CAIhB;IAuLD;;;;;OAKG;IACH,wBAFc,OAAO,EAAA,QAsBpB;IAuBD;;;;;OAKG;IACH,yBAHW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAOpB;IAYD;;;;;OAKG;IACH,wBAHW,MAAM,WACH,OAAO,EAAA,QAapB;IAED;;;;OAIG;IACH,sBAFc,OAAO,EAAA,QAOpB;IAED;;OAEG;IACH,wBAEC;IAED;;;;;OAKG;IACH,2BAHW,MAAM,UACN,MAAM,QAahB;IAED;;;;OAIG;IACH,0BAFW,MAAM,QAYhB;IAED;;;;OAIG;IACH,6BAFW,MAAM,QAWhB;IAyFD;;;;;;;;;OASG;IACH,mBAPW,MAAM,QAAQ,mBACd,MAAM,GAAG,MAAM,YAEvB;QAAgC,UAAU,GAAlC,KAAK,CAAC,MAAM,CAAC;QACK,UAAU,GAA5B,OAAO;QACW,aAAa,GAA/B,OAAO;KACjB,QAkBA;IAED;;;;;;OAMG;IACH,uBAJW,MAAM,aACN,MAAM,GACJ,IAAI,CAMhB;IA8BD;;;;OAIG;IACH,kBAFa,MAAM,CAclB;IAhoBD,0BAgBC;IAID,+BAUC;IA6FD,0BAIC;IAED,+BAIC;IAED,8BAIC;IAED;;;;;;;;;;OAUG;IACH,oBAHW,MAAM,GACJ,IAAI,CAMhB;IAED,wCAIC;IAED,2CAIC;IAED,sBAIC;IAID,mBAEC;IAED,yBAEC;IAED;;;;;;MAQC;IA8BD,8BAGC;IAED,wBAQC;IA8BD;;;;;;;;;OASG;IACH,eALW,MAAM,UACN,MAAM,UACH,OAAO,EAAA,QAapB;IAED,wCAGC;IAED,wCAGC;IAED,yCAGC;IA+BD,8BAEC;IAID;;;;;;OAMG;IACH,kBAJW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAQpB;IAeD;;;;;OAKG;IACH,iBAHW,MAAM,WACH,OAAO,EAAA,QAIpB;IA4FD;;;;OAIG;IACH,eAFc,OAAO,EAAA,QASpB;IAED;;OAEG;IACH,iBAEC;IAED;;;;;OAKG;IACH,oBAHW,MAAM,UACN,MAAM,QAIhB;IAED;;;;OAIG;IACH,mBAFW,MAAM,QAIhB;IAED;;;;OAIG;IACH,sBAFW,MAAM,QAahB;IAED;;;;;;;;;OASG;IACH,YAPW,MAAM,QAAQ,mBACd,MAAM,GAAG,MAAM,YAEvB;QAAgC,UAAU,GAAlC,KAAK,CAAC,MAAM,CAAC;QACK,UAAU,GAA5B,OAAO;QACW,aAAa,GAA/B,OAAO;KACjB,QAkBA;IA4CD;;;;OAIG;IACH,mBAEC;IAED;;;;OAIG;IACH,WAFa,MAAM,CAclB;;CAoBF"}
+{"version":3,"file":"Glog.d.ts","sourceRoot":"","sources":["../../../src/node/lib/Glog.js"],"names":[],"mappings":"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"}

package/types/node/lib/VFileObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VFileObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/VFileObject.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;IAGE;;;;;OAKG;IACH,sBAHW,MAAM,UACN,gBAAgB,EAc1B;IAED,yBAEC;IAED,uBAEC;;CACF;uBAtDsB,iBAAiB"}
+{"version":3,"file":"VFileObject.d.ts","sourceRoot":"","sources":["../../../src/node/lib/VFileObject.js"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;IAGE;;;;;OAKG;IACH,sBAHW,MAAM,UACN,gBAAgB,EAa1B;IAED,yBAEC;IAED,uBAEC;;CACF;uBArDsB,iBAAiB"}