package gumbo:logging@0.1.0;

/// The `logging` world provides a standardized entry point for logging capabilities.
/// It serves as a dedicated interface for interacting with the logging functionality
/// defined within the `logging` interface, allowing for structured logging, context management,
/// and tracing within a plugin or application.
@since(version = 0.1.0)
world logging {
        /// Defines the severity level of a log message.
        @since(version = 0.1.0)
        enum log-level {
            /// Detailed information typically used for diagnosing issues.
            trace,

            /// Information useful for developers to debug the application.
            debug,

            /// General operational information about the application's state.
            info,

            /// Indicates a potential problem that should be investigated.
            warn,

            /// Indicates a significant issue that could impact the application's functionality.
            error,
        }

        /// Gets the current `log-level` of the application.
        ///
        /// # Returns
        /// - The current log level, or `None` if logging is disabled.
        @since(version = 0.1.0)
        import get-log-level: func() -> option<log-level>;

        /// Logs an event with the specified severity level, target, and message.
        ///
        /// # Parameters
        /// - `level`: The severity level of the log event.
        /// - `target`: The target or category of the log event.
        /// - `message`: The log message.
        ///
        /// # Returns
        /// - `Ok(())`: If the event was logged successfully.
        /// - `Err(log-error)`: If the logging operation failed.
        @since(version = 0.1.0)
        import log-event: func(level: log-level, target: string, message: string);
}

Caused by:
    0: failed to merge worlds from two documents
    1: duplicate import found for interface `log-level`

@since(version = 0.1.0)
world logging {
    import logging: interface {
        /// Defines the severity level of a log message.
        @since(version = 0.1.0)
        enum log-level {
            /// Detailed information typically used for diagnosing issues.
            trace,

            /// Information useful for developers to debug the application.
            debug,

            /// General operational information about the application's state.
            info,

            /// Indicates a potential problem that should be investigated.
            warn,

            /// Indicates a significant issue that could impact the application's functionality.
            error,
        }

        /// Gets the current `log-level` of the application.
        ///
        /// # Returns
        /// - The current log level, or `None` if logging is disabled.
        @since(version = 0.1.0)
        get-log-level: func() -> option<log-level>;

        /// Logs an event with the specified severity level, target, and message.
        ///
        /// # Parameters
        /// - `level`: The severity level of the log event.
        /// - `target`: The target or category of the log event.
        /// - `message`: The log message.
        ///
        /// # Returns
        /// - `Ok(())`: If the event was logged successfully.
        /// - `Err(log-error)`: If the logging operation failed.
        @since(version = 0.1.0)
        log-event: func(level: log-level, target: string, message: string);
    }
}