@twin.org/core 0.0.2-next.16 → 0.0.2-next.17

package/dist/cjs/index.cjs

@@ -398,26 +398,26 @@ class Is {
  */
 class StringHelper {
     /**
-     * Trim trailing slashes from a string.
+     * Implementation signature for trimTrailingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimTrailingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/\/+$/, "");
         }
-        return "";
+        return value;
     }
     /**
-     * Trim leading slashes from a string.
+     * Implementation signature for trimLeadingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimLeadingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/^\/+/, "");
         }
-        return "";
+        return value;
     }
     /**
      * Convert the input string to kebab case.
@@ -2705,7 +2705,7 @@ class ObjectHelper {
      * @returns The object as bytes.
      */
     static toBytes(obj, format = false) {
-        if (obj === undefined) {
+        if (Is.undefined(obj)) {
             return new Uint8Array();
         }
         const json = format ? JSON.stringify(obj, undefined, "\t") : JSON.stringify(obj);

package/dist/esm/index.mjs

@@ -396,26 +396,26 @@ class Is {
  */
 class StringHelper {
     /**
-     * Trim trailing slashes from a string.
+     * Implementation signature for trimTrailingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimTrailingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/\/+$/, "");
         }
-        return "";
+        return value;
     }
     /**
-     * Trim leading slashes from a string.
+     * Implementation signature for trimLeadingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed string or the original null/undefined.
      */
     static trimLeadingSlashes(value) {
-        if (Is.stringValue(value)) {
+        if (Is.string(value)) {
             return value.replace(/^\/+/, "");
         }
-        return "";
+        return value;
     }
     /**
      * Convert the input string to kebab case.
@@ -2703,7 +2703,7 @@ class ObjectHelper {
      * @returns The object as bytes.
      */
     static toBytes(obj, format = false) {
-        if (obj === undefined) {
+        if (Is.undefined(obj)) {
             return new Uint8Array();
         }
         const json = format ? JSON.stringify(obj, undefined, "\t") : JSON.stringify(obj);

package/dist/types/helpers/stringHelper.d.ts

@@ -4,16 +4,28 @@
 export declare class StringHelper {
     /**
      * Trim trailing slashes from a string.
+     * Overloads preserve null/undefined instead of coercing to empty string.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed value (same null/undefined passed in).
      */
-    static trimTrailingSlashes(value: string | undefined): string;
+    static trimTrailingSlashes(value: string): string;
+    /**
+     *
+     * @param value
+     */
+    static trimTrailingSlashes<T extends null | undefined>(value: T): T;
     /**
      * Trim leading slashes from a string.
+     * Overloads preserve null/undefined instead of coercing to empty string.
      * @param value The value to trim.
-     * @returns The trimmed value.
+     * @returns The trimmed value (same null/undefined passed in).
+     */
+    static trimLeadingSlashes(value: string): string;
+    /**
+     * Overload for null/undefined passthrough.
+     * @param value The null or undefined value.
      */
-    static trimLeadingSlashes(value: string | undefined): string;
+    static trimLeadingSlashes<T extends null | undefined>(value: T): T;
     /**
      * Convert the input string to kebab case.
      * @param input The input to convert.

package/docs/changelog.md

@@ -1,5 +1,22 @@
 # @twin.org/core - Changelog
 
+## [0.0.2-next.17](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.16...core-v0.0.2-next.17) (2025-09-29)
+
+
+### Features
+
+* additional nameof operators ([a5aab60](https://github.com/twinfoundation/framework/commit/a5aab60bf66a86f1b7ff8af7c4f044cb03706d50))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.0.2-next.16 to 0.0.2-next.17
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.16 to 0.0.2-next.17
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.16 to 0.0.2-next.17
+
 ## [0.0.2-next.16](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.15...core-v0.0.2-next.16) (2025-09-28)
 
 

package/docs/reference/classes/StringHelper.md

@@ -16,45 +16,107 @@ Class to help with string.
 
 ### trimTrailingSlashes()
 
+Implementation signature for trimTrailingSlashes.
+
+#### Param
+
+The value to trim.
+
+#### Call Signature
+
 > `static` **trimTrailingSlashes**(`value`): `string`
 
 Trim trailing slashes from a string.
+Overloads preserve null/undefined instead of coercing to empty string.
 
-#### Parameters
+##### Parameters
 
-##### value
+###### value
+
+`string`
 
 The value to trim.
 
-`undefined` | `string`
-
-#### Returns
+##### Returns
 
 `string`
 
-The trimmed value.
+The trimmed value (same null/undefined passed in).
+
+#### Call Signature
+
+> `static` **trimTrailingSlashes**\<`T`\>(`value`): `T`
+
+##### Type Parameters
+
+###### T
+
+`T` *extends* `undefined` \| `null`
+
+##### Parameters
+
+###### value
+
+`T`
+
+##### Returns
+
+`T`
 
 ***
 
 ### trimLeadingSlashes()
 
+Implementation signature for trimLeadingSlashes.
+
+#### Param
+
+The value to trim.
+
+#### Call Signature
+
 > `static` **trimLeadingSlashes**(`value`): `string`
 
 Trim leading slashes from a string.
+Overloads preserve null/undefined instead of coercing to empty string.
 
-#### Parameters
+##### Parameters
 
-##### value
+###### value
 
-The value to trim.
+`string`
 
-`undefined` | `string`
+The value to trim.
 
-#### Returns
+##### Returns
 
 `string`
 
-The trimmed value.
+The trimmed value (same null/undefined passed in).
+
+#### Call Signature
+
+> `static` **trimLeadingSlashes**\<`T`\>(`value`): `T`
+
+Overload for null/undefined passthrough.
+
+##### Type Parameters
+
+###### T
+
+`T` *extends* `undefined` \| `null`
+
+##### Parameters
+
+###### value
+
+`T`
+
+The null or undefined value.
+
+##### Returns
+
+`T`
 
 ***
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.0.2-next.16",
+	"version": "0.0.2-next.17",
 	"description": "Helper methods/classes for data type checking/validation/guarding/error handling",
 	"repository": {
 		"type": "git",
@@ -14,7 +14,7 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@twin.org/nameof": "0.0.2-next.16",
+		"@twin.org/nameof": "0.0.2-next.17",
 		"intl-messageformat": "10.7.16",
 		"rfc6902": "5.1.2"
 	},