@arkyn/shared 3.0.1-beta.142 → 3.0.1-beta.144

package/dist/services/validateDateService.js

@@ -1,35 +1,14 @@
 /**
- * Service for validating date components and input formats.
+ * Validates date components and input format strings for date-parsing utilities.
+ * Enforces 4-digit years, month/day ranges, month-specific day counts, and leap year rules.
  *
- * This service provides methods to validate date parts (year, month, day) and
- * input format strings used in date parsing operations. It includes leap year
- * validation and month-specific day validation.
- *
- * @remarks
- * The service validates:
- * - Year must be exactly 4 digits (1000-9999)
- * - Month must be between 1 and 12
- * - Day must be between 1 and 31
- * - Day must be valid for the specific month (e.g., no February 30)
- * - Leap year rules for February 29
- *
- * @example Validate a valid date
- * ```typescript
- * const service = new ValidateDateService();
- * service.validateDateParts(2024, 1, 15); // No error thrown
- * ```
- *
- * @example Validate an invalid date
+ * @example
  * ```typescript
  * const service = new ValidateDateService();
- * service.validateDateParts(2023, 2, 29); // Throws: "Day 29 is not valid for February 2023 (non-leap year)"
- * ```
- *
- * @example Validate input format
- * ```typescript
- * const service = new ValidateDateService();
- * service.validateInputFormat("brazilianDate"); // No error thrown
- * service.validateInputFormat("invalidFormat"); // Throws: "Invalid input format: invalidFormat"
+ * service.validateDateParts(2024, 2, 29); // OK — leap year
+ * service.validateDateParts(2023, 2, 29); // throws — not a leap year
+ * service.validateInputFormat("brazilianDate"); // OK
+ * service.validateInputFormat("custom"); // throws
  * ```
  */
 class ValidateDateService {
@@ -67,24 +46,11 @@ class ValidateDateService {
         }
     }
     /**
-     * Validates the components of a date (year, month, and day).
-     *
-     * @param {number} year - The year to validate (must be 4 digits).
-     * @param {number} month - The month to validate (must be between 1 and 12).
-     * @param {number} day - The day to validate (must be between 1 and 31, and valid for the month).
-     *
-     * @throws {Error} "Year should be four digits" - If the year doesn't have exactly 4 digits.
-     * @throws {Error} "Month should be between 1 and 12" - If the month is out of valid range.
-     * @throws {Error} "Day should be between 1 and 31" - If the day is out of valid range.
-     * @throws {Error} Month-specific error - If the day is invalid for the specific month.
+     * Throws if year, month, or day are out of valid range or inconsistent with the calendar.
      *
-     * @example
-     * ```typescript
-     * const service = new ValidateDateService();
-     * service.validateDateParts(2024, 2, 29); // Valid leap year date
-     * service.validateDateParts(2023, 2, 29); // Throws error - not a leap year
-     * service.validateDateParts(2024, 4, 31); // Throws error - April has only 30 days
-     * ```
+     * @param year - 4-digit year (1000–9999).
+     * @param month - Month number (1–12).
+     * @param day - Day number (1–31, validated against the specific month).
      */
     validateDateParts(year, month, day) {
         const messageErrors = {
@@ -101,26 +67,9 @@ class ValidateDateService {
         this.validateDayInMonth(day, month, year);
     }
     /**
-     * Validates that a given format string is supported.
-     *
-     * @param {string} format - The format string to validate.
-     *
-     * @throws {Error} "Invalid input format: {format}" - If the format is not one of the valid formats.
-     *
-     * @remarks
-     * Valid formats are:
-     * - "brazilianDate": DD/MM/YYYY format
-     * - "isoDate": MM-DD-YYYY format
-     * - "timestamp": YYYY-MM-DD format
+     * Throws if `format` is not one of `"brazilianDate"`, `"isoDate"`, or `"timestamp"`.
      *
-     * @example
-     * ```typescript
-     * const service = new ValidateDateService();
-     * service.validateInputFormat("brazilianDate"); // Valid
-     * service.validateInputFormat("isoDate"); // Valid
-     * service.validateInputFormat("timestamp"); // Valid
-     * service.validateInputFormat("customFormat"); // Throws error
-     * ```
+     * @param format - The format string to check.
      */
     validateInputFormat(format) {
         const validFormats = ["brazilianDate", "isoDate", "timestamp"];

package/dist/utilities/calculateCardInstallment.d.ts

@@ -1,29 +1,16 @@
 /**
- * Calculates the installment price and total price for a card payment plan.
+ * Calculates the per-installment and total price for a card payment plan with compound interest.
+ * No interest is applied when `fees` is `0` or `numberInstallments` is `1`.
  *
- * @remarks
- * **Important:** When the interest amount (`fees`) is equal to 0 or the number of installments (`numberInstallments`) is equal to 1, no interest will be charged.
- *
- * @param {object} props - The input parameters for the calculation.
- * @param {number} props.cashPrice - The total cash price of the product or service.
- * @param {number} props.numberInstallments - The number of installments for the payment plan.
- * @param {number} [props.fees=0.0349] - The interest rate per installment (default is 0.0349).
- *
- * @throws {Error} If `numberInstallments` is less than or equal to 0.
- * @throws {Error} If `fees` is less than 0.
- *
- * @returns {object} An object containing:
- * - `totalPrice`: The total price to be paid, rounded to two decimal places.
- * - `installmentPrice`: The price of each installment, rounded to two decimal places.
+ * @param props.cashPrice - The base price of the item.
+ * @param props.numberInstallments - Number of installments (must be > 0).
+ * @param props.fees - Monthly interest rate (defaults to `0.0349`).
+ * @returns `{ totalPrice, installmentPrice }` — both rounded to 2 decimal places.
  *
  * @example
  * ```typescript
- * const result = calculateCardInstallment({
- *   cashPrice: 1000,
- *   numberInstallments: 12,
- *   fees: 0.02,
- * });
- * console.log(result); // Output: { totalPrice: 1124.62, installmentPrice: 93.72 }
+ * calculateCardInstallment({ cashPrice: 1000, numberInstallments: 12, fees: 0.02 });
+ * // { totalPrice: 1124.62, installmentPrice: 93.72 }
  * ```
  */
 declare function calculateCardInstallment(props: {

package/dist/utilities/calculateCardInstallment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculateCardInstallment.d.ts","sourceRoot":"","sources":["../../src/utilities/calculateCardInstallment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,iBAAS,wBAAwB,CAAC,KAAK,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CA4BnD;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"calculateCardInstallment.d.ts","sourceRoot":"","sources":["../../src/utilities/calculateCardInstallment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,iBAAS,wBAAwB,CAAC,KAAK,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CA4BnD;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/utilities/calculateCardInstallment.js

@@ -1,29 +1,16 @@
 /**
- * Calculates the installment price and total price for a card payment plan.
+ * Calculates the per-installment and total price for a card payment plan with compound interest.
+ * No interest is applied when `fees` is `0` or `numberInstallments` is `1`.
  *
- * @remarks
- * **Important:** When the interest amount (`fees`) is equal to 0 or the number of installments (`numberInstallments`) is equal to 1, no interest will be charged.
- *
- * @param {object} props - The input parameters for the calculation.
- * @param {number} props.cashPrice - The total cash price of the product or service.
- * @param {number} props.numberInstallments - The number of installments for the payment plan.
- * @param {number} [props.fees=0.0349] - The interest rate per installment (default is 0.0349).
- *
- * @throws {Error} If `numberInstallments` is less than or equal to 0.
- * @throws {Error} If `fees` is less than 0.
- *
- * @returns {object} An object containing:
- * - `totalPrice`: The total price to be paid, rounded to two decimal places.
- * - `installmentPrice`: The price of each installment, rounded to two decimal places.
+ * @param props.cashPrice - The base price of the item.
+ * @param props.numberInstallments - Number of installments (must be > 0).
+ * @param props.fees - Monthly interest rate (defaults to `0.0349`).
+ * @returns `{ totalPrice, installmentPrice }` — both rounded to 2 decimal places.
  *
  * @example
  * ```typescript
- * const result = calculateCardInstallment({
- *   cashPrice: 1000,
- *   numberInstallments: 12,
- *   fees: 0.02,
- * });
- * console.log(result); // Output: { totalPrice: 1124.62, installmentPrice: 93.72 }
+ * calculateCardInstallment({ cashPrice: 1000, numberInstallments: 12, fees: 0.02 });
+ * // { totalPrice: 1124.62, installmentPrice: 93.72 }
  * ```
  */
 function calculateCardInstallment(props) {

package/dist/utilities/ensureQuotes.d.ts

@@ -5,9 +5,8 @@
  * quotes (`'`) or double quotes (`"`). If the string is already quoted, it is
  * returned as-is. Otherwise, the function wraps the string in double quotes.
  *
- * @param {string} rawValue - The raw string to be checked and potentially quoted.
- *
- * @returns {string} The input string, either unchanged if it is already quoted, or wrapped in double quotes.
+ * @param rawValue - The string to be checked and potentially quoted.
+ * @returns The original string if already quoted, otherwise the string wrapped in double quotes.
  *
  * @example
  * ```typescript

package/dist/utilities/ensureQuotes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensureQuotes.d.ts","sourceRoot":"","sources":["../../src/utilities/ensureQuotes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iBAAS,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"ensureQuotes.d.ts","sourceRoot":"","sources":["../../src/utilities/ensureQuotes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,iBAAS,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/utilities/ensureQuotes.js

@@ -5,9 +5,8 @@
  * quotes (`'`) or double quotes (`"`). If the string is already quoted, it is
  * returned as-is. Otherwise, the function wraps the string in double quotes.
  *
- * @param {string} rawValue - The raw string to be checked and potentially quoted.
- *
- * @returns {string} The input string, either unchanged if it is already quoted, or wrapped in double quotes.
+ * @param rawValue - The string to be checked and potentially quoted.
+ * @returns The original string if already quoted, otherwise the string wrapped in double quotes.
  *
  * @example
  * ```typescript

package/dist/utilities/findCountryMask.d.ts

@@ -1,43 +1,19 @@
 import { type CountryType } from "@arkyn/templates";
 /**
- * Finds and returns the phone mask for a given phone number based on the project's
- * country templates (masks use "_" as digit placeholders).
+ * Resolves the matching phone mask and country metadata for a given phone number.
+ * Masks use `"_"` as digit placeholders. For countries with multiple mask lengths
+ * (e.g. Brazil with and without the ninth digit), the mask matching the number's
+ * digit count is returned.
  *
- * The function typically:
- * - Parses the provided phone number to determine the country (using libphonenumber-js).
- * - Looks up the corresponding country mask in the `@arkyn/templates` list.
- * - Returns the mask string (e.g. "(__) _____-____") to be used for formatting.
- *
- * @param {string} phoneNumber - The input phone number (can include country code or be in national format).
- * @returns {string} The country mask string containing "_" placeholders for digits.
- *
- * @throws {Error} If the phone number is invalid or if no mask is found for the parsed country.
+ * @param phoneNumber - Phone number in E.164 format (e.g. `"+5511999999999"`).
+ * @returns A tuple of `[maskString, CountryType]`.
+ * @throws If the number is invalid or no mask is found for the parsed country.
  *
  * @example
  * ```typescript
- * console.log(findCountryMask("+5511999999999"));
- * // output:
- * [
- *  ["(__) _____-____", ["(__) ____-____"]],
- *  {
- *    name: "Brazil",
- *    code: "+55",
- *    iso: "BR",
- *    flag: "🇧🇷",
- *    mask: ["(__) _____-____", ["(__) ____-____"]] }
- * ]
- *
- * console.log(findCountryMask("+19700000000"));
- * // output:
- * [
- *  "(___) ___-____",
- *  {
- *    name: "United States",
- *    code: "+1",
- *    iso: "US",
- *    flag: "🇺🇸",
- *    mask: "(___) ___-____" }
- * ]
+ * const [mask, country] = findCountryMask("+5511999999999");
+ * // mask: "(__) _____-____"
+ * // country.name: "Brazil"
  * ```
  */
 declare function findCountryMask(phoneNumber: string): [string, CountryType];

package/dist/utilities/findCountryMask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findCountryMask.d.ts","sourceRoot":"","sources":["../../src/utilities/findCountryMask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,iBAAS,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CA+BnE;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"findCountryMask.d.ts","sourceRoot":"","sources":["../../src/utilities/findCountryMask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/D;;;;;;;;;;;;;;;;GAgBG;AAEH,iBAAS,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CA+BnE;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/utilities/findCountryMask.js

@@ -2,44 +2,20 @@ import { countries } from "@arkyn/templates";
 import { parsePhoneNumberWithError } from "libphonenumber-js";
 import { removeNonNumeric } from "./removeNonNumeric";
 /**
- * Finds and returns the phone mask for a given phone number based on the project's
- * country templates (masks use "_" as digit placeholders).
+ * Resolves the matching phone mask and country metadata for a given phone number.
+ * Masks use `"_"` as digit placeholders. For countries with multiple mask lengths
+ * (e.g. Brazil with and without the ninth digit), the mask matching the number's
+ * digit count is returned.
  *
- * The function typically:
- * - Parses the provided phone number to determine the country (using libphonenumber-js).
- * - Looks up the corresponding country mask in the `@arkyn/templates` list.
- * - Returns the mask string (e.g. "(__) _____-____") to be used for formatting.
- *
- * @param {string} phoneNumber - The input phone number (can include country code or be in national format).
- * @returns {string} The country mask string containing "_" placeholders for digits.
- *
- * @throws {Error} If the phone number is invalid or if no mask is found for the parsed country.
+ * @param phoneNumber - Phone number in E.164 format (e.g. `"+5511999999999"`).
+ * @returns A tuple of `[maskString, CountryType]`.
+ * @throws If the number is invalid or no mask is found for the parsed country.
  *
  * @example
  * ```typescript
- * console.log(findCountryMask("+5511999999999"));
- * // output:
- * [
- *  ["(__) _____-____", ["(__) ____-____"]],
- *  {
- *    name: "Brazil",
- *    code: "+55",
- *    iso: "BR",
- *    flag: "🇧🇷",
- *    mask: ["(__) _____-____", ["(__) ____-____"]] }
- * ]
- *
- * console.log(findCountryMask("+19700000000"));
- * // output:
- * [
- *  "(___) ___-____",
- *  {
- *    name: "United States",
- *    code: "+1",
- *    iso: "US",
- *    flag: "🇺🇸",
- *    mask: "(___) ___-____" }
- * ]
+ * const [mask, country] = findCountryMask("+5511999999999");
+ * // mask: "(__) _____-____"
+ * // country.name: "Brazil"
  * ```
  */
 function findCountryMask(phoneNumber) {

package/dist/utilities/isHtml.d.ts

@@ -5,9 +5,8 @@
  * in a string. The check is case-insensitive and detects both opening
  * and closing tags.
  *
- * @param {string} rawString - A string to be checked
- *
- * @returns {boolean} `true` if the string contains HTML markup, `false` otherwise
+ * @param rawString - The string to check.
+ * @returns `true` if the string contains HTML markup, `false` otherwise.
  *
  * @example
  * ```typescript

package/dist/utilities/isHtml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isHtml.d.ts","sourceRoot":"","sources":["../../src/utilities/isHtml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iBAAS,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG1C;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"isHtml.d.ts","sourceRoot":"","sources":["../../src/utilities/isHtml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iBAAS,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG1C;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/utilities/isHtml.js

@@ -5,9 +5,8 @@
  * in a string. The check is case-insensitive and detects both opening
  * and closing tags.
  *
- * @param {string} rawString - A string to be checked
- *
- * @returns {boolean} `true` if the string contains HTML markup, `false` otherwise
+ * @param rawString - The string to check.
+ * @returns `true` if the string contains HTML markup, `false` otherwise.
  *
  * @example
  * ```typescript

package/dist/utilities/removeCurrencySymbols.d.ts

@@ -5,9 +5,8 @@
  * and removes them using a regular expression. The resulting string
  * is also trimmed of any leading or trailing whitespace.
  *
- * @param {string} rawString - The input string containing currency symbols.
- *
- * @returns {string} A string with all currency symbols removed and trimmed of whitespace.
+ * @param rawString - The formatted string that may contain currency symbols.
+ * @returns The string with all currency symbols removed and trimmed of whitespace.
  *
  * @example
  * ```typescript

package/dist/utilities/removeCurrencySymbols.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"removeCurrencySymbols.d.ts","sourceRoot":"","sources":["../../src/utilities/removeCurrencySymbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iBAAS,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"removeCurrencySymbols.d.ts","sourceRoot":"","sources":["../../src/utilities/removeCurrencySymbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iBAAS,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/utilities/removeCurrencySymbols.js

@@ -5,9 +5,8 @@
  * and removes them using a regular expression. The resulting string
  * is also trimmed of any leading or trailing whitespace.
  *
- * @param {string} rawString - The input string containing currency symbols.
- *
- * @returns {string} A string with all currency symbols removed and trimmed of whitespace.
+ * @param rawString - The formatted string that may contain currency symbols.
+ * @returns The string with all currency symbols removed and trimmed of whitespace.
  *
  * @example
  * ```typescript

package/dist/utilities/removeNonNumeric.d.ts

@@ -1,9 +1,8 @@
 /**
  * Removes all non-numeric characters from a given string.
  *
- * @param {string} rawString - The input string from which non-numeric characters will be removed.
- *
- * @returns {string} A new string containing only numeric characters from the input.
+ * @param rawString - The input string to strip non-numeric characters from.
+ * @returns A new string containing only the numeric characters from the input.
  *
  * @example
  * ```typescript

package/dist/utilities/removeNonNumeric.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"removeNonNumeric.d.ts","sourceRoot":"","sources":["../../src/utilities/removeNonNumeric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,iBAAS,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"removeNonNumeric.d.ts","sourceRoot":"","sources":["../../src/utilities/removeNonNumeric.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iBAAS,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/utilities/removeNonNumeric.js

@@ -1,9 +1,8 @@
 /**
  * Removes all non-numeric characters from a given string.
  *
- * @param {string} rawString - The input string from which non-numeric characters will be removed.
- *
- * @returns {string} A new string containing only numeric characters from the input.
+ * @param rawString - The input string to strip non-numeric characters from.
+ * @returns A new string containing only the numeric characters from the input.
  *
  * @example
  * ```typescript

package/dist/utilities/stripHtmlTags.d.ts

@@ -4,9 +4,8 @@
  * This function removes all HTML tags from the provided string by replacing any content
  * that matches the HTML tag pattern with an empty string.
  *
- * @param {string} rawHtml - The HTML string to be processed
- *
- * @returns {string} The input string with all HTML tags removed
+ * @param rawHtml - The HTML string to strip tags from.
+ * @returns The plain text with all HTML tags (including `<script>`, `<style>`, and comments) removed.
  *
  * @example
  * ```typescript

package/dist/utilities/stripHtmlTags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripHtmlTags.d.ts","sourceRoot":"","sources":["../../src/utilities/stripHtmlTags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"stripHtmlTags.d.ts","sourceRoot":"","sources":["../../src/utilities/stripHtmlTags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,iBAAS,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/utilities/stripHtmlTags.js

@@ -4,9 +4,8 @@
  * This function removes all HTML tags from the provided string by replacing any content
  * that matches the HTML tag pattern with an empty string.
  *
- * @param {string} rawHtml - The HTML string to be processed
- *
- * @returns {string} The input string with all HTML tags removed
+ * @param rawHtml - The HTML string to strip tags from.
+ * @returns The plain text with all HTML tags (including `<script>`, `<style>`, and comments) removed.
  *
  * @example
  * ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkyn/shared",
-  "version": "3.0.1-beta.142",
+  "version": "3.0.1-beta.144",
   "main": "./dist/bundle.js",
   "module": "./dist/bundle.js",
   "type": "module",