GrCodeScanner

type GrCameraStatus = 'idle'

interface GrCodeResult {
    /** Содержимое: адрес, номер товара, текст. */
    value: string;
    /** Символика: `qr_code`, `ean_13`, `code_128`, … */
    format: string;
}

type GrCodeDetector = (source: CanvasImageSource) => Promise<GrCodeResult[]>;
/** Есть ли нативный `BarcodeDetector`. */
export declare function nativeDetectorSupported(scope?: typeof globalThis): boolean;
/**
 * Нативный детектор в общей форме.
 *
 * Формат приводится к нашему типу здесь, а не в компоненте: спецификация зовёт
 * содержимое `rawValue`, и это единственное место, где чужое имя видно.
 */
export declare function createNativeDetector(formats: readonly string[] | undefined, scope?: typeof globalThis): GrCodeDetector | null;
/**
 * Что сообщать наружу из очередного кадра.
 *
 * Камера отдаёт десятки кадров в секунду, и один и тот же код распознаётся в
 * каждом. Без фильтра приложение получило бы поток одинаковых событий и
 * оформило бы двадцать заказов вместо одного. Поэтому по умолчанию сообщается
 * только то, чего не было в предыдущем кадре.
 *
 * `continuous` нужен там, где сканируют подряд (приёмка на складе): там повтор
 * того же кода — законное второе событие.
 */
export declare function freshCodes(previous: readonly GrCodeResult[], next: readonly GrCodeResult[], continuous: boolean): GrCodeResult[];

function nativeDetectorSupported(scope?: typeof globalThis): boolean;

function createNativeDetector(formats: readonly string[] | undefined, scope?: typeof globalThis): GrCodeDetector | null;

function freshCodes(previous: readonly GrCodeResult[], next: readonly GrCodeResult[], continuous: boolean): GrCodeResult[];

const grCodeScannerConfig: import("@feugene/granum/contract").GranumComponentDescriptor<"GrCodeScanner">;

interface GrCodeScannerConfigurableProps {
    size?: GrCodeScannerSize;
}

interface GrCodeScannerProps {
    /** Какая камера: `environment` — тыловая, ей и сканируют. */
    facing?: 'user' | 'environment';
    /** Конкретное устройство, если приложение его уже выбрало. */
    deviceId?: string;
    /**
     * Включать камеру сразу.
     *
     * По умолчанию `false`: запрос разрешения без действия пользователя
     * отклоняют не глядя, а второй раз браузер уже не спросит.
     */
    autoStart?: boolean;
    /** Символики: `qr_code`, `ean_13`, `code_128`, … Без списка — все, что умеет браузер. */
    formats?: readonly string[];
    /**
     * Детектор для браузеров без `BarcodeDetector` — Safari и Firefox.
     *
     * Пакет своего декодера не несёт: у него нет ни одной зависимости, и ради
     * одного компонента появилась бы самая тяжёлая. Рецепт подключения готовой
     * библиотеки — на странице компонента.
     */
    detector?: GrCodeDetector;
    /** Как часто разбирать кадр, мс. Чаще — горячее устройство, реже — вялый отклик. */
    interval?: number;
    /** Сообщать один и тот же код повторно: приёмка сканирует подряд. */
    continuous?: boolean;
    /**
     * Ступень размера: элементы управления и кегль подписей. По умолчанию `md`;
     * берётся из `GrConfigProvider`.
     */
    size?: GrCodeScannerSize;
    /** Сканер недоступен: камера не включается, кнопки выключены. */
    disabled?: boolean;
    /** Имя группы с превью и кнопками. Не задано — из локали («Code scanner»). */
    ariaLabel?: string;
}

interface GrCodeScannerEmits {
    /** Распознаны коды. Без `continuous` — только те, которых не было в прошлом кадре. */
    (e: 'detect', codes: GrCodeResult[]): void;
    /** Поток камеры пошёл — сканирование началось. */
    (e: 'start'): void;
    /** Камера выключена. */
    (e: 'stop'): void;
    /** Состояние камеры сменилось — значения `GrCameraStatus`. */
    (e: 'statusChange', status: GrCameraStatus): void;
}

type GrCodeScannerSize = 'xs' | 'sm' | 'md' | 'lg';

const grCodeScannerSafelist: string[];