reis 0.1.0

#![allow(
    unused_parens,
    clippy::useless_conversion,
    clippy::double_parens,
    clippy::match_single_binding
)]

// GENERATED FILE

/**
This is a special interface to setup the client as seen by the EIS
implementation. The object for this interface has the fixed object
id 0 and only exists until the connection has been set up, see the
`ei_handshake.connection` event.

The `ei_handshake` version is 1 until:
- the EIS implementation sends the interface_version event with
  a version other than 1, and, in response,
- the client sends the interface_version request with a
  version equal or lower to the EIS implementation version.

The EIS implementation must send the interface_version event immediately
once the physical connection has been established.

Once the `ei_connection.connection` event has been sent the handshake
is destroyed by the EIS implementation.
 */
pub mod handshake {
    #[derive(Clone, Debug)]
    pub struct Handshake(pub(crate) crate::Object);

    impl crate::private::Sealed for Handshake {}

    impl crate::Interface for Handshake {
        const NAME: &'static str = "ei_handshake";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Handshake {}

    impl Handshake {
        /**
        Notifies the EIS implementation that this client supports the
        given version of the `ei_handshake` interface. The version number
        must be less than or equal to the version in the
        handshake_version event sent by the EIS implementation when
        the connection was established.

        Immediately after sending this request, the client must assume the negotiated
        version number for the `ei_handshake` interface and the EIS implementation
        may send events and process requests matching that version.

        This request must be sent exactly once and it must be the first request
        the client sends.
         */
        pub fn handshake_version(&self, version: u32) -> () {
            let args = &[crate::Arg::Uint32(version.into())];

            self.0.request(0, args);

            ()
        }

        /**
        Notify the EIS implementation that configuration is complete.

        In the future (and possibly after requiring user interaction),
        the EIS implementation responds by sending the `ei_handshake.connection` event.
         */
        pub fn finish(&self) -> () {
            let args = &[];

            self.0.request(1, args);

            ()
        }

        /**
        Notify the EIS implementation of the type of this context. The context types
        defines whether the client will send events to or receive events from the
        EIS implementation.

        Depending on the context type, certain requests must not be used and some
        events must not be sent by the EIS implementation.

        This request is optional, the default client type is context_type.receiver.
        This request must not be sent more than once and must be sent before
        `ei_handshake.finish.`
         */
        pub fn context_type(&self, context_type: ContextType) -> () {
            let args = &[crate::Arg::Uint32(context_type.into())];

            self.0.request(2, args);

            ()
        }

        /**
        Notify the EIS implementation of the client name. The name is a
        human-presentable UTF-8 string and should represent the client name
        as accurately as possible. This name may be presented to the user
        for identification of this client (e.g. to confirm the client has
        permissions to connect).

        There is no requirement for the EIS implementation to use this name. For
        example, where the client is managed through an XDG Desktop Portal an EIS
        implementation would typically use client identification information sent
        by the portal instead.

        This request is optional, the default client name is implementation-defined.
        This request must not be sent more than once and must be sent before
        `ei_handshake.finish.`
         */
        pub fn name(&self, name: &str) -> () {
            let args = &[crate::Arg::String(name.into())];

            self.0.request(3, args);

            ()
        }

        /**
        Notify the EIS implementation that the client supports the
        given named interface with the given maximum version number.

        Future objects created by the EIS implementation will
        use the respective interface version (or any lesser version).

        This request must be sent for the "`ei_connection`" interface,
        failing to do so will result in the EIS implementation disconnecting
        the client on `ei_handshake.finish.`

        This request must not be sent for the "`ei_handshake`" interface, use
        the `ei_handshake.handshake_version` request instead.

        Note that an EIS implementation may consider some interfaces to
        be required and immediately `ei_connection.disconnect` a client
        not supporting those interfaces.

        This request must not be sent more than once per interface and must be
        sent before `ei_handshake.finish.`
         */
        pub fn interface_version(&self, name: &str, version: u32) -> () {
            let args = &[
                crate::Arg::String(name.into()),
                crate::Arg::Uint32(version.into()),
            ];

            self.0.request(4, args);

            ()
        }
    }

    /**
    This enum denotes context types for the libei context.

    A context type of receiver is a libei context receiving events
    from the EIS implementation. A context type of sender is a libei context
    sending events to the EIS implementation.
     */
    #[derive(Clone, Copy, Debug)]
    pub enum ContextType {
        /** this client receives events from the EIS implementation */
        Receiver = 1,
        /** this client sends events to the EIS implementation */
        Sender = 2,
    }

    impl From<ContextType> for u32 {
        fn from(value: ContextType) -> u32 {
            value as u32
        }
    }

    impl crate::OwnedArg for ContextType {
        fn parse(buf: &mut crate::ByteStream) -> Result<Self, crate::ParseError> {
            match u32::parse(buf)? {
                1 => Ok(Self::Receiver),
                2 => Ok(Self::Sender),
                variant => Err(crate::ParseError::InvalidVariant("ContextType", variant)),
            }
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            crate::Arg::Uint32(*self as u32)
        }

