feat: add support for specifying fixed column width(s)

---
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: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: passed
  - 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: passed
  - 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
---

---
type: pre_push_report
description: Results of running various checks prior to pushing changes.
report:
  - task: run_javascript_examples
    status: na
  - task: run_c_examples
    status: na
  - task: run_cpp_examples
    status: na
  - task: run_javascript_readme_examples
    status: na
  - task: run_c_benchmarks
    status: na
  - task: run_cpp_benchmarks
    status: na
  - task: run_fortran_benchmarks
    status: na
  - task: run_javascript_benchmarks
    status: na
  - task: run_julia_benchmarks
    status: na
  - task: run_python_benchmarks
    status: na
  - task: run_r_benchmarks
    status: na
  - task: run_javascript_tests
    status: na
---

Author: kgryte

lib/node_modules/@stdlib/plot/table/unicode/README.md

@@ -69,6 +69,8 @@ The constructor accepts the following `options`:
 
 -   **columnSeparator**: column separator character(s). Default: `'│'`.
 
+-   **columnWidth**: column width(s) in units of grapheme clusters (i.e., visual characters). When `null`, column widths are determined according to cell content. When set to a specific width, a column is rendered with the specified width, unless overridden by a `maxColumnWidth` option which is less than the specified width. Default: `null`.
+
 -   **cornerTopLeft**: top-left table corner grapheme cluster (i.e., visual character). Default: `'┌'`.
 
 -   **cornerTopRight**: top-right table corner grapheme cluster (i.e., visual character). Default: `'┌'`.
@@ -123,7 +125,7 @@ The constructor accepts the following `options`:
 
 -   **margins**: table margins in the order `[top, right, bottom, left]`. This is a shorthand option instead of specifying margins individually. Default: `[ 0, 0, 0, 0 ]`.
 
--   **maxColumnWidth**: maximum cell width(s) in units of grapheme clusters (i.e., visual characters). Default: `+infinity`.
+-   **maxColumnWidth**: maximum cell width(s) in units of grapheme clusters (i.e., visual characters). If less than a column's specified width, this option overrides the `columnWidth` option. Default: `+infinity`.
 
 -   **maxWidth**: maximum table width in units of grapheme clusters (i.e., visual characters). Default: `+infinity`.
 
@@ -327,6 +329,34 @@ var v = table.columnSeparator;
 // returns '|'
 ```
 
+<a name="prop-column-width"></a>
+
+#### UnicodeTable.prototype.columnWidth
+
+Column width in units of grapheme clusters (i.e., visual characters).
+
+```javascript
+var table = new UnicodeTable();
+
+// Set:
+table.columnWidth = 10;
+
+// Get:
+var v = table.columnWidth;
+// returns 10
+
+// Set:
+table.columnWidth = [ 10, 15 ];
+
+// Get:
+v = table.columnWidth;
+// returns [ 10, 15 ]
+```
+
+When `null`, column widths are determined according to cell content. When set to a specific width, a column is rendered with the specified width, unless overridden by a [`maxColumnWidth`](#prop-max-column-width) which is less than the specified width.
+
+To specify a column width for each column, provide an array of widths.
+
 <a name="prop-corner-top-left"></a>
 
 #### UnicodeTable.prototype.cornerTopLeft
@@ -735,11 +765,11 @@ var v = table.margins;
 // returns [ 2, 2, 2, 2 ]
 ```
 
-<a name="prop-max-cell-width"></a>
+<a name="prop-max-column-width"></a>
 
 #### UnicodeTable.prototype.maxColumnWidth
 
-Maximum cell width in units of grapheme clusters (i.e., visual characters). If cell data is longer than the maximum cell width, the rendered cell data is truncated. To specify the maximum cell width for each column of cells, provide an array of maximum cell widths.
+Maximum column width in units of grapheme clusters (i.e., visual characters). If column data is longer than the maximum column width, the rendered column data is truncated. To specify the maximum column width for each column, provide an array of maximum widths.
 
 ```javascript
 var table = new UnicodeTable();
@@ -756,8 +786,11 @@ table.maxColumnWidth = [ 10, 15 ];
 
 // Get:
 v = table.maxColumnWidth;
+// returns [ 10, 15 ]
 ```
 
+If set to a value which is less than a column's specified width, the maximum column width takes precedence over [`columnWidth`](#prop-column-width).
+
 <a name="prop-max-width"></a>
 
 #### UnicodeTable.prototype.maxWidth

lib/node_modules/@stdlib/plot/table/unicode/benchmark/benchmark.js

