Biblioteca

A Biblioteca é a tela central do InkShelf: a representação navegável da(s) pasta(s) que o usuário escolheu como fonte do seu acervo. Este documento cobre a estrutura e o comportamento gerais da tela; os subtemas Scanner, Sistema de Capas, Filtros, Ordenação, Busca, Favoritos, Continuar Lendo, Histórico, Estatísticas e Notificações têm documentos próprios nesta mesma pasta.

Estrutura: a pasta (ou o servidor) é a biblioteca

Não existe uma hierarquia própria do app. A árvore de pastas e arquivos exibida na Biblioteca é um espelho direto da estrutura real de arquivos no armazenamento, obtida via SAF (Storage Access Framework) — ou, se houver, da estrutura de um servidor Komga/Kavita conectado. Navegar uma pasta na Biblioteca é navegar a pasta correspondente no armazenamento do aparelho ou no servidor.

Pastas raiz

O usuário pode adicionar mais de uma pasta raiz local — não é limitado a uma única origem — e, opcionalmente, conectar um ou mais servidores Komga/Kavita, cada um contribuindo suas próprias bibliotecas selecionadas como raízes adicionais na mesma árvore (ver Fontes Remotas). Toda raiz — local ou remota — entra para a varredura da biblioteca (ver Scanner) e pode ser removida individualmente. Um rescan manual ("Atualizar biblioteca") pode ser disparado a qualquer momento, além da varredura automática que ocorre normalmente.

Navegação

• Breadcrumbs: a trilha de pastas percorridas fica visível e é clicável, permitindo voltar a qualquer nível intermediário sem repetir toques de "voltar".
• Cabeçalho: mostra a contagem de itens da pasta atual, acesso à busca e um menu de opções da tela.
• Persistência de posição: a posição de rolagem é lembrada por combinação de pasta + filtro + modo de visualização — voltar para uma pasta já visitada restaura o scroll de onde o usuário parou.

Modos de visualização

Dois modos estão disponíveis para qualquer usuário: Grade e Lista. Quando a Grade é usada, o número de itens por linha é ajustável.

Filtros e ordenação

A Biblioteca pode ser filtrada (Todos, Não lidos, Lidos, Ocultados) e ordenada (nome crescente/decrescente, mais itens, mais recente). Ver Filtros e Ordenação para detalhes de cada modo.

Menu de contexto (toque longo)

Tocar e segurar um item de pasta ou arquivo abre um menu contextual com ações rápidas:

• Marcar como lido / não lido
• Adicionar / remover dos favoritos
• Ocultar / mostrar
• Atualizar capa
• Definir como capa da pasta (apenas para arquivos — permite escolher manualmente qual arquivo representa visualmente uma pasta)

Pra itens Komga/Kavita, marcar como lido/não lido e favoritar/desfavoritar um item por vez sincroniza com o servidor. Uma ação em massa (seleção múltipla, ou "marcar pasta inteira" numa pasta com muitos itens) fica só local — de propósito, não sincroniza com o servidor (ver Fontes Remotas).

O que fica de fora deste documento

• Como a varredura e a sincronização preservam estado do usuário entre rescans → Scanner
• Como capas são geradas, cacheadas e definidas manualmente → Sistema de Capas
• Semântica de cada filtro → Filtros
• Semântica de cada modo de ordenação → Ordenação
• Servidores Komga/Kavita, opções por biblioteca, sincronização bidirecional → Fontes Remotas