chore: Use explicit ./artifacts path in release workflow

.github/workflows/ci.yml

@@ -12,13 +12,22 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        swift-version: ["6.1"]
+        swift-version: ["6.1", "6.2"]
     container:
       image: swift:${{ matrix.swift-version }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Cache Swift packages
+        uses: actions/cache@v4
+        with:
+          path: .build
+          key: ${{ runner.os }}-spm-${{ matrix.swift-version }}-${{ hashFiles('**/Package.resolved') }}
+          restore-keys: |
+            ${{ runner.os }}-spm-${{ matrix.swift-version }}-
+            ${{ runner.os }}-spm-
+
       - name: Build package
         run: swift build --verbose
 
@@ -30,7 +39,7 @@ jobs:
     runs-on: macos-latest
     strategy:
       matrix:
-        swift-version: ["6.1"]
+        swift-version: ["6.1", "6.2"]
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -40,6 +49,15 @@ jobs:
         with:
           swift-version: ${{ matrix.swift-version }}
 
+      - name: Cache Swift packages
+        uses: actions/cache@v4
+        with:
+          path: .build
+          key: ${{ runner.os }}-spm-${{ matrix.swift-version }}-${{ hashFiles('**/Package.resolved') }}
+          restore-keys: |
+            ${{ runner.os }}-spm-${{ matrix.swift-version }}-
+            ${{ runner.os }}-spm-
+
       - name: Build package
         run: swift build --verbose
 

.github/workflows/release-tailwindcss-cli.yml

@@ -0,0 +1,104 @@
+name: Release TailwindCSS CLI Artifacts
+
+on:
+  workflow_dispatch:
+    inputs:
+      tailwind_version:
+        description: "TailwindCSS release version (e.g., v4.1.14)"
+        required: true
+        type: string
+
+jobs:
+  build-and-release:
+    name: Build and Release Artifacts
+    runs-on: macos-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Swift
+        uses: swift-actions/setup-swift@v2
+        with:
+          swift-version: "6.1"
+
+      - name: Cache Swift packages
+        uses: actions/cache@v4
+        with:
+          path: .build
+          key: ${{ runner.os }}-spm-release-${{ hashFiles('**/Package.resolved') }}
+          restore-keys: |
+            ${{ runner.os }}-spm-release-
+            ${{ runner.os }}-spm-
+
+      - name: Validate version format
+        run: |
+          if [[ ! "${{ inputs.tailwind_version }}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+            echo "Error: Version must be in format vX.Y.Z (e.g., v4.1.14)"
+            exit 1
+          fi
+          echo "Version format is valid: ${{ inputs.tailwind_version }}"
+
+      - name: Build artifact bundler
+        run: |
+          echo "Building TailwindCSSCLIArtifactBundler..."
+          swift build -c release --product TailwindCSSCLIArtifactBundler
+
+      - name: Create artifact bundles
+        run: |
+          echo "Creating artifact bundles for TailwindCSS ${{ inputs.tailwind_version }}..."
+          mkdir -p ./artifacts
+          .build/release/TailwindCSSCLIArtifactBundler \
+            --version "${{ inputs.tailwind_version }}" \
+            --work-dir "${{ runner.temp }}/tailwindcss-bundles" \
+            --output-dir ./artifacts
+
+      - name: List generated artifacts
+        run: |
+          echo "Generated artifacts:"
+          ls -lh artifacts/
+
+      - name: Compute checksum
+        id: checksum
+        run: |
+          CHECKSUM=$(shasum -a 256 artifacts/tailwindcss.artifactbundleindex | awk '{print $1}')
+          echo "checksum=$CHECKSUM" >> $GITHUB_OUTPUT
+          echo "Artifact bundle index checksum: $CHECKSUM"
+
+      - name: Create release
+        uses: softprops/action-gh-release@6da8fa9354ddfdc4aeace5fc48d7f679b5214090 # v2.4.1
+        with:
+          tag_name: TailwindCSSCLI-${{ inputs.tailwind_version }}
+          name: TailwindCSS CLI ${{ inputs.tailwind_version }}
+          body: |
+            ## TailwindCSS CLI Artifact Bundles
+
+            This release contains Swift Package Manager artifact bundles for TailwindCSS CLI version `${{ inputs.tailwind_version }}`.
+
+            ### Included Artifacts
+            - Linux x64 (`x86_64-unknown-linux-gnu`)
+            - macOS x64 (`x86_64-apple-darwin`)
+            - macOS ARM64 (`aarch64-apple-darwin`)
+
+            ### Usage
+            Add the artifact bundle to your `Package.swift`:
+            ```swift
+            .binaryTarget(
+              name: "TailwindCSSCLI",
+              url: "https://github.com/${{ github.repository }}/releases/download/TailwindCSSCLI@${{ inputs.tailwind_version }}/tailwindcss.artifactbundleindex",
+              checksum: "${{ steps.checksum.outputs.checksum }}"
+            )
+            ```
+
+            ### Checksum
+            ```
+            ${{ steps.checksum.outputs.checksum }}
+            ```
+          draft: false
+          prerelease: false
+          make_latest: false
+          files: |
+            artifacts/*.zip
+            artifacts/tailwindcss.artifactbundleindex

Package.resolved

@@ -0,0 +1,33 @@
+{
+  "originHash" : "8e39da950f9cbe4c8126b1fabf0d3d6945ab547f7564fd7bb0921701f3269c14",
+  "pins" : [
+    {
+      "identity" : "swift-argument-parser",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/apple/swift-argument-parser.git",
+      "state" : {
+        "revision" : "309a47b2b1d9b5e991f36961c983ecec72275be3",
+        "version" : "1.6.1"
+      }
+    },
+    {
+      "identity" : "swift-asn1",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/apple/swift-asn1.git",
+      "state" : {
+        "revision" : "f70225981241859eb4aa1a18a75531d26637c8cc",
+        "version" : "1.4.0"
+      }
+    },
+    {
+      "identity" : "swift-crypto",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/apple/swift-crypto.git",
+      "state" : {
+        "revision" : "95ba0316a9b733e92bb6b071255ff46263bbe7dc",
+        "version" : "3.15.1"
+      }
+    }
+  ],
+  "version" : 3
+}

Package.swift

@@ -6,15 +6,27 @@ let package = Package(
   name: "SwiftTailwind",
   platforms: [.macOS(.v12)],
   products: [
-    .plugin(name: "TailwindCSS", targets: ["TailwindCSS"])
+    .plugin(name: "TailwindCSS", targets: ["TailwindCSS"]),
+    .executable(name: "TailwindCSSCLIArtifactBundler", targets: ["TailwindCSSCLIArtifactBundler"]),
+  ],
+  dependencies: [
+    .package(url: "https://github.com/apple/swift-argument-parser.git", from: "1.0.0"),
+    .package(url: "https://github.com/apple/swift-crypto.git", from: "3.0.0"),
   ],
   targets: [
+    .executableTarget(
+      name: "TailwindCSSCLIArtifactBundler",
+      dependencies: [
+        .product(name: "ArgumentParser", package: "swift-argument-parser"),
+        .product(name: "Crypto", package: "swift-crypto"),
+      ]
+    ),
     .plugin(name: "TailwindCSS", capability: .buildTool(), dependencies: ["TailwindCSSCLI"]),
     .binaryTarget(
       name: "TailwindCSSCLI",
       url:
-        "https://github.com/laosb/SwiftTailwind/releases/download/1.0.0+tw.4.1.12/tailwindcss.artifactbundle.zip",
+        "https://github.com/laosb/SwiftTailwind/releases/download/1.1.0-test.4+tw.4.1.14/tailwindcss.artifactbundleindex",
-      checksum: "bfa96ef1d4d1b665bb40c89ec906044c9532b3cabf866fbe2bd3e5a95bf40bea"
+      checksum: "ec4df49e361db5fc3159c431e5661af2e1b22d8575c64ce0482a8e84cfd93d04"
     ),
     .target(
       name: "SwiftTailwindExample",

Scripts/buildArtifactBundle.sh

@@ -1,83 +0,0 @@
-#!/bin/bash
-
-set -euo pipefail
-
-# Check if TAILWINDCSS_VERSION environment variable is set
-if [[ -z "${TAILWINDCSS_VERSION:-}" ]]; then
-    echo "Error: TAILWINDCSS_VERSION environment variable is not set"
-    echo "Usage: TAILWINDCSS_VERSION=v3.4.0 $0"
-    exit 1
-fi
-
-VERSION="$TAILWINDCSS_VERSION"
-echo "Building artifact bundle for TailwindCSS version: $VERSION"
-
-# Get the directory containing this script to find the template
-TEMPLATE_FILE="$PWD/Scripts/info.template.json"
-
-# Check if template file exists
-if [[ ! -f "$TEMPLATE_FILE" ]]; then
-    echo "Error: Template file not found at $TEMPLATE_FILE"
-    exit 1
-fi
-
-# Create working directory
-WORK_DIR="/tmp/tailwindcss.artifactbundle"
-echo "Creating working directory: $WORK_DIR"
-rm -rf "$WORK_DIR"
-mkdir -p "$WORK_DIR"
-cd "$WORK_DIR"
-
-# GitHub release base URL
-BASE_URL="https://github.com/tailwindlabs/tailwindcss/releases/download/$VERSION"
-
-# Download and place binaries
-download_binary() {
-    local binary_name="$1"
-    local target_path="$2"
-    local target_dir
-    target_dir=$(dirname "$target_path")
-
-    echo "Downloading $binary_name..."
-    mkdir -p "$target_dir"
-
-    if curl -L "$BASE_URL/$binary_name" > "$target_path"; then
-        chmod +x "$target_path"
-        echo "✓ Downloaded and made executable: $target_path"
-    else
-        echo "✗ Failed to download $binary_name from $BASE_URL/$binary_name"
-        exit 1
-    fi
-}
-
-# Download each binary to its target location
-download_binary "tailwindcss-linux-x64" "tailwindcss-$VERSION-linux-x64/bin/tailwindcss"
-download_binary "tailwindcss-macos-x64" "tailwindcss-$VERSION-macos-x64/bin/tailwindcss"
-download_binary "tailwindcss-macos-arm64" "tailwindcss-$VERSION-macos-arm64/bin/tailwindcss"
-
-# Create info.json from template, replacing %VERSION% with actual version
-echo "Creating info.json from template..."
-sed "s/%VERSION%/$VERSION/g" "$TEMPLATE_FILE" > "info.json"
-echo "✓ Created info.json with version $VERSION"
-
-# Create ZIP file
-ZIP_FILE="/tmp/tailwindcss.artifactbundle.zip"
-echo "Creating ZIP file: $ZIP_FILE"
-
-# Remove existing ZIP file if it exists
-rm -f "$ZIP_FILE"
-
-# Create ZIP with the artifact bundle as the only child in root
-cd /tmp
-zip -r "tailwindcss.artifactbundle.zip" "tailwindcss.artifactbundle"
-
-echo "✓ Created ZIP file: $ZIP_FILE"
-
-# Compute checksum using Swift Package Manager
-echo "Computing checksum..."
-CHECKSUM=$(swift package compute-checksum "$ZIP_FILE")
-
-echo ""
-echo "=== BUILD COMPLETE ==="
-echo "ZIP file path: $ZIP_FILE"
-echo "Checksum: $CHECKSUM"

Scripts/info.template.json

@@ -1,23 +0,0 @@
-{
-  "schemaVersion": "1.0",
-  "artifacts": {
-    "tailwindcss": {
-      "version": "%VERSION%",
-      "type": "executable",
-      "variants": [
-        {
-          "path": "tailwindcss-%VERSION%-macos-x64/bin/tailwindcss",
-          "supportedTriples": ["x86_64-apple-macosx"]
-        },
-        {
-          "path": "tailwindcss-%VERSION%-macos-arm64/bin/tailwindcss",
-          "supportedTriples": ["arm64-apple-macosx"]
-        },
-        {
-          "path": "tailwindcss-%VERSION%-linux-x64/bin/tailwindcss",
-          "supportedTriples": ["x86_64-unknown-linux-gnu"]
-        }
-      ]
-    }
-  }
-}

Sources/TailwindCSSCLIArtifactBundler/ArtifactBundleBuilder+File Operations.swift

@@ -0,0 +1,41 @@
+import Foundation
+
+extension ArtifactBundleBuilder {
+  func downloadFile(from urlString: String, to destination: String) throws {
+    guard let url = URL(string: urlString) else {
+      throw ArtifactBundleError.invalidURL(urlString)
+    }
+
+    let data = try Data(contentsOf: url)
+    try data.write(to: URL(fileURLWithPath: destination))
+  }
+
+  func makeExecutable(path: String) throws {
+    let attributes = [FileAttributeKey.posixPermissions: 0o755]
+    try fileManager.setAttributes(attributes, ofItemAtPath: path)
+  }
+
+  func createZipFile(bundleDir: String, zipPath: String) throws {
+    // Remove existing ZIP file if it exists
+    if fileManager.fileExists(atPath: zipPath) {
+      try fileManager.removeItem(atPath: zipPath)
+    }
+
+    let bundleDirURL = URL(fileURLWithPath: bundleDir)
+    let workDirURL = bundleDirURL.deletingLastPathComponent()
+    let bundleName = bundleDirURL.lastPathComponent
+
+    let process = Process()
+    process.executableURL = URL(fileURLWithPath: "/usr/bin/zip")
+    process.arguments = ["-r", zipPath, bundleName]
+    process.currentDirectoryURL = workDirURL
+
+    try process.run()
+    process.waitUntilExit()
+
+    guard process.terminationStatus == 0 else {
+      throw ArtifactBundleError.zipCreationFailed
+    }
+  }
+
+}

Sources/TailwindCSSCLIArtifactBundler/ArtifactBundleBuilder+computeChecksum.swift

@@ -0,0 +1,46 @@
+import Crypto
+import Foundation
+
+extension ArtifactBundleBuilder {
+  /// Computes the SHA256 checksum of a file.
+  ///
+  /// If `usingSHA256Directly` is true, it uses Swift Crypto's SHA256 implementation.
+  /// This is to workaround https://github.com/swiftlang/swift-package-manager/issues/9219.
+  func computeChecksum(
+    filePath: String,
+    usingSHA256Directly: Bool = false
+  ) throws -> String {
+    if usingSHA256Directly {
+      // Use swift-crypto's SHA256 implementation
+      let fileURL = URL(fileURLWithPath: filePath)
+      let data = try Data(contentsOf: fileURL)
+      let hash = SHA256.hash(data: data)
+      return hash.compactMap { String(format: "%02x", $0) }.joined()
+    } else {
+      // Use swift package compute-checksum command
+      let process = Process()
+      process.executableURL = URL(fileURLWithPath: "/usr/bin/swift")
+      process.arguments = ["package", "compute-checksum", filePath]
+
+      let pipe = Pipe()
+      process.standardOutput = pipe
+
+      try process.run()
+      process.waitUntilExit()
+
+      guard process.terminationStatus == 0 else {
+        throw ArtifactBundleError.checksumComputationFailed
+      }
+
+      let data = pipe.fileHandleForReading.readDataToEndOfFile()
+      let output = String(data: data, encoding: .utf8)?.trimmingCharacters(
+        in: .whitespacesAndNewlines)
+
+      guard let checksum = output, !checksum.isEmpty else {
+        throw ArtifactBundleError.checksumComputationFailed
+      }
+
+      return checksum
+    }
+  }
+}

Sources/TailwindCSSCLIArtifactBundler/ArtifactBundleBuilder+expandingTriple.swift

@@ -0,0 +1,29 @@
+extension ArtifactBundleBuilder {
+  /// Expands a list of triples into a stricter list of triples.
+  ///
+  /// To workaround https://github.com/swiftlang/swift-package-manager/issues/7362.
+  func expandingTriple(_ triple: String) -> [String] {
+    switch triple {
+    case "aarch64-apple-darwin":
+      [
+        "aarch64-apple-darwin",
+        "arm64-apple-macosx12.0",
+        "arm64-apple-macosx13.0",
+        "arm64-apple-macosx14.0",
+        "arm64-apple-macosx15.0",
+        "arm64-apple-macosx26.0",
+      ]
+    case "x86_64-apple-darwin":
+      [
+        "x86_64-apple-darwin",
+        "x86_64-apple-macosx12.0",
+        "x86_64-apple-macosx13.0",
+        "x86_64-apple-macosx14.0",
+        "x86_64-apple-macosx15.0",
+        "x86_64-apple-macosx26.0",
+      ]
+    // TODO: Does linux need more detailed triple variants?
+    default: [triple]
+    }
+  }
+}

Sources/TailwindCSSCLIArtifactBundler/ArtifactBundleBuilder.swift

@@ -0,0 +1,158 @@
+import Foundation
+
+class ArtifactBundleBuilder {
+  private let version: String
+  private let workDir: String
+  private let outputDir: String
+  let fileManager = FileManager.default
+
+  private let binaryConfigurations: [BinaryConfiguration] = [
+    BinaryConfiguration(binaryName: "tailwindcss-linux-x64", triple: "x86_64-unknown-linux-gnu"),
+    BinaryConfiguration(binaryName: "tailwindcss-macos-x64", triple: "x86_64-apple-darwin"),
+    BinaryConfiguration(binaryName: "tailwindcss-macos-arm64", triple: "aarch64-apple-darwin"),
+  ]
+
+  init(version: String, workDir: String, outputDir: String) {
+    self.version = version
+    self.workDir = workDir
+    self.outputDir = outputDir
+  }
+
+  func buildArtifactBundles() throws {
+    try setupWorkingDirectory()
+
+    var bundleInfos: [BundleInfo] = []
+
+    print("Creating individual bundles...")
+    for config in binaryConfigurations {
+      let bundleInfo = try createBundle(for: config)
+      bundleInfos.append(bundleInfo)
+    }
+
+    try generateArtifactBundleIndex(bundleInfos: bundleInfos)
+
+    print("=== BUILD COMPLETE ===")
+    print("All bundles created successfully:")
+    print("")
+    print("Generated artifact bundle index: \(outputDir)/tailwindcss.artifactbundleindex")
+    print("")
+
+    let indexChecksum = try computeChecksum(
+      filePath: "\(outputDir)/tailwindcss.artifactbundleindex", usingSHA256Directly: true)
+    print("Index checksum: \(indexChecksum)")
+    print("")
+
+    for bundleInfo in bundleInfos {
+      print("Bundle: \(bundleInfo.fileName)")
+      print("  Checksum: \(bundleInfo.checksum)")
+      print("  Triple: \(bundleInfo.triple)")
+      print("")
+    }
+  }
+
+  private func setupWorkingDirectory() throws {
+    print("Creating working directory: \(workDir)")
+
+    if fileManager.fileExists(atPath: workDir) {
+      try fileManager.removeItem(atPath: workDir)
+    }
+
+    try fileManager.createDirectory(atPath: workDir, withIntermediateDirectories: true)
+  }
+
+  private func createBundle(for config: BinaryConfiguration) throws -> BundleInfo {
+    let bundleDirName = "tailwindcss-\(version)-\(config.triple).artifactbundle"
+    let bundleDir = "\(workDir)/\(bundleDirName)"
+    let binaryPath = "bin/tailwindcss"
+
+    print("Creating bundle for \(config.triple)...")
+
+    // Create bundle directory structure
+    let binDir = "\(bundleDir)/bin"
+    try fileManager.createDirectory(atPath: binDir, withIntermediateDirectories: true)
+
+    // Download binary
+    print("  Downloading \(config.binaryName)...")
+    let binaryURL =
+      "https://github.com/tailwindlabs/tailwindcss/releases/download/\(version)/\(config.binaryName)"
+    let binaryDestination = "\(bundleDir)/\(binaryPath)"
+
+    try downloadFile(from: binaryURL, to: binaryDestination)
+    try makeExecutable(path: binaryDestination)
+    print("  ✓ Downloaded and made executable: \(binaryDestination)")
+
+    // Create info.json
+    print("  Creating info.json...")
+    try createInfoJSON(bundleDir: bundleDir, binaryPath: binaryPath, triple: config.triple)
+    print(
+      "  ✓ Created info.json with version \(version), path \(binaryPath), triple \(config.triple)")
+
+    // Create ZIP file
+    let zipFileName = "\(bundleDirName).zip"
+    let zipPath = "\(outputDir)/\(zipFileName)"
+    print("  Creating ZIP file: \(zipPath)")
+
+    try createZipFile(bundleDir: bundleDir, zipPath: zipPath)
+
+    // Compute checksum
+    print("  Computing checksum...")
+    let checksum = try computeChecksum(filePath: zipPath)
+
+    print("  ✓ Bundle created: \(zipPath)")
+    print("  ✓ Checksum: \(checksum)")
+    print("")
+
+    return BundleInfo(fileName: zipFileName, checksum: checksum, triple: config.triple)
+  }
+
+  private func createInfoJSON(bundleDir: String, binaryPath: String, triple: String) throws {
+    let artifact = Artifact(
+      version: version,
+      type: "executable",
+      variants: [
+        ArtifactVariant(path: binaryPath, supportedTriples: expandingTriple(triple))
+      ]
+    )
+
+    let info = ArtifactBundleInfo(
+      schemaVersion: "1.0",
+      artifacts: ["tailwindcss": artifact]
+    )
+
+    let encoder = JSONEncoder()
+    encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+
+    let jsonData = try encoder.encode(info)
+    let infoPath = "\(bundleDir)/info.json"
+    try jsonData.write(to: URL(fileURLWithPath: infoPath))
+  }
+
+  private func generateArtifactBundleIndex(bundleInfos: [BundleInfo]) throws {
+    print("Generating tailwindcss.artifactbundleindex...")
+
+    // Create output directory if it doesn't exist
+    if !fileManager.fileExists(atPath: outputDir) {
+      try fileManager.createDirectory(atPath: outputDir, withIntermediateDirectories: true)
+    }
+
+    let bundles = bundleInfos.map { bundleInfo in
+      Bundle(
+        fileName: bundleInfo.fileName,
+        checksum: bundleInfo.checksum,
+        supportedTriples: expandingTriple(bundleInfo.triple)
+      )
+    }
+
+    let index = ArtifactBundleIndex(
+      schemaVersion: "1.0",
+      archives: bundles
+    )
+
+    let encoder = JSONEncoder()
+    encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
+
+    let jsonData = try encoder.encode(index)
+    let indexPath = "\(outputDir)/tailwindcss.artifactbundleindex"
+    try jsonData.write(to: URL(fileURLWithPath: indexPath))
+  }
+}

Sources/TailwindCSSCLIArtifactBundler/ArtifactBundleError.swift

@@ -0,0 +1,18 @@
+import Foundation
+
+enum ArtifactBundleError: Error, LocalizedError {
+  case invalidURL(String)
+  case zipCreationFailed
+  case checksumComputationFailed
+
+  var errorDescription: String? {
+    switch self {
+    case .invalidURL(let url):
+      return "Invalid URL: \(url)"
+    case .zipCreationFailed:
+      return "Failed to create ZIP file"
+    case .checksumComputationFailed:
+      return "Failed to compute checksum"
+    }
+  }
+}

Sources/TailwindCSSCLIArtifactBundler/Models.swift

@@ -0,0 +1,53 @@
+import Foundation
+
+// MARK: - Artifact Bundle Info Models
+
+/// Represents the info.json file structure for an artifact bundle
+struct ArtifactBundleInfo: Codable {
+  let schemaVersion: String
+  let artifacts: [String: Artifact]
+
+  enum CodingKeys: String, CodingKey {
+    case schemaVersion, artifacts
+  }
+}
+
+struct Artifact: Codable {
+  let version: String
+  let type: String
+  let variants: [ArtifactVariant]
+}
+
+struct ArtifactVariant: Codable {
+  let path: String
+  let supportedTriples: [String]
+}
+
+// MARK: - Artifact Bundle Index Models
+
+/// Represents the .artifactbundleindex file structure
+struct ArtifactBundleIndex: Codable {
+  let schemaVersion: String
+  let archives: [Bundle]  // The proposal says it's "bundles" but the actual implementation uses "archives"
+}
+
+struct Bundle: Codable {
+  let fileName: String
+  let checksum: String
+  let supportedTriples: [String]
+}
+
+// MARK: - Internal Data Models
+
+/// Configuration for a binary platform
+struct BinaryConfiguration {
+  let binaryName: String
+  let triple: String
+}
+
+/// Information about a created bundle
+struct BundleInfo {
+  let fileName: String
+  let checksum: String
+  let triple: String
+}

Sources/TailwindCSSCLIArtifactBundler/TailwindCSSCLIArtifactBundler.swift

@@ -0,0 +1,32 @@
+import ArgumentParser
+import Foundation
+
+@main
+struct TailwindCSSCLIArtifactBundler: ParsableCommand {
+  static let configuration = CommandConfiguration(
+    commandName: "TailwindCSSCLIArtifactBundler",
+    abstract: "Build TailwindCSS CLI artifact bundles for Swift Package Manager",
+    version: "1.0.0"
+  )
+
+  @Option(name: .shortAndLong, help: "TailwindCSS version to build (e.g., v4.1.14)")
+  var version: String
+
+  @Option(name: .shortAndLong, help: "Working directory for temporary files")
+  var workDir: String = "/tmp/tailwindcss-bundles"
+
+  @Option(name: .shortAndLong, help: "Output directory for the artifact bundle index")
+  var outputDir: String = "."
+
+  func run() throws {
+    print("Building artifact bundles for TailwindCSS version: \(version)")
+
+    let bundler = ArtifactBundleBuilder(
+      version: version,
+      workDir: workDir,
+      outputDir: outputDir
+    )
+
+    try bundler.buildArtifactBundles()
+  }
+}