[TÍTULO DO RECURSO OU MODIFICAÇÃO] (modulo.sugerido)
Tipo de Solicitação: [ ] Nova Feature / API [ ] Melhoria de Função Existente [ ] Bugfix / Correção [ ] Otimização
Status: Pendente de envio
Estagio do Factorio: [ ] data-stage (data.lua) [ ] runtime (control.lua) [ ] settings (settings.lua)
Mod / Projeto Solicitante: [Nome do seu mod e versão, ex: Quantum-Teleporter v1.0.0]

Funcao/API Solicitada:
Nome e assinatura da função desejada (ex: LDARuntime.gui.findElementByName(root_element, name, max_depth)).

Parametros e Tipos:
- parametro_1 (tipo, obrigatorio/opcional): Descricao do dado esperado.
- parametro_2 (tipo, opcional): Descricao e valor padrao caso omitido.

Retorno Esperado:
Tipo e formato do retorno (ex: LuaGuiElement|nil, tabela de protótipo, booleano de sucesso, etc.).

Necessidade no Mod (Caso de Uso):
Qual mecânica o seu mod precisa implementar e qual dor de cabeça isso resolve (evitar código duplicado, janelas complexas, cálculos manuais, etc.).

Exemplo de Uso Pratico:
Como você gostaria de chamar essa função no seu código final:
-- exemplo:
local resultado = LDARuntime.modulo.funcao(...)

Comportamento em Casos Limite (Edge Cases & Falhas):
O que deve acontecer se o elemento for inválido, faltar energia, objeto for destruído ou valores forem nulos (ex: "retornar nil em vez de dar crash", "não gastar energia se não cobrir o total").

Frequencia de Execucao (Performance):
[ ] Sob demanda (eventos de clique, construção, abertura de GUI)
[ ] Frequente (chamado em on_tick, loops ou varreduras em massa)

Implementacao Temporaria (Workaround Atual):
Cole o código ou helper que você criou temporariamente no seu mod para servir de inspiração:
-- cole o código aqui

Compatibilidade & Dependencias:
- Factorio: 2.0+ / 2.1+
- LDA-LIB: >= 0.0.17
- DLC Space Age: [ ] Obrigatorio [ ] Opcional [ ] Nao aplicavel

Observacoes Tecnicas:
Detalhes específicos de engine (ex: "objetos Factorio são userdata", "persistir em storage", "respeitar player.opened para fechar no ESC").