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

@@ -2,6 +2,51 @@
 
 > Package changelog.
 
+<section class="release" id="unreleased">
+
+## Unreleased (2025-09-19)
+
+<section class="features">
+
+### Features
+
+-   [`8d28862`](https://github.com/stdlib-js/stdlib/commit/8d28862f79b21b726cd80d47f85c73cf6d2d2d5c) - add support for `struct` and `DataType` dtype values
+
+</section>
+
+<!-- /.features -->
+
+<section class="commits">
+
+### Commits
+
+<details>
+
+-   [`04c434a`](https://github.com/stdlib-js/stdlib/commit/04c434ac661b2f006a1ab737efb1dec2a72b0efd) - **docs:** update type _(by Athan Reines)_
+-   [`8d28862`](https://github.com/stdlib-js/stdlib/commit/8d28862f79b21b726cd80d47f85c73cf6d2d2d5c) - **feat:** add support for `struct` and `DataType` dtype values _(by Athan Reines)_
+
+</details>
+
+</section>
+
+<!-- /.commits -->
+
+<section class="contributors">
+
+### Contributors
+
+A total of 1 person contributed to this release. Thank you to this contributor:
+
+-   Athan Reines
+
+</section>
+
+<!-- /.contributors -->
+
+</section>
+
+<!-- /.release -->
+
 <section class="release" id="v0.3.0">
 
 ## 0.3.0 (2024-07-29)

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

@@ -110,17 +110,12 @@ var ctor = ctors( 'float' );
 <!-- eslint no-undef: "error" -->
 
 ```javascript
+var logEachMap = require( '@stdlib/console-log-each-map' );
 var dtypes = require( '@stdlib/ndarray-dtypes' );
 var ctors = require( '@stdlib/ndarray-base-buffer-ctors' );
 
-var DTYPES = dtypes();
-
-var ctor;
-var i;
-for ( i = 0; i < DTYPES.length; i++ ) {
-    ctor = ctors( DTYPES[ i ] );
-    console.log( ctor );
-}
+var dts = dtypes( 'integer_and_generic' );
+logEachMap( '%s => %s', dts, ctors );
 ```
 
 </section>

README.md

@@ -21,20 +21,22 @@
 // MODULES //
 
 var bench = require( '@stdlib/bench-harness' );
+var DataType = require( '@stdlib/ndarray-dtype-ctor' );
 var dtypes = require( '@stdlib/ndarray-dtypes' );
+var structFactory = require( '@stdlib/dstructs-struct' );
 var isFunction = require( '@stdlib/assert-is-function' );
 var pkg = require( './../package.json' ).name;
 var ctors = require( './../lib' );
 
 
 // VARIABLES //
 
-var DTYPES = dtypes();
+var DTYPES = dtypes( 'integer_and_generic' );
 
 
 // MAIN //
 
-bench( pkg, function benchmark( b ) {
+bench( pkg+'::strings', function benchmark( b ) {
 	var ctor;
 	var i;
 
@@ -52,3 +54,103 @@ bench( pkg, function benchmark( b ) {
 	b.pass( 'benchmark finished' );
 	b.end();
 });
+
+bench( pkg+'::data_type_instances,strings', function benchmark( b ) {
+	var values;
+	var ctor;
+	var i;
+
+	values = [
+		new DataType( 'float64' ),
+		new DataType( 'float32' ),
+		new DataType( 'int32' )
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		ctor = ctors( values[ i%values.length ] );
+		if ( typeof ctor !== 'function' ) {
+			b.fail( 'should return a function' );
+		}
+	}
+	b.toc();
+	if ( !isFunction( ctor ) ) {
+		b.fail( 'should return a function' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
+bench( pkg+'::structs', function benchmark( b ) {
+	var schema;
+	var values;
+	var ctor;
+	var i;
+
+	schema = [
+		{
+			'name': 'beep',
+			'type': 'float64'
+		},
+		{
+			'name': 'boop',
+			'type': 'int32'
+		}
+	];
+
+	values = [
+		structFactory( schema ),
+		structFactory( schema )
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		ctor = ctors( values[ i%values.length ] );
+		if ( typeof ctor !== 'function' ) {
+			b.fail( 'should return a function' );
+		}
+	}
+	b.toc();
+	if ( !isFunction( ctor ) ) {
+		b.fail( 'should return a function' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
+bench( pkg+'::data_type_instances,structs', function benchmark( b ) {
+	var schema;
+	var values;
+	var ctor;
+	var i;
+
+	schema = [
+		{
+			'name': 'beep',
+			'type': 'float64'
+		},
+		{
+			'name': 'boop',
+			'type': 'int32'
+		}
+	];
+
+	values = [
+		new DataType( structFactory( schema ) ),
+		new DataType( structFactory( schema ) )
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		ctor = ctors( values[ i%values.length ] );
+		if ( typeof ctor !== 'function' ) {
+			b.fail( 'should return a function' );
+		}
+	}
+	b.toc();
+	if ( !isFunction( ctor ) ) {
+		b.fail( 'should return a function' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});