Propiedad del Codigo Fuente
Cuando instalas un primitivo o plantilla de Solidiom, obtienes el código fuente. No un bundle compilado. No un enlace CDN. Los archivos TypeScript reales se instalan en tu proyecto.
Qué Significa la Propiedad del Codigo Fuente
- Puedes leerlo — sin código minificado misterioso en node_modules
- Puedes modificarlo — cambiar comportamiento, agregar funciones, corregir errores
- Puedes auditarlo — revisar cada línea por seguridad antes de desplegar
- Puedes bifurcarlo — tomar el código y nunca mirar atrás
- Puedes venderizarlo — commitear en tu repositorio y desconectarte del upstream
Cómo Funciona
Modo Paquete (por defecto)
solidiom add buttonInstala @solidiom/button como dependencia del workspace. El código fuente está en node_modules/@solidiom/button/source/ — legible, pero gestionado por tu gestor de paquetes.
Modo Fuente
solidiom add button --mode sourceCopia el código fuente del primitivo directamente en el directorio de código fuente configurado. Eres completamente dueño de estos archivos y puedes revisar conflictos con solidiom diff --primitive button.
Verificación de Integridad
Para comprobar la integridad del registro, usa el modo de registro explícitamente:
solidiom verify --registryLa verificación de un artefacto requiere una ruta al artefacto, por ejemplo solidiom verify ./dist/dialog.tgz.
¿Por Qué No Solo npm?
Las bibliotecas de componentes tradicionales te dan un bundle compilado:
- No puedes ver la implementación
- No puedes corregir errores sin esperar un release
- No puedes eliminar funciones que no necesitas
- No puedes auditar por seguridad sin decompilar
La emisión source/ de Solidiom te da la misma experiencia de desarrollo que código que escribiste tú mismo, con la opción de mantenerte conectado a las mejoras del upstream.
Compensaciones
| Beneficio | Compensación |
|---|---|
| Control total | Eres responsable de tus modificaciones |
| Sin lock-in | Las actualizaciones upstream requieren merge manual (modo fuente) |
| Auditable | Más archivos en tu proyecto |
| Bifurcable | La divergencia del upstream es permanente (modo fuente) |
El Contrato del Registro
El registro asegura que lo que instalas es lo que fue publicado:
- Cada archivo tiene un digest SHA-256 en el manifiesto
- Los manifiestos están firmados con Ed25519 (verificación asimétrica)
- El CLI falla cerrado ante discrepancia de digest
- El modo offline funciona desde una instantánea local del registro
No tienes que confiar en nosotros. Puedes verificar.