Auto-generated commit

Author: stdlib-bot

.github/.keepalive

@@ -188,7 +188,12 @@ jsconfig.json
 # Other editor files #
 ######################
 .idea/
-
-# Cursor #
-##########
+.cursor
 .cursorignore
+.windsurfrules
+.clinerules
+
+# AI coding agents #
+####################
+CLAUDE.md
+GEMINI.md

.gitignore

@@ -4,7 +4,17 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2025-05-26)
+## Unreleased (2025-09-19)
+
+<section class="features">
+
+### Features
+
+-   [`1908bae`](https://github.com/stdlib-js/stdlib/commit/1908bae6fe4852798ed12f620b59af50f762f2e5) - add support for `struct` and `DataType` dtype values
+
+</section>
+
+<!-- /.features -->
 
 <section class="issues">
 
@@ -24,6 +34,7 @@ A total of 2 issues were closed in this release:
 
 <details>
 
+-   [`1908bae`](https://github.com/stdlib-js/stdlib/commit/1908bae6fe4852798ed12f620b59af50f762f2e5) - **feat:** add support for `struct` and `DataType` dtype values _(by Athan Reines)_
 -   [`a464a60`](https://github.com/stdlib-js/stdlib/commit/a464a60568b819f813aff054ba0c32476192d269) - **chore:** fix EditorConfig lint errors [(#6246)](https://github.com/stdlib-js/stdlib/pull/6246) _(by MANI, Athan Reines)_
 -   [`b6a6575`](https://github.com/stdlib-js/stdlib/commit/b6a657548d4e7beacc37f26e7f49c77ae3ea2f0b) - **chore:** fix EditorConfig lint errors [(#6057)](https://github.com/stdlib-js/stdlib/pull/6057) _(by Kaushikgtm)_
 -   [`2777e4b`](https://github.com/stdlib-js/stdlib/commit/2777e4be161869d09406e3b17947d24c64b47af2) - **bench:** resolve lint errors in benchmarks _(by Athan Reines)_

CHANGELOG.md

@@ -9,35 +9,49 @@ Abdelrahman Samir <60700731+abdelrahman04@users.noreply.github.com>
 Abdul Kaium <97376242+impawstarlight@users.noreply.github.com>
 Abhay Punia <156515195+Hecker165@users.noreply.github.com>
 Abhijit Raut <abhijitmraut8010@gmail.com>
+Abhishek G <166795493+AbhishekG-Codes@users.noreply.github.com>
 Abhishek Jain <40913033+abhishekblue@users.noreply.github.com>
 Adarsh Palaskar <adarshpalaskar99@gmail.com>
 Aditya Sapra <adityaework@gmail.com>
+Aditya Singh <adityasinghk099@gmail.com>
 Ahmed Atwa <Ahmedatwa866@yahoo.com>
 Ahmed Kashkoush <ahmedkashkoush464@gmail.com>
 Ahmed Khaled <kahmd1444@gmail.com>
 Aksshay Balasubramanian <119944779+Aksshay88@users.noreply.github.com>
 Aleksandr <112382387+alextes90@users.noreply.github.com>
 Ali Salesi <ali_sal1381@yahoo.com>
-AlyAbdelmoneim <148393799+AlyAbdelmoneim@users.noreply.github.com>
+Aly Abdelmoneim <148393799+AlyAbdelmoneim@users.noreply.github.com>
 Aman Bhansali <bhansali.1@iitj.ac.in>
 AmanBhadkariya <140033975+AmanBhadkariya@users.noreply.github.com>
+Amisha Chhajed <136238836+amishhaa@users.noreply.github.com>
 Amit Jimiwal <amitjimiwal45@gmail.com>
+Anmol Sah <113588714+anmolsah@users.noreply.github.com>
+Annamalai Prabu <apfossdev@gmail.com>
 Anshu Kumar <132515490+anxhukumar@users.noreply.github.com>
 Anshu Kumar <contact.anshukumar@protonmail.com>
+Anshuman Singh <109489361+Anshumancanrock@users.noreply.github.com>
 Anudeep Sanapala <anudeep0306@gmail.com>
+Arihant Pal <arihant0pal@gmail.com>
+Aryan Bhirud <112156883+AryanBhirud@users.noreply.github.com>
+AryanJ18 <18aryanj2006@gmail.com>
 Athan Reines <kgryte@gmail.com>
+Atharva Patil <124063987+atharva-patil-23@users.noreply.github.com>
 Ayaka <73595362+USERSATOSHI@users.noreply.github.com>
 Bhavishy Agrawal <90029607+bhavishy2801@users.noreply.github.com>
 Brendan Graetz <bguiz@users.noreply.github.com>
 Bruno Fenzl <brunofenzl@gmail.com>
 Bryan Elee <rxbryn@gmail.com>
 Chinmay Joshi <86140365+JawHawk@users.noreply.github.com>
 Christopher Dambamuromo <chridam@gmail.com>
+DUDHAT HEMIL PRAVINKUMAR <138382078+Hemil36@users.noreply.github.com>
 Dan Rose <danoftheroses@gmail.com>
+Daniel Hernandez Gomez <156333015+dhernandeez13@users.noreply.github.com>
 Daniel Killenberger <daniel.killenberger@gmail.com>
 Daniel Yu <40680511+Daniel777y@users.noreply.github.com>
 Debashis Maharana <debashismaharana7854@gmail.com>
 Deep Trivedi <128926685+thedeeppp@users.noreply.github.com>
+Deepak Singh <78257493+Deepak91168@users.noreply.github.com>
+Deepak Singh <negid0253@gmail.com>
 Desh Deepak Kant <118960904+DeshDeepakKant@users.noreply.github.com>
 Dev Goel <135586571+corsairier@users.noreply.github.com>
 Dhanyabad behera <110620935+dhanyabad11@users.noreply.github.com>
@@ -53,11 +67,15 @@ Frank Kovacs <fran70kk@gmail.com>
 GK Bishnoi <gkishan1kyt@gmail.com>
 GURU PRASAD SHARMA <168292003+GURUPRASADSHARMA@users.noreply.github.com>
 Gaurav <gaurav70380@gmail.com>
+Gaurav Kaushik <144526331+Gauravkaushik-1206@users.noreply.github.com>
+Gautam Kaushik <162317291+Kaushikgtm@users.noreply.github.com>
 Gautam sharma <gautamkrishnasharma1@gmail.com>
+GeoDaoyu <geodaoyu@foxmail.com>
 Girish Garg <garggirish2020@gmail.com>
 Golden Kumar <103646877+AuenKr@users.noreply.github.com>
 Gunj Joshi <gunjjoshi8372@gmail.com>
 Gururaj Gurram <gururajgurram1512@gmail.com>
+Harishchandra Reddy <harish.7000@gmail.com>
 Haroon Rasheed <51189276+haroon26@users.noreply.github.com>
 Harsh <harshyadav6078@gmail.com>
 HarshaNP <96897754+GittyHarsha@users.noreply.github.com>
@@ -80,6 +98,7 @@ Joris Labie <joris.labie1@gmail.com>
 Justin Dennison <justin1dennison@gmail.com>
 Justyn Shelby <96994781+ShelbyJustyn@users.noreply.github.com>
 Karan Anand <anandkarancompsci@gmail.com>
+Karan Vasudevamurthy <karanlvm123@gmail.com>
 Karan Yadav <77043443+karanBRAVO@users.noreply.github.com>
 Karthik Prakash <116057817+skoriop@users.noreply.github.com>
 Kaushikgtm <162317291+Kaushikgtm@users.noreply.github.com>
@@ -89,6 +108,7 @@ Krishnam Agarwal <83017176+888krishnam@users.noreply.github.com>
 Krishnendu Das <86651039+itskdhere@users.noreply.github.com>
 Kshitij-Dale <152467202+Kshitij-Dale@users.noreply.github.com>
 Lalit Narayan Yadav <162928571+LalitNarayanYadav@users.noreply.github.com>
+Lokesh Ranjan <lokesh.ranjan.phe23@itbhu.ac.in>
 Lovelin Dhoni J B <100030865+lovelindhoni@users.noreply.github.com>
 MANI <77221000+Eternity0207@users.noreply.github.com>
 Mahfuza Humayra Mohona <mhmohona@gmail.com>
@@ -104,6 +124,8 @@ Momtchil Momtchev <momtchil@momtchev.com>
 Muhammad Haris <harriskhan047@outlook.com>
 Muhammad Taaha Tariq <166188821+Taaha-Tariq@users.noreply.github.com>
 Muhmmad Saad <106260977+saad-imran-dev@users.noreply.github.com>
+NEEKUorAAYUSH <aayush10072004@gmail.com>
+Nakul Krishnakumar <nakulkrishnakumar86@gmail.com>
 Naresh Jagadeesan <naresh.naresh000@gmail.com>
 Naveen Kumar <stupiddint@gmail.com>
 Neeraj Pathak <neerajrpathak710@gmail.com>
@@ -116,7 +138,10 @@ Nourhan Hasan <109472010+TheNourhan@users.noreply.github.com>
 Ognjen Jevremović <ognjenjevremovic@users.noreply.github.com>
 Oneday12323 <107678750+Oneday12323@users.noreply.github.com>
 Ori Miles <97595296+orimiles5@users.noreply.github.com>
+Payal Goswami <payalgoswami9711@gmail.com>
 Philipp Burckhardt <pburckhardt@outlook.com>
+Pierre Forstmann <15964998+pierreforstmann@users.noreply.github.com>
+Pradyumn Prasad <pradyumnprasad.567@gmail.com>
 Prajjwal Bajpai <142303989+prajjwalbajpai@users.noreply.github.com>
 Prajwal Kulkarni <prajwalkulkarni76@gmail.com>
 Pranav Goswami <pranavchiku11@gmail.com>
@@ -145,25 +170,32 @@ Ruthwik Chikoti <145591715+ruthwikchikoti@users.noreply.github.com>
 Ryan Seal <splrk@users.noreply.github.com>
 Rylan Yang <137365285+rylany27@users.noreply.github.com>
 SAHIL KUMAR <168997976+sahilk45@users.noreply.github.com>
+SAUJANYA MAGARDE <162047941+SaujanyaMagarde@users.noreply.github.com>
 SHIVAM YADAV <120725381+Shivam-1827@users.noreply.github.com>
 Sachin Raj <120590207+schnrj@users.noreply.github.com>
 Sahil Goyal <87982509+sahil20021008@users.noreply.github.com>
 Sai Avinash <120403424+nasarobot@users.noreply.github.com>
 Sai Srikar Dumpeti <80447788+the-r3aper7@users.noreply.github.com>
 Sanchay Ketan Sinha <122982233+satansin123@users.noreply.github.com>
 Sarthak Paandey <145528240+SarthakPaandey@users.noreply.github.com>
+Satyajeet Chavan <chavansatyajeet2004@gmail.com>
 Saurabh Singh <saurabhsraghuvanshi@gmail.com>
+Seth-Banker <125103042+Seth-Banker@users.noreply.github.com>
 Seyyed Parsa Neshaei <spneshaei@users.noreply.github.com>
 Shabareesh Shetty <139731143+ShabiShett07@users.noreply.github.com>
 Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
+Shaswata Panda <106397517+shaswata-26@users.noreply.github.com>
 Shivam Ahir <11shivam00@gmail.com>
+Shivansh <114570926+shiv343@users.noreply.github.com>
 Shraddheya Shendre <shendreshraddheya@gmail.com>
 Shubh Mehta <93862397+Shubh942@users.noreply.github.com>
 Shubham Mishra <shubh622005@gmail.com>
+Siddhesh waje <117733253+siddhesh434@users.noreply.github.com>
 Sivam Das <100067002+Sivam2313@users.noreply.github.com>
 Snehil Shah <snehilshah.989@gmail.com>
 Soumajit Chatterjee <121816890+soumajit23@users.noreply.github.com>
 Spandan Barve <contact@marsian.dev>
+Srinivas Batthula <srinivasbatthula05.official@gmail.com>
 Stephannie Jiménez Gacha <steff456@hotmail.com>
 Suhaib Ilahi <suhaib.elahi87@gmail.com>
 Suraj Kumar <125961509+kumarsuraj212003@users.noreply.github.com>
@@ -172,25 +204,32 @@ Tanishq Ahuja <68651083+TheGEN1U5@users.noreply.github.com>
 Tirtadwipa Manunggal <tirtadwipa.manunggal@gmail.com>
 Tudor Pagu <104032457+tudor-pagu@users.noreply.github.com>
 Tufailahmed Bargir <142114244+Tufailahmed-Bargir@users.noreply.github.com>
+Tushar Bhardwaj <155543597+TusharBhardwaj441@users.noreply.github.com>
+Tyson Cung <45380903+tysoncung@users.noreply.github.com>
 Uday Kakade <141299403+udaykakade25@users.noreply.github.com>
+Ujjwal Kirti <64329707+ujjwalkirti@users.noreply.github.com>
 Utkarsh <http://utkarsh11105@gmail.com>
 Utkarsh Raj <rajutkarsh2505@gmail.com>
 UtkershBasnet <119008923+UtkershBasnet@users.noreply.github.com>
 Vaibhav Patel <98279986+noobCoderVP@users.noreply.github.com>
+Vansh Choudhary <iamvanshchaudhary7@gmail.com>
 Vara Rahul Rajana <123227543+rajanarahul93@users.noreply.github.com>
 Varad Gupta <varadgupta21@gmail.com>
 Vinit Pandit <106718914+MeastroZI@users.noreply.github.com>
 Vivek Maurya <vm8118134@gmail.com>
+Wendy Yuchen Sun <wendyyuchensun@gmail.com>
 Xiaochuan Ye <tap91624@gmail.com>
 Yaswanth Kosuru <116426380+yaswanthkosuru@users.noreply.github.com>
 Yernar Yergaziyev <yernar.yergaziyev@erg.kz>
 Yugal Kaushik <yugalkaushik14@gmail.com>
 Yuvi Mittal <128018763+yuvi-mittal@users.noreply.github.com>
+deepak427 <62477872+deepak427@users.noreply.github.com>
 devshree-bhati <147095250+devshree-bhati@users.noreply.github.com>
 ditsu <170345142+ditsus@users.noreply.github.com>
 ekambains <bainsinbusiness@gmail.com>
 fadiothman22 <48636283+fadiothman22@users.noreply.github.com>
 iraandrushko <71790513+iraandrushko@users.noreply.github.com>
+jsai28 <54253219+jsai28@users.noreply.github.com>
 lohithganni <116790357+lohithganni@users.noreply.github.com>
 olenkabilonizhka <62379231+olenkabilonizhka@users.noreply.github.com>
 pranav-1720 <123018993+pranav-1720@users.noreply.github.com>

CONTRIBUTORS

@@ -33,7 +33,7 @@ limitations under the License.
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
 
-> Return the number of bytes per element provided an underlying [array data type][@stdlib/ndarray/dtypes].
+> Return the number of bytes per element for a provided underlying [ndarray data type][@stdlib/ndarray/dtypes].
 
 <!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
 
@@ -75,7 +75,7 @@ var bytesPerElement = require( '@stdlib/ndarray-base-bytes-per-element' );
 
 #### bytesPerElement( dtype )
 
-Returns the number of bytes per element provided an underlying [array data type][@stdlib/ndarray/dtypes].
+Returns the number of bytes per element for a provided underlying [ndarray data type][@stdlib/ndarray/dtypes].
 
 ```javascript
 var nbytes = bytesPerElement( 'float64' );
@@ -115,11 +115,7 @@ var nbytes = bytesPerElement( 'foobar' );
 ```javascript
 var bytesPerElement = require( '@stdlib/ndarray-base-bytes-per-element' );
 
-var dtypes;
-var nbytes;
-var i;
-
-dtypes = [
+var dtypes = [
     'float64',
     'float32',
     'int8',
@@ -134,6 +130,8 @@ dtypes = [
     'foobar'
 ];
 
+var nbytes;
+var i;
 for ( i = 0; i < dtypes.length; i++ ) {
     nbytes = bytesPerElement( dtypes[ i ] );
     nbytes = ( nbytes ) ? nbytes+' bytes' : 'null';

README.md

@@ -21,13 +21,15 @@
 // MODULES //
 
 var bench = require( '@stdlib/bench-harness' );
+var DataType = require( '@stdlib/ndarray-dtype-ctor' );
+var structFactory = require( '@stdlib/dstructs-struct' );
 var pkg = require( './../package.json' ).name;
 var bytesPerElement = require( './../lib' );
 
 
 // MAIN //
 
-bench( pkg, function benchmark( b ) {
+bench( pkg+'::string', function benchmark( b ) {
 	var dtypes;
 	var dtype;
 	var out;
@@ -63,3 +65,125 @@ bench( pkg, function benchmark( b ) {
 	b.pass( 'benchmark finished' );
 	b.end();
 });
+
+bench( pkg+'::struct', function benchmark( b ) {
+	var schemas;
+	var dtypes;
+	var dtype;
+	var out;
+	var i;
+
+	schemas = [
+		[
+			{
+				'name': 'foo',
+				'type': 'float64'
+			}
+		],
+		[
+			{
+				'name': 'foo',
+				'type': 'float32'
+			}
+		]
+	];
+
+	dtypes = [
+		structFactory( schemas[ 0 ] ),
+		structFactory( schemas[ 1 ] )
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		dtype = dtypes[ i%dtypes.length ];
+		out = bytesPerElement( dtype );
+		if ( out !== out ) {
+			b.fail( 'should not return NaN' );
+		}
+	}
+	b.toc();
+	if ( out !== out ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
+bench( pkg+'::data_type_instance,string', function benchmark( b ) {
+	var dtypes;
+	var dtype;
+	var out;
+	var i;
+
+	dtypes = [
+		new DataType( 'float64' ),
+		new DataType( 'float32' ),
+		new DataType( 'int8' ),
+		new DataType( 'uint8' ),
+		new DataType( 'uint8c' ),
+		new DataType( 'int16' ),
+		new DataType( 'uint16' ),
+		new DataType( 'int32' ),
+		new DataType( 'uint32' ),
+		new DataType( 'binary' ),
+		new DataType( 'generic' )
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		dtype = dtypes[ i%dtypes.length ];
+		out = bytesPerElement( dtype );
+		if ( out !== out ) {
+			b.fail( 'should not return NaN' );
+		}
+	}
+	b.toc();
+	if ( out !== out ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
+bench( pkg+'::data_type_instance,struct', function benchmark( b ) {
+	var schemas;
+	var dtypes;
+	var dtype;
+	var out;
+	var i;
+
+	schemas = [
+		[
+			{
+				'name': 'foo',
+				'type': 'float64'
+			}
+		],
+		[
+			{
+				'name': 'foo',
+				'type': 'float32'
+			}
+		]
+	];
+
+	dtypes = [
+		new DataType( structFactory( schemas[ 0 ] ) ),
+		new DataType( structFactory( schemas[ 1 ] ) )
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		dtype = dtypes[ i%dtypes.length ];
+		out = bytesPerElement( dtype );
+		if ( out !== out ) {
+			b.fail( 'should not return NaN' );
+		}
+	}
+	b.toc();
+	if ( out !== out ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});