Secção Bibliotecas

A secção Bibliotecas permite-lhe desenvolver uma biblioteca partilhada em local e vê-la nos micros que a consomem, sem a publicar num registo. O MicroLab constrói o seu artefacto e liga-o sobre o node_modules de cada consumidor. Hoje suporta bibliotecas npm.

É uma secção com padrão lista + detalhe (como Micros): no lateral, o catálogo de bibliotecas; no centro, o detalhe editável da selecionada.

Adicionar uma biblioteca

A partir do botão de adição (barra superior) —também oferecido no fundo vazio da secção quando ainda não há nenhuma—:

• Adicionar biblioteca — escolhe a pasta do repo da biblioteca.
• Importar do Git — clona o repo e adiciona-a, derivando o nome do pacote do seu package.json.

O detalhe de uma biblioteca

Identidade e receita de build. Guarda-se sozinho (autosave com um pequeno atraso, tal como em Micros; pode desativar-se em Definições):

• Nome e Pacote (o nome do pacote npm que produz).
• Build — o comando que constrói o artefacto (dist) e o caminho do artefacto. Se não os declarar, usa-se o do perfil npm: npm run build, com o dist sob o último segmento do pacote.
• Consumidores — os micros que usam a biblioteca. Por predefinição são detetados sozinhos procurando quem declara esse pacote; pode fixá-los à mão (ids de micros separados por vírgula).
• Vigiar alterações — reconstrói e religa automaticamente ao mudar o código.

Estado e ações

Por biblioteca:

Ação	O que faz
Construir	Gera o artefacto (dist).
Ligar	Copia o artefacto sobre o node_modules/<pacote> de cada consumidor (sobrepõe a versão do registo).
Desligar	Restaura em cada consumidor a sua versão original.
Vigiar	Faz construir + ligar a quente a cada alteração. Precisa do motor ativo.

O estado de cada biblioteca (construída / não construída, ligada em N consumidores, em vigilância) vê-se na lista e no detalhe.

Repositório (Git)

Como em Micros, o detalhe de uma biblioteca inclui o seu Git: mudar de ramo, fazer fetch e pull (--ff-only). O acesso é de só leitura (nunca faz push), e se houver alterações por confirmar, o MicroLab avisa antes de mudar de ramo ou atualizar.

Se o repo não está no disco

Se a pasta de uma biblioteca foi movida, o detalhe marca-o e oferece relocalizar: escolhe a pasta nova e o caminho é guardado.

Não invasivo

A ligação só toca em node_modules (que está fora do Git) e reverte-se ao desligar ou com um npm ci: o MicroLab não modifica o repo do consumidor nem o da biblioteca.

Apagar uma biblioteca do catálogo não a desliga: se estava ligada, desligue-a antes a partir do detalhe.

A partir do CLI e do MCP

microlab library list/status/build/link/unlink/watch. As de só leitura (library_list, library_status) estão também como tools do MCP.

Ver também

• Secção Micros · O espaço de trabalho e .microlab/