@adaas/a-utils 0.2.8 → 0.3.1

package/.conf/tsconfig.base.json

@@ -0,0 +1,91 @@
+{
+    "$schema": "https://json.schemastore.org/tsconfig",
+
+    "compilerOptions": {
+        "rootDir": "../",
+        "useDefineForClassFields": false,
+        // "isolatedModules": true,
+
+        /* ===============================
+           Output (tsup controls formats)
+           =============================== */
+        "outDir": "dist",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "emitDeclarationOnly": false,
+
+        /* ===============================
+           Language & runtime
+           =============================== */
+        "target": "ES2022",
+        "lib": ["ES2022", "DOM"],
+
+        /* ===============================
+           Module system (CRITICAL)
+           =============================== */
+        "module": "nodenext",
+        "moduleResolution": "NodeNext",
+
+        /* ===============================
+           Interop & compatibility
+           =============================== */
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "resolveJsonModule": true,
+
+        /* ===============================
+           Type checking
+           =============================== */
+        "strict": true,
+        "noImplicitAny": false,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "strictPropertyInitialization": true,
+        "noFallthroughCasesInSwitch": true,
+
+        /* ===============================
+           Developer experience
+           =============================== */
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "noErrorTruncation": true,
+
+        /* ===============================
+           Decorators (if used)
+           =============================== */
+        "experimentalDecorators": true,
+
+        /* ===============================
+           Internal path aliases ONLY
+           =============================== */
+        "baseUrl": ".",
+        "paths": {
+            "@adaas/a-utils/a-channel": ["src/lib/A-Channel"],
+            "@adaas/a-utils/a-command": ["src/lib/A-Command"],
+            "@adaas/a-utils/a-config": ["src/lib/A-Config"],
+            "@adaas/a-utils/a-execution": ["src/lib/A-Execution"],
+            "@adaas/a-utils/a-logger": ["src/lib/A-Logger"],
+            "@adaas/a-utils/a-manifest": ["src/lib/A-Manifest"],
+            "@adaas/a-utils/a-memory": ["src/lib/A-Memory"],
+            "@adaas/a-utils/a-operation": ["src/lib/A-Operation"],
+            "@adaas/a-utils/a-route": ["src/lib/A-Route"],
+            "@adaas/a-utils/a-schedule": ["src/lib/A-Schedule"],
+            "@adaas/a-utils/a-service": ["src/lib/A-Service"],
+            "@adaas/a-utils/a-signal": ["src/lib/A-Signal"],
+            "@adaas/a-utils/a-state-machine": ["src/lib/A-StateMachine"]
+        },
+        /* ===============================
+           Types
+           =============================== */
+        // "typeRoots": ["node_modules/@types"]
+    },
+    "include": [
+        "../src/**/*",
+    ],
+    "exclude": [
+        "../node_modules",
+        "../dist",
+        "**/*.spec.ts"
+    ]
+}

package/.conf/tsconfig.browser.json

@@ -0,0 +1,26 @@
+{
+   "extends": "./tsconfig.base.json",
+   "compilerOptions": {
+      "rootDir": "../",
+      "outDir": "dist/browser",
+      "baseUrl": "../",
+
+      "paths": {
+         "@adaas/a-utils/a-channel": ["src/lib/A-Channel"],
+         "@adaas/a-utils/a-command": ["src/lib/A-Command"],
+         "@adaas/a-utils/a-config": ["src/lib/A-Config"],
+         "@adaas/a-utils/a-execution": ["src/lib/A-Execution"],
+         "@adaas/a-utils/a-logger": ["src/lib/A-Logger"],
+         "@adaas/a-utils/a-manifest": ["src/lib/A-Manifest"],
+         "@adaas/a-utils/a-memory": ["src/lib/A-Memory"],
+         "@adaas/a-utils/a-operation": ["src/lib/A-Operation"],
+         // Note: A-Polyfill is a special case with separate entry points for Node and browser, so we alias it directly to the Node version here. Consumers can import the browser version directly if needed.
+         "@adaas/a-utils/a-polyfill": ["src/lib/A-Polyfill/index.browser"],
+         "@adaas/a-utils/a-route": ["src/lib/A-Route"],
+         "@adaas/a-utils/a-schedule": ["src/lib/A-Schedule"],
+         "@adaas/a-utils/a-service": ["src/lib/A-Service"],
+         "@adaas/a-utils/a-signal": ["src/lib/A-Signal"],
+         "@adaas/a-utils/a-state-machine": ["src/lib/A-StateMachine"]
+      },
+   },
+}

