Support CodableWithConfiguration when storing and retrieving from LocalStorage

[Supereg]

Support CodableWithConfiguration when storing and retrieving from LocalStorage

♻️ Current situation & Problem

As of know, we only support storage and retrieval using Encodable and Decodable types. iOS 17 introduced a new set of protocols: EncodableWithConfiguration and DecodableWithConfiguration. Instead of relying on the userInfo dictionary and runtime checks to ensure configuration is supplied on the call site, type can now strictly define a certain configuration type that has to be supplied when encoding or decoding. There is also a new @CodableConfiguration property wrapper that can be used to statically define configurations for nested types.

To embrace these strongly typed configurations, SpeziStorage add support to accept types of these new protocols. We rely on the newly introduced TopLevelEncoder and TopLevelDecoder protocols introduced with StanfordSpezi/SpeziFoundation#15 to stay generic over the encoder and decoder.

⚙️ Release Notes

• Support storage and retrieval of CodableWithConfiguration types.
• Improved documentation.

📚 Documentation

This PR reworks some of the documentation structure of SpeziStorage. Reducing some of the fluff and reorganizing the catalog a bit.

✅ Testing

--

📝 Code of Conduct & Contributing Guidelines

By submitting creating this pull request, you agree to follow our Code of Conduct and Contributing Guidelines:

• I agree to follow the Code of Conduct and Contributing Guidelines.

[codecov]

Codecov Report

Attention: Patch coverage is 66.66667% with 10 lines in your changes missing coverage. Please review.

Project coverage is 90.28%. Comparing base (099e059) to head (0b9b0b9).
Report is 1 commits behind head on main.

Files	Patch %	Lines
Sources/SpeziLocalStorage/LocalStorage.swift	66.67%	10 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #24      +/-   ##
==========================================
- Coverage   92.06%   90.28%   -1.77%     
==========================================
  Files           6        6              
  Lines         453      473      +20     
==========================================
+ Hits          417      427      +10     
- Misses         36       46      +10     

Files	Coverage Δ
...ources/SpeziLocalStorage/LocalStorageSetting.swift	97.30% <ø> (ø)
Sources/SpeziSecureStorage/Credentials.swift	100.00% <ø> (ø)
Sources/SpeziSecureStorage/SecureStorage.swift	93.97% <ø> (ø)
...es/SpeziSecureStorage/SecureStorageItemTypes.swift	100.00% <ø> (ø)
...ources/SpeziSecureStorage/SecureStorageScope.swift	82.46% <ø> (ø)
Sources/SpeziLocalStorage/LocalStorage.swift	83.07% <66.67%> (-6.35%)	⬇️

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 099e059...0b9b0b9. Read the comment docs.

[PSchmiedmayer]

Thank you for the nice additions; looks great to me!