Version 0.8.0 (#357)

Release of version 0.8.0
See bellow the full CHANGELOG details.

Added:
- [Library] New architecture with tokens provider ([#79](#79))
- [DemoApp] Prepare new architecture to add components illustration ([#328](#328))

Changed:
- [Tool] Update `net-http` gem from 0.5.0 to 0.6.0
- [Tool] Update `SwiftLint` pod from v0.57.0 to v0.57.1
- [Tool] Update `SwiftFormat/CLI` pod from v0.54.6 to v0.55.3
- [Tool] Update `fastlane` gem from v2.225.0 to v2.226.0
- [Library] Update `FontSemanticTokens` (tokenator *20241213075501*)
- [Library] Update `FontSemanticTokens` (tokenator *20241211115813*)
- [Library] Update `FontRawTokens` (tokenator *20241211101443*)
- [Tool] Migrate from `xcode_install` to `xcodes` in Fastfile, freeze Xcode version (16.0)
- [Library] Rename `Typography*` tokens and elements to `Font*` ([#322](#322))
- [Library] Update `ColorSemanticTokens` (tokenator *20241204111709*)
- [Library] Update `SpaceSemanticTokens` (tokenator *20241204110127*)
- [Library] Rename `opacityTransparent` opacity semantic token to `opacityInvisible`
- [Library] Update `OpacitySemanticTokens` and `OpacityRawTokens` tokens (tokenator *20241204110957*)
- [Library] Update `OrangeBrandColorRawTokens` tokens (tokenator *20241204111119*)
- [Library] Update `SizeSemanticTokens` tokens (tokenator *20241204110236*)
- [Library] Rename any `sizeIcon**` size semantic tokens applying "T-shirt sizes" template
- [Library] Update `ElevationSemanticTokens` and `ColorRawTokens` tokens (tokenator *20241204111249*)
- [Library] Rename any `colorTransparent*` color semantic tokens to `colorOpacity*`
- [DemoApp] Reactor UI test to use theme in environment ([#299](#299))

Removed:
- [Library] Font raw tokens `fontFamilyBrandDefault`, `fontFamilyBrandTV`, `fontFamilySystemArial`, `fontFamilySystemHelvetica`, `fontFamilySystemNotoSans`, `fontFamilySystemSFPro`, `fontFamilySystemRoboto`, `fontFamilyMonospaceMonaco`, `fontFamilyMonospaceCourierNew`, `fontFamilySystemArial`
- [Library] Space semantic tokens `*WithIcon*`, `*WithArrow*` 
- [Library] Elevation semantic tokens `elevationBlurOverlayDefault`, `elevationBlurOverlayEmphasized`, `elevationXOverlayDefault`, `elevationXOverlayEmphasized`, `elevationYOverlayDefault`, `elevationYOverlayEmphasized`, `elevationColorOverlayDefaultLight`, `elevationColorOverlayEmphasizedLight`, `elevationColorOverlayDefaultDark`, `elevationColorOverlayEmphasizedDark`

Co-authored-by: Pierre-Yves Lapersonne <pierreyves.lapersonne@orange.com>
Co-authored-by: Ludovic Pinel <ludovic.pinel@orange.com>
Co-authored-by: boosted-bot <boosted-bot@users.noreply.github.com>

.github/AUTHORS.txt

@@ -10,4 +10,4 @@
 
 # Please keep the list sorted.
 
-Orange
+Orange SA

.github/CODEOWNERS

@@ -18,8 +18,8 @@
 
 /.github/ @pylapp
 
-/OUDS/ @pylapp @ludovic35 @Tayebsed93
-/Showcase/ @pylapp @ludovic35 @Tayebsed93
+/OUDS/ @pylapp @ludovic35
+/Showcase/ @pylapp @ludovic35
 
 /docs_release/ @pylapp @ludovic35
 
@@ -33,7 +33,7 @@
 
 .swiftlint.yml @pylapp @ludovic35
 
-CHANGELOG.md @ludovic35 @pylapp @Tayebsed93
+CHANGELOG.md @ludovic35 @pylapp
 
 Gemfile @pylapp @ludovic35
 Gemfile.lock @pylapp @ludovic35

.github/CONTRIBUTING.md

@@ -7,6 +7,10 @@ Please take a moment to review this document in order to make the contribution p
 Following these guidelines helps to communicate that you respect the time of the developers managing and developing this Open Source project.
 In return, they should reciprocate that respect in addressing your issue or assessing patches and features.
 
+You should also have a look on the wiki if you are looking for information about how the project is managed, the releases and tests done, and how to do some actions.
+[The wiki define the way to work anyone must agree](https://github.com/Orange-OpenSource/ouds-ios/wiki).
+[The Code of Conduct](https://github.com/Orange-OpenSource/ouds-ios/blob/develop/.github/CODE_OF_CONDUCT.md) defines how we should interact together.
+
 ## Using the Issue Tracker
 
 The [issue tracker](https://github.com/Orange-OpenSource/ouds-ios/issues) is the preferred channel for [bug reports](#bug-reports), [feature requests](#feature-requests) and [submitting pull requests](#pull-requests), but please respect the following restrictions:
@@ -112,7 +116,7 @@ Adhering to the following process is the best way to get your work included in t
 
 7. [Open a Pull Request](https://help.github.com/articles/about-pull-requests/) with a clear title and description against the `develop` branch.
 
-**IMPORTANT**: By submitting a patch, you agree to allow the project owners to license your work under the terms of the [MIT License](LICENSE).
+**IMPORTANT**: By submitting a patch, you agree to allow the project owners to license your work under the terms of the [MIT License](https://github.com/Orange-OpenSource/ouds-ios/blob/develop/LICENSE).
 
 Note that a ruleset based [on task-list-completed tool](https://github.com/marketplace/task-list-completed) is applied on `develop` branch: if any prerequisites are not futfilled in the pull request ticket the merge won't be done. 
 

.github/DEVELOP.md

@@ -49,6 +49,10 @@ brew install swiftlint
 # For SwiftFormat (at least 0.52.4)
 brew install swiftformat
 # or `brew reinstall swiftformat` to get updates if old version installed
+
+# For xcodes (at least 1.5.0)
+brew install xcodesorg/made/xcodes
+# or `brew reinstall xcodesorg/made/xcodes` to get updates if old version installed
 ```
 
 Ensure you have the suitable _Ruby_ version. We recommend the use of [rbenv](https://github.com/rbenv/rbenv) to load the suitable version of ruby.
@@ -161,7 +165,7 @@ Any interface modifications require regenerating the illustrations using the too
 The snapshot tool fetched the reference image to compare it against the current screen and detected no differences, resulting in a success
 
 5. Run the snapshot test (failure):
-    - We will deliberately change the image by setting the `OpacityOpaque` token to `OpacityTransparent` in class `OpacityTokenPage.swift`
+    - We will deliberately change the image by setting the `OpacityOpaque` token to `OpacityInvisible` in class `OpacityTokenPage.swift`
 
       <img width="561" alt="IntentionalTokenModification" src="https://github.com/user-attachments/assets/1d138b7b-2998-40b7-bf39-d9a597ced6c0">
     - Test result failure :
@@ -300,6 +304,13 @@ chore(🤖): update `OpacityRawTokens` (tokenator generation 20241021134644) (#2
 ``` 
 
 i.e. precise the tokens updated, the *tokenator* generation timestamp and the pull request number.
+If you know what is the design kit revision, add it in the commit body, like:
+
+```text
+chore(🤖): update `OpacityRawTokens` (tokenator generation 20241021134644) (#225)
+
+Design kit token library V.24.12.18
+``` 
 
 ### About release note and changelog
 
@@ -346,7 +357,7 @@ We use _SwiftLint_ in this project so as to be sure the source code follows defi
 You must run _SwiftLint_ in CLI or using _Xcode_ to be sure you don't keep and submit warnings.
 **In most of cases you must fix warnings, or explain why in your commtis and pull request comments you choose to disable them.**
 
-Today, only in very few cases some SwiftLint warnings are disabled:
+Today, only in very few cases some _SwiftLint_ warnings are disabled at files level:
 - in tests classes
 - in files containing tokens which will be generated
 
@@ -362,6 +373,8 @@ The warnings which can be disabled for test classes files and mocks files:
 - *line_length*: because of length of tokens names
 - *file_length*: because of the amount of tokens to test
 - *type_body_length*: because we can have a lot of tests to do
+- *function_body_length*: because we can have function with a lot of assertions
+- *force_try*: because we can need tod efine some configuration variable we are sure they work (like regxp)
 - *required_deinit*: because we do not need to manage init and deinit of test classe
 - *implicitly_unwrapped_optional*: because for declaration of themes to test we bang!
 

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -2,7 +2,7 @@ name: Report a bug
 description: Tell us about a bug or issue you may have identified in OUDS iOS.
 title: "[Bug] "
 labels: ["🐞 bug", "🔍 triage"]
-assignees: ["ludovic35", "pylapp", "Tayebsed93"]
+assignees: ["ludovic35", "pylapp"]
 body:
   - type: checkboxes
     attributes:

.github/ISSUE_TEMPLATE/component_update.yml

@@ -0,0 +1,36 @@
+name: Component Update Request
+description: Please fill out the following details for your component update request.
+title: "[Component Update] "
+labels: ["⚛️ component", "🔍 triage"]
+assignees: ["ludovic35", "pylapp"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe your need in details
+    validations:
+      required: true      
+  - type: textarea
+    id: motivation_context
+    attributes:
+      label: Motivation & Context
+      description: Why is this change required? What problem does it solve?
+  - type: checkboxes
+    attributes:
+      label: Types of change
+      description: Please fill the suitable items in the list
+      options:
+        - label: Add new component
+        - label: Update existing component  
+  - type: checkboxes
+    attributes:
+      label: Checklist for Core Team
+      description: Some points to check before any merge
+      options:
+        - label: Tokens have been updated
+        - label: Documentations have been updated
+        - label: Unit tests have been updated
+        - label: UI tests have been updated
+        - label: Demo app have been updated
+        - label: Retrocompatibility has been checked, or broken API have been flagged as deprecated with a workaround

.github/ISSUE_TEMPLATE/demo_app_update.yml

@@ -0,0 +1,23 @@
+name: Demo App Update Request
+description: Please fill out the following details for your demo app update request.
+title: "[Demo App] "
+labels: ["📱 demo app", "🔍 triage"]
+assignees: ["ludovic35", "pylapp"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe your need in details. Which screens? Which tokens, components or modules?
+    validations:
+      required: true
+  - type: checkboxes
+    attributes:
+      label: Checklist for Core Team
+      description: Some points to check before any merge
+      options:
+        - label: Tokens have been updated (if needed)
+        - label: Documentations have been updated (if needed)
+        - label: Unit tests have been updated and still pass
+        - label: UI tests have been updated and still pass
+        - label: Retrocompatibility has been checked, or broken API have been flagged as deprecated with a workaround

.github/ISSUE_TEMPLATE/documentation-update.yml

@@ -2,7 +2,7 @@ name: Documentation Update
 description: Describe this issue found in the documentation
 title: "[Doc] "
 labels: ["📖 documentation", "🔍 triage"]
-assignees: ["ludovic35", "pylapp", "Tayebsed93"]
+assignees: ["ludovic35", "pylapp"]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -2,7 +2,7 @@ name: Feature Request
 description: Suggest a new Epic to be added to the backlog.
 title: "[Feature] "
 labels: ["feature", "🔍 triage"]
-assignees: ["ludovic35", "pylapp", "Tayebsed93"]
+assignees: ["ludovic35", "pylapp"]
 body:
   - type: checkboxes
     attributes:

.github/ISSUE_TEMPLATE/module_update.yml

@@ -0,0 +1,34 @@
+name: Module Update Request
+description: Please fill out the following details for your module update request.
+title: "[Module Update] "
+labels: ["🎇 module", "🔍 triage"]
+assignees: ["ludovic35", "pylapp"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe your need in details
+    validations:
+      required: true      
+  - type: textarea
+    id: motivation_context
+    attributes:
+      label: Motivation & Context
+      description: Why is this change required? What problem does it solve?
+  - type: checkboxes
+    attributes:
+      label: Types of change
+      description: Please fill the suitable items in the list
+      options:
+        - label: Add new module
+        - label: Update existing module  
+  - type: checkboxes
+    attributes:
+      label: Checklist for Core Team
+      description: Some points to check before any merge
+      options:
+        - label: Documentations have been updated
+        - label: Tests have been updated if needed
+        - label: Demo app has been updated if needed
+        - label: Retrocompatibility has been checked, or broken API have been flagged as deprecated with a workaround

.github/ISSUE_TEMPLATE/token_update.yml

@@ -2,7 +2,7 @@ name: Token Update Request
 description: Please fill out the following details for your token update request.
 title: "[Token Update] "
 labels: ["📀 token", "🔍 triage"]
-assignees: ["ludovic35", "pylapp", "Tayebsed93"]
+assignees: ["ludovic35", "pylapp"]
 body:
   - type: checkboxes
     attributes:

.github/workflows/build-and-test.yml

@@ -109,3 +109,4 @@ jobs:
           cd Showcase
           bundle exec pod install
           bundle exec fastlane test_ui
+        continue-on-error: true # See https://github.com/Orange-OpenSource/ouds-ios/issues/305

CHANGELOG.md

@@ -4,6 +4,41 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.0](https://github.com/Orange-OpenSource/ouds-ios/compare/0.7.0...0.8.0) - 2024-12-18
+
+### Added
+
+- [Library] New architecture with tokens provider ([#79](https://github.com/Orange-OpenSource/ouds-ios/issues/79))
+- [DemoApp] Prepare new architecture to add components illustration ([#328](https://github.com/Orange-OpenSource/ouds-ios/issues/328))
+
+### Changed
+
+- [Tool] Update `net-http` gem from 0.5.0 to 0.6.0
+- [Tool] Update `SwiftLint` pod from v0.57.0 to v0.57.1
+- [Tool] Update `SwiftFormat/CLI` pod from v0.54.6 to v0.55.3
+- [Tool] Update `fastlane` gem from v2.225.0 to v2.226.0
+- [Library] Update `FontSemanticTokens` (tokenator *20241213075501*)
+- [Library] Update `FontSemanticTokens` (tokenator *20241211115813*)
+- [Library] Update `FontRawTokens` (tokenator *20241211101443*)
+- [Tool] Migrate from `xcode_install` to `xcodes` in Fastfile, freeze Xcode version (16.0)
+- [Library] Rename `Typography*` tokens and elements to `Font*` ([#322](https://github.com/Orange-OpenSource/ouds-ios/issues/322))
+- [Library] Update `ColorSemanticTokens` (tokenator *20241204111709*)
+- [Library] Update `SpaceSemanticTokens` (tokenator *20241204110127*)
+- [Library] Rename `opacityTransparent` opacity semantic token to `opacityInvisible`
+- [Library] Update `OpacitySemanticTokens` and `OpacityRawTokens` tokens (tokenator *20241204110957*)
+- [Library] Update `OrangeBrandColorRawTokens` tokens (tokenator *20241204111119*)
+- [Library] Update `SizeSemanticTokens` tokens (tokenator *20241204110236*)
+- [Library] Rename any `sizeIcon**` size semantic tokens applying "T-shirt sizes" template
+- [Library] Update `ElevationSemanticTokens` and `ColorRawTokens` tokens (tokenator *20241204111249*)
+- [Library] Rename any `colorTransparent*` color semantic tokens to `colorOpacity*`
+- [DemoApp] Reactor UI test to use theme in environment ([#299](https://github.com/Orange-OpenSource/ouds-ios/issues/299))
+
+### Removed
+
+- [Library] Font raw tokens `fontFamilyBrandDefault`, `fontFamilyBrandTV`, `fontFamilySystemArial`, `fontFamilySystemHelvetica`, `fontFamilySystemNotoSans`, `fontFamilySystemSFPro`, `fontFamilySystemRoboto`, `fontFamilyMonospaceMonaco`, `fontFamilyMonospaceCourierNew`, `fontFamilySystemArial`
+- [Library] Space semantic tokens `*WithIcon*`, `*WithArrow*` 
+- [Library] Elevation semantic tokens `elevationBlurOverlayDefault`, `elevationBlurOverlayEmphasized`, `elevationXOverlayDefault`, `elevationXOverlayEmphasized`, `elevationYOverlayDefault`, `elevationYOverlayEmphasized`, `elevationColorOverlayDefaultLight`, `elevationColorOverlayEmphasizedLight`, `elevationColorOverlayDefaultDark`, `elevationColorOverlayEmphasizedDark`
+
 ## [0.7.0](https://github.com/Orange-OpenSource/ouds-ios/compare/0.6.0...0.7.0) - 2024-11-29
 
 ### Added
@@ -15,9 +50,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- [DemoApp] Update space tokens screen ([#275](https://github.com/Orange-OpenSource/ouds-ios/issues/275))
+- [Library] Update `BorderRawTokens` and `BorderSemanticTokens` tokens (tokenator *20241204110708*)
 - [Library] Update `GridSemanticTokens` tokens (tokenator *20241129080807*)
 - [Library] Types `GridExtraCompactSemanticToken`, `GridCompactSemanticToken` and `GridRegularSemanticToken` replaced by `GridSemanticToken` to make tokenator updates integration easier 
-- [DemoApp] Update space tokens screen ([#275](https://github.com/Orange-OpenSource/ouds-ios/issues/275))
 - [Library] Update `GridRawTokens` tokens (tokenator *20241128161629*)
 - [DemoApp] Update color tokens screen 
 - [Library] Update `ColorSemanticTokens` tokens (tokenator *20241127112301*)

Gemfile

@@ -14,11 +14,11 @@
 source "https://rubygems.org"
 
 gem 'cocoapods',  '1.16.2'
-gem 'fastlane', '2.225.0'
+gem 'fastlane', '2.226.0'
 gem 'fastlane-plugin-changelog', '0.16.0'
 gem 'fastlane-plugin-mattermost', '1.3.2'
-gem 'json', '2.8.2'
-gem 'net-http', '0.5.0'
+gem 'json', '2.9.0'
+gem 'net-http', '0.6.0'
 gem 'xcode-install', '2.8.1'
 
 plugins_path = File.join(File.dirname(__FILE__), 'Showcase/fastlane', 'Pluginfile')

Gemfile.lock

@@ -128,7 +128,7 @@ GEM
     faraday_middleware (1.2.1)
       faraday (~> 1.0)
     fastimage (2.3.1)
-    fastlane (2.225.0)
+    fastlane (2.226.0)
       CFPropertyList (>= 2.3, < 4.0.0)
       addressable (>= 2.8, < 3.0.0)
       artifactory (~> 3.0)
@@ -168,7 +168,7 @@ GEM
       tty-spinner (>= 0.8.0, < 1.0.0)
       word_wrap (~> 1.0.0)
       xcodeproj (>= 1.13.0, < 2.0.0)
-      xcpretty (~> 0.3.0)
+      xcpretty (~> 0.4.0)
       xcpretty-travis-formatter (>= 0.0.3, < 2.0.0)
     fastlane-plugin-changelog (0.16.0)
     fastlane-plugin-mattermost (1.3.2)
@@ -231,7 +231,7 @@ GEM
     i18n (1.14.6)
       concurrent-ruby (~> 1.0)
     jmespath (1.6.2)
-    json (2.8.2)
+    json (2.9.0)
     jwt (2.9.3)
       base64
     logger (1.6.1)
@@ -244,7 +244,7 @@ GEM
     nanaimo (0.4.0)
     nap (1.1.0)
     naturally (2.2.1)
-    net-http (0.5.0)
+    net-http (0.6.0)
       uri
     netrc (0.11.0)
     nkf (0.2.0)
@@ -259,7 +259,7 @@ GEM
       uber (< 0.2.0)
     retriable (3.1.2)
     rexml (3.3.9)
-    rouge (2.0.7)
+    rouge (3.28.0)
     ruby-macho (2.5.1)
     ruby2_keywords (0.0.5)
     rubyzip (2.3.2)
@@ -300,8 +300,8 @@ GEM
       colored2 (~> 3.1)
       nanaimo (~> 0.4.0)
       rexml (>= 3.3.6, < 4.0)
-    xcpretty (0.3.0)
-      rouge (~> 2.0.7)
+    xcpretty (0.4.0)
+      rouge (~> 3.28.0)
     xcpretty-travis-formatter (1.0.1)
       xcpretty (~> 0.2, >= 0.0.7)
 
@@ -320,11 +320,11 @@ PLATFORMS
 
 DEPENDENCIES
   cocoapods (= 1.16.2)
-  fastlane (= 2.225.0)
+  fastlane (= 2.226.0)
   fastlane-plugin-changelog (= 0.16.0)
   fastlane-plugin-mattermost (= 1.3.2)
-  json (= 2.8.2)
-  net-http (= 0.5.0)
+  json (= 2.9.0)
+  net-http (= 0.6.0)
   xcode-install (= 2.8.1)
 
 BUNDLED WITH