🤖 Merge PR DefinitelyTyped#74466 Add types for webpack-log by @gasp

Author: gasp

types/webpack-log/.npmignore

@@ -0,0 +1,5 @@
+*
+!**/*.d.ts
+!**/*.d.cts
+!**/*.d.mts
+!**/*.d.*.ts

types/webpack-log/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Options for creating a webpack logger.
+ */
+interface WebpackLogOptions {
+    /**
+     * Log level. Default: 'info'.
+     */
+    level?: "trace" | "debug" | "info" | "warn" | "error" | "silent";
+
+    /**
+     * Name of the logger. Default: '<webpack-log>'.
+     */
+    name?: string;
+
+    /**
+     * Whether to include timestamp in output. Default: false.
+     */
+    timestamp?: boolean;
+
+    /**
+     * Whether to generate unique logger ID. Default: true.
+     */
+    unique?: boolean;
+}
+
+/**
+ * Logger instance returned by webpack-log.
+ */
+interface WebpackLogger {
+    /**
+     * Log at trace level.
+     */
+    trace(...args: unknown[]): void;
+
+    /**
+     * Log at debug level.
+     */
+    debug(...args: unknown[]): void;
+
+    /**
+     * Log at info level.
+     */
+    info(...args: unknown[]): void;
+
+    /**
+     * Log at warn level.
+     */
+    warn(...args: unknown[]): void;
+
+    /**
+     * Log at error level.
+     */
+    error(...args: unknown[]): void;
+}
+
+/**
+ * Creates a logger for the Webpack ecosystem.
+ *
+ * @param options - Logger configuration options
+ * @returns A logger instance with trace, debug, info, warn, and error methods
+ *
+ * @example
+ * ```javascript
+ * const getLogger = require('webpack-log');
+ *
+ * const log = getLogger({ name: 'my-plugin' });
+ * log.info('Starting plugin');
+ * log.error('Something went wrong');
+ * ```
+ */
+declare function getLogger(options?: WebpackLogOptions): WebpackLogger;
+
+declare namespace getLogger {
+    export { WebpackLogger, WebpackLogOptions };
+}
+
+export = getLogger;

types/webpack-log/package.json

@@ -0,0 +1,17 @@
+{
+    "private": true,
+    "name": "@types/webpack-log",
+    "version": "3.0.9999",
+    "projects": [
+        "https://github.com/shellscape/webpack-log"
+    ],
+    "devDependencies": {
+        "@types/webpack-log": "workspace:."
+    },
+    "owners": [
+        {
+            "name": "gaspard",
+            "githubUsername": "gasp"
+        }
+    ]
+}

types/webpack-log/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compilerOptions": {
+        "module": "node16",
+        "lib": [
+            "es6"
+        ],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "files": [
+        "index.d.ts",
+        "webpack-log-tests.ts"
+    ]
+}

types/webpack-log/webpack-log-tests.ts

@@ -0,0 +1,34 @@
+import getLogger = require("webpack-log");
+
+// Create logger with default options
+const log = getLogger();
+
+// Create logger with name
+const namedLog = getLogger({ name: "my-webpack-plugin" });
+
+// Create logger with all options
+const fullLog = getLogger({
+    name: "webpack-plugin",
+    level: "debug",
+    timestamp: true,
+    unique: false,
+});
+
+// Test log methods
+log.trace("trace message");
+log.debug("debug message");
+log.info("info message");
+log.warn("warning message");
+log.error("error message");
+
+// Test with multiple arguments
+log.info("message", { data: 123 });
+log.error("error", new Error("test"));
+
+// Test log level options
+getLogger({ level: "trace" });
+getLogger({ level: "debug" });
+getLogger({ level: "info" });
+getLogger({ level: "warn" });
+getLogger({ level: "error" });
+getLogger({ level: "silent" });