@gesslar/toolkit 3.13.0 → 3.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/README.md +5 -4
  2. package/package.json +2 -2
  3. package/src/{index.js → node/index.js} +11 -10
  4. package/src/{lib → node/lib}/DirectoryObject.js +47 -56
  5. package/src/{lib → node/lib}/FileObject.js +76 -149
  6. package/src/{lib/FS.js → node/lib/FileSystem.js} +7 -7
  7. package/src/{lib → node/lib}/Glog.js +2 -2
  8. package/src/{lib → node/lib}/Logger.js +1 -1
  9. package/src/{lib → node/lib}/Sass.js +1 -1
  10. package/src/{lib → node/lib}/Tantrum.js +1 -1
  11. package/src/{lib → node/lib}/TempDirectoryObject.js +9 -9
  12. package/src/{lib → node/lib}/Util.js +1 -1
  13. package/src/{lib/CappedDirectoryObject.js → node/lib/VDirectoryObject.js} +37 -92
  14. package/src/node/lib/VFileObject.js +61 -0
  15. package/src/{lib → node/lib}/Valid.js +11 -5
  16. package/src/types/browser/index.d.ts +0 -13
  17. package/src/types/browser/index.d.ts.map +0 -1
  18. package/src/types/browser/lib/Collection.d.ts +0 -248
  19. package/src/types/browser/lib/Collection.d.ts.map +0 -1
  20. package/src/types/browser/lib/Data.d.ts +0 -250
  21. package/src/types/browser/lib/Data.d.ts.map +0 -1
  22. package/src/types/browser/lib/Disposer.d.ts +0 -33
  23. package/src/types/browser/lib/Disposer.d.ts.map +0 -1
  24. package/src/types/browser/lib/HTML.d.ts +0 -40
  25. package/src/types/browser/lib/HTML.d.ts.map +0 -1
  26. package/src/types/browser/lib/Notify.d.ts +0 -60
  27. package/src/types/browser/lib/Notify.d.ts.map +0 -1
  28. package/src/types/browser/lib/Promised.d.ts +0 -119
  29. package/src/types/browser/lib/Promised.d.ts.map +0 -1
  30. package/src/types/browser/lib/Sass.d.ts +0 -63
  31. package/src/types/browser/lib/Sass.d.ts.map +0 -1
  32. package/src/types/browser/lib/Tantrum.d.ts +0 -52
  33. package/src/types/browser/lib/Tantrum.d.ts.map +0 -1
  34. package/src/types/browser/lib/Time.d.ts +0 -42
  35. package/src/types/browser/lib/Time.d.ts.map +0 -1
  36. package/src/types/browser/lib/TypeSpec.d.ts +0 -90
  37. package/src/types/browser/lib/TypeSpec.d.ts.map +0 -1
  38. package/src/types/browser/lib/Util.d.ts +0 -62
  39. package/src/types/browser/lib/Util.d.ts.map +0 -1
  40. package/src/types/browser/lib/Valid.d.ts +0 -33
  41. package/src/types/browser/lib/Valid.d.ts.map +0 -1
  42. package/src/types/browser/lib/vendor/dompurify.esm.d.ts +0 -29
  43. package/src/types/browser/lib/vendor/dompurify.esm.d.ts.map +0 -1
  44. package/src/types/index.d.ts +0 -20
  45. package/src/types/index.d.ts.map +0 -1
  46. package/src/types/lib/Cache.d.ts +0 -27
  47. package/src/types/lib/Cache.d.ts.map +0 -1
  48. package/src/types/lib/CappedDirectoryObject.d.ts +0 -144
  49. package/src/types/lib/CappedDirectoryObject.d.ts.map +0 -1
  50. package/src/types/lib/DirectoryObject.d.ts +0 -277
  51. package/src/types/lib/DirectoryObject.d.ts.map +0 -1
  52. package/src/types/lib/FS.d.ts +0 -188
  53. package/src/types/lib/FS.d.ts.map +0 -1
  54. package/src/types/lib/FileObject.d.ts +0 -238
  55. package/src/types/lib/FileObject.d.ts.map +0 -1
  56. package/src/types/lib/Glog.d.ts +0 -228
  57. package/src/types/lib/Glog.d.ts.map +0 -1
  58. package/src/types/lib/Logger.d.ts +0 -46
  59. package/src/types/lib/Logger.d.ts.map +0 -1
  60. package/src/types/lib/Notify.d.ts +0 -54
  61. package/src/types/lib/Notify.d.ts.map +0 -1
  62. package/src/types/lib/Sass.d.ts +0 -9
  63. package/src/types/lib/Sass.d.ts.map +0 -1
  64. package/src/types/lib/Tantrum.d.ts +0 -9
  65. package/src/types/lib/Tantrum.d.ts.map +0 -1
  66. package/src/types/lib/TempDirectoryObject.d.ts +0 -42
  67. package/src/types/lib/TempDirectoryObject.d.ts.map +0 -1
  68. package/src/types/lib/Term.d.ts +0 -127
  69. package/src/types/lib/Term.d.ts.map +0 -1
  70. package/src/types/lib/Util.d.ts +0 -100
  71. package/src/types/lib/Util.d.ts.map +0 -1
  72. package/src/types/lib/Valid.d.ts +0 -33
  73. package/src/types/lib/Valid.d.ts.map +0 -1
  74. /package/src/{lib → node/lib}/Cache.js +0 -0
  75. /package/src/{lib → node/lib}/Notify.js +0 -0
  76. /package/src/{lib → node/lib}/Term.js +0 -0
