@darksheep/logger 1.3.0 → 1.4.0

package/types/logger.d.ts

@@ -1,40 +1,94 @@
+/**
+ * @import { LogLevel, LogContext, LogEntry} from './utilities/log-types.js'
+ * @import { Replacer } from './replacer.js';
+ */
+import type { LogLevel, LogContext } from './utilities/log-types.js';
+import type { Replacer } from './replacer.js';
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { formatter } from './formatter.js';
+import { replace } from './replacer.js';
+import { stdoutWrite } from './stdout-write.js';
+export type Options = {
+    /**
+     * - The replacer function to use.
+     */
+    replace?: typeof replace;
+    /**
+     * - The replacers to use in the replacer.
+     */
+    replacers?: Replacer[];
+    /**
+     * - The formatter function to use (eg console or json formatter).
+     */
+    format?: typeof formatter;
+    /**
+     * - The place to write the log to.
+     */
+    write?: typeof stdoutWrite;
+};
 /**
  * @typedef {Object} Options
  * @property {typeof replace} [replace] - The replacer function to use.
- * @property {import('./replacer.js').Replacer<any, any>[]} [replacers] - The replacers to use in the replacer.
+ * @property {Replacer[]} [replacers] - The replacers to use in the replacer.
  * @property {typeof formatter} [format] - The formatter function to use (eg console or json formatter).
  * @property {typeof stdoutWrite} [write] - The place to write the log to.
  */
