AgentD1F

Multi-line diff engine with Flash, Megatron, and Optimus algorithms for Swift.

✅ Interactive Demo

🚀 Try the Live Demo: d1f.ai

Experience the power of MultiLineDiff algorithms in real-time with our interactive JavaScript implementation:

• ⚡ Flash Algorithm: Lightning-fast prefix/suffix detection (14.5ms)
• 🤖 Optimus Algorithm: Line-aware CollectionDifference processing (43.7ms)
• 🧠 Megatron Algorithm: Semantic analysis with balanced performance (47.8ms)
• 🌟 Starscream Algorithm: Swift-native line processing (45.1ms)
• 🔍 Zoom Algorithm: Simple character-based diffing (23.9ms)

Real-time Performance Monitoring: Watch actual algorithm execution times as you type!

📦 Package Information

Repository: CodeFreezeAI/swift-multi-line-diff
Website: d1f.ai - Interactive Demo & Documentation
License: MIT
Language: Swift 100%
Latest Release: v2.0.2 (May 27, 2025)
Creator: Todd Bruss © xcf.ai

---

🚀 Installation Methods

Method 1: Swift Package Manager (Recommended)

Via Xcode

1. Open your Xcode project
2. Go to File → Add Package Dependencies
3. Enter the repository URL:

   https://github.com/CodeFreezeAI/swift-multi-line-diff.git
   

4. Select version 2.0.1 or Up to Next Major Version
5. Click Add Package
6. Select MultiLineDiff target and click Add Package

Via Package.swift

Add the dependency to your Package.swift file:

// swift-tools-version: 6.1
import PackageDescription

let package = Package(
    name: "YourProject",
    platforms: [
        .macOS(.v10_15),
        .iOS(.v13_0),
        .watchOS(.v6_0),
        .tvOS(.v13_0)
    ],
    dependencies: [
        .package(
            url: "https://github.com/CodeFreezeAI/swift-multi-line-diff.git",
            from: "2.0.1"
        )
    ],
    targets: [
        .target(
            name: "YourTarget",
            dependencies: [
                .product(name: "MultiLineDiff", package: "swift-multi-line-diff")
            ]
        )
    ]
)

Then run:

swift package resolve
swift build

Method 2: Local Compilation

Clone and Build Locally

# Clone the repository
git clone https://github.com/CodeFreezeAI/swift-multi-line-diff.git
cd swift-multi-line-diff

# Build the package
swift build

# Run tests to verify installation
swift test

# Build in release mode for production
swift build -c release

Integration into Local Project

# Add as a local dependency in your Package.swift
.package(path: "../path/to/swift-multi-line-diff")

---

📱Apple Platform Support

Platform	Minimum Version
macOS	10.15+
iOS	13.0+
watchOS	6.0+
tvOS	13.0+

Users are welcome to fork and port MultiLineDiff to Linux, Windows and Ubuntu!

---

🔧 Basic Usage

Import the Package

import MultiLineDiff

Quick Start Examples

1. Basic Diff Creation

import MultiLineDiff

let source = """
func greet() {
    print("Hello")
}
"""

let destination = """
func greet() {
    print("Hello, World!")
}
"""

// Create diff using default Megatron algorithm
let diff = MultiLineDiff.createDiff(
    source: source,
    destination: destination
)

// Apply the diff
let result = try MultiLineDiff.applyDiff(to: source, diff: diff)
print(result) // Outputs the destination text

2. Algorithm Selection

// Ultra-fast Flash algorithm (recommended for speed)
let flashDiff = MultiLineDiff.createDiff(
    source: source,
    destination: destination,
    algorithm: .flash
)

// Detailed Optimus algorithm (recommended for precision)
let optimusDiff = MultiLineDiff.createDiff(
    source: source,
    destination: destination,
    algorithm: .optimus
)

// Semantic Megatron algorithm (recommended for complex changes)
let megatronDiff = MultiLineDiff.createDiff(
    source: source,
    destination: destination,
    algorithm: .megatron
)

3. ASCII Diff Display

// Generate AI-friendly ASCII diff
let asciiDiff = MultiLineDiff.createAndDisplayDiff(
    source: source,
    destination: destination,
    format: .ai,
    algorithm: .flash
)

print("ASCII Diff for AI:")
print(asciiDiff)