@stdlib/ndarray-base-buffer-ctors 0.2.1 → 0.4.0

package/NOTICE

@@ -1 +1 @@
-Copyright (c) 2016-2024 The Stdlib Authors.
+Copyright (c) 2016-2026 The Stdlib Authors.

package/README.md

@@ -2,7 +2,7 @@
 
 @license Apache-2.0
 
-Copyright (c) 2018 The Stdlib Authors.
+Copyright (c) 2024 The Stdlib Authors.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -65,30 +65,14 @@ var ctors = require( '@stdlib/ndarray-base-buffer-ctors' );
 
 #### ctors( dtype )
 
-Returns an ndarray data buffer constructor for a specified data type.
+Returns an ndarray data buffer constructor for a specified [data type][@stdlib/ndarray/dtypes].
 
 ```javascript
 var ctor = ctors( 'float64' );
 // returns <Function>
 ```
 
-The function returns constructors for the following data types:
-
--   `binary`: binary.
--   `complex64`: single-precision complex floating-point numbers.
--   `complex128`: double-precision complex floating-point numbers.
--   `float32`: single-precision floating-point numbers.
--   `float64`: double-precision floating-point numbers.
--   `generic`: values of any type.
--   `int16`: signed 16-bit integers.
--   `int32`: signed 32-bit integers.
--   `int8`: signed 8-bit integers.
--   `uint16`: unsigned 16-bit integers.
--   `uint32`: unsigned 32-bit integers.
--   `uint8`: unsigned 8-bit integers.
--   `uint8c`: unsigned clamped 8-bit integers.
-
-If provided an unknown or unsupported data type, the function returns `null`.
+If provided an unknown or unsupported [data type][@stdlib/ndarray/dtypes], the function returns `null`.
 
 ```javascript
 var ctor = ctors( 'float' );
@@ -116,17 +100,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>
@@ -175,7 +154,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2026. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -188,8 +167,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/ndarray-base-buffer-ctors.svg
 [npm-url]: https://npmjs.org/package/@stdlib/ndarray-base-buffer-ctors
 
-[test-image]: https://github.com/stdlib-js/ndarray-base-buffer-ctors/actions/workflows/test.yml/badge.svg?branch=v0.2.1
-[test-url]: https://github.com/stdlib-js/ndarray-base-buffer-ctors/actions/workflows/test.yml?query=branch:v0.2.1
+[test-image]: https://github.com/stdlib-js/ndarray-base-buffer-ctors/actions/workflows/test.yml/badge.svg?branch=v0.4.0
+[test-url]: https://github.com/stdlib-js/ndarray-base-buffer-ctors/actions/workflows/test.yml?query=branch:v0.4.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/ndarray-base-buffer-ctors/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/ndarray-base-buffer-ctors?branch=main
@@ -201,8 +180,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 -->
 
-[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
-[chat-url]: https://app.gitter.im/#/room/#stdlib-js_stdlib:gitter.im
+[chat-image]: https://img.shields.io/badge/zulip-join_chat-brightgreen.svg
+[chat-url]: https://stdlib.zulipchat.com
 
 [stdlib]: https://github.com/stdlib-js/stdlib
 
@@ -221,6 +200,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/ndarray-base-buffer-ctors/main/LICENSE
 
+[@stdlib/ndarray/dtypes]: https://www.npmjs.com/package/@stdlib/ndarray-dtypes
+
 </section>
 
 <!-- /.links -->

package/dist/index.js

@@ -1,7 +1,36 @@
-"use strict";var a=function(e,r){return function(){return r||e((r={exports:{}}).exports,r),r.exports}};var t=a(function(d,i){
-var v=require('@stdlib/buffer-ctor/dist'),o=require('@stdlib/array-float64/dist'),q=require('@stdlib/array-float32/dist'),y=require('@stdlib/array-int16/dist'),l=require('@stdlib/array-int32/dist'),A=require('@stdlib/array-int8/dist'),s=require('@stdlib/array-uint16/dist'),c=require('@stdlib/array-uint32/dist'),p=require('@stdlib/array-uint8/dist'),x=require('@stdlib/array-uint8c/dist'),m=require('@stdlib/array-complex64/dist'),f=require('@stdlib/array-complex128/dist'),U={binary:v,float64:o,float32:q,generic:Array,int16:y,int32:l,int8:A,uint16:s,uint32:c,uint8:p,uint8c:x,complex64:m,complex128:f};i.exports=U
-});var n=a(function(g,u){
-var C=t();function I(e){return C[e]||null}u.exports=I
-});var b=n();module.exports=b;
-/** @license Apache-2.0 */
+"use strict";var i=function(a,r){return function(){return r||a((r={exports:{}}).exports,r),r.exports}};var o=i(function(T,n){"use strict";var c=require("@stdlib/buffer-ctor"),s=require("@stdlib/array-float64"),y=require("@stdlib/array-float32"),A=require("@stdlib/array-int16"),f=require("@stdlib/array-int32"),m=require("@stdlib/array-int8"),p=require("@stdlib/array-uint16"),x=require("@stdlib/array-uint32"),C=require("@stdlib/array-uint8"),F=require("@stdlib/array-uint8c"),I=require("@stdlib/array-complex64"),U=require("@stdlib/array-complex128"),b=require("@stdlib/array-bool");function u(){throw new Error("not implemented")}var w={binary:c,float64:s,float32:y,float16:u,generic:Array,int16:A,int32:f,int8:m,uint16:p,uint32:x,uint8:C,uint8c:F,complex32:u,complex64:I,complex128:U,bool:b};n.exports=w});var q=i(function(j,l){"use strict";var B=require("@stdlib/assert-is-function"),E=require("@stdlib/ndarray-base-assert-is-struct-data-type"),S=require("@stdlib/ndarray-base-dtype-resolve-str"),g=require("@stdlib/array-struct-factory"),h=o(),v={};function k(a){var r,e,t;return!B(a)&&(t=S(a),e=h[t]||null,e)?e:E(a)?(t?r=a.value:(r=a,t=r.layout),e=v[t],e||(e=g(r),v[t]=e,e)):null}l.exports=k});var D=q();module.exports=D;
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../lib/ctors.js", "../lib/main.js", "../lib/index.js"],
-  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar Buffer = require( '@stdlib/buffer-ctor' );\nvar Float64Array = require( '@stdlib/array-float64' );\nvar Float32Array = require( '@stdlib/array-float32' );\nvar Int16Array = require( '@stdlib/array-int16' );\nvar Int32Array = require( '@stdlib/array-int32' );\nvar Int8Array = require( '@stdlib/array-int8' );\nvar Uint16Array = require( '@stdlib/array-uint16' );\nvar Uint32Array = require( '@stdlib/array-uint32' );\nvar Uint8Array = require( '@stdlib/array-uint8' );\nvar Uint8ClampedArray = require( '@stdlib/array-uint8c' );\nvar Complex64Array = require( '@stdlib/array-complex64' );\nvar Complex128Array = require( '@stdlib/array-complex128' );\n\n\n// MAIN //\n\n// Mapping from data types to underlying buffer constructors...\nvar ctors = {\n\t'binary': Buffer,\n\t'float64': Float64Array,\n\t'float32': Float32Array,\n\t'generic': Array, // TODO: replace with `stdlib` pkg\n\t'int16': Int16Array,\n\t'int32': Int32Array,\n\t'int8': Int8Array,\n\t'uint16': Uint16Array,\n\t'uint32': Uint32Array,\n\t'uint8': Uint8Array,\n\t'uint8c': Uint8ClampedArray,\n\t'complex64': Complex64Array,\n\t'complex128': Complex128Array\n};\n\n\n// EXPORTS //\n\nmodule.exports = ctors;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar table = require( './ctors.js' );\n\n\n// MAIN //\n\n/**\n* Returns an ndarray data buffer constructor.\n*\n* @param {string} dtype - data type\n* @returns {(Function|null)} data buffer constructor or null\n*\n* @example\n* var ctor = ctors( 'float64' );\n* // returns <Function>\n*\n* @example\n* var ctor = ctors( 'float' );\n* // returns null\n*/\nfunction ctors( dtype ) {\n\treturn table[ dtype ] || null;\n}\n\n\n// EXPORTS //\n\nmodule.exports = ctors;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* ndarray data buffer constructors.\n*\n* @module @stdlib/ndarray-base-buffer-ctors\n*\n* @example\n* var ctors = require( '@stdlib/ndarray-base-buffer-ctors' );\n*\n* var ctor = ctors( 'float64' );\n* // returns <Function>\n*\n* ctor = ctors( 'int' );\n* // returns null\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
-  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAS,QAAS,qBAAsB,EACxCC,EAAe,QAAS,uBAAwB,EAChDC,EAAe,QAAS,uBAAwB,EAChDC,EAAa,QAAS,qBAAsB,EAC5CC,EAAa,QAAS,qBAAsB,EAC5CC,EAAY,QAAS,oBAAqB,EAC1CC,EAAc,QAAS,sBAAuB,EAC9CC,EAAc,QAAS,sBAAuB,EAC9CC,EAAa,QAAS,qBAAsB,EAC5CC,EAAoB,QAAS,sBAAuB,EACpDC,EAAiB,QAAS,yBAA0B,EACpDC,EAAkB,QAAS,0BAA2B,EAMtDC,EAAQ,CACX,OAAUZ,EACV,QAAWC,EACX,QAAWC,EACX,QAAW,MACX,MAASC,EACT,MAASC,EACT,KAAQC,EACR,OAAUC,EACV,OAAUC,EACV,MAASC,EACT,OAAUC,EACV,UAAaC,EACb,WAAcC,CACf,EAKAZ,EAAO,QAAUa,IC1DjB,IAAAC,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAQ,IAmBZ,SAASC,EAAOC,EAAQ,CACvB,OAAOF,EAAOE,CAAM,GAAK,IAC1B,CAKAH,EAAO,QAAUE,ICXjB,IAAIE,EAAO,IAKX,OAAO,QAAUA",
-  "names": ["require_ctors", "__commonJSMin", "exports", "module", "Buffer", "Float64Array", "Float32Array", "Int16Array", "Int32Array", "Int8Array", "Uint16Array", "Uint32Array", "Uint8Array", "Uint8ClampedArray", "Complex64Array", "Complex128Array", "ctors", "require_main", "__commonJSMin", "exports", "module", "table", "ctors", "dtype", "main"]
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2024 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar Buffer = require( '@stdlib/buffer-ctor' );\nvar Float64Array = require( '@stdlib/array-float64' );\nvar Float32Array = require( '@stdlib/array-float32' );\nvar Int16Array = require( '@stdlib/array-int16' );\nvar Int32Array = require( '@stdlib/array-int32' );\nvar Int8Array = require( '@stdlib/array-int8' );\nvar Uint16Array = require( '@stdlib/array-uint16' );\nvar Uint32Array = require( '@stdlib/array-uint32' );\nvar Uint8Array = require( '@stdlib/array-uint8' );\nvar Uint8ClampedArray = require( '@stdlib/array-uint8c' );\nvar Complex64Array = require( '@stdlib/array-complex64' );\nvar Complex128Array = require( '@stdlib/array-complex128' );\nvar BooleanArray = require( '@stdlib/array-bool' );\n\n\n// FUNCTIONS //\n\n/**\n* Throws an error.\n*\n* @private\n* @throws {Error} not implemented\n*/\nfunction notImplemented() {\n\tthrow new Error( 'not implemented' );\n}\n\n\n// MAIN //\n\n// Mapping from data types to underlying buffer constructors...\nvar ctors = { // eslint-disable-line vars-on-top\n\t'binary': Buffer,\n\t'float64': Float64Array,\n\t'float32': Float32Array,\n\t'float16': notImplemented, // FIXME: replace with Float16Array constructor once implemented\n\t'generic': Array, // TODO: replace with `stdlib` pkg\n\t'int16': Int16Array,\n\t'int32': Int32Array,\n\t'int8': Int8Array,\n\t'uint16': Uint16Array,\n\t'uint32': Uint32Array,\n\t'uint8': Uint8Array,\n\t'uint8c': Uint8ClampedArray,\n\t'complex32': notImplemented, // FIXME: replace with Complex32Array constructor once implemented\n\t'complex64': Complex64Array,\n\t'complex128': Complex128Array,\n\t'bool': BooleanArray\n};\n\n\n// EXPORTS //\n\nmodule.exports = ctors;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isFunction = require( '@stdlib/assert-is-function' );\nvar isStructDataType = require( '@stdlib/ndarray-base-assert-is-struct-data-type' );\nvar resolveStr = require( '@stdlib/ndarray-base-dtype-resolve-str' );\nvar structFactory = require( '@stdlib/array-struct-factory' );\nvar table = require( './ctors.js' );\n\n\n// VARIABLES //\n\n// Initialize a cache to storing memoized struct array constructors:\nvar CACHE = {}; // TODO: consider adding/using `@stdlib/array/memoized-struct-factory`; should we need to memoize struct array constructors elsewhere, we should centralize that logic, rather than have multiple caches.\n\n\n// MAIN //\n\n/**\n* Returns an ndarray data buffer constructor.\n*\n* @param {*} dtype - data type\n* @returns {(Function|null)} data buffer constructor or null\n*\n* @example\n* var ctor = ctors( 'float64' );\n* // returns <Function>\n*\n* @example\n* var ctor = ctors( 'float' );\n* // returns null\n*/\nfunction ctors( dtype ) {\n\tvar struct;\n\tvar ctor;\n\tvar key;\n\n\t// Case: string || dtype_instance_with_string\n\tif ( !isFunction( dtype ) ) {\n\t\tkey = resolveStr( dtype );\n\t\tctor = table[ key ] || null;\n\t\tif ( ctor ) {\n\t\t\treturn ctor;\n\t\t}\n\t}\n\t// Case: struct_ctor || dtype_instance_with_struct_ctor\n\tif ( isStructDataType( dtype ) ) {\n\t\tif ( key ) {\n\t\t\t// Data type instance (note: we assume that `key === struct.layout`):\n\t\t\tstruct = dtype.value;\n\t\t} else {\n\t\t\t// Struct constructor:\n\t\t\tstruct = dtype;\n\t\t\tkey = struct.layout;\n\t\t}\n\t\tctor = CACHE[ key ];\n\t\tif ( ctor ) {\n\t\t\treturn ctor;\n\t\t}\n\t\tctor = structFactory( struct );\n\t\tCACHE[ key ] = ctor;\n\t\treturn ctor;\n\t}\n\treturn null;\n}\n\n\n// EXPORTS //\n\nmodule.exports = ctors;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* ndarray data buffer constructors.\n*\n* @module @stdlib/ndarray-base-buffer-ctors\n*\n* @example\n* var ctors = require( '@stdlib/ndarray-base-buffer-ctors' );\n*\n* var ctor = ctors( 'float64' );\n* // returns <Function>\n*\n* ctor = ctors( 'int' );\n* // returns null\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAS,QAAS,qBAAsB,EACxCC,EAAe,QAAS,uBAAwB,EAChDC,EAAe,QAAS,uBAAwB,EAChDC,EAAa,QAAS,qBAAsB,EAC5CC,EAAa,QAAS,qBAAsB,EAC5CC,EAAY,QAAS,oBAAqB,EAC1CC,EAAc,QAAS,sBAAuB,EAC9CC,EAAc,QAAS,sBAAuB,EAC9CC,EAAa,QAAS,qBAAsB,EAC5CC,EAAoB,QAAS,sBAAuB,EACpDC,EAAiB,QAAS,yBAA0B,EACpDC,EAAkB,QAAS,0BAA2B,EACtDC,EAAe,QAAS,oBAAqB,EAWjD,SAASC,GAAiB,CACzB,MAAM,IAAI,MAAO,iBAAkB,CACpC,CAMA,IAAIC,EAAQ,CACX,OAAUd,EACV,QAAWC,EACX,QAAWC,EACX,QAAWW,EACX,QAAW,MACX,MAASV,EACT,MAASC,EACT,KAAQC,EACR,OAAUC,EACV,OAAUC,EACV,MAASC,EACT,OAAUC,EACV,UAAaI,EACb,UAAaH,EACb,WAAcC,EACd,KAAQC,CACT,EAKAb,EAAO,QAAUe,IC3EjB,IAAAC,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAa,QAAS,4BAA6B,EACnDC,EAAmB,QAAS,iDAAkD,EAC9EC,EAAa,QAAS,wCAAyC,EAC/DC,EAAgB,QAAS,8BAA+B,EACxDC,EAAQ,IAMRC,EAAQ,CAAC,EAmBb,SAASC,EAAOC,EAAQ,CACvB,IAAIC,EACAC,EACAC,EAGJ,MAAK,CAACV,EAAYO,CAAM,IACvBG,EAAMR,EAAYK,CAAM,EACxBE,EAAOL,EAAOM,CAAI,GAAK,KAClBD,GACGA,EAIJR,EAAkBM,CAAM,GACvBG,EAEJF,EAASD,EAAM,OAGfC,EAASD,EACTG,EAAMF,EAAO,QAEdC,EAAOJ,EAAOK,CAAI,EACbD,IAGLA,EAAON,EAAeK,CAAO,EAC7BH,EAAOK,CAAI,EAAID,EACRA,IAED,IACR,CAKAV,EAAO,QAAUO,ICnDjB,IAAIK,EAAO,IAKX,OAAO,QAAUA",
+  "names": ["require_ctors", "__commonJSMin", "exports", "module", "Buffer", "Float64Array", "Float32Array", "Int16Array", "Int32Array", "Int8Array", "Uint16Array", "Uint32Array", "Uint8Array", "Uint8ClampedArray", "Complex64Array", "Complex128Array", "BooleanArray", "notImplemented", "ctors", "require_main", "__commonJSMin", "exports", "module", "isFunction", "isStructDataType", "resolveStr", "structFactory", "table", "CACHE", "ctors", "dtype", "struct", "ctor", "key", "main"]
 }

package/docs/types/index.d.ts

@@ -32,7 +32,7 @@
 * var ctor = ctors( 'float' );
 * // returns null
 */
-declare function ctors( dtype: string ): Function | null;
+declare function ctors( dtype: any ): Function | null;
 
 
 // EXPORTS //

package/lib/ctors.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2018 The Stdlib Authors.
+* Copyright (c) 2024 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -32,15 +32,30 @@ var Uint8Array = require( '@stdlib/array-uint8' );
 var Uint8ClampedArray = require( '@stdlib/array-uint8c' );
 var Complex64Array = require( '@stdlib/array-complex64' );
 var Complex128Array = require( '@stdlib/array-complex128' );
+var BooleanArray = require( '@stdlib/array-bool' );
+
+
+// FUNCTIONS //
+
+/**
+* Throws an error.
+*
+* @private
+* @throws {Error} not implemented
+*/
+function notImplemented() {
+	throw new Error( 'not implemented' );
+}
 
 
 // MAIN //
 
 // Mapping from data types to underlying buffer constructors...
-var ctors = {
+var ctors = { // eslint-disable-line vars-on-top
 	'binary': Buffer,
 	'float64': Float64Array,
 	'float32': Float32Array,
+	'float16': notImplemented, // FIXME: replace with Float16Array constructor once implemented
 	'generic': Array, // TODO: replace with `stdlib` pkg
 	'int16': Int16Array,
 	'int32': Int32Array,
@@ -49,8 +64,10 @@ var ctors = {
 	'uint32': Uint32Array,
 	'uint8': Uint8Array,
 	'uint8c': Uint8ClampedArray,
+	'complex32': notImplemented, // FIXME: replace with Complex32Array constructor once implemented
 	'complex64': Complex64Array,
-	'complex128': Complex128Array
+	'complex128': Complex128Array,
+	'bool': BooleanArray
 };
 
 

package/lib/main.js

@@ -20,15 +20,25 @@
 
 // MODULES //
 
+var isFunction = require( '@stdlib/assert-is-function' );
+var isStructDataType = require( '@stdlib/ndarray-base-assert-is-struct-data-type' );
+var resolveStr = require( '@stdlib/ndarray-base-dtype-resolve-str' );
+var structFactory = require( '@stdlib/array-struct-factory' );
 var table = require( './ctors.js' );
 
 
+// VARIABLES //
+
+// Initialize a cache to storing memoized struct array constructors:
+var CACHE = {}; // TODO: consider adding/using `@stdlib/array/memoized-struct-factory`; should we need to memoize struct array constructors elsewhere, we should centralize that logic, rather than have multiple caches.
+
+
 // MAIN //
 
 /**
 * Returns an ndarray data buffer constructor.
 *
-* @param {string} dtype - data type
+* @param {*} dtype - data type
 * @returns {(Function|null)} data buffer constructor or null
 *
 * @example
@@ -40,7 +50,37 @@ var table = require( './ctors.js' );
 * // returns null
 */
 function ctors( dtype ) {
-	return table[ dtype ] || null;
+	var struct;
+	var ctor;
+	var key;
+
+	// Case: string || dtype_instance_with_string
+	if ( !isFunction( dtype ) ) {
+		key = resolveStr( dtype );
+		ctor = table[ key ] || null;
+		if ( ctor ) {
+			return ctor;
+		}
+	}
+	// Case: struct_ctor || dtype_instance_with_struct_ctor
+	if ( isStructDataType( dtype ) ) {
+		if ( key ) {
+			// Data type instance (note: we assume that `key === struct.layout`):
+			struct = dtype.value;
+		} else {
+			// Struct constructor:
+			struct = dtype;
+			key = struct.layout;
+		}
+		ctor = CACHE[ key ];
+		if ( ctor ) {
+			return ctor;
+		}
+		ctor = structFactory( struct );
+		CACHE[ key ] = ctor;
+		return ctor;
+	}
+	return null;
 }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/ndarray-base-buffer-ctors",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "ndarray data buffer constructors.",
   "license": "Apache-2.0",
   "author": {
@@ -30,18 +30,23 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/array-complex128": "^0.2.1",
-    "@stdlib/array-complex64": "^0.2.1",
-    "@stdlib/array-float32": "^0.2.1",
-    "@stdlib/array-float64": "^0.2.1",
-    "@stdlib/array-int16": "^0.2.1",
-    "@stdlib/array-int32": "^0.2.1",
-    "@stdlib/array-int8": "^0.2.1",
-    "@stdlib/array-uint16": "^0.2.1",
-    "@stdlib/array-uint32": "^0.2.1",
-    "@stdlib/array-uint8": "^0.2.1",
-    "@stdlib/array-uint8c": "^0.2.1",
-    "@stdlib/buffer-ctor": "^0.2.1"
+    "@stdlib/array-bool": "^0.1.1",
+    "@stdlib/array-complex128": "^0.3.1",
+    "@stdlib/array-complex64": "^0.3.1",
+    "@stdlib/array-float32": "^0.2.2",
+    "@stdlib/array-float64": "^0.2.2",
+    "@stdlib/array-int16": "^0.2.2",
+    "@stdlib/array-int32": "^0.2.2",
+    "@stdlib/array-int8": "^0.2.2",
+    "@stdlib/array-struct-factory": "github:stdlib-js/array-struct-factory#main",
+    "@stdlib/array-uint16": "^0.2.2",
+    "@stdlib/array-uint32": "^0.2.2",
+    "@stdlib/array-uint8": "^0.2.2",
+    "@stdlib/array-uint8c": "^0.2.2",
+    "@stdlib/assert-is-function": "^0.2.2",
+    "@stdlib/buffer-ctor": "^0.2.2",
+    "@stdlib/ndarray-base-assert-is-struct-data-type": "^0.1.0",
+    "@stdlib/ndarray-base-dtype-resolve-str": "^0.3.0"
   },
   "devDependencies": {},
   "engines": {
@@ -80,7 +85,6 @@
     "utils",
     "util"
   ],
-  "__stdlib__": {},
   "funding": {
     "type": "opencollective",
     "url": "https://opencollective.com/stdlib"