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

package/dist/cjs/index.cjs

@@ -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

@@ -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/docs/changelog.md

@@ -1,5 +1,22 @@
 # @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)
 
 

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/package.json

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