feat: add plot/charts/scatter/ctor

---
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_pkg_readmes
    status: na
  - task: lint_markdown_docs
    status: na
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: passed
  - 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: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: Sachinn-64

lib/node_modules/@stdlib/plot/charts/scatter/ctor/examples/index.js

@@ -0,0 +1,36 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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';
+
+var uniform = require( '@stdlib/random/uniform' );
+var Float64Vector = require( '@stdlib/ndarray/vector/float64' );
+var ScatterChart = require( './../lib' );
+
+var a = new Float64Vector( [ 10.0, 20.0, 30.0, 40.0, 50.0 ] );
+var b = new Float64Vector( [ 20.0, 30.0, 40.0, 50.0, 60.0 ] );
+
+var y = uniform( [ 100, 5 ], a, b );
+
+var chart = new ScatterChart( y, {
+	'symbols': [ 'o', 'square' ],
+	'symbolsOpacity': [ 1.0, 0.4 ],
+	'symbolsSize': [ 100, 50 ],
+	'legend': true
+});
+console.log( chart.toJSON() );

lib/node_modules/@stdlib/plot/charts/scatter/ctor/lib/change_event.js

@@ -0,0 +1,41 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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';
+
+// MAIN //
+
+/**
+* Returns a new change event object.
+*
+* @private
+* @param {string} property - property name
+* @returns {Object} event object
+*/
+function event( property ) { // eslint-disable-line stdlib/no-redeclare
+	return {
+		'type': 'update',
+		'source': 'visualization',
+		'property': property
+	};
+}
+
+
+// EXPORTS //
+
+module.exports = event;

lib/node_modules/@stdlib/plot/charts/scatter/ctor/lib/colors/get.js

@@ -0,0 +1,44 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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' );
+var prop = require( './properties.js' );
+
+
+// MAIN //
+
+/**
+* Returns the symbol colors.
+*
+* @private
+* @returns {Array<string>} colors
+*/
+function get() {
+	return copy( this[ prop.private ] );
+}
+
+
+// EXPORTS //
+
+module.exports = get;

lib/node_modules/@stdlib/plot/charts/scatter/ctor/lib/colors/properties.js

@@ -0,0 +1,33 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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( 'colors' );
+
+
+// EXPORTS //
+
+module.exports = obj;

lib/node_modules/@stdlib/plot/charts/scatter/ctor/lib/colors/set.js

@@ -0,0 +1,75 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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 isStringArray = require( '@stdlib/assert/is-string-array' ).primitives;
+var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
+var hasEqualValues = require( '@stdlib/array/base/assert/has-equal-values' );
+var copy = require( '@stdlib/array/base/copy' );
+var join = require( '@stdlib/array/base/join' );
+var format = require( '@stdlib/string/format' );
+var prop = require( './properties.js' );
+
+
+// VARIABLES //
+
+var debug = logger( 'scatter-chart:set:'+prop.name );
+
+
+// MAIN //
+
+/**
+* Sets symbol colors.
+*
+* @private
+* @param {(Array<string>|string)} value - input value
+* @throws {TypeError} must be a string or an array of strings
+* @returns {void}
+*/
+function set( value ) {
+	var isStr = isString( value );
+	if ( !isStr && !isStringArray( value ) ) {
+		throw new TypeError( format( 'invalid assignment. `%s` must be a string or an array of strings. Value: `%s`.', prop.name, value ) );
+	}
+	if ( isStr ) {
+		value = [ value ];
+	}
+	if ( !hasEqualValues( value, this[ prop.private ] ) ) {
+		debug( 'Current value: [%s]. New value: [%s].', join( this[ prop.private ], ', ' ), join( value, ', ' ) );
+
+		// Perform a defensive copy as we will be caching the specified symbol colors:
+		value = copy( value );
+
+		// Cache the value before updating the scale to ensure consistent state:
+		this[ prop.private ] = value;
+
+		// Update the color range:
+		this.colorScale.range = value;
+	}
+}
+
+
+// EXPORTS //
+
+module.exports = set;

lib/node_modules/@stdlib/plot/charts/scatter/ctor/lib/defaults.js

@@ -0,0 +1,60 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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 category10 = require( '@stdlib/plot/color-schemes/category10' );
+
+
+// MAIN //
+
+/**
+* Returns defaults.
+*
+* @private
+* @returns {Object} defaults
+*
+* @example
+* var obj = defaults();
+* // returns {...}
+*/
+function defaults() {
+	return {
+		// Symbol colors:
+		'colors': category10(),
+
+		// Boolean indicating whether to display a legend:
+		'legend': false,
+
+		// Symbol(s):
+		'symbols': [ 'circle' ],
+
+		// Symbol opacity:
+		'symbolsOpacity': [ 1.0 ],
+
+		// Symbol size(s) (in pixels squared):
+		'symbolsSize': [ 100 ]
+	};
+}
+
+
+// EXPORTS //
+
+module.exports = defaults;

lib/node_modules/@stdlib/plot/charts/scatter/ctor/lib/index.js

@@ -0,0 +1,42 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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';
+
+/**
+* Scatter chart constructor.
+*
+* @module @stdlib/plot/charts/scatter/ctor
+*
+* @example
+* var ScatterChart = require( '@stdlib/plot/charts/scatter/ctor' );
+*
+* var chart = new ScatterChart();
+* // returns <ScatterChart>
+*
+* // TODO: update example
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;

lib/node_modules/@stdlib/plot/charts/scatter/ctor/lib/legend/get.js

@@ -0,0 +1,43 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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 prop = require( './properties.js' );
+
+
+// MAIN //
+
+/**
+* Returns a boolean indicating whether to display a chart legend.
+*
+* @private
+* @returns {boolean} boolean flag
+*/
+function get() {
+	return this[ prop.private ];
+}
+
+
+// EXPORTS //
+
+module.exports = get;