Interface LogImplInterface

The shape of GeoLeaf.Log — a level-filtered console with repetition damping.

Two independent mechanisms decide whether a call reaches the console: the level threshold (LogImplInterface.setLevel) and, for messages recognised as repetitive, a grouping counter that suppresses them after a few occurrences and reports the totals through LogImplInterface.showSummary. A message can therefore be dropped even at a permissive level.

interface LogImplInterface {
    setLevel(level: string): void;
    getLevel(): number;
    getLevelName(): string;
    setQuietMode(enabled: boolean): void;
    showSummary(): void;
    debug(...args: unknown[]): void;
    info(...args: unknown[]): void;
    warn(...args: unknown[]): void;
    error(...args: unknown[]): void;
}

Index

Methods

setLevel getLevel getLevelName setQuietMode showSummary debug info warn error

Methods

setLevel

setLevel(level: string): void
Sets the verbosity threshold.

Accepts "debug", "info", "warn", "error" and "production", case-insensitively. ⚠️ "production" is not a level of its own: it sets the threshold to warn and turns quiet mode on, so it is the only value with a side effect beyond the threshold. An unrecognised value logs a warning and leaves the level unchanged.
Parameters
- level: string
  The level name.
Returns void
Example
```
GeoLeaf.Log.setLevel("debug");
```
Example
```
GeoLeaf.Log.setLevel("production");
// Équivalent à : setLevel('warn') + setQuietMode(true)
```
- Defined in src/utils/log/logger.ts:169

getLevel

getLevel(): number
The current threshold, as its numeric value from LEVELS.

Returns number
0 (DEBUG), 1 (INFO), 2 (WARN) or 3 (ERROR).
Example
```
const level = GeoLeaf.Log.getLevel();
// Returns: 0 (DEBUG) | 1 (INFO) | 2 (WARN) | 3 (ERROR)
```
- Defined in src/utils/log/logger.ts:182

getLevelName

getLevelName(): string
The current threshold, as its name.

⚠️ Reports the threshold, not the mode: after setLevel("production") this returns "WARN", and nothing here reveals that quiet mode was switched on with it.

Returns string
"DEBUG", "INFO", "WARN" or "ERROR".
Example
```
const name = GeoLeaf.Log.getLevelName();
// Returns: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR'
```
- Defined in src/utils/log/logger.ts:198

setQuietMode

setQuietMode(enabled: boolean): void
Turns repetition damping on or off, independently of the level.

With it on, messages matching the module's repetitive-message patterns are shown a couple of times and then counted silently until LogImplInterface.showSummary.
Parameters
- enabled: boolean
  true to damp repetitive messages.
Returns void
Example
```
GeoLeaf.Log.setQuietMode(true);
// [GeoLeaf.INFO] Silent mode activated - repetitive logs reduced
```
- Defined in src/utils/log/logger.ts:214

showSummary

showSummary(): void
Prints how many times each damped message was suppressed.

The counterpart of quiet mode: without this call, the suppressed occurrences are never reported at all.

Returns void
Example
```
GeoLeaf.Log.showSummary();
// [GeoLeaf.INFO] Grouped log summary
// • 12x: Module loaded...
// • 8x: Profile loaded...
```
- Defined in src/utils/log/logger.ts:230

debug

debug(...args: unknown[]): void
Logs at DEBUG — internal detail, off by default (the default threshold is INFO).
Parameters
- ...args: unknown[]
  Values forwarded to the console, prefixed with the module tag.
Returns void
Example
```
GeoLeaf.Log.debug("[GeoLeaf.GeoJSON] Chargement des entités…");
```
- Defined in src/utils/log/logger.ts:242

info

info(...args: unknown[]): void
Logs at INFO — normal lifecycle events. Subject to repetition damping.
Parameters
- ...args: unknown[]
  Values forwarded to the console, prefixed with the module tag.
Returns void
Example
```
GeoLeaf.Log.info("[GeoLeaf.Core] Carte initialisée.");
```
- Defined in src/utils/log/logger.ts:254

warn

warn(...args: unknown[]): void
Logs at WARN — a degraded path was taken, but the operation continued.
Parameters
- ...args: unknown[]
  Values forwarded to the console, prefixed with the module tag.
Returns void
Example
```
GeoLeaf.Log.warn("[GeoLeaf.Config] Clé 'basemap.id' manquante, fallback sur 'street'.");
```
- Defined in src/utils/log/logger.ts:266

error

error(...args: unknown[]): void
Logs at ERROR — the highest level, never damped by quiet mode.
Parameters
- ...args: unknown[]
  Values forwarded to the console, prefixed with the module tag.
Returns void
Example
```
GeoLeaf.Log.error("[GeoLeaf.Config] Échec du chargement de la configuration.");
```
- Defined in src/utils/log/logger.ts:278

Interface LogImplInterface

Index

Methods

Methods

setLevel

Parameters

Returns void

Example

Example

getLevel

Returns number

Example

getLevelName

Returns string

Example

setQuietMode

Parameters

Returns void

Example

showSummary

Returns void

Example

debug

Parameters

Returns void

Example

info

Parameters

Returns void

Example

warn

Parameters

Returns void

Example

error

Parameters

Returns void

Example

Settings

On This Page