@@ -125,6 +125,7 @@ bench( pkg+'::instantiation,data,options', function benchmark( b ) {
 		'borderLeft': '7890',
 		'borders': [ '1', '23', '456', '7890' ],
 		'bufferSize': 10,
+		'columnWidth': null,
 		'columnSeparator': 'None',
 		'cornerTopLeft': '*',
 		'cornerTopRight': '*',
@@ -437,6 +438,62 @@ bench( pkg+'::set,get:columnSeparator', function benchmark( b ) {
 	b.end();
 });
 
+bench( pkg+'::set,get:columnWidth:value=number', function benchmark( b ) {
+	var values;
+	var v;
+	var i;
+
+	values = [
+		10,
+		20,
+		30,
+		40
+	];
+	v = new UnicodeTable();
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		v.columnWidth = values[ i % values.length ];
+		if ( !isNumber( v.columnWidth ) ) {
+			b.fail( 'should return a number' );
+		}
+	}
+	b.toc();
+	if ( !isNumber( v.columnWidth ) ) {
+		b.fail( 'should return a number' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
+bench( pkg+'::set,get:columnWidth:value=array', function benchmark( b ) {
+	var values;
+	var v;
+	var i;
+
+	values = [
+		[ 1, 2, 3 ],
+		[ 4, 5, 6 ],
+		[ 7, null, 9 ],
+		[ null, null, null ]
+	];
+	v = new UnicodeTable();
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		v.columnWidth = values[ i % values.length ];
+		if ( !isArray( v.columnWidth ) ) {
+			b.fail( 'should return an array' );
+		}
+	}
+	b.toc();
+	if ( !isArray( v.columnWidth ) ) {
+		b.fail( 'should return an array' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
 bench( pkg+'::set,get:cornerTopLeft', function benchmark( b ) {
 	var values;
 	var v;

lib/node_modules/@stdlib/plot/table/unicode/docs/repl.txt

@@ -47,6 +47,13 @@
     options.columnSeparator: string (optional)
         Column separator character(s). Default: '│'.
 
+    options.columnWidth: Array<integer|null>|integer|null (optional)
+        Column width(s) in units of grapheme clusters (i.e., visual
+        characters). When `null`, column widths are determined according to cell
+        content. When set to a specific width, a column is rendered with the
+        specified width, unless overridden by a `maxColumnWidth` option which is
+        less than the specified width. Default: null.
+
     options.cornerTopLeft: string (optional)
         Top-left table corner grapheme cluster (i.e., visual character).
         Default: '┌'.
@@ -135,9 +142,10 @@
         Table margins in the order [top, right, bottom, left]. Default:
         [ 0, 0, 0, 0 ].
 
-    options.maxColumnWidth: Array<integer>|integer|null (optional)
+    options.maxColumnWidth: Array<integer|null>|integer|null (optional)
         Maximum column width(s) in units of grapheme clusters (i.e., visual
-        characters). Default: +infinity.
+        characters). If less than a column's specified width, this option
+        overrides the `columnWidth` option. Default: +infinity.
 
     options.maxWidth: integer|null (optional)
         Maximum table width in units of grapheme clusters (i.e., visual
@@ -194,6 +202,9 @@
     table.columnSeparator
         Column separator character(s).
 
+    table.columnWidth
+        Column width(s).
+
     table.cornerTopLeft
         Top-left table corner grapheme cluster (i.e., visual character).
 

lib/node_modules/@stdlib/plot/table/unicode/examples/index.js

@@ -36,6 +36,7 @@ var table = new UnicodeTable( data, {
 	'rowSeparator': '-',
 	'columnSeparator': '#$%',
 	'maxWidth': 200,
+	'columnWidth': 15,
 	'marginLeft': 5,
 	'marginRight': 5,
 	'align': 'right',

lib/node_modules/@stdlib/plot/table/unicode/lib/column_widths.js

@@ -0,0 +1,83 @@
+/**
+* @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 zeros = require( '@stdlib/array/base/zeros' );
+
+
+// MAIN //
+
+/**
+* Resolves individual column widths based on table data and specified paddings.
+*
+* @private
+* @param {NonNegativeInteger} nrows - number of table rows
+* @param {NonNegativeInteger} ncols - number of table columns
+* @param {ndarray} data - table data
+* @param {(ndarray|null)} headers - table headers
+* @param {NonNegativeIntegerArray} leftPadding - left padding
+* @param {NonNegativeIntegerArray} rightPadding - right padding
+* @returns {NonNegativeIntegerArray} column widths
+*/
+function columnWidths( nrows, ncols, data, headers, leftPadding, rightPadding ) { // eslint-disable-line max-len
+	var lpad;
+	var rpad;
+	var out;
+	var len;
+	var M;
+	var N;
+	var v;
+	var i;
+	var j;
+
+	M = leftPadding.length;
+	N = rightPadding.length;
+
+	out = zeros( ncols );
+	if ( headers ) {
+		for ( j = 0; j < ncols; j++ ) {
+			lpad = leftPadding[ j%M ];
+			rpad = rightPadding[ j%N ];
+			v = headers.get( 0, j );
+			len = lpad + v.ngraphemes + rpad;
+			if ( len > out[ j ] ) {
+				out[ j ] = len;
+			}
+		}
+	}
+	for ( i = 0; i < nrows; i++ ) {
+		for ( j = 0; j < ncols; j++ ) {
+			lpad = leftPadding[ j%M ];
+			rpad = rightPadding[ j%N ];
+			v = data.get( i, j );
+			len = lpad + v.ngraphemes + rpad;
+			if ( len > out[ j ] ) {
+				out[ j ] = len;
+			}
+		}
+	}
+	return out;
+}
+
+
+// EXPORTS //
+
+module.exports = columnWidths;

lib/node_modules/@stdlib/plot/table/unicode/lib/defaults.js

@@ -71,6 +71,16 @@ function defaults() {
 	// Buffer size:
 	out.bufferSize = FLOAT64_MAX;
 
+	// Column separator:
+	out.columnSeparator = {
+		'value': '|',
+		'graphemes': [ '|' ],
+		'ngraphemes': 1
+	};
+
+	// Column widths:
+	out.columnWidth = null; // by default, automatically size based on content
+
 	// Corner grapheme clusters:
 	out.corners = [
 		{
@@ -99,13 +109,6 @@ function defaults() {
 		}
 	];
 
-	// Column separator:
-	out.columnSeparator = {
-		'value': '|',
-		'graphemes': [ '|' ],
-		'ngraphemes': 1
-	};
-
 	// Cell format string:
 	out.format = [ '%s' ];