import { VariantProps } from 'class-variance-authority';
import * as i0 from '@angular/core';
import { ModelSignal, InputSignal, OutputEmitterRef, WritableSignal, Signal } from '@angular/core';
import { ControlValueAccessor, Validator, NgControl, ValidationErrors } from '@angular/forms';
import { FormFieldControl, ErrorStateMatcher, FormFieldAppearance } from 'ngx-com/components/form-field';

/**
 * Types and interfaces for the TimePicker component.
 */
/** Value type for the standalone time picker */
interface ComTimeValue {
    /** Hours (0-23, always stored in 24h format internally) */
    hours: number;
    /** Minutes (0-59) */
    minutes: number;
    /** Seconds (0-59) */
    seconds: number;
}
/** Creates a ComTimeValue */
declare function createTimeValue(hours?: number, minutes?: number, seconds?: number): ComTimeValue;
/**
 * Compares two ComTimeValue objects.
 * @returns negative if a < b, 0 if equal, positive if a > b
 */
declare function compareTime(a: ComTimeValue, b: ComTimeValue): number;
declare function generateTimePickerId(): string;
/** Size variants for time picker */
type TimePickerSize = 'sm' | 'default' | 'lg';
/** Visual variant */
type TimePickerVariant = 'standalone' | 'embedded' | 'naked';
/** Validation state */
type TimePickerState = 'default' | 'error' | 'success';
/** Period for 12-hour format */
type TimePeriod = 'AM' | 'PM';
/** Segment type */
type TimeSegment = 'hours' | 'minutes' | 'seconds';

/**
 * CVA variants for the time picker container.
 *
 * @tokens `--color-input-background`, `--color-input-foreground`, `--color-input-border`,
 *         `--color-ring`, `--color-warn`, `--color-success`, `--radius-input`
 */
declare const timepickerContainerVariants: (props?: {
    variant?: TimePickerVariant;
    size?: TimePickerSize;
    state?: TimePickerState;
}) => string;
type TimepickerContainerVariants = VariantProps<typeof timepickerContainerVariants>;
/**
 * CVA variants for the disabled state of time picker.
 *
 * @tokens `--color-disabled`, `--color-disabled-foreground`
 */
declare const timepickerDisabledVariants: () => string;
type TimepickerDisabledVariants = VariantProps<typeof timepickerDisabledVariants>;
/**
 * CVA variants for each time segment input.
 *
 * @tokens `--color-primary-subtle`, `--color-primary-subtle-foreground`, `--radius-interactive-sm`
 */
declare const timepickerSegmentVariants: (props?: {
    size?: TimePickerSize;
}) => string;
type TimepickerSegmentVariants = VariantProps<typeof timepickerSegmentVariants>;
/**
 * CVA variants for the colon separator.
 *
 * @tokens `--color-muted-foreground`
 */
declare const timepickerSeparatorVariants: (props?: {
    size?: TimePickerSize;
}) => string;
type TimepickerSeparatorVariants = VariantProps<typeof timepickerSeparatorVariants>;
/**
 * CVA variants for the AM/PM toggle button.
 *
 * @tokens `--color-muted`, `--color-muted-foreground`, `--color-muted-hover`, `--color-ring`,
 *         `--radius-control-sm`
 */
declare const timepickerPeriodVariants: (props?: {
    size?: TimePickerSize;
}) => string;
type TimepickerPeriodVariants = VariantProps<typeof timepickerPeriodVariants>;
/**
 * CVA variants for the time section divider in datepicker panel.
 *
 * @tokens `--color-border-subtle`
 */
declare const timepickerSectionVariants: (props?: {
    size?: TimePickerSize;
}) => string;
type TimepickerSectionVariants = VariantProps<typeof timepickerSectionVariants>;
/**
 * CVA variants for time labels in date range picker.
 *
 * @tokens `--color-muted-foreground`
 */
declare const timepickerLabelVariants: (props?: {
    size?: TimePickerSize;
}) => string;
type TimepickerLabelVariants = VariantProps<typeof timepickerLabelVariants>;

