/*
 * Clang Module Map for libarchive
 *
 * What this is:
 * This file tells the Clang compiler how to treat libarchive as a "module" -
 * a self-contained unit of code that can be imported all at once instead of
 * including individual header files. Think of it like a package definition.
 *
 * How it works:
 * - When you write `@import CArchive` (Objective-C) or `import CArchive` (Swift),
 *   the compiler uses this file to know which headers belong to libarchive
 * - Instead of processing each #include separately, the compiler can load a
 *   pre-compiled version of the entire library, making builds faster
 * - This also provides better dependency tracking and can catch issues like
 *   conflicting macro definitions between libraries
 *
 * When to update:
 * Update this file whenever:
 * - New public header files are added to libarchive's libarchive/ directory
 * - Public headers are removed or renamed
 * - The library's API structure changes significantly
 *
 * You typically don't need to update this for:
 * - Internal implementation changes
 * - Private/internal header modifications
 * - Documentation updates
 *
 * NOTE: This only affects projects using Clang with modules enabled. Traditional
 * #include-based builds will continue to work normally with or without this file.
 */
module CArchive {
  header "archive.h"
  header "archive_entry.h"
}