+refactor: Improve code structure

Author: robelator

.github/_README.md

@@ -18,19 +18,19 @@ cd your_project
 **2. Clone this repo into a `.github/` folder:**
 
 ```zsh
-git clone https://github.com/robmllze/pub.dev_package_workflow.git .github
+git clone https://github.com/DevCetra/pub.dev_package_workflow.git .github
 ```
 
 **3. Remove the `/.git` folder to include it to your project:**
-   
-*On macOS and Linux:*
+
+_On macOS and Linux:_
+
 ```zsh
 rm -rf .github/.git/
 ```
 
-*On Windows:*
+_On Windows:_
+
 ```cmd
 rmdir /s /q .github/.git/
 ```
-
-

.gitignore

@@ -17,4 +17,9 @@
 **/.github/.git
 **/.metadata
 **/.flutter-plugins
-**/.flutter-plugins-dependencies
+**/.flutter-plugins-dependencies
+**/pubspec_overrides.yaml
+
+# Don't support IntelliJ.
+**/*.iml
+**/*.idea/

.vscode/tasks.json

@@ -4,7 +4,7 @@
         {
             "label": "▶️ Refetch workflow",
             "type": "shell",
-            "command": "rm -rf .github && git clone https://github.com/robmllze/pub.dev_package_workflow.git .github && rm -rf .github/.git/"
+            "command": "rm -rf .github && git clone https://github.com/DevCetra/pub.dev_package_workflow.git .github && rm -rf .github/.git/"
         },
         {
             "label": "▶️ Publish to pub.dev",

DEVELOPER_NOTES.md

@@ -18,7 +18,7 @@
 
 ## Enabling GitHub Workflow
 
-https://github.com/robmllze/YOUR_PROJECT_NAME/settings/actions
+https://github.com/DevCetra/YOUR_PROJECT_NAME/settings/actions
 
 ## Changelog
 
@@ -33,7 +33,7 @@ git init
 git add .
 git commit -m "Initial commit"
 gh repo create YOUR_PROJECT_NAME --public
-git remote add origin https://github.com/robmllze/YOUR_PROJECT_NAME.git
+git remote add origin https://github.com/DevCetra/YOUR_PROJECT_NAME.git
 git push -u origin main
 ```
 
@@ -54,7 +54,7 @@ git push -u origin main
 
 ```bash
 rm -rf .github/
-git clone https://github.com/robmllze/pub.dev_package_workflow.git .github
+git clone https://github.com/DevCetra/pub.dev_package_workflow.git .github
 rm -rf .github/.git
 ```
 
@@ -71,6 +71,6 @@ find . -name '.DS_Store' -type f -delete
 
 ```bash
 rmdir /s /q .github/
-git clone https://github.com/robmllze/pub.dev_package_workflow.git .github
+git clone https://github.com/DevCetra/pub.dev_package_workflow.git .github
 rmdir /s /q .github/.git
 ```

README.md

@@ -1,5 +1,3 @@
-# DF - String
-
 <a href="https://www.buymeacoffee.com/robmllze" target="_blank"><img align="right" src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a>
 
 Dart & Flutter Packages by DevCetra.com & contributors.
@@ -52,7 +50,7 @@ No matter how you choose to contribute, your involvement is greatly appreciated
 
 ### Join GitHub Discussions:
 
-💬 https://github.com/robmllze/df_string/discussions/
+💬 https://github.com/DevCetra/df_string/discussions/
 
 ### Chief Maintainer:
 

lib/src/_index.g.dart

@@ -1,21 +1,14 @@
 //.title
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //
-// GENERATED BY DF GEN - DO NOT MODIFY BY HAND
-// See: https://github.com/robmllze/df_gen
+// GENERATED - DO NOT MODIFY BY HAND
+// See: https://github.com/DevCetra/df_generate_dart_indexes
 //
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-// --- PUBLIC FILES ---
-export 'string_case_types.dart';
-export 'extensions/misc_utils_on_string_extension.dart';
-export 'extensions/null_if_empty_on_string_x.dart';
-export 'extensions/string_case_conversions_on_string_extension.dart';
-export 'extensions/to_timmed_or_null_on_object_extension.dart';
-
-// --- PRIVATE FILES (EXCLUDED) ---
-// export '_index.g.dart';
-
-// --- GENERATED FILES (EXCLUDED) ---
-// None found.
+export './string_case_types.dart';
+export './extensions/string_case_conversions_on_string_x.dart';
+export './extensions/misc_utils_on_string_x.dart';
+export './extensions/null_if_empty_on_string_x.dart';
+export './extensions/to_timmed_or_null_on_object_x.dart';

…ions/misc_utils_on_string_extension.dart …c/extensions/misc_utils_on_string_x.dartlib/src/extensions/misc_utils_on_string_extension.dart renamed to lib/src/extensions/misc_utils_on_string_x.dart lib/src/extensions/misc_utils_on_string_extension.dart renamed to lib/src/extensions/misc_utils_on_string_x.dart

@@ -10,10 +10,17 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-extension MiscUtilsOnStringExtension on String {
-  /// Truncates the string to the given [length].
-  String truncToLength(int length) {
-    return (this.length > length ? substring(0, length).trim() : this);
+extension MiscUtilsOnStringX on String {
+  /// Truncates the string to the given [length]. Specify [ellipsis] to append
+  /// to he truncated string if it is shorter than [length], e.g.
+  /// 'Hello World'.truncToLength(5, ellipsis: '...') => 'Hello...'.
+  String truncToLength(
+    int length, {
+    String ellipsis = '',
+  }) {
+    final temp = (this.length > length ? substring(0, length).trim() : this);
+    if (temp.length < length) return temp + ellipsis;
+    return temp;
   }
 
   /// Replaces all whitespace characters with [replace].
@@ -25,7 +32,11 @@ extension MiscUtilsOnStringExtension on String {
   /// [startIndex].
   ///
   /// See: [replaceFirst].
-  String replaceLast(Pattern from, String replace, [int startIndex = 0]) {
+  String replaceLast(
+    Pattern from,
+    String replace, [
+    int startIndex = 0,
+  ]) {
     final match = from.allMatches(this, startIndex).lastOrNull;
     if (match == null) return this;
     final lastIndex = match.start;

…ase_conversions_on_string_extension.dart …string_case_conversions_on_string_x.dartlib/src/extensions/string_case_conversions_on_string_extension.dart renamed to lib/src/extensions/string_case_conversions_on_string_x.dart lib/src/extensions/string_case_conversions_on_string_extension.dart renamed to lib/src/extensions/string_case_conversions_on_string_x.dart

@@ -10,7 +10,7 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-extension StringCaseConversionsOnStringExtension on String {
+extension StringCaseConversionsOnStringX on String {
   /// Converts the string to UPPER_SNAKE_CASE;
   String toUpperSnakeCase() => toSnakeCase().toUpperCase();
 
@@ -32,6 +32,10 @@ extension StringCaseConversionsOnStringExtension on String {
   /// Converts the string to kebab-case.
   String toKebabCase() => _extractLowercaseComponents().join('-');
 
+  /// Converts the string to Capitalized-Kebab-Case.
+  String toCapitalizedKebabCase() =>
+      _extractLowercaseComponents().map((e) => e.capitalize()).join('-');
+
   /// Converts the string to dot.case.
   String toDotCase() => _extractLowercaseComponents().join('.');
 
@@ -42,15 +46,13 @@ extension StringCaseConversionsOnStringExtension on String {
   String toUpperDotCase() => toDotCase().toUpperCase();
 
   /// Converts the string to path/case.
-  String toPathCase([String separator = '/']) =>
-      _extractLowercaseComponents().join(separator);
+  String toPathCase([String separator = '/']) => _extractLowercaseComponents().join(separator);
 
   /// Converts the string to camelCase.
   String toCamelCase() => toPascalCase().withFirstLetterAsLowerCase();
 
   /// Converts the string to PascalCase.
-  String toPascalCase() =>
-      _extractLowercaseComponents().map((e) => e.capitalize()).join();
+  String toPascalCase() => _extractLowercaseComponents().map((e) => e.capitalize()).join();
 
   /// Extracts and returns a list of lowercase components from the string.
   ///
@@ -85,9 +87,7 @@ extension StringCaseConversionsOnStringExtension on String {
           if ((a.isLowerCase && b.isUpperCase) ||
               (a._isDigit && bIsLetter) ||
               (aIsLetter && b._isDigit) ||
-              (a.isUpperCase &&
-                  b.isUpperCase &&
-                  (n + 1 < length && this[n + 1].isLowerCase))) {
+              (a.isUpperCase && b.isUpperCase && (n + 1 < length && this[n + 1].isLowerCase))) {
             words.add(currentWord.toString().toLowerCase());
             currentWord = StringBuffer();
           }
@@ -140,9 +140,6 @@ extension StringCaseConversionsOnStringExtension on String {
 
   /// Capitalizes each word in the string.
   String withCapitalizedWords() {
-    return trim()
-        .split(RegExp(r'[- ]+'))
-        .map((e) => e.trim().toLowerCase().capitalize())
-        .join(' ');
+    return trim().split(RegExp(r'[- ]+')).map((e) => e.trim().toLowerCase().capitalize()).join(' ');
   }
 }

…_timmed_or_null_on_object_extension.dart …sions/to_timmed_or_null_on_object_x.dartlib/src/extensions/to_timmed_or_null_on_object_extension.dart renamed to lib/src/extensions/to_timmed_or_null_on_object_x.dart lib/src/extensions/to_timmed_or_null_on_object_extension.dart renamed to lib/src/extensions/to_timmed_or_null_on_object_x.dart

@@ -10,7 +10,7 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-extension ToTrimmedOrNullOnObjectExtension on Object {
+extension ToTrimmedOrNullOnObjectX on Object {
   /// Converts the input to a string and trims it or returns `null` if the
   /// result is empty.
   String? toTrimmedOrNull() {

lib/src/string_case_types.dart

@@ -10,7 +10,7 @@
 // ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
 //.title~
 
-import 'extensions/string_case_conversions_on_string_extension.dart';
+import 'extensions/string_case_conversions_on_string_x.dart';
 
 // ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
 
@@ -24,6 +24,7 @@ enum StringCaseType {
   UPPER_SNAKE_CASE(_UPPER_SNAKE_CASE),
   LOWER_KEBAB_CASE(_LOWER_KEBAB_CASE),
   UPPER_KEBAB_CASE(_UPPER_KEBAB_CASE),
+  CAPITALIZED_KEBAB_CASE(_UPPER_KEBAB_CASE),
   CAMEL_CASE(_CAMEL_CASE),
   PASCAL_CASE(_PASCAL_CASE),
   LOWER_DOT_CASE(_LOWER_DOT_CASE),
@@ -34,44 +35,17 @@ enum StringCaseType {
   //
   //
 
-  final String message;
+  final String code;
 
   //
   //
   //
 
-  const StringCaseType(this.message);
+  const StringCaseType(this.code);
 }
 
 // ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
 
-/// Camel case example.
-const CAMEL_CASE_EXAMPLE = 'camelCase';
-
-/// Lower dot case example.
-const LOWER_DOT_CASE_EXAMPLE = 'lower.dot.case';
-
-/// Lower kebab case example.
-const LOWER_KEBAB_CASE_EXAMPLE = 'lower-kebab-case';
-
-/// Lower snake case example.
-const LOWER_SNAKE_CASE_EXAMPLE = 'lower_snake_case';
-
-/// Pascal case example.
-const PASCAL_CASE_EXAMPLE = 'PascalCase';
-
-/// Path case example.
-const PATH_CASE_EXAMPLE = 'path/case';
-
-/// Upper dot case example.
-const UPPER_DOT_CASE_EXAMPLE = 'UPPER.DOT.CASE';
-
-/// Upper kebab case example.
-const UPPER_KEBAB_CASE_EXAMPLE = 'UPPER-KEBAB-CASE';
-
-/// Upper snake case example.
-const UPPER_SNAKE_CASE_EXAMPLE = 'UPPER_SNAKE_CASE';
-
 /// A key representing camel case.
 const CAMEL_CASE = 'CAMEL_CASE';
 
@@ -81,6 +55,9 @@ const LOWER_DOT_CASE = 'LOWER_DOT_CASE';
 /// A key representing lower kebab case.
 const LOWER_KEBAB_CASE = 'LOWER_KEBAB_CASE';
 
+/// A key representing lower kebab case.
+const CAPITALIZED_KEBAB_CASE = 'CAPITALIZED_KEBAB_CASE';
+
 /// A key representing lower snake case.
 const LOWER_SNAKE_CASE = 'LOWER_SNAKE_CASE';
 
@@ -107,6 +84,7 @@ const _PASCAL_CASE = PASCAL_CASE;
 const _PATH_CASE = PATH_CASE;
 const _UPPER_DOT_CASE = UPPER_DOT_CASE;
 const _UPPER_KEBAB_CASE = UPPER_KEBAB_CASE;
+const _CAPITALIZED_KEBAB_CASE = CAPITALIZED_KEBAB_CASE;
 const _UPPER_SNAKE_CASE = UPPER_SNAKE_CASE;
 
 // ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
@@ -125,6 +103,8 @@ String convertToStringCaseType(
       return value.toLowerKebabCase();
     case StringCaseType.UPPER_KEBAB_CASE:
       return value.toUpperKebabCase();
+    case StringCaseType.CAPITALIZED_KEBAB_CASE:
+      return value.toCapitalizedKebabCase();
     case StringCaseType.CAMEL_CASE:
       return value.toCamelCase();
     case StringCaseType.PASCAL_CASE:
@@ -142,7 +122,7 @@ String convertToStringCaseType(
 
 // ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
 
-extension ConvertOnStringCaseTypeExtension on StringCaseType {
+extension ConvertOnStringCaseTypeX on StringCaseType {
   /// Converts [value] to a specific case type.
   String convert(String value) {
     return convertToStringCaseType(value, this);