package/.conf/tsconfig.node.json

@@ -0,0 +1,30 @@
+{
+   "extends": "./tsconfig.base.json",
+   "compilerOptions": {
+      "rootDir": "../",
+      "outDir": "dist/node",
+      "baseUrl": "../",
+      
+      "paths": {
+         "@adaas/a-utils/a-channel": ["src/lib/A-Channel"],
+         "@adaas/a-utils/a-command": ["src/lib/A-Command"],
+         "@adaas/a-utils/a-config": ["src/lib/A-Config"],
+         "@adaas/a-utils/a-execution": ["src/lib/A-Execution"],
+         "@adaas/a-utils/a-logger": ["src/lib/A-Logger"],
+         "@adaas/a-utils/a-manifest": ["src/lib/A-Manifest"],
+         "@adaas/a-utils/a-memory": ["src/lib/A-Memory"],
+         "@adaas/a-utils/a-operation": ["src/lib/A-Operation"],
+         // Note: A-Polyfill is a special case with separate entry points for Node and browser, so we alias it directly to the Node version here. Consumers can import the browser version directly if needed.
+         "@adaas/a-utils/a-polyfill": ["src/lib/A-Polyfill/index.node"],
+         "@adaas/a-utils/a-route": ["src/lib/A-Route"],
+         "@adaas/a-utils/a-schedule": ["src/lib/A-Schedule"],
+         "@adaas/a-utils/a-service": ["src/lib/A-Service"],
+         "@adaas/a-utils/a-signal": ["src/lib/A-Signal"],
+         "@adaas/a-utils/a-state-machine": ["src/lib/A-StateMachine"]
+      },
+
+      "types": [
+         "node"
+      ],
+   },
+}

package/dist/browser/A-Logger.component-Be-LMV3I.d.mts

@@ -0,0 +1,467 @@
+import { A_TYPES__ConceptENVVariables, A_TYPES__Fragment_Constructor, A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY, A_Component, A_Scope, A_Error } from '@adaas/a-concept';
+import { A_ExecutionContext } from './a-execution.mjs';
+
+declare enum A_TYPES__ConfigFeature {
+}
+type A_TYPES__ConfigContainerConstructor<T extends Array<string | A_TYPES__ConceptENVVariables[number]>> = {
+    /**
+     * If set to true, the SDK will throw an error if the variable is not defined OR not presented in the defaults
+     */
+    strict: boolean;
+    /**
+     * Allows to define the names of variable to be loaded
+     */
+    variables: T;
+    /**
+     * Allows to set the default values for the variables
+     */
+    defaults: {
+        [key in T[number]]?: any;
+    };
+} & A_TYPES__Fragment_Constructor;
+
+declare const A_CONSTANTS__CONFIG_ENV_VARIABLES: {};
+type A_TYPES__ConfigENVVariables = (typeof A_CONSTANTS__CONFIG_ENV_VARIABLES)[keyof typeof A_CONSTANTS__CONFIG_ENV_VARIABLES][];
+declare const A_CONSTANTS__CONFIG_ENV_VARIABLES_ARRAY: readonly [];
+
+declare class A_Config<T extends Array<string | A_TYPES__ConceptENVVariables[number]> = any[]> extends A_ExecutionContext<{
+    [key in T[number]]: any;
+} & {
+    [key in typeof A_CONSTANTS__DEFAULT_ENV_VARIABLES_ARRAY[number]]: any;
+} & {
+    [key in typeof A_CONSTANTS__CONFIG_ENV_VARIABLES_ARRAY[number]]: any;
+}> {
+    protected _strict: boolean;
+    protected _configProperties: T;
+    protected DEFAULT_ALLOWED_TO_READ_PROPERTIES: ("A_CONCEPT_NAME" | "A_CONCEPT_ROOT_SCOPE" | "A_CONCEPT_ENVIRONMENT" | "A_CONCEPT_RUNTIME_ENVIRONMENT" | "A_CONCEPT_ROOT_FOLDER" | "A_ERROR_DEFAULT_DESCRIPTION")[];
+    constructor(config: Partial<A_TYPES__ConfigContainerConstructor<T>>);
+    get strict(): boolean;
+    /**
+      * This method is used to get the configuration property by name
+      *
+      * @param property
+      * @returns
+      */
+    get<K extends T[number]>(property: K | typeof this.DEFAULT_ALLOWED_TO_READ_PROPERTIES[number]): {
+        [key in T[number]]: any;
+    }[K] | undefined;
+    /**
+     *
+     * This method is used to set the configuration property by name
+     * OR set multiple properties at once by passing an array of objects
+     *
+     * @param variables
+     */
+    set(variables: Array<{
+        property: T[number] | A_TYPES__ConceptENVVariables[number];
+        value: any;
+    }>): any;
+    set(variables: Partial<Record<T[number] | A_TYPES__ConceptENVVariables[number], any>>): any;
+    set(property: T[number] | A_TYPES__ConceptENVVariables[number], value: any): any;
+}
+
+declare const A_LoggerEnvVariables: {
+    /**
+     * Sets the log level for the logger
+     *
+     * @example 'debug', 'info', 'warn', 'error'
+     */
+    readonly A_LOGGER_LEVEL: "A_LOGGER_LEVEL";
+    /**
+     * Sets the default scope length for log messages
+     *
+     * @example 'A_LOGGER_DEFAULT_SCOPE_LENGTH'
+     */
+    readonly A_LOGGER_DEFAULT_SCOPE_LENGTH: "A_LOGGER_DEFAULT_SCOPE_LENGTH";
+    /**
+     * Sets the default color for scope display in log messages
+     *
+     * @example 'green', 'blue', 'red', 'yellow', 'gray', 'magenta', 'cyan', 'white', 'pink'
+     */
+    readonly A_LOGGER_DEFAULT_SCOPE_COLOR: "A_LOGGER_DEFAULT_SCOPE_COLOR";
+    /**
+     * Sets the default color for log message content
+     *
+     * @example 'green', 'blue', 'red', 'yellow', 'gray', 'magenta', 'cyan', 'white', 'pink'
+     */
+    readonly A_LOGGER_DEFAULT_LOG_COLOR: "A_LOGGER_DEFAULT_LOG_COLOR";
+};
+declare const A_LoggerEnvVariablesArray: readonly ["A_LOGGER_LEVEL", "A_LOGGER_DEFAULT_SCOPE_LENGTH", "A_LOGGER_DEFAULT_SCOPE_COLOR", "A_LOGGER_DEFAULT_LOG_COLOR"];
+type A_LoggerEnvVariablesType = (typeof A_LoggerEnvVariables)[keyof typeof A_LoggerEnvVariables][];
+
+type A_LoggerLevel = 'debug' | 'info' | 'warn' | 'error' | 'all';
+/**
+ * Available color names for the logger
+ * Can be used as first parameter in logging methods to specify message color
+ */
+type A_LoggerColorName = 'red' | 'yellow' | 'green' | 'blue' | 'cyan' | 'magenta' | 'gray' | 'brightBlue' | 'brightCyan' | 'brightMagenta' | 'darkGray' | 'lightGray' | 'indigo' | 'violet' | 'purple' | 'lavender' | 'skyBlue' | 'steelBlue' | 'slateBlue' | 'deepBlue' | 'lightBlue' | 'periwinkle' | 'cornflower' | 'powder' | 'charcoal' | 'silver' | 'smoke' | 'slate';
+
+/**
+ * A_Logger - Advanced Logging Component with Scope-based Output Formatting
+ *
+ * This component provides comprehensive logging capabilities with:
+ * - Color-coded console output for different log levels
+ * - Scope-based message formatting with consistent alignment
+ * - Support for multiple data types (objects, errors, strings)
+ * - Configurable log levels for filtering output
+ * - Special handling for A_Error and native Error objects
+ * - Timestamp inclusion for better debugging
+ *
+ * Key Features:
+ * - **Scope Integration**: Uses A_Scope for consistent message prefixing
+ * - **Color Support**: Terminal color codes for visual distinction
+ * - **Object Formatting**: Pretty-prints JSON objects with proper indentation
+ * - **Error Handling**: Special formatting for A_Error and Error objects
+ * - **Log Level Filtering**: Configurable filtering based on severity
+ * - **Multi-line Support**: Proper alignment for multi-line messages
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with dependency injection (uses deterministic colors based on scope name)
+ * class MyService {
+ *   constructor(@A_Inject(A_Logger) private logger: A_Logger) {}
+ *
+ *   doSomething() {
+ *     this.logger.info('Processing started'); // Uses scope-name-based colors, always shows
+ *     this.logger.debug('Debug information'); // Only shows when debug level enabled
+ *
+ *     // Color overload methods with enum support
+ *     this.logger.info('green', 'Success message'); // Green message, scope stays default
+ *     this.logger.debug('gray', 'Verbose debug info'); // Gray message for less important info
+ *     this.logger.info('brightBlue', 'Important notification');
+ *
+ *     // Terminal width aware formatting - automatically wraps long lines
+ *     this.logger.info('This is a very long message that will be automatically wrapped to fit within the terminal width while maintaining proper indentation and formatting');
+ *
+ *     this.logger.warning('Something might be wrong');
+ *     this.logger.error(new Error('Something failed'));
+ *   }
+ * }
+ *
+ * // Same scope names will always get the same colors automatically
+ * const logger1 = new A_Logger(new A_Scope({name: 'UserService'})); // Gets consistent colors
+ * const logger2 = new A_Logger(new A_Scope({name: 'UserService'})); // Gets same colors as logger1
+ *
+ * // Available color names (A_LoggerColorName enum):
+ * // 'red', 'yellow', 'green', 'blue', 'cyan', 'magenta', 'gray',
+ * // 'brightBlue', 'brightCyan', 'brightMagenta', 'darkGray', 'lightGray',
+ * // 'indigo', 'violet', 'purple', 'lavender', 'skyBlue', 'steelBlue',
+ * // 'slateBlue', 'deepBlue', 'lightBlue', 'periwinkle', 'cornflower',
+ * // 'powder', 'charcoal', 'silver', 'smoke', 'slate'
+ *
+ * // Configuration via environment variables or A_Config (overrides automatic selection)
+ * process.env.A_LOGGER_DEFAULT_SCOPE_COLOR = 'magenta';
+ * process.env.A_LOGGER_DEFAULT_LOG_COLOR = 'green';
+ *
+ * // Or through A_Config instance
+ * const config = new A_Config({
+ *   A_LOGGER_DEFAULT_SCOPE_COLOR: 'red',
+ *   A_LOGGER_DEFAULT_LOG_COLOR: 'white'
+ * });
+ * const logger = new A_Logger(scope, config);
+ * ```
+ */
+declare class A_Logger extends A_Component {
+    protected scope: A_Scope;
+    protected config?: A_Config<A_LoggerEnvVariablesType> | undefined;
+    /**
+     * Terminal color codes for different log levels and custom styling
+     * These codes work with ANSI escape sequences for colored terminal output
+     */
+    readonly COLORS: any;
+    /**
+     * Standard scope length for consistent formatting
+     * This ensures all log messages align properly regardless of scope name length
+     */
+    private readonly STANDARD_SCOPE_LENGTH;
+    /**
+     * Default color for the scope portion of log messages
+     * This color is used for the scope brackets and content, and remains consistent
+     * for this logger instance regardless of message color overrides
+     */
+    private readonly DEFAULT_SCOPE_COLOR;
+    /**
+     * Default color for log message content when no explicit color is provided
+     * This color is used for the message body when logging without specifying a color
+     */
+    private readonly DEFAULT_LOG_COLOR;
+    /**
+     * Current terminal width for responsive formatting
+     * Automatically detected or falls back to default values
+     */
+    private readonly TERMINAL_WIDTH;
+    /**
+     * Maximum content width based on terminal size
+     * Used for word wrapping and line length calculations
+     */
+    private readonly MAX_CONTENT_WIDTH;
+    /**
+     * Initialize A_Logger with dependency injection
+     * Colors are configured through A_Config or generated randomly if not provided
+     *
+     * @param scope - The current scope context for message prefixing
+     * @param config - Optional configuration for log level filtering and color settings
+     */
+    constructor(scope: A_Scope, config?: A_Config<A_LoggerEnvVariablesType> | undefined);
+    /**
+     * Generate a simple hash from a string
+     * Used to create deterministic color selection based on scope name
+     *
+     * @param str - The string to hash
+     * @returns A numeric hash value
+     */
+    private simpleHash;
+    /**
+     * Generate a deterministic color based on scope name
+     * Same scope names will always get the same color, but uses safe color palette
+     *
+     * @param scopeName - The scope name to generate color for
+     * @returns A color key from the safe colors palette
+     */
+    private generateColorFromScopeName;
+    /**
+     * Generate a pair of complementary colors based on scope name
+     * Ensures visual harmony between scope and message colors while being deterministic
+     *
+     * @param scopeName - The scope name to base colors on
+     * @returns Object with scopeColor and logColor that work well together
+     */
+    private generateComplementaryColorsFromScope;
+    /**
+     * Detect current terminal width based on environment
+     *
+     * Returns appropriate width for different environments:
+     * - Node.js: Uses process.stdout.columns if available
+     * - Browser: Returns browser default width
+     * - Fallback: Returns default terminal width
+     *
+     * @returns Terminal width in characters
+     */
+    private detectTerminalWidth;
+    /**
+     * Wrap text to fit within terminal width while preserving formatting
+     *
+     * @param text - Text to wrap
+     * @param scopePadding - The scope padding string for alignment
+     * @param isFirstLine - Whether this is the first line (affects available width calculation)
+     * @returns Array of wrapped lines with proper indentation
+     */
+    private wrapText;
+    /**
+     * Split a long word that doesn't fit on a single line
+     *
+     * @param word - Word to split
+     * @param maxLength - Maximum length per chunk
+     * @returns Array of word chunks
+     */
+    private splitLongWord;
+    /**
+     * Get the formatted scope length for consistent message alignment
+     * Uses a standard length to ensure all messages align properly regardless of scope name
+     *
+     * @returns The scope length to use for padding calculations
+     */
+    get scopeLength(): number;
+    /**
+     * Get the formatted scope name with proper padding, centered within the container
+     * Ensures consistent width for all scope names in log output with centered alignment
+     *
+     * @returns Centered and padded scope name for consistent formatting
+     */
+    get formattedScope(): string;
+    /**
+     * Compile log arguments into formatted console output with colors and proper alignment
+     *
+     * This method handles the core formatting logic for all log messages:
+     * - Applies separate colors for scope and message content
+     * - Formats scope names with consistent padding
+     * - Handles different data types appropriately
+     * - Maintains proper indentation for multi-line content
+     *
+     * @param messageColor - The color key to apply to the message content
+     * @param args - Variable arguments to format and display
+     * @returns Array of formatted strings and/or objects ready for console output
+     */
+    compile(messageColor: keyof typeof this.COLORS, ...args: any[]): Array<any>;
+    /**
+     * Format an object for display with proper JSON indentation and terminal width awareness
+     *
+     * @param obj - The object to format
+     * @param shouldAddNewline - Whether to add a newline prefix
+     * @param scopePadding - The padding string for consistent alignment
+     * @returns Formatted object string or the object itself for browser environments
+     */
+    private formatObject;
+    /**
+     * Wrap a long JSON string value while preserving readability
+     *
+     * @param value - The string value to wrap
+     * @param maxWidth - Maximum width for the value
+     * @returns Wrapped string value
+     */
+    private wrapJsonStringValue;
+    /**
+     * Format a string for display with proper indentation and terminal width wrapping
+     *
+     * @param str - The string to format
+     * @param shouldAddNewline - Whether to add a newline prefix
+     * @param scopePadding - The padding string for consistent alignment
+     * @returns Formatted string
+     */
+    private formatString;
+    /**
+     * Determine if a log message should be output based on configured log level
+     *
+     * Log level hierarchy:
+     * - debug: Shows all messages (debug, info, warning, error)
+     * - info: Shows info, warning, and error messages
+     * - warn: Shows warning and error messages only
+     * - error: Shows error messages only
+     * - all: Shows all messages (alias for debug)
+     *
+     * @param logMethod - The type of log method being called
+     * @returns True if the message should be logged, false otherwise
+     */
+    protected shouldLog(logMethod: 'debug' | 'info' | 'warning' | 'error'): boolean;
+    /**
+     * Debug logging method with optional color specification
+     * Only logs when debug level is enabled
+     *
+     * Supports two usage patterns:
+     * 1. debug(message, ...args) - Uses instance's default log color
+     * 2. debug(color, message, ...args) - Uses specified color for message content only
+     *
+     * Note: The scope color always remains the instance's default scope color,
+     * only the message content color changes when explicitly specified.
+     *
+     * @param color - Optional color name from A_LoggerColorName enum or the first message argument
+     * @param args - Additional arguments to log
+     *
+     * @example
+     * ```typescript
+     * logger.debug('Debug information'); // Uses instance default colors
+     * logger.debug('gray', 'Debug message'); // Gray message, scope stays instance color
+     * logger.debug('Processing user:', { id: 1, name: 'John' });
+     * ```
+     */
+    debug(color: A_LoggerColorName, ...args: any[]): void;
+    debug(...args: any[]): void;
+    /**
+     * Info logging method with optional color specification
+     * Logs without any restrictions (always shows regardless of log level)
+     *
+     * Supports two usage patterns:
+     * 1. info(message, ...args) - Uses instance's default log color
+     * 2. info(color, message, ...args) - Uses specified color for message content only
+     *
+     * Note: The scope color always remains the instance's default scope color,
+     * only the message content color changes when explicitly specified.
+     *
+     * @param color - Optional color name from A_LoggerColorName enum or the first message argument
+     * @param args - Additional arguments to log
+     *
+     * @example
+     * ```typescript
+     * logger.info('Hello World'); // Uses instance default colors
+     * logger.info('green', 'Success message'); // Green message, scope stays instance color
+     * logger.info('Processing user:', { id: 1, name: 'John' });
+     * ```
+     */
+    info(color: A_LoggerColorName, ...args: any[]): void;
+    info(...args: any[]): void;
+    /**
+     * Legacy log method (kept for backward compatibility)
+     * @deprecated Use info() method instead
+     *
+     * @param color - Optional color name from A_LoggerColorName enum or the first message argument
+     * @param args - Additional arguments to log
+     */
+    log(color: A_LoggerColorName, ...args: any[]): void;
+    log(...args: any[]): void;
+    /**
+     * Log warning messages with yellow color coding
+     *
+     * Use for non-critical issues that should be brought to attention
+     * but don't prevent normal operation
+     *
+     * @param args - Arguments to log as warnings
+     *
+     * @example
+     * ```typescript
+     * logger.warning('Deprecated method used');
+     * logger.warning('Rate limit approaching:', { current: 95, limit: 100 });
+     * ```
+     */
+    warning(...args: any[]): void;
+    /**
+     * Log error messages with red color coding
+     *
+     * Use for critical issues, exceptions, and failures that need immediate attention
+     *
+     * @param args - Arguments to log as errors
+     * @returns void (for compatibility with console.log)
+     *
+     * @example
+     * ```typescript
+     * logger.error('Database connection failed');
+     * logger.error(new Error('Validation failed'));
+     * logger.error('Critical error:', error, { context: 'user-registration' });
+     * ```
+     */
+    error(...args: any[]): void;
+    /**
+     * Legacy method for A_Error logging (kept for backward compatibility)
+     *
+     * @deprecated Use error() method instead which handles A_Error automatically
+     * @param error - The A_Error instance to log
+     */
+    protected log_A_Error(error: A_Error): void;
+    /**
+     * Format A_Error instances for inline display within compiled messages
+     *
+     * Provides detailed formatting for A_Error objects with:
+     * - Error code, message, and description
+     * - Original error information FIRST (better UX for debugging)
+     * - Stack traces with terminal width awareness
+     * - Documentation links (if available)
+     * - Consistent formatting with rest of logger
+     *
+     * @param error - The A_Error instance to format
+     * @returns Formatted string ready for display
+     */
+    protected compile_A_Error(error: A_Error): string;
+    /**
+     * Format stack trace with proper terminal width wrapping and indentation
+     *
+     * @param stack - The stack trace string
+     * @param baseIndent - Base indentation for continuation lines
+     * @returns Array of formatted stack trace lines
+     */
+    private formatStackTrace;
+    /**
+     * Format standard Error instances for inline display within compiled messages
+     *
+     * Provides clean, readable formatting for standard JavaScript errors with:
+     * - Terminal width aware message wrapping
+     * - Properly formatted stack traces
+     * - Consistent indentation with rest of logger
+     *
+     * @param error - The Error instance to format
+     * @returns Formatted string ready for display
+     */
+    protected compile_Error(error: Error): string;
+    /**
+     * Generate timestamp string for log messages
+     *
+     * Format: MM:SS:mmm (minutes:seconds:milliseconds)
+     * This provides sufficient precision for debugging while remaining readable
+     *
+     * @returns Formatted timestamp string
+     *
+     * @example
+     * Returns: "15:42:137" for 3:42:15 PM and 137 milliseconds
+     */
+    protected getTime(): string;
+}
+
+export { A_Logger as A, type A_LoggerColorName as a, A_LoggerEnvVariables as b, A_LoggerEnvVariablesArray as c, type A_LoggerEnvVariablesType as d, type A_LoggerLevel as e, A_Config as f, A_CONSTANTS__CONFIG_ENV_VARIABLES as g, A_CONSTANTS__CONFIG_ENV_VARIABLES_ARRAY as h, type A_TYPES__ConfigContainerConstructor as i, type A_TYPES__ConfigENVVariables as j, A_TYPES__ConfigFeature as k };