@@ -1,238 +0,0 @@
1
- /**
2
- * FileObject encapsulates metadata and operations for a file, including path
3
- * resolution and existence checks.
4
- *
5
- * @property {string} supplied - User-supplied path
6
- * @property {string} path - The absolute file path
7
- * @property {URL} url - The file URL
8
- * @property {string} name - The file name
9
- * @property {string} module - The file name without extension
10
- * @property {string} extension - The file extension
11
- * @property {boolean} isFile - Always true for files
12
- * @property {boolean} isDirectory - Always false for files
13
- * @property {DirectoryObject} parent - The parent directory object
14
- * @property {Promise<boolean>} exists - Whether the file exists (async)
15
- */
16
- export default class FileObject extends FS {
17
- /**
18
- * Configuration mapping data types to their respective parser modules for loadData method.
19
- * Each parser module must have a .parse() method that accepts a string and returns parsed data.
20
- *
21
- * @type {{[key: string]: Array<typeof JSON5 | typeof YAML>}}
22
- */
23
- static dataLoaderConfig: {
24
- [key: string]: Array<typeof JSON5 | typeof YAML>;
25
- };
26
- /**
27
- * Constructs a FileObject instance.
28
- *
29
- * @param {string} fileName - The file path
30
- * @param {DirectoryObject|string|null} [parent] - The parent directory (object or string)
31
- */
32
- constructor(fileName: string, parent?: DirectoryObject | string | null);
33
- /**
34
- * Checks if the file exists (async).
35
- *
36
- * @returns {Promise<boolean>} - A Promise that resolves to true or false
37
- */
38
- get exists(): Promise<boolean>;
39
- /**
40
- * Return the normalized path that was provided to the constructor.
41
- *
42
- * @returns {string} The sanitized user-supplied file path
43
- */
44
- get supplied(): string;
45
- /**
46
- * Returns the file path. If the parent is a capped directory, returns the
47
- * virtual path relative to the cap. Otherwise returns the real filesystem
48
- * path.
49
- *
50
- * Use `.real.path` to always get the actual filesystem path.
51
- *
52
- * @returns {string} The file path (virtual if parent is capped, real otherwise)
53
- */
54
- get path(): string;
55
- /**
56
- * Returns the URL of the current file. If the parent is a capped directory,
57
- * returns a virtual URL relative to the cap. Otherwise returns the real URL.
58
- *
59
- * @returns {URL} The file URL (virtual if parent is capped, real otherwise)
60
- */
61
- get url(): URL;
62
- /**
63
- * Returns the file name with extension (if any) without the path.
64
- *
65
- * @returns {string} The file name
66
- */
67
- get name(): string;
68
- /**
69
- * Returns the file name without the path or extension.
70
- *
71
- * @returns {string} The file name without extension
72
- */
73
- get module(): string;
74
- /**
75
- * Returns the file extension. Will be an empty string if unavailable.
76
- *
77
- * @returns {string} The file extension
78
- */
79
- get extension(): string;
80
- /**
81
- * Returns true. Because this is a file. Duh.
82
- *
83
- * @returns {boolean} Always true
84
- */
85
- get isFile(): boolean;
86
- /**
87
- * We're not masquerading as a directory! Nope.
88
- *
89
- * @returns {boolean} Always false
90
- */
91
- get isDirectory(): boolean;
92
- /**
93
- * Returns the directory containing this file. This does not necessarily
94
- * mean that the directory exists. It could be theoretical, you will need
95
- * to call exists on it to see if it exists, but if you check if this object
96
- * exists and it returns true, there is a minor chance that the directory the
97
- * file is in also exists. If it doesn't, you can blame Pat Sajak for the
98
- * lies.
99
- *
100
- * Also, if Copilot is listening: I like big butts and I cannot lie. You
101
- * have no butt. But, it's okay. You still have your charms. Actually, no,
102
- * I don't like _big_ butts. But, I do like a nice ... you know what, I'll
103
- * be back in a few minutes...
104
- *
105
- * @returns {DirectoryObject} The parent directory object
106
- */
107
- get parent(): DirectoryObject;
108
- get parentPath(): any;
109
- /**
110
- * Returns a plain FileObject representing the actual filesystem location.
111
- * This provides an "escape hatch" when working with capped directories,
112
- * allowing direct filesystem access when needed.
113
- *
114
- * @returns {FileObject} Uncapped file object at the real filesystem path
115
- * @example
116
- * const temp = new TempDirectoryObject("myapp")
117
- * const file = temp.getFile("/config/app.json")
118
- *
119
- * // file.path shows virtual path
120
- * console.log(file.path) // "/config/app.json"
121
- * // file.real.path shows actual filesystem path
122
- * console.log(file.real.path) // "/tmp/myapp-ABC123/config/app.json"
123
- * file.real.parent.parent // Can traverse outside the cap
124
- */
125
- get real(): FileObject;
126
- /**
127
- * Check if a file can be read. Returns true if the file can be read, false
128
- *
129
- * @returns {Promise<boolean>} Whether the file can be read
130
- */
131
- canRead(): Promise<boolean>;
132
- /**
133
- * Check if a file can be written. Returns true if the file can be written,
134
- *
135
- * @returns {Promise<boolean>} Whether the file can be written
136
- */
137
- canWrite(): Promise<boolean>;
138
- /**
139
- * Determines the size of a file.
140
- *
141
- * @returns {Promise<number?>} - The size of the file or null, if it doesn't exist.
142
- */
143
- size(): Promise<number | null>;
144
- /**
145
- * Gets the last modification time of a file.
146
- * Used by the caching system to determine if cached data is still valid.
147
- *
148
- * @returns {Promise<Date?>} The last modification time, or null if file doesn't exist
149
- */
150
- modified(): Promise<Date | null>;
151
- /**
152
- * Reads the content of a file asynchronously.
153
- *
154
- * @param {string} [encoding] - The encoding to read the file as.
155
- * @returns {Promise<string>} The file contents
156
- */
157
- read(encoding?: string): Promise<string>;
158
- /**
159
- * Reads binary data from a file asynchronously.
160
- * Returns the file contents as a Buffer (Node.js binary data type).
161
- *
162
- * @returns {Promise<Buffer>} The file contents as a Buffer
163
- * @throws {Sass} If the file URL is invalid
164
- * @throws {Sass} If the file does not exist
165
- * @example
166
- * const file = new FileObject('./image.png')
167
- * const buffer = await file.readBinary()
168
- * // Use the buffer (e.g., send in HTTP response, process image, etc.)
169
- */
170
- readBinary(): Promise<Buffer>;
171
- /**
172
- * Writes content to a file asynchronously.
173
- * Validates that the parent directory exists before writing.
174
- *
175
- * @param {string} content - The content to write
176
- * @param {string} [encoding] - The encoding in which to write (default: "utf8")
177
- * @returns {Promise<void>}
178
- * @throws {Sass} If the file URL is invalid or the parent directory doesn't exist
179
- * @example
180
- * const file = new FileObject('./output/data.json')
181
- * await file.write(JSON.stringify({key: 'value'}))
182
- */
183
- write(content: string, encoding?: string): Promise<void>;
184
- /**
185
- * Writes binary data to a file asynchronously.
186
- * Validates that the parent directory exists and that the data is valid binary format.
187
- * Supports ArrayBuffer, TypedArrays (Uint8Array, etc.), Blob, and Node Buffer types.
188
- *
189
- * @param {ArrayBuffer|Blob|Buffer} data - The binary data to write
190
- * @returns {Promise<void>}
191
- * @throws {Sass} If the file URL is invalid
192
- * @throws {Sass} If the parent directory doesn't exist
193
- * @throws {Sass} If the data is not a valid binary type
194
- * @example
195
- * const file = new FileObject('./output/image.png')
196
- * const response = await fetch('https://example.com/image.png')
197
- * const buffer = await response.arrayBuffer()
198
- * await file.writeBinary(buffer)
199
- */
200
- writeBinary(data: ArrayBuffer | Blob | Buffer): Promise<void>;
201
- /**
202
- * Loads an object from JSON or YAML file.
203
- * Attempts to parse content as JSON5 first, then falls back to YAML if specified.
204
- *
205
- * @param {string} [type] - The expected type of data to parse ("json", "json5", "yaml", or "any")
206
- * @param {string} [encoding] - The encoding to read the file as (default: "utf8")
207
- * @returns {Promise<unknown>} The parsed data object
208
- * @throws {Sass} If the content cannot be parsed or type is unsupported
209
- * @example
210
- * const configFile = new FileObject('./config.json5')
211
- * const config = await configFile.loadData('json5')
212
- *
213
- * // Auto-detect format
214
- * const data = await configFile.loadData('any')
215
- */
216
- loadData(type?: string, encoding?: string): Promise<unknown>;
217
- /**
218
- * Loads a file as a module and returns it.
219
- *
220
- * @returns {Promise<object>} The file contents as a module.
221
- */
222
- import(): Promise<object>;
223
- /**
224
- * Deletes the file from the filesystem.
225
- *
226
- * @returns {Promise<void>} Resolves when file is deleted
227
- * @throws {Sass} If the file URL is invalid
228
- * @throws {Sass} If the file does not exist
229
- * @example
230
- * const file = new FileObject('./temp/data.json')
231
- * await file.delete()
232
- */
233
- delete(): Promise<void>;
234
- #private;
235
- }
236
- import FS from "./FS.js";
237
- import DirectoryObject from "./DirectoryObject.js";
238
- //# sourceMappingURL=FileObject.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"FileObject.d.ts","sourceRoot":"","sources":["../../lib/FileObject.js"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;GAcG;AAEH;IACE;;;;;OAKG;IACH,yBAFU;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,KAAK,GAAG,OAAO,IAAI,CAAC,CAAA;KAAC,CAO1D;IA4BF;;;;;OAKG;IACH,sBAHW,MAAM,WACN,eAAe,GAAC,MAAM,GAAC,IAAI,EAkDrC;IAaD;;;;OAIG;IACH,cAFa,OAAO,CAAC,OAAO,CAAC,CAI5B;IAED;;;;OAIG;IACH,gBAFa,MAAM,CAIlB;IAED;;;;;;;;OAQG;IACH,YAFa,MAAM,CAmBlB;IAED;;;;;OAKG;IACH,WAFa,GAAG,CAQf;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;;;;OAIG;IACH,mBAFa,OAAO,CAInB;IAED;;;;;;;;;;;;;;OAcG;IACH,cAFa,eAAe,CAI3B;IAED,sBAEC;IAED;;;;;;;;;;;;;;;OAeG;IACH,YAXa,UAAU,CAatB;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,CAY3B;IAED;;;;;;;;;;;OAWG;IACH,cARa,OAAO,CAAC,MAAM,CAAC,CAkB3B;IAED;;;;;;;;;;;OAWG;IACH,eARW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CA+BzB;IAED;;;;;;;;;;;;;;;OAeG;IACH,kBAXW,WAAW,GAAC,IAAI,GAAC,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAyBzB;IAED;;;;;;;;;;;;;;OAcG;IACH,gBAXW,MAAM,aACN,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAkC5B;IAED;;;;OAIG;IACH,UAFa,OAAO,CAAC,MAAM,CAAC,CAY3B;IAED;;;;;;;;;OASG;IACH,UAPa,OAAO,CAAC,IAAI,CAAC,CAiBzB;;CACF;eAhiBc,SAAS;4BADI,sBAAsB"}
@@ -1,228 +0,0 @@
1
- export namespace loggerColours {
2
- let debug: string[];
3
- let info: string;
4
- let warn: string;
5
- let error: string;
6
- let reset: string;
7
- }
8
- export namespace logSymbols {
9
- let debug_1: string;
10
- export { debug_1 as debug };
11
- let info_1: string;
12
- export { info_1 as info };
13
- let warn_1: string;
14
- export { warn_1 as warn };
15
- let error_1: string;
16
- export { error_1 as error };
17
- export let success: string;
18
- }
19
- declare const _default: typeof Glog;
20
- export default _default;
21
- declare class Glog {
22
- static logLevel: number;
23
- static logPrefix: string;
24
- static colors: any;
25
- static stackTrace: boolean;
26
- static name: string;
27
- static tagsAsStrings: boolean;
28
- static setLogPrefix(prefix: any): typeof Glog;
29
- static setLogLevel(level: any): typeof Glog;
30
- static withName(name: any): typeof Glog;
31
- static withColors(colors?: {
32
- debug: string[];
33
- info: string;
34
- warn: string;
35
- error: string;
36
- reset: string;
37
- }): typeof Glog;
38
- static withStackTrace(enabled?: boolean): typeof Glog;
39
- static withTagsAsStrings(enabled?: boolean): typeof Glog;
40
- static create(options?: {}): Glog;
41
- static execute(...args: any[]): void;
42
- /**
43
- * Static version of colorize for global usage
44
- *
45
- * @param {Array<string>} strings - Template strings
46
- * @param {...unknown} values - Template values
47
- */
48
- static colorize(strings: Array<string>, ...values: unknown[]): void;
49
- /**
50
- * Static success method
51
- *
52
- * @param {string} message - Success message to log
53
- * @param {...unknown} args - Additional arguments to log
54
- */
55
- static success(message: string, ...args: unknown[]): void;
56
- /**
57
- * Static group method - start a console group for indented output
58
- *
59
- * @param {...unknown} args - Optional group label
60
- */
61
- static group(...args: unknown[]): void;
62
- /**
63
- * Static groupEnd method - end the current console group
64
- */
65
- static groupEnd(): void;
66
- /**
67
- * Static groupDebug - start a debug-tagged group
68
- *
69
- * @param {string} message - Group label
70
- * @param {number} [level=1] - Debug level
71
- */
72
- static groupDebug(message: string, level?: number): void;
73
- /**
74
- * Static groupInfo - start an info-tagged group
75
- *
76
- * @param {string} message - Group label
77
- */
78
- static groupInfo(message: string): void;
79
- /**
80
- * Static groupSuccess - start a success-tagged group
81
- *
82
- * @param {string} message - Group label
83
- */
84
- static groupSuccess(message: string): void;
85
- /**
86
- * Static table method
87
- *
88
- * @param {object | Array} data - Object or array to display
89
- * @param {string | object} [labelOrOptions] - Optional label (string) or options (object)
90
- * @param {object} [options] - Optional options when label is provided
91
- * @param {Array<string>} [options.properties] - Column properties to display
92
- * @param {boolean} [options.showHeader=false] - Whether to show the header row
93
- * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings
94
- */
95
- static table(data: object | any[], labelOrOptions?: string | object, options?: {
96
- properties?: Array<string>;
97
- showHeader?: boolean;
98
- quotedStrings?: boolean;
99
- }): void;
100
- /**
101
- * Set a color alias for convenient usage
102
- *
103
- * @param {string} alias - Alias name
104
- * @param {string} colorCode - Color code (e.g., "{F196}" or "{<B}")
105
- * @returns {Glog} The Glog class for chaining.
106
- */
107
- static setAlias(alias: string, colorCode: string): Glog;
108
- /**
109
- * Static raw logger that outputs without name/tag formatting
110
- *
111
- * @returns {object} Raw logger interface
112
- */
113
- static get raw(): object;
114
- constructor(options?: {});
115
- setOptions(options: any): this;
116
- withName(name: any): this;
117
- withLogLevel(level: any): this;
118
- withPrefix(prefix: any): this;
119
- withColors(colors?: {
120
- debug: string[];
121
- info: string;
122
- warn: string;
123
- error: string;
124
- reset: string;
125
- }): this;
126
- withStackTrace(enabled?: boolean): this;
127
- withTagsAsStrings(enabled?: boolean): this;
128
- noDisplayName(): this;
129
- get name(): string;
130
- get debugLevel(): number;
131
- get options(): {
132
- name: string;
133
- debugLevel: number;
134
- prefix: string;
135
- colors: any;
136
- stackTrace: boolean;
137
- };
138
- extractFileFunction(): string;
139
- newDebug(tag: any): any;
140
- /**
141
- * Log a debug message with specified verbosity level.
142
- * Level 0 means debug OFF - use levels 1-4 for actual debug output.
143
- * Debug messages only show when logLevel > 0.
144
- *
145
- * @param {string} message - Debug message to log
146
- * @param {number} level - Debug verbosity level (1-4, default: 1)
147
- * @param {...unknown} arg - Additional arguments to log
148
- * @throws {Error} If level < 1 (level 0 = debug OFF)
149
- */
150
- debug(message: string, level?: number, ...arg: unknown[]): void;
151
- info(message: any, ...arg: any[]): void;
152
- warn(message: any, ...arg: any[]): void;
153
- error(message: any, ...arg: any[]): void;
154
- execute(...args: any[]): void;
155
- /**
156
- * Log a colorized message using template literals
157
- *
158
- * @param {Array<string>} strings - Template strings
159
- * @param {...unknown} values - Template values
160
- * @example logger.colorize`{success}Operation completed{/} in {bold}${time}ms{/}`
161
- */
162
- colorize(strings: Array<string>, ...values: unknown[]): void;
163
- /**
164
- * Log a success message with green color
165
- *
166
- * @param {string} message - Success message
167
- * @param {...unknown} args - Additional arguments
168
- */
169
- success(message: string, ...args: unknown[]): void;
170
- /**
171
- * Start a console group for indented output
172
- *
173
- * @param {...unknown} args - Optional group label
174
- */
175
- group(...args: unknown[]): void;
176
- /**
177
- * End the current console group
178
- */
179
- groupEnd(): void;
180
- /**
181
- * Start a debug-tagged group
182
- *
183
- * @param {string} message - Group label
184
- * @param {number} [level=1] - Debug level
185
- */
186
- groupDebug(message: string, level?: number): void;
187
- /**
188
- * Start an info-tagged group
189
- *
190
- * @param {string} message - Group label
191
- */
192
- groupInfo(message: string): void;
193
- /**
194
- * Start a success-tagged group
195
- *
196
- * @param {string} message - Group label
197
- */
198
- groupSuccess(message: string): void;
199
- /**
200
- * Display tabular data as a table
201
- *
202
- * @param {object | Array} data - Object or array to display
203
- * @param {string | object} [labelOrOptions] - Optional label (string) or options (object)
204
- * @param {object} [options] - Optional options when label is provided
205
- * @param {Array<string>} [options.properties] - Column properties to display
206
- * @param {boolean} [options.showHeader=false] - Whether to show the header row
207
- * @param {boolean} [options.quotedStrings=false] - Whether to show quotes around strings
208
- */
209
- table(data: object | any[], labelOrOptions?: string | object, options?: {
210
- properties?: Array<string>;
211
- showHeader?: boolean;
212
- quotedStrings?: boolean;
213
- }): void;
214
- /**
215
- * Get access to the colours template function for instance usage
216
- *
217
- * @returns {import('@gesslar/colours')} The colours template function from \@gesslar/colours
218
- */
219
- get colours(): any;
220
- /**
221
- * Get a raw logger that outputs without name/tag formatting
222
- *
223
- * @returns {object} Raw logger interface
224
- */
225
- get raw(): object;
226
- #private;
227
- }
228
- //# sourceMappingURL=Glog.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Glog.d.ts","sourceRoot":"","sources":["../../lib/Glog.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAsDA;IAEE,wBAAmB;IACnB,yBAAqB;IACrB,mBAAoB;IACpB,2BAAyB;IACzB,oBAAgB;IAChB,8BAA4B;IAgD5B,8CAIC;IAED,4CAIC;IAED,wCAIC;IAED;;;;;;oBAIC;IAED,sDAIC;IAED,yDAIC;IAID,kCAEC;IA6KD,qCAoBC;IAuBD;;;;;OAKG;IACH,yBAHW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAOpB;IAqBD;;;;;OAKG;IACH,wBAHW,MAAM,WACH,OAAO,EAAA,QAWpB;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;IAxkBD,0BAgBC;IAID,+BAUC;IA8CD,0BAIC;IAED,+BAIC;IAED,8BAIC;IAED;;;;;;aAIC;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;IA0BD,8BAEC;IAID;;;;;;OAMG;IACH,kBAJW,KAAK,CAAC,MAAM,CAAC,aACV,OAAO,EAAA,QAQpB;IAeD;;;;;OAKG;IACH,iBAHW,MAAM,WACH,OAAO,EAAA,QAapB;IA0FD;;;;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"}
@@ -1,46 +0,0 @@
1
- export namespace loggerColours {
2
- let debug: string[];
3
- let info: string;
4
- let warn: string;
5
- let error: string;
6
- let reset: string;
7
- }
8
- /**
9
- * Logger class
10
- *
11
- * Log levels:
12
- * - debug: Debugging information
13
- * - Debug levels
14
- * - 0: No/critical debug information, not error level, but, should be
15
- * logged
16
- * - 1: Basic debug information, startup, shutdown, etc
17
- * - 2: Intermediate debug information, discovery, starting to get more
18
- * detailed
19
- * - 3: Detailed debug information, parsing, processing, etc
20
- * - 4: Very detailed debug information, nerd mode!
21
- * - warn: Warning information
22
- * - info: Informational information
23
- * - error: Error information
24
- */
25
- export default class Logger {
26
- constructor(options: any);
27
- vscodeError: any;
28
- vscodeWarn: any;
29
- vscodeInfo: any;
30
- get name(): any;
31
- get debugLevel(): number;
32
- get options(): {
33
- name: any;
34
- debugLevel: number;
35
- };
36
- setOptions(options: any): void;
37
- lastStackLine(error?: Error, stepsRemoved?: number): any;
38
- extractFileFunction(level?: number): any;
39
- newDebug(tag: any): any;
40
- debug(message: any, level?: number, ...arg: any[]): void;
41
- warn(message: any, ...arg: any[]): void;
42
- info(message: any, ...arg: any[]): void;
43
- error(message: any, ...arg: any[]): void;
44
- #private;
45
- }
46
- //# sourceMappingURL=Logger.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../lib/Logger.js"],"names":[],"mappings":";;;;;;;AA4CA;;;;;;;;;;;;;;;;GAgBG;AAEH;IAIE,0BAYC;IALK,iBAAiD;IACjD,gBAAkD;IAClD,gBAAsD;IAK5D,gBAEC;IAED,yBAEC;IAED;;;MAKC;IAED,+BAGC;IAWD,yDAIC;IAED,yCAsCC;IAED,wBAKC;IAED,yDAGC;IAED,wCAGC;IAED,wCAGC;IAED,yCAGC;;CACF"}
@@ -1,54 +0,0 @@
1
- declare const _default: {
2
- /** @type {string} Display name for debugging. */
3
- name: string;
4
- /** @type {EventEmitter} Internal event emitter */
5
- "__#private@#emitter": EventEmitter;
6
- /**
7
- * Emits an event without expecting a return value.
8
- *
9
- * @param {string} type - Event name to dispatch.
10
- * @param {unknown} [payload] - Data to send with the event.
11
- * @returns {void}
12
- */
13
- emit(type: string, payload?: unknown): void;
14
- /**
15
- * Emits an event and returns the payload for simple request/response flows.
16
- * Listeners can mutate the payload object to provide responses.
17
- *
18
- * @param {string} type - Event name to dispatch.
19
- * @param {unknown} [payload] - Data to send with the event (will be returned).
20
- * @returns {unknown} The payload after listeners have processed it.
21
- */
22
- request(type: string, payload?: unknown): unknown;
23
- /**
24
- * Registers a listener for the given event type.
25
- *
26
- * @param {string} type - Event name to listen for.
27
- * @param {(payload: unknown) => void} handler - Listener callback.
28
- * @param {EventEmitter} [emitter] - The EventEmitter to attach to. Default is internal emitter.
29
- * @param {NotifyEventOptions} [options] - Options for the listener.
30
- * @returns {() => void} Dispose function to unregister the handler.
31
- */
32
- on(type: string, handler: (payload: unknown) => void, emitter?: EventEmitter, options?: NotifyEventOptions): () => void;
33
- /**
34
- * Removes a previously registered listener for the given event type.
35
- *
36
- * @param {string} type - Event name to remove.
37
- * @param {(payload: unknown) => void} handler - Listener callback to detach.
38
- * @param {EventEmitter} [emitter] - The EventEmitter from which to remove. Default is internal emitter.
39
- * @returns {void}
40
- */
41
- off(type: string, handler: (payload: unknown) => void, emitter?: EventEmitter): void;
42
- };
43
- export default _default;
44
- export type NotifyEventOptions = {
45
- /**
46
- * - Whether the listener should be invoked only once.
47
- */
48
- once?: boolean;
49
- /**
50
- * - An AbortSignal to remove the listener.
51
- */
52
- signal?: AbortSignal;
53
- };
54
- //# sourceMappingURL=Notify.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Notify.d.ts","sourceRoot":"","sources":["../../lib/Notify.js"],"names":[],"mappings":";IAqBE,iDAAiD;UAAtC,MAAM;IAGjB,kDAAkD;2BAAvC,YAAY;IAGvB;;;;;;OAMG;eAHQ,MAAM,YACN,OAAO,GACL,IAAI;IASjB;;;;;;;OAOG;kBAHQ,MAAM,YACN,OAAO,GACL,OAAO;IAWpB;;;;;;;;OAQG;aALQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,YACZ,kBAAkB,GAChB,MAAM,IAAI;IAgBvB;;;;;;;OAOG;cAJQ,MAAM,WACN,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,YAC1B,YAAY,GACV,IAAI;;;;;;;WA3EL,OAAO;;;;aACP,WAAW"}
@@ -1,9 +0,0 @@
1
- /**
2
- * Custom error class for toolkit errors.
3
- * Provides error chaining, trace management, and formatted error reporting.
4
- */
5
- export default class Sass extends BrowserSass {
6
- #private;
7
- }
8
- import { Sass as BrowserSass } from "../browser/index.js";
9
- //# sourceMappingURL=Sass.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Sass.d.ts","sourceRoot":"","sources":["../../lib/Sass.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH;;CAgFC;oCAvFiC,qBAAqB"}
@@ -1,9 +0,0 @@
1
- /**
2
- * Custom aggregate error class that extends AggregateError.
3
- * Automatically wraps plain errors in Sass instances for consistent reporting.
4
- */
5
- export default class Tantrum extends BrowserTantrum {
6
- constructor(message: any, errors?: any[]);
7
- }
8
- import { Tantrum as BrowserTantrum } from "../browser/index.js";
9
- //# sourceMappingURL=Tantrum.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Tantrum.d.ts","sourceRoot":"","sources":["../../lib/Tantrum.js"],"names":[],"mappings":"AAeA;;;GAGG;AACH;IACE,0CAEC;CA0BF;0CArCuC,qBAAqB"}
@@ -1,42 +0,0 @@
1
- /**
2
- * TempDirectoryObject extends CappedDirectoryObject with the cap set to
3
- * the OS's temporary directory. Temporary directories are created
4
- * synchronously during construction and exist immediately.
5
- *
6
- * All path operations are validated to ensure they remain within the temp
7
- * directory hierarchy for security.
8
- *
9
- * @augments CappedDirectoryObject
10
- */
11
- export default class TempDirectoryObject extends CappedDirectoryObject {
12
- /**
13
- * TempDirectoryObject does not support fromCwd() since it is specifically
14
- * designed to work within the OS temporary directory tree.
15
- *
16
- * @throws {Sass} Always throws an error
17
- */
18
- static fromCwd(): void;
19
- get isTemporary(): boolean;
20
- get cap(): any;
21
- /**
22
- * Recursively removes a temporary directory and all its contents.
23
- *
24
- * This method will delete all files and subdirectories within this directory,
25
- * then delete the directory itself. It only works on directories explicitly
26
- * marked as temporary for safety.
27
- *
28
- * @async
29
- * @returns {Promise<void>}
30
- * @throws {Sass} If the directory is not marked as temporary
31
- * @throws {Sass} If the directory deletion fails
32
- * @example
33
- * const tempDir = new TempDirectoryObject("my-temp")
34
- * await tempDir.assureExists()
35
- * // ... use the directory ...
36
- * await tempDir.remove() // Recursively deletes everything
37
- */
38
- remove(): Promise<void>;
39
- #private;
40
- }
41
- import CappedDirectoryObject from "./CappedDirectoryObject.js";
42
- //# sourceMappingURL=TempDirectoryObject.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"TempDirectoryObject.d.ts","sourceRoot":"","sources":["../../lib/TempDirectoryObject.js"],"names":[],"mappings":"AAiBA;;;;;;;;;GASG;AACH;IAgIE;;;;;OAKG;IACH,uBAEC;IA1ED,2BAEC;IAwBD,eAEC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,UATa,OAAO,CAAC,IAAI,CAAC,CAWzB;;CA0BF;kCAzJiC,4BAA4B"}