Sección Librerías
La sección Librerías te permite desarrollar una librería compartida en local y
verla en los micros que la consumen, sin publicarla en un registro. MicroLab construye
su artefacto y lo enlaza sobre el node_modules de cada consumidor. Hoy soporta
librerías npm.
Es una sección con patrón lista + detalle (como Micros): en el lateral, el catálogo de librerías; en el centro, el detalle editable de la seleccionada.
Añadir una librería
Sección titulada «Añadir una librería»Desde el botón de alta (barra superior) —también ofrecido en el fondo vacío de la sección cuando aún no hay ninguna—:
- Añadir librería — eliges la carpeta del repo de la librería.
- Importar desde Git — clona el repo y la da de alta, derivando el nombre del
paquete de su
package.json.
El detalle de una librería
Sección titulada «El detalle de una librería»Identidad y receta de build. Se guarda solo (autosave con un pequeño retardo, igual que en Micros; se puede desactivar en Ajustes):
- Nombre y Paquete (el nombre del paquete npm que produce).
- Build — el comando que construye el artefacto (
dist) y la ruta del artefacto. Si no los declaras, se usa el del perfil npm:npm run build, con eldistbajo el último segmento del paquete. - Consumidores — los micros que usan la librería. Por defecto se detectan solos escaneando quién declara ese paquete; puedes fijarlos a mano (ids de micros separados por coma).
- Vigilar cambios — reconstruye y reenlaza automáticamente al cambiar el código.
Estado y acciones
Sección titulada «Estado y acciones»Por librería:
| Acción | Qué hace |
|---|---|
| Construir | Genera el artefacto (dist). |
| Enlazar | Copia el artefacto sobre node_modules/<paquete> de cada consumidor (pisa la versión del registro). |
| Desenlazar | Restaura en cada consumidor su versión original. |
| Vigilar | Hace construir + enlazar en caliente ante cada cambio. Necesita el motor vivo. |
El estado de cada librería (construida / sin construir, enlazada en N consumidores, en watch) se ve en la lista y en el detalle.
Repositorio (Git)
Sección titulada «Repositorio (Git)»Como en Micros, el detalle de una librería incluye su Git: cambiar de rama, hacer
fetch y pull (--ff-only). El acceso es de solo lectura (nunca hace push), y
si hay cambios sin confirmar, MicroLab avisa antes de cambiar de rama o actualizar.
Si el repo no está en disco
Sección titulada «Si el repo no está en disco»Si la carpeta de una librería se movió, el detalle lo marca y ofrece relocalizar: eliges la carpeta nueva y se guarda la ruta.
No invasivo
Sección titulada «No invasivo»El enlace solo toca node_modules (que está fuera de Git) y se revierte al desenlazar
o con un npm ci: MicroLab no modifica el repo del consumidor ni el de la librería.
Borrar una librería del catálogo no la desenlaza: si estaba enlazada, desenlázala antes desde el detalle.
Desde el CLI y el MCP
Sección titulada «Desde el CLI y el MCP»microlab library list/status/build/link/unlink/watch. Las de solo lectura
(library_list, library_status) están también como tools del MCP.