feat: add support for getting and setting data and add shorthand properties

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: passed
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/plot/charts/base/quantitative/examples/index.js

@@ -22,7 +22,7 @@ var QuantitativeChart = require( './../lib' );
 
 var chart = new QuantitativeChart({
 	'title': 'Hello World!',
-	'xLabel': 'Hello',
-	'yLabel': 'World'
+	'xTitle': 'Hello',
+	'yTitle': 'World'
 });
 console.log( chart.toJSON() );

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/channels/get.js

@@ -0,0 +1,44 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+/* eslint-disable no-invalid-this */
+
+'use strict';
+
+// MODULES //
+
+var objectAssign = require( '@stdlib/object/assign' );
+var prop = require( './properties.js' );
+
+
+// MAIN //
+
+/**
+* Returns an object mapping chart data field names to encoding channels.
+*
+* @private
+* @returns {Object} channels
+*/
+function get() {
+	return objectAssign( {}, this[ prop.private ] );
+}
+
+
+// EXPORTS //
+
+module.exports = get;

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/channels/properties.js

@@ -0,0 +1,33 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var property2object = require( '@stdlib/plot/vega/base/property2object' );
+
+
+// MAIN //
+
+var obj = property2object( 'channels' );
+
+
+// EXPORTS //
+
+module.exports = obj;

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/channels/set.js

@@ -0,0 +1,63 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+/* eslint-disable no-invalid-this */
+
+'use strict';
+
+// MODULES //
+
+var logger = require( 'debug' );
+var isObject = require( '@stdlib/assert/is-object' );
+var objectAssignIn = require( '@stdlib/object/assign-in' );
+var format = require( '@stdlib/string/format' );
+var changeEvent = require( './../change_event.js' );
+var prop = require( './properties.js' );
+
+
+// VARIABLES //
+
+var debug = logger( 'quantitative-chart:channels:set:'+prop.name );
+
+
+// MAIN //
+
+/**
+* Sets an object mapping chart data field names to encoding channels.
+*
+* @private
+* @param {Object} value - input value
+* @throws {TypeError} must be an object
+* @returns {void}
+*/
+function set( value ) {
+	if ( !isObject( value ) ) {
+		throw new TypeError( format( 'invalid assignment. `%s` must be an object. Value: `%s`.', prop.name, value ) );
+	}
+	// FIXME: verify that the object has valid field mappings (i.e., string-to-string)
+
+	value = objectAssignIn( {}, value );
+	debug( 'Current value: %s. New value: %s.', JSON.stringify( this[ prop.private ] ), JSON.stringify( value ) );
+	this[ prop.private ] = value;
+	this.emit( 'change', changeEvent( prop.name ) );
+}
+
+
+// EXPORTS //
+
+module.exports = set;

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/data/get.js

@@ -0,0 +1,43 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+/* eslint-disable no-invalid-this */
+
+'use strict';
+
+// MODULES //
+
+var copy = require( '@stdlib/array/base/copy' );
+
+
+// MAIN //
+
+/**
+* Returns chart data.
+*
+* @private
+* @returns {Array<DataSet>} data sets
+*/
+function get() {
+	return copy( this.config.data );
+}
+
+
+// EXPORTS //
+
+module.exports = get;

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/data/properties.js

@@ -0,0 +1,33 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var property2object = require( '@stdlib/plot/vega/base/property2object' );
+
+
+// MAIN //
+
+var obj = property2object( 'data' );
+
+
+// EXPORTS //
+
+module.exports = obj;

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/data/set.js

