docs: add details about API versions (#374) (#375)

Signed-off-by: Pierre-Yves Lapersonne <[email protected]>

Author: pylapp

CHANGELOG.md

@@ -70,6 +70,8 @@ struct RequestAccessibleFocusModifier: ViewModifier {
 ///         .oudsRequestAccessibleFocus(_requestFocus, for: .some(id: elements[0].id))
 ///     }
 /// ```
+///
+/// - Since: 0.8.0
 public enum AccessibilityFocusable: Hashable {
     case none
     case some(id: String)

OUDS/Core/Components/Sources/ViewModifiers/AccessibleModifiers/AccessibleModifiers.swift

@@ -25,6 +25,8 @@ import OUDSTokensSemantic
 /// Because `OUDSTheme` is not a *final* class, its type cannot be seen as `Sendable`, that is the reason why this conformity is unchecked.
 ///
 /// **Warning: You are not supposed to use this abstract default theme directly. Please prefer `OrangeTheme` instead**
+///
+/// - Since: 0.8.0
 open class OUDSTheme: @unchecked Sendable {
 
     // MARK: - Properties

OUDS/Core/OUDS/Sources/OUDSTheme/OUDSTheme.swift

@@ -67,6 +67,7 @@ extension EnvironmentValues {
 ///         YourRootView()
 ///     }
 ///
+/// - Since: 0.8.0
 public struct OUDSThemeableView<Content>: View where Content: View {
 
     private let theme: OUDSTheme

OUDS/Core/OUDS/Sources/OUDSTheme/Views/OUDSThemeableView.swift

@@ -75,6 +75,8 @@ extension EnvironmentValues {
 ///     @Environment(\.oudsHorizontalSizeClass) var horizontalSizeClass
 ///     @Environment(\.oudsVerticalSizeClass) var verticalSizeClass
 /// ```
+///
+/// - Since: 0.8.0
 public enum OUDSUserInterfaceSizeClass: String, Sendable {
     case extraCompact = "Extra Compact"
     case compact = "Compact"

OUDS/Core/OUDS/Sources/OUDSUserInterfaceSizeClass.swift

@@ -43,7 +43,8 @@ import OUDSTokensSemantic
 ///
 ///     @Environment(\.theme) var theme
 /// ```
-/// 
+///
+/// - Since: 0.8.0
 public final class InverseTheme: OrangeTheme, @unchecked Sendable {
 
     // MARK: - Initializers

OUDS/Core/Themes/Inverse/Sources/InverseTheme.swift

@@ -14,6 +14,8 @@
 /// This enum helps to add new **color raw tokens** exclusive to this ``OrangeTheme``.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum OrangeBrandColorRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Themes/Orange/Sources/Declarations/OrangeBrandColorRawTokens.swift

@@ -14,6 +14,8 @@
 /// This enum helps to add new **font raw tokens** exclusive to this ``OrangeTheme``
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///  
+/// - Since: 0.8.0
 public enum OrangeBrandFontRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Themes/Orange/Sources/Declarations/OrangeBrandFontRawTokens.swift

@@ -46,6 +46,8 @@ import OUDSTokensSemantic
 ///
 ///     @Environment(\.theme) var theme
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeTheme: OUDSTheme, @unchecked Sendable {
 
     // MARK: - Initializers

OUDS/Core/Themes/Orange/Sources/OrangeTheme.swift

@@ -51,6 +51,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(borders: CustomBorderTokensProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeBorderSemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeBorderSemanticTokensProvider.swift

@@ -49,6 +49,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(colors: CustomColorTokensProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeColorSemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeColorSemanticTokensProvider.swift

@@ -47,6 +47,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(elevations: CustomElevationTokensProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeElevationSemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeElevationSemanticTokensProvider.swift

@@ -49,6 +49,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(fonts: CustomFontTokensProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeFontSemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeFontSemanticTokensProvider.swift

@@ -53,6 +53,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(grids: CustomGridTokensProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeGridSemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeGridSemanticTokensProvider.swift

@@ -45,6 +45,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(opacities: CustomOpacityTokensProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeOpacitySemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeOpacitySemanticTokensProvider.swift

@@ -49,6 +49,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(sizes: CustomSizeTokensProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeSizeSemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeSizeSemanticTokensProvider.swift

@@ -49,6 +49,8 @@ import OUDSFoundations
 /// ```swift
 ///     OrangeTheme(spaces: CustomSpaceTokenProvider())
 /// ```
+///
+/// - Since: 0.8.0
 open class OrangeThemeSpaceSemanticTokensProvider {
 
     /// Intializes the provider

OUDS/Core/Themes/Orange/Sources/Providers/OrangeThemeSpaceSemanticTokensProvider.swift

@@ -17,6 +17,8 @@ import OUDSTokensSemantic
 
 /// This is a component tokens list for buttons like `OUDSButton`.
 /// **Warning: This is a draft component **
+///
+/// - Since: 0.8.0
 public protocol ButtonsComponentTokens {
 
     /*

OUDS/Core/Tokens/ComponentTokens/Sources/Values/ButtonsComponentTokens.swift

@@ -18,6 +18,8 @@ import Foundation
 /// Here an *elevation* is caracterized by *X and Y offsets*, a *radius* for the shadow and a *color* to apply on that shadow.
 /// All these elements are *raw tokens*, and together define a *composite raw token* for *elevation* effect.
 /// It is defined as a `final class` and `NSObject` so as to be shared through `@objc` with extensions and protocols within modules.
+///
+/// - Since: 0.8.0
 public final class ElevationCompositeRawToken: NSObject, Sendable { // NSObject for @objc compatibility
 
     /// The X offset for the elevation

OUDS/Core/Tokens/RawTokens/Sources/Composites/ElevationCompositeRawToken.swift

@@ -20,6 +20,8 @@ infix operator <|
 /// Composite tokens are tokens defined in *Figma* by other tokens.
 /// Here a *font* thing is caracterized by a *font size*, a *line height*, a *font weight* and *letter spacing* values.
 /// All these elements are *raw tokens*, and together define a *composite raw token* for *font* thing.
+/// 
+/// - Since: 0.8.0
 public struct FontCompositeRawToken: Equatable, Sendable {
 
     // Font family is not included here because this is the only thing which can vary

OUDS/Core/Tokens/RawTokens/Sources/Composites/FontCompositeRawToken.swift

@@ -19,6 +19,8 @@
 /// Primitive types such as `Double` and `String` must be used to as to allow to use `@objc` keywords in _Swift extensions_ for overriding.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum BorderRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Tokens/RawTokens/Sources/Declarations/BorderRawTokens.swift

@@ -16,9 +16,11 @@
 /// ``ColorRawTokens`` are tokens to use to define *colors* of components thants to ``ColorRawToken`` type. Some of these colors are "raw", and others have transparancy effects.
 /// This enum contains also the shared colors, i.e. colors exposed to any theme. Some colors related to the Orange brand are defined elswhere in `OrangeBrandColorRawTokens`.
 ///
-/// Primitive types such as  ``String` must be used to as to allow to use `@objc` keywords in extensions for overriding.
+/// Primitive types such as  `String` must be used to as to allow to use `@objc` keywords in extensions for overriding.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum ColorRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Tokens/RawTokens/Sources/Declarations/ColorRawTokens.swift

@@ -18,6 +18,8 @@
 /// Primitive types such as `Double` must be used to as to allow to use `@objc` keywords in extensions for overriding.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum DimensionRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Tokens/RawTokens/Sources/Declarations/DimensionRawTokens.swift

@@ -20,6 +20,8 @@
 /// Primitive types such as `CGFloat` must be used to as to allow to use `@objc` keywords in extensions for overriding.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum ElevationRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Tokens/RawTokens/Sources/Declarations/ElevationRawTokens.swift

@@ -25,6 +25,8 @@
 /// Primitive types such as `Int` and `String` must be used to as to allow to use `@objc` keywords in extensions for overriding.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum FontRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Tokens/RawTokens/Sources/Declarations/FontRawTokens.swift

@@ -13,11 +13,13 @@
 
 /// Defined as the group of all **raw tokens** related to **grid**.
 /// Values are defined in *GridRawTokens+Values.swift* file updated by the tokenator.
-/// ``GridRawTokens`` are tokens to use to define *grids*  using ``GridRawToken` type.
+/// ``GridRawTokens`` are tokens to use to define *grids*  using ``GridRawToken`` type.
 ///
 /// Primitive types such as `Int` must be used to as to allow to use `@objc` keywords in extensions for overriding.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum GridRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Tokens/RawTokens/Sources/Declarations/GridRawTokens.swift

@@ -18,6 +18,8 @@
 /// Primitive types such as `Double` must be used to as to allow to use `@objc` keywords in extensions for overriding.
 /// Such tokens are packed in a _Swift enum_ so as to gather them in one object with the suitable namespace and avoid to have just constants in nothing else
 ///  (i.e. publicly accessible from everywhere). More optimized than _struct_.
+///
+/// - Since: 0.8.0
 public enum OpacityRawTokens {
 
     // ଘ( ･ω･)_/ﾟ･:*:･｡☆

OUDS/Core/Tokens/RawTokens/Sources/Declarations/OpacityRawTokens.swift

@@ -40,6 +40,7 @@ import SwiftUI
 ///         // It is recommended to use the higher level version as it is less error-prone.
 /// ```
 ///
+/// - Since: 0.8.0
 public final class MultipleColorSemanticTokens: NSObject, Sendable {
 
     /// For **light** mode scheme

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleColorSemanticTokens.swift

@@ -48,6 +48,8 @@ import SwiftUI
 /// The case of this `MultipleElevationCompositeRawTokens` is quite particular because in fact it contains `MultipleElevationCompositeRawTokens` (i.e. raw tokens) instead of semantic tokens.
 /// In fact only the *color* of the elevation effect vary depending to the color scheme,
 /// but in the *Figma* kit this is composite raw tokens which are defined for ligh and dark mode as only one token.
+///
+/// - Since: 0.8.0
 public final class MultipleElevationCompositeRawTokens: NSObject, Sendable {
 
     /// For **light** mode scheme

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleElevationCompositeRawTokens.swift

@@ -43,6 +43,7 @@ import SwiftUICore
 /// (i.e. raw tokens) instead of semantic tokens.
 /// In fact there is not "font composite semantic tokens" defined in the *Figma* kit.
 ///
+/// - Since: 0.8.0
 public final class MultipleFontCompositeRawTokens: NSObject, Sendable {
 
     /// For **extra-compact** and **compact** viewports

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleFontCompositeRawTokens.swift

@@ -42,7 +42,8 @@ import OUDSTokensRaw
 ///         // The theme exposes both generated font letter spacing semantic tokens and "crafted" higher level color semantic tokens.
 ///         // It is recommended to use the higher level version as it is less error-prone.
 /// ```
-/// 
+///
+/// - Since: 0.8.0
 public final class MultipleFontLetterSpacingSemanticTokens: NSObject, Sendable {
 
     /// For **extra-compact** and **compact** viewports

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleFontLetterSpacingSemanticTokens.swift

@@ -40,7 +40,8 @@ import OUDSTokensRaw
 ///         // The theme exposes both generated font line height semantic tokens and "crafted" higher level color semantic tokens.
 ///         // It is recommended to use the higher level version as it is less error-prone.
 /// ```
-/// 
+///
+/// - Since: 0.8.0
 public final class MultipleFontLineHeightSemanticTokens: NSObject, Sendable {
 
     /// For **extra-compact** and **compact** viewports

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleFontLineHeightSemanticTokens.swift

@@ -38,7 +38,8 @@ import OUDSTokensRaw
 ///         // The theme exposes both generated font size semantic tokens and "crafted" higher level color semantic tokens.
 ///         // It is recommended to use the higher level version as it is less error-prone.
 /// ```
-/// 
+///
+/// - Since: 0.8.0
 public final class MultipleFontSizeSemanticTokens: NSObject, Sendable {
 
     /// For **extra-compact** and **compact** viewports

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleFontSizeSemanticTokens.swift

@@ -41,7 +41,8 @@ import SwiftUICore
 ///         // The theme exposes both generated font size semantic tokens and "crafted" higher level color semantic tokens.
 ///         // It is recommended to use the higher level version as it is less error-prone.
 /// ```
-/// 
+///
+/// - Since: 0.8.0
 public final class MultipleSizeSemanticTokens: NSObject, Sendable {
 
     /// For **extra-compact** and **compact** viewports

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleSizeSemanticTokens.swift

@@ -40,7 +40,8 @@ import SwiftUICore
 ///         // The theme exposes both generated font space semantic tokens and "crafted" higher level color semantic tokens.
 ///         // It is recommended to use the higher level version as it is less error-prone.
 /// ```
-/// 
+///
+/// - Since: 0.8.0
 public final class MultipleSpaceSemanticTokens: NSObject, Sendable {
 
     /// For **extra-compact** and **compact** viewports

OUDS/Core/Tokens/SemanticTokens/Sources/Multiples/MultipleSpaceSemanticTokens.swift

@@ -20,6 +20,8 @@
 /// This is a group of semantic tokens for **borders**.
 /// It defines all ``BorderWidthSemanticToken``, ``BorderRadiusSemanticToken`` and ``BorderStyleSemanticToken`` a theme must have.
 /// Any border semantic token must be declared there as providers like `OUDSBorderSemanticTokensProvider` will then expose them through `OUDSTheme`.
+///
+/// - Since: 0.8.0
 public protocol BorderSemanticTokens {
 
     // MARK: - Semantic token - Border - Width

OUDS/Core/Tokens/SemanticTokens/Sources/Values/BorderSemanticTokens.swift

@@ -42,7 +42,8 @@
 ///         // Thus users can in their components use colorBgPrimary as defined in their design system
 ///         // (even if they are still able to use 'lower level' semantic tokens but it is more error-prone)
 /// ```
-/// 
+///
+/// - Since: 0.8.0
 public protocol ColorMultipleSemanticTokens {
 
     // MARK: - Color - Opacity - Invisible

OUDS/Core/Tokens/SemanticTokens/Sources/Values/ColorMultipleSemanticTokens.swift

@@ -23,6 +23,8 @@
 /// It defines all ``ColorSemanticToken``  a theme must have.
 /// These tokens are then gathered inside ``MultipleColorSemanticTokens`` defined in ``ColorMultipleSemanticTokens``.
 /// Any color semantic token must be declared there (except ``MultipleColorSemanticTokens``)
+///
+/// - Since: 0.8.0
 public protocol ColorSemanticTokens {
 
     // MARK: - Color - Opacity - Invisible

OUDS/Core/Tokens/SemanticTokens/Sources/Values/ColorSemanticTokens.swift

@@ -40,6 +40,8 @@
 ///         // Or use .light or .dark instead of elevation(for:)
 ///     }
 /// ```
+///
+/// - Since: 0.8.0
 public protocol ElevationCompositeSemanticTokens {
 
     var elevationNone: ElevationCompositeSemanticToken { get }

OUDS/Core/Tokens/SemanticTokens/Sources/Values/ElevationCompositeSemanticTokens.swift

@@ -45,6 +45,7 @@
 ///         // (even if they are still able to use 'lower level' semantic tokens but it is more error-prone)
 /// ```
 ///
+/// - Since: 0.8.0
 public protocol ElevationMultipleSemanticTokens {
 
     var elevationColorDefault: MultipleColorSemanticTokens { get }

OUDS/Core/Tokens/SemanticTokens/Sources/Values/ElevationMultipleSemanticTokens.swift

@@ -24,6 +24,8 @@
 /// However the composite tokens (here for box shadows) are defined in ``ElevationCompositeSemanticTokens`` because the *tokenator*
 /// is not able to generate them yet, and they must be defined elsewhere to not be deleted.
 /// Any elevation semantic token must be declared there (except ``ElevationCompositeSemanticTokens``)
+///
+/// - Since: 0.8.0
 public protocol ElevationSemanticTokens {
 
     // MARK: Semantic token - Elevation - X

OUDS/Core/Tokens/SemanticTokens/Sources/Values/ElevationSemanticTokens.swift

@@ -43,6 +43,8 @@
 ///
 ///      // Etc.
 /// ```
+///
+/// - Since: 0.8.0
 public protocol FontCompositeSemanticTokens {
 
     // MARK: - Semantic tokens - Typography - Composites - Display

OUDS/Core/Tokens/SemanticTokens/Sources/Values/FontCompositeSemanticTokens.swift

@@ -51,6 +51,7 @@
 ///         // (even if they are still able to use 'lower level' semantic tokens but it is more error-prone)
 /// ```
 /// 
+/// - Since: 0.8.0
 public protocol FontMultipleSemanticTokens {
 
     // MARK: - Semantic token - Typography - Font - Size