feat: Add customization for local packages structure

Sources/XcodeGraph/Models/Package.swift

@@ -3,7 +3,11 @@ import Path
 
 public enum Package: Equatable, Codable, Sendable {
     case remote(url: String, requirement: Requirement)
-    case local(path: AbsolutePath)
+    /// Parameters
+    ///  - path: Absolute path of a package
+    ///  - groupPath: Path which would be used to
+    ///  structure packages in generated project
+    case local(path: AbsolutePath, groupPath: String?)
 }
 
 extension XcodeGraph.Package {

Sources/XcodeGraphMapper/Extensions/Package+Extensions.swift

@@ -6,7 +6,7 @@ extension Package {
         switch self {
         case let .remote(url, _):
             return url
-        case let .local(path):
+        case let .local(path, _):
             return path.pathString
         }
     }

Sources/XcodeGraphMapper/Mappers/Graph/XcodeGraphMapper.swift

@@ -141,10 +141,10 @@ public struct XcodeGraphMapper: XcodeGraphMapping {
             case .remote:
                 break
             case let .local(path: packagePath):
-                guard packageInfos[packagePath] == nil else { break }
-                let packageInfo = try await packageInfoLoader.loadPackageInfo(at: packagePath)
-                packageInfos[packagePath] = packageInfo
-                packagesByName[packageInfo.name] = packagePath
+                guard packageInfos[packagePath.path] == nil else { break }
+                let packageInfo = try await packageInfoLoader.loadPackageInfo(at: packagePath.path)
+                packageInfos[packagePath.path] = packageInfo
+                packagesByName[packageInfo.name] = packagePath.path
             }
         }
         for (path, packageInfo) in packageInfos {

Sources/XcodeGraphMapper/Mappers/Packages/XCPackageMapper.swift

@@ -48,7 +48,7 @@ struct XCPackageMapper: XCPackageMapping {
     func map(package: XCLocalSwiftPackageReference, sourceDirectory: AbsolutePath) throws -> Package {
         let relativePath = try RelativePath(validating: package.relativePath)
         let path = sourceDirectory.appending(relativePath)
-        return .local(path: path)
+        return .local(path: path, groupPath: nil)
     }
 
     // MARK: - Private Helpers

Sources/XcodeGraphMapper/Mappers/Project/PBXProjectMapper.swift

@@ -97,7 +97,7 @@ struct PBXProjectMapper: PBXProjectMapping {
         }
         let localPackages = try pbxProject.localPackages.compactMap {
             try packageMapper.map(package: $0, sourceDirectory: sourceDirectory)
-        } + localPackagePaths.map { .local(path: $0) }
+        } + localPackagePaths.map { .local(path: $0, groupPath: nil) }
 
         // Create a files group for the main group
         let filesGroup = ProjectGroup.group(name: pbxProject.mainGroup?.name ?? "Project")

Tests/XcodeGraphMapperTests/MapperTests/Graph/XcodeGraphMapperTests.swift

@@ -432,8 +432,8 @@ struct XcodeGraphMapperTests {
             .willReturn(
                 .test(
                     packages: [
-                        .local(path: "/tmp/LibraryA"),
-                        .local(path: "/tmp/LibraryB"),
+                        .local(path: "/tmp/LibraryA", groupPath: nil),
+                        .local(path: "/tmp/LibraryB", groupPath: nil),
                     ]
                 )
             )

Tests/XcodeGraphMapperTests/MapperTests/Package/XCPackageMapperTests.swift

@@ -150,7 +150,7 @@ struct XCPackageMapperTests {
         let expectedPath = xcodeProj.srcPath.appending(
             try RelativePath(validating: "Packages/Example")
         )
-        #expect(result == .local(path: expectedPath))
+        #expect(result == .local(path: expectedPath, groupPath: nil))
     }
 
     @Test("Throws an error if remote package has no repository URL")

Tests/XcodeGraphTests/Models/PackageTests.swift

@@ -7,7 +7,7 @@ import XCTest
 final class PackageTests: XCTestCase {
     func test_codable_local() {
         // Given
-        let subject = Package.local(path: try! AbsolutePath(validating: "/path/to/workspace"))
+        let subject = Package.local(path: try! AbsolutePath(validating: "/path/to/workspace"), groupPath: nil)
 
         // Then
         XCTAssertCodable(subject)
@@ -26,7 +26,7 @@ final class PackageTests: XCTestCase {
 
     func test_is_remote_local() {
         // Given
-        let subject = Package.local(path: try! AbsolutePath(validating: "/path/to/package"))
+        let subject = Package.local(path: try! AbsolutePath(validating: "/path/to/package"), groupPath: nil)
 
         // Then
         XCTAssertFalse(subject.isRemote)