@mks2508/better-logger 0.14.0-alpha.2 → 0.18.2-alpha.1

package/dist/playground/header.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Header renderer for CLI primitives
+ */
+/**
+ * Renders a styled header with optional subtitle
+ * @param title - Main title text
+ * @param subtitle - Optional subtitle (rendered dimmed)
+ * @returns Formatted header string
+ */
+export declare function renderHeader(title: string, subtitle?: string): string;
+//# sourceMappingURL=header.d.ts.map

package/dist/playground/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../src/playground/header.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIrE"}

package/dist/playground/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Playground subpath barrel — visual CLI helpers.
+ * Raw rendering functions used by TerminalBridge.
+ */
+export { renderBox } from './box.js';
+export { renderTable } from './cli-table.js';
+export { renderStep } from './step.js';
+export { SpinnerManager, NoopSpinner } from './spinner.js';
+export { renderHeader } from './header.js';
+export { renderDivider } from './divider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/playground/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/playground/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/playground/server-fallback.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Server/JSON fallback for CLI primitives in non-TTY environments
+ */
+import type { IBoxOptions, ITableOptions } from '../types/core.js';
+import type { Logger } from '../Logger.js';
+/**
+ * Server-mode fallback: outputs CLI primitives as plain logger calls
+ * when not running in an interactive terminal.
+ *
+ */
+export declare class ServerFallback {
+    private logger;
+    constructor(logger: Logger);
+    /** Render step as plain info log */
+    step(current: number, total: number, msg: string): void;
+    /** Render header as plain info log */
+    header(title: string, subtitle?: string): void;
+    /** Divider is a no-op in server mode */
+    divider(): void;
+    /** Blank line is a no-op in server mode */
+    blank(): void;
+    /** Render box content as plain info log */
+    box(content: string, _options?: IBoxOptions): void;
+    /** Render table rows as plain info logs */
+    cliTable(rows: Record<string, unknown>[], _options?: ITableOptions): void;
+}
+//# sourceMappingURL=server-fallback.d.ts.map

package/dist/playground/server-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fallback.d.ts","sourceRoot":"","sources":["../../src/playground/server-fallback.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B,oCAAoC;IACpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvD,sCAAsC;IACtC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAK9C,wCAAwC;IACxC,OAAO,IAAI,IAAI;IAIf,2CAA2C;IAC3C,KAAK,IAAI,IAAI;IAIb,2CAA2C;IAC3C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI;IAIlD,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI;CAK5E"}

package/dist/playground/spinner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Built-in spinner implementation for CLI primitives
+ */
+import type { ISpinnerHandle, LoggerConfig } from '../types/core.js';
+import type { Logger } from '../Logger.js';
+/**
+ * Interactive terminal spinner with in-place line updates.
+ * Writes to stderr to avoid polluting piped stdout.
+ *
+ * @implements {ISpinnerHandle}
+ */
+export declare class SpinnerManager implements ISpinnerHandle {
+    private message;
+    private frameIndex;
+    private interval;
+    private _logger;
+    constructor(message: string, _config: LoggerConfig, logger: Logger);
+    /** Start the spinner animation */
+    start(): void;
+    /** Stop the spinner without a status message */
+    stop(): void;
+    /** Stop with a success indicator */
+    succeed(msg?: string): void;
+    /** Stop with a failure indicator */
+    fail(msg?: string): void;
+    /** Update the spinner text while running */
+    text(msg: string): void;
+    private render;
+    private clearLine;
+    private clearInterval;
+}
+/**
+ * No-op spinner for non-TTY environments or silent mode.
+ * Logs start/succeed/fail as plain log messages.
+ *
+ * @implements {ISpinnerHandle}
+ */
+export declare class NoopSpinner implements ISpinnerHandle {
+    private message;
+    private _logger;
+    constructor(message: string, logger: Logger);
+    start(): void;
+    stop(): void;
+    succeed(msg?: string): void;
+    fail(msg?: string): void;
+    text(msg: string): void;
+}
+//# sourceMappingURL=spinner.d.ts.map

