/**
 * @license
 * Copyright 2022-2026 Matter.js Authors
 * SPDX-License-Identifier: Apache-2.0
 */

/*** THIS FILE IS GENERATED, DO NOT EDIT ***/

import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
import { OnOffServer as BaseOnOffServer } from "../behaviors/on-off/OnOffServer.js";
import {
    ScenesManagementServer as BaseScenesManagementServer
} from "../behaviors/scenes-management/ScenesManagementServer.js";
import { LevelControlServer as BaseLevelControlServer } from "../behaviors/level-control/LevelControlServer.js";
import {
    OccupancySensingClient as BaseOccupancySensingClient
} from "../behaviors/occupancy-sensing/OccupancySensingClient.js";
import { MutableEndpoint } from "../endpoint/type/MutableEndpoint.js";
import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js";
import { Identity } from "@matter/general";

/**
 * A Mounted On/Off Control is a fixed device that provides power to another device or power circuit that is connected
 * to it, and is capable of switching that provided power on or off.
 *
 * This device type is intended for any wall-mounted or hardwired load controller, while On/Off Plug-in Unit is intended
 * only for smart plugs and other power switching devices that are not permanently connected, and which can be unplugged
 * from their power source.
 *
 * > [!NOTE]
 *
 * > NOTE: Since this device type was added in Matter 1.4, for endpoints using this device type it is recommended to add
 *   the subset device type On/Off Plug-in Unit to the DeviceTypeList of the Descriptor cluster on the same endpoint for
 *   backward compatibility with existing clients. See On/Off Plug-in Unit client guidance for additional information,
 *   regarding the inclusion of these two device types.
 *
 * ### Cluster Requirements
 *
 * The inclusion of the Level Control cluster on this device is recommended to provide a consistent user experience when
 * the device is grouped with additional dimmable lights and the “with on/off” commands are used. For this device, since
 * its only states are on or off, if the Level Control cluster is implemented, it shall NOT have any effect on the
 * actual light level except for those commands that cause an on/off state change, that is, the “with on/off” commands.
 * In addition, if the Level Control cluster is implemented, the device shall accept and process Level Control cluster
 * commands, adjusting the value of the CurrentLevel attribute accordingly and, where necessary, adjusting the On/Off
 * cluster OnOff attribute.
 *
 * ### Element Requirements
 *
 * As the TriggerEffect command of the Identify cluster and the OffWithEffect command of the On/Off cluster specify
 * light effects that require dimming of the light output, and such is not possible on this device type, the specified
 * light effects may be replaced by pure on/off light effects.
 *
 * @see {@link MatterSpecification.v161.Device} § 5.3
 */
export interface MountedOnOffControlDevice extends Identity<typeof MountedOnOffControlDeviceDefinition> {}

export namespace MountedOnOffControlRequirements {
    /**
     * The Identify cluster is required by the Matter specification.
     *
     * This version of {@link IdentifyServer} is specialized per the specification.
     */
    export const IdentifyServer = BaseIdentifyServer.alter({ commands: { triggerEffect: { optional: false } } });

    /**
     * The Groups cluster is required by the Matter specification.
     *
     * We provide this alias to the default implementation {@link GroupsServer} for convenience.
     */
    export const GroupsServer = BaseGroupsServer;

    /**
     * The OnOff cluster is required by the Matter specification.
     *
     * This version of {@link OnOffServer} is specialized per the specification.
     */
    export const OnOffServer = BaseOnOffServer.with("Lighting");

    /**
     * The ScenesManagement cluster is required by the Matter specification.
     *
     * This version of {@link ScenesManagementServer} is specialized per the specification.
     */
    export const ScenesManagementServer = BaseScenesManagementServer
        .alter({ commands: { copyScene: { optional: false } } });

    /**
     * The LevelControl cluster is optional per the Matter specification.
     *
     * This version of {@link LevelControlServer} is specialized per the specification.
     */
    export const LevelControlServer = BaseLevelControlServer
        .with("OnOff", "Lighting")
        .alter({
            attributes: {
                currentLevel: { min: 1, max: 254 },
                minLevel: { min: 1, max: 1, default: 1 },
                maxLevel: { min: 254, max: 254, default: 254 }
            }
        });

    /**
     * The OccupancySensing cluster is optional per the Matter specification.
     *
     * We provide this alias to the default implementation {@link OccupancySensingClient} for convenience.
     */
    export const OccupancySensingClient = BaseOccupancySensingClient;

    /**
     * An implementation for each server cluster supported by the endpoint per the Matter specification.
     */
    export const server = {
        mandatory: {
            Identify: IdentifyServer,
            Groups: GroupsServer,
            OnOff: OnOffServer,
            ScenesManagement: ScenesManagementServer
        },

        optional: { LevelControl: LevelControlServer }
    };

    /**
     * A definition for each client cluster supported by the endpoint per the Matter specification.
     */
    export const client = { optional: { OccupancySensing: OccupancySensingClient } };
}

export const MountedOnOffControlDeviceDefinition = MutableEndpoint({
    name: "MountedOnOffControl",
    deviceType: 0x10f,
    deviceRevision: 3,
    requirements: MountedOnOffControlRequirements,

    behaviors: SupportedBehaviors(
        MountedOnOffControlRequirements.server.mandatory.Identify,
        MountedOnOffControlRequirements.server.mandatory.Groups,
        MountedOnOffControlRequirements.server.mandatory.OnOff,
        MountedOnOffControlRequirements.server.mandatory.ScenesManagement
    )
});

Object.freeze(MountedOnOffControlDeviceDefinition);
export const MountedOnOffControlDevice: MountedOnOffControlDevice = MountedOnOffControlDeviceDefinition;