/**
 * Time picker component with segmented numeric input fields.
 * Supports standalone usage with ControlValueAccessor and embedded usage
 * within datepicker/date-range-picker panels.
 *
 * Visual layout: `[HH] : [MM] : [SS] [AM|PM]`
 *
 * @tokens `--color-input-background`, `--color-input-foreground`, `--color-input-border`,
 *         `--color-ring`, `--color-primary-subtle`, `--color-primary-subtle-foreground`,
 *         `--color-muted`, `--color-muted-foreground`, `--color-muted-hover`,
 *         `--color-disabled`, `--color-disabled-foreground`,
 *         `--color-warn`, `--color-success`, `--color-border`
 *
 * @example
 * ```html
 * <!-- Standalone with reactive forms -->
 * <com-time-picker formControlName="startTime" />
 *
 * <!-- 12-hour format with seconds -->
 * <com-time-picker formControlName="alarm" [use12HourFormat]="true" [showSeconds]="true" />
 *
 * <!-- 15-minute steps -->
 * <com-time-picker formControlName="meeting" [minuteStep]="15" />
 *
 * <!-- Embedded inside datepicker panel -->
 * <com-time-picker variant="embedded" [value]="time" (timeChange)="onTime($event)" />
 * ```
 */
declare class ComTimePicker implements ControlValueAccessor, FormFieldControl<ComTimeValue | null>, Validator {
    private readonly localeId;
    readonly ngControl: NgControl | null;
    private readonly defaultErrorStateMatcher;
    private readonly parentForm;
    private readonly parentFormGroup;
    private readonly timepickerId;
    private readonly hoursInputRef;
    private readonly minutesInputRef;
    private readonly secondsInputRef;
    private readonly periodButtonRef;
    /** Current time value. */
    readonly value: ModelSignal<ComTimeValue | null>;
    /** Whether the time picker is disabled. */
    readonly disabled: ModelSignal<boolean>;
    /** Whether the time picker is required. */
    readonly required: InputSignal<boolean>;
    /** Whether to show the seconds segment. */
    readonly showSeconds: InputSignal<boolean>;
    /** 12h vs 24h format. `null` = auto-detect from locale. */
    readonly use12HourFormat: InputSignal<boolean | null>;
    /** Step interval for minutes. */
    readonly minuteStep: InputSignal<number>;
    /** Step interval for seconds. */
    readonly secondStep: InputSignal<number>;
    /** Minimum selectable time. */
    readonly minTime: InputSignal<ComTimeValue | null>;
    /** Maximum selectable time. */
    readonly maxTime: InputSignal<ComTimeValue | null>;
    /** Visual variant. */
    readonly variant: InputSignal<TimePickerVariant>;
    /** Size variant. */
    readonly size: InputSignal<TimePickerSize>;
    /** Validation state. */
    readonly state: InputSignal<TimePickerState>;
    /** Accessible label for the group. */
    readonly ariaLabel: InputSignal<string | null>;
    /** Additional CSS classes. */
    readonly userClass: InputSignal<string>;
    /** Placeholder text for empty segments. */
    readonly placeholder: InputSignal<string>;
    /** Custom error state matcher for determining when to show errors. */
    readonly errorStateMatcher: InputSignal<ErrorStateMatcher | undefined>;
    readonly touched: ModelSignal<boolean>;
    readonly invalid: InputSignal<boolean>;
    readonly sfErrors: InputSignal<readonly unknown[]>;
    /** Emitted when time value changes. */
    readonly timeChange: OutputEmitterRef<ComTimeValue | null>;
    /** Internal value state. */
    readonly internalValue: WritableSignal<ComTimeValue | null>;
    /** Which segment is currently focused. */
    readonly activeSegment: WritableSignal<TimeSegment | 'period' | null>;
    /** Pending typed digits for auto-advance. */
    readonly pendingDigits: WritableSignal<string>;
    /** Live announcements for screen readers. */
    readonly liveAnnouncement: WritableSignal<string>;
    /** IDs for aria-describedby (set by form-field). */
    private readonly _describedByIds;
    /** Form field appearance (set by form-field). */
    private readonly _appearance;
    /** Whether the time picker is focused. Implements FormFieldControl. */
    readonly focused: Signal<boolean>;
    /** Whether the label should float. */
    readonly shouldLabelFloat: Signal<boolean>;
    /** Whether the control is in an error state. Implements FormFieldControl. */
    readonly errorState: Signal<boolean>;
    /** Structured validation errors from Signal Forms. */
    readonly errors: Signal<readonly unknown[] | null>;
    /** Unique ID for the control (maps to hours input). Implements FormFieldControl. */
    readonly id: Signal<string>;
    /**
     * Effective state combining manual state with automatic error detection.
     */
    readonly effectiveState: Signal<TimePickerState>;
    /** Combined aria-describedby from form-field. */
    readonly effectiveAriaDescribedBy: Signal<string | null>;
    /** Whether to use 12-hour format. */
    readonly is12Hour: Signal<boolean>;
    /** Current period (AM/PM). */
    readonly period: Signal<TimePeriod>;
    /** Display hours (converted from 24h to 12h when needed). */
    readonly displayHours: Signal<number | null>;
    /** Formatted hours string. */
    readonly formattedHours: Signal<string>;
    /** Formatted minutes string. */
    readonly formattedMinutes: Signal<string>;
    /** Formatted seconds string. */
    readonly formattedSeconds: Signal<string>;
    /** Container classes. */
    readonly containerClasses: Signal<string>;
    /** Segment input classes. */
    readonly segmentClasses: Signal<string>;
    /** Separator classes. */
    readonly separatorClasses: Signal<string>;
    /** Period button classes. */
    readonly periodClasses: Signal<string>;
    private onChange;
    private onTouched;
    private onValidatorChange;
    constructor();
    writeValue(value: ComTimeValue | null): void;
    registerOnChange(fn: (value: ComTimeValue | null) => void): void;
    registerOnTouched(fn: () => void): void;
    setDisabledState(isDisabled: boolean): void;
    validate(): ValidationErrors | null;
    registerOnValidatorChange(fn: () => void): void;
    protected onSegmentFocus(segment: TimeSegment): void;
    protected onSegmentBlur(segment: TimeSegment): void;
    protected onSegmentInput(event: Event, segment: TimeSegment): void;
    protected onSegmentKeydown(event: KeyboardEvent, segment: TimeSegment): void;
    protected onPeriodKeydown(event: KeyboardEvent): void;
    protected togglePeriod(): void;
    /**
     * Called when the form field container is clicked.
     * Implements FormFieldControl.
     */
    onContainerClick(_event: MouseEvent): void;
    /**
     * Sets the describedBy IDs from the form field.
     * Called by the parent form field component.
     */
    setDescribedByIds(ids: string): void;
    /**
     * Sets the appearance for styling.
     * Called by the parent form field component.
     */
    setAppearance(appearance: FormFieldAppearance): void;
    private setPeriod;
    private incrementSegment;
    private handleDigitInput;
    private snapToStep;
    private setSegmentToMin;
    private setSegmentToMax;
    private focusNextSegment;
    private focusPrevSegment;
    private updateValue;
    static ɵfac: i0.ɵɵFactoryDeclaration<ComTimePicker, never>;
    static ɵcmp: i0.ɵɵComponentDeclaration<ComTimePicker, "com-time-picker", ["comTimePicker"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "showSeconds": { "alias": "showSeconds"; "required": false; "isSignal": true; }; "use12HourFormat": { "alias": "use12HourFormat"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "secondStep": { "alias": "secondStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "userClass": { "alias": "class"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "sfErrors": { "alias": "errors"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "disabled": "disabledChange"; "touched": "touchedChange"; "timeChange": "timeChange"; }, never, never, true, never>;
}

export { ComTimePicker, compareTime, createTimeValue, generateTimePickerId, timepickerContainerVariants, timepickerDisabledVariants, timepickerLabelVariants, timepickerPeriodVariants, timepickerSectionVariants, timepickerSegmentVariants, timepickerSeparatorVariants };
export type { ComTimeValue, TimePeriod, TimePickerSize, TimePickerState, TimePickerVariant, TimeSegment, TimepickerContainerVariants, TimepickerDisabledVariants, TimepickerLabelVariants, TimepickerPeriodVariants, TimepickerSectionVariants, TimepickerSegmentVariants, TimepickerSeparatorVariants };