package/dist/playground/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/playground/spinner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAS3C;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,cAAc;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IAKlE,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAcb,gDAAgD;IAChD,IAAI,IAAI,IAAI;IAOZ,oCAAoC;IACpC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3B,oCAAoC;IACpC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQxB,4CAA4C;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;CAMxB;AAED;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,cAAc;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK3C,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAIxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/playground/step.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Step progress renderer for CLI primitives
+ */
+import { type ColorCapability } from '../terminal/color-converter.js';
+/**
+ * Renders a step progress indicator like `  [2/5] Analyzing repository...`
+ * @param current - Current step number
+ * @param total - Total number of steps
+ * @param msg - Step description message
+ * @param colorCap - Terminal color capability
+ * @returns Formatted step string
+ */
+export declare function renderStep(current: number, total: number, msg: string, colorCap: ColorCapability): string;
+//# sourceMappingURL=step.d.ts.map

package/dist/playground/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/playground/step.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAE/F;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAMzG"}

package/dist/playground-module.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Entry point for ./playground subpath.
+ * Visual CLI helpers: box, table, steps, spinner rendering functions.
+ */
+export { renderBox } from './playground/index.js';
+export { renderTable } from './playground/index.js';
+export { renderStep } from './playground/index.js';
+export { SpinnerManager, NoopSpinner } from './playground/index.js';
+export { renderHeader } from './playground/index.js';
+export { renderDivider } from './playground/index.js';
+//# sourceMappingURL=playground-module.d.ts.map

package/dist/playground-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground-module.d.ts","sourceRoot":"","sources":["../src/playground-module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/playground.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_spinner = require("./chunks/spinner-DNvxbM9a.cjs");
+exports.NoopSpinner = require_spinner.NoopSpinner;
+exports.SpinnerManager = require_spinner.SpinnerManager;
+exports.renderBox = require_spinner.renderBox;
+exports.renderDivider = require_spinner.renderDivider;
+exports.renderHeader = require_spinner.renderHeader;
+exports.renderStep = require_spinner.renderStep;
+exports.renderTable = require_spinner.renderTable;

package/dist/playground.js

@@ -0,0 +1,2 @@
+import { a as renderDivider, i as renderBox, n as SpinnerManager, o as renderHeader, r as renderTable, s as renderStep, t as NoopSpinner } from "./chunks/spinner-D3FsF78o.js";
+export { NoopSpinner, SpinnerManager, renderBox, renderDivider, renderHeader, renderStep, renderTable };

package/dist/serializers/SerializerBridge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview SerializerBridge — SerializerRegistry facade.
+ * Encapsulates serializer registration, removal, and registry access.
+ */
+import type { SerializerFn } from '../types/index.js';
+import { SerializerRegistry } from './index.js';
+/**
+ * Bridge for serializer management.
+ */
+export interface SerializerBridge {
+    /** Adds a serializer for a type. */
+    addSerializer<T>(type: new (...args: unknown[]) => T, serializer: SerializerFn<T>, priority?: number): void;
+    removeSerializer<T>(type: new (...args: unknown[]) => T): boolean;
+    /** Returns the underlying registry. */
+    getSerializerRegistry(): SerializerRegistry;
+}
+/**
+ * Creates a SerializerBridge instance.
+ */
+export declare function createSerializerBridge(): SerializerBridge;
+//# sourceMappingURL=SerializerBridge.d.ts.map

package/dist/serializers/SerializerBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializerBridge.d.ts","sourceRoot":"","sources":["../../src/serializers/SerializerBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,oCAAoC;IACpC,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5G,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC;IAClE,uCAAuC;IACvC,qBAAqB,IAAI,kBAAkB,CAAC;CAC/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAgBzD"}

package/dist/serializers/SerializerRegistry.d.ts

@@ -0,0 +1,16 @@
+import type { SerializerFn, SerializerEntry, SerializerConfig, ISerializerRegistry } from '../types/index.js';
+export declare class SerializerRegistry implements ISerializerRegistry {
+    private serializers;
+    private config;
+    constructor(config?: SerializerConfig);
+    private registerDefaults;
+    add<T>(type: new (...args: any[]) => T, serializer: SerializerFn<T>, priority?: number): void;
+    remove<T>(type: new (...args: any[]) => T): boolean;
+    has<T>(type: new (...args: any[]) => T): boolean;
+    getAll(): SerializerEntry[];
+    private findSerializer;
+    private serializeInternal;
+    serialize(value: any, config?: SerializerConfig): any;
+}
+export declare function getDefaultSerializerRegistry(): SerializerRegistry;
+//# sourceMappingURL=SerializerRegistry.d.ts.map