@@ -0,0 +1,75 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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.
+*/
+
+/* eslint-disable no-invalid-this */
+
+'use strict';
+
+// MODULES //
+
+var logger = require( 'debug' );
+var isDataSetArray = require( '@stdlib/plot/vega/base/assert/is-dataset-array' );
+var isArrayLikeObject = require( '@stdlib/assert/is-array-like-object' );
+var hasEqualValues = require( '@stdlib/array/base/assert/has-equal-values' );
+var min = require( '@stdlib/math/base/special/fast/min' );
+var xyargs2tidy = require( '@stdlib/plot/vega/data/tidy/from-xy-arguments' );
+var format = require( '@stdlib/string/format' );
+var prop = require( './properties.js' );
+
+
+// VARIABLES //
+
+var debug = logger( 'quantitative-chart:data:set:'+prop.name );
+
+
+// MAIN //
+
+/**
+* Sets chart data.
+*
+* @private
+* @param {ArrayLikeObject} value - input value
+* @throws {TypeError} must be an array-like object
+* @returns {void}
+*/
+function set( value ) {
+	var data;
+	var N;
+	var i;
+	if ( !isArrayLikeObject( value ) ) {
+		throw new TypeError( format( 'invalid assignment. `%s` must be an array-like object. Value: `%s`.', prop.name, value ) );
+	}
+	if ( !hasEqualValues( value, this.config.data ) ) {
+		debug( 'New chart data.' );
+		if ( isDataSetArray( value ) ) {
+			data = value;
+		} else {
+			data = xyargs2tidy( value, this._channels );
+			N = min( data.length, this._labels.length );
+			for ( i = 0; i < N; i++ ) {
+				data[ i ].name = this._labels[ i ];
+			}
+		}
+		this.config.data = data;
+	}
+}
+
+
+// EXPORTS //
+
+module.exports = set;

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/defaults.js

@@ -32,20 +32,29 @@
 */
 function defaults() {
 	return {
+		// Object mapping data field names to encoding channels:
+		'channels': {
+			'x': 'x',
+			'y': 'y'
+		},
+
+		// Chart data:
+		'data': [],
+
 		// Data labels:
 		'labels': [],
 
-		// x-axis label:
-		'xLabel': 'x',
-
 		// x-axis scale type:
-		'xScale': 'linear',
+		'xScaleType': 'linear',
 
-		// y-axis label:
-		'yLabel': 'y',
+		// x-axis label:
+		'xTitle': 'x',
 
 		// y-axis scale type:
-		'yScale': 'linear'
+		'yScaleType': 'linear',
+
+		// y-axis label:
+		'yTitle': 'y'
 	};
 }
 

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/labels/get.js

@@ -23,6 +23,7 @@
 // MODULES //
 
 var copy = require( '@stdlib/array/base/copy' );
+var prop = require( './properties.js' );
 
 
 // MAIN //
@@ -34,7 +35,7 @@ var copy = require( '@stdlib/array/base/copy' );
 * @returns {Array<string>} labels
 */
 function get() {
-	return copy( this._labels );
+	return copy( this[ prop.private ] );
 }
 
 

lib/node_modules/@stdlib/plot/charts/base/quantitative/lib/labels/set.js

@@ -26,6 +26,7 @@ var logger = require( 'debug' );
 var isStringArray = require( '@stdlib/assert/is-string-array' ).primitives;
 var isEmptyArrayLikeObject = require( '@stdlib/assert/is-empty-array-like-object' );
 var hasEqualValues = require( '@stdlib/array/base/assert/has-equal-values' );
+var min = require( '@stdlib/math/base/special/fast/min' );
 var copy = require( '@stdlib/array/base/copy' );
 var join = require( '@stdlib/array/base/join' );
 var format = require( '@stdlib/string/format' );
@@ -49,12 +50,24 @@ var debug = logger( 'quantitative-chart:labels:set:'+prop.name );
 * @returns {void}
 */
 function set( value ) {
+	var labels;
+	var data;
+	var N;
+	var i;
 	if ( !isStringArray( value ) && !isEmptyArrayLikeObject( value ) ) {
 		throw new TypeError( format( 'invalid assignment. `%s` must be an array of strings. Value: `%s`.', prop.name, value ) );
 	}
+	// FIXME: verify that the list of data labels is unique
+
 	if ( !hasEqualValues( value, this[ prop.private ] ) ) {
 		debug( 'Current value: [%s]. New value: [%s].', join( this[ prop.private ], ', ' ), join( value, ', ' ) );
-		this[ prop.private ] = copy( value );
+		labels = copy( value );
+		data = this.config.data;
+		N = min( data.length, labels.length );
+		for ( i = 0; i < N; i++ ) {
+			data[ i ].name = labels[ i ];
+		}
+		this[ prop.private ] = labels;
 		this.emit( 'change', changeEvent( prop.name ) );
 	}
 }