@grazziotin/react-components 1.0.3 → 1.0.4

package/dist/components/barcode/barcode-scanner.js

@@ -0,0 +1,433 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { TIMEOUTS, VALIDACAO, getQuaggaConfig, verificarSuporteCamera, solicitarPermissaoCamera, } from './utils/constants';
+import Button from 'src/components/button';
+import CustomLoaders from 'src/components/loader';
+import { useEffect, useState, useRef, useCallback } from 'react';
+/**
+ * Componente scanner de código de barras que utiliza a biblioteca Quagga.js
+ * para capturar códigos de barras através da câmera do dispositivo.
+ *
+ * @component
+ * @param props - Propriedades do componente
+ * @param props.setCode - Função callback para definir o código lido
+ * @param props.open - Estado que controla se o scanner está aberto/ativo
+ * @param props.setOpen - Função para controlar o estado de abertura do scanner
+ *
+ * @example
+ * ```tsx
+ * const [code, setCode] = useState('')
+ * const [scannerOpen, setScannerOpen] = useState(false)
+ *
+ * return (
+ *   <BarcodeScanner
+ *     setCode={setCode}
+ *     open={scannerOpen}
+ *     setOpen={setScannerOpen}
+ *   />
+ * )
+ * ```
+ */
+export function BarcodeScanner(_a) {
+    var _this = this;
+    var setCode = _a.setCode, open = _a.open, setOpen = _a.setOpen;
+    var _b = useState(true), loading = _b[0], setLoading = _b[1];
+    var _c = useState(null), error = _c[0], setError = _c[1];
+    var _d = useState(''), lastCode = _d[0], setLastCode = _d[1];
+    var scannerRef = useRef(null);
+    var isInitialized = useRef(false);
+    var isInitializing = useRef(false);
+    var detectionTimeout = useRef();
+    var consecutiveReads = useRef(new Map());
+    var initTimeout = useRef();
+    var quaggaRef = useRef(null);
+    var getQuagga = useCallback(function () { return __awaiter(_this, void 0, void 0, function () {
+        var module_1, quagga, err_1;
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    if (quaggaRef.current)
+                        return [2 /*return*/, quaggaRef.current];
+                    _b.label = 1;
+                case 1:
+                    _b.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, import('quagga')];
+                case 2:
+                    module_1 = _b.sent();
+                    quagga = ((_a = module_1.default) !== null && _a !== void 0 ? _a : module_1);
+                    quaggaRef.current = quagga;
+                    return [2 /*return*/, quagga];
+                case 3:
+                    err_1 = _b.sent();
+                    console.error('Erro ao carregar biblioteca Quagga:', err_1);
+                    setError('Biblioteca de scanner não disponível neste ambiente');
+                    setLoading(false);
+                    return [2 /*return*/, null];
+                case 4: return [2 /*return*/];
+            }
+        });
+    }); }, []);
+    /**
+     * Verifica se o dispositivo suporta câmera
+     *
+     * @async
+     * @function checkCameraSupport
+     * @returns {Promise<void>} Promise que resolve quando a verificação é concluída
+     */
+    var checkCameraSupport = useCallback(function () { return __awaiter(_this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, verificarSuporteCamera()];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, []);
+    /**
+     * Solicita permissão para uso da câmera
+     *
+     * @async
+     * @function requestCameraPermission
+     * @returns {Promise<void>} Promise que resolve quando a permissão é concedida ou rejeitada
+     */
+    var requestCameraPermission = useCallback(function () { return __awaiter(_this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, solicitarPermissaoCamera()];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, []);
+    /**
+     * Valida se o código de barras lido é válido
+     *
+     * @function validateBarcode
+     * @param {string} code - Código de barras para validar
+     * @returns {boolean} true se o código é válido, false caso contrário
+     *
+     * @description
+     * Verifica se o código:
+     * - Não está vazio
+     * - Tem tamanho mínimo adequado
+     * - Não possui caracteres repetidos em excesso
+     */
+    var validateBarcode = function (code) {
+        var cleanCode = code.trim();
+        if (!cleanCode || cleanCode.length < VALIDACAO.TAMANHO_MINIMO_CODIGO)
+            return false;
+        if (VALIDACAO.REGEX_CARACTERES_REPETIDOS.test(cleanCode))
+            return false;
+        return true;
+    };
+    /**
+     * Limpa e para o scanner Quagga, liberando recursos
+     *
+     * @function cleanupQuagga
+     * @returns {void}
+     *
+     * @description
+     * - Remove listeners de detecção
+     * - Para o scanner
+     * - Reseta estados de inicialização
+     * - Limpa contadores de leituras consecutivas
+     */
+    var cleanupQuagga = useCallback(function () {
+        try {
+            var quagga = quaggaRef.current;
+            if (isInitialized.current && quagga) {
+                quagga.offDetected();
+                quagga.stop();
+            }
+        }
+        catch (err) {
+            console.error('Erro ao limpar scanner:', err);
+        }
+        isInitialized.current = false;
+        isInitializing.current = false;
+        consecutiveReads.current.clear();
+    }, []);
+    /**
+     * Confirma a leitura de um código após múltiplas detecções consecutivas
+     *
+     * @function confirmReading
+     * @param {string} code - Código detectado para confirmar
+     * @returns {void}
+     *
+     * @description
+     * Implementa um sistema de confirmação que requer múltiplas leituras
+     * consecutivas do mesmo código antes de considerá-lo válido.
+     * Isso reduz falsos positivos e melhora a precisão.
+     */
+    var confirmReading = useCallback(function (code) {
+        var count = consecutiveReads.current.get(code) || 0;
+        consecutiveReads.current.set(code, count + 1);
+        var newCount = consecutiveReads.current.get(code);
+        setLastCode(code);
+        for (var _i = 0, _a = Array.from(consecutiveReads.current.entries()); _i < _a.length; _i++) {
+            var _b = _a[_i], key = _b[0], value = _b[1];
+            if (key !== code && value < TIMEOUTS.CONFIRMACAO_THRESHOLD) {
+                consecutiveReads.current.delete(key);
+            }
+        }
+        if (newCount >= TIMEOUTS.CONFIRMACAO_THRESHOLD) {
+            cleanupQuagga();
+            consecutiveReads.current.clear();
+            setTimeout(function () {
+                setCode(code);
+                setOpen(false);
+            }, TIMEOUTS.FECHAMENTO_MODAL);
+        }
+        else {
+            setTimeout(function () {
+                if (consecutiveReads.current.get(code) === newCount) {
+                    consecutiveReads.current.delete(code);
+                    if (lastCode === code)
+                        setLastCode('');
+                }
+            }, TIMEOUTS.LIMPEZA_CONTADOR);
+        }
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [cleanupQuagga, setCode, setOpen]);
+    /**
+     * Manipula a detecção de códigos de barras pelo Quagga
+     *
+     * @function handleQuaggaDetected
+     * @param {QuaggaResult} result - Resultado da detecção do Quagga
+     * @returns {void}
+     *
+     * @description
+     * Processa os resultados da detecção:
+     * - Extrai o código e formato
+     * - Valida o código detectado
+     * - Inicia o processo de confirmação
+     */
+    var handleQuaggaDetected = useCallback(function (result) {
+        var _a;
+        try {
+            if (!((_a = result === null || result === void 0 ? void 0 : result.codeResult) === null || _a === void 0 ? void 0 : _a.code))
+                return;
+            var code = result.codeResult.code.trim();
+            if (!validateBarcode(code))
+                return;
+            confirmReading(code);
+        }
+        catch (err) {
+            console.error('Erro ao processar detecção:', err);
+        }
+    }, [confirmReading]);
+    /**
+     * Inicializa o scanner Quagga com configurações apropriadas
+     *
+     * @async
+     * @function initializeScanner
+     * @returns {Promise<void>} Promise que resolve quando a inicialização é concluída
+     *
+     * @description
+     * Processo de inicialização:
+     * 1. Verifica suporte à câmera
+     * 2. Solicita permissões
+     * 3. Configura o Quagga com base no dispositivo
+     * 4. Inicia o scanner
+     * 5. Configura listeners de detecção
+     */
+    var initializeScanner = useCallback(function () { return __awaiter(_this, void 0, void 0, function () {
+        var err_2, isMobile, config, quagga;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!scannerRef.current || isInitialized.current || isInitializing.current)
+                        return [2 /*return*/];
+                    isInitializing.current = true;
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 4, , 5]);
+                    return [4 /*yield*/, checkCameraSupport()];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, requestCameraPermission()];
+                case 3:
+                    _a.sent();
+                    return [3 /*break*/, 5];
+                case 4:
+                    err_2 = _a.sent();
+                    isInitializing.current = false;
+                    setError(err_2.message);
+                    setLoading(false);
+                    return [2 /*return*/];
+                case 5:
+                    isMobile = /Android|iPhone|iPad|iPod/i.test(navigator.userAgent);
+                    config = getQuaggaConfig(scannerRef.current, isMobile);
+                    return [4 /*yield*/, getQuagga()];
+                case 6:
+                    quagga = _a.sent();
+                    if (!quagga)
+                        return [2 /*return*/];
+                    quagga.init(config, function (err) {
+                        if (err) {
+                            var message = typeof err === 'object' && err !== null && 'message' in err
+                                ? String(err.message)
+                                : JSON.stringify(err);
+                            console.error('Erro na inicialização do Quagga:', err);
+                            setError("Erro ao inicializar scanner: ".concat(message));
+                            setLoading(false);
+                            return;
+                        }
+                        try {
+                            quagga.start();
+                            isInitialized.current = true;
+                            isInitializing.current = false;
+                            setError(null);
+                            consecutiveReads.current.clear();
+                            quagga.onDetected(handleQuaggaDetected);
+                            setTimeout(function () { return setLoading(false); }, TIMEOUTS.LOADING_DELAY);
+                        }
+                        catch (error_) {
+                            console.error('Erro ao iniciar Quagga:', error_);
+                            setError('Erro ao iniciar scanner');
+                            setLoading(false);
+                        }
+                    });
+                    return [2 /*return*/];
+            }
+        });
+    }); }, [
+        checkCameraSupport,
+        requestCameraPermission,
+        handleQuaggaDetected,
+        getQuagga,
+    ]);
+    /**
+     * Effect principal que gerencia o ciclo de vida do scanner
+     *
+     * @description
+     * - Inicializa o scanner quando `open` se torna true
+     * - Limpa recursos quando `open` se torna false
+     * - Gerencia timeouts de inicialização
+     */
+    useEffect(function () {
+        var currentTimeout = detectionTimeout.current;
+        if (initTimeout.current)
+            clearTimeout(initTimeout.current);
+        if (open && !isInitialized.current && !isInitializing.current) {
+            setLoading(true);
+            setError(null);
+            setLastCode('');
+            consecutiveReads.current.clear();
+            initTimeout.current = setTimeout(function () {
+                initializeScanner();
+            }, TIMEOUTS.INICIALIZACAO);
+            return function () {
+                if (initTimeout.current)
+                    clearTimeout(initTimeout.current);
+            };
+        }
+        else if (!open && isInitialized.current) {
+            isInitialized.current = false;
+            isInitializing.current = false;
+            cleanupQuagga();
+            if (currentTimeout)
+                clearTimeout(currentTimeout);
+            if (initTimeout.current)
+                clearTimeout(initTimeout.current);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [open]);
+    /**
+     * Effect de limpeza executado na desmontagem do componente
+     *
+     * @description
+     * Garante que todos os recursos sejam liberados quando o componente
+     * é desmontado, evitando vazamentos de memória.
+     */
+    useEffect(function () {
+        var currentTimeout = detectionTimeout.current;
+        return function () {
+            cleanupQuagga();
+            if (currentTimeout)
+                clearTimeout(currentTimeout);
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    /**
+     * Renderização condicional quando há erro no scanner
+     *
+     * @description
+     * Exibe uma interface de erro completa com:
+     * - Mensagem de erro principal
+     * - Informações de debug (se disponíveis)
+     * - Alertas sobre contexto de segurança
+     * - Instruções para resolução de problemas
+     * - Botão para tentar novamente
+     *
+     * Trata especificamente:
+     * - Problemas de HTTPS/contexto seguro
+     * - Permissões de câmera
+     * - Acesso externo vs local
+     */
+    if (error) {
+        return (_jsx("div", { className: "overflow-hidden", children: _jsxs("div", { className: "p-2 text-center", children: [_jsx("p", { className: "mb-2 font-semibold", children: "\u26A0\uFE0F Erro no scanner" }), _jsx("p", { className: "text-xs text-gray-600 mb-4", children: error }), error.toLowerCase().includes('permissão') && (_jsxs("div", { className: "bg-light-blue-50 border border-blue-200 rounded p-3 mb-4 text-left", children: [_jsx("p", { className: "text-xs font-semibold mb-2", children: "\uD83D\uDD12 Permiss\u00F5es da c\u00E2mera:" }), _jsxs("ul", { className: "text-xs text-blue-700 list-disc list-inside space-y-1", children: [_jsx("li", { children: "Clique no \u00EDcone de cadeado na barra de endere\u00E7o" }), _jsx("li", { children: "Encontre \"C\u00E2mera\" nas configura\u00E7\u00F5es" }), _jsx("li", { children: "Mude para \"Permitir\"" }), _jsx("li", { children: "Recarregue a p\u00E1gina" })] })] })), _jsx(Button, { size: "small", variant: "text", className: "mt-2", onClick: function () {
+                            setError(null);
+                            setLoading(true);
+                            setTimeout(initializeScanner, TIMEOUTS.TENTAR_NOVAMENTE);
+                        }, children: "Tentar novamente" })] }) }));
+    }
+    /**
+     * Renderização principal do scanner quando não há erro
+     *
+     * @description
+     * Estrutura principal do componente:
+     * 1. Container do scanner (div com ref) - onde o Quagga renderiza o vídeo
+     * 2. Loader customizado - exibido durante inicialização
+     * 3. Dicas de uso - instruções para melhor leitura
+     *
+     * O container do scanner:
+     * - Tem altura dinâmica baseada no estado de loading
+     * - Fica oculto durante carregamento
+     * - Possui bordas estilizadas para indicar área de captura
+     */
+    return (_jsxs("div", { children: [_jsx("div", { ref: scannerRef, id: "barcode-scanner", className: "mb-2 relative overflow-hidden border-2 border-dashed border-blue-300 rounded-lg", style: {
+                    maxHeight: loading ? '0px' : '400px',
+                    minHeight: loading ? '0px' : '300px',
+                    visibility: loading ? 'hidden' : 'visible',
+                } }), _jsx(CustomLoaders, { open: loading }), !loading && (_jsx("div", { className: "text-center text-sm text-gray-600 mt-2", children: _jsxs("div", { className: "mt-3 text-xs text-gray-500", children: [_jsx("p", { className: "mb-1", children: "\uD83D\uDCA1 Dicas para melhor leitura:" }), _jsxs("ul", { className: "text-left space-y-1", children: [_jsx("li", { children: "\u2022 Mantenha o c\u00F3digo de barras bem iluminado" }), _jsx("li", { children: "\u2022 Aproxime ou afaste at\u00E9 focar bem" }), _jsx("li", { children: "\u2022 Mantenha o celular est\u00E1vel" }), _jsx("li", { children: "\u2022 Certifique-se que o c\u00F3digo n\u00E3o est\u00E1 danificado" })] })] }) }))] }));
+}

package/dist/components/barcode/index.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import { BarcodeDialogProps } from './utils/interface';
+/**
+ * Componente modal para leitura de código de barras usando câmera
+ *
+ * @description
+ * Este componente exibe um dialog modal que permite a leitura de códigos de barras
+ * através da câmera do dispositivo. A funcionalidade só está disponível em
+ * contextos seguros (HTTPS) ou em desenvolvimento local.
+ *
+ * @example
+ * ```tsx
+ * const [isOpen, setIsOpen] = useState(false)
+ * const [barcode, setBarcode] = useState('')
+ *
+ * return (
+ *   <BarcodeDialog
+ *     open={isOpen}
+ *     setOpen={setIsOpen}
+ *     setCode={setBarcode}
+ *   />
+ * )
+ * ```
+ *
+ * @param {BarcodeDialogProps} props - As propriedades do componente
+ * @param {boolean} props.open - Estado que controla se o dialog está visível
+ * @param {function} props.setOpen - Função para alterar a visibilidade do dialog
+ * @param {function} props.setCode - Callback executado quando um código é lido
+ *
+ * @returns {React.ReactElement} Elemento React do dialog de leitura de barcode
+ *
+ * @version 1.2.0
+ * @author Flaviasoz
+ * @since 1.0.0
+ */
+export declare function BarcodeDialog({ open, setOpen, setCode, }: Readonly<BarcodeDialogProps>): React.ReactElement;

package/dist/components/barcode/index.js

@@ -0,0 +1,65 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import Dialog from 'src/components/dialog';
+import { BarcodeScanner } from './barcode-scanner';
+import { useCallback, useMemo } from 'react';
+import { contextoSeguro, MENSAGENS, style } from './utils/constants';
+/**
+ * Componente modal para leitura de código de barras usando câmera
+ *
+ * @description
+ * Este componente exibe um dialog modal que permite a leitura de códigos de barras
+ * através da câmera do dispositivo. A funcionalidade só está disponível em
+ * contextos seguros (HTTPS) ou em desenvolvimento local.
+ *
+ * @example
+ * ```tsx
+ * const [isOpen, setIsOpen] = useState(false)
+ * const [barcode, setBarcode] = useState('')
+ *
+ * return (
+ *   <BarcodeDialog
+ *     open={isOpen}
+ *     setOpen={setIsOpen}
+ *     setCode={setBarcode}
+ *   />
+ * )
+ * ```
+ *
+ * @param {BarcodeDialogProps} props - As propriedades do componente
+ * @param {boolean} props.open - Estado que controla se o dialog está visível
+ * @param {function} props.setOpen - Função para alterar a visibilidade do dialog
+ * @param {function} props.setCode - Callback executado quando um código é lido
+ *
+ * @returns {React.ReactElement} Elemento React do dialog de leitura de barcode
+ *
+ * @version 1.2.0
+ * @author Flaviasoz
+ * @since 1.0.0
+ */
+export function BarcodeDialog(_a) {
+    var open = _a.open, setOpen = _a.setOpen, setCode = _a.setCode;
+    /**
+     * Manipula o fechamento do dialog
+     * @function handleClose
+     * @description Fecha o dialog definindo o estado 'open' como false
+     */
+    var handleClose = useCallback(function () {
+        setOpen(false);
+    }, [setOpen]);
+    /**
+     * Verifica se o contexto é seguro para usar a câmera
+     * @description Memoriza o resultado da verificação de segurança para evitar re-cálculos
+     */
+    var isContextSecure = useMemo(function () { return contextoSeguro(); }, []);
+    /**
+     * Componente de conteúdo do dialog baseado no contexto de segurança
+     * @description Renderiza o scanner ou mensagem de erro baseado na segurança do contexto
+     */
+    var dialogContent = useMemo(function () {
+        if (!isContextSecure) {
+            return (_jsx("div", { role: "alert", "aria-live": "polite", className: "text-xs", style: style, children: MENSAGENS.HTTPS_REQUERIDO }));
+        }
+        return _jsx(BarcodeScanner, { setCode: setCode, open: open, setOpen: setOpen });
+    }, [isContextSecure, setCode, open, setOpen]);
+    return (_jsx(Dialog, { open: open, maxWidth: "xs", onClose: handleClose, "aria-labelledby": "barcode-dialog-title", "aria-describedby": "barcode-dialog-description", children: _jsx("div", { id: "barcode-dialog-description", children: dialogContent }) }));
+}

package/dist/components/barcode/utils/constants.d.ts

@@ -0,0 +1,139 @@
+import { CSSProperties } from 'react';
+/**
+ * Mensagens de erro e informação para o componente
+ */
+export declare const MENSAGENS: {
+    HTTPS_REQUERIDO: string;
+    TITULO: string;
+};
+/**
+ * Mapa de mensagens de erro para diferentes tipos de erro de câmera
+ */
+export declare const MENSAGENS_ERRO_CAMERA: Map<string, string>;
+/**
+ * Configurações de timeout e delays
+ */
+export declare const TIMEOUTS: {
+    CONFIRMACAO_THRESHOLD: number;
+    LIMPEZA_CONTADOR: number;
+    INICIALIZACAO: number;
+    LOADING_DELAY: number;
+    FECHAMENTO_MODAL: number;
+    TENTAR_NOVAMENTE: number;
+};
+/**
+ * Configurações de validação
+ */
+export declare const VALIDACAO: {
+    TAMANHO_MINIMO_CODIGO: number;
+    REGEX_CARACTERES_REPETIDOS: RegExp;
+};
+/**
+ * Configurações da câmera
+ */
+export declare const CONFIG_CAMERA: {
+    CONSTRAINTS: {
+        WIDTH: {
+            min: number;
+            ideal: number;
+            max: number;
+        };
+        HEIGHT: {
+            min: number;
+            ideal: number;
+            max: number;
+        };
+        ASPECT_RATIO: {
+            ideal: number;
+        };
+    };
+    AREA_SCANNER: {
+        top: string;
+        right: string;
+        left: string;
+        bottom: string;
+    };
+    WORKERS: {
+        MOBILE: number;
+        DESKTOP: number;
+    };
+};
+/**
+ * Readers suportados pelo Quagga
+ */
+export declare const READERS_SUPORTADOS: string[];
+/**
+ * Configuração padrão do Quagga
+ */
+export declare const getQuaggaConfig: (target: HTMLElement, isMobile: boolean) => {
+    inputStream: {
+        name: string;
+        type: string;
+        constraints: {
+            width: {
+                min: number;
+                ideal: number;
+                max: number;
+            };
+            height: {
+                min: number;
+                ideal: number;
+                max: number;
+            };
+            facingMode: string;
+            aspectRatio: {
+                ideal: number;
+            };
+        };
+        target: HTMLElement;
+        area: {
+            top: string;
+            right: string;
+            left: string;
+            bottom: string;
+        };
+    };
+    locator: {
+        halfSample: boolean;
+        patchSize: string;
+        debug: {
+            showCanvas: boolean;
+            showPatches: boolean;
+            showFoundPatches: boolean;
+            showSkeleton: boolean;
+            showLabels: boolean;
+            showPatchLabels: boolean;
+            showRemainingPatchLabels: boolean;
+            boxFromPatches: {
+                showTransformed: boolean;
+                showTransformedBox: boolean;
+                showBB: boolean;
+            };
+        };
+    };
+    numOfWorkers: number;
+    decoder: {
+        readers: string[];
+        multiple: boolean;
+    };
+    locate: boolean;
+    debug: boolean;
+    frequency: number;
+};
+/**
+ * Verifica se o protocolo atual é HTTPS ou se está em desenvolvimento local
+ * @returns {boolean} True se for HTTPS ou localhost, false caso contrário
+ */
+export declare const contextoSeguro: () => boolean;
+/**
+ * Verifica se o navegador suporta acesso à câmera
+ * @throws {Error} Quando o navegador não suporta câmera ou não está em contexto seguro
+ */
+export declare const verificarSuporteCamera: () => Promise<void>;
+/**
+ * Solicita permissão para acessar a câmera
+ * @returns {Promise<boolean>} True se a permissão foi concedida
+ * @throws {Error} Quando a permissão é negada ou há erro no acesso
+ */
+export declare const solicitarPermissaoCamera: () => Promise<boolean>;
+export declare const style: CSSProperties;