package/dist/serializers/SerializerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializerRegistry.d.ts","sourceRoot":"","sources":["../../src/serializers/SerializerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EAEZ,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACtB,MAAM,mBAAmB,CAAC;AAQ3B,qBAAa,kBAAmB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,GAAE,gBAAqB;IAKzC,OAAO,CAAC,gBAAgB;IAmDxB,GAAG,CAAC,CAAC,EACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAC/B,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,EAC3B,QAAQ,GAAE,MAAW,GACtB,IAAI;IAIP,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO;IAInD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,OAAO;IAIhD,MAAM,IAAI,eAAe,EAAE;IAK3B,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,iBAAiB;IAiDzB,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,GAAG;CASxD;AAID,wBAAgB,4BAA4B,IAAI,kBAAkB,CAKjE"}

package/dist/serializers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Serializers subpath barrel.
+ * Exports: SerializerRegistry, createSerializerBridge, SerializerBridge
+ */
+export { SerializerRegistry, getDefaultSerializerRegistry } from './SerializerRegistry.js';
+export { createSerializerBridge, type SerializerBridge } from './SerializerBridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/serializers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/serializers-module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Entry point for ./serializers subpath.
+ * Serializer registry and bridge.
+ */
+export { SerializerRegistry, getDefaultSerializerRegistry } from './serializers/index.js';
+export { createSerializerBridge, type SerializerBridge } from './serializers/index.js';
+//# sourceMappingURL=serializers-module.d.ts.map

package/dist/serializers-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers-module.d.ts","sourceRoot":"","sources":["../src/serializers-module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/serializers.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_SerializerBridge = require("./chunks/SerializerBridge-BaOQOb8q.cjs");
+exports.SerializerRegistry = require_SerializerBridge.SerializerRegistry;
+exports.createSerializerBridge = require_SerializerBridge.createSerializerBridge;
+exports.getDefaultSerializerRegistry = require_SerializerBridge.getDefaultSerializerRegistry;

package/dist/serializers.js

@@ -0,0 +1,2 @@
+import { n as SerializerRegistry, r as getDefaultSerializerRegistry, t as createSerializerBridge } from "./chunks/SerializerBridge-BkpQu5c9.js";
+export { SerializerRegistry, createSerializerBridge, getDefaultSerializerRegistry };

