Function loadZipFromFile

src/utils/zipLoader.ts:248–279

(
  zipFile: File,
  onProgress: (progress: ZipProgress) => void
)

 * Extracts COLMAP files immediately and builds an index for lazy image extraction.
 */
export async function loadZipFromFile(
  zipFile: File,
  onProgress: (progress: ZipProgress) => void
): Promise<ZipLoadResult> {
  // Initialize libarchive.js
  await initializeArchive();

  onProgress({ percent: 0, message: 'Checking archive...' });

  // Validate size
  const validation = validateZipFile(zipFile);
  if (!validation.valid) {
    throw new Error(validation.error ?? 'Invalid archive');
  }

  onProgress({ percent: 40, message: 'Opening archive...' });

  // Open archive
  const archive = await Archive.open(zipFile);

  // Process archive
  const { colmapFiles, imageIndex, imageCount } = await processZipArchive(archive, onProgress);

  // Verify we have required COLMAP files
  if (!hasRequiredColmapArchiveFiles(colmapFiles.keys())) {
    throw new Error(
      'ZIP does not contain valid COLMAP files (cameras.bin, images.bin, points3D.bin)'
    );
  }

  return { colmapFiles, imageIndex, archive, fileSize: zipFile.size, imageCount };
}