1 files changed, 24 insertions, 0 deletions
diff --git a/lib/string_ext.dart b/lib/string_ext.dart
new file mode 100644
index 0000000..6119c5b
--- /dev/null
+++ b/lib/string_ext.dart
@@ -0,0 +1,24 @@
+// Copyright (C) 2025, uvok cheetah
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+extension StringExt on String {
+  /// split string on first occurrence.
+  /// if s is not inside string, the original value is returned.
+  List<String> splitFirst(String s) {
+    int idx = indexOf(s);
+    if (idx == -1) return [this];
+    return [substring(0, idx).trim(), substring(idx + s.length).trim()];
+  }
+}