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

package/dist/cjs/index.cjs

@@ -400,7 +400,7 @@ class StringHelper {
     /**
      * Implementation signature for trimTrailingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed string or the original null/undefined.
+     * @returns The trimmed string or the original.
      */
     static trimTrailingSlashes(value) {
         if (Is.string(value)) {
@@ -411,7 +411,7 @@ class StringHelper {
     /**
      * Implementation signature for trimLeadingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed string or the original null/undefined.
+     * @returns The trimmed string or the original.
      */
     static trimLeadingSlashes(value) {
         if (Is.string(value)) {
@@ -2941,6 +2941,32 @@ class ObjectHelper {
         }
         return obj;
     }
+    /**
+     * Split an object into two with the specified keys.
+     * @param obj The object to split.
+     * @param keys The property keys to split.
+     * @returns The two partial objects.
+     */
+    static split(obj, keys) {
+        if (Is.object(obj) && Is.array(keys)) {
+            const picked = {};
+            const omitted = {};
+            const allKeys = Object.keys(obj);
+            for (const key of allKeys) {
+                if (keys.includes(key)) {
+                    picked[key] = obj[key];
+                }
+                else {
+                    omitted[key] = obj[key];
+                }
+            }
+            return {
+                picked: Object.keys(picked).length > 0 ? picked : undefined,
+                omitted: Object.keys(omitted).length > 0 ? omitted : undefined
+            };
+        }
+        return { picked: obj, omitted: undefined };
+    }
     /**
      * Converter the non JSON primitives to extended types.
      * @param obj The object to convert.

package/dist/esm/index.mjs

@@ -398,7 +398,7 @@ class StringHelper {
     /**
      * Implementation signature for trimTrailingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed string or the original null/undefined.
+     * @returns The trimmed string or the original.
      */
     static trimTrailingSlashes(value) {
         if (Is.string(value)) {
@@ -409,7 +409,7 @@ class StringHelper {
     /**
      * Implementation signature for trimLeadingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed string or the original null/undefined.
+     * @returns The trimmed string or the original.
      */
     static trimLeadingSlashes(value) {
         if (Is.string(value)) {
@@ -2939,6 +2939,32 @@ class ObjectHelper {
         }
         return obj;
     }
+    /**
+     * Split an object into two with the specified keys.
+     * @param obj The object to split.
+     * @param keys The property keys to split.
+     * @returns The two partial objects.
+     */
+    static split(obj, keys) {
+        if (Is.object(obj) && Is.array(keys)) {
+            const picked = {};
+            const omitted = {};
+            const allKeys = Object.keys(obj);
+            for (const key of allKeys) {
+                if (keys.includes(key)) {
+                    picked[key] = obj[key];
+                }
+                else {
+                    omitted[key] = obj[key];
+                }
+            }
+            return {
+                picked: Object.keys(picked).length > 0 ? picked : undefined,
+                omitted: Object.keys(omitted).length > 0 ? omitted : undefined
+            };
+        }
+        return { picked: obj, omitted: undefined };
+    }
     /**
      * Converter the non JSON primitives to extended types.
      * @param obj The object to convert.

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

@@ -80,6 +80,16 @@ export declare class ObjectHelper {
      * @returns The partial object.
      */
     static omit<T>(obj: T | undefined, keys?: (keyof T)[]): Partial<T>;
+    /**
+     * Split an object into two with the specified keys.
+     * @param obj The object to split.
+     * @param keys The property keys to split.
+     * @returns The two partial objects.
+     */
+    static split<T>(obj: T | undefined, keys?: (keyof T)[]): {
+        picked: Partial<T> | undefined;
+        omitted: Partial<T> | undefined;
+    };
     /**
      * Converter the non JSON primitives to extended types.
      * @param obj The object to convert.

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

@@ -3,29 +3,17 @@
  */
 export declare class StringHelper {
     /**
-     * Trim trailing slashes from a string.
-     * Overloads preserve null/undefined instead of coercing to empty string.
+     * Implementation signature for trimTrailingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value (same null/undefined passed in).
+     * @returns The trimmed string or the original.
      */
     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.
+     * Implementation signature for trimLeadingSlashes.
      * @param value The value to trim.
-     * @returns The trimmed value (same null/undefined passed in).
+     * @returns The trimmed string or the original.
      */
     static trimLeadingSlashes(value: string): string;
-    /**
-     * Overload for null/undefined passthrough.
-     * @param value The null or undefined value.
-     */
-    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,39 @@
 # @twin.org/core - Changelog
 
+## [0.0.2-next.19](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.18...core-v0.0.2-next.19) (2025-09-30)
+
+
+### Features
+
+* add objectHelper.split ([386830a](https://github.com/twinfoundation/framework/commit/386830a77f8e842a5b119be0983708e042c3b14b))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.0.2-next.18 to 0.0.2-next.19
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.18 to 0.0.2-next.19
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.18 to 0.0.2-next.19
+
+## [0.0.2-next.18](https://github.com/twinfoundation/framework/compare/core-v0.0.2-next.17...core-v0.0.2-next.18) (2025-09-29)
+
+
+### Features
+
+* simplify StringHelper signature ([0390403](https://github.com/twinfoundation/framework/commit/039040344952f91ee3c671249bc0e1c8f3b38e17))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/nameof bumped from 0.0.2-next.17 to 0.0.2-next.18
+  * devDependencies
+    * @twin.org/nameof-transformer bumped from 0.0.2-next.17 to 0.0.2-next.18
+    * @twin.org/nameof-vitest-plugin bumped from 0.0.2-next.17 to 0.0.2-next.18
+
 ## [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)
 
 

package/docs/reference/classes/ObjectHelper.md

@@ -390,6 +390,48 @@ The partial object.
 
 ***
 
+### split()
+
+> `static` **split**\<`T`\>(`obj`, `keys?`): `object`
+
+Split an object into two with the specified keys.
+
+#### Type Parameters
+
+##### T
+
+`T`
+
+#### Parameters
+
+##### obj
+
+The object to split.
+
+`undefined` | `T`
+
+##### keys?
+
+keyof `T`[]
+
+The property keys to split.
+
+#### Returns
+
+`object`
+
+The two partial objects.
+
+##### picked
+
+> **picked**: `undefined` \| `Partial`\<`T`\>
+
+##### omitted
+
+> **omitted**: `undefined` \| `Partial`\<`T`\>
+
+***
+
 ### toExtended()
 
 > `static` **toExtended**(`obj`): `any`

package/docs/reference/classes/StringHelper.md

@@ -16,107 +16,45 @@ 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.
+Implementation signature for trimTrailingSlashes.
 
-##### Parameters
+#### Parameters
 
-###### value
+##### value
 
 `string`
 
 The value to trim.
 
-##### Returns
+#### Returns
 
 `string`
 
-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`
+The trimmed string or the original.
 
 ***
 
 ### 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.
+Implementation signature for trimLeadingSlashes.
 
-##### Parameters
+#### Parameters
 
-###### value
+##### value
 
 `string`
 
 The value to trim.
 
-##### Returns
+#### Returns
 
 `string`
 
-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`
+The trimmed string or the original.
 
 ***
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/core",
-	"version": "0.0.2-next.17",
+	"version": "0.0.2-next.19",
 	"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.17",
+		"@twin.org/nameof": "0.0.2-next.19",
 		"intl-messageformat": "10.7.16",
 		"rfc6902": "5.1.2"
 	},