-export class Logger {
-    /** @type {AsyncLocalStorage<import('./utilities/log-types.js').LogContext[]>} */
-    static storage: AsyncLocalStorage<import("./utilities/log-types.js").LogContext[]>;
+export declare class Logger {
+    #private;
+    /** @type {AsyncLocalStorage<LogContext[]>} */
+    static storage: AsyncLocalStorage<LogContext[]>;
+    /** @type {Replacer[]} */
+    replacers: Replacer[];
     /**
-     * @param {import('./utilities/log-types.js').LogContext} context - Context to bind ot the async context.
+     * @param {LogContext} [context] - Context to add to the logger.
+     * @param {Options} [options] - Options for the loggers output.
+     */
+    constructor(context?: LogContext, options?: Options);
+    /**
+     * @param {LogContext} context - Context to bind ot the async context.
      * @returns {void}
      */
-    static addAsyncContext(context: import("./utilities/log-types.js").LogContext): void;
+    static addAsyncContext(context: LogContext): void;
     /**
      * @template [R=unknown]
      * @overload
      * @param {() => R} callback - The function to wrap the context in.
      * @returns {R}
      */
+    /**
+     * @template [R=unknown]
+     * @overload
+     * @param {LogContext} context - Context to bind ot the async context.
+     * @param {() => R} callback - The function to wrap the context in.
+     * @returns {R}
+     */
+    /**
+     * @template [R=unknown]
+     * @param {unknown} context - Context to bind ot the async context.
+     * @param {unknown} [callback] - The function to wrap the context in.
+     * @returns {R}
+     */
     static wrap<R = unknown>(callback: () => R): R;
     /**
      * @template [R=unknown]
      * @overload
-     * @param {import('./utilities/log-types.js').LogContext} context - Context to bind ot the async context.
      * @param {() => R} callback - The function to wrap the context in.
      * @returns {R}
      */
-    static wrap<R = unknown>(context: import("./utilities/log-types.js").LogContext, callback: () => R): R;
     /**
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Context to add to the logger.
-     * @param {Options} [options] - Options for the loggers output.
+     * @template [R=unknown]
+     * @overload
+     * @param {LogContext} context - Context to bind ot the async context.
+     * @param {() => R} callback - The function to wrap the context in.
+     * @returns {R}
      */
-    constructor(context?: import("./utilities/log-types.js").LogContext, options?: Options);
-    /** @type {import('./replacer.js').Replacer[]} */
-    replacers: import("./replacer.js").Replacer[];
+    /**
+     * @template [R=unknown]
+     * @param {unknown} context - Context to bind ot the async context.
+     * @param {unknown} [callback] - The function to wrap the context in.
+     * @returns {R}
+     */
+    static wrap<R = unknown>(context: LogContext, callback: () => R): R;
     /**
      * Set the channel in the new logger.
      * @param {string} channel - The channel name.
@@ -44,48 +98,106 @@ export class Logger {
     /**
      * Creating a new logger with {context, ...this.context}.
      * @overload
-     * @param {import('./utilities/log-types.js').LogContext} context - The new context.
+     * @param {LogContext} context - The new context.
+     * @returns {Logger}
+     */
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @overload
+     * @param {LogContext} context - The new context.
+     * @param {LogLevel} level - The log level at which we allow this context.
+     * @returns {Logger}
+     */
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @overload
+     * @param {LogLevel} level - The log level at which we allow this context.
+     * @param {LogContext} context - The new context.
+     * @returns {Logger}
+     */
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @param {LogContext | LogLevel} contextOrLevel - The log level at which we allow this context.
+     * @param {LogLevel | LogContext} [levelOrContext] - The new context.
+     * @returns {Logger}
+     */
+    context(context: LogContext): Logger;
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @overload
+     * @param {LogContext} context - The new context.
+     * @returns {Logger}
+     */
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @overload
+     * @param {LogContext} context - The new context.
+     * @param {LogLevel} level - The log level at which we allow this context.
+     * @returns {Logger}
+     */
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @overload
+     * @param {LogLevel} level - The log level at which we allow this context.
+     * @param {LogContext} context - The new context.
+     * @returns {Logger}
+     */
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @param {LogContext | LogLevel} contextOrLevel - The log level at which we allow this context.
+     * @param {LogLevel | LogContext} [levelOrContext] - The new context.
      * @returns {Logger}
      */
-    context(context: import("./utilities/log-types.js").LogContext): Logger;
+    context(context: LogContext, level: LogLevel): Logger;
     /**
      * Creating a new logger with {context, ...this.context}.
      * @overload
-     * @param {import('./utilities/log-types.js').LogContext} context - The new context.
-     * @param {import('./utilities/log-types.js').LogLevel} level - The log level at which we allow this context.
+     * @param {LogContext} context - The new context.
      * @returns {Logger}
      */
-    context(context: import("./utilities/log-types.js").LogContext, level: import("./utilities/log-types.js").LogLevel): Logger;
     /**
      * Creating a new logger with {context, ...this.context}.
      * @overload
-     * @param {import('./utilities/log-types.js').LogLevel} level - The log level at which we allow this context.
-     * @param {import('./utilities/log-types.js').LogContext} context - The new context.
+     * @param {LogContext} context - The new context.
+     * @param {LogLevel} level - The log level at which we allow this context.
      * @returns {Logger}
      */
-    context(level: import("./utilities/log-types.js").LogLevel, context: import("./utilities/log-types.js").LogContext): Logger;
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @overload
+     * @param {LogLevel} level - The log level at which we allow this context.
+     * @param {LogContext} context - The new context.
+     * @returns {Logger}
+     */
+    /**
+     * Creating a new logger with {context, ...this.context}.
+     * @param {LogContext | LogLevel} contextOrLevel - The log level at which we allow this context.
+     * @param {LogLevel | LogContext} [levelOrContext] - The new context.
+     * @returns {Logger}
+     */
+    context(level: LogLevel, context: LogContext): Logger;
     /**
      * Write a log with the level 'critical' - A crucial part of the application is not working.
      *
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Additional context.
+     * @param {LogContext} [context] - Additional context.
      * @returns {void}
      */
-    critical(message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
+    critical(message: Error | string, context?: LogContext): void;
     /**
      * Write a log with the level 'debug' - Information that is unlikely to help in production.
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Additional context.
+     * @param {LogContext} [context] - Additional context.
      * @returns {void}
      */
-    debug(message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
+    debug(message: Error | string, context?: LogContext): void;
     /**
      * Write a log with the level 'error' - A non critical operation fails.
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Additional context.
+     * @param {LogContext} [context] - Additional context.
      * @returns {void}
      */
-    error(message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
+    error(message: Error | string, context?: LogContext): void;
     /**
      * Get a value from the context by key.
      * @param {string} key - The key to get from the context.
@@ -95,17 +207,17 @@ export class Logger {
     /**
      * Write a log with the level 'info' - Information about successful operations.
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Additional context.
+     * @param {LogContext} [context] - Additional context.
      * @returns {void}
      */
-    info(message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
+    info(message: Error | string, context?: LogContext): void;
     /**
      * Write a log with the level 'notice' - Information about events that may be unusual.
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Additional context.
+     * @param {LogContext} [context] - Additional context.
      * @returns {void}
      */
-    notice(message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
+    notice(message: Error | string, context?: LogContext): void;
     /**
      * Set a value into a new context by key.
      * @param {string} key - The key to set.
@@ -116,10 +228,10 @@ export class Logger {
     /**
      * Write a log with the level 'silly' - Information to help resolve complex logic issues.
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Additional context.
+     * @param {LogContext} [context] - Additional context.
      * @returns {void}
      */
-    silly(message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
+    silly(message: Error | string, context?: LogContext): void;
     /**
      * Set the trail in the new logger.
      * @param {string} [trail] - The trail id.
@@ -129,10 +241,10 @@ export class Logger {
     /**
      * Write a log with the level 'warning' - An operation might fail in the future.
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Additional context.
+     * @param {LogContext} [context] - Additional context.
      * @returns {void}
      */
-    warning(message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
+    warning(message: Error | string, context?: LogContext): void;
     /**
      * @template [R=unknown]
      * @param {() => R} callback - The function to wrap the context in.
@@ -141,33 +253,10 @@ export class Logger {
     wrap<R = unknown>(callback: () => R): R;
     /**
      * Write a new log entry.
-     * @param {import('./utilities/log-types.js').LogLevel} level - The log level of the message to log.
+     * @param {LogLevel} level - The log level of the message to log.
      * @param {Error | string} message - The message to log.
-     * @param {import('./utilities/log-types.js').LogContext} [context] - Context to add to the log (merged with this.context, and Logger.contexts).
+     * @param {LogContext} [context] - Context to add to the log (merged with this.context, and Logger.contexts).
      * @returns {void}
      */
-    write(level: import("./utilities/log-types.js").LogLevel, message: Error | string, context?: import("./utilities/log-types.js").LogContext): void;
-    #private;
+    write(level: LogLevel, message: Error | string, context?: LogContext): void;
 }
-export type Options = {
-    /**
-     * - The replacer function to use.
-     */
-    replace?: typeof replace;
-    /**
-     * - The replacers to use in the replacer.
-     */
-    replacers?: import("./replacer.js").Replacer<any, any>[];
-    /**
-     * - The formatter function to use (eg console or json formatter).
-     */
-    format?: typeof formatter;
-    /**
-     * - The place to write the log to.
-     */
-    write?: typeof stdoutWrite;
-};
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { replace } from './replacer.js';
-import { formatter } from './formatter.js';
-import { stdoutWrite } from './stdout-write.js';

package/types/replacer.d.ts

@@ -1,19 +1,4 @@
-/**
- * @template [T=unknown]
- * @template [O=unknown]
- * @typedef {Object} Replacer
- * @property {string} name - The name of the replacer.
- * @property {(input: unknown, path?: string[]) => boolean} shouldReplace - Check to see if input can be replaced.
- * @property {(input: T, path?: string[]) => O} replace - The replace function if shouldReplace returns true.
- * @property {boolean} [stopHere] - Should the traverse stop here.
- */
-/**
- * @param {unknown} object - The object we're replacing.
- * @param {Replacer[]} replacers - The Replacer array to execute.
- * @returns {unknown}
- */
-export function replace(object: unknown, replacers?: Replacer[]): unknown;
-export type Replacer<T = unknown, O = unknown> = {
+export type Replacer<T = any, O = unknown> = {
     /**
      * - The name of the replacer.
      */
@@ -31,3 +16,18 @@ export type Replacer<T = unknown, O = unknown> = {
      */
     stopHere?: boolean;
 };
+/**
+ * @template [T=any]
+ * @template [O=unknown]
+ * @typedef {Object} Replacer
+ * @property {string} name - The name of the replacer.
+ * @property {(input: unknown, path?: string[]) => boolean} shouldReplace - Check to see if input can be replaced.
+ * @property {(input: T, path?: string[]) => O} replace - The replace function if shouldReplace returns true.
+ * @property {boolean} [stopHere] - Should the traverse stop here.
+ */
+/**
+ * @param {unknown} object - The object we're replacing.
+ * @param {Replacer[]} replacers - The Replacer array to execute.
+ * @returns {unknown}
+ */
+export declare function replace(object: unknown, replacers?: Replacer[]): unknown;

package/types/replacers/buffers.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../replacer.js').Replacer<Buffer>} */
-export const BufferReplacer: import("../replacer.js").Replacer<Buffer>;
+/**
+ * @import { Replacer } from '../replacer.js';
+ */
+import type { Replacer } from '../replacer.js';
+/** @type {Replacer<Buffer>} */
+export declare const BufferReplacer: Replacer<Buffer>;

package/types/replacers/error.d.ts

@@ -1,14 +1,4 @@
-/**
- * @typedef {Object} BaseError
- * @property {string} type - The error type or name.
- * @property {string} message - The error message.
- * @property {import('../utilities/stacktrace.js').Callsite[]} stack - The stacktrace of the error.
- */
-/**
- * @typedef {BaseError & { [k: string]: unknown }} NormalisedError
- */
-/** @type {import('../replacer.js').Replacer<Error, NormalisedError>} */
-export const ErrorReplacer: import("../replacer.js").Replacer<Error, NormalisedError>;
+import type { Replacer } from '../replacer.js';
 export type BaseError = {
     /**
      * - The error type or name.
@@ -21,8 +11,19 @@ export type BaseError = {
     /**
      * - The stacktrace of the error.
      */
-    stack: import("../utilities/stacktrace.js").Callsite[];
+    stack: import('../utilities/stacktrace.js').Callsite[];
 };
 export type NormalisedError = BaseError & {
     [k: string]: unknown;
 };
+/**
+ * @typedef {Object} BaseError
+ * @property {string} type - The error type or name.
+ * @property {string} message - The error message.
+ * @property {import('../utilities/stacktrace.js').Callsite[]} stack - The stacktrace of the error.
+ */
+/**
+ * @typedef {BaseError & { [k: string]: unknown }} NormalisedError
+ */
+/** @type {Replacer<Error, NormalisedError>} */
+export declare const ErrorReplacer: Replacer<Error, NormalisedError>;

package/types/replacers/http-client-request.d.ts

@@ -1,3 +1,7 @@
-/** @type {import('../replacer.js').Replacer<ClientRequest>} */
-export const HttpClientRequestReplacer: import("../replacer.js").Replacer<ClientRequest>;
+/**
+ * @import { Replacer } from '../replacer.js';
+ */
+import type { Replacer } from '../replacer.js';
 import { ClientRequest } from 'node:http';
+/** @type {Replacer<ClientRequest>} */
+export declare const HttpClientRequestReplacer: Replacer<ClientRequest>;

package/types/replacers/http-incoming-message.d.ts

@@ -1,15 +1,21 @@
 /**
- * @type {import('../replacer.js').Replacer<
+ * @import { ClientRequest } from 'node:http'
+ * @import { Replacer } from '../replacer.js'
+ */
+import type { ClientRequest } from 'node:http';
+import type { Replacer } from '../replacer.js';
+import { IncomingMessage } from 'node:http';
+/**
+ * @type {Replacer<
  *    IncomingMessage & {
  *      hostname?: string,
  *      originalUrl?: string,
- *      req?: import('node:http').ClientRequest
+ *      req?: ClientRequest
  *    }
  * >}
  */
-export const HttpIncomingMessageReplacer: import("../replacer.js").Replacer<IncomingMessage & {
+export declare const HttpIncomingMessageReplacer: Replacer<IncomingMessage & {
     hostname?: string;
     originalUrl?: string;
-    req?: import("node:http").ClientRequest;
+    req?: ClientRequest;
 }>;
-import { IncomingMessage } from 'node:http';

package/types/replacers/http-server-response.d.ts

@@ -1,3 +1,7 @@
-/** @type {import('../replacer.js').Replacer<ServerResponse>} */
-export const HttpServerResponseReplacer: import("../replacer.js").Replacer<ServerResponse>;
+/**
+ * @import { Replacer } from '../replacer.js';
+ */
+import type { Replacer } from '../replacer.js';
 import { ServerResponse } from 'node:http';
+/** @type {Replacer<ServerResponse>} */
+export declare const HttpServerResponseReplacer: Replacer<ServerResponse>;

package/types/replacers/index.d.ts

@@ -1,8 +1,8 @@
-export { BufferReplacer } from "./buffers.js";
-export { ErrorReplacer } from "./error.js";
-export { HttpClientRequestReplacer } from "./http-client-request.js";
-export { HttpIncomingMessageReplacer } from "./http-incoming-message.js";
-export { HttpServerResponseReplacer } from "./http-server-response.js";
-export { LongStringReplacer } from "./long-strings.js";
-export { NetSocketReplacer } from "./net-socket.js";
-export { SecretDelete, SecretObscure } from "./secrets.js";
+export { BufferReplacer } from './buffers.js';
+export { ErrorReplacer } from './error.js';
+export { HttpClientRequestReplacer } from './http-client-request.js';
+export { HttpIncomingMessageReplacer } from './http-incoming-message.js';
+export { HttpServerResponseReplacer } from './http-server-response.js';
+export { LongStringReplacer } from './long-strings.js';
+export { NetSocketReplacer } from './net-socket.js';
+export { SecretRedact, SecretRemove } from './secrets.js';

package/types/replacers/long-strings.d.ts

@@ -1,2 +1,6 @@
-/** @type {import('../replacer.js').Replacer<string>} */
-export const LongStringReplacer: import("../replacer.js").Replacer<string>;
+/**
+ * @import { Replacer } from '../replacer.js';
+ */
+import type { Replacer } from '../replacer.js';
+/** @type {Replacer<string>} */
+export declare const LongStringReplacer: Replacer<string>;

package/types/replacers/net-socket.d.ts

@@ -1,3 +1,7 @@
-/** @type {import('../replacer.js').Replacer<Socket>} */
-export const NetSocketReplacer: import("../replacer.js").Replacer<Socket>;
+/**
+ * @import { Replacer } from '../replacer.js';
+ */
+import type { Replacer } from '../replacer.js';
 import { Socket } from 'node:net';
+/** @type {Replacer<Socket>} */
+export declare const NetSocketReplacer: Replacer<Socket>;

package/types/replacers/secrets.d.ts

@@ -1,4 +1,8 @@
-/** @type {import('../replacer.js').Replacer} */
-export const SecretDelete: import("../replacer.js").Replacer;
-/** @type {import('../replacer.js').Replacer} */
-export const SecretObscure: import("../replacer.js").Replacer;
+/**
+ * @import { Replacer } from '../replacer.js';
+ */
+import type { Replacer } from '../replacer.js';
+/** @type {Replacer} */
+export declare const SecretRemove: Replacer;
+/** @type {Replacer} */
+export declare const SecretRedact: Replacer;

package/types/stdout-write.d.ts

@@ -2,4 +2,4 @@
  * @param {string} output - What should be written to stdout.
  * @returns {void}
  */
-export function stdoutWrite(output: string): void;
+export declare function stdoutWrite(output: string): void;

package/types/utilities/colour.d.ts

@@ -1,17 +1,21 @@
-/**
- * Should colours be used in the output.
- * @returns {boolean}
- */
-export function shouldColour(): boolean;
-/**
- * Colour a string.
- * @param {string} string - The string to colour.
- * @param {ColourOptions | undefined} [options] - The options to use to colour the string.
- * @returns {string}
- */
-export function colourString(string: string, options?: ColourOptions | undefined): string;
+declare const colours: Readonly<{
+    black: "0";
+    red: "1";
+    green: "2";
+    yellow: "3";
+    blue: "4";
+    magenta: "5";
+    cyan: "6";
+    white: "7";
+}>;
+declare const effects: Readonly<{
+    bold: number[];
+    faint: number[];
+    italic: number[];
+    underline: number[];
+}>;
 export type ColourNames = keyof typeof colours;
-export type ColourMode = "bright" | "dim";
+export type ColourMode = 'bright' | 'dim';
 export type ColourEffects = keyof typeof effects;
 export type ColourOptions = {
     /**
@@ -37,22 +41,18 @@ export type ColourOptions = {
     /**
      * - How to handle the string termination.
      */
-    reset?: boolean | Omit<ColourOptions, "reset">;
+    reset?: boolean | Omit<ColourOptions, 'reset'>;
 };
-declare const colours: Readonly<{
-    black: "0";
-    red: "1";
-    green: "2";
-    yellow: "3";
-    blue: "4";
-    magenta: "5";
-    cyan: "6";
-    white: "7";
-}>;
-declare const effects: Readonly<{
-    bold: number[];
-    faint: number[];
-    italic: number[];
-    underline: number[];
-}>;
+/**
+ * Should colours be used in the output.
+ * @returns {boolean}
+ */
+export declare function shouldColour(): boolean;
+/**
+ * Colour a string.
+ * @param {string} string - The string to colour.
+ * @param {ColourOptions | undefined} [options] - The options to use to colour the string.
+ * @returns {string}
+ */
+export declare function colourString(string: string, options?: ColourOptions | undefined): string;
 export {};

package/types/utilities/environment.d.ts

@@ -1,25 +1,17 @@
-export namespace environment {
-    export { LOG_CALLSITES as includeCallsite };
-    export { LOG_CPU as includeCpuUsage };
-    export { LOG_MEMORY as includeMemoryUsage };
-    export let isDevelopment: boolean;
-    export let isProduction: boolean;
-    export let isTesting: boolean;
-    export let logFilters: {
+export declare const environment: {
+    includeCallsite: boolean;
+    includeCpuUsage: boolean;
+    includeMemoryUsage: boolean;
+    isDevelopment: boolean;
+    isProduction: boolean;
+    isTesting: boolean;
+    logFilters: {
         allowed: RegExp[];
         blocked: RegExp[];
     };
-    export let logLevel: import("./log-types.js").LogLevel;
-    export let secretFilters: {
-        allowed: RegExp[];
-        blocked: RegExp[];
-    };
-    export { LOG_RELATIVE_TO as relativeTo };
-    export { LOG_MAX_LENGTH as stringMaxLength };
-}
-declare const LOG_CALLSITES: boolean;
-declare const LOG_CPU: boolean;
-declare const LOG_MEMORY: boolean;
-declare const LOG_RELATIVE_TO: string | undefined;
-declare const LOG_MAX_LENGTH: number;
-export {};
+    logLevel: import("./log-types.js").LogLevel;
+    redactFilters: import("./legacy-secrets.js").Filters;
+    relativeTo: string | undefined;
+    removeFilters: import("./legacy-secrets.js").Filters;
+    stringMaxLength: number;
+};

package/types/utilities/json-path.d.ts

@@ -2,4 +2,4 @@
  * @param {string[]} nodes - The nodes to the element.
  * @returns {string}
  */
-export function nodesToPath(nodes: string[]): string;
+export declare function nodesToPath(nodes: string[]): string;

package/types/utilities/last-callsite.d.ts

@@ -2,7 +2,7 @@
  * Get the callsite that we think is outside the package.
  * @returns {{ file: string, line: number, column: number } | void}
  */
-export function getLastCallsite(): {
+export declare function getLastCallsite(): {
     file: string;
     line: number;
     column: number;