Orange-OpenSource
diff --git a/‎.github/CODEOWNERS
+7-7 b/‎.github/CODEOWNERS
+7-7
diff --git a/‎.github/CONTRIBUTORS.txt
+1 b/‎.github/CONTRIBUTORS.txt
+1
diff --git a/‎.github/DEVELOP.md
+36-2 b/‎.github/DEVELOP.md
+36-2
diff --git a/‎.github/ISSUE_TEMPLATE/bug_report.yml
+1-1 b/‎.github/ISSUE_TEMPLATE/bug_report.yml
+1-1
diff --git a/‎.github/ISSUE_TEMPLATE/documentation-update.yml
+1-1 b/‎.github/ISSUE_TEMPLATE/documentation-update.yml
+1-1
diff --git a/‎.github/ISSUE_TEMPLATE/feature_request.yml
+1-1 b/‎.github/ISSUE_TEMPLATE/feature_request.yml
+1-1
diff --git a/‎.github/ISSUE_TEMPLATE/token_update.yml
+49 b/‎.github/ISSUE_TEMPLATE/token_update.yml
+49
diff --git a/‎.swiftlint.yml
+2 b/‎.swiftlint.yml
+2
diff --git a/‎CHANGELOG.md
+53 b/‎CHANGELOG.md
+53
diff --git a/‎Gemfile
+1-1 b/‎Gemfile
+1-1
@@ -17,15 +17,15 @@ AUTHORS.txt @pylapp
 CONTRIBUTORS.txt @pylapp
 LICENSE @pylapp
 
-README.md @ludovic35 @pylapp
-CHANGELOG.md @ludovic35 @pylapp
+README.md @ludovic35 @pylapp @Tayebsed93
+CHANGELOG.md @ludovic35 @pylapp @Tayebsed93
 DEVELOP.md @ludovic35 @pylapp
 CONTRIBUTING.md @ludovic35 @pylapp
-THIRD-PARTY.md @ludovic35 @pylapp
-NOTICE.txt @ludovic35 @pylapp
+THIRD-PARTY.md @pylapp
+NOTICE.txt @pylapp
 
 # Project
 
-/.github/ @pylapp @ludovic35
-/Showcase/ @pylapp @ludovic35
-/OUDS/ @pylapp @ludovic35
+/.github/ @pylapp
+/Showcase/ @pylapp @ludovic35 @Tayebsed93
+/OUDS/ @pylapp @ludovic35 @Tayebsed93
@@ -23,3 +23,4 @@
 Julien DERAMOND <[email protected]>
 Pierre-Yves LAPERSONNE <[email protected]>
 Ludovic PINEL <[email protected]>
+Tayeb SEDRAIA <[email protected]>
@@ -21,7 +21,8 @@
 ## Technical preconditions
 
 You should check wether or not you have the tools in use in the project like _Fastlane_, _SwiftLint_, _SwiftFormat_, etc.
-You can have a look for example in thr **THIRD\_PARTY.md** file which lists any dependencies and tools we use are different levels (SDK, showcase app, projects).
+You can have a look for example in the **THIRD\_PARTY.md** file which lists any dependencies and tools we use are different levels (SDK, showcase app, projects).
+Have a look on the lociks file to know which versions we are using (*Podfile*, *Podfile.lock*, *Packages.swift*, *Package.resolved*, *Gemfile*, *Gemfile.lock*).
 
 If some tools are missing, pick the suitable command line below:
 ```bash
@@ -38,7 +39,23 @@ brew install peripheryapp/periphery/periphery
 brew install gitleaks
 ```
 
+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.
+We use here _Ruby 3_ (3.1.x).
+If you are not used to this tool:
+
+```shell
+# List available local version of Ruby
+rbenv install --list
+
+# Apply the 3.1.2 version of Ruby (if listed previously)
+rbenv global 3.1.2
+
+# Check Ruby version
+ruby --version
+```
+
 We use also for our GitLab CI runners **Xcode 15.3**, we suggest you use this version or newer if you want but beware.
+**Xcode 16** use will come.
 
 ## Build showcase demo app
 
