Rename ouds-prefixed public methods and OUDSButtonStyle to StyleForButton

Agent-Logs-Url: https://github.com/Orange-OpenSource/ouds-ios/sessions/1e08d090-da57-4d99-bb37-f7e5698a17ce

Co-authored-by: pylapp <7559007+pylapp@users.noreply.github.com>

Author: Copilot

AGENTS.md

@@ -175,28 +175,35 @@ the dedicated OUDS view modifier with the same name as the typography, i.e. `bod
 #### Background and foreground color
 
 OUDS framework provides a SwiftUI view modifier to apply foreground color (using a token).
-For example if a user want to apply in foreground the color `theme.colors.contentDefault`, he must not use the `foregroundColor()` method from SwiftUI but instead
-the dedicated OUDS view modifier `oudsForegroundColor(color)`.
+For example if a user want to apply in foreground the color `theme.colors.contentDefault`, use
+the dedicated OUDS overload of `foregroundColor(_:)` passing a `MultipleColorSemanticToken`:
+```swift
+.foregroundColor(theme.colors.contentDefault)
+```
 
-The logic is the same for `backgroundColor` which must be replaced by `oudsBackground(color)`.
+The logic is the same for background color which must use the dedicated OUDS overload of `background(_:)`:
+```swift
+.background(theme.colors.bgPrimary)
+```
 
 #### Add border
 
-Border can be defined using the OUDS view modifier `oudsBorder(style:width:radius:color)` with tokens in parameters like:
+Border can be defined using the OUDS overload of `border(style:width:radius:color:)` with tokens in parameters like:
 ```swift
-.oudsBorder(style: theme.borders.styleDefault,
-            width: theme.borders.widthThin,
-            radius: theme.borders.radiusMedium,
-            color: theme.colors.actionEnabled)
+.border(style: theme.borders.styleDefault,
+        width: theme.borders.widthThin,
+        radius: theme.borders.radiusMedium,
+        color: theme.colors.actionEnabled)
 ```
 
 #### Add shadow / elevation effect
 
-Elevations effets or box shadows can be applied to view with a dedicated view modifier `oudsShadow(elevation)` with an elevation token like:
+Elevations effets or box shadows can be applied to view with the dedicated OUDS overload of `shadow(_:)` with an elevation token like:
 ```swift
