refactor: ensure all properties have defaults and disallow undefined

---
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: na
  - 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/vega/visualization/lib/autosize/get.js

@@ -26,7 +26,7 @@
 * Returns the autosize configuration.
 *
 * @private
-* @returns {(void|string|Autosize|Signal)} autosize configuration
+* @returns {(Autosize|Signal)} autosize configuration
 */
 function get() {
 	return this._autosize;

lib/node_modules/@stdlib/plot/vega/visualization/lib/autosize/set.js

@@ -25,8 +25,8 @@
 var logger = require( 'debug' );
 var isAutosize = require( '@stdlib/plot/vega/base/assert/is-autosize' );
 var isString = require( '@stdlib/assert/is-nonnegative-number' ).isPrimitive;
-var isUndefined = require( '@stdlib/assert/is-undefined' );
 var isObject = require( '@stdlib/assert/is-object' );
+var Autosize = require( '@stdlib/plot/vega/autosize' );
 var format = require( '@stdlib/string/format' );
 
 
@@ -40,35 +40,27 @@ var debug = logger( 'vega:visualization:set:autosize' );
 /**
 * Sets the autosize configuration.
 *
-* ## Notes
-*
-* -   Providing `undefined` "unsets" the configured value.
-*
 * @private
-* @param {(string|Autosize|Signal|void)} value - input value
+* @param {(string|Autosize|Signal)} value - input value
 * @throws {TypeError} must be either a string, an autosize instance, or a signal
 * @returns {void}
 */
 function set( value ) {
-	var flg = isAutosize( value );
-	if (
-		!flg &&
-		!isString( value ) &&
-		!isObject( value ) &&
-		!isUndefined( value )
-	) {
+	if ( isString( value ) ) {
+		value = new Autosize({
+			'type': value
+		});
+	} else if ( isObject( value ) ) {
+		// TODO: add signal support
+	} else if ( !isAutosize( value ) ) {
 		throw new TypeError( format( 'invalid assignment. `%s` must be either a string, an autosize instance, or a signal. Value: `%s`.', 'autosize', value ) );
 	}
 	if ( value !== this._autosize ) {
-		if ( isAutosize( this._autosize ) ) {
-			this._removeChangeListener( this._autosize );
-		}
+		this._removeChangeListener( this._autosize );
 		debug( 'Current value: %s. New value: %s.', JSON.stringify( this._autosize ), JSON.stringify( value ) );
 		this._autosize = value;
 		this.emit( 'change' );
-		if ( flg ) {
-			this._addChangeListener( this._autosize );
-		}
+		this._addChangeListener( this._autosize );
 	}
 }
 

lib/node_modules/@stdlib/plot/vega/visualization/lib/config/get.js

@@ -26,7 +26,7 @@
 * Returns the visualization theme.
 *
 * @private
-* @returns {(Config|void)} theme
+* @returns {Config} theme
 */
 function get() {
 	return this._config;

lib/node_modules/@stdlib/plot/vega/visualization/lib/config/set.js

@@ -23,7 +23,6 @@
 // MODULES //
 
 var logger = require( 'debug' );
-var isUndefined = require( '@stdlib/assert/is-undefined' );
 var isObject = require( '@stdlib/assert/is-object' );
 var format = require( '@stdlib/string/format' );
 
@@ -38,29 +37,21 @@ var debug = logger( 'vega:visualization:set:config' );
 /**
 * Sets the visualization theme.
 *
-* ## Notes
-*
-* -   Providing `undefined` "unsets" the configured value.
-*
 * @private
-* @param {(Config|void)} value - input value
+* @param {Config} value - input value
 * @throws {TypeError} must be a configuration instance
 * @returns {void}
 */
 function set( value ) {
-	if ( !isObject( value ) && !isUndefined( value ) ) { // FIXME: validate configuration instance
+	if ( !isObject( value ) ) { // FIXME: validate configuration instance
 		throw new TypeError( format( 'invalid assignment. `%s` must be a configuration instance. Value: `%s`.', 'config', value ) );
 	}
 	if ( value !== this._config ) {
-		if ( this._config ) {
-			this._removeChangeListener( this._config );
-		}
+		this._removeChangeListener( this._config );
 		debug( 'Current value: %s. New value: %s.', JSON.stringify( this._config ), JSON.stringify( value ) );
 		this._config = value;
 		this.emit( 'change' );
-		if ( this._config ) {
-			this._addChangeListener( this._config );
-		}
+		this._addChangeListener( this._config );
 	}
 }
 

lib/node_modules/@stdlib/plot/vega/visualization/lib/defaults.js

@@ -18,6 +18,13 @@
 
 'use strict';
 
+// MODULES //
+
+var Autosize = require( '@stdlib/plot/vega/autosize' );
+var Padding = require( '@stdlib/plot/vega/padding' );
+var Title = require( '@stdlib/plot/vega/title' );
+
+
 // MAIN //
 
 /**
@@ -35,29 +42,53 @@ function defaults() {
 		// Schema URL:
 		'$schema': 'https://vega.github.io/schema/vega/v6.json',
 
+		// Autosize configuration:
+		'autosize': new Autosize(),
+
 		// Coordinate axes:
 		'axes': [],
 
+		// Visualization theme:
+		'config': {},
+
 		// Data set definitions and transforms:
 		'data': [],
 
 		// Visualization description:
 		'description': '',
 
+		// Visual encodings:
+		'encode': {},
+
+		// Height (in pixels):
+		'height': 0,
+
 		// Legends:
 		'legends': [],
 
 		// Graphical marks:
 		'marks': [],
 
+		// Padding (in pixels):
+		'padding': new Padding(),
+
 		// Cartographic projections:
 		'projections': [],
 
 		// Visualization scales:
 		'scales': [],
 
 		// Signals for parameterizing a visualization:
-		'signals': []
+		'signals': [],
+
+		// Visualization title:
+		'title': new Title(),
+
+		// Optional meta data:
+		'usermeta': {},
+
+		// Width (in pixels):
+		'width': 0
 	};
 }
 

lib/node_modules/@stdlib/plot/vega/visualization/lib/encode/get.js

@@ -26,7 +26,7 @@
 * Returns encoding directives for the visual properties of the top-level group mark representing a visualization's data rectangle.
 *
 * @private
-* @returns {(Encode|void)} encoding directives
+* @returns {Encode} encoding directives
 */
 function get() {
 	return this._encode;

lib/node_modules/@stdlib/plot/vega/visualization/lib/encode/set.js

@@ -23,7 +23,6 @@
 // MODULES //
 
 var logger = require( 'debug' );
-var isUndefined = require( '@stdlib/assert/is-undefined' );
 var isObject = require( '@stdlib/assert/is-object' );
 var format = require( '@stdlib/string/format' );
 
@@ -38,29 +37,21 @@ var debug = logger( 'vega:visualization:set:encode' );
 /**
 * Sets encoding directives for the visual properties of the top-level group mark representing a visualization's data rectangle.
 *
-* ## Notes
-*
-* -   Providing `undefined` "unsets" the configured value.
-*
 * @private
-* @param {(Encode|void)} value - input value
+* @param {Encode} value - input value
 * @throws {TypeError} must be an encoding object
 * @returns {void}
 */
 function set( value ) {
-	if ( !isObject( value ) && !isUndefined( value ) ) { // FIXME: validate encoding object
+	if ( !isObject( value ) ) { // FIXME: validate encoding object
 		throw new TypeError( format( 'invalid assignment. `%s` must be a valid encoding. Value: `%s`.', 'encode', value ) );
 	}
 	if ( value !== this._encode ) {
-		if ( this._encode ) {
-			this._removeChangeListener( this._encode );
-		}
+		this._removeChangeListener( this._encode );
 		debug( 'Current value: %s. New value: %s.', JSON.stringify( this._encode ), JSON.stringify( value ) );
 		this._encode = value;
 		this.emit( 'change' );
-		if ( this._encode ) {
-			this._addChangeListener( this._encode );
-		}
+		this._addChangeListener( this._encode );
 	}
 }
 

lib/node_modules/@stdlib/plot/vega/visualization/lib/height/get.js

@@ -26,7 +26,7 @@
 * Returns the visualization height (in pixels).
 *
 * @private
-* @returns {(void|NonNegativeNumber|Signal)} height
+* @returns {(NonNegativeNumber|Signal)} height
 */
 function get() {
 	return this._height;

lib/node_modules/@stdlib/plot/vega/visualization/lib/height/set.js

@@ -24,7 +24,6 @@
 
 var logger = require( 'debug' );
 var isNonNegativeNumber = require( '@stdlib/assert/is-nonnegative-number' ).isPrimitive;
-var isUndefined = require( '@stdlib/assert/is-undefined' );
 var isObject = require( '@stdlib/assert/is-object' );
 var format = require( '@stdlib/string/format' );
 
@@ -39,17 +38,13 @@ var debug = logger( 'vega:visualization:set:height' );
 /**
 * Sets the visualization height (in pixels).
 *
-* ## Notes
-*
-* -   Providing `undefined` "unsets" the configured value.
-*
 * @private
-* @param {(NonNegativeNumber|Signal|void)} value - input value
+* @param {(NonNegativeNumber|Signal)} value - input value
 * @throws {TypeError} must be either a nonnegative number or a signal
 * @returns {void}
 */
 function set( value ) {
-	if ( !isNonNegativeNumber( value ) && !isObject( value ) && !isUndefined( value ) ) {
+	if ( !isNonNegativeNumber( value ) && !isObject( value ) ) {
 		throw new TypeError( format( 'invalid assignment. `%s` must be either a nonnegative number or a signal. Value: `%s`.', 'height', value ) );
 	}
 	if ( value !== this._height ) {

lib/node_modules/@stdlib/plot/vega/visualization/lib/main.js

@@ -300,7 +300,7 @@ setReadOnlyAccessor( Visualization.prototype, '$schema', getSchema );
 *
 * @name autosize
 * @memberof Visualization.prototype
-* @type {(string|Signal|Autosize)}
+* @type {(Signal|Autosize)}
 *
 * @example
 * var Autosize = require( '@stdlib/plot/vega/autosize' );
@@ -505,7 +505,7 @@ setReadWriteAccessor( Visualization.prototype, 'signals', getSignals, setSignals
 *
 * @name title
 * @memberof Visualization.prototype
-* @type {(Title|void)}
+* @type {Title}
 *
 * @example
 * var Title = require( '@stdlib/plot/vega/title' );