docs: update DocC documentation to reflect current features and implementation

Author: owdax

Sources/SwiftDevKit/Documentation.docc/GettingStarted.md

@@ -1,14 +1,15 @@
 # Getting Started with SwiftDevKit
 
-This guide helps you get started with string and date conversion features in SwiftDevKit.
+Learn how to use SwiftDevKit's powerful features for text processing, time utilities, and data conversion.
 
 ## Overview
 
-SwiftDevKit provides simple and type-safe ways to convert values to and from strings, including specialized support for date formatting with thread safety.
+SwiftDevKit provides a comprehensive set of tools for common development tasks, including string manipulation, time handling, and various data conversion utilities.
 
 ## Requirements
 
-- iOS 16.0+ / macOS 13.0+ / tvOS 16.0+ / watchOS 9.0+
+- iOS 13.0+ / macOS 10.15+ / tvOS 13.0+ / watchOS 6.0+
+- Xcode 16.0+
 - Swift 5.9+
 
 ## Basic Setup
@@ -17,106 +18,105 @@ Add SwiftDevKit to your project using Swift Package Manager:
 
 ```swift
 dependencies: [
-    .package(url: "https://github.com/yourusername/SwiftDevKit.git", from: "1.0.0")
+    .package(url: "https://github.com/owdax/SwiftDevKit.git", from: "1.0.0")
 ]
 ```
 
-## Using String Conversion
+## Text Processing
 
-### Built-in Types
-
-SwiftDevKit extends common numeric types with string conversion capabilities:
+### String Transformations
 
 ```swift
-let number = 42
-let string = try await number.toString() // "42"
-let backToNumber = try await Int.fromString("42") // 42
+let text = "hello world example"
+let camelCase = text.toCamelCase() // "helloWorldExample"
+let snakeCase = text.toSnakeCase() // "hello_world_example"
+let kebabCase = text.toKebabCase() // "hello-world-example"
+
+// Smart truncation
+let longText = "This is a very long text that needs truncation"
+let truncated = longText.truncate(length: 20) // "This is a very lon..."
+
+// Whitespace handling
+let messy = "  too   many    spaces   "
+let clean = messy.removeExcessWhitespace() // "too many spaces"
 ```
 
-### Custom Types
-
-Make your types string-convertible by conforming to `StringConvertible`:
+### String Extraction
 
 ```swift
-struct User: StringConvertible {
-    let id: Int
-    
-    func toString() async throws -> String {
-        return String(id)
-    }
-    
-    static func fromString(_ string: String) async throws -> Self {
-        guard let id = Int(string) else {
-            throw StringConversionError.invalidInput(string)
-        }
-        return User(id: id)
-    }
-}
+let text = "Contact us at support@example.com or visit https://example.com"
+let emails = text.extractEmails() // ["support@example.com"]
+let urls = text.extractURLs() // ["https://example.com"]
+
+let post = "Check out #swiftdev and @swift_dev for updates!"
+let hashtags = post.extractHashtags() // ["swiftdev"]
+let mentions = post.extractMentions() // ["swift_dev"]
 ```
 
-## Date Conversion
+## Time Utilities
 
-SwiftDevKit provides thread-safe date formatting with common predefined formats:
+### TimeZone Management
 
 ```swift
-// Using ISO8601
-let date = Date()
-let iso8601 = try await date.toISO8601() // "2025-01-16T15:30:00Z"
-let parsedDate = try await Date.fromISO8601(iso8601)
-
-// Using custom formats
-let shortDate = try await date.toString(format: DateFormat.shortDate) // "01/16/2025"
-let httpDate = try await date.toHTTPDate() // "Wed, 16 Jan 2025 15:30:00 GMT"
+// Get current time in different zones
+let time = TimeZoneUtilities.currentTime(in: "America/New_York")
+let offset = TimeZoneUtilities.offsetHours(for: "Europe/London")
+
+// Convert between zones
+let converted = TimeZoneUtilities.convert(date: Date(),
+                                        from: "UTC",
+                                        to: "Asia/Tokyo")
 ```
 
