@vc-shell/framework 1.2.1 → 1.2.3-beta.0

package/dist/core/utilities/logger.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Logger utility for consistent logging throughout the framework.
+ * Provides conditional logging based on environment and log levels.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "none";
+/**
+ * Creates a logger instance with optional context prefix
+ * @param context - Additional context prefix for log messages
+ * @returns Logger instance with log methods
+ */
+export declare function createLogger(context?: string): {
+    /**
+     * Log debug messages (only in development)
+     */
+    debug: (...args: unknown[]) => void;
+    /**
+     * Log info messages
+     */
+    info: (...args: unknown[]) => void;
+    /**
+     * Log warning messages
+     */
+    warn: (...args: unknown[]) => void;
+    /**
+     * Log error messages
+     */
+    error: (...args: unknown[]) => void;
+    /**
+     * Create a child logger with additional context
+     */
+    child: (childContext: string) => /*elided*/ any;
+    /**
+     * Set the log level for this logger instance
+     */
+    setLevel: (level: LogLevel) => void;
+    /**
+     * Enable or disable logging
+     */
+    setEnabled: (enabled: boolean) => void;
+};
+/**
+ * Default logger instance for general framework logging
+ */
+export declare const logger: {
+    /**
+     * Log debug messages (only in development)
+     */
+    debug: (...args: unknown[]) => void;
+    /**
+     * Log info messages
+     */
+    info: (...args: unknown[]) => void;
+    /**
+     * Log warning messages
+     */
+    warn: (...args: unknown[]) => void;
+    /**
+     * Log error messages
+     */
+    error: (...args: unknown[]) => void;
+    /**
+     * Create a child logger with additional context
+     */
+    child: (childContext: string) => /*elided*/ any;
+    /**
+     * Set the log level for this logger instance
+     */
+    setLevel: (level: LogLevel) => void;
+    /**
+     * Enable or disable logging
+     */
+    setEnabled: (enabled: boolean) => void;
+};
+/**
+ * Pre-configured loggers for common contexts
+ */
+export declare const loggers: {
+    core: {
+        /**
+         * Log debug messages (only in development)
+         */
+        debug: (...args: unknown[]) => void;
+        /**
+         * Log info messages
+         */
+        info: (...args: unknown[]) => void;
+        /**
+         * Log warning messages
+         */
+        warn: (...args: unknown[]) => void;
+        /**
+         * Log error messages
+         */
+        error: (...args: unknown[]) => void;
+        /**
+         * Create a child logger with additional context
+         */
+        child: (childContext: string) => /*elided*/ any;
+        /**
+         * Set the log level for this logger instance
+         */
+        setLevel: (level: LogLevel) => void;
+        /**
+         * Enable or disable logging
+         */
+        setEnabled: (enabled: boolean) => void;
+    };
+    ui: {
+        /**
+         * Log debug messages (only in development)
+         */
+        debug: (...args: unknown[]) => void;
+        /**
+         * Log info messages
+         */
+        info: (...args: unknown[]) => void;
+        /**
+         * Log warning messages
+         */
+        warn: (...args: unknown[]) => void;
+        /**
+         * Log error messages
+         */
+        error: (...args: unknown[]) => void;
+        /**
+         * Create a child logger with additional context
+         */
+        child: (childContext: string) => /*elided*/ any;
+        /**
+         * Set the log level for this logger instance
+         */
+        setLevel: (level: LogLevel) => void;
+        /**
+         * Enable or disable logging
+         */
+        setEnabled: (enabled: boolean) => void;
+    };
+    shared: {
+        /**
+         * Log debug messages (only in development)
+         */
+        debug: (...args: unknown[]) => void;
+        /**
+         * Log info messages
+         */
+        info: (...args: unknown[]) => void;
+        /**
+         * Log warning messages
+         */
+        warn: (...args: unknown[]) => void;
+        /**
+         * Log error messages
+         */
+        error: (...args: unknown[]) => void;
+        /**
+         * Create a child logger with additional context
+         */
+        child: (childContext: string) => /*elided*/ any;
+        /**
+         * Set the log level for this logger instance
+         */
+        setLevel: (level: LogLevel) => void;
+        /**
+         * Enable or disable logging
+         */
+        setEnabled: (enabled: boolean) => void;
+    };
+    plugins: {
+        /**
+         * Log debug messages (only in development)
+         */
+        debug: (...args: unknown[]) => void;
+        /**
+         * Log info messages
+         */
+        info: (...args: unknown[]) => void;
+        /**
+         * Log warning messages
+         */
+        warn: (...args: unknown[]) => void;
+        /**
+         * Log error messages
+         */
+        error: (...args: unknown[]) => void;
+        /**
+         * Create a child logger with additional context
+         */
+        child: (childContext: string) => /*elided*/ any;
+        /**
+         * Set the log level for this logger instance
+         */
+        setLevel: (level: LogLevel) => void;
+        /**
+         * Enable or disable logging
+         */
+        setEnabled: (enabled: boolean) => void;
+    };
+    services: {
+        /**
+         * Log debug messages (only in development)
+         */
+        debug: (...args: unknown[]) => void;
+        /**
+         * Log info messages
+         */
+        info: (...args: unknown[]) => void;
+        /**
+         * Log warning messages
+         */
+        warn: (...args: unknown[]) => void;
+        /**
+         * Log error messages
+         */
+        error: (...args: unknown[]) => void;
+        /**
+         * Create a child logger with additional context
+         */
+        child: (childContext: string) => /*elided*/ any;
+        /**
+         * Set the log level for this logger instance
+         */
+        setLevel: (level: LogLevel) => void;
+        /**
+         * Enable or disable logging
+         */
+        setEnabled: (enabled: boolean) => void;
+    };
+    composables: {
+        /**
+         * Log debug messages (only in development)
+         */
+        debug: (...args: unknown[]) => void;
+        /**
+         * Log info messages
+         */
+        info: (...args: unknown[]) => void;
+        /**
+         * Log warning messages
+         */
+        warn: (...args: unknown[]) => void;
+        /**
+         * Log error messages
+         */
+        error: (...args: unknown[]) => void;
+        /**
+         * Create a child logger with additional context
+         */
+        child: (childContext: string) => /*elided*/ any;
+        /**
+         * Set the log level for this logger instance
+         */
+        setLevel: (level: LogLevel) => void;
+        /**
+         * Enable or disable logging
+         */
+        setEnabled: (enabled: boolean) => void;
+    };
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/utilities/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../core/utilities/logger.ts"],"names":[],"mappings":"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"}