console-toolkit 1.2.14 → 1.3.0

package/src/box.js

@@ -1,15 +1,7 @@
 import {addAlias} from './meta.js';
 import {getLength, clipStrings, toStrings} from './strings.js';
 
-/** A rectangular text container where all strings have equal display width.
- * Provides methods for padding, stacking, clipping, and flipping.
- * @see {@link https://github.com/uhop/console-toolkit/wiki/Module:-box}
- */
 export class Box {
-  /** Creates a new Box.
-   * @param {Box|string|string[]|*} s - Input data. If a Box, it is copied. If `normalized` is true, the array is used as-is.
-   * @param {boolean} [normalized=false] - If true, assumes strings are already equal width and takes ownership of the array.
-   */
   constructor(s, normalized) {
     if (s instanceof Box) {
       this.box = [...s.box]; // copy
@@ -18,22 +10,13 @@ export class Box {
     }
   }
 
-  /** The display width of the box (length of the first string, or 0 if empty). */
   get width() {
     return this.box.length ? getLength(this.box[0]) : 0;
   }
-  /** The number of rows in the box. */
   get height() {
     return this.box.length;
   }
 
-  /** Creates a Box from various input types.
-   * @param {import('./strings.js').StringsInput} s - Input: Box, object with toBox()/toPanel(), function, string, array, etc.
-   * @param {object} [options] - Options.
-   * @param {string} [options.symbol=' '] - The padding character.
-   * @param {'left'|'l'|'right'|'r'|'center'|'c'} [options.align='left'] - Alignment for shorter strings.
-   * @returns {Box} A new Box instance.
-   */
   static make(s, options) {
     main: for (;;) {
       switch (typeof s) {
@@ -83,73 +66,44 @@ export class Box {
     );
   }
 
-  /** Creates a blank Box filled with a symbol.
-   * @param {number} width - The width of the box.
-   * @param {number} height - The height of the box.
-   * @param {string} [symbol=' '] - The fill character.
-   * @returns {Box} A new blank Box.
-   */
   static makeBlank(width, height, symbol = ' ') {
-    return new Box(height <= 0 ? [] : new Array(height).fill(symbol.repeat(width)), true);
+    return new Box(height <= 0 ? [] : new Array(height).fill(width <= 0 ? '' : symbol.repeat(width)), true);
   }
 
-  /** Returns the underlying array of strings.
-   * @returns {string[]} The box content.
-   */
   toStrings() {
     return this.box;
   }
 
-  /** Creates a shallow copy of this Box.
-   * @returns {Box} A new Box with the same content.
-   */
   clone() {
     return new Box(this);
   }
 
-  /** Clips all strings to a given display width.
-   * @param {number} width - The maximum display width.
-   * @param {object} [options] - Options passed to `clip()`.
-   * @returns {Box} A new clipped Box.
-   */
   clip(width, options) {
     return Box.make(clipStrings(this.box, width, options));
   }
 
   // padding
 
-  /** Pads the box on both left and right sides.
-   * @param {number} left - Left padding amount.
-   * @param {number} right - Right padding amount.
-   * @param {string} [symbol=' '] - The padding character.
-   * @returns {Box} A new padded Box.
-   */
   padLeftRight(left, right, symbol = ' ') {
-    const paddingLeft = symbol.repeat(left),
-      paddingRight = symbol.repeat(right);
+    if (left <= 0 && right <= 0) return this.clone();
+    const paddingLeft = left > 0 ? symbol.repeat(left) : '',
+      paddingRight = right > 0 ? symbol.repeat(right) : '';
     return new Box(
       this.box.map(s => paddingLeft + s + paddingRight),
       true
     );
   }
 
-  /** Pads the box on both top and bottom sides.
-   * @param {number} top - Top padding amount (number of rows).
-   * @param {number} bottom - Bottom padding amount (number of rows).
-   * @param {string} [symbol=' '] - The padding character.
-   * @returns {Box} A new padded Box.
-   */
   padTopBottom(top, bottom, symbol = ' ') {
-    const padding = symbol.repeat(this.width);
-    return new Box([...new Array(top).fill(padding), ...this.box, ...new Array(bottom).fill(padding)], true);
+    if (top <= 0 && bottom <= 0) return this.clone();
+    const padding = symbol.repeat(this.width),
+      t = top > 0 ? top : 0,
+      b = bottom > 0 ? bottom : 0;
+    return new Box([...new Array(t).fill(padding), ...this.box, ...new Array(b).fill(padding)], true);
   }
 
-  /** Pads the box on the right side.
-   * @param {number} n - Right padding amount.
-   * @param {string} [symbol=' '] - The padding character.
-   * @returns {Box} A new padded Box.
-   */
   padRight(n, symbol = ' ') {
+    if (n <= 0) return this.clone();
     const padding = symbol.repeat(n);
     return new Box(
       this.box.map(s => s + padding),
@@ -157,12 +111,8 @@ export class Box {
     );
   }
 
-  /** Pads the box on the left side.
-   * @param {number} n - Left padding amount.
-   * @param {string} [symbol=' '] - The padding character.
-   * @returns {Box} A new padded Box.
-   */
   padLeft(n, symbol = ' ') {
+    if (n <= 0) return this.clone();
     const padding = symbol.repeat(n);
     return new Box(
       this.box.map(s => padding + s),
@@ -170,38 +120,18 @@ export class Box {
     );
   }
 
-  /** Pads the box on the top side.
-   * @param {number} n - Top padding amount (number of rows).
-   * @param {string} [symbol=' '] - The padding character.
-   * @returns {Box} A new padded Box.
-   */
   padTop(n, symbol = ' ') {
+    if (n <= 0) return this.clone();
     const padding = symbol.repeat(this.width);
     return new Box([...new Array(n).fill(padding), ...this.box], true);
   }
 
-  /** Pads the box on the bottom side.
-   * @param {number} n - Bottom padding amount (number of rows).
-   * @param {string} [symbol=' '] - The padding character.
-   * @returns {Box} A new padded Box.
-   */
   padBottom(n, symbol = ' ') {
+    if (n <= 0) return this.clone();
     const padding = symbol.repeat(this.width);
     return new Box([...this.box, ...new Array(n).fill(padding)], true);
   }
 
-  /** Pads the box on all sides (CSS padding order: top, right, bottom, left).
-   * - `pad(t)` → equal padding on all sides.
-   * - `pad(t, r)` → top/bottom = t, left/right = r.
-   * - `pad(t, r, b)` → top = t, left/right = r, bottom = b.
-   * - `pad(t, r, b, l)` → individual padding.
-   * @param {number} t - Top padding.
-   * @param {number|string} [r] - Right padding or symbol.
-   * @param {number|string} [b] - Bottom padding or symbol.
-   * @param {number|string} [l] - Left padding or symbol.
-   * @param {string} [symbol=' '] - The padding character.
-   * @returns {Box} A new padded Box.
-   */
   pad(t, r, b, l, symbol = ' ') {
     // implemented the CSS padding order
     if (typeof r != 'number') {
@@ -220,11 +150,6 @@ export class Box {
 
   // removing
 
-  /** Removes rows from the box.
-   * @param {number} y - The starting row index.
-   * @param {number} n - The number of rows to remove.
-   * @returns {Box} A new Box with rows removed.
-   */
   removeRows(y, n) {
     const result = [...this.box];
     result.splice(y, n);
@@ -233,13 +158,6 @@ export class Box {
 
   // stack
 
-  /** Stacks another box below this one.
-   * @param {import('./strings.js').StringsInput} box - The box to add at the bottom.
-   * @param {object} [options] - Options.
-   * @param {string} [options.symbol=' '] - The padding character for width alignment.
-   * @param {'left'|'l'|'right'|'r'|'center'|'c'} [options.align='left'] - Horizontal alignment if widths differ.
-   * @returns {Box} A new combined Box.
-   */
   addBottom(box, {symbol = ' ', align = 'left'} = {}) {
     let a = this,
       b = toBox(box);
@@ -267,13 +185,6 @@ export class Box {
     return new Box([...a.box, ...b.box], true);
   }
 
-  /** Stacks another box to the right of this one.
-   * @param {import('./strings.js').StringsInput} box - The box to add on the right.
-   * @param {object} [options] - Options.
-   * @param {string} [options.symbol=' '] - The padding character for height alignment.
-   * @param {'top'|'t'|'bottom'|'b'|'center'|'c'} [options.align='top'] - Vertical alignment if heights differ.
-   * @returns {Box} A new combined Box.
-   */
   addRight(box, {symbol = ' ', align = 'top'} = {}) {
     box = toBox(box);
     const ah = this.height,
@@ -284,24 +195,19 @@ export class Box {
         true
       );
 
-    let t = 0,
-      b = 0;
+    let t = 0;
     const diff = Math.abs(ah - bh);
     switch (align) {
       case 'top':
       case 't':
         t = 0;
-        b = diff;
         break;
       case 'bottom':
       case 'b':
         t = diff;
-        b = 0;
         break;
       default: // center
-        const half = diff >> 1;
-        t = half;
-        b = half + (diff & 1 ? 1 : 0);
+        t = diff >> 1;
         break;
     }
 
@@ -336,9 +242,6 @@ export class Box {
 
   // flipping
 
-  /** Flips the box vertically (reverses the row order).
-   * @returns {Box} A new vertically flipped Box.
-   */
   flipV() {
     return new Box(this.box.toReversed(), true);
   }
@@ -346,9 +249,6 @@ export class Box {
 
 addAlias(Box, 'toBox', 'clone');
 
-/** Alias for `Box.make()`. Converts its argument to a Box.
- * @type {typeof Box.make}
- */
 export const toBox = Box.make;
 
 export default Box;

package/src/charts/bars/block-frac-grouped.js

@@ -1,12 +1,6 @@
 import {drawRow} from './block-frac.js';
 import drawGroupedChart from './draw-grouped.js';
 
-/** Draws a complete fractional block grouped bar chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available width.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawRow);
 
 export default drawChart;

package/src/charts/bars/block-frac.js

@@ -8,13 +8,6 @@ import {drawRealHeightBlock} from '../../draw-block-frac.js';
 // data = [datum]
 // datum = {value, colorState, symbol, state}
 
-/** Draws a single stacked bar row using fractional block characters.
- * @param {object[]} data - Normalized data series.
- * @param {number} width - Total width.
- * @param {number} maxValue - Maximum value for scaling.
- * @param {object} [options] - Options including `reverse`, `drawEmptyBorder`, `rectSize`, `initState`.
- * @returns {string[]} The drawn row lines.
- */
 export const drawRow = (data, width, maxValue, options = {}) => {
   const {reverse, drawEmptyBorder, initState = {}} = options,
     rectSize = Math.max(0, options.rectSize ?? 0.5),
@@ -28,7 +21,7 @@ export const drawRow = (data, width, maxValue, options = {}) => {
         true
       );
     }),
-    result = new Array(blocks[0].box.length).fill('');
+    result = blocks.length ? new Array(blocks[0].box.length).fill('') : [];
   if (reverse) blocks.reverse();
   for (const block of blocks) {
     for (let i = 0; i < block.box.length; ++i) {
@@ -38,12 +31,6 @@ export const drawRow = (data, width, maxValue, options = {}) => {
   return result.map(line => optimize(line));
 };
 
-/** Draws a complete fractional block stacked bar chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available width.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawStackedChart(drawRow);
 
 export default drawChart;

package/src/charts/bars/block-grouped.js

@@ -1,12 +1,6 @@
 import {drawRow} from './block.js';
 import drawGroupedChart from './draw-grouped.js';
 
-/** Draws a complete block grouped bar chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available width.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawRow);
 
 export default drawChart;

package/src/charts/bars/block.js

@@ -9,13 +9,6 @@ import defaultBlockTheme from '../../themes/blocks/unicode-half.js';
 // data = [datum]
 // datum = {value, colorState, symbol, state}
 
-/** Draws a single stacked bar row using block-drawing characters.
- * @param {object[]} data - Normalized data series.
- * @param {number} width - Total width.
- * @param {number} maxValue - Maximum value for scaling.
- * @param {object} [options] - Options including `reverse`, `blockTheme`, `rectSize`, `initState`.
- * @returns {string[]} The drawn row lines.
- */
 export const drawRow = (data, width, maxValue, options = {}) => {
   const {reverse, blockTheme = defaultBlockTheme, rectSize = 0, initState = {}} = options,
     sizes = allocateSizes(data, maxValue, width),
@@ -35,7 +28,7 @@ export const drawRow = (data, width, maxValue, options = {}) => {
         true
       );
     }),
-    result = new Array(blocks[0].box.length).fill('');
+    result = blocks.length ? new Array(blocks[0].box.length).fill('') : [];
   if (reverse) blocks.reverse();
   for (const block of blocks) {
     for (let i = 0; i < block.box.length; ++i) {
@@ -45,12 +38,6 @@ export const drawRow = (data, width, maxValue, options = {}) => {
   return result.map(line => optimize(line));
 };
 
-/** Draws a complete block stacked bar chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available width.
- * @param {object} [options] - Block bar options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawStackedChart(drawRow);
 
 export default drawChart;

package/src/charts/bars/draw-grouped.js

@@ -1,10 +1,6 @@
 import defaultTheme from '../themes/default.js';
 import {normalizeData} from '../utils.js';
 
-/** Creates a grouped bar chart drawing function from a row-drawing function.
- * @param {Function} drawRow - Function `(data, width, maxValue, options) => string|string[]`.
- * @returns {Function} Chart drawing function `(values, width, options) => string[]`.
- */
 export const drawChart =
   drawRow =>
   (values, width, options = {}) => {

package/src/charts/bars/draw-stacked.js

@@ -1,10 +1,6 @@
 import defaultTheme from '../themes/default.js';
 import {normalizeData, sumValues} from '../utils.js';
 
-/** Creates a stacked bar chart drawing function from a row-drawing function.
- * @param {Function} drawRow - Function `(data, width, maxValue, options) => string|string[]`.
- * @returns {Function} Chart drawing function `(values, width, options) => string[]`.
- */
 export const drawChart =
   drawRow =>
   (values, width, options = {}) => {

package/src/charts/bars/frac-grouped.js

@@ -7,14 +7,8 @@ import drawGroupedChart from './draw-grouped.js';
 // data = [datum]
 // datum = {value, colorState, symbol, state}
 
-/** Draws a single grouped bar row using fractional width block characters.
- * @param {object[]} data - Normalized data series.
- * @param {number} width - Total width.
- * @param {number} maxValue - Maximum value for scaling.
- * @param {object} [options] - Options including `reverse`, `rectSize`, `initState`.
- * @returns {string[]} The drawn row lines.
- */
 export const drawRow = (data, width, maxValue, options = {}) => {
+  if (!maxValue) maxValue = 1;
   const {reverse, rectSize = 1, initState = {}} = options,
     blocks = data.map(datum => {
       if (!datum) return Box.makeBlank(0, rectSize);
@@ -25,7 +19,7 @@ export const drawRow = (data, width, maxValue, options = {}) => {
         true
       );
     }),
-    result = new Array(blocks[0].box.length).fill('');
+    result = blocks.length ? new Array(blocks[0].box.length).fill('') : [];
   if (reverse) blocks.reverse();
   for (const block of blocks) {
     for (let i = 0; i < block.box.length; ++i) {
@@ -35,12 +29,6 @@ export const drawRow = (data, width, maxValue, options = {}) => {
   return result.map(line => optimize(line));
 };
 
-/** Draws a complete fractional grouped bar chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available width.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawRow);
 
 export default drawChart;

package/src/charts/bars/plain-grouped.js

@@ -1,12 +1,6 @@
 import {drawRow} from './plain.js';
 import drawGroupedChart from './draw-grouped.js';
 
-/** Draws a complete plain grouped bar chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available width.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawRow);
 
 export default drawChart;

package/src/charts/bars/plain.js

@@ -10,13 +10,6 @@ import defaultTheme from '../themes/default.js';
 
 const defaultSymbol = vBlocks8th[7];
 
-/** Default draw function for a single bar item.
- * @param {object} datum - Data item with `value`, `colorState`, `symbol`, `state`.
- * @param {number} size - Allocated size in characters.
- * @param {object} _ - Context (index, data, sizes, etc.).
- * @param {object} options - Draw options.
- * @returns {string} Styled string.
- */
 export const defaultDrawItem = (datum, size, _, {initState = {}}) =>
   datum
     ? style
@@ -24,15 +17,8 @@ export const defaultDrawItem = (datum, size, _, {initState = {}}) =>
         .addState(datum.colorState || {})
         .addState(datum.state || {})
         .text((datum.symbol || defaultSymbol).repeat(size))
-    : '';
+    : ' '.repeat(size);
 
-/** Draws a bar item with a text label instead of a filled symbol.
- * @param {object} datum - Data item with `label`, `symbol`, `colorState`, `state`.
- * @param {number} size - Allocated size.
- * @param {object} _ - Context.
- * @param {object} options - Draw options including `reverse`, `truncate`, `useEllipsis`.
- * @returns {string} Styled string.
- */
 export const drawItemLabel = (datum, size, _, {reverse, truncate, useEllipsis = true, initState = {}}) => {
   if (!datum) return '';
   const symbol = datum.symbol || ' ';
@@ -51,13 +37,6 @@ export const drawItemLabel = (datum, size, _, {reverse, truncate, useEllipsis =
     .text(label);
 };
 
-/** Draws a single stacked bar row.
- * @param {object[]} data - Normalized data series.
- * @param {number} width - Total width.
- * @param {number} maxValue - Maximum value for scaling.
- * @param {object} [options] - Options including `drawItem`, `rectSize`, `theme`, `initState`, `reverse`.
- * @returns {string|string[]} The drawn row(s).
- */
 export const drawRow = (data, width, maxValue, options = {}) => {
   const {drawItem = defaultDrawItem, rectSize = 0, theme = defaultTheme, initState, reverse} = options,
     {symbol = ' ', state = null, colorState} = theme?.empty || {},
@@ -79,12 +58,6 @@ export const drawRow = (data, width, maxValue, options = {}) => {
   return new Array(rectSize).fill(row);
 };
 
-/** Draws a complete plain stacked bar chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available width.
- * @param {object} [options] - Bar options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawStackedChart(drawRow);
 
 export default drawChart;

package/src/charts/columns/block-frac-grouped.js

@@ -1,12 +1,6 @@
 import {drawColumn} from './block-frac.js';
 import drawGroupedChart from './draw-grouped.js';
 
-/** Draws a complete fractional block grouped column chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available height.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawColumn);
 
 export default drawChart;

package/src/charts/columns/block-frac.js

@@ -8,13 +8,6 @@ import {drawRealWidthBlock} from '../../draw-block-frac.js';
 // data = [datum]
 // datum = {value, colorState, symbol, state}
 
-/** Draws a single stacked column using fractional block characters.
- * @param {object[]} data - Normalized data series.
- * @param {number} width - Total height.
- * @param {number} maxValue - Maximum value for scaling.
- * @param {object} [options] - Options including `reverse`, `drawEmptyBorder`, `rectSize`, `initState`.
- * @returns {string[]} The drawn column lines.
- */
 export const drawColumn = (data, width, maxValue, options = {}) => {
   const {reverse, drawEmptyBorder, initState} = options,
     rectSize = Math.max(0, options.rectSize ?? 0.5),
@@ -32,12 +25,6 @@ export const drawColumn = (data, width, maxValue, options = {}) => {
   return result.map(line => optimize(line));
 };
 
-/** Draws a complete fractional block stacked column chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available height.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawStackedChart(drawColumn);
 
 export default drawChart;

package/src/charts/columns/block-grouped.js

@@ -1,12 +1,6 @@
 import {drawColumn} from './block.js';
 import drawGroupedChart from './draw-grouped.js';
 
-/** Draws a complete block grouped column chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available height.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawColumn);
 
 export default drawChart;

package/src/charts/columns/block.js

@@ -9,13 +9,6 @@ import defaultBlockTheme from '../../themes/blocks/unicode-half.js';
 // data = [datum]
 // datum = {value, colorState, symbol, state}
 
-/** Draws a single stacked column using block-drawing characters.
- * @param {object[]} data - Normalized data series.
- * @param {number} width - Total height.
- * @param {number} maxValue - Maximum value for scaling.
- * @param {object} [options] - Options including `reverse`, `blockTheme`, `rectSize`, `initState`.
- * @returns {string[]} The drawn column lines.
- */
 export const drawColumn = (data, width, maxValue, options = {}) => {
   const {reverse, blockTheme = defaultBlockTheme, rectSize = 0, initState = {}} = options,
     sizes = allocateSizes(data, maxValue, width),
@@ -39,12 +32,6 @@ export const drawColumn = (data, width, maxValue, options = {}) => {
   return result.map(line => optimize(line));
 };
 
-/** Draws a complete block stacked column chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available height.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawStackedChart(drawColumn);
 
 export default drawChart;

package/src/charts/columns/draw-grouped.js

@@ -3,10 +3,6 @@ import {normalizeData} from '../utils.js';
 import Panel from '../../panel.js';
 import style from '../../style.js';
 
-/** Creates a grouped column chart drawing function from a column-drawing function.
- * @param {Function} drawColumn - Function `(data, width, maxValue, options) => string[]`.
- * @returns {Function} Chart drawing function `(values, width, options) => string[]`.
- */
 export const drawChart =
   drawColumn =>
   (values, width, options = {}) => {
@@ -20,7 +16,7 @@ export const drawChart =
     const newData = [];
     data.forEach(series => {
       newData.push(...series);
-      if (series.length < maxSeriesLength) newData.push(...new Array(maxSeriesLength - series.length).fill(null));
+      for (let i = series.length; i < maxSeriesLength; ++i) newData.push(null);
     });
 
     const max =

package/src/charts/columns/draw-stacked.js

@@ -3,10 +3,6 @@ import {normalizeData, sumValues} from '../utils.js';
 import Panel from '../../panel.js';
 import style from '../../style.js';
 
-/** Creates a stacked column chart drawing function from a column-drawing function.
- * @param {Function} drawColumn - Function `(data, width, maxValue, options) => string[]`.
- * @returns {Function} Chart drawing function `(values, width, options) => string[]`.
- */
 export const drawChart =
   drawColumn =>
   (values, width, options = {}) => {

package/src/charts/columns/frac-grouped.js

@@ -7,14 +7,8 @@ import drawGroupedChart from './draw-grouped.js';
 // data = [datum]
 // datum = {value, colorState, symbol, state}
 
-/** Draws a single grouped column using fractional height block characters.
- * @param {object[]} data - Normalized data series.
- * @param {number} width - Total height.
- * @param {number} maxValue - Maximum value for scaling.
- * @param {object} [options] - Options including `reverse`, `rectSize`, `initState`.
- * @returns {string[]} The drawn column lines.
- */
 export const drawColumn = (data, width, maxValue, options = {}) => {
+  if (!maxValue) maxValue = 1;
   const {reverse, rectSize = 1, initState = {}} = options,
     blocks = data.map(datum => {
       if (!datum) return Box.makeBlank(rectSize, 0);
@@ -29,12 +23,6 @@ export const drawColumn = (data, width, maxValue, options = {}) => {
   return result.map(line => optimize(line));
 };
 
-/** Draws a complete fractional grouped column chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available height.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawColumn);
 
 export default drawChart;

package/src/charts/columns/plain-grouped.js

@@ -1,12 +1,6 @@
 import {drawColumn} from './plain.js';
 import drawGroupedChart from './draw-grouped.js';
 
-/** Draws a complete plain grouped column chart.
- * @param {any[]} values - Chart data.
- * @param {number} width - Available height.
- * @param {object} [options] - Options.
- * @returns {string[]} Array of strings representing the chart.
- */
 export const drawChart = drawGroupedChart(drawColumn);
 
 export default drawChart;