Comparar y actualizar instalaciones de código fuente

Cuando instalas primitivos en modo source, los archivos viven en tu proyecto y pueden modificarse localmente. Los comandos solidiom diff y solidiom update te ayudan a rastrear cambios y actualizar desde upstream de forma segura.

#Comparar cambios con diff

solidiom diff compara los archivos instalados contra los dígitos almacenados en .solidiom/lock.json:

solidiom diff

Salida:

  M src/ui/primitives/dialog/Dialog.tsx
  D src/ui/primitives/dialog/utils.ts

• M — archivo modificado localmente
• D — archivo eliminado
• A — archivo nuevo

Para filtrar por primitivo:

solidiom diff --primitive dialog

Sin cambios:

solidiom diff
# No local modifications.

#Actualizar primitivos

solidiom update actualiza un primitivo a la versión upstream más reciente usando un algoritmo de fusión de tres vías:

solidiom update dialog

#Algoritmo de fusión

La fusión compara tres estados:

1. Base — el dígito original registrado en .solidiom/lock.json
2. Local — el contenido actual del archivo (posiblemente modificado por el usuario)
3. Upstream — la nueva versión del registro o monorepo

La matriz de decisiones:

#Estados de actualización

Salida:

  ↑ src/ui/primitives/dialog/Dialog.tsx
  ⇄ src/ui/primitives/dialog/Context.tsx (auto-merged)
  ⚡ src/ui/primitives/dialog/Overlay.tsx (CONFLICT)
  ○ src/ui/primitives/dialog/Custom.tsx (detached)

3 files updated.
1 conflicts - resolve manually:
  • src/ui/primitives/dialog/Overlay.tsx
    Compare: Overlay.tsx.local vs Overlay.tsx.upstream

#Ejecución simulada

solidiom update dialog --dry-run

Muestra los cambios que se aplicarían sin escribir archivos.

#Manejo de conflictos

Cuando ambos lados modifican las mismas líneas, solidiom update genera marcadores de conflicto estilo diff3:

<<<<<<< local
  contenido local
=======
  contenido upstream
>>>>>>> upstream

Además, crea archivos de referencia:

• <archivo>.local — versión local
• <archivo>.upstream — versión upstream

Resuelve el conflicto manualmente y elimina los archivos .local y .upstream cuando termines.

#Archivos desvinculados

Los archivos marcados como “detached” se omiten durante solidiom update. Para desvincular un primitivo:

solidiom detach dialog

Esta operación solo actualiza los metadatos de .solidiom/lock.json; no modifica ni elimina archivos.

#Reescritura de importaciones

Durante la actualización, las importaciones se reescriben automáticamente para reflejar la configuración actual del proyecto:

• Los archivos .tsx y .jsx usan transformación AST con ts-morph para preservar la estructura
• Los demás archivos usan reescritura basada en expresiones regulares
• Si la transformación AST falla, se usa el método de respaldo basado en expresiones regulares

#Lockfile

Después de una actualización exitosa, .solidiom/lock.json se actualiza con los nuevos dígitos y versiones. El archivo lockfile mantiene el registro de:

• digest — SHA-256 del contenido original
• version — versión en el momento de instalación
• detached — si el archivo está desvinculado
• manifestFilesHash — hash de integridad del manifiesto del registro
• verifiedAt — marca de tiempo de verificación
• provenance — “verified” o “unverified”

#Salida JSON

solidiom diff --json
solidiom update dialog --json

#Opciones de diff

#Opciones de update