import * as i0 from '@angular/core';
import { InputSignal, TemplateRef, Type, InputSignalWithTransform, ModelSignal, OutputEmitterRef, Signal, InjectionToken } from '@angular/core';
import { VariantProps, cva } from 'class-variance-authority';
import { ConnectedPosition, ConnectionPositionPair } from '@angular/cdk/overlay';

type PopoverPosition = 'above' | 'below' | 'left' | 'right' | 'auto';
type PopoverAlignment = 'start' | 'center' | 'end';
type PopoverTriggerOn = 'click' | 'focus' | 'manual';
type PopoverVariant = 'default' | 'compact' | 'wide' | 'flush';
type PopoverBackdrop = 'transparent' | 'dimmed' | 'none';
type PopoverSide = 'top' | 'bottom' | 'left' | 'right';
/**
 * Popover panel styling variants.
 *
 * @tokens `--color-popover`, `--color-popover-foreground`, `--color-border`, `--shadow-overlay`, `--radius-popover`, `--radius-overlay`
 */
declare const popoverPanelVariants: ReturnType<typeof cva<{
    variant: Record<PopoverVariant, string>;
}>>;
type PopoverPanelVariants = VariantProps<typeof popoverPanelVariants>;
/**
 * Popover arrow positioning variants.
 * The arrow is positioned on the edge of the popover pointing toward the trigger.
 *
 * @tokens `--color-popover`, `--color-border`
 */
declare const popoverArrowVariants: ReturnType<typeof cva<{
    side: Record<PopoverSide, string>;
}>>;
type PopoverArrowVariants = VariantProps<typeof popoverArrowVariants>;

/**
 * Popover trigger directive — manages the popover overlay lifecycle.
 * Applied to the trigger element, it handles opening, closing, positioning,
 * and accessibility for floating popover content.
 *
 * @tokens `--color-popover`, `--color-popover-foreground`, `--color-border`, `--shadow-overlay`, `--color-ring`
 *
 * @example Basic usage with template
 * ```html
 * <button comButton [comPopoverTrigger]="helpContent">Help</button>
 * <ng-template #helpContent>
 *   <p>This is help content.</p>
 * </ng-template>
 * ```
 *
 * @example With positioning
 * ```html
 * <button
 *   comButton
 *   [comPopoverTrigger]="menuContent"
 *   popoverPosition="below"
 *   popoverAlignment="start"
 *   [popoverShowArrow]="false"
 * >
 *   Menu
 * </button>
 * ```
 *
 * @example With component content
 * ```html
 * <button
 *   comButton
 *   [comPopoverTrigger]="UserProfilePopover"
 *   [popoverData]="{ userId: user.id }"
 * >
 *   Profile
 * </button>
 * ```
 *
 * @example Manual control
 * ```html
 * <button
 *   comButton
 *   [comPopoverTrigger]="content"
 *   popoverTriggerOn="manual"
 *   [(popoverOpen)]="isOpen"
 * >
 *   Controlled
 * </button>
 * ```
 */