@@ -147,10 +164,27 @@ A [GitHub Action bot](https://probot.github.io/apps/dco/) has been plugged in th
 ### About commits
 
 Try as best as possible to apply [conventional commits rules](https://www.conventionalcommits.org/en/v1.0.0/).
-Keep in mind to have your commits well prefixed, and with the issue number between parenthesis at the end.
+Keep in mind to have your commits well prefixed, and with the issue number between parenthesis at the end, and also if needed the pull request issue number.
 If your commits embed contributions for other people, do not forget to [add them as co-authors](https://docs.github.com/fr/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors).
 All of you should also comply to DCO.
 
+You commit message should be prefixed by keywords [you can find in the specification](https://www.conventionalcommits.org/en/v1.0.0/#specification):
+- fix:
+- feat:
+- build:
+- chore:
+- ci:
+- docs:
+- style:
+- refactor:
+- perf:
+- test:
+
+You can add also ! aftter the keyword to say a breaking change occur, and also add a scope between parenthesis like:
+- feat!: breaking change because..
+- feat(API)!: breaking change in the API because..
+- feat: add something in the API...
+
 For example, given a commit to fix the issue n°42, the commit should be like:
 
 ```text
 
@@ -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]: Bug Summary"
 labels: ["🐞 bug", "🔍 triage"]
-assignees: ["ludovic35", "pylapp"]
+assignees: ["ludovic35", "pylapp", "Tayebsed93"]
 body:
   - type: checkboxes
     attributes:
 
@@ -2,7 +2,7 @@ name: Documentation Update
 description: Describe this issue found in the documentation
 title: "[Doc]: "
 labels: ["📖 documentation", "🔍 triage"]
-assignees: ["ludovic35", "pylapp"]
+assignees: ["ludovic35", "pylapp", "Tayebsed93"]
 body:
   - type: markdown
     attributes:
 
@@ -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"]
+assignees: ["ludovic35", "pylapp", "Tayebsed93"]
 body:
   - type: checkboxes
     attributes:
 
@@ -0,0 +1,49 @@
+name: Token Update Request
+description: Please fill out the following details for your token update request.
+title: "[Token Update] - Title"
+labels: ["📀 token", "🔍 triage"]
+assignees: ["ludovic35", "pylapp", "Tayebsed93"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### Type of tokens
+        Please fill the checkboxes of the token type you want to update:
+        - [ ] Raw token (i.e. associated to _SwiftUI_ or _Swift_ value)
+        - [ ] Semantic token (i.e. pointing to a raw token)
+        - [ ] Component token (i.e. pointing to a semantic token, used for a component)
+    validations:
+      required: true        
+  - 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?
+    validations:
+      required: true      
+  - type: markdown
+    attributes:
+      value: |
+        ### Types of change
+        Please fill the suitable items in the list:
+        - [ ] Add new tokens
+        - [ ] Update existing tokens (i.e. change name or value)
+        - [ ] Remove existing token
+    validations:
+      required: true        
+  - type: markdown
+    attributes:
+      value: |
+        ### Checklist for Core Team
+        - [ ] Tokens have been updated
+        - [ ] Documentation have been updated
+        - [ ] Unit tests have been updated
+        - [ ] Retrocompatibility has been checked, or broken API have been flagged as deprecated without a workaround
+
@@ -31,6 +31,8 @@ excluded:
 - Showcase/Pods
 - Showcase/DerivedData
 
+strict: true
+
 # ==============
 # Disabled rules
 # ==============
 
@@ -4,6 +4,59 @@ 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.3.0](https://github.com/Orange-OpenSource/ouds-ios/compare/0.2.0...0.3.0) - 2024-10-04
+
+### Added
+
+- [Library] Add color semantic tokens `colorBackgroundStatusNeutral`, some `OnBackgroundEmphasized`, `colorBackgroundAction`, `colorBackgroundAlways`, `colorContent` variants
+- [Library] Add typography semantic tokens for font letter spacing
+- [DemoApp] Create token section (Border, Typography, Elevation, Opacity) ([#120](https://github.com/Orange-OpenSource/ouds-ios/issues/120))
+- [Library] Unit tests for multiple tokens
+- [Library] Add color semantic composite tokens embeding light and dark modes values
+- [Library] Add spacing semantic tokens "huge" and "jumbo"
+- [Library] Add closed "sys" dimension semantic tokens
+- [Tool] GitHub issue template for tokens update request
+- [Library] Add more sizing semantic tokens ([#122](https://github.com/Orange-OpenSource/ouds-ios/issues/122))
+- [Library] Add letter spacing and more font family tokens for typography ([#51](https://github.com/Orange-OpenSource/ouds-ios/issues/51))
+
+### Changed
+
+- [Library] Rename and move color raw tokens for core, Orange brand and Sosh brand
+- [Library] Remove web-specific grid tokens, keep compact/regular widths ([#147](https://github.com/Orange-OpenSource/ouds-ios/pull/147))
+- [Library] Rename of typography font weight raw tokens
+- [Library] Rename dimension semantic tokens to apply T-Shirt size rules ([#130](https://github.com/Orange-OpenSource/ouds-ios/issues/130))
+- [Library] Rename `SizingCompositeSemanticToken` to `MultipleSizingSemanticToken` to keep "composite" word for *Figma* design system
+- [Library] Rename `ColorCompositeSemanticToken` to `MultipleColorRawToken` to keep "composite" word for *Figma* design system
+- [Library] Rename `TypographyCompositeSemanticToken` to `MultipleTypographyTokens` to keep "composite" word for *Figma* design system
+- [Library] Rename `SpacingCompositeSemanticToken` to `MultipleSpacingTokens` to keep "composite" word for *Figma* design system
+- [Library] Rename `SizingCompositeSemanticToken` to `MultipleSizingTokens` to keep "composite" word for *Figma* design system
+- [Library] Rename `ColorCompositeSemanticToken` to `MultipleColorTokens` to keep "composite" word for *Figma* design system
+- [Library] Elevation colors have been merged into "multiple" objects colors to have less variables and manage color schemes
+- [Library] Rename `ColorCompositeSemanticToken` to `MultipleColorSemanticToken` to keep "composite" word for *Figma* design system
+- [Library] Elevation colors have been merged into composite colors to have less variables and manage color schemes
+- [Library] Rename `SpacingCompositeSemanticToken` to `MultipleSpacingTokens` to keep "composite" word for *Figma* design system
+- [Library] Rename `SizingCompositeSemanticToken` to `MultipleSizingTokens` to keep "composite" word for *Figma* design system
+- [Library] Rename `ColorCompositeSemanticToken` to `MultipleColorTokens` to keep "composite" word for *Figma* design system
+- [Library] Elevation colors have been merged into "multiple" objects colors to have less variables and manage color schemes
+- [Library] Update color semantic tokens to better manage light and dark modes values
+- [Library] Update elevation colors focus light and dark
+- [Library] Rename space padding inline component tokens by removing "component" word
+- [Library] Improve documentation about raw and semantic tokens definitions ([#127](https://github.com/Orange-OpenSource/ouds-ios/issues/127))
+- [Library] Improve documentation about raw tokens definitions
+- [Library] Move composite tokens elsewhere to help parser ([#129](https://github.com/Orange-OpenSource/ouds-ios/issues/129))
+- [Library] Improve documentation about raw and semantic tokens definitions ([#127](https://github.com/Orange-OpenSource/ouds-ios/issues/127))
+- [Library] Rename some sizing semantic tokens ([#122](https://github.com/Orange-OpenSource/ouds-ios/issues/122))
+- [Library] Replace "adaptable" word by "scaled" in space semantic tokens, "fix" by "fixed" and remove "layout" ([#117](https://github.com/Orange-OpenSource/ouds-ios/issues/117))
+
+### Removed
+
+- [Library] Color semantic token `colorBackgroundEmphasizedSecondary`, `colorOnBackground` variants
+- [Library] Remove raw tokens `elevationZIndex` ([#119](https://github.com/Orange-OpenSource/ouds-ios/issues/119))
+
+### Fixed
+
+- [Library] Blur values for elevation composite raw tokens
+
 ## [0.2.0](https://github.com/Orange-OpenSource/ouds-ios/compare/0.1.0...0.2.0) - 2024-09-19
 
 ### Added
 
@@ -14,7 +14,7 @@
 source "https://rubygems.org"
 
 gem 'cocoapods',  '1.15.2'
-gem 'fastlane', '2.222.0'
+gem 'fastlane', '2.223.1'
 gem 'fastlane-plugin-changelog', '0.16.0'
 gem 'fastlane-plugin-mattermost', '1.3.2'
 gem 'json', '2.7.2'