-### Predefined Date Formats
+## Color Conversion
 
-SwiftDevKit includes commonly used date formats:
-- `DateFormat.iso8601` - Standard format for APIs
-- `DateFormat.http` - For HTTP headers
-- `DateFormat.shortDate` - Compact display format
-- `DateFormat.longDate` - Human-readable format
-- `DateFormat.dateTime` - Combined date and time
-- And more...
+```swift
+// Convert between color formats
+let rgb = RGBColor(r: 255, g: 128, b: 0)
+let hex = rgb.toHex() // "#FF8000"
+let hsl = rgb.toHSL() // HSLColor(h: 30, s: 100, l: 50)
+
+// Parse colors
+let color = try ColorConversion.from(hex: "#FF8000")
+let rgbComponents = color.rgbComponents
+```
+
+## Number Formatting
 
-### Thread Safety
+```swift
+let number = 1234567.89
+let formatted = number.format(style: .currency,
+                            locale: Locale(identifier: "en_US"))
+// "$1,234,567.89"
 
-All date conversion operations are thread-safe and can be called concurrently from multiple tasks. The framework uses an actor-based formatter cache to ensure optimal performance while maintaining thread safety.
+let scientific = number.format(style: .scientific)
+// "1.23E6"
+```
 
 ## Error Handling
 
 Handle conversion errors appropriately:
 
 ```swift
 do {
-    let value = try await Int.fromString("not a number")
-} catch let error as StringConversionError {
-    switch error {
-    case .invalidInput(let value):
-        print("Invalid input: \(value)")
-    }
+    let color = try ColorConversion.from(hex: "invalid")
+} catch let error as ColorConversionError {
+    print("Invalid color format: \(error.localizedDescription)")
 }
 
 do {
-    let date = try await Date.fromString("invalid", format: DateFormat.iso8601)
-} catch let error as DateConversionError {
-    switch error {
-    case .invalidFormat(let value):
-        print("Invalid date format: \(value)")
-    case .invalidComponents:
-        print("Invalid date components")
-    case .invalidFormatString(let format):
-        print("Invalid format string: \(format)")
-    case .custom(let message):
-        print(message)
-    }
+    let time = try TimeZoneUtilities.convert(date: Date(),
+                                           from: "Invalid/Zone",
+                                           to: "UTC")
+} catch let error as TimeZoneError {
+    print("Time zone error: \(error.localizedDescription)")
 }
 ```
 
 ## Next Steps
 
-- Explore the API documentation for more details
+- Explore the API documentation for detailed information
 - Check out example projects in the repository
 - Join our community discussions
 
-For more information, visit the [SwiftDevKit Documentation](https://github.com/yourusername/SwiftDevKit). 
+For more information, visit the [SwiftDevKit Documentation](https://github.com/owdax/SwiftDevKit). 

Sources/SwiftDevKit/Documentation.docc/SwiftDevKit.md

@@ -8,11 +8,11 @@ SwiftDevKit aims to be your go-to toolkit for common development tasks, offering
 
 ### Key Features
 
-- Data Conversion Tools
-- Cryptography Utilities
-- Text Processing
-- Development Helpers
-- Platform Utilities
+- Text Processing and String Manipulation
+- Time and TimeZone Utilities
+- Color Conversion Tools
+- Number Formatting
+- Date Conversion
 
 ## Topics
 
@@ -21,11 +21,16 @@ SwiftDevKit aims to be your go-to toolkit for common development tasks, offering
 - <doc:GettingStarted>
 - <doc:Installation>
 
-### Categories
+### Core Features
 
-- ``DataConversion``
-- ``Cryptography``
 - ``TextProcessing``
+- ``TimeUtilities``
+- ``Conversion``
+- ``NumberFormatting``
+
+### Coming Soon
+
+- ``Cryptography``
 - ``DevHelpers``
 - ``PlatformUtils``