declare class ComPopoverTrigger {
    private readonly overlay;
    private readonly elementRef;
    private readonly viewContainerRef;
    private readonly injector;
    private readonly destroyRef;
    private readonly focusTrapFactory;
    private readonly document;
    private overlayRef;
    private focusTrap;
    private scrollCleanup;
    private closeTimeoutId;
    private destroyed;
    private readonly popoverId;
    /** Content to render: TemplateRef or Component class. */
    readonly comPopoverTrigger: InputSignal<TemplateRef<unknown> | Type<unknown>>;
    /** Preferred position direction. */
    readonly popoverPosition: InputSignal<PopoverPosition>;
    /** Alignment along the cross-axis. */
    readonly popoverAlignment: InputSignal<PopoverAlignment>;
    /** What interaction opens the popover. */
    readonly popoverTriggerOn: InputSignal<PopoverTriggerOn>;
    /** Gap in px between trigger and popover edge. */
    readonly popoverOffset: InputSignal<number>;
    /** Whether to render the connecting arrow. */
    readonly popoverShowArrow: InputSignalWithTransform<boolean, unknown>;
    /** Size/padding preset for the content panel. */
    readonly popoverVariant: InputSignal<PopoverVariant>;
    /** Backdrop behavior. */
    readonly popoverBackdrop: InputSignal<PopoverBackdrop>;
    /** Close when clicking outside the popover. */
    readonly popoverCloseOnOutside: InputSignalWithTransform<boolean, unknown>;
    /** Close on Escape key. */
    readonly popoverCloseOnEscape: InputSignalWithTransform<boolean, unknown>;
    /** Close when ancestor scrollable container scrolls. */
    readonly popoverCloseOnScroll: InputSignalWithTransform<boolean, unknown>;
    /** Prevents opening when true. */
    readonly popoverDisabled: InputSignalWithTransform<boolean, unknown>;
    /** Two-way bindable open state. */
    readonly popoverOpen: ModelSignal<boolean>;
    /** Arbitrary data passed to the content component/template. */
    readonly popoverData: InputSignal<unknown>;
    /** Custom CSS class(es) on the overlay panel. */
    readonly popoverPanelClass: InputSignal<string | string[]>;
    /** Trap focus inside popover. */
    readonly popoverTrapFocus: InputSignalWithTransform<boolean, unknown>;
    /** Optional accessibility label for the popover dialog. */
    readonly popoverAriaLabel: InputSignal<string | undefined>;
    /** Emitted after popup opens and is visible. */
    readonly popoverOpened: OutputEmitterRef<void>;
    /** Emitted after popup closes and is detached. */
    readonly popoverClosed: OutputEmitterRef<void>;
    private readonly activeSide;
    private readonly activeAlignment;
    private readonly animationState;
    private contentComponentRef;
    private readonly hasBackdrop;
    private readonly backdropClass;
    protected readonly ariaControls: Signal<string | null>;
    private readonly panelClassArray;
    constructor();
    /** Programmatically open the popover. */
    open(): void;
    /** Programmatically close the popover. */
    close(): void;
    /** Toggle the popover open/close state. */
    toggle(): void;
    /** Force recalculation of position. */
    reposition(): void;
    protected onTriggerClick(event: MouseEvent): void;
    protected onTriggerFocus(): void;
    protected onTriggerBlur(): void;
    protected onEscapeKey(event: Event): void;
    private openPopover;
    private closePopover;
    private cancelPendingClose;
    private subscribeToScrollEvents;
    private unsubscribeFromScrollEvents;
    private createOverlay;
    private attachContent;
    private updateContentComponentInputs;
    private detachContent;
    private subscribeToCloseEvents;
    private setupFocusTrap;
    private destroyFocusTrap;
    private disposeOverlay;
    static ɵfac: i0.ɵɵFactoryDeclaration<ComPopoverTrigger, never>;
    static ɵdir: i0.ɵɵDirectiveDeclaration<ComPopoverTrigger, "[comPopoverTrigger]", ["comPopoverTrigger"], { "comPopoverTrigger": { "alias": "comPopoverTrigger"; "required": true; "isSignal": true; }; "popoverPosition": { "alias": "popoverPosition"; "required": false; "isSignal": true; }; "popoverAlignment": { "alias": "popoverAlignment"; "required": false; "isSignal": true; }; "popoverTriggerOn": { "alias": "popoverTriggerOn"; "required": false; "isSignal": true; }; "popoverOffset": { "alias": "popoverOffset"; "required": false; "isSignal": true; }; "popoverShowArrow": { "alias": "popoverShowArrow"; "required": false; "isSignal": true; }; "popoverVariant": { "alias": "popoverVariant"; "required": false; "isSignal": true; }; "popoverBackdrop": { "alias": "popoverBackdrop"; "required": false; "isSignal": true; }; "popoverCloseOnOutside": { "alias": "popoverCloseOnOutside"; "required": false; "isSignal": true; }; "popoverCloseOnEscape": { "alias": "popoverCloseOnEscape"; "required": false; "isSignal": true; }; "popoverCloseOnScroll": { "alias": "popoverCloseOnScroll"; "required": false; "isSignal": true; }; "popoverDisabled": { "alias": "popoverDisabled"; "required": false; "isSignal": true; }; "popoverOpen": { "alias": "popoverOpen"; "required": false; "isSignal": true; }; "popoverData": { "alias": "popoverData"; "required": false; "isSignal": true; }; "popoverPanelClass": { "alias": "popoverPanelClass"; "required": false; "isSignal": true; }; "popoverTrapFocus": { "alias": "popoverTrapFocus"; "required": false; "isSignal": true; }; "popoverAriaLabel": { "alias": "popoverAriaLabel"; "required": false; "isSignal": true; }; }, { "popoverOpen": "popoverOpenChange"; "popoverOpened": "popoverOpened"; "popoverClosed": "popoverClosed"; }, never, never, true, never>;
}

/**
 * Convenience directive that closes the parent popover when clicked.
 * Applied to elements inside the popover that should dismiss it.
 *
 * @tokens none
 *
 * @example
 * ```html
 * <ng-template #confirmPop>
 *   <div class="space-y-3">
 *     <p>Are you sure?</p>
 *     <div class="flex gap-2">
 *       <button comButton variant="ghost" comPopoverClose>Cancel</button>
 *       <button comButton (click)="confirm()" comPopoverClose>Confirm</button>
 *     </div>
 *   </div>
 * </ng-template>
 * ```
 *
 * @example With a result value
 * ```html
 * <button [comPopoverClose]="'confirmed'" (click)="onConfirm()">Yes</button>
 * <button [comPopoverClose]="'cancelled'">No</button>
 * ```
 */
