feat: 🎸 [HCPSDKFIORIUIKIT-2957]Implement a generic AlphaNumeric

Apps/Examples/Examples.xcodeproj/project.pbxproj

@@ -46,6 +46,7 @@
 		64905D092C7693970062AAD4 /* DateTimePickerExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 64905D082C7693970062AAD4 /* DateTimePickerExample.swift */; };
 		649C7F482CE531C8007B78A7 /* ProgressIndicatorExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 649C7F472CE531C5007B78A7 /* ProgressIndicatorExample.swift */; };
 		64A3FF012D12527F00992B24 /* DimensionSelectorExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 64A3FF002D12527B00992B24 /* DimensionSelectorExample.swift */; };
+		684E21D32E4D7921001823E2 /* TextInputExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 684E21D22E4D7921001823E2 /* TextInputExample.swift */; };
 		691DE21925F2A30B00094D4A /* KPIItemExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 691DE21825F2A30B00094D4A /* KPIItemExample.swift */; };
 		692F338B26556A6A009B98DA /* SideBarExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 692F338A26556A6A009B98DA /* SideBarExample.swift */; };
 		69B2B5D9268A333C009AC6B3 /* KPIProgressViewExample.swift in Sources */ = {isa = PBXBuildFile; fileRef = 69B2B5D8268A333C009AC6B3 /* KPIProgressViewExample.swift */; };
