EEditor

1. Primeiros Passos

Ao iniciar o EEditor pela primeira vez, você verá um editor vazio com uma barra lateral. Para começar a trabalhar:

1. Abra uma pasta — pressione ⌘O ou toque no ícone de pasta na barra lateral para escolher um diretório. O EEditor irá escaneá-lo e exibir todos os arquivos na árvore da barra lateral.
2. Selecione um arquivo — clique em qualquer arquivo na barra lateral para abri-lo no editor. O arquivo abre em uma nova aba.
3. Comece a escrever — as edições são salvas automaticamente após 1 segundo de inatividade. Você também pode pressionar ⌘S para salvar imediatamente.

2. O Editor

O EEditor oferece um ambiente de escrita livre de distrações com destaque de sintaxe em tempo real.

• Destaque de sintaxe — cabeçalhos, negrito, itálico, blocos de código, links e mais são coloridos em tempo real para Markdown. Para arquivos de código, palavras-chave, tipos, strings, números e comentários são destacados em mais de 24 linguagens.
• Buscar e Substituir — pressione ⌘F para abrir a barra de busca. Digite para pesquisar, use o campo de substituição para trocar correspondências.
• Inserir timestamp — pressione ⌘I para inserir a data e hora atuais (YYYY-MM-DD HH:mm) na posição do cursor.
• Desfazer / Refazer — ⌘Z para desfazer, ⌘⇧Z para refazer.
• Indicador de linguagem — a linguagem detectada é mostrada no canto inferior direito do editor.

3. Barra Lateral e Árvore de Arquivos

A barra lateral mostra uma visualização hierárquica da sua pasta. Diretórios são classificados primeiro, depois arquivos em ordem alfabética.

• Expandir/recolher pastas clicando no triângulo de divulgação.
• Criar um novo arquivo — pressione ⌘N ou use o botão +. Você pode digitar um caminho como subpasta/arquivo.md para criar arquivos aninhados.
• Criar uma nova pasta — use o botão + de pasta na barra de ferramentas da barra lateral.
• Excluir — clique com o botão direito (ou toque longo no iOS) e selecione Excluir. No macOS, os arquivos são movidos para a Lixeira.
• Renomear — use o menu de contexto para renomear arquivos ou pastas.
• Atualizar — pressione ⌘⇧R para reescanear o diretório.
• Indicador de alterações — um pequeno ponto aparece ao lado de arquivos com alterações não salvas.

A barra lateral tem três modos acessíveis pelo controle segmentado no topo: Arquivos (árvore de arquivos), Calendário (veja a seção 8) e Agenda (veja a seção 8b).

4. Abas e Arquivos Fixados

Cada arquivo que você abre aparece como uma aba no topo da área do editor.

• Alternar abas — clique em uma aba, ou use ⌘⌥→ (próxima) e ⌘⌥← (anterior). A navegação é circular.
• Fechar uma aba — clique no botão × na aba ou pressione ⌘W. Alterações não salvas são salvas automaticamente antes de fechar.
• Fechar todas não fixadas — pressione ⌘⌥W para fechar todas as abas exceto as fixadas.
• Fixar uma aba — pressione ⌘⇧K ou clique com o botão direito na aba e selecione Fixar. Abas fixadas mostram um ícone de alfinete e não podem ser fechadas (desafixe primeiro). Abas fixadas são restauradas quando você reinicia o aplicativo.

5. Busca e Abertura Rápida

Busca em texto completo (⌘⇧F) pesquisa em todos os arquivos do seu workspace:

• Os resultados mostram nome do arquivo, número da linha, contagem de correspondências e contexto (as linhas ao redor de cada correspondência).
• Alterne o modo sensível a maiúsculas com o botão Aa.
• Clique em qualquer resultado para abrir o arquivo naquela localização.

Abertura Rápida (⌘P) é um localizador de arquivos com busca difusa:

