Added ving util appendNumberToString().

ving/docs/change-log.md

@@ -25,6 +25,7 @@ outline: deep
 * Added prepend/append slots to FormInput for inserting icons into input groups.
 * Exposed new props for modifying the classes associated with PanelZone.
 * Added a coerce attribute to the FormInput component.
+* Added ving util appendNumberToString().
 
 ## 2024-04-29
 * Implemented: reformat page generator to use panel components on view and edit #139

ving/docs/subsystems/utils.md

@@ -8,6 +8,10 @@ There are a bunch of utilities libraries in `ving/utils` that solve common probl
 
 ## Utility Libraries
 
+### appendNumberToString
+
+Adds a number to the end of a string, or increments it if there's already one there.
+
 ### findObject
 
 Provides light wrappers around the javascript `find()` function that throws an error if the object you're looking for isn't found.

ving/utils/appendNumberToString.mjs

@@ -0,0 +1,17 @@
+import { isArray } from '#ving/utils/identify.mjs';
+
+/** 
+ * Appends a number to the end of a string, or increments the number if there's already one at the end of the string.
+ * @param {string} input - Any string
+ * @example
+ * appendNumberToString('foo') // foo2
+ * appendNumberToString('foo2') // foo3
+ */
+
+export default (input) => {
+    const matches = input.match(/^(.*?)(\d+)$/);
+    let num = (isArray(matches) && matches.length == 3) ? parseInt(matches[2]) : 1;
+    let str = (isArray(matches) && matches.length == 3) ? matches[1] : input;
+    num++;
+    return str + num;
+}