feat!: migrate utils/object-inverse-by to object/inverse-by

lib/node_modules/@stdlib/namespace/alias2pkg/data/data.csv

@@ -2663,7 +2663,7 @@ objectEntries,"@stdlib/utils/entries"
 objectEntriesIn,"@stdlib/utils/entries-in"
 objectFromEntries,"@stdlib/utils/from-entries"
 objectInverse,"@stdlib/utils/object-inverse"
-objectInverseBy,"@stdlib/utils/object-inverse-by"
+objectInverseBy,"@stdlib/object/inverse-by"
 objectKeys,"@stdlib/utils/keys"
 objectValues,"@stdlib/utils/values"
 objectValuesIn,"@stdlib/utils/values-in"

lib/node_modules/@stdlib/namespace/lib/namespace/o.js

@@ -76,14 +76,14 @@ ns.push({
 	'value': require( '@stdlib/utils/object-inverse' ),
 	'type': 'Function',
 	'related': [
-		'@stdlib/utils/object-inverse-by'
+		'@stdlib/object/inverse-by'
 	]
 });
 
 ns.push({
 	'alias': 'objectInverseBy',
-	'path': '@stdlib/utils/object-inverse-by',
-	'value': require( '@stdlib/utils/object-inverse-by' ),
+	'path': '@stdlib/object/inverse-by',
+	'value': require( '@stdlib/object/inverse-by' ),
 	'type': 'Function',
 	'related': [
 		'@stdlib/utils/object-inverse'

lib/node_modules/@stdlib/namespace/pkg2alias/data/data.csv

@@ -2663,7 +2663,7 @@
 "@stdlib/utils/entries-in",objectEntriesIn
 "@stdlib/utils/from-entries",objectFromEntries
 "@stdlib/utils/object-inverse",objectInverse
-"@stdlib/utils/object-inverse-by",objectInverseBy
+"@stdlib/object/inverse-by",objectInverseBy
 "@stdlib/utils/keys",objectKeys
 "@stdlib/utils/values",objectValues
 "@stdlib/utils/values-in",objectValuesIn

lib/node_modules/@stdlib/namespace/pkg2related/data/data.csv

@@ -2662,8 +2662,8 @@
 "@stdlib/utils/entries","@stdlib/utils/entries-in,@stdlib/utils/from-entries,@stdlib/utils/keys,@stdlib/utils/values"
 "@stdlib/utils/entries-in","@stdlib/utils/entries,@stdlib/utils/from-entries,@stdlib/utils/keys-in,@stdlib/utils/values-in"
 "@stdlib/utils/from-entries","@stdlib/utils/entries"
-"@stdlib/utils/object-inverse","@stdlib/utils/object-inverse-by"
-"@stdlib/utils/object-inverse-by","@stdlib/utils/object-inverse"
+"@stdlib/utils/object-inverse","@stdlib/object/inverse-by"
+"@stdlib/object/inverse-by","@stdlib/utils/object-inverse"
 "@stdlib/utils/keys","@stdlib/utils/entries,@stdlib/utils/keys-in,@stdlib/utils/nonindex-keys,@stdlib/utils/values"
 "@stdlib/utils/values","@stdlib/utils/entries,@stdlib/utils/keys"
 "@stdlib/utils/values-in","@stdlib/utils/entries-in,@stdlib/utils/keys-in,@stdlib/utils/values"

lib/node_modules/@stdlib/namespace/pkg2standalone/data/data.csv

@@ -2663,7 +2663,7 @@
 "@stdlib/utils/entries-in","@stdlib/utils-entries-in"
 "@stdlib/utils/from-entries","@stdlib/utils-from-entries"
 "@stdlib/utils/object-inverse","@stdlib/utils-object-inverse"
-"@stdlib/utils/object-inverse-by","@stdlib/utils-object-inverse-by"
+"@stdlib/object/inverse-by","@stdlib/object-inverse-by"
 "@stdlib/utils/keys","@stdlib/utils-keys"
 "@stdlib/utils/values","@stdlib/utils-values"
 "@stdlib/utils/values-in","@stdlib/utils-values-in"

lib/node_modules/@stdlib/namespace/standalone2pkg/data/data.csv

@@ -2663,7 +2663,7 @@
 "@stdlib/utils-entries-in","@stdlib/utils/entries-in"
 "@stdlib/utils-from-entries","@stdlib/utils/from-entries"
 "@stdlib/utils-object-inverse","@stdlib/utils/object-inverse"
-"@stdlib/utils-object-inverse-by","@stdlib/utils/object-inverse-by"
+"@stdlib/object-inverse-by","@stdlib/object/inverse-by"
 "@stdlib/utils-keys","@stdlib/utils/keys"
 "@stdlib/utils-values","@stdlib/utils/values"
 "@stdlib/utils-values-in","@stdlib/utils/values-in"

lib/node_modules/@stdlib/utils/object-inverse-by/README.md → lib/node_modules/@stdlib/object/inverse-by/README.md

@@ -27,7 +27,7 @@ limitations under the License.
 ## Usage
 
 ```javascript
-var invertBy = require( '@stdlib/utils/object-inverse-by' );
+var invertBy = require( '@stdlib/object/inverse-by' );
 ```
 
 #### invertBy( obj, \[options,] transform )
@@ -144,7 +144,7 @@ var out = invertBy( obj, transform );
 ```javascript
 var objectKeys = require( '@stdlib/utils/keys' );
 var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
-var invertBy = require( '@stdlib/utils/object-inverse-by' );
+var invertBy = require( '@stdlib/object/inverse-by' );
 
 function transform( key, value ) {
     return value;

lib/node_modules/@stdlib/utils/object-inverse-by/lib/index.js → lib/node_modules/@stdlib/object/inverse-by/lib/index.js

@@ -21,10 +21,10 @@
 /**
 * Invert an object, such that keys become values and values become keys, according to a transform function.
 *
-* @module @stdlib/utils/object-inverse-by
+* @module @stdlib/object/inverse-by
 *
 * @example
-* var invertBy = require( '@stdlib/utils/object-inverse-by' );
+* var invertBy = require( '@stdlib/object/inverse-by' );
 *
 * function transform( key, value ) {
 *     return key + value;
@@ -37,7 +37,7 @@
 * // returns { 'abeep': 'a', 'bboop': 'b' }
 *
 * @example
-* var invertBy = require( '@stdlib/utils/object-inverse-by' );
+* var invertBy = require( '@stdlib/object/inverse-by' );
 *
 * function transform( key, value ) {
 *     return value;
@@ -50,7 +50,7 @@
 * // returns { 'beep': [ 'a', 'b' ] }
 *
 * @example
-* var invertBy = require( '@stdlib/utils/object-inverse-by' );
+* var invertBy = require( '@stdlib/object/inverse-by' );
 *
 * function transform( key, value ) {
 *     return value;

lib/node_modules/@stdlib/utils/object-inverse-by/package.json → lib/node_modules/@stdlib/object/inverse-by/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@stdlib/utils/object-inverse-by",
+  "name": "@stdlib/object/inverse-by",
   "version": "0.0.0",
   "description": "Invert an object, such that keys become values and values become keys, according to a transform function.",
   "license": "Apache-2.0",

lib/node_modules/@stdlib/utils/docs/types/index.d.ts

@@ -152,7 +152,6 @@
 import nonIndexKeys = require( '@stdlib/utils/nonindex-keys' );
 import noop = require( '@stdlib/utils/noop' );
 import objectInverse = require( '@stdlib/utils/object-inverse' );
-import objectInverseBy = require( '@stdlib/utils/object-inverse-by' );
 import omit = require( '@stdlib/utils/omit' );
 import omitBy = require( '@stdlib/utils/omit-by' );
 import openURL = require( '@stdlib/utils/open-url' );
@@ -665,7 +664,7 @@
 	*
 	* @example
 	* var p = ns.convertPath( '/c/foo/bar/beep.c', 'win32' );
 	* // returns 'c:\\foo\\bar\\beep.c'
 	*
 	* @example
 	* var p = ns.convertPath( '/c/foo/bar/beep.c', 'mixed' );
@@ -1810,7 +1809,7 @@
 	*
 	* @example
 	* var str = ns.rescape( '[A-Z]*' );
 	* // returns '\\[A\\-Z\\]\\*'
 	*/
 	rescape: typeof rescape;
 
@@ -4051,45 +4050,6 @@
 	*/
 	objectInverse: typeof objectInverse;
 
-	/**
-	* Inverts an object, such that keys become values and values become keys, according to a transform function.
-	*
-	* ## Notes
-	*
-	* -   The transform function is provided three arguments:
-	*
-	*     -   `key`: object key.
-	*     -   `value`: object value corresponding to `key`.
-	*     -   `obj`: the input object.
-	*
-	* -   The value returned by a transform function should be a value which can be serialized as an object key. Hence, beware when providing objects having values which are themselves objects. The function relies on native object serialization (`#toString`) when converting transform function return values to keys.
-	*
-	* -   In older JavaScript engines, insertion order is not guaranteed, as object key enumeration was not specified according to the ECMAScript specification in earlier editions. In practice, however, most older engines use insertion order to sort an object's keys, thus allowing for deterministic inversion.
-	*
-	* @param obj - input object
-	* @param opts - function options
-	* @param opts.duplicates - boolean indicating whether to store duplicate keys (default: true)
-	* @param transform - transform function
-	* @returns inverted object
-	*
-	* @example
-	* function transform( key, value ) {
-	*     return value;
-	* }
-	*
-	* var obj = {};
-	* obj.a = 'beep';
-	* obj.b = 'boop';
-	* obj.c = 'beep'; // inserted after `a`
-	*
-	* var opts = {
-	*     'duplicates': false
-	* };
-	* var out = ns.objectInverseBy( obj, opts, transform );
-	* // returns { 'beep': 'c', 'boop': 'b' }
-	*/
-	objectInverseBy: typeof objectInverseBy;
-
 	/**
 	* Returns a partial object copy excluding specified keys.
 	*

lib/node_modules/@stdlib/utils/lib/index.js

@@ -1228,15 +1228,6 @@ setReadOnly( utils, 'noop', require( '@stdlib/utils/noop' ) );
 */
 setReadOnly( utils, 'objectInverse', require( '@stdlib/utils/object-inverse' ) );
 
-/**
-* @name objectInverseBy
-* @memberof utils
-* @readonly
-* @type {Function}
-* @see {@link module:@stdlib/utils/object-inverse-by}
-*/
-setReadOnly( utils, 'objectInverseBy', require( '@stdlib/utils/object-inverse-by' ) );
-
 /**
 * @name omit
 * @memberof utils

lib/node_modules/@stdlib/utils/object-inverse/README.md

@@ -144,7 +144,7 @@ console.dir( out );
 
 ## See Also
 
--   <span class="package-name">[`@stdlib/utils/object-inverse-by`][@stdlib/utils/object-inverse-by]</span><span class="delimiter">: </span><span class="description">invert an object, such that keys become values and values become keys, according to a transform function.</span>
+-   <span class="package-name">[`@stdlib/object/inverse-by`][@stdlib/object/inverse-by]</span><span class="delimiter">: </span><span class="description">invert an object, such that keys become values and values become keys, according to a transform function.</span>
 
 </section>
 
@@ -158,7 +158,7 @@ console.dir( out );
 
 <!-- <related-links> -->
 
-[@stdlib/utils/object-inverse-by]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/utils/object-inverse-by
+[@stdlib/object/inverse-by]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/object/inverse-by
 
 <!-- </related-links> -->