package/dist/styles/StyleManager.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview StyleManager — style preset and display settings management.
+ * Encapsulates active preset tracking, display toggles, and the
+ * module-level LEVEL_STYLES variable.
+ *
+ * Wired into Logger.ts in F4. Logger delegates style queries and theme
+ * changes through this bridge so that the module-level LEVEL_STYLES stay
+ * in sync across the module.
+ */
+import { THEME_PRESETS } from '../styling/index.js';
+import type { ThemeVariant } from '../types/index.js';
+export { StyleBuilder } from '../styling/index.js';
+/**
+ * Display visibility settings.
+ */
+export interface DisplaySettings {
+    showTimestamp: boolean;
+    showLocation: boolean;
+    showBadges: boolean;
+}
+/**
+ * Active preset state tracked by StyleManager.
+ */
+export interface PresetState {
+    /** The resolved style config (LEVEL_STYLES). */
+    styles: typeof THEME_PRESETS.default;
+    /** The active smart-preset config (if any). */
+    activePreset: unknown;
+    /** Name of the active smart-preset (if any). */
+    activePresetName: string | undefined;
+    /** Last-applied customize() overrides. */
+    customization: unknown;
+    /** Display visibility settings. */
+    displaySettings: DisplaySettings;
+}
+/**
+ * Options for creating StyleManager.
+ */
+export interface IStyleManagerOptions {
+    /** Initial display settings. */
+    initialDisplaySettings?: Partial<DisplaySettings>;
+}
+/**
+ * StyleManager - manages style presets and display settings.
+ */
+export interface StyleManager {
+    /** Returns current display settings. */
+    getDisplaySettings(): DisplaySettings;
+    /** Applies a smart preset by name. Returns true if applied. */
+    applyPreset(name: string): boolean;
+    /** Lists all available presets. */
+    getAvailablePresets(): string[];
+    /** Gets the current LEVEL_STYLES. */
+    getStyles(): typeof THEME_PRESETS.default;
+    /** Gets the active smart-preset config. */
+    getActivePreset(): unknown;
+    /** Gets the active smart-preset name. */
+    getActivePresetName(): string | undefined;
+    /** Gets the active customization overrides. */
+    getCustomization(): unknown;
+    /** Stores customization overrides. */
+    setCustomization(overrides: unknown): void;
+    /** Resolves the effective styles for a theme variant. */
+    resolveThemeStyle(theme: ThemeVariant): typeof THEME_PRESETS.default;
+    /** Sets the active theme by name, updating the module-level LEVEL_STYLES. */
+    setTheme(theme: ThemeVariant): boolean;
+    /** Resets LEVEL_STYLES to the default preset. */
+    resetStyles(): void;
+}
+/**
+ * Creates a StyleManager instance.
+ */
+export declare function createStyleManager(options?: IStyleManagerOptions): StyleManager;
+/**
+ * Module-level active styles — shared across all Logger instances.
+ * Exported so Logger can reference it directly.
+ */
+export declare let LEVEL_STYLES: typeof THEME_PRESETS.default;
+/**
+ * Resets LEVEL_STYLES to default.
+ */
+export declare function resetStyles(): void;
+//# sourceMappingURL=StyleManager.d.ts.map

package/dist/styles/StyleManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StyleManager.d.ts","sourceRoot":"","sources":["../../src/styles/StyleManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACH,aAAa,EAGhB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,mBAAmB,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,gDAAgD;IAChD,MAAM,EAAE,OAAO,aAAa,CAAC,OAAO,CAAC;IACrC,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,mCAAmC;IACnC,eAAe,EAAE,eAAe,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,gCAAgC;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,wCAAwC;IACxC,kBAAkB,IAAI,eAAe,CAAC;IACtC,+DAA+D;IAC/D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,mCAAmC;IACnC,mBAAmB,IAAI,MAAM,EAAE,CAAC;IAChC,qCAAqC;IACrC,SAAS,IAAI,OAAO,aAAa,CAAC,OAAO,CAAC;IAC1C,2CAA2C;IAC3C,eAAe,IAAI,OAAO,CAAC;IAC3B,yCAAyC;IACzC,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1C,+CAA+C;IAC/C,gBAAgB,IAAI,OAAO,CAAC;IAC5B,sCAAsC;IACtC,gBAAgB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,yDAAyD;IACzD,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,aAAa,CAAC,OAAO,CAAC;IACrE,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;IACvC,iDAAiD;IACjD,WAAW,IAAI,IAAI,CAAC;CACvB;AAUD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,YAAY,CA0EnF;AAED;;;GAGG;AACH,eAAO,IAAI,YAAY,EAAE,OAAO,aAAa,CAAC,OAA+B,CAAC;AAE9E;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/styles/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Styles subpath barrel.
+ * Exports: StyleBuilder, StylePresets, THEME_PRESETS, createStyleManager, StyleManager
+ */
+export { StyleBuilder, StylePresets, THEME_PRESETS } from '../styling/index.js';
+export { createStyleManager, type StyleManager, type DisplaySettings, type PresetState } from './StyleManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/styles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/styles/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/styles-module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Entry point for ./styles subpath.
+ * StyleBuilder + themes + presets + StyleManager.
+ */
+export { StyleBuilder, StylePresets, THEME_PRESETS } from './styling/index.js';
+export { createStyleManager, type StyleManager, type DisplaySettings, type PresetState } from './styles/index.js';
+//# sourceMappingURL=styles-module.d.ts.map

