e1.9.0 Structured JSON log method added, refactored.

interface.go

@@ -22,10 +22,11 @@ const (
 
 // Record flags for controlling output structure
 const (
-	FlagShowTimestamp int64 = 0b001
-	FlagShowLevel     int64 = 0b010
-	FlagRaw           int64 = 0b100
-	FlagDefault             = FlagShowTimestamp | FlagShowLevel
+	FlagShowTimestamp  int64 = 0b0001
+	FlagShowLevel      int64 = 0b0010
+	FlagRaw            int64 = 0b0100
+	FlagStructuredJSON int64 = 0b1000
+	FlagDefault              = FlagShowTimestamp | FlagShowLevel
 )
 
 // logRecord represents a single log entry.
@@ -107,6 +108,11 @@ func (l *Logger) LogTrace(depth int, args ...any) {
 	l.log(FlagShowTimestamp, LevelInfo, int64(depth), args...)
 }
 
+// LogStructured logs a message with structured fields as proper JSON
+func (l *Logger) LogStructured(level int64, message string, fields map[string]any) {
+	l.log(l.getFlags()|FlagStructuredJSON, level, 0, []any{message, fields})
+}
+
 // Write outputs raw, unformatted data regardless of configured format.
 // This method bypasses all formatting (timestamps, levels, JSON structure)
 // and writes args as space-separated strings without a trailing newline.