@@ -320,6 +321,7 @@
 		64905D082C7693970062AAD4 /* DateTimePickerExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DateTimePickerExample.swift; sourceTree = "<group>"; };
 		649C7F472CE531C5007B78A7 /* ProgressIndicatorExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ProgressIndicatorExample.swift; sourceTree = "<group>"; };
 		64A3FF002D12527B00992B24 /* DimensionSelectorExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DimensionSelectorExample.swift; sourceTree = "<group>"; };
+		684E21D22E4D7921001823E2 /* TextInputExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = TextInputExample.swift; sourceTree = "<group>"; };
 		691DE21825F2A30B00094D4A /* KPIItemExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = KPIItemExample.swift; sourceTree = "<group>"; };
 		692F338A26556A6A009B98DA /* SideBarExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SideBarExample.swift; sourceTree = "<group>"; };
 		69B2B5D8268A333C009AC6B3 /* KPIProgressViewExample.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = KPIProgressViewExample.swift; sourceTree = "<group>"; };
@@ -671,6 +673,14 @@
 			path = AIUserFeedback;
 			sourceTree = "<group>";
 		};
+		684E21D12E4D78D5001823E2 /* TextInput */ = {
+			isa = PBXGroup;
+			children = (
+				684E21D22E4D7921001823E2 /* TextInputExample.swift */,
+			);
+			path = TextInput;
+			sourceTree = "<group>";
+		};
 		691DE21725F2A2F000094D4A /* KPI */ = {
 			isa = PBXGroup;
 			children = (
@@ -846,6 +856,7 @@
 		8A5579C824C1293C0098003A /* FioriSwiftUICore */ = {
 			isa = PBXGroup;
 			children = (
+				684E21D12E4D78D5001823E2 /* TextInput */,
 				5A80A5EE2DE706B700950E40 /* AIUserFeedback */,
 				B163CD842DE54B9A00B011D8 /* WritingAssistant */,
 				87F70A662DDB9EC700B683B4 /* BarcodeScanner */,
@@ -1524,6 +1535,7 @@
 				6D6E86252C50D42000EDB6F4 /* FioriButtonInListExample.swift in Sources */,
 				B8D4377125F983730024EE7D /* ObjectCell_Rules_Alignment.swift in Sources */,
 				A65FB3BF2DE464A000930093 /* CurrencyInputExample.swift in Sources */,
+				684E21D32E4D7921001823E2 /* TextInputExample.swift in Sources */,
 				8A5579D524C1293C0098003A /* SettingsSeries.swift in Sources */,
 				6432FFA02C5164F8008ECE89 /* SegmentedControlExample.swift in Sources */,
 				9DEC27B52C3F3DB30070B571 /* KeyValueItemExample.swift in Sources */,

Apps/Examples/Examples/FioriSwiftUICore/CoreContentView.swift

@@ -61,6 +61,7 @@ struct CoreContentView: View {
             MenuItem(title: "SectionHeader/Footer Example", section: "Headers", destination: SectionHeaderFooterExample()),
 
             // Controls
+            MenuItem(title: "Format Text Input", section: "Controls", destination: TextInputExample()),
             MenuItem(title: "Customized TabView", section: "Controls", destination: TabViewExample()),
             MenuItem(title: "Customized Toolbar", section: "Controls", destination: ToolbarExample()),
             MenuItem(title: "Dimension Selector", section: "Controls", destination: DimensionSelectorExample()),

Apps/Examples/Examples/FioriSwiftUICore/TextInput/TextInputExample.swift

@@ -0,0 +1,124 @@
+import FioriSwiftUICore
+import SwiftUI
+
+struct TextInputExample: View {
+    @State var showsCharCount = true
+    @State var allowsBeyondLimit = true
+
+    @State private var phoneNumber: String = ""
+    @State private var price: String = ""
+    @State private var numeric: String = ""
+    @State private var date: String = ""
+    @State private var genericText: String = ""
+    @State private var genericText2: String = ""
+
+    @State private var valueText: String = ""
+
+    // the below ids used to scroll to related items
+    private var phoneNumberId = UUID()
+    private var priceId = UUID()
+    private var numericId = UUID()
+    private var dateId = UUID()
+    private var genericTextId = UUID()
+    private var genericText2Id = UUID()
+    private var valueTextId = UUID()
+
+    var body: some View {
+        ScrollViewReader { _ in
+            List {
+                Section {
+                    TextFieldFormView(title: "Phone Number", text: self.$phoneNumber, formatter: self.phoneNumberFormatter, placeholder: "(123) 456-7890", errorMessage: AttributedString(""), maxTextLength: 13, hintText: AttributedString("(###) ###-####"), isCharCountEnabled: self.showsCharCount, allowsBeyondLimit: self.allowsBeyondLimit, isRequired: false, actionIcon: nil, action: nil)
+                        .id(self.phoneNumberId)
+                } header: {
+                    Text("Phone Number Formatter - Text field form view")
+                        .font(.fiori(forTextStyle: .subheadline))
+                        .foregroundStyle(Color.preferredColor(.secondaryLabel))
+                }
+                Section {
+                    TextFieldFormView(title: "Price", text: self.$price, formatter: self.priceFormatter, placeholder: "$ 0.00", errorMessage: AttributedString(""), hintText: AttributedString(""), isCharCountEnabled: self.showsCharCount, allowsBeyondLimit: self.allowsBeyondLimit, isRequired: false, actionIcon: nil, action: nil)
+                        .id(self.priceId)
+
+                    TextFieldFormView(title: "Number", text: self.$numeric, formatter: self.numberFormatter, placeholder: "1.234lbs", errorMessage: AttributedString(""), hintText: AttributedString(""), isCharCountEnabled: self.showsCharCount, allowsBeyondLimit: self.allowsBeyondLimit, isRequired: false, actionIcon: nil, action: nil)
+                        .id(self.numericId)
+                } header: {
+                    Text("Custom Number Formatter - Text field form view")
+                        .font(.fiori(forTextStyle: .subheadline))
+                        .foregroundStyle(Color.preferredColor(.secondaryLabel))
+                }
+                Section {
+                    TextFieldFormView(title: "Date", text: self.$date, formatter: self.dateFormatter, placeholder: "AA 2025/01/01", errorMessage: AttributedString(""), maxTextLength: 13, hintText: AttributedString("AA YYYY/MM/DD"), isCharCountEnabled: self.showsCharCount, allowsBeyondLimit: self.allowsBeyondLimit, isRequired: false, actionIcon: nil, action: nil)
+                        .id(self.dateId)
+
+                    TextFieldFormView(title: "Generic Text", text: self.$genericText, formatter: self.genericTextFormatter, placeholder: "+AA 123 456# a 2025/01/01 A*", errorMessage: AttributedString(""), maxTextLength: 28, hintText: AttributedString("+AA NNN NNNS X YYYY/MM/DD A*"), isCharCountEnabled: self.showsCharCount, allowsBeyondLimit: self.allowsBeyondLimit, isRequired: false, actionIcon: nil, action: nil)
+                        .id(self.genericTextId)
+
+                    TextFieldFormView(title: "Generic Text2", text: self.$genericText2, formatter: self.genericText2Formatter, placeholder: "123+A* 456 789 A*", errorMessage: AttributedString(""), maxTextLength: 18, hintText: AttributedString("NNN+A* NNN NNN A*"), isCharCountEnabled: self.showsCharCount, allowsBeyondLimit: self.allowsBeyondLimit, isRequired: false, actionIcon: nil, action: nil)
+                        .id(self.genericText2Id)
+
+                } header: {
+                    Text("Generic Text Formatter - Text field form view")
+                        .font(.fiori(forTextStyle: .subheadline))
+                        .foregroundStyle(Color.preferredColor(.secondaryLabel))
+                }
+                Section {
+                    TitleFormView(text: self.$valueText, formatter: self.genericTextFormatter, placeholder: "+AA 123 456# a 2025/01/01 A*", hintText: AttributedString("+AA NNN NNNS X YYYY/MM/DD A*"), isCharCountEnabled: self.showsCharCount, allowsBeyondLimit: self.allowsBeyondLimit)
+                        .padding(.leading, -4)
+                        .padding(.trailing, -4)
+                        .id(self.valueTextId)
+                } header: {
+                    Text("Generic Text Formatter - Title form view")
+                        .font(.fiori(forTextStyle: .subheadline))
+                        .foregroundStyle(Color.preferredColor(.secondaryLabel))
+                }
+                .listRowSeparator(.hidden, edges: .bottom)
+                .environment(\.defaultMinListRowHeight, 0)
+                .environment(\.defaultMinListHeaderHeight, 0)
+            }
+        }
+    }
+
+    var phoneNumberFormatter: PhoneNumberFormatter {
+        let formatter = PhoneNumberFormatter()
+        return formatter
+    }
+
+    var priceFormatter: CustomNumberFormatter {
+        let formatter = CustomNumberFormatter()
+        formatter.numberStyle = .currency
+        return formatter
+    }
+
+    var numberFormatter: CustomNumberFormatter {
+        let formatter = CustomNumberFormatter()
+        formatter.numberStyle = .decimal
+        formatter.maximumFractionDigits = 3
+        formatter.positiveSuffix = "lbs"
+        return formatter
+    }
+
+    var dateFormatter: GenericTextFormatter {
+        let formatter = GenericTextFormatter()
+        formatter.format = "AA YYYY/MM/DD"
+        formatter.yearMinium = 1000
+        formatter.yearMaximum = 3000
+        return formatter
+    }
+
+    var numericFormatter: GenericTextFormatter {
+        let formatter = GenericTextFormatter()
+        formatter.format = "+\\A\\* NNN NNN \\A\\*"
+        return formatter
+    }
+
+    var genericTextFormatter: GenericTextFormatter {
+        let formatter = GenericTextFormatter()
+        formatter.format = "+AA NNN NNNS X YYYY/MM/DD \\A\\*"
+        return formatter
+    }
+
+    var genericText2Formatter: GenericTextFormatter {
+        let formatter = GenericTextFormatter()
+        formatter.format = "NNN+\\A\\* NNN NNN \\A\\*"
+        return formatter
+    }
+}