-.oudsShadow(theme.elevations.emphasized)
+.shadow(theme.elevations.emphasized)
 ```
 
+
 ### 3.8 Use components
 
 #### Actions

CHANGELOG.md

@@ -6,6 +6,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased](https://github.com/Orange-OpenSource/ouds-ios/compare/1.3.0...develop)
 
+### Added
+
+- New unprefixed `View` extension methods as non-deprecated alternatives to the deprecated `ouds`-prefixed ones (Orange-OpenSource/ouds-ios#1352)
+
+### Changed
+
+- Rename internal `OUDSButtonStyle` to `StyleForButton` (Orange-OpenSource/ouds-ios#1352)
+
+### Deprecated
+
+- `View.oudsForegroundStyle(_:)` replaced by `View.foregroundStyle(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsForegroundColor(_:)` replaced by `View.foregroundColor(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsBackground(_:)` replaced by `View.background(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsAccentColor(_:)` replaced by `View.accentColor(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsShadow(_:)` replaced by `View.shadow(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsBorder(style:width:radius:color:)` replaced by `View.border(style:width:radius:color:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsColoredSurface(_:)` replaced by `View.coloredSurface(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsGridMargin(_:)` replaced by `View.gridMargin(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsRequestAccessibleFocus(_:)` replaced by `View.requestAccessibleFocus(_:)` (Orange-OpenSource/ouds-ios#1352)
+- `View.oudsRequestAccessibleFocus(_:for:)` replaced by `View.requestAccessibleFocus(_:for:)` (Orange-OpenSource/ouds-ios#1352)
+- `Divider.oudsHorizontalDivider(dividerColor:)` replaced by `Divider.horizontalDivider(dividerColor:)` (Orange-OpenSource/ouds-ios#1352)
+- `Divider.oudsVerticalDivider(color:)` replaced by `Divider.verticalDivider(color:)` (Orange-OpenSource/ouds-ios#1352)
+
 ## [1.3.0](https://github.com/Orange-OpenSource/ouds-ios/compare/1.2.0...1.3.0) - 2026-03-26
 
 ### Added

MIGRATION.md

@@ -1,10 +1,86 @@
 # Migration Guide
 
+- [v1.3.0 → v1.4.0](#v130--v140)
 - [v1.2.0 → v1.3.0](#v120--v130)
 - [v1.1.0 → v1.2.0](#v110--v120)
 - [v1.0.0 → v1.1.0](#v100--v110)
 - [Support](#support)
 
+## v1.3.0 → v1.4.0
+
+### Overview
+
+Some public `View` extension methods prefixed with `ouds` have been renamed to remove the prefix, aligning with the naming style of typography helpers.
+The old methods are deprecated and will be removed in a future version.
+The internal `OUDSButtonStyle` struct has been renamed to `StyleForButton`.
+
+### Before You Begin
+
+#### Prerequisites
+
+- Use version 1.3 or older
+
+### Deprecated API
+
+#### 1. Renamed `View` extension methods (deprecated, not removed)
+
+The following `View` extension methods have been deprecated in favor of unprefixed versions.
+The old methods still compile with a deprecation warning.
+
+**Impact**: Low
+
+| Deprecated | Replacement |
+|---|---|
+| `.oudsForegroundStyle(_:)` | `.foregroundStyle(_:)` |
+| `.oudsForegroundColor(_:)` | `.foregroundColor(_:)` |
+| `.oudsBackground(_:)` | `.background(_:)` |
+| `.oudsAccentColor(_:)` | `.accentColor(_:)` |
+| `.oudsShadow(_:)` | `.shadow(_:)` |
+| `.oudsBorder(style:width:radius:color:)` | `.border(style:width:radius:color:)` |
+| `.oudsColoredSurface(_:)` | `.coloredSurface(_:)` |
+| `.oudsGridMargin(_:)` | `.gridMargin(_:)` |
+| `.oudsRequestAccessibleFocus(_:)` | `.requestAccessibleFocus(_:)` |
+| `.oudsRequestAccessibleFocus(_:for:)` | `.requestAccessibleFocus(_:for:)` |
+| `.oudsHorizontalDivider(dividerColor:)` | `.horizontalDivider(dividerColor:)` |
+| `.oudsVerticalDivider(color:)` | `.verticalDivider(color:)` |
+
+**Before (v1.3.x)**:
+```swift
+Text("Hello")
+    .oudsForegroundColor(theme.colors.contentDefault)
+    .oudsBackground(theme.colors.bgPrimary)
+
+SomeView()
+    .oudsBorder(style: theme.borders.styleDefault,
+                width: theme.borders.widthThin,
+                radius: theme.borders.radiusMedium,
+                color: theme.colors.borderDefault)
+    .oudsShadow(theme.elevations.emphasized)
+```
+
+**After (v1.4.0)**:
+```swift
+Text("Hello")
+    .foregroundColor(theme.colors.contentDefault)
+    .background(theme.colors.bgPrimary)
+
+SomeView()
+    .border(style: theme.borders.styleDefault,
+            width: theme.borders.widthThin,
+            radius: theme.borders.radiusMedium,
+            color: theme.colors.borderDefault)
+    .shadow(theme.elevations.emphasized)
+```
+
+**Required Action**:
+- Replace deprecated `ouds`-prefixed calls with their unprefixed counterparts
+
+**Reason for Change**: User feedback indicated the `ouds` prefix on methods was redundant and verbose given that parameter types are strongly typed OUDS tokens which prevent any ambiguity with native SwiftUI overloads.
+
+#### 2. Rename of internal `OUDSButtonStyle` to `StyleForButton`
+
+**Impact**: None (internal type, not exposed in the public API)
+
 ## v1.2.0 → v1.3.0
 
 ### Overview

OUDS/Core/Components/Sources/Actions/Button/Internal/ButtonStyle+BackgroundModifier.swift

@@ -31,7 +31,7 @@ struct ButtonBackgroundModifier: ViewModifier {
 
     func body(content: Content) -> some View {
         if let appliedColor {
-            content.oudsBackground(appliedColor)
+            content.background(appliedColor)
         } else {
             content
         }

OUDS/Core/Components/Sources/Actions/Button/Internal/ButtonStyle+BorderModifier.swift

@@ -36,15 +36,15 @@ struct ButtonBorderModifier: ViewModifier {
         switch appearance {
         case .default:
             content
-                .oudsBorder(
+                .border(
                     style: theme.borders.styleDefault,
                     width: defaultWidth,
                     radius: radius,
                     color: defaultColor)
         case .strong:
             if onColoredSurface {
                 content
-                    .oudsBorder(
+                    .border(
                         style: theme.borders.styleDefault,
                         width: defaultWidth,
                         radius: radius,

OUDS/Core/Components/Sources/Actions/Button/Internal/ButtonStyle.swift

@@ -32,7 +32,7 @@ import SwiftUI
 /// - **normal**: is the normal state of a button which can be disabled, pressed, hovered or normal (i.e. enabled)
 /// - **loading**: the style used after button was clicked and probably data are requested before navigate to a next screen or get updated data.
 ///
-struct OUDSButtonStyle: ButtonStyle {
+struct StyleForButton: ButtonStyle {
 
     // MARK: Stored Properties
 
@@ -45,7 +45,7 @@ struct OUDSButtonStyle: ButtonStyle {
 
     // MARK: Initializer
 
-    /// Initialize the `OUDSButtonStyle` for the `appearance`
+    /// Initialize the `StyleForButton` for the `appearance`
     /// and the `style` of the `OUDSButton`.
     ///
     /// - Parameters:

OUDS/Core/Components/Sources/Actions/Button/OUDSButton.swift

@@ -268,7 +268,7 @@ public struct OUDSButton: View {
                 ButtonTextAndIcon(text: text, icon: icon, flipIcon: flipped)
             }
         }
-        .buttonStyle(OUDSButtonStyle(appearance: appearance, style: style, isHover: isHover, isFullWidth: isFullWidth))
+        .buttonStyle(StyleForButton(appearance: appearance, style: style, isHover: isHover, isFullWidth: isFullWidth))
         .disabled(style == .loading)
         .accessibilityLabel(accessibilityLabel)
         #if !os(watchOS) && !os(tvOS)

OUDS/Core/Components/Sources/ContentDisplay/BulletList/Internal/Bullet.swift

@@ -96,7 +96,7 @@ struct UnorderedBullet: View {
 
     var body: some View {
         ScaledIcon(icon: image.renderingMode(.template), size: assetSize)
-            .oudsForegroundColor(color)
+            .foregroundColor(color)
     }
 
     // MARK: Private helpers

OUDS/Core/Components/Sources/Controls/Checkbox/Internal/CheckboxBackgroundColorModifier.swift

@@ -30,10 +30,10 @@ struct CheckboxBackgroundColorModifier: ViewModifier {
         case .enabled, .disabled, .readOnly:
             content
         case .hover:
-            content.oudsBackground(theme.controlItem.colorBgHover)
+            content.background(theme.controlItem.colorBgHover)
                 .clipShape(RoundedRectangle(cornerRadius: theme.controlItem.borderRadiusItemOnly))
         case .pressed:
-            content.oudsBackground(theme.controlItem.colorBgPressed)
+            content.background(theme.controlItem.colorBgPressed)
                 .clipShape(RoundedRectangle(cornerRadius: theme.controlItem.borderRadiusItemOnly))
         }
     }

OUDS/Core/Components/Sources/Controls/Checkbox/Internal/CheckboxIndicator.swift

@@ -59,7 +59,7 @@ struct CheckboxIndicator: View {
             .renderingMode(.template)
             .scaledToFit()
             .accessibilityHidden(true)
-            .oudsForegroundColor(appliedColor)
+            .foregroundColor(appliedColor)
     }
 
     private var appliedColor: MultipleColorSemanticToken {