package/dist/styles-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles-module.d.ts","sourceRoot":"","sources":["../src/styles-module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/styles.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_styling = require("./chunks/styling-Cg5saQ46.cjs");
+const require_StyleManager = require("./chunks/StyleManager-CIpd6wbO.cjs");
+exports.StyleBuilder = require_styling.StyleBuilder;
+exports.StylePresets = require_styling.StylePresets;
+exports.THEME_PRESETS = require_styling.THEME_PRESETS;
+exports.createStyleManager = require_StyleManager.createStyleManager;

package/dist/styles.js

@@ -0,0 +1,3 @@
+import { c as StyleBuilder, l as StylePresets, s as THEME_PRESETS } from "./chunks/styling-84N8T97t.js";
+import { t as createStyleManager } from "./chunks/StyleManager-LCvVlVdx.js";
+export { StyleBuilder, StylePresets, THEME_PRESETS, createStyleManager };

package/dist/styling/banners.d.ts

@@ -35,11 +35,15 @@ export declare const THEME_BANNERS: Record<ThemeVariant, {
     style: string;
 }>;
 /**
- * Feature detection for banner capabilities
+ * Feature detection for banner capabilities. Returns `'simple'` immediately
+ * if neither `navigator` nor `document` exist (Node, SSR, workers).
+ *
  */
 export declare function detectBannerCapabilities(): BannerType;
 /**
- * Display initialization banner with advanced styling
+ * Display initialization banner with advanced styling. No-op in Node,
+ * SSR, or Web Workers (DOM-guard at the top).
+ *
  */
 export declare function displayInitBanner(bannerType?: BannerType): void;
 //# sourceMappingURL=banners.d.ts.map

package/dist/styling/banners.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"banners.d.ts","sourceRoot":"","sources":["../../src/styling/banners.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;CAoD3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyBjF,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,UAAU,CA2BrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAuC/D"}
+{"version":3,"file":"banners.d.ts","sourceRoot":"","sources":["../../src/styling/banners.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;CAoD3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyBjF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,UAAU,CA8BrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAyC/D"}

package/dist/styling/index.d.ts

@@ -1,10 +1,15 @@
 /**
- * @fileoverview Styling system exports for Advanced Logger
+ * @fileoverview Styling system exports for Advanced Logger.
+ *
+ * Implementation-level primitives consumed by `src/styles/` (the public
+ * StyleManager bridge). End users should prefer:
+ *
+ * ```ts
+ * import { StyleBuilder, THEME_PRESETS } from '@mks2508/better-logger/styles';
+ * ```
  */
 export { StyleBuilder, $, StylePresets } from './StyleBuilder.js';
 export { THEME_PRESETS } from './themes.js';
 export { BANNER_VARIANTS, THEME_BANNERS, detectBannerCapabilities, displayInitBanner } from './banners.js';
-export { TimestampStyler, LevelStyler, PrefixStyler, MessageStyler, LocationStyler } from './SemanticStyles.js';
-export { LogStyleBuilder, createLogStyleBuilder } from './LogStyleBuilder.js';
 export { SMART_PRESETS, getSmartPreset, getAvailablePresets, hasPreset, PRESET_DESCRIPTIONS } from './SmartPresets.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/styling/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/styling/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACH,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,eAAe,EACf,WAAW,EACX,YAAY,EACZ,aAAa,EACb,cAAc,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EACH,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACtB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/styling/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACH,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,iBAAiB,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACtB,MAAM,mBAAmB,CAAC"}

package/dist/terminal/color-converter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Color Converter - CSS colors to ANSI extended color codes
+ * Supports 256-color and truecolor (24-bit) terminals
+ */
+export type ColorCapability = 'full' | 'basic' | 'none';
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+export declare function hexToRgb(hex: string): RGB;
+export declare function rgbToHex(r: number, g: number, b: number): string;
+export declare function hexTo256(hex: string): number;
+export declare function colorToHex(color: string): string;
+export declare function getANSIForeground(color: string, capability: ColorCapability): string;
+export declare function getANSIBackground(color: string, capability: ColorCapability): string;
+export declare function getANSI256Foreground(colorIndex: number): string;
+export declare function getANSI256Background(colorIndex: number): string;
+export declare function extractGradientColors(gradient: string): string[];
+export declare function gradientToSingleColor(gradient: string): string;
+export declare function cssColorToANSI(cssColor: string, capability: ColorCapability, isBackground?: boolean): string;
+export declare const ANSI: {
+    reset: string;
+    bold: string;
+    dim: string;
+    italic: string;
+    underline: string;
+    blink: string;
+    inverse: string;
+    hidden: string;
+    strikethrough: string;
+    fg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+        gray: string;
+        brightRed: string;
+        brightGreen: string;
+        brightYellow: string;
+        brightBlue: string;
+        brightMagenta: string;
+        brightCyan: string;
+        brightWhite: string;
+    };
+    bg: {
+        black: string;
+        red: string;
+        green: string;
+        yellow: string;
+        blue: string;
+        magenta: string;
+        cyan: string;
+        white: string;
+        gray: string;
+        brightRed: string;
+        brightGreen: string;
+        brightYellow: string;
+        brightBlue: string;
+        brightMagenta: string;
+        brightCyan: string;
+        brightWhite: string;
+    };
+    rgb: (r: number, g: number, b: number) => string;
+    bgRgb: (r: number, g: number, b: number) => string;
+    color256: (n: number) => string;
+    bgColor256: (n: number) => string;
+};
+//# sourceMappingURL=color-converter.d.ts.map