• Comece a digitar um nome de arquivo — os resultados atualizam instantaneamente.
• Use as setas do teclado para navegar, Enter para abrir, Escape para cancelar.
• Correspondências por prefixo têm prioridade mais alta. Nomes mais curtos aparecem primeiro em caso de empate.
• Pré-preenchimento por seleção: se você tiver texto selecionado no editor, pressionar ⌘P pré-preenche a busca com sua seleção.

Wiki-links (⌘O): posicione o cursor em um link [[nomedoarquivo]] e pressione ⌘O para abrir o arquivo diretamente. Se nenhum wiki-link for detectado, o diálogo padrão de Abrir Pasta aparece.

6. Pré-visualização e Exportação PDF

Pré-visualização Markdown (⌘⇧P) renderiza seu documento como HTML estilizado:

• Suporta cabeçalhos, listas, blocos de código, links, imagens, citações e tabelas.
• Adapta-se ao modo escuro ou claro do seu sistema.
• No macOS, a pré-visualização abre em um frame. No iOS, aparece como uma folha.

Exportação PDF (⌘⇧E) gera um documento pronto para impressão:

• Tamanho de página A4 (595 × 842 pontos) com tipografia limpa.
• No macOS, um diálogo de salvamento aparece com um nome de arquivo sugerido.
• No iOS/iPadOS, o PDF é apresentado via folha de compartilhamento do sistema.

7. Notas Diárias e Planejador Semanal

Nota diária (⌘D):

• Cria um arquivo chamado YYYY-MM-DD.md (ex.: 2026-02-19.md) na sua pasta raiz.
• Pré-preenchido com um cabeçalho: # 2026-02-19.
• Se o arquivo já existir, simplesmente o abre.

Planejador semanal (⌘⇧W):

• Cria um arquivo chamado YYYY-WEEK-WW.md (ex.: 2026-WEEK-08.md) usando numeração de semana ISO 8601.
• Pré-preenchido com um modelo estruturado:

  # Week 08 — 2026
  
  ## Monday
  ### Morning
  -
  ### Afternoon
  -
  ### Evening
  -
  
  ## Tuesday
  ...through Sunday

• Se o arquivo já existir, simplesmente o abre.

8. Visualização de Calendário

Alterne a barra lateral para o modo Calendário usando o controle segmentado (ícones de pasta / calendário / agenda) no topo da barra lateral.

• Uma grade mensal mostra o mês atual com segunda-feira como primeiro dia da semana (ISO 8601).
• Indicadores de pontos duplos aparecem em cada dia: um ponto azul para atividade de arquivos e um ponto laranja para itens de agenda agendados naquela data.
• Use os botões < e > para navegar entre meses. O botão Hoje volta ao mês atual.
• Clique em um dia para ver arquivos modificados naquele dia e itens de agenda agendados para aquela data, organizados em seções separadas.
• Clique em um arquivo na lista do dia para abri-lo no editor.

8b. Barra Lateral da Agenda

Alterne a barra lateral para o modo Agenda usando o ícone de prancheta no controle segmentado. O painel da agenda oferece uma visualização rápida da sua programação:

• Atrasados — itens com data :when anterior a hoje, mostrados com cabeçalho de seção vermelho.
• Hoje — itens agendados para hoje.
• Próximos 7 Dias — itens futuros dentro da próxima semana.
• Cada item mostra seu ponto de prioridade (vermelho = urgente, laranja = alta, amarelo = média, cinza = normal), texto, categorias e data formatada.
• Use o botão de atualização para recarregar dados após adicionar itens no REPL.

9. REPL EELisp

O EEditor inclui um interpretador Lisp integrado chamado EELisp — projetado para gerenciamento de dados pessoais.

Abrindo o REPL:

• Pressione ⌘⇧L para alternar a barra lateral do REPL, ou toque no ícone de terminal na barra de ferramentas.
• Se você tiver texto selecionado no editor, ⌘⇧L o envia para o campo de entrada do REPL automaticamente.
• O REPL abre como um painel lateral direito que permanece aberto enquanto você alterna entre arquivos e abas.

