/**
 *
 * GalleryZoomToggle dispatches `zoom-in` when the active item is at normal scale and `zoom-out` when it is zoomed.
 * Useful for a single button that handles both directions. The slot scope exposes the current `zoomed` flag for
 * conditional icon rendering.
 *
 * [Live Demo](https://www.primevue.dev/gallery/)
 *
 * @module galleryzoomtoggle
 *
 */
import type { DefineComponent, DesignToken, EmitFn, PassThrough } from '@primevue/core';
import type { ComponentHooks } from '@primevue/core/basecomponent';
import type { PassThroughOptions } from 'primevue/passthrough';
import type { ButtonHTMLAttributes, Component, VNode } from 'vue';

export declare type GalleryZoomTogglePassThroughOptionType = GalleryZoomTogglePassThroughAttributes | ((options: GalleryZoomTogglePassThroughMethodOptions) => GalleryZoomTogglePassThroughAttributes | string) | string | null | undefined;

/**
 * Custom passthrough(pt) option method.
 */
export interface GalleryZoomTogglePassThroughMethodOptions {
    /**
     * Defines instance.
     */
    instance: any;
    /**
     * Defines valid properties.
     */
    props: GalleryZoomToggleProps;
    /**
     * Defines valid attributes.
     */
    attrs: any;
    /**
     * Defines parent options.
     */
    parent: any;
    /**
     * Defines passthrough(pt) options in global config.
     */
    global: object | undefined;
}

/**
 * Custom passthrough(pt) options.
 * @see {@link GalleryZoomToggleProps.pt}
 */
export interface GalleryZoomTogglePassThroughOptions {
    /**
     * Used to pass attributes to the root's DOM element.
     */
    root?: GalleryZoomTogglePassThroughOptionType;
    /**
     * Used to manage all lifecycle hooks.
     */
    hooks?: ComponentHooks;
}

/**
 * Custom passthrough attributes for each DOM elements.
 */
export interface GalleryZoomTogglePassThroughAttributes {
    [key: string]: any;
}

/**
 * Defines valid properties in GalleryZoomToggle component.
 */
export interface GalleryZoomToggleProps {
    /**
     * Use to change the HTML tag of root element.
     * @defaultValue BUTTON
     */
    as?: string | Component | undefined;
    /**
     * When enabled, it changes the default rendered element for the one passed as a child element.
     * @defaultValue false
     */
    asChild?: boolean | undefined;
    /**
     * It generates scoped CSS variables using design tokens for the component.
     */
    dt?: DesignToken<any>;
    /**
     * Used to pass attributes to DOM elements inside the component.
     */
    pt?: PassThrough<GalleryZoomTogglePassThroughOptions>;
    /**
     * Used to configure passthrough(pt) options of the component.
     */
    ptOptions?: PassThroughOptions;
    /**
     * When enabled, it removes component related styles in the core.
     * @defaultValue false
     */
    unstyled?: boolean;
}

/**
 * Root element attributes forwarded to the consumer when `asChild` is enabled.
 */
export interface GalleryZoomToggleA11yAttrs extends ButtonHTMLAttributes {
    /**
     * Marker attribute used by Gallery to identify the dispatched action.
     */
    'data-action': 'zoom-toggle';
    /**
     * Click handler that toggles between `zoom-in` and `zoom-out` based on the current state.
     */
    onClick: (event: MouseEvent) => void;
}

/**
 * Defines valid slots in GalleryZoomToggle component.
 */
export interface GalleryZoomToggleSlots {
    /**
     * Custom content template. Receives `zoomed` (and consumer-targeted props when `asChild` is enabled).
     * @param {Object} scope - default slot's params.
     */
    default(scope: {
        /**
         * Computed class name for the button root (only emitted when `asChild` is enabled).
         */
        class?: string | object | Array<string | object>;
        /**
         * Click handler to spread on the consumer's root element (only emitted when `asChild` is enabled).
         */
        onClick?: (event: MouseEvent) => void;
        /**
         * Whether the active item is currently zoomed. Useful for swapping icons.
         */
        zoomed: boolean;
    }): VNode[];
}

/**
 * Defines valid emits in GalleryZoomToggle component.
 */
export interface GalleryZoomToggleEmitsOptions {}

export declare type GalleryZoomToggleEmits = EmitFn<GalleryZoomToggleEmitsOptions>;

/**
 * **PrimeVue - GalleryZoomToggle**
 *
 * _GalleryZoomToggle is a helper component for Gallery component._
 *
 * [Live Demo](https://www.primevue.dev/gallery/)
 * --- ---
 * ![PrimeVue](https://primefaces.org/cdn/primevue/images/logo-100.png)
 *
 * @group Component
 *
 */
declare const GalleryZoomToggle: DefineComponent<GalleryZoomToggleProps, GalleryZoomToggleSlots, GalleryZoomToggleEmits>;

declare module 'vue' {
    export interface GlobalComponents {
        GalleryZoomToggle: DefineComponent<GalleryZoomToggleProps, GalleryZoomToggleSlots, GalleryZoomToggleEmits>;
    }
}

export default GalleryZoomToggle;