feat: Add write() function for typing text

[NakaokaRei]

Feature Request: write() Function

Description

Implement write() function to type text strings with optional interval between keystrokes.

Proposed API

public static func write(
    _ text: String,
    interval: TimeInterval = 0
)

Parameters

• text: The string to type
• interval: Delay between each keystroke (in seconds)

Example Usage

// Type text instantly
SwiftAutoGUI.write("Hello, World\!")

// Type with 0.1 second delay between characters
SwiftAutoGUI.write("Slowly typed text", interval: 0.1)

// Type in a text field
SwiftAutoGUI.click(x: 100, y: 200)  // Click on text field
SwiftAutoGUI.write("user@example.com")

Implementation Notes

• Parse string into individual characters
• Handle special characters and Unicode properly
• Use existing keyDown()/keyUp() infrastructure
• Add Thread.sleep for interval between keystrokes

Priority

🟡 Medium - Very useful for form filling and text automation

Related to PyAutoGUI

• PyAutoGUI write() documentation

[NakaokaRei]

@claude implement this feature based on the issue description

[claude]

Claude finished @NakaokaRei's task —— View job • claude/issue-12-20250708_060616 • Create PR ➔

---

Implementing write() Function

I've successfully implemented the write() function for typing text strings with optional keystroke intervals.

Tasks:

• Examine existing codebase structure and keyboard functions
• Implement write() function with proper character handling
• Test the implementation with swift build/test
• Commit changes

Implementation Details:

✅ write() Function: Added write(_ text: String, interval: TimeInterval = 0) method that:

• Types each character sequentially using existing keyDown()/keyUp() infrastructure
• Automatically handles uppercase letters and special characters with shift key
• Supports custom intervals between keystrokes
• Gracefully handles unsupported characters (skips them)

✅ Character Mapping: Added characterToKey() helper function supporting:

• All letters (a-z, A-Z)
• Numbers (0-9)
• Common punctuation and special characters
• Whitespace characters (space, tab, newline)

✅ Tests: Added comprehensive tests in KeyboardTests.swift:

• Basic write function tests
• Character mapping validation
• Edge cases (empty strings, emoji, special characters)

✅ Documentation: Updated DocC documentation to include the new function

Example Usage:

// Type text instantly
SwiftAutoGUI.write("Hello, World!")

// Type with 0.1 second delay between characters
SwiftAutoGUI.write("Slowly typed text", interval: 0.1)

// Type in a text field
SwiftAutoGUI.leftClick()  // Click on text field
SwiftAutoGUI.write("user@example.com")

The implementation follows the existing code patterns and includes proper error handling for unsupported characters.