package/dist/terminal/color-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-converter.d.ts","sourceRoot":"","sources":["../../src/terminal/color-converter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,GAAG;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAiED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAUzC;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAc5C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBhD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,MAAM,CAmBpF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,MAAM,CAmBpF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/D;AAiCD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAehE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAW9D;AAED,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,EAC3B,YAAY,GAAE,OAAe,GAC9B,MAAM,CAcR;AAED,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAiDJ,MAAM,KAAK,MAAM,KAAK,MAAM;eAC1B,MAAM,KAAK,MAAM,KAAK,MAAM;kBACzB,MAAM;oBACJ,MAAM;CACzB,CAAC"}

package/dist/terminal/formatter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Terminal Formatter - Alignment, key-value, and advanced terminal formatting
+ */
+import { type ColorCapability } from './color-converter.js';
+import type { ColumnConfig, ColumnAlign, BadgeStyle, TimestampFormat, LogOptions } from '../types/index.js';
+export declare function stripAnsi(str: string): string;
+export declare function getVisibleLength(str: string): number;
+export declare function padToWidth(str: string, width: number, align?: ColumnAlign): string;
+export declare function formatWithRightAlign(leftContent: string, rightContent: string, maxWidth?: number): string;
+export declare function formatColumns(columns: ColumnConfig[], maxWidth?: number, colorCapability?: ColorCapability): string;
+export declare function formatKeyValue(obj: Record<string, unknown>, colorCapability?: ColorCapability, options?: {
+    separator?: string;
+    keyColor?: string;
+    valueColor?: string;
+}): string;
+export declare function isKeyValueObject(obj: unknown): obj is Record<string, unknown>;
+export declare function formatBadge(badge: string, style?: BadgeStyle, colorCapability?: ColorCapability, color?: string): string;
+export declare function formatTimestamp(date?: Date, format?: TimestampFormat): string;
+export declare function formatRelativeTime(date: Date): string;
+export declare function formatElapsedTime(date: Date): string;
+export declare function resetStartTime(): void;
+export declare function applyLogOptions(message: string, options: LogOptions, colorCapability?: ColorCapability): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/terminal/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/terminal/formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA8C,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxG,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5G,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,WAAoB,GAAG,MAAM,CAiB1F;AAED,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAClB,MAAM,CAWR;AAED,wBAAgB,aAAa,CACzB,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,CAAC,EAAE,MAAM,EACjB,eAAe,GAAE,eAAwB,GAC1C,MAAM,CA2BR;AAED,wBAAgB,cAAc,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,eAAe,GAAE,eAAwB,EACzC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7E,MAAM,CA0BR;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc7E;AAED,wBAAgB,WAAW,CACvB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,UAAuB,EAC9B,eAAe,GAAE,eAAwB,EACzC,KAAK,CAAC,EAAE,MAAM,GACf,MAAM,CA4BR;AAED,wBAAgB,eAAe,CAC3B,IAAI,GAAE,IAAiB,EACvB,MAAM,GAAE,eAAwB,GACjC,MAAM,CAmBR;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgBrD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWpD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,eAAe,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,eAAe,GAAE,eAAwB,GAC1C,MAAM,CAQR"}