declare class ComPopoverClose {
    private readonly popoverRef;
    /**
     * Optional result value to pass when closing.
     * This value is emitted via the trigger's close event.
     */
    readonly comPopoverClose: InputSignal<unknown>;
    protected closePopover(): void;
    static ɵfac: i0.ɵɵFactoryDeclaration<ComPopoverClose, never>;
    static ɵdir: i0.ɵɵDirectiveDeclaration<ComPopoverClose, "[comPopoverClose]", ["comPopoverClose"], { "comPopoverClose": { "alias": "comPopoverClose"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
}

/**
 * Marker directive for lazy popover content templates.
 * Applied to `<ng-template>` to indicate content that should be
 * lazily instantiated when the popover opens.
 *
 * This directive is primarily semantic — it marks the template as popover content
 * and provides access to the TemplateRef for potential content queries.
 *
 * @tokens none
 *
 * @example
 * ```html
 * <button [comPopoverTrigger]="helpContent">Help</button>
 * <ng-template comPopoverTemplate #helpContent>
 *   <p>This is help content.</p>
 * </ng-template>
 * ```
 *
 * Note: You can also pass a template reference directly without this directive:
 * ```html
 * <button [comPopoverTrigger]="helpContent">Help</button>
 * <ng-template #helpContent>
 *   <p>This also works.</p>
 * </ng-template>
 * ```
 */
declare class ComPopoverTemplate {
    /** Reference to the template for rendering. */
    readonly templateRef: TemplateRef<unknown>;
    static ɵfac: i0.ɵɵFactoryDeclaration<ComPopoverTemplate, never>;
    static ɵdir: i0.ɵɵDirectiveDeclaration<ComPopoverTemplate, "[comPopoverTemplate]", ["comPopoverTemplate"], {}, {}, never, never, true, never>;
}

/**
 * Interface for the popover reference injected into content.
 * Provides methods to control the popover from within content.
 */
interface PopoverRef {
    /** Programmatically open the popover. */
    open(): void;
    /** Programmatically close the popover. */
    close(): void;
    /** Toggle the popover open/close state. */
    toggle(): void;
    /** Force recalculation of position. */
    reposition(): void;
}
/**
 * Data passed to a component rendered inside the popover.
 * Inject this token to access the data provided via `popoverData` input.
 *
 * @example
 * ```ts
 * @Component({ ... })
 * export class UserProfilePopover {
 *   readonly data = inject(POPOVER_DATA); // { userId: '123' }
 * }
 * ```
 */
declare const POPOVER_DATA: InjectionToken<unknown>;
/**
 * Reference to the popover trigger directive for closing from inside the popover.
 * Inject this token to programmatically close the popover from within content.
 *
 * @example
 * ```ts
 * @Component({ ... })
 * export class UserProfilePopover {
 *   readonly popoverRef = inject(POPOVER_REF);
 *
 *   save(): void {
 *     // ... save logic
 *     this.popoverRef.close();
 *   }
 * }
 * ```
 */
declare const POPOVER_REF: InjectionToken<PopoverRef>;

/**
 * Build an ordered list of position pairs for the CDK overlay.
 * The first position is the preferred position; remaining positions are fallbacks.
 *
 * @param position - Preferred position direction ('above', 'below', 'left', 'right', 'auto')
 * @param alignment - Alignment along the cross-axis ('start', 'center', 'end')
 * @param offset - Gap in pixels between trigger and popover edge (default: 8)
 * @returns Array of ConnectedPosition for FlexibleConnectedPositionStrategy
 */
declare function buildPopoverPositions(position: PopoverPosition, alignment: PopoverAlignment, offset?: number): ConnectedPosition[];
/**
 * Derive which side of the trigger the popover is on from a connection pair.
 * Used to position the arrow correctly.
 *
 * The returned side indicates where the popover sits relative to the trigger:
 * - 'bottom': popover is below trigger, arrow at top pointing up
 * - 'top': popover is above trigger, arrow at bottom pointing down
 * - 'right': popover is right of trigger, arrow at left pointing left
 * - 'left': popover is left of trigger, arrow at right pointing right
 */
declare function deriveSideFromPosition(pair: ConnectionPositionPair): PopoverSide;
/**
 * Derive alignment from a connection pair.
 */
declare function deriveAlignmentFromPosition(pair: ConnectionPositionPair): PopoverAlignment;

export { ComPopoverClose, ComPopoverTemplate, ComPopoverTrigger, POPOVER_DATA, POPOVER_REF, buildPopoverPositions, deriveAlignmentFromPosition, deriveSideFromPosition, popoverArrowVariants, popoverPanelVariants };
export type { PopoverAlignment, PopoverArrowVariants, PopoverBackdrop, PopoverPanelVariants, PopoverPosition, PopoverRef, PopoverSide, PopoverTriggerOn, PopoverVariant };