Usando o REPL:

• Digite uma expressão no prompt > e pressione ⌘Return para avaliá-la.
• Entrada multilinha — se sua expressão tiver parênteses desbalanceados, o prompt muda para .. e aguarda mais entrada. Uma barra de dica mostra ⌘↩ para executar · ⎋ para cancelar.
• Histórico — pressione Seta para Cima/Baixo para navegar por comandos anteriores. O histórico é persistido entre sessões (até 100 entradas).
• Selecionar texto — clique e arraste em qualquer entrada de saída para selecionar e copiar texto.

Comportamento da barra lateral:

• A barra lateral do REPL permanece aberta enquanto você alterna entre arquivos, abre novas abas e navega — ela não fecha.
• O estado da barra lateral é persistido entre sessões. Se você fechar e reabrir o aplicativo, a barra lateral do REPL reaparece se estava aberta.
• Pressione ⌘⇧L ou clique no botão × no cabeçalho do REPL para fechá-lo.

Comandos de banco de dados:

O EELisp inclui comandos integrados para gerenciamento de banco de dados:

• (tables) — listar todas as tabelas no banco de dados atual
• (describe nomedatabela) — mostrar o esquema de uma tabela
• (drop-table nomedatabela) — excluir uma tabela
• :db — mostrar o caminho do banco de dados atual
• :db <caminho> — alternar para um arquivo de banco de dados diferente
• :db new <nome> — criar um novo arquivo de banco de dados na pasta atual
• :db memory — alternar para um banco de dados em memória

Executando blocos EELisp no editor:

• Incorpore blocos de código cercados ```eelisp em qualquer arquivo Markdown.
• Posicione o cursor dentro do bloco e pressione ⌘⇧Return para executá-lo.
• O resultado é inserido como texto simples na próxima linha após o fechamento, auto-selecionado para fácil cópia.
• Se o resultado for um formulário (edit, defform) ou tabela (browse), ele abre como um painel lateral interativo ao lado do editor.

10. Comandos de Banco de Dados

O REPL inclui um motor de banco de dados SQLite. Por padrão, ele usa um banco de dados em memória. Quando você abre uma pasta contendo um arquivo eelisp.db, o REPL se conecta automaticamente a ele para armazenamento persistente (veja Gerenciamento de Banco de Dados). Nomes de tabelas e definições de campos são escritos como símbolos puros (sem necessidade de aspas).

Definir uma tabela:

(deftable tasks (title:string priority:number done:bool due:date))

Tipos de campo: string, number, bool, date, memo.

Inserir registros:

(insert tasks {:title "Write docs" :priority 1 :done false})

Consultar registros:

;; Todos os registros
(query tasks)

;; Com filtros
(query tasks :where "priority <= ?" :params (list 2))

;; Ordenados, limitados
(query tasks :order "priority" :limit 5)

;; Selecionar colunas específicas
(query tasks :select "title, done")

Os resultados das consultas são exibidos como tabelas ASCII formatadas.

Formulários interativos (browse):

;; Abrir um formulário para navegar, editar e gerenciar registros
(browse tasks)

;; Navegar com filtros e ordenação
(browse tasks :where "done = ?" :params (list false) :order "priority")

O formulário mostra um registro por vez com navegação Anterior/Próximo, edição inline, botões Salvar, Novo e Excluir.

Atualizar e excluir:

;; Atualizar registro por ID
(update tasks 1 {:done true})

;; Exclusão suave (estilo dBASE)
(delete tasks 1)

;; Purgar registros excluídos suavemente
(pack tasks)

Outros comandos:

Comando	Descrição
(tables)	Listar todos os nomes de tabelas
(describe tasks)	Mostrar esquema da tabela
(count-records tasks)	Contar registros (com :where opcional)
(drop-table tasks)	Excluir uma tabela
(field-get record :name)	Obter um campo de um registro
(record-id record)	Obter o ID do registro
(records result-set)	Extrair lista de registros dos resultados da consulta
(browse table)	Abrir visualização de tabela/grade navegável
(edit table)	Abrir formulário CRUD interativo
(defform name (fields) :computed ...)	Criar formulário calculadora com campos calculados

11. Gerenciamento de Banco de Dados

O EELisp suporta bancos de dados SQLite tanto em memória quanto persistentes.

Conexão automática:

• Quando você abre uma pasta, se um arquivo eelisp.db existir na raiz, o REPL se conecta automaticamente a ele.
• Dados que você cria com deftable e insert são persistidos no disco.
• Se nenhum arquivo de banco de dados existir, o REPL usa um banco de dados em memória (os dados são perdidos quando você fecha o aplicativo).

Comandos de banco de dados do REPL:

Comando	Descrição
:db	Mostrar o caminho do banco de dados atual
:db <caminho>	Alternar para um arquivo de banco de dados diferente
:db new <nome>	Criar um novo arquivo de banco de dados na pasta atual
:db memory	Alternar para um banco de dados em memória

12. Agenda: Itens, Categorias, Regras e Visualizações

O EELisp inclui um gerenciador de informações pessoais inspirado no Lotus Agenda. Adicione itens de forma livre, categorize automaticamente com regras, defina visualizações dinâmicas, organize com categorias hierárquicas e consulte com filtros — tudo armazenado em SQLite.

Adicionando itens:

;; Texto primeiro — apenas digite o que está em mente
(add-item "Finish quarterly report for Sarah")

;; Com metadados
(add-item "Call dentist" :when "2026-03-01" :priority 2)
(add-item "Buy groceries" :category "personal" :notes "milk, eggs, bread")

Consultando itens:

;; Navegar todos os itens (tabela interativa)
(items)

;; Filtrar por categoria, texto, prioridade ou data
(items :category "work")
(items :search "quarterly")
(items :priority 1)
(items :when-before "2026-03-01")

Gerenciando itens:

Comando	Descrição
(add-item text :when :priority :category :notes)	Criar um novo item
(items :category :search :priority :when-before :when-after)	Consultar itens com filtros (visualização em tabela)
(item-get id)	Buscar um único item por ID
(item-edit id)	Abrir item em formulário para edição
(item-set id :field val ...)	Atualizar propriedades do item
(item-done id)	Marcar item como concluído (exclusão suave)
(item-count :category cat)	Contar itens com filtro opcional

Categorias:

As categorias são hierárquicas (use separadores /) e podem ser mutuamente exclusivas:

;; Categorias hierárquicas
(defcategory work)
(defcategory work/projects)
(defcategory work/meetings)
(defcategory personal)
(defcategory personal/errands)

;; Categorias exclusivas (item pode estar em apenas um filho)
(defcategory priority :exclusive true
  :children (high medium low))

;; Atribuir / desatribuir
(assign 1 "work/projects")
(assign 1 "priority/high")
(unassign 1 "personal")

;; Ver a árvore de categorias
(categories)

Regras de Auto-Categorização:

Defina regras que categorizam automaticamente os itens com base no conteúdo — a magia do Lotus Agenda:

;; Regras de correspondência de texto
(defrule urgent-flag
  :when (str-contains text "URGENT")
  :assign "priority/high")

(defrule meeting-detect
  :when (or (str-contains text "meeting")
            (str-contains text "call with"))
  :assign "work/meetings")

;; Extração de data via regex
(defrule date-extract
  :when (str-matches text "\\b(\\d{4}-\\d{2}-\\d{2})\\b")
  :action (item-set id :when (match 1)))

;; Aplicar regras
(apply-rules)            ;; aplicar em lote a todos os itens
(apply-rules 42)         ;; aplicar ao item #42
(auto-categorize true)   ;; auto-aplicar em cada add-item

Gerenciamento de regras:

Comando	Descrição
(defrule name :when cond :assign cat)	Definir uma regra de categorização
(defrule name :when cond :action expr)	Definir uma regra com ação personalizada
(apply-rules)	Aplicar todas as regras a todos os itens
(apply-rules id)	Aplicar todas as regras a um item específico
(auto-categorize true/false)	Alternar auto-aplicação na inserção
(rules)	Listar todas as regras definidas
(drop-rule name)	Excluir uma regra

Visualizações — Perspectivas Dinâmicas:

Defina consultas salvas que filtram, ordenam e agrupam itens. Mostre uma visualização a qualquer momento para ver os itens correspondentes mais recentes:

;; Definir visualizações com expressões de filtro
(defview work-board
  :source items
  :filter (has-category "work")
  :group-by category
  :sort-by when)

(defview urgent
  :source items
  :filter (= priority "1")
  :sort-by when)

(defview inbox
  :source items
  :filter (= (length categories) 0))

;; Mostrar uma visualização
(show work-board)
;; → agrupado por categoria com contagem de itens

(show urgent)
;; → itens filtrados e ordenados

Gerenciamento de visualizações:

Comando	Descrição
(defview name :source :filter :group-by :sort-by)	Definir uma visualização salva com expressão de filtro
(show view-name)	Exibir itens correspondentes de uma visualização
(views)	Listar todas as visualizações definidas
(drop-view name)	Excluir uma visualização

Auxiliares de data:

Comando	Descrição
(today)	Retorna a data de hoje como string ISO (ex.: "2026-02-21")
(date-add date n :days/:weeks/:months)	Adicionar dias, semanas ou meses a uma data
(date-diff date1 date2)	Diferença em dias entre duas datas

Integração com Calendário:

Visualize itens por data e adicione itens rapidamente para hoje:

;; Ver itens para uma data específica
(items-on "2026-02-24")

;; Ver itens em um intervalo de datas
(items-between "2026-02-24" "2026-02-28")

;; Adicionar rapidamente com data de hoje preenchida
(add-item-today "Review pull requests" :priority 1)
(add-item-today "Quick grocery run" :notes "milk, bread")

;; Combinar com auxiliares de data
(items-on (today))
(items-between (today) (date-add (today) 7 :days))

Comando	Descrição
(items-on "date")	Mostrar itens agendados para uma data específica
(items-between "start" "end")	Mostrar itens em um intervalo de datas (inclusivo)
(add-item-today text :priority :category :notes)	Adicionar item com data de hoje preenchida automaticamente

Entrada Inteligente:

O comando add analisa linguagem natural para extrair datas, prioridades e pessoas automaticamente:

;; Criação de itens em linguagem natural
(add "Meet Alice tomorrow for coffee !!")
;; → Item com :when = amanhã, :priority 2, :who "Alice"

(add "Call Bob next Monday about the project")
;; → Item com :when = próxima segunda, :who "Bob"

(add "URGENT fix server crash")
;; → Item com :priority 1

;; Pré-visualizar sem criar um item
(smart-parse "email Sarah March 15 about renewal !!")
;; → {:text "email Sarah about renewal" :when "2026-03-15" :priority 2 :who ("Sarah")}

Comando	Descrição
(add "text")	Adição inteligente: analisa linguagem natural, extrai metadados, cria item
(smart-parse "text")	Pré-visualizar extração sem criar um item

HTTP e JSON:

Cliente HTTP genérico e builtins JSON para integração com APIs:

Comando	Descrição
(http-get url)	Requisição GET, retorna {:status N :body "..."}
(http-post url body :content-type "...")	Requisição POST com corpo
(json-parse string)	Analisar string JSON para dict/list EELisp
(json-stringify value)	Converter valor EELisp para string JSON

Itens Recorrentes e Modelos:

Itens com padrões de recorrência criam automaticamente a próxima ocorrência quando marcados como concluídos. Modelos definem blueprints reutilizáveis de itens:

Comando	Descrição
(add-item text :recur :weekly)	Criar um item recorrente (:daily, :weekly, :monthly)
(every N :unit)	Intervalo personalizado, ex.: (every 3 :months)
(item-done id)	Marcar como concluído; cria próximo automaticamente se recorrente
(deftemplate name :text "..." :category "..." :priority N)	Definir um modelo reutilizável de item
(from-template name :when "..." ...)	Criar item a partir de modelo com substituições
(templates)	Listar todos os modelos definidos
(drop-template name)	Remover um modelo

Múltiplas Agendas:

Abra, alterne entre e gerencie múltiplos bancos de dados de agenda. Exporte e importe para backup ou migração:

Comando	Descrição
(open-agenda "path/to/file.db")	Abrir um novo banco de dados de agenda e alternar para ele
(use-agenda name)	Alternar para uma agenda já aberta
(agendas)	Listar todas as agendas abertas com marcador ativo
(close-agenda name)	Fechar e remover uma agenda do registro
(export-agenda name :format :json :path "file.json")	Exportar todas as tabelas da agenda para JSON
(import-agenda "file.json")	Importar registros de uma exportação JSON

13. Referência Rápida EELisp

Variáveis e funções:

(def x 42)
(defn square (x) (* x x))
(square 5)   ; → 25

;; Funções anônimas
(map (fn (x) (* x x)) '(1 2 3))   ; → (1 4 9)

;; Parâmetros rest
(defn sum (first . rest)
  (reduce + first rest))

Condicionais e loops:

(if (> x 0) "positive" "non-positive")

(cond
  (< x 0)  "negative"
  (= x 0)  "zero"
  else      "positive")

(let ((x 1) (y 2)) (+ x y))   ; → 3

;; Loop com estilo named-let
(loop ((i 0) (acc 0))
  (> i 10)
  (recur (+ i 1) (+ acc i)))   ; → 55

Strings:

(str "hello" ", " "world")          ; → "hello, world"
(str-split "a,b,c" ",")            ; → ("a" "b" "c")
(str-join '("a" "b" "c") "-")      ; → "a-b-c"
(str-upper "hello")                 ; → "HELLO"

Listas:

(list 1 2 3)                        ; → (1 2 3)
(cons 0 '(1 2))                     ; → (0 1 2)
(map inc (range 1 6))               ; → (2 3 4 5 6)
(filter even? (range 1 11))         ; → (2 4 6 8 10)
(reduce + 0 '(1 2 3 4 5))          ; → 15
(sort-by id '(3 1 4 1 5))          ; → (1 1 3 4 5)

Dicionários:

(def d {:name "Alice" :age 30})
(dict-get d :name)                  ; → "Alice"
(dict-set d :age 31)                ; → {:name "Alice" :age 31}
(dict-keys d)                       ; → (:name :age)

Funções do prelúdio:

Função	Descrição
inc / dec	Incrementar / decrementar por 1
even? / odd?	Verificações de paridade
zero? / pos? / neg?	Verificações de sinal
first / second / third / last	Acesso a listas
take / drop	Pegar/descartar os primeiros n elementos
some? / every?	Algum/todos correspondem ao predicado
pipe	Macro de encadeamento: (pipe 5 inc inc square)
compose	Composição de funções
partial	Aplicação parcial

14. Dicas para iOS e iPadOS

• Barra de Ações Rápidas — uma barra de ferramentas horizontal aparece acima do editor com botões para Timestamp, Buscar, Diário, Semanal, Pesquisar, Abrir, Pré-visualização, PDF, REPL e Atalhos. Toque em qualquer botão para acesso instantâneo.
• Barra de Ferramentas do REPL — quando o REPL está ativo, uma barra de ferramentas aparece acima do teclado com navegação de histórico (cima/baixo), snippets rápidos (query, deftable, defn) e um botão de limpar.
• Teclado externo — todos os atalhos de teclado funcionam quando você conecta um teclado físico ao seu iPad.
• Menus de contexto — toque longo em arquivos na barra lateral ou abas para acessar renomear, excluir, fixar e outras ações.
• Split View — o EEditor funciona nos modos Split View e Slide Over do iPadOS.