@socketsecurity/lib 3.2.8 → 3.3.0

package/dist/env/node-auth-token.js

@@ -22,7 +22,7 @@ __export(node_auth_token_exports, {
   getNodeAuthToken: () => getNodeAuthToken
 });
 module.exports = __toCommonJS(node_auth_token_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getNodeAuthToken() {
   return (0, import_rewire.getEnvValue)("NODE_AUTH_TOKEN");
 }

package/dist/env/node-env.js

@@ -22,7 +22,7 @@ __export(node_env_exports, {
   getNodeEnv: () => getNodeEnv
 });
 module.exports = __toCommonJS(node_env_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getNodeEnv() {
   return (0, import_rewire.getEnvValue)("NODE_ENV");
 }

package/dist/env/npm.js

@@ -26,7 +26,7 @@ __export(npm_exports, {
   getNpmToken: () => getNpmToken
 });
 module.exports = __toCommonJS(npm_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getNpmConfigRegistry() {
   return (0, import_rewire.getEnvValue)("npm_config_registry");
 }

package/dist/env/package-manager.js

@@ -24,7 +24,7 @@ __export(package_manager_exports, {
   getPackageManagerUserAgent: () => getPackageManagerUserAgent
 });
 module.exports = __toCommonJS(package_manager_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function detectPackageManager() {
   const userAgent = getPackageManagerUserAgent();
   if (userAgent) {

package/dist/env/path.js

@@ -22,7 +22,7 @@ __export(path_exports, {
   getPath: () => getPath
 });
 module.exports = __toCommonJS(path_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getPath() {
   return (0, import_rewire.getEnvValue)("PATH");
 }

package/dist/env/pre-commit.js

@@ -22,8 +22,8 @@ __export(pre_commit_exports, {
   getPreCommit: () => getPreCommit
 });
 module.exports = __toCommonJS(pre_commit_exports);
-var import_helpers = require("./helpers");
-var import_rewire = require("./rewire");
+var import_helpers = require("#env/helpers");
+var import_rewire = require("#env/rewire");
 function getPreCommit() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("PRE_COMMIT"));
 }

package/dist/env/rewire.d.ts

@@ -2,8 +2,8 @@
  * Get an environment variable value, checking overrides first.
  *
  * Resolution order:
- * 1. AsyncLocalStorage context (set via withEnv)
- * 2. Test overrides (set via setEnv in beforeEach)
+ * 1. Isolated overrides (temporary - set via withEnv/withEnvSync)
+ * 2. Shared overrides (persistent - set via setEnv in beforeEach)
  * 3. process.env (including vi.stubEnv modifications)
  *
  * @internal Used by env getters to support test rewiring
@@ -79,13 +79,13 @@ export declare function hasOverride(key: string): boolean;
  * @example
  * ```typescript
  * // Nested overrides work correctly
- * setEnv('CI', '1') // Test-level override
+ * setEnv('CI', '1') // Shared override (persistent)
  *
  * await withEnv({ CI: '0' }, async () => {
- *   expect(getCI()).toBe(false) // Context override takes precedence
+ *   expect(getCI()).toBe(false) // Isolated override takes precedence
  * })
  *
- * expect(getCI()).toBe(true) // Back to test-level override
+ * expect(getCI()).toBe(true) // Back to shared override
  * ```
  */
 export declare function withEnv<T>(overrides: Record<string, string | undefined>, fn: () => T | Promise<T>): Promise<T>;

package/dist/env/rewire.js

@@ -29,38 +29,46 @@ __export(rewire_exports, {
 });
 module.exports = __toCommonJS(rewire_exports);
 var import_async_hooks = require("async_hooks");
-const envStorage = new import_async_hooks.AsyncLocalStorage();
-const testOverrides = /* @__PURE__ */ new Map();
+var import_helpers = require("#env/helpers");
+const isolatedOverridesStorage = new import_async_hooks.AsyncLocalStorage();
+const sharedOverridesSymbol = Symbol.for(
+  "@socketsecurity/lib/env/rewire/test-overrides"
+);
+const isVitestEnv = (0, import_helpers.envAsBoolean)(process.env.VITEST);
+if (isVitestEnv && !globalThis[sharedOverridesSymbol]) {
+  globalThis[sharedOverridesSymbol] = /* @__PURE__ */ new Map();
+}
+const sharedOverrides = globalThis[sharedOverridesSymbol];
 function getEnvValue(key) {
-  const contextOverrides = envStorage.getStore();
-  if (contextOverrides?.has(key)) {
-    return contextOverrides.get(key);
+  const isolatedOverrides = isolatedOverridesStorage.getStore();
+  if (isolatedOverrides?.has(key)) {
+    return isolatedOverrides.get(key);
   }
-  if (testOverrides.has(key)) {
-    return testOverrides.get(key);
+  if (sharedOverrides?.has(key)) {
+    return sharedOverrides.get(key);
   }
   return process.env[key];
 }
 function setEnv(key, value) {
-  testOverrides.set(key, value);
+  sharedOverrides?.set(key, value);
 }
 function clearEnv(key) {
-  testOverrides.delete(key);
+  sharedOverrides?.delete(key);
 }
 function resetEnv() {
-  testOverrides.clear();
+  sharedOverrides?.clear();
 }
 function hasOverride(key) {
-  const contextOverrides = envStorage.getStore();
-  return contextOverrides?.has(key) || testOverrides.has(key);
+  const isolatedOverrides = isolatedOverridesStorage.getStore();
+  return !!(isolatedOverrides?.has(key) || sharedOverrides?.has(key));
 }
 async function withEnv(overrides, fn) {
   const map = new Map(Object.entries(overrides));
-  return await envStorage.run(map, fn);
+  return await isolatedOverridesStorage.run(map, fn);
 }
 function withEnvSync(overrides, fn) {
   const map = new Map(Object.entries(overrides));
-  return envStorage.run(map, fn);
+  return isolatedOverridesStorage.run(map, fn);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/env/shell.js

@@ -22,7 +22,7 @@ __export(shell_exports, {
   getShell: () => getShell
 });
 module.exports = __toCommonJS(shell_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getShell() {
   return (0, import_rewire.getEnvValue)("SHELL");
 }

package/dist/env/socket-cli-shadow.js

@@ -26,8 +26,8 @@ __export(socket_cli_shadow_exports, {
   getSocketCliShadowSilent: () => getSocketCliShadowSilent
 });
 module.exports = __toCommonJS(socket_cli_shadow_exports);
-var import_helpers = require("./helpers");
-var import_rewire = require("./rewire");
+var import_helpers = require("#env/helpers");
+var import_rewire = require("#env/rewire");
 function getSocketCliShadowAcceptRisks() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_SHADOW_ACCEPT_RISKS"));
 }

package/dist/env/socket-cli.js

@@ -35,8 +35,8 @@ __export(socket_cli_exports, {
   getSocketCliViewAllRisks: () => getSocketCliViewAllRisks
 });
 module.exports = __toCommonJS(socket_cli_exports);
-var import_helpers = require("./helpers");
-var import_rewire = require("./rewire");
+var import_helpers = require("#env/helpers");
+var import_rewire = require("#env/rewire");
 function getSocketCliAcceptRisks() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_CLI_ACCEPT_RISKS"));
 }

package/dist/env/socket.js

@@ -36,8 +36,8 @@ __export(socket_exports, {
   getSocketViewAllRisks: () => getSocketViewAllRisks
 });
 module.exports = __toCommonJS(socket_exports);
-var import_helpers = require("./helpers");
-var import_rewire = require("./rewire");
+var import_helpers = require("#env/helpers");
+var import_rewire = require("#env/rewire");
 function getSocketAcceptRisks() {
   return (0, import_helpers.envAsBoolean)((0, import_rewire.getEnvValue)("SOCKET_ACCEPT_RISKS"));
 }

package/dist/env/temp-dir.js

@@ -24,7 +24,7 @@ __export(temp_dir_exports, {
   getTmpdir: () => getTmpdir
 });
 module.exports = __toCommonJS(temp_dir_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getTmpdir() {
   return (0, import_rewire.getEnvValue)("TMPDIR");
 }

package/dist/env/term.js

@@ -22,7 +22,7 @@ __export(term_exports, {
   getTerm: () => getTerm
 });
 module.exports = __toCommonJS(term_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getTerm() {
   return (0, import_rewire.getEnvValue)("TERM");
 }

package/dist/env/test.js

@@ -24,9 +24,9 @@ __export(test_exports, {
   isTest: () => isTest
 });
 module.exports = __toCommonJS(test_exports);
-var import_helpers = require("./helpers");
-var import_node_env = require("./node-env");
-var import_rewire = require("./rewire");
+var import_helpers = require("#env/helpers");
+var import_node_env = require("#env/node-env");
+var import_rewire = require("#env/rewire");
 function getJestWorkerId() {
   return (0, import_helpers.envAsString)((0, import_rewire.getEnvValue)("JEST_WORKER_ID"));
 }

package/dist/env/windows.js

@@ -25,7 +25,7 @@ __export(windows_exports, {
   getUserprofile: () => getUserprofile
 });
 module.exports = __toCommonJS(windows_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getAppdata() {
   return (0, import_rewire.getEnvValue)("APPDATA");
 }

package/dist/env/xdg.js

@@ -24,7 +24,7 @@ __export(xdg_exports, {
   getXdgDataHome: () => getXdgDataHome
 });
 module.exports = __toCommonJS(xdg_exports);
-var import_rewire = require("./rewire");
+var import_rewire = require("#env/rewire");
 function getXdgCacheHome() {
   return (0, import_rewire.getEnvValue)("XDG_CACHE_HOME");
 }

package/dist/fs.js

@@ -48,7 +48,7 @@ __export(fs_exports, {
   writeJsonSync: () => writeJsonSync
 });
 module.exports = __toCommonJS(fs_exports);
-var import_process = require("./constants/process");
+var import_process = require("#constants/process");
 var import_arrays = require("./arrays");
 var import_globs = require("./globs");
 var import_json = require("./json");
@@ -429,7 +429,7 @@ function getAllowedDirectories() {
       getOsTmpDir,
       getSocketCacacheDir,
       getSocketUserDir
-    } = require("./paths");
+    } = require("#lib/paths");
     _cachedAllowedDirs = [
       path.resolve(getOsTmpDir()),
       path.resolve(getSocketCacacheDir()),
@@ -444,8 +444,7 @@ function invalidatePathCache() {
 (0, import_rewire.registerCacheInvalidation)(invalidatePathCache);
 // @__NO_SIDE_EFFECTS__
 async function safeDelete(filepath, options) {
-  const del = require("./external/del");
-  const { deleteAsync } = del;
+  const { deleteAsync } = require("./external/del");
   const opts = { __proto__: null, ...options };
   const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_path.pathLikeToString) : [(0, import_path.pathLikeToString)(filepath)];
   let shouldForce = opts.force !== false;
@@ -477,8 +476,7 @@ async function safeDelete(filepath, options) {
 }
 // @__NO_SIDE_EFFECTS__
 function safeDeleteSync(filepath, options) {
-  const del = require("./external/del");
-  const { deleteSync } = del;
+  const { deleteSync } = require("./external/del");
   const opts = { __proto__: null, ...options };
   const patterns = (0, import_arrays.isArray)(filepath) ? filepath.map(import_path.pathLikeToString) : [(0, import_path.pathLikeToString)(filepath)];
   let shouldForce = opts.force !== false;

package/dist/git.js

@@ -45,7 +45,7 @@ __export(git_exports, {
 });
 module.exports = __toCommonJS(git_exports);
 var import_path = __toESM(require("path"));
-var import_platform = require("./constants/platform");
+var import_platform = require("#constants/platform");
 var import_debug = require("./debug");
 var import_globs = require("./globs");
 var import_path2 = require("./path");

package/dist/github.js

@@ -31,8 +31,8 @@ __export(github_exports, {
 });
 module.exports = __toCommonJS(github_exports);
 var import_cache_with_ttl = require("./cache-with-ttl");
-var import_github = require("./env/github");
-var import_socket_cli = require("./env/socket-cli");
+var import_github = require("#env/github");
+var import_socket_cli = require("#env/socket-cli");
 var import_http_request = require("./http-request");
 var import_spawn = require("./spawn");
 const GITHUB_API_BASE_URL = "https://api.github.com";

package/dist/globs.js

@@ -77,8 +77,7 @@ let _fastGlob;
 // @__NO_SIDE_EFFECTS__
 function getFastGlob() {
   if (_fastGlob === void 0) {
-    const globExport = require("./external/fast-glob");
-    _fastGlob = "default" in globExport ? globExport.default : globExport;
+    _fastGlob = require("./external/fast-glob");
   }
   return _fastGlob;
 }
@@ -97,14 +96,14 @@ function globStreamLicenses(dirname, options) {
   if (ignoreOriginals) {
     const { LICENSE_ORIGINAL_GLOB_RECURSIVE } = (
       /*@__INLINE__*/
-      require("./constants/paths")
+      require("#constants/paths")
     );
     ignore.push(LICENSE_ORIGINAL_GLOB_RECURSIVE);
   }
   const fastGlob = /* @__PURE__ */ getFastGlob();
   const paths = (
     /*@__INLINE__*/
-    require("./constants/paths")
+    require("#constants/paths")
   );
   return fastGlob.globStream(
     [recursive ? paths.LICENSE_GLOB_RECURSIVE : paths.LICENSE_GLOB],

package/dist/lifecycle-script-names.d.ts

@@ -1,2 +1,9 @@
-declare const _default: Set<string>;
-export default _default;
+/**
+ * @fileoverview NPM lifecycle script names.
+ *
+ * Standard npm lifecycle hooks that can be defined in package.json scripts.
+ * https://docs.npmjs.com/cli/v10/using-npm/scripts#life-cycle-scripts
+ */
+declare const lifecycleScriptNames: Set<string>;
+export default lifecycleScriptNames;
+export { lifecycleScriptNames as 'module.exports' };

package/dist/lifecycle-script-names.js

@@ -18,8 +18,12 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var lifecycle_script_names_exports = {};
-/* module.exports will be set at end of file */
-var lifecycle_script_names_default = new Set(
+__export(lifecycle_script_names_exports, {
+  default: () => lifecycle_script_names_default,
+  "module.exports": () => lifecycleScriptNames
+});
+module.exports = __toCommonJS(lifecycle_script_names_exports);
+const lifecycleScriptNames = new Set(
   [
     "dependencies",
     "prepublishOnly",
@@ -35,5 +39,8 @@ var lifecycle_script_names_default = new Set(
     ].map((n) => [`pre${n}`, n, `post${n}`])
   ].flat()
 );
-
-module.exports = lifecycle_script_names_default;
+var lifecycle_script_names_default = lifecycleScriptNames;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  "module.exports": null
+});

package/dist/logger.d.ts

@@ -13,6 +13,7 @@
  * console.log(`${LOG_SYMBOLS.warn} Warning message`)
  * console.log(`${LOG_SYMBOLS.info} Information message`)
  * console.log(`${LOG_SYMBOLS.step} Processing step`)
+ * console.log(`${LOG_SYMBOLS.reason} Working through logic`)
  * ```
  */
 type LogSymbols = {
@@ -20,6 +21,8 @@ type LogSymbols = {
     fail: string;
     /** Blue colored information symbol (ℹ or i in ASCII) */
     info: string;
+    /** Dimmed yellow reasoning/working symbol (∴ or :. in ASCII) */
+    reason: string;
     /** Cyan colored step symbol (→ or > in ASCII) */
     step: string;
     /** Green colored success symbol (✔ or √ in ASCII) */
@@ -62,9 +65,9 @@ export type { LogSymbols, LoggerMethods, Task };
 /**
  * Log symbols for terminal output with colored indicators.
  *
- * Provides colored Unicode symbols (✔, ✖, ⚠, ℹ, →) with ASCII fallbacks (√, ×, ‼, i, >)
+ * Provides colored Unicode symbols (✖, ℹ, ∴, →, ✔, ⚠) with ASCII fallbacks (×, i, :., >, √, ‼)
  * for terminals that don't support Unicode. Symbols are colored according to the active
- * theme's color palette (success, error, warning, info, step).
+ * theme's color palette (error, info, reason, step, success, warning).
  *
  * The symbols are lazily initialized on first access and automatically update when the
  * fallback theme changes (via setTheme()). Note that LOG_SYMBOLS reflect the global
@@ -74,11 +77,12 @@ export type { LogSymbols, LoggerMethods, Task };
  * ```typescript
  * import { LOG_SYMBOLS } from '@socketsecurity/lib'
  *
- * console.log(`${LOG_SYMBOLS.success} Build completed`)    // Theme success color ✔
  * console.log(`${LOG_SYMBOLS.fail} Build failed`)          // Theme error color ✖
- * console.log(`${LOG_SYMBOLS.warn} Deprecated API used`)   // Theme warning color ⚠
  * console.log(`${LOG_SYMBOLS.info} Starting process`)      // Theme info color ℹ
+ * console.log(`${LOG_SYMBOLS.reason} Analyzing dependencies`) // Dimmed yellow ∴
  * console.log(`${LOG_SYMBOLS.step} Processing files`)      // Theme step color →
+ * console.log(`${LOG_SYMBOLS.success} Build completed`)    // Theme success color ✔
+ * console.log(`${LOG_SYMBOLS.warn} Deprecated API used`)   // Theme warning color ⚠
  * ```
  */
 export declare const LOG_SYMBOLS: Record<string, string>;
@@ -288,6 +292,35 @@ export declare class Logger {
      * ```
      */
     assert(value: unknown, ...message: unknown[]): this;
+    /**
+     * Clears the current line in the terminal.
+     *
+     * Moves the cursor to the beginning of the line and clears all content.
+     * Works in both TTY and non-TTY environments. Useful for clearing
+     * progress indicators created with `progress()`.
+     *
+     * The stream to clear (stderr or stdout) depends on whether the logger
+     * is stream-bound.
+     *
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.progress('Loading...')
+     * // ... do work ...
+     * logger.clearLine()
+     * logger.success('Loaded')
+     *
+     * // Clear multiple progress updates
+     * for (const file of files) {
+     *   logger.progress(`Processing ${file}`)
+     *   processFile(file)
+     *   logger.clearLine()
+     * }
+     * logger.success('All files processed')
+     * ```
+     */
+    clearLine(): this;
     /**
      * Clears the visible terminal screen.
      *
@@ -413,6 +446,28 @@ export declare class Logger {
      * ```
      */
     dirxml(...data: unknown[]): this;
+    /**
+     * Logs a completion message with a success symbol (alias for `success()`).
+     *
+     * Provides semantic clarity when marking something as "done". Does NOT
+     * automatically clear the current line - call `clearLine()` first if
+     * needed after using `progress()`.
+     *
+     * @param args - Message and additional arguments to log
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.done('Task completed')
+     *
+     * // After progress indicator
+     * logger.progress('Processing...')
+     * // ... do work ...
+     * logger.clearLine()
+     * logger.done('Processing complete')
+     * ```
+     */
+    done(...args: unknown[]): this;
     /**
      * Logs an error message to stderr.
      *
@@ -614,6 +669,53 @@ export declare class Logger {
      * ```
      */
     logNewline(): this;
+    /**
+     * Shows a progress indicator that can be cleared with `clearLine()`.
+     *
+     * Displays a simple status message with a '∴' prefix. Does not include
+     * animation or spinner. Intended to be cleared once the operation completes.
+     * The output stream (stderr or stdout) depends on whether the logger is
+     * stream-bound.
+     *
+     * @param text - The progress message to display
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.progress('Processing files...')
+     * // ... do work ...
+     * logger.clearLine()
+     * logger.success('Files processed')
+     *
+     * // Stream-specific progress
+     * logger.stdout.progress('Loading...')
+     * // ... do work ...
+     * logger.stdout.clearLine()
+     * logger.stdout.log('Done')
+     * ```
+     */
+    progress(text: string): this;
+    /**
+     * Logs a reasoning/working message with a dimmed yellow therefore symbol.
+     *
+     * Automatically prefixes the message with `LOG_SYMBOLS.reason` (dimmed yellow ∴).
+     * Useful for showing intermediate reasoning, logic steps, or "working" output
+     * that leads to a conclusion. Always outputs to stderr. If the message starts
+     * with an existing symbol, it will be stripped and replaced.
+     *
+     * @param args - Message and additional arguments to log
+     * @returns The logger instance for chaining
+     *
+     * @example
+     * ```typescript
+     * logger.step('Analyzing package security')
+     * logger.reason('Found 3 direct dependencies')
+     * logger.reason('Checking 47 transitive dependencies')
+     * logger.reason('Risk score: 8.5/10')
+     * logger.fail('Package blocked due to high risk')
+     * ```
+     */
+    reason(...args: unknown[]): this;
     /**
      * Resets all indentation to zero.
      *
@@ -706,28 +808,6 @@ export declare class Logger {
      * ```
      */
     success(...args: unknown[]): this;
-    /**
-     * Logs a completion message with a success symbol (alias for `success()`).
-     *
-     * Provides semantic clarity when marking something as "done". Does NOT
-     * automatically clear the current line - call `clearLine()` first if
-     * needed after using `progress()`.
-     *
-     * @param args - Message and additional arguments to log
-     * @returns The logger instance for chaining
-     *
-     * @example
-     * ```typescript
-     * logger.done('Task completed')
-     *
-     * // After progress indicator
-     * logger.progress('Processing...')
-     * // ... do work ...
-     * logger.clearLine()
-     * logger.done('Processing complete')
-     * ```
-     */
-    done(...args: unknown[]): this;
     /**
      * Displays data in a table format.
      *
@@ -893,61 +973,6 @@ export declare class Logger {
      * ```
      */
     write(text: string): this;
-    /**
-     * Shows a progress indicator that can be cleared with `clearLine()`.
-     *
-     * Displays a simple status message with a '∴' prefix. Does not include
-     * animation or spinner. Intended to be cleared once the operation completes.
-     * The output stream (stderr or stdout) depends on whether the logger is
-     * stream-bound.
-     *
-     * @param text - The progress message to display
-     * @returns The logger instance for chaining
-     *
-     * @example
-     * ```typescript
-     * logger.progress('Processing files...')
-     * // ... do work ...
-     * logger.clearLine()
-     * logger.success('Files processed')
-     *
-     * // Stream-specific progress
-     * logger.stdout.progress('Loading...')
-     * // ... do work ...
-     * logger.stdout.clearLine()
-     * logger.stdout.log('Done')
-     * ```
-     */
-    progress(text: string): this;
-    /**
-     * Clears the current line in the terminal.
-     *
-     * Moves the cursor to the beginning of the line and clears all content.
-     * Works in both TTY and non-TTY environments. Useful for clearing
-     * progress indicators created with `progress()`.
-     *
-     * The stream to clear (stderr or stdout) depends on whether the logger
-     * is stream-bound.
-     *
-     * @returns The logger instance for chaining
-     *
-     * @example
-     * ```typescript
-     * logger.progress('Loading...')
-     * // ... do work ...
-     * logger.clearLine()
-     * logger.success('Loaded')
-     *
-     * // Clear multiple progress updates
-     * for (const file of files) {
-     *   logger.progress(`Processing ${file}`)
-     *   processFile(file)
-     *   logger.clearLine()
-     * }
-     * logger.success('All files processed')
-     * ```
-     */
-    clearLine(): this;
 }
 /**
  * Get the default logger instance.