Update documentation and package definition.

Author: objecthub

Package.swift

@@ -4,7 +4,7 @@
 //  NumberKit
 //
 //  Created by Matthias Zenger on 01/05/2017.
-//  Copyright © 2015-2023 Matthias Zenger. All rights reserved.
+//  Copyright © 2015-2024 Matthias Zenger. All rights reserved.
 //
 //  Licensed under the Apache License, Version 2.0 (the "License");
 //  you may not use this file except in compliance with the License.
@@ -23,20 +23,16 @@ import PackageDescription
 
 let package = Package(
   name: "NumberKit",
-  // Products define the executables and libraries produced by a package, and make them visible
-  // to other packages.
+  platforms: [
+    .macOS("13.3"),
+    .iOS(.v13),
+    .tvOS(.v13)
+  ],
   products: [
     .library(name: "NumberKit", targets: ["NumberKit"]),
   ],
-  
-  // Dependencies declare other packages that this package depends on.
-  // e.g. `.package(url: /* package url */, from: "1.0.0"),`
   dependencies: [
   ],
-  
-  // Targets are the basic building blocks of a package. A target can define a module or
-  // a test suite. Targets can depend on other targets in this package, and on products
-  // in packages which this package depends on.
   targets: [
     .target(name: "NumberKit",
             dependencies: [],
@@ -45,7 +41,5 @@ let package = Package(
                 dependencies: ["NumberKit"],
                 exclude: ["Info.plist"]),
   ],
-  
-  // Required Swift language version.
   swiftLanguageVersions: [.v5]
 )

README.md

@@ -1,14 +1,16 @@
 # Swift NumberKit
 
-[![Platforms: macOS, iOS, Linux](https://img.shields.io/badge/Platforms-macOS,%20iOS,%20Linux-blue.svg?style=flat)](https://developer.apple.com/osx/) [![Language: Swift 5.7](https://img.shields.io/badge/Language-Swift%205.7-green.svg?style=flat)](https://developer.apple.com/swift/) [![IDE: Xcode 14](https://img.shields.io/badge/IDE-Xcode%2014-orange.svg?style=flat)](https://developer.apple.com/xcode/) [![Package managers: SwiftPM, Carthage](https://img.shields.io/badge/Package%20managers-SwiftPM,%20Carthage-8E64B0.svg?style=flat)](https://github.com/Carthage/Carthage) [![License: Apache](http://img.shields.io/badge/License-Apache-lightgrey.svg?style=flat)](https://raw.githubusercontent.com/objecthub/swift-numberkit/master/LICENSE)
+[![Platforms: macOS, iOS, Linux](https://img.shields.io/badge/Platforms-macOS,%20iOS,%20Linux-blue.svg?style=flat)](https://developer.apple.com/osx/) [![Language: Swift 5.9](https://img.shields.io/badge/Language-Swift%205.9-green.svg?style=flat)](https://developer.apple.com/swift/) [![IDE: Xcode 15](https://img.shields.io/badge/IDE-Xcode%2015-orange.svg?style=flat)](https://developer.apple.com/xcode/) [![Package managers: SwiftPM, Carthage](https://img.shields.io/badge/Package%20managers-SwiftPM,%20Carthage-8E64B0.svg?style=flat)](https://github.com/Carthage/Carthage) [![License: Apache](http://img.shields.io/badge/License-Apache-lightgrey.svg?style=flat)](https://raw.githubusercontent.com/objecthub/swift-numberkit/master/LICENSE)
 
 ## Overview
 
 This is a framework implementing advanced numeric data types for the Swift programming
-language on macOS, iOS and Linux. Currently, the framework provides three new numeric types,
-each represented as a struct:
+language on macOS, iOS and Linux. Currently, the framework provides four new numeric types,
+each represented as a struct or enumeration:
 
-  1. `BigInt`: arbitrary-precision signed integers
+  1. `BigInt`: arbitrary-size signed integers
+  2. `Integer`: arbitrary-size signed integers whose implementation depends on the size
+      of the represented value.
   2. `Rational`: signed rational numbers
   3. `Complex`: complex floating-point numbers
 
@@ -21,12 +23,20 @@ real, generic enough foundation (and still isn't).
 
 ## BigInt
 
-`BigInt` objects are immutable, signed, arbitrary-precision integers that can be used as a
+`BigInt` values are immutable, signed, arbitrary-size integers that can be used as a
 drop-in replacement for the existing binary integer types of Swift 5.
 [Struct `BigInt`](https://github.com/objecthub/swift-numberkit/blob/master/Sources/NumberKit/BigInt.swift) defines all
-the standard arithmetic integer operations and implements the corresponding protocols defined
-in the standard library.
+the standard arithmetic integer operations and implements the corresponding protocols provided
+by Swift.
 
+## Integer
+
+`Integer` values are immutable, signed, arbitrary-size integers that can be used as a
+drop-in replacement for the existing binary integer types of Swift 5. As opposed to `BigInt`,
+the representation of values is chosen to optimize for memory size and performance of
+airthmetic operations. [Enum `Integer`](https://github.com/objecthub/swift-numberkit/blob/master/Sources/NumberKit/Integer.swift)
+defines all the standard arithmetic integer operations and implements the corresponding protocols
+provided by the Swift standard library.
 
 ## Rational
 
@@ -35,7 +45,6 @@ defines immutable, rational numbers based on an existing signed integer
 type `T`, like `Int32`, `Int64`, or `BigInt`. A rational number is a signed number that can
 be expressed as the quotient of two integers _a_ and _b_: _a / b_.
 
-
 ## Complex
 
 [Struct `Complex<T>`](https://github.com/objecthub/swift-numberkit/blob/master/Sources/NumberKit/Complex.swift)
@@ -47,12 +56,12 @@ where _i_ is the _imaginary unit_.
 
 The following technologies are needed to build the components of the _Swift NumberKit_ framework:
 
-- [Xcode 14](https://developer.apple.com/xcode/)
-- [Swift 5.8](https://developer.apple.com/swift/)
+- [Xcode 15](https://developer.apple.com/xcode/)
+- [Swift 5.9](https://developer.apple.com/swift/)
 - [Swift Package Manager](https://swift.org/package-manager/)
 - macOS, iOS or Linux
 
 ## Copyright
 
 Author: Matthias Zenger (<[email protected]>)  
-Copyright © 2016-2023 Matthias Zenger. All rights reserved.
+Copyright © 2016-2024 Matthias Zenger. All rights reserved.