package/dist/transports/ConsoleTransport.d.ts

@@ -0,0 +1,9 @@
+import type { TransportRecord, TransportOptions, ITransport } from '../types/index.js';
+export declare class ConsoleTransport implements ITransport {
+    private options?;
+    readonly name = "console";
+    constructor(options?: TransportOptions | undefined);
+    write(record: TransportRecord): void;
+    private getConsoleMethod;
+}
+//# sourceMappingURL=ConsoleTransport.d.ts.map

package/dist/transports/ConsoleTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleTransport.d.ts","sourceRoot":"","sources":["../../src/transports/ConsoleTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAY,MAAM,mBAAmB,CAAC;AAEjG,qBAAa,gBAAiB,YAAW,UAAU;IAGnC,OAAO,CAAC,OAAO,CAAC;IAF5B,QAAQ,CAAC,IAAI,aAAa;gBAEN,OAAO,CAAC,EAAE,gBAAgB,YAAA;IAE9C,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAUpC,OAAO,CAAC,gBAAgB;CAU3B"}

package/dist/transports/FileTransport.d.ts

@@ -0,0 +1,56 @@
+import type { TransportRecord, TransportOptions, IBufferedTransport, HookLogEntry } from '../types/index.js';
+/**
+ * Options for {@link FileTransport}. Uses `destination` as the file path in
+ * Node and as a `localStorage` key in the browser (the path component is
+ * sanitised to `[a-zA-Z0-9_-]`).
+ *
+ */
+export interface FileTransportOptions extends TransportOptions {
+    /**
+     * Where to write. In Node this is a file path (resolved relative to
+     * `process.cwd()` and sanitised against path traversal). In the browser
+     * this is a localStorage key (sanitised to alphanumeric + `-_`).
+     * @default 'app.log' (Node) | 'better-logger:default' (browser)
+     */
+    destination?: string;
+    /**
+     * Optional hook fired when the transport cannot write (FS error,
+     * quota exceeded, browser tab in private mode, ...). Receives a
+     * synthetic {@link HookLogEntry}.
+     */
+    onError?: (entry: HookLogEntry) => void | Promise<void>;
+}
+/**
+ * File-based transport.
+ *
+ * - In Node, writes batches via `fs.promises.appendFile` (non-blocking).
+ * - In the browser, writes batches into `localStorage` (fallback no-op if
+ *   `localStorage` is unavailable — e.g. private mode, sandboxed iframes).
+ *
+ * Fixed in 5.1.0:
+ *   - BUG-N3: uses async `fs.promises.appendFile` instead of sync `appendFileSync`.
+ *   - BUG-N4: destination is sanitised to reject path traversal (`..`, `~`, abs paths).
+ *   - BUG-N5: dynamic `import('node:fs/promises')` instead of CJS `require('fs')`.
+ *   - BUG-N6: browser case uses `localStorage` with try/catch (was silent no-op).
+ *
+ */
+export declare class FileTransport implements IBufferedTransport {
+    readonly name = "file";
+    private buffer;
+    private flushTimer?;
+    private options;
+    private closed;
+    constructor(options?: FileTransportOptions);
+    get bufferSize(): number;
+    get maxBufferSize(): number;
+    isReady(): boolean;
+    write(record: TransportRecord): void;
+    flush(): Promise<void>;
+    private flushNode;
+    private flushBrowser;
+    close(): Promise<void>;
+    private resolveNodeDestination;
+    private resolveBrowserKey;
+    private emitError;
+}
+//# sourceMappingURL=FileTransport.d.ts.map

package/dist/transports/FileTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTransport.d.ts","sourceRoot":"","sources":["../../src/transports/FileTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,eAAe,EACf,gBAAgB,EAEhB,kBAAkB,EAClB,YAAY,EAEf,MAAM,mBAAmB,CAAC;AAO3B;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IACpD,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,CAAC,EAAE,oBAAoB;IAc1C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,IAAI,OAAO;IAIlB,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IA+B9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAad,SAAS;YAaT,YAAY;IAcpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,SAAS;CAYpB"}