@luxass/utils 1.5.0 → 1.6.1

package/dist/index.cjs

@@ -1,14 +1,16 @@
 const require_guards = require('./guards-DE5pQVvl.cjs');
 const require_number = require('./number-DRbo8lb6.cjs');
-const require_string = require('./string-Ki9Q9jVP.cjs');
+const require_string = require('./string-CxNDb3Ui.cjs');
 
 exports.capitalize = require_string.capitalize
 exports.clamp = require_number.clamp
 exports.dedent = require_string.dedent
+exports.dedentRaw = require_string.dedentRaw
 exports.isNotNull = require_guards.isNotNull
 exports.isNotNullish = require_guards.isNotNullish
 exports.isNotUndefined = require_guards.isNotUndefined
 exports.isTruthy = require_guards.isTruthy
+exports.sanitizeIdentifier = require_string.sanitizeIdentifier
 exports.toCamelCase = require_string.toCamelCase
 exports.toKebabCase = require_string.toKebabCase
 exports.toPascalCase = require_string.toPascalCase

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { isNotNull, isNotNullish, isNotUndefined, isTruthy } from "./guards.d-DXUlpL_S.cjs";
 import { clamp } from "./number.d-C1FAMQlq.cjs";
-import { capitalize, dedent, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string.d-olvwSa1o.cjs";
+import { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string.d-Dm-Z_ZP2.cjs";
 import { Arrayable, Awaitable, ElementOf, InferArguments, Nullable, Nullish } from "./types.d-fcYBBT6c.cjs";
-export { Arrayable, Awaitable, ElementOf, InferArguments, Nullable, Nullish, capitalize, clamp, dedent, isNotNull, isNotNullish, isNotUndefined, isTruthy, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+export { Arrayable, Awaitable, ElementOf, InferArguments, Nullable, Nullish, capitalize, clamp, dedent, dedentRaw, isNotNull, isNotNullish, isNotUndefined, isTruthy, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { isNotNull$1 as isNotNull, isNotNullish$1 as isNotNullish, isNotUndefined$1 as isNotUndefined, isTruthy$1 as isTruthy } from "./guards.d-n1BzCANy.js";
 import { clamp$1 as clamp } from "./number.d-C2Xuq3Is.js";
-import { capitalize$1 as capitalize, dedent$1 as dedent, toCamelCase$1 as toCamelCase, toKebabCase$1 as toKebabCase, toPascalCase$1 as toPascalCase, toSnakeCase$1 as toSnakeCase } from "./string.d-BgvLaGcg.js";
+import { capitalize$1 as capitalize, dedent$1 as dedent, dedentRaw$1 as dedentRaw, sanitizeIdentifier$1 as sanitizeIdentifier, toCamelCase$1 as toCamelCase, toKebabCase$1 as toKebabCase, toPascalCase$1 as toPascalCase, toSnakeCase$1 as toSnakeCase } from "./string.d-BSY3kSBV.js";
 import { Arrayable, Awaitable, ElementOf, InferArguments, Nullable, Nullish } from "./types.d-BcKIY6l3.js";
-export { Arrayable, Awaitable, ElementOf, InferArguments, Nullable, Nullish, capitalize, clamp, dedent, isNotNull, isNotNullish, isNotUndefined, isTruthy, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+export { Arrayable, Awaitable, ElementOf, InferArguments, Nullable, Nullish, capitalize, clamp, dedent, dedentRaw, isNotNull, isNotNullish, isNotUndefined, isTruthy, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { isNotNull, isNotNullish, isNotUndefined, isTruthy } from "./guards-O1HGJraI.js";
 import { clamp } from "./number-Bfr1z0Nr.js";
-import { capitalize, dedent, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-DgqE1XDy.js";
+import { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-bY1lSRQs.js";
 
-export { capitalize, clamp, dedent, isNotNull, isNotNullish, isNotUndefined, isTruthy, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+export { capitalize, clamp, dedent, dedentRaw, isNotNull, isNotNullish, isNotUndefined, isTruthy, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/{string-Ki9Q9jVP.cjs → string-CxNDb3Ui.cjs}

@@ -122,6 +122,22 @@ function internal_dedent(strings, values, raw = false) {
 	const lastNonWhitespaceLine = whitespaceLines.lastIndexOf(false);
 	return lines.slice(firstNonWhitespaceLine >= 0 ? firstNonWhitespaceLine : 0, lastNonWhitespaceLine >= 0 ? lastNonWhitespaceLine + 1 : lines.length).map((line) => line.slice(commonIndent)).join("\n");
 }
+/**
+* Ensures a string is a valid JavaScript identifier by prefixing with an underscore if necessary
+* @param {string} str - The string to sanitize
+* @returns {string} A valid JavaScript identifier
+* @example
+* ```ts
+* sanitizeIdentifier("validName") // "validName"
+* sanitizeIdentifier("123invalid") // "_123invalid"
+* sanitizeIdentifier("$valid") // "$valid"
+* sanitizeIdentifier("_valid") // "_valid"
+* ```
+*/
+function sanitizeIdentifier(str) {
+	const cleaned = str.replace(/[^\w$]/g, "");
+	return /^[A-Z_$]/i.test(cleaned) ? cleaned : `_${cleaned}`;
+}
 
 //#endregion
 Object.defineProperty(exports, 'capitalize', {
@@ -142,6 +158,12 @@ Object.defineProperty(exports, 'dedentRaw', {
     return dedentRaw;
   }
 });
+Object.defineProperty(exports, 'sanitizeIdentifier', {
+  enumerable: true,
+  get: function () {
+    return sanitizeIdentifier;
+  }
+});
 Object.defineProperty(exports, 'toCamelCase', {
   enumerable: true,
   get: function () {

package/dist/{string-DgqE1XDy.js → string-bY1lSRQs.js}

@@ -120,6 +120,22 @@ function internal_dedent(strings, values, raw = false) {
 	const lastNonWhitespaceLine = whitespaceLines.lastIndexOf(false);
 	return lines.slice(firstNonWhitespaceLine >= 0 ? firstNonWhitespaceLine : 0, lastNonWhitespaceLine >= 0 ? lastNonWhitespaceLine + 1 : lines.length).map((line) => line.slice(commonIndent)).join("\n");
 }
+/**
+* Ensures a string is a valid JavaScript identifier by prefixing with an underscore if necessary
+* @param {string} str - The string to sanitize
+* @returns {string} A valid JavaScript identifier
+* @example
+* ```ts
+* sanitizeIdentifier("validName") // "validName"
+* sanitizeIdentifier("123invalid") // "_123invalid"
+* sanitizeIdentifier("$valid") // "$valid"
+* sanitizeIdentifier("_valid") // "_valid"
+* ```
+*/
+function sanitizeIdentifier(str) {
+	const cleaned = str.replace(/[^\w$]/g, "");
+	return /^[A-Z_$]/i.test(cleaned) ? cleaned : `_${cleaned}`;
+}
 
 //#endregion
-export { capitalize, dedent, dedentRaw, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+export { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/string.cjs

@@ -1,8 +1,9 @@
-const require_string = require('./string-Ki9Q9jVP.cjs');
+const require_string = require('./string-CxNDb3Ui.cjs');
 
 exports.capitalize = require_string.capitalize
 exports.dedent = require_string.dedent
 exports.dedentRaw = require_string.dedentRaw
+exports.sanitizeIdentifier = require_string.sanitizeIdentifier
 exports.toCamelCase = require_string.toCamelCase
 exports.toKebabCase = require_string.toKebabCase
 exports.toPascalCase = require_string.toPascalCase

package/dist/{string.d-olvwSa1o.d.cts → string.d-BSY3kSBV.d.ts}

@@ -101,6 +101,19 @@ declare namespace dedent {
   */
 
 declare function dedentRaw(literals: string): string;
-declare function dedentRaw(strings: TemplateStringsArray, ...values: unknown[]): string;
+declare function dedentRaw(strings: TemplateStringsArray, ...values: unknown[]): string; /**
+                                                                                         * Ensures a string is a valid JavaScript identifier by prefixing with an underscore if necessary
+                                                                                         * @param {string} str - The string to sanitize
+                                                                                         * @returns {string} A valid JavaScript identifier
+                                                                                         * @example
+                                                                                         * ```ts
+                                                                                         * sanitizeIdentifier("validName") // "validName"
+                                                                                         * sanitizeIdentifier("123invalid") // "_123invalid"
+                                                                                         * sanitizeIdentifier("$valid") // "$valid"
+                                                                                         * sanitizeIdentifier("_valid") // "_valid"
+                                                                                         * ```
+                                                                                         */
+
+declare function sanitizeIdentifier(str: string): string;
 //#endregion
-export { capitalize, dedent, dedentRaw, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+export { capitalize as capitalize$1, dedent as dedent$1, dedentRaw as dedentRaw$1, sanitizeIdentifier as sanitizeIdentifier$1, toCamelCase as toCamelCase$1, toKebabCase as toKebabCase$1, toPascalCase as toPascalCase$1, toSnakeCase as toSnakeCase$1 };

package/dist/{string.d-BgvLaGcg.d.ts → string.d-Dm-Z_ZP2.d.cts}

@@ -101,6 +101,19 @@ declare namespace dedent {
   */
 
 declare function dedentRaw(literals: string): string;
-declare function dedentRaw(strings: TemplateStringsArray, ...values: unknown[]): string;
+declare function dedentRaw(strings: TemplateStringsArray, ...values: unknown[]): string; /**
+                                                                                         * Ensures a string is a valid JavaScript identifier by prefixing with an underscore if necessary
+                                                                                         * @param {string} str - The string to sanitize
+                                                                                         * @returns {string} A valid JavaScript identifier
+                                                                                         * @example
+                                                                                         * ```ts
+                                                                                         * sanitizeIdentifier("validName") // "validName"
+                                                                                         * sanitizeIdentifier("123invalid") // "_123invalid"
+                                                                                         * sanitizeIdentifier("$valid") // "$valid"
+                                                                                         * sanitizeIdentifier("_valid") // "_valid"
+                                                                                         * ```
+                                                                                         */
+
+declare function sanitizeIdentifier(str: string): string;
 //#endregion
-export { capitalize as capitalize$1, dedent as dedent$1, dedentRaw as dedentRaw$1, toCamelCase as toCamelCase$1, toKebabCase as toKebabCase$1, toPascalCase as toPascalCase$1, toSnakeCase as toSnakeCase$1 };
+export { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/string.d.cts

@@ -1,2 +1,2 @@
-import { capitalize, dedent, dedentRaw, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string.d-olvwSa1o.cjs";
-export { capitalize, dedent, dedentRaw, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+import { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string.d-Dm-Z_ZP2.cjs";
+export { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/string.d.ts

@@ -1,2 +1,2 @@
-import { capitalize$1 as capitalize, dedent$1 as dedent, dedentRaw$1 as dedentRaw, toCamelCase$1 as toCamelCase, toKebabCase$1 as toKebabCase, toPascalCase$1 as toPascalCase, toSnakeCase$1 as toSnakeCase } from "./string.d-BgvLaGcg.js";
-export { capitalize, dedent, dedentRaw, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+import { capitalize$1 as capitalize, dedent$1 as dedent, dedentRaw$1 as dedentRaw, sanitizeIdentifier$1 as sanitizeIdentifier, toCamelCase$1 as toCamelCase, toKebabCase$1 as toKebabCase, toPascalCase$1 as toPascalCase, toSnakeCase$1 as toSnakeCase } from "./string.d-BSY3kSBV.js";
+export { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/dist/string.js

@@ -1,3 +1,3 @@
-import { capitalize, dedent, dedentRaw, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-DgqE1XDy.js";
+import { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase } from "./string-bY1lSRQs.js";
 
-export { capitalize, dedent, dedentRaw, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };
+export { capitalize, dedent, dedentRaw, sanitizeIdentifier, toCamelCase, toKebabCase, toPascalCase, toSnakeCase };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxass/utils",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "A collection of utilities for JavaScript/TypeScript",
   "type": "module",
   "author": {