        fn enum_name(&self) -> Option<(&'static str, &'static str)> {
            Some((
                "context_type",
                match self {
                    Self::Receiver => "receiver",
                    Self::Sender => "sender",
                },
            ))
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This event is sent exactly once and immediately after connection
        to the EIS implementation.

        In response, the client must send the `ei_handshake.handshake_version` request
        with any version up to including the version provided in this event.
        See the `ei_handshake.handshake_version` request for details on what happens next.
         */
        HandshakeVersion {
            /** the interface version */
            version: u32,
        },
        /**
        Notifies the client that the EIS implementation supports
        the given named interface with the given maximum version number.

        This event must be sent by the EIS implementation for any
        interfaces that supports client-created objects (e.g. "`ei_callback`")
        before the `ei_handshake.connection` event.
        The client must not assume those interfaces are supported unless
        and until those versions have been received.

        This request must not be sent for the "`ei_handshake`" interface, use
        the handshake_version event instead.

        This event may be sent by the EIS implementation for any
        other supported interface (but not necessarily all supported
        interfaces) before the `ei_handshake.connection` event.
         */
        InterfaceVersion {
            /** the interface name */
            name: String,
            /** the interface version */
            version: u32,
        },
        /**
        Provides the client with the connection object that is the top-level
        object for all future requests and events.

        This event is sent exactly once at some unspecified time after the client
        sends the `ei_handshake.finish` request to the EIS implementation.

        The `ei_handshake` object will be destroyed by the
        EIS implementation immediately after this event has been sent, a
        client must not attempt to use it after that point.

        The version sent by the EIS implementation is the version of the "`ei_connection`"
        interface as announced by `ei_handshake.interface_version`, or any
        lower version.

        The serial number is the start value of the EIS implementation's serial
        number sequence. Clients must not assume any specific value for this
        serial number. Any future serial number in any event is monotonically
        increasing by an unspecified amount.
         */
        Connection {
            /** this event's serial number */
            serial: u32,
            /** the connection object */
            connection: super::connection::Connection,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("handshake_version"),
                1 => Some("interface_version"),
                2 => Some("connection"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let version = _bytes.read_arg()?;

                    Ok(Self::HandshakeVersion { version })
                }
                1 => {
                    let name = _bytes.read_arg()?;
                    let version = _bytes.read_arg()?;

                    Ok(Self::InterfaceVersion { name, version })
                }
                2 => {
                    let serial = _bytes.read_arg()?;
                    let connection = _bytes.read_arg()?;
                    let version = _bytes.read_arg()?;

                    Ok(Self::Connection {
                        serial,
                        connection: _bytes.backend().new_peer_interface(connection, version)?,
                    })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("handshake", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::HandshakeVersion { version } => {
                    args.push(version.as_arg());
                }
                Self::InterfaceVersion { name, version } => {
                    args.push(name.as_arg());
                    args.push(version.as_arg());
                }
                Self::Connection { serial, connection } => {
                    args.push(serial.as_arg());
                    args.push(connection.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use handshake::Handshake;

/**
The core connection object. This is the top-level object for any communication
with the EIS implementation.

Note that for a client to receive this object, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod connection {
    #[derive(Clone, Debug)]
    pub struct Connection(pub(crate) crate::Object);

    impl crate::private::Sealed for Connection {}

    impl crate::Interface for Connection {
        const NAME: &'static str = "ei_connection";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Connection {}

    impl Connection {
        /**
        The sync request asks the EIS implementation to emit the 'done' event
        on the returned `ei_callback` object. Since requests are
        handled in-order and events are delivered in-order, this can
        be used as a synchronization point to ensure all previous requests and the
        resulting events have been handled.

        The object returned by this request will be destroyed by the
        EIS implementation after the callback is fired and as such the client must not
        attempt to use it after that point.

        The callback_data in the `ei_callback.done` event is always zero.

        Note that for a client to use this request it must announce
        support for the "`ei_callback`" interface in `ei_handshake.interface_version.`
        It is a protocol violation to request sync without having announced the
        "`ei_callback`" interface and the EIS implementation must disconnect
        the client.
         */
        pub fn sync(&self, version: u32) -> (super::callback::Callback) {
            let callback = self.0.backend().new_id("ei_callback".to_string(), version);
            let args = &[
                crate::Arg::NewId(callback.into()),
                crate::Arg::Uint32(version.into()),
            ];

            self.0.request(0, args);

            (super::callback::Callback(crate::Object::new(
                self.0.backend().clone(),
                callback,
                true,
            )))
        }

        /**
        A request to the EIS implementation that this client should be disconnected.
        This is a courtesy request to allow the EIS implementation to distinquish
        between a client disconnecting on purpose and one disconnecting through the
        socket becoming invalid.

        Immediately after sending this request, the client may destroy the
        `ei_connection` object and it should close the socket. The EIS implementation
        will treat the connection as already disconnected on receipt and does not
        send the `ei_connection.disconnect` event in response to this request.
         */
        pub fn disconnect(&self) -> () {
            let args = &[];

            self.0.request(1, args);
            self.0.backend().remove_id(self.0.id());

            ()
        }
    }

    /**
    A reason why a client was disconnected. This enum is intended to
    provide information to the client on whether it was disconnected as
    part of normal operations or as result of an error on either the client
    or EIS implementation side.

    A nonzero value describes an error, with the generic value "error" (1) reserved
    as fallback.

    This enum may be extended in the future, clients must be able to handle
    values that are not in their supported version of this enum.
     */
    #[derive(Clone, Copy, Debug)]
    pub enum DisconnectReason {
        /** client was purposely disconnected */
        Disconnected = 0,
        /** an error caused the disconnection */
        Error = 1,
        /** sender/receiver client sent request for receiver/sender mode */
        Mode = 2,
        /** client committed a protocol violation */
        Protocol = 3,
        /** client sent an invalid value */
        Value = 4,
        /** error on the transport layer */
        Transport = 5,
    }

    impl From<DisconnectReason> for u32 {
        fn from(value: DisconnectReason) -> u32 {
            value as u32
        }
    }

    impl crate::OwnedArg for DisconnectReason {
        fn parse(buf: &mut crate::ByteStream) -> Result<Self, crate::ParseError> {
            match u32::parse(buf)? {
                0 => Ok(Self::Disconnected),
                1 => Ok(Self::Error),
                2 => Ok(Self::Mode),
                3 => Ok(Self::Protocol),
                4 => Ok(Self::Value),
                5 => Ok(Self::Transport),
                variant => Err(crate::ParseError::InvalidVariant(
                    "DisconnectReason",
                    variant,
                )),
            }
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            crate::Arg::Uint32(*self as u32)
        }

        fn enum_name(&self) -> Option<(&'static str, &'static str)> {
            Some((
                "disconnect_reason",
                match self {
                    Self::Disconnected => "disconnected",
                    Self::Error => "error",
                    Self::Mode => "mode",
                    Self::Protocol => "protocol",
                    Self::Value => "value",
                    Self::Transport => "transport",
                },
            ))
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This event may be sent by the EIS implementation immediately before
        the client is disconnected. The last_serial argument is set to the last
        serial number used in a request by the client or zero if the client has not
        yet issued a request.

        Where a client is disconnected by EIS on purpose, for example after
        a user interaction, the reason is disconnect_reason.disconnected (i.e. zero)
        and the explanation is NULL.

        Where a client is disconnected due to some invalid request or other
        protocol error, the reason is one of disconnect_reason (i.e. nonzero) and
        explanation may contain a string explaining why. This string is
        intended to help debugging only and is not guaranteed to stay constant.

        The `ei_connection` object will be destroyed by the
        EIS implementation immediately after this event has been sent, a
        client must not attempt to use it after that point.

        There is no guarantee this event is sent - the connection may be closed
        without a disconnection event.
         */
        Disconnected {
            /** the last serial sent by the EIS implementation */
            last_serial: u32,
            /** the reason for being disconnected */
            reason: DisconnectReason,
            /** an explanation for debugging purposes */
            explanation: String,
        },
        /**
        Notification that a new seat has been added.

        A seat is a set of input devices that logically belong together.

        This event is only sent if the client announced support for the
        "`ei_seat`" interface in `ei_handshake.interface_version.`
        The interface version is equal or less to the client-supported
        version in `ei_handshake.interface_version` for the "`ei_seat`"
        interface.
         */
        Seat {
            /**  */
            seat: super::seat::Seat,
        },
        /**
        Notification that an object ID used in an earlier request was
        invalid and does not exist.

        This event is sent by the EIS implementation when an object that
        does not exist as seen by the EIS implementation. The protocol is
        asynchronous and this may occur e.g. when the EIS implementation
        destroys an object at the same time as the client requests functionality
        from that object. For example, an EIS implementation may send
        `ei_device.destroyed` and destroy the device's resources (and protocol object)
        at the same time as the client attempts to `ei_device.start_emulating`
        on that object.

        It is the client's responsibilty to unwind any state changes done
        to the object since the last successful message.
         */
        InvalidObject {
            /** the last serial sent by the EIS implementation */
            last_serial: u32,
            /**  */
            invalid_id: u64,
        },
        /**
        The ping event asks the client to emit the 'done' event
        on the provided `ei_callback` object. Since requests are
        handled in-order and events are delivered in-order, this can
        be used as a synchronization point to ensure all previous requests
        and the resulting events have been handled.

        The object returned by this request must be destroyed by the
        ei client implementation after the callback is fired and as
        such the client must not attempt to use it after that point.

        The callback_data in the resulting `ei_pingpong.done` request is
        ignored by the EIS implementation.

        Note that for a EIS implementation to use this request the client must
        announce support for this interface in `ei_handshake.interface_version.` It is
        a protocol violation to send this event to a client without the
        "`ei_pingpong`" interface.
         */
        Ping {
            /** callback object for the ping request */
            ping: super::pingpong::Pingpong,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("disconnected"),
                1 => Some("seat"),
                2 => Some("invalid_object"),
                3 => Some("ping"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let last_serial = _bytes.read_arg()?;
                    let reason = _bytes.read_arg()?;
                    let explanation = _bytes.read_arg()?;

                    Ok(Self::Disconnected {
                        last_serial,
                        reason,
                        explanation,
                    })
                }
                1 => {
                    let seat = _bytes.read_arg()?;
                    let version = _bytes.read_arg()?;

                    Ok(Self::Seat {
                        seat: _bytes.backend().new_peer_interface(seat, version)?,
                    })
                }
                2 => {
                    let last_serial = _bytes.read_arg()?;
                    let invalid_id = _bytes.read_arg()?;

                    Ok(Self::InvalidObject {
                        last_serial,
                        invalid_id,
                    })
                }
                3 => {
                    let ping = _bytes.read_arg()?;
                    let version = _bytes.read_arg()?;

                    Ok(Self::Ping {
                        ping: _bytes.backend().new_peer_interface(ping, version)?,
                    })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("connection", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Disconnected {
                    last_serial,
                    reason,
                    explanation,
                } => {
                    args.push(last_serial.as_arg());
                    args.push(reason.as_arg());
                    args.push(explanation.as_arg());
                }
                Self::Seat { seat } => {
                    args.push(seat.as_arg());
                }
                Self::InvalidObject {
                    last_serial,
                    invalid_id,
                } => {
                    args.push(last_serial.as_arg());
                    args.push(invalid_id.as_arg());
                }
                Self::Ping { ping } => {
                    args.push(ping.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use connection::Connection;

/**
Interface for ensuring a roundtrip to the EIS implementation.
Clients can handle the 'done' event to get notified when
the related request that created the `ei_callback` object is done.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod callback {
    #[derive(Clone, Debug)]
    pub struct Callback(pub(crate) crate::Object);

    impl crate::private::Sealed for Callback {}

    impl crate::Interface for Callback {
        const NAME: &'static str = "ei_callback";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Callback {}

    impl Callback {}

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        Notify the client when the related request is done. Immediately after this event
        the `ei_callback` object is destroyed by the EIS implementation and as such the
        client must not attempt to use it after that point.
         */
        Done {
            /** request-specific data for the callback */
            callback_data: u64,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("done"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let callback_data = _bytes.read_arg()?;

                    Ok(Self::Done { callback_data })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("callback", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Done { callback_data } => {
                    args.push(callback_data.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use callback::Callback;

/**
Interface for ensuring a roundtrip to the client implementation.
This interface is identical to `ei_callback` but is intended for
the EIS implementation to enforce a roundtrip to the client.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod pingpong {
    #[derive(Clone, Debug)]
    pub struct Pingpong(pub(crate) crate::Object);

    impl crate::private::Sealed for Pingpong {}

    impl crate::Interface for Pingpong {
        const NAME: &'static str = "ei_pingpong";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Pingpong {}

    impl Pingpong {
        /**
        Notify the EIS implementation when the related event is done. Immediately after this request
        the `ei_pingpong` object is destroyed by the client and as such must not be used
        any further.
         */
        pub fn done(&self, callback_data: u64) -> () {
            let args = &[crate::Arg::Uint64(callback_data.into())];

            self.0.request(0, args);
            self.0.backend().remove_id(self.0.id());

            ()
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {}

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                opcode => Err(crate::ParseError::InvalidOpcode("pingpong", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use pingpong::Pingpong;

/**
An `ei_seat` represents a set of input devices that logically belong together. In most
cases only one seat is present and all input devices on that seat share the same
pointer and keyboard focus.

A seat has potential capabilities, a client is expected to bind to those capabilities.
The EIS implementation then creates logical input devices based on the capabilities the
client is interested in.

Immediately after creation of the `ei_seat` object, the EIS implementation sends a burst
of events with information about this seat. This burst of events is terminated by the
`ei_seat.done` event.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod seat {
    #[derive(Clone, Debug)]
    pub struct Seat(pub(crate) crate::Object);

    impl crate::private::Sealed for Seat {}

    impl crate::Interface for Seat {
        const NAME: &'static str = "ei_seat";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Seat {}

    impl Seat {
        /**
        Notification that the client is no longer interested in this seat.
        The EIS implementation will release any resources related to this seat and
        send the `ei_seat.destroyed` event once complete.

        Note that releasing a seat does not guarantee another seat becomes available.
        In other words, in most single-seat cases, releasing the seat means the
        connection becomes effectively inert.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Bind to the bitmask of capabilities given. The bitmask is zero or more of the
        masks representing an interface as provided in the `ei_seat.capability` event.
        See the `ei_seat.capability` event documentation for examples.

        Binding masks that are not supported in the `ei_device`'s interface version
        is a client bug and may result in disconnection.

        A client may send this request multiple times to adjust the capabilities it
        is interested in. If previously-bound capabilities are dropped by the client,
        the EIS implementation may `ei_device.remove` devices that have these capabilities.
         */
        pub fn bind(&self, capabilities: u64) -> () {
            let args = &[crate::Arg::Uint64(capabilities.into())];

            self.0.request(1, args);

            ()
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This seat has been removed and a client should release all
        associated resources.

        This `ei_seat` object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        The name of this seat, if any. This event is optional and sent once immediately
        after object creation.

        It is a protocol violation to send this event after the `ei_seat.done` event.
         */
        Name {
            /** the seat name */
            name: String,
        },
        /**
        A notification that this seat supports devices with the given interface.
        The interface is mapped to a bitmask by the EIS implementation.
        A client may then binary OR these bitmasks in `ei_seat.bind.`
        In response, the EIS implementation may then create device based on those
        bound capabilities.

        For example, an EIS implementation may map "`ei_pointer`" to 0x1,
        "`ei_keyboard`" to 0x4 and "`ei_touchscreen`" to 0x8. A client may then
        `ei_seat.bind`(0xc) to bind to keyboard and touchscreen but not pointer.
        Note that as shown in this example the set of masks may be sparse.
        The value of the mask is contant for the lifetime of the seat but may differ
        between seats.

        Note that seat capabilities only represent a mask of possible capabilities on
        devices in this seat. A capability that is not available on the seat cannot
        ever be available on any device in this seat. For example, a seat that only has the
        pointer and keyboard capabilities can never have a device with the touchscreen
        capability. It is up to the EIS implementation to decide how many (if any) devices
        with any given capability exist in this seat.

        Only interfaces that the client announced during `ei_handshake.interface_version`
        can be a seat capability.

        This event is sent multiple times - once per supported interface.
        The set of capabilities is constant for the lifetime of the seat.

        It is a protocol violation to send this event after the `ei_seat.done` event.
         */
        Capability {
            /** the mask representing this capability */
            mask: u64,
            /** the interface name for this capability */
            interface: String,
        },
        /**
        Notification that the initial burst of events is complete and
        the client can set up this seat now.

        It is a protocol violation to send this event more than once.
         */
        Done,
        /**
        Notification that a new device has been added.

        This event is only sent if the client announced support for the
        "`ei_device`" interface in `ei_handshake.interface_version.`
        The interface version is equal or less to the client-supported
        version in `ei_handshake.interface_version` for the "`ei_device`"
        interface.
         */
        Device {
            /** the new device */
            device: super::device::Device,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("name"),
                2 => Some("capability"),
                3 => Some("done"),
                4 => Some("device"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let name = _bytes.read_arg()?;

                    Ok(Self::Name { name })
                }
                2 => {
                    let mask = _bytes.read_arg()?;
                    let interface = _bytes.read_arg()?;

                    Ok(Self::Capability { mask, interface })
                }
                3 => Ok(Self::Done),
                4 => {
                    let device = _bytes.read_arg()?;
                    let version = _bytes.read_arg()?;

                    Ok(Self::Device {
                        device: _bytes.backend().new_peer_interface(device, version)?,
                    })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("seat", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Name { name } => {
                    args.push(name.as_arg());
                }
                Self::Capability { mask, interface } => {
                    args.push(mask.as_arg());
                    args.push(interface.as_arg());
                }
                Self::Done => {}
                Self::Device { device } => {
                    args.push(device.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use seat::Seat;

/**
An `ei_device` represents a single logical input devices. Like physical input devices
an `ei_device` may have multiple capabilities and may e.g. function as pointer
and keyboard.

Depending on the `ei_handshake.context_type`, an `ei_device` can
emulate events via client requests or receive events. It is a protocol violation
to emulate certain events on a receiver device, or for the EIS implementation
to send certain events to the device. See the individual request/event documentation
for details.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod device {
    #[derive(Clone, Debug)]
    pub struct Device(pub(crate) crate::Object);

    impl crate::private::Sealed for Device {}

    impl crate::Interface for Device {
        const NAME: &'static str = "ei_device";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Device {}

    impl Device {
        /**
        Notification that the client is no longer interested in this device.

        Note that releasing a device does not guarantee another device becomes available.

        The EIS implementation will release any resources related to this device and
        send the `ei_device.destroyed` event once complete.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Notify the EIS implementation that the given device is about to start
        sending events. This should be seen more as a transactional boundary than a
        time-based boundary. The primary use-cases for this are to allow for setup on
        the EIS implementation side and/or UI updates to indicate that a device is
        sending events now and for out-of-band information to sync with a given event
        sequence.

        There is no actual requirement that events start immediately once emulation
        starts and there is no requirement that a client calls `ei_device.stop_emulating`
        after the most recent events.
        For example, in a remote desktop use-case the client would call
        `ei_device.start_emulating` once the remote desktop session starts (rather than when
        the device sends events) and `ei_device.stop_emulating` once the remote desktop
        session stops.

        The sequence number identifies this transaction between start/stop emulating.
        It must go up by at least 1 on each call to `ei_device.start_emulating.`
        Wraparound must be handled by the EIS implementation but callers must ensure
        that detection of wraparound is possible.

        It is a protocol violation to request `ei_device.start_emulating` after
        `ei_device.start_emulating` without an intermediate stop_emulating.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn start_emulating(&self, last_serial: u32, sequence: u32) -> () {
            let args = &[
                crate::Arg::Uint32(last_serial.into()),
                crate::Arg::Uint32(sequence.into()),
            ];

            self.0.request(1, args);

            ()
        }

        /**
        Notify the EIS implementation that the given device is no longer sending
        events. See `ei_device.start_emulating` for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn stop_emulating(&self, last_serial: u32) -> () {
            let args = &[crate::Arg::Uint32(last_serial.into())];

            self.0.request(2, args);

            ()
        }

        /**
        Generate a frame event to group the current set of events
        into a logical hardware event. This function must be called after one
        or more events on any of `ei_pointer`, `ei_pointer_absolute`,
        `ei_scroll`, `ei_button`, `ei_keyboard` or `ei_touchscreen` has
        been requested by the EIS implementation.

        The EIS implementation should not process changes to the device state
        until the `ei_device.frame` event. For example, pressing and releasing
        a key within the same frame is a logical noop.

        The given timestamp applies to all events in the current frame.
        The timestamp must be in microseconds of CLOCK_MONOTONIC.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn frame(&self, last_serial: u32, timestamp: u64) -> () {
            let args = &[
                crate::Arg::Uint32(last_serial.into()),
                crate::Arg::Uint64(timestamp.into()),
            ];

            self.0.request(3, args);

            ()
        }
    }

    /**
    If the device type is `ei_device.device_type.virtual`, the device is a
    virtual device representing input as applied on the EIS implementation's
    screen. A relative virtual device generates input events in logical pixels,
    an absolute virtual device generates input events in logical pixels on one
    of the device's regions. Virtual devices do not have a `ei_device.dimension` but
    it may have an `ei_device.region.`

    If the device type is `ei_device.device_type.physical`, the device is a
    representation of a physical device as if connected to the EIS
    implementation's host computer. A relative physical device generates input
    events in mm, an absolute physical device generates input events in mm
    within the device's specified physical size. Physical devices do not have
    regions and no `ei_device.region` events are sent for such devices.
     */
    #[derive(Clone, Copy, Debug)]
    pub enum DeviceType {
        /** a virtual device */
        Virtual = 1,
        /** representation of a physical device */
        Physical = 2,
    }

    impl From<DeviceType> for u32 {
        fn from(value: DeviceType) -> u32 {
            value as u32
        }
    }

    impl crate::OwnedArg for DeviceType {
        fn parse(buf: &mut crate::ByteStream) -> Result<Self, crate::ParseError> {
            match u32::parse(buf)? {
                1 => Ok(Self::Virtual),
                2 => Ok(Self::Physical),
                variant => Err(crate::ParseError::InvalidVariant("DeviceType", variant)),
            }
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            crate::Arg::Uint32(*self as u32)
        }

        fn enum_name(&self) -> Option<(&'static str, &'static str)> {
            Some((
                "device_type",
                match self {
                    Self::Virtual => "virtual",
                    Self::Physical => "physical",
                },
            ))
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This device has been removed and a client should release all
        associated resources.

        This `ei_device` object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        The name of this device, if any. This event is optional and sent once immediately
        after object creation.

        It is a protocol violation to send this event after the `ei_device.done` event.
         */
        Name {
            /** the device name */
            name: String,
        },
        /**
        The device type, one of virtual or physical.

        Devices of type `ei_device.device_type.physical` are supported only clients of
        type `ei_handshake.context_type.receiver.`

        This event is sent once immediately after object creation.
        It is a protocol violation to send this event after the `ei_device.done` event.
         */
        DeviceType {
            /** the device type */
            device_type: DeviceType,
        },
        /**
        The device dimensions in mm. This event is optional and sent once immediately
        after object creation.

        This event is only sent for devices of `ei_device.device_type.physical.`

        It is a protocol violation to send this event after the `ei_device.done` event.
         */
        Dimensions {
            /** the device physical width in mm */
            width: u32,
            /** the device physical height in mm */
            height: u32,
        },
        /**
        Notifies the client of one region. The number of regions is constant for a device
        and all regions are announced immediately after object creation.

        A region is rectangular and defined by an x/y offset and a width and a height.
        A region defines the area on an EIS desktop layout that is accessible by
        this device - this region may not be the full area of the desktop.
        Input events may only be sent for points within the regions.

        The use of regions is private to the EIS compositor and coordinates may not
        match the size of the actual desktop. For example, a compositor may set a
        1920x1080 region to represent a 4K monitor and transparently map input
        events into the respective true pixels.

        Absolute devices may have different regions, it is up to the libei client
        to send events through the correct device to target the right pixel. For
        example, a dual-head setup my have two absolute devices, the first with a
        zero offset region spanning the left screen, the second with a nonzero
        offset spanning the right screen.

        The physical scale denotes a constant factor that needs to be applied to
        any relative movement on this region for that movement to match the same
        *physical* movement on another region.

        It is an EIS implementation bug to advertise the absolute pointer capability
        on a device_type.virtual device without advertising an `ei_region` for this device.

        This event is optional and sent immediately after object creation. Where a device
        has multiple regions, this event is sent once for each region.
        It is a protocol violation to send this event after the `ei_device.done` event.
         */
        Region {
            /** region x offset in logical pixels */
            offset_x: u32,
            /** region y offset in logical pixels */
            offset_y: u32,
            /** region width in logical pixels */
            width: u32,
            /** region height in logical pixels */
            hight: u32,
            /** the physical scale for this region */
            scale: f32,
        },
        /**
        Notification that a new device has a sub-interface.

        This event may be sent for the
        - "`ei_pointer`" interface if the device has the
          `ei_device.capabilities.pointer` capability
        - "`ei_pointer_absolute`" interface if the device has the
          `ei_device.capabilities.pointer_absolute` capability
        - "`ei_scroll`" interface if the device has the
          `ei_device.capabilities.scroll` capability
        - "`ei_button`" interface if the device has the
          `ei_device.capabilities.button` capability
        - "`ei_keyboard`" interface if the device has the
          `ei_device.capabilities.keyboard` capability
        - "`ei_touchscreen`" interface if the device has the
          `ei_device.capabilities.touchscreen` capability
        The interface version is equal or less to the client-supported
        version in `ei_handshake.interface_version` for the respective interface.

        This event is optional and sent immediately after object creation
        and at most once per interface.
        It is a protocol violation to send this event after the `ei_device.done` event.
         */
        Interface {
            /**  */
            object: crate::Object,
        },
        /**
        Notification that the initial burst of events is complete and
        the client can set up this device now.

        It is a protocol violation to send this event more than once per device.
         */
        Done,
        /**
        Notification that the device has been resumed by the EIS implementation
        and (depending on the `ei_handshake.context_type`) the client may request
        `ei_device.start_emulating` or the EIS implementation may
        `ei_device.start_emulating` events.

        It is a client bug to request emulation of events on a device that is
        not resumed. The EIS implementation may silently discard such events.

        A newly advertised device is in the `ei_device.paused` state.
         */
        Resumed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        Notification that the device has been paused by the EIS implementation
        and no futher events will be accepted on this device until
        it is resumed again.

        For devices of `ei_device_setup.context_type` sender, the client thus does
        not need to request `ei_device.stop_emulating` and may request
        `ei_device.start_emulating` after a subsequent `ei_device.resumed.`

        For devices of `ei_device_setup.context_type` receiver and where
        the EIS implementation did not send a `ei_device.stop_emulating`
        prior to this event, the device may send a `ei_device.start_emulating`
        event after a subsequent `ei_device.resumed` event.

        Pausing a device resets the logical state of the device to neutral.
        This includes:
        - any buttons or keys logically down are released
        - any modifiers logically down are released
        - any touches logically down are released

        It is a client bug to request emulation of events on a device that is
        not resumed. The EIS implementation may silently discard such events.

        A newly advertised device is in the `ei_device.paused` state.
         */
        Paused {
            /** this event's serial number */
            serial: u32,
        },
        /**
        See the `ei_device.start_emulating` request for details.

        It is a protocol violation to send this event for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        StartEmulating {
            /** this event's serial number */
            serial: u32,
            /**  */
            sequence: u32,
        },
        /**
        See the `ei_device.stop_emulating` request for details.

        It is a protocol violation to send this event for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        StopEmulating {
            /** this event's serial number */
            serial: u32,
        },
        /**
        See the `ei_device.frame` request for details.

        It is a protocol violation to send this event for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        Frame {
            /** this event's serial number */
            serial: u32,
            /** timestamp in microseconds */
            timestamp: u64,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("name"),
                2 => Some("device_type"),
                3 => Some("dimensions"),
                4 => Some("region"),
                5 => Some("interface"),
                6 => Some("done"),
                7 => Some("resumed"),
                8 => Some("paused"),
                9 => Some("start_emulating"),
                10 => Some("stop_emulating"),
                11 => Some("frame"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let name = _bytes.read_arg()?;

                    Ok(Self::Name { name })
                }
                2 => {
                    let device_type = _bytes.read_arg()?;

                    Ok(Self::DeviceType { device_type })
                }
                3 => {
                    let width = _bytes.read_arg()?;
                    let height = _bytes.read_arg()?;

                    Ok(Self::Dimensions { width, height })
                }
                4 => {
                    let offset_x = _bytes.read_arg()?;
                    let offset_y = _bytes.read_arg()?;
                    let width = _bytes.read_arg()?;
                    let hight = _bytes.read_arg()?;
                    let scale = _bytes.read_arg()?;

                    Ok(Self::Region {
                        offset_x,
                        offset_y,
                        width,
                        hight,
                        scale,
                    })
                }
                5 => {
                    let object = _bytes.read_arg()?;
                    let interface_name = _bytes.read_arg()?;
                    let version = _bytes.read_arg()?;

                    Ok(Self::Interface {
                        object: _bytes.backend().new_peer_object(
                            object,
                            interface_name,
                            version,
                        )?,
                    })
                }
                6 => Ok(Self::Done),
                7 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Resumed { serial })
                }
                8 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Paused { serial })
                }
                9 => {
                    let serial = _bytes.read_arg()?;
                    let sequence = _bytes.read_arg()?;

                    Ok(Self::StartEmulating { serial, sequence })
                }
                10 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::StopEmulating { serial })
                }
                11 => {
                    let serial = _bytes.read_arg()?;
                    let timestamp = _bytes.read_arg()?;

                    Ok(Self::Frame { serial, timestamp })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("device", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Name { name } => {
                    args.push(name.as_arg());
                }
                Self::DeviceType { device_type } => {
                    args.push(device_type.as_arg());
                }
                Self::Dimensions { width, height } => {
                    args.push(width.as_arg());
                    args.push(height.as_arg());
                }
                Self::Region {
                    offset_x,
                    offset_y,
                    width,
                    hight,
                    scale,
                } => {
                    args.push(offset_x.as_arg());
                    args.push(offset_y.as_arg());
                    args.push(width.as_arg());
                    args.push(hight.as_arg());
                    args.push(scale.as_arg());
                }
                Self::Interface { object } => {
                    args.push(object.as_arg());
                }
                Self::Done => {}
                Self::Resumed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Paused { serial } => {
                    args.push(serial.as_arg());
                }
                Self::StartEmulating { serial, sequence } => {
                    args.push(serial.as_arg());
                    args.push(sequence.as_arg());
                }
                Self::StopEmulating { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Frame { serial, timestamp } => {
                    args.push(serial.as_arg());
                    args.push(timestamp.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use device::Device;

/**
Interface for pointer motion requests and events. This interface
is available on devices with the `ei_device.capability` pointer.

This interface is only provided once per device and where a client
requests `ei_pointer.release` the interface does not get re-initialized. An
EIS implementation may adjust the behavior of the device (including removing
the device) if the interface is releasd.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod pointer {
    #[derive(Clone, Debug)]
    pub struct Pointer(pub(crate) crate::Object);

    impl crate::private::Sealed for Pointer {}

    impl crate::Interface for Pointer {
        const NAME: &'static str = "ei_pointer";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Pointer {}

    impl Pointer {
        /**
        Notification that the client is no longer interested in this pointer.
        The EIS implementation will release any resources related to this pointer and
        send the `ei_pointer.destroyed` event once complete.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Generate a relative motion event on this pointer.

        It is a client bug to send this request more than once
        within the same `ei_device.frame.`

        It is a client bug to send this request on a device without
        the `ei_device.capabilities.pointer` capability.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn motion_relative(&self, x: f32, y: f32) -> () {
            let args = &[crate::Arg::Float(x.into()), crate::Arg::Float(y.into())];

            self.0.request(1, args);

            ()
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This object has been removed and a client should release all
        associated resources.

        This object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        See the `ei_pointer.motion_relative` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        MotionRelative {
            /**  */
            x: f32,
            /**  */
            y: f32,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("motion_relative"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let x = _bytes.read_arg()?;
                    let y = _bytes.read_arg()?;

                    Ok(Self::MotionRelative { x, y })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("pointer", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::MotionRelative { x, y } => {
                    args.push(x.as_arg());
                    args.push(y.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use pointer::Pointer;

/**
Interface for absolute pointer requests and events. This interface
is available on devices with the `ei_device.capability` pointer_absolute.

This interface is only provided once per device and where a client
requests `ei_pointer_absolute.release` the interface does not get
re-initialized. An EIS implementation may adjust the behavior of the
device (including removing the device) if the interface is releasd.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod pointer_absolute {
    #[derive(Clone, Debug)]
    pub struct PointerAbsolute(pub(crate) crate::Object);

    impl crate::private::Sealed for PointerAbsolute {}

    impl crate::Interface for PointerAbsolute {
        const NAME: &'static str = "ei_pointer_absolute";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for PointerAbsolute {}

    impl PointerAbsolute {
        /**
        Notification that the client is no longer interested in this object.
        The EIS implementation will release any resources related to this object and
        send the `ei_pointer_absolute.destroyed` event once complete.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Generate an absolute motion event on this pointer. The x/y
        coordinates must be within the device's regions or the event
        is silently discarded.

        It is a client bug to send this request more than once
        within the same `ei_device.frame.`

        It is a client bug to send this request on a device without
        the `ei_device.capabilities.pointer_absolute` capability.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn motion_absolute(&self, x: f32, y: f32) -> () {
            let args = &[crate::Arg::Float(x.into()), crate::Arg::Float(y.into())];

            self.0.request(1, args);

            ()
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This object has been removed and a client should release all
        associated resources.

        This object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        See the `ei_pointer_absolute.motion_absolute` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        MotionAbsolute {
            /**  */
            x: f32,
            /**  */
            y: f32,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("motion_absolute"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let x = _bytes.read_arg()?;
                    let y = _bytes.read_arg()?;

                    Ok(Self::MotionAbsolute { x, y })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("pointer_absolute", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::MotionAbsolute { x, y } => {
                    args.push(x.as_arg());
                    args.push(y.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use pointer_absolute::PointerAbsolute;

/**
Interface for scroll requests and events. This interface
is available on devices with the `ei_device.capability` scroll.

This interface is only provided once per device and where a client
requests `ei_scroll.release` the interface does not get
re-initialized. An EIS implementation may adjust the behavior of the
device (including removing the device) if the interface is releasd.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod scroll {
    #[derive(Clone, Debug)]
    pub struct Scroll(pub(crate) crate::Object);

    impl crate::private::Sealed for Scroll {}

    impl crate::Interface for Scroll {
        const NAME: &'static str = "ei_scroll";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Scroll {}

    impl Scroll {
        /**
        Notification that the client is no longer interested in this object.
        The EIS implementation will release any resources related to this object and
        send the `ei_scroll.destroyed` event once complete.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Generate a a smooth (pixel-precise) scroll event on this pointer.
        Clients must not send `ei_scroll.scroll_discrete` events for the same event,
        the EIS implementation is responsible for emulation of discrete
        scroll events.

        It is a client bug to send this request more than once
        within the same `ei_device.frame.`

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn scroll(&self, x: f32, y: f32) -> () {
            let args = &[crate::Arg::Float(x.into()), crate::Arg::Float(y.into())];

            self.0.request(1, args);

            ()
        }

        /**
        Generate a a discrete (e.g. wheel) scroll event on this pointer.
        Clients must not send `ei_scroll.scroll` events for the same event,
        the EIS implementation is responsible for emulation of smooth
        scroll events.

        A discrete scroll event is based logical scroll units (equivalent to one
        mouse wheel click). The value for one scroll unit is 120, a fraction or
        multiple thereof represents a fraction or multiple of a wheel click.

        It is a client bug to send this request more than once
        within the same `ei_device.frame.`

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn scroll_discrete(&self, x: i32, y: i32) -> () {
            let args = &[crate::Arg::Int32(x.into()), crate::Arg::Int32(y.into())];

            self.0.request(2, args);

            ()
        }

        /**
        Generate a a scroll stop or cancel event on this pointer.

        A scroll stop event notifies the EIS implementation that the interaction causing a
        scroll motion previously triggered with `ei_scroll.scroll` or
        `ei_scroll.scroll_discrete` has stopped. For example, if all
        fingers are lifted off a touchpad, two-finger scrolling has logically
        stopped. The EIS implementation may use this information to e.g. start kinetic scrolling
        previously based on the previous finger speed.

        If is_cancel is nonzero, the event represents a cancellation of the
        current interaction. This indicates that the interaction has stopped to the
        point where further (server-emulated) scroll events from this device are wrong.

        It is a client bug to send this request more than once
        within the same `ei_device.frame.`

        It is a client bug to send this request for an axis that
        had a a nonzero value in either `ei_scroll.scroll` or `ei_scroll.scroll_discrete`
        in the current frame.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn scroll_stop(&self, x: u32, y: u32, is_cancel: u32) -> () {
            let args = &[
                crate::Arg::Uint32(x.into()),
                crate::Arg::Uint32(y.into()),
                crate::Arg::Uint32(is_cancel.into()),
            ];

            self.0.request(3, args);

            ()
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This object has been removed and a client should release all
        associated resources.

        This object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        See the `ei_scroll.scroll` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        Scroll {
            /**  */
            x: f32,
            /**  */
            y: f32,
        },
        /**
        See the `ei_scroll.scroll_discrete` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        ScrollDiscrete {
            /**  */
            x: i32,
            /**  */
            y: i32,
        },
        /**

        See the `ei_scroll.scroll_stop` request for details.
        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.
         */
        ScrollStop {
            /**  */
            x: u32,
            /**  */
            y: u32,
            /**  */
            is_cancel: u32,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("scroll"),
                2 => Some("scroll_discrete"),
                3 => Some("scroll_stop"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let x = _bytes.read_arg()?;
                    let y = _bytes.read_arg()?;

                    Ok(Self::Scroll { x, y })
                }
                2 => {
                    let x = _bytes.read_arg()?;
                    let y = _bytes.read_arg()?;

                    Ok(Self::ScrollDiscrete { x, y })
                }
                3 => {
                    let x = _bytes.read_arg()?;
                    let y = _bytes.read_arg()?;
                    let is_cancel = _bytes.read_arg()?;

                    Ok(Self::ScrollStop { x, y, is_cancel })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("scroll", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Scroll { x, y } => {
                    args.push(x.as_arg());
                    args.push(y.as_arg());
                }
                Self::ScrollDiscrete { x, y } => {
                    args.push(x.as_arg());
                    args.push(y.as_arg());
                }
                Self::ScrollStop { x, y, is_cancel } => {
                    args.push(x.as_arg());
                    args.push(y.as_arg());
                    args.push(is_cancel.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use scroll::Scroll;

/**
Interface for button requests and events. This interface
is available on devices with the `ei_device.capability` button.

This interface is only provided once per device and where a client
requests `ei_button.release` the interface does not get
re-initialized. An EIS implementation may adjust the behavior of the
device (including removing the device) if the interface is releasd.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod button {
    #[derive(Clone, Debug)]
    pub struct Button(pub(crate) crate::Object);

    impl crate::private::Sealed for Button {}

    impl crate::Interface for Button {
        const NAME: &'static str = "ei_button";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Button {}

    impl Button {
        /**
        Notification that the client is no longer interested in this object.
        The EIS implementation will release any resources related to this object and
        send the `ei_button.destroyed` event once complete.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Generate a button event on this pointer.

        The button codes must match the defines in linux/input-event-codes.h.

        It is a client bug to send more than one button request for the same button
        within the same `ei_device.frame.`

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn button(&self, button: u32, state: ButtonState) -> () {
            let args = &[
                crate::Arg::Uint32(button.into()),
                crate::Arg::Uint32(state.into()),
            ];

            self.0.request(1, args);

            ()
        }
    }

    /**
    The logical state of a button.
     */
    #[derive(Clone, Copy, Debug)]
    pub enum ButtonState {
        /** the button is logically up */
        Released = 0,
        /** the button is logically down */
        Press = 1,
    }

    impl From<ButtonState> for u32 {
        fn from(value: ButtonState) -> u32 {
            value as u32
        }
    }

    impl crate::OwnedArg for ButtonState {
        fn parse(buf: &mut crate::ByteStream) -> Result<Self, crate::ParseError> {
            match u32::parse(buf)? {
                0 => Ok(Self::Released),
                1 => Ok(Self::Press),
                variant => Err(crate::ParseError::InvalidVariant("ButtonState", variant)),
            }
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            crate::Arg::Uint32(*self as u32)
        }

        fn enum_name(&self) -> Option<(&'static str, &'static str)> {
            Some((
                "button_state",
                match self {
                    Self::Released => "released",
                    Self::Press => "press",
                },
            ))
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This pointer has been removed and a client should release all
        associated resources.

        This `ei_scroll` object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        See the `ei_scroll.button` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.

        It is an EIS implementation bug to send more than one button request
        for the same button within the same `ei_device.frame.`
         */
        Button {
            /**  */
            button: u32,
            /**  */
            state: ButtonState,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("button"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let button = _bytes.read_arg()?;
                    let state = _bytes.read_arg()?;

                    Ok(Self::Button { button, state })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("button", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Button { button, state } => {
                    args.push(button.as_arg());
                    args.push(state.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use button::Button;

/**
Interface for keyboard requests and events. This interface
is available on devices with the `ei_device.capability` keyboard.

This interface is only provided once per device and where a client
requests `ei_keyboard.release` the interface does not get re-initialized. An
EIS implementation may adjust the behavior of the device (including removing
the device) if the interface is releasd.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod keyboard {
    #[derive(Clone, Debug)]
    pub struct Keyboard(pub(crate) crate::Object);

    impl crate::private::Sealed for Keyboard {}

    impl crate::Interface for Keyboard {
        const NAME: &'static str = "ei_keyboard";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Keyboard {}

    impl Keyboard {
        /**
        Notification that the client is no longer interested in this keyboard.
        The EIS implementation will release any resources related to this keyboard and
        send the `ei_keyboard.destroyed` event once complete.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Generate a key event on this keyboard. If the device has an
        `ei_keyboard.keymap`, the key code corresponds to that keymap.

        The key codes must match the defines in linux/input-event-codes.h.

        It is a client bug to send more than one key request for the same key
        within the same `ei_device.frame.`

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than sender.
         */
        pub fn key(&self, key: u32, state: KeyState) -> () {
            let args = &[
                crate::Arg::Uint32(key.into()),
                crate::Arg::Uint32(state.into()),
            ];

            self.0.request(1, args);

            ()
        }
    }

    /**
    The logical state of a key.
     */
    #[derive(Clone, Copy, Debug)]
    pub enum KeyState {
        /** the key is logically up */
        Released = 0,
        /** the key is logically down */
        Press = 1,
    }

    impl From<KeyState> for u32 {
        fn from(value: KeyState) -> u32 {
            value as u32
        }
    }

    impl crate::OwnedArg for KeyState {
        fn parse(buf: &mut crate::ByteStream) -> Result<Self, crate::ParseError> {
            match u32::parse(buf)? {
                0 => Ok(Self::Released),
                1 => Ok(Self::Press),
                variant => Err(crate::ParseError::InvalidVariant("KeyState", variant)),
            }
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            crate::Arg::Uint32(*self as u32)
        }

        fn enum_name(&self) -> Option<(&'static str, &'static str)> {
            Some((
                "key_state",
                match self {
                    Self::Released => "released",
                    Self::Press => "press",
                },
            ))
        }
    }
    /**
    The keymap type describes how the keymap in the `ei_keyboard.keymap` event
    should be parsed.
     */
    #[derive(Clone, Copy, Debug)]
    pub enum KeymapType {
        /** a libxkbcommon-compatible XKB keymap */
        Xkb = 1,
    }

    impl From<KeymapType> for u32 {
        fn from(value: KeymapType) -> u32 {
            value as u32
        }
    }

    impl crate::OwnedArg for KeymapType {
        fn parse(buf: &mut crate::ByteStream) -> Result<Self, crate::ParseError> {
            match u32::parse(buf)? {
                1 => Ok(Self::Xkb),
                variant => Err(crate::ParseError::InvalidVariant("KeymapType", variant)),
            }
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            crate::Arg::Uint32(*self as u32)
        }

        fn enum_name(&self) -> Option<(&'static str, &'static str)> {
            Some((
                "keymap_type",
                match self {
                    Self::Xkb => "xkb",
                },
            ))
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This keyboard has been removed and a client should release all
        associated resources.

        This `ei_keyboard` object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        Notification that this device has a keymap. Future key events must be
        interpreted by the client according to this keymap. For clients
        of `ei_handshake.context_type` sender it is the client's
        responsibility to send the correct `ei_keyboard.key` keycodes to
        generate the expected keysym in the EIS implementation.

        The keymap is constant for the lifetime of the device.

        This event provides a file descriptor to the client which can be
        memory-mapped in read-only mode to provide a keyboard mapping
        description. The fd must be mapped with MAP_PRIVATE by
        the recipient, as MAP_SHARED may fail.

        This event is sent immediately after the `ei_keyboard` object is created
        and before the `ei_device.done` event. It is a protocol violation to send this
        event after the `ei_device.done` event.
         */
        Keymap {
            /** the keymap type */
            keymap_type: KeymapType,
            /** the keymap size in bytes */
            size: u32,
            /** file descriptor to the keymap */
            keymap: std::os::unix::io::OwnedFd,
        },
        /**
        See the `ei_keyboard.key` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.

        It is a protocol violation to send a key down event in the same
        frame as a key up event for the same key in the same frame.
         */
        Key {
            /**  */
            key: u32,
            /**  */
            state: KeyState,
        },
        /**
        Notification that the EIS implementation has changed modifier
        states on this device. Future `ei_keyboard.key` requests must take the
        new modifier state into account.

        A client must assume that all modifiers are lifted when it
        receives an `ei_device.paused` event. The EIS implementation
        must send this event after `ei_device.resumed` to notify the client
        of any nonzero modifier state.

        This event does not reqire an `ei_device.frame` and should
        be processed immediately by the client.

        This event is only sent for devices with an `ei_keyboard.keymap.`
         */
        Modifiers {
            /** this event's serial number */
            serial: u32,
            /** depressed modifiers */
            depressed: u32,
            /** locked modifiers */
            locked: u32,
            /** latched modifiers */
            latched: u32,
            /** the keyboard group (layout) */
            group: u32,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("keymap"),
                2 => Some("key"),
                3 => Some("modifiers"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let keymap_type = _bytes.read_arg()?;
                    let size = _bytes.read_arg()?;
                    let keymap = _bytes.read_arg()?;

                    Ok(Self::Keymap {
                        keymap_type,
                        size,
                        keymap,
                    })
                }
                2 => {
                    let key = _bytes.read_arg()?;
                    let state = _bytes.read_arg()?;

                    Ok(Self::Key { key, state })
                }
                3 => {
                    let serial = _bytes.read_arg()?;
                    let depressed = _bytes.read_arg()?;
                    let locked = _bytes.read_arg()?;
                    let latched = _bytes.read_arg()?;
                    let group = _bytes.read_arg()?;

                    Ok(Self::Modifiers {
                        serial,
                        depressed,
                        locked,
                        latched,
                        group,
                    })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("keyboard", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Keymap {
                    keymap_type,
                    size,
                    keymap,
                } => {
                    args.push(keymap_type.as_arg());
                    args.push(size.as_arg());
                    args.push(keymap.as_arg());
                }
                Self::Key { key, state } => {
                    args.push(key.as_arg());
                    args.push(state.as_arg());
                }
                Self::Modifiers {
                    serial,
                    depressed,
                    locked,
                    latched,
                    group,
                } => {
                    args.push(serial.as_arg());
                    args.push(depressed.as_arg());
                    args.push(locked.as_arg());
                    args.push(latched.as_arg());
                    args.push(group.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use keyboard::Keyboard;

/**
Interface for touchscreen requests and events. This interface
is available on devices with the `ei_device.capability` touchscreen.

This interface is only provided once per device and where a client
requests `ei_touchscreen.release` the interface does not get re-initialized. An
EIS implementation may adjust the behavior of the device (including removing
the device) if the interface is releasd.

Note that for a client to receive objects of this type, it must announce
support for this interface in `ei_handshake.interface_version.`
 */
pub mod touchscreen {
    #[derive(Clone, Debug)]
    pub struct Touchscreen(pub(crate) crate::Object);

    impl crate::private::Sealed for Touchscreen {}

    impl crate::Interface for Touchscreen {
        const NAME: &'static str = "ei_touchscreen";
        const VERSION: u32 = 1;
        const CLIENT_SIDE: bool = true;
        type Incoming = Event;

        fn new_unchecked(object: crate::Object) -> Self {
            Self(object)
        }

        fn as_arg(&self) -> crate::Arg<'_> {
            self.0.as_arg()
        }
    }

    impl crate::ei::Interface for Touchscreen {}

    impl Touchscreen {
        /**
        Notification that the client is no longer interested in this touch.
        The EIS implementation will release any resources related to this touch and
        send the `ei_touch.destroyed` event once complete.
         */
        pub fn release(&self) -> () {
            let args = &[];

            self.0.request(0, args);

            ()
        }

        /**
        Notifies the EIS implementation about a new touch logically down at the
        given coordinates. The touchid is a unique id for this touch. Touchids
        may be re-used after `ei_touchscreen.up.`

        The x/y coordinates must be within the device's regions or the event and future
        `ei_touchscreen.motion` events with the same touchid are silently discarded.

        It is a protocol violation to send a touch down in the same
        frame as a touch motion or touch up.
         */
        pub fn down(&self, touchid: u32, x: f32, y: f32) -> () {
            let args = &[
                crate::Arg::Uint32(touchid.into()),
                crate::Arg::Float(x.into()),
                crate::Arg::Float(y.into()),
            ];

            self.0.request(1, args);

            ()
        }

        /**
        Notifies the EIS implementation about an existing touch changing position to
        the given coordinates. The touchid is the unique id for this touch previously
        sent with `ei_touchscreen.down.`

        The x/y coordinates must be within the device's regions or the event is
        silently discarded.

        It is a protocol violation to send a touch motion in the same
        frame as a touch down or touch up.
         */
        pub fn motion(&self, touchid: u32, x: f32, y: f32) -> () {
            let args = &[
                crate::Arg::Uint32(touchid.into()),
                crate::Arg::Float(x.into()),
                crate::Arg::Float(y.into()),
            ];

            self.0.request(2, args);

            ()
        }

        /**
        Notifies the EIS implementation about an existing touch being logically
        up. The touchid is the unique id for this touch previously
        sent with `ei_touchscreen.down.`

        The touchid may be re-used after this request.

        It is a protocol violation to send a touch up in the same
        frame as a touch motion or touch down.
         */
        pub fn up(&self, touchid: u32) -> () {
            let args = &[crate::Arg::Uint32(touchid.into())];

            self.0.request(3, args);

            ()
        }
    }

    #[non_exhaustive]
    #[derive(Debug)]
    pub enum Event {
        /**
        This touch has been removed and a client should release all
        associated resources.

        This `ei_touchscreen` object will be destroyed by the EIS implementation immmediately after
        after this event is sent and as such the client must not attempt to use
        it after that point.
         */
        Destroyed {
            /** this event's serial number */
            serial: u32,
        },
        /**
        See the `ei_touchscreen.down` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.

        It is a protocol violation to send a touch down in the same
        frame as a touch motion or touch up.
         */
        Down {
            /**  */
            touchid: u32,
            /**  */
            x: f32,
            /**  */
            y: f32,
        },
        /**
        See the `ei_touchscreen.motion` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.

        It is a protocol violation to send a touch motion in the same
        frame as a touch down or touch up.
         */
        Motion {
            /**  */
            touchid: u32,
            /**  */
            x: f32,
            /**  */
            y: f32,
        },
        /**
        See the `ei_touchscreen.up` request for details.

        It is a protocol violation to send this request for a client
        of an `ei_handshake.context_type` other than receiver.

        It is a protocol violation to send a touch up in the same
        frame as a touch motion or touch down.
         */
        Up {
            /**  */
            touchid: u32,
        },
    }

    impl Event {
        pub(super) fn op_name(operand: u32) -> Option<&'static str> {
            match operand {
                0 => Some("destroyed"),
                1 => Some("down"),
                2 => Some("motion"),
                3 => Some("up"),
                _ => None,
            }
        }

        pub(super) fn parse(
            operand: u32,
            _bytes: &mut crate::ByteStream,
        ) -> Result<Self, crate::ParseError> {
            match operand {
                0 => {
                    let serial = _bytes.read_arg()?;

                    Ok(Self::Destroyed { serial })
                }
                1 => {
                    let touchid = _bytes.read_arg()?;
                    let x = _bytes.read_arg()?;
                    let y = _bytes.read_arg()?;

                    Ok(Self::Down { touchid, x, y })
                }
                2 => {
                    let touchid = _bytes.read_arg()?;
                    let x = _bytes.read_arg()?;
                    let y = _bytes.read_arg()?;

                    Ok(Self::Motion { touchid, x, y })
                }
                3 => {
                    let touchid = _bytes.read_arg()?;

                    Ok(Self::Up { touchid })
                }
                opcode => Err(crate::ParseError::InvalidOpcode("touchscreen", opcode)),
            }
        }

        #[allow(
            unused_imports,
            unused_mut,
            unused_variables,
            unreachable_code,
            unreachable_patterns
        )]
        pub(super) fn args(&self) -> Vec<crate::Arg<'_>> {
            use crate::{arg::OwnedArg, Interface};
            let mut args = Vec::new();
            match self {
                Self::Destroyed { serial } => {
                    args.push(serial.as_arg());
                }
                Self::Down { touchid, x, y } => {
                    args.push(touchid.as_arg());
                    args.push(x.as_arg());
                    args.push(y.as_arg());
                }
                Self::Motion { touchid, x, y } => {
                    args.push(touchid.as_arg());
                    args.push(x.as_arg());
                    args.push(y.as_arg());
                }
                Self::Up { touchid } => {
                    args.push(touchid.as_arg());
                }
                _ => unreachable!(),
            }
            args
        }
    }
}

pub use touchscreen::Touchscreen;

#[non_exhaustive]
#[derive(Debug)]
pub enum Event {
    Handshake(handshake::Handshake, handshake::Event),
    Connection(connection::Connection, connection::Event),
    Callback(callback::Callback, callback::Event),
    Pingpong(pingpong::Pingpong, pingpong::Event),
    Seat(seat::Seat, seat::Event),
    Device(device::Device, device::Event),
    Pointer(pointer::Pointer, pointer::Event),
    PointerAbsolute(pointer_absolute::PointerAbsolute, pointer_absolute::Event),
    Scroll(scroll::Scroll, scroll::Event),
    Button(button::Button, button::Event),
    Keyboard(keyboard::Keyboard, keyboard::Event),
    Touchscreen(touchscreen::Touchscreen, touchscreen::Event),
}

impl Event {
    pub(crate) fn op_name(interface: &str, operand: u32) -> Option<&'static str> {
        match interface {
            "ei_handshake" => handshake::Event::op_name(operand),
            "ei_connection" => connection::Event::op_name(operand),
            "ei_callback" => callback::Event::op_name(operand),
            "ei_pingpong" => pingpong::Event::op_name(operand),
            "ei_seat" => seat::Event::op_name(operand),
            "ei_device" => device::Event::op_name(operand),
            "ei_pointer" => pointer::Event::op_name(operand),
            "ei_pointer_absolute" => pointer_absolute::Event::op_name(operand),
            "ei_scroll" => scroll::Event::op_name(operand),
            "ei_button" => button::Event::op_name(operand),
            "ei_keyboard" => keyboard::Event::op_name(operand),
            "ei_touchscreen" => touchscreen::Event::op_name(operand),
            _ => None,
        }
    }

    pub(crate) fn parse(
        id: u64,
        interface: &str,
        operand: u32,
        bytes: &mut crate::ByteStream,
    ) -> Result<Self, crate::ParseError> {
        match interface {
            "ei_handshake" => Ok(Self::Handshake(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                handshake::Event::parse(operand, bytes)?,
            )),
            "ei_connection" => Ok(Self::Connection(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                connection::Event::parse(operand, bytes)?,
            )),
            "ei_callback" => Ok(Self::Callback(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                callback::Event::parse(operand, bytes)?,
            )),
            "ei_pingpong" => Ok(Self::Pingpong(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                pingpong::Event::parse(operand, bytes)?,
            )),
            "ei_seat" => Ok(Self::Seat(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                seat::Event::parse(operand, bytes)?,
            )),
            "ei_device" => Ok(Self::Device(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                device::Event::parse(operand, bytes)?,
            )),
            "ei_pointer" => Ok(Self::Pointer(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                pointer::Event::parse(operand, bytes)?,
            )),
            "ei_pointer_absolute" => Ok(Self::PointerAbsolute(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                pointer_absolute::Event::parse(operand, bytes)?,
            )),
            "ei_scroll" => Ok(Self::Scroll(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                scroll::Event::parse(operand, bytes)?,
            )),
            "ei_button" => Ok(Self::Button(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                button::Event::parse(operand, bytes)?,
            )),
            "ei_keyboard" => Ok(Self::Keyboard(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                keyboard::Event::parse(operand, bytes)?,
            )),
            "ei_touchscreen" => Ok(Self::Touchscreen(
                crate::Object::new(bytes.backend().clone(), id, true).downcast_unchecked(),
                touchscreen::Event::parse(operand, bytes)?,
            )),
            _ => Err(crate::ParseError::InvalidInterface),
        }
    }
}

impl crate::MessageEnum for Event {
    fn args(&self) -> Vec<crate::Arg<'_>> {
        match self {
            Self::Handshake(_, x) => x.args(),
            Self::Connection(_, x) => x.args(),
            Self::Callback(_, x) => x.args(),
            Self::Pingpong(_, x) => x.args(),
            Self::Seat(_, x) => x.args(),
            Self::Device(_, x) => x.args(),
            Self::Pointer(_, x) => x.args(),
            Self::PointerAbsolute(_, x) => x.args(),
            Self::Scroll(_, x) => x.args(),
            Self::Button(_, x) => x.args(),
            Self::Keyboard(_, x) => x.args(),
            Self::Touchscreen(_, x) => x.args(),
        }
    }
}