docs: add parameterized API Reference

Author: alessiofrittoli

README.md

@@ -1516,6 +1516,46 @@ console.log(parseValue("String value")); // Outputs: 'String value'
 
 ---
 
+##### `parameterized`
+
+Creates a parameterized string with placeholder values.
+
+###### Types
+
+###### `ParameterizedValue`
+
+Represents a value that can be used as a parameter in string operations.
+
+```ts
+type ParameterizedValue = string | boolean | number | bigint;
+```
+
+###### `Parameterized`
+
+Represents a parameterized string with its corresponding values.
+
+```ts
+type Parameterized = [string, ParameterizedValue[]];
+```
+
+<details>
+
+<summary style="cursor:pointer">Examples</summary>
+
+```ts
+import { parameterized } from "@alessiofrittoli/web-utils";
+
+const data = {
+  value: "parameterized",
+};
+
+console.log(parameterized`My string with ${data.value} values.`); // [ 'My string with ? values.', [ 'parameterized' ] ]
+```
+
+</details>
+
+---
+
 #### Types utilities
 
 ⚠️ Docs coming soon

src/strings.ts

@@ -348,7 +348,7 @@ export const emailDataToString = (
  * Represents a value that can be used as a parameter in string operations.
  * 
  */
-type ParameterizedValue = string | boolean | number | bigint
+export type ParameterizedValue = string | boolean | number | bigint
 
 
 /**
@@ -357,23 +357,23 @@ type ParameterizedValue = string | boolean | number | bigint
  * @property {string} 0 - The template string
  * @property {ParameterizedValue[]} 1 - Array of values to be substituted into the template string
  */
-type Parameterized = [ string, ParameterizedValue[] ]
+export type Parameterized = [ string, ParameterizedValue[] ]
 
 
 /**
- * Creates a parameterized query string with placeholder values.
+ * Creates a parameterized string with placeholder values.
  * 
  * @param strings - The template string parts from a template literal.
  * @param values - One or more parameter values or arrays of values to be substituted into the template.
- * @returns A tuple containing the normalized query string with `?` placeholders and an array of parameter values.
+ * @returns A tuple containing the normalized string with `?` placeholders and an array of parameter values.
  * 
  * @example
  * ```ts
- * const [ query, params ] = parameterized`
+ * const [ string, params ] = parameterized`
  *  SELECT * FROM users WHERE id = ${ 1 } AND status IN ( ${ [ 'active', 'pending' ] } )
  * ` )
  * 
- * // query: "SELECT * FROM users WHERE id = ? AND status IN ( ?, ? )"
+ * // string: "SELECT * FROM users WHERE id = ? AND status IN ( ?, ? )"
  * // params: [ 1, 'active', 'pending' ]
  * ```
  *