@oclif/table 0.1.24 → 0.2.1

package/lib/index.d.ts

@@ -1,2 +1,2 @@
-export { printTable, printTables } from './table.js';
+export { makeTable, printTable, printTables } from './table.js';
 export type { TableOptions } from './types.js';

package/lib/index.js

@@ -1 +1 @@
-export { printTable, printTables } from './table.js';
+export { makeTable, printTable, printTables } from './table.js';

package/lib/table.d.ts

@@ -27,10 +27,30 @@ export declare function Skeleton(props: React.PropsWithChildren & {
     readonly height?: number;
 }): React.JSX.Element;
 /**
- * Renders a table with the given data.
- * @param options see {@link TableOptions}
+ * Prints a table based on the provided options. If the data length exceeds 50,000 entries,
+ * the table is rendered in chunks to handle large datasets efficiently.
+ *
+ * @template T - A generic type that extends a record with string keys and unknown values.
+ * @param {TableOptions<T>} options - The options for rendering the table, including data and other configurations.
+ * @returns {void}
  */
 export declare function printTable<T extends Record<string, unknown>>(options: TableOptions<T>): void;
+/**
+ * Generates a table as a string based on the provided options.
+ *
+ * @template T - A generic type extending a record with string keys and unknown values.
+ * @param {TableOptions<T>} options - The options to configure the table.
+ * @returns {string} The rendered table as a string.
+ */
+export declare function makeTable<T extends Record<string, unknown>>(options: TableOptions<T>): string;
+/**
+ * Prints multiple tables to the console.
+ *
+ * @template T - An array of records where each record represents a table.
+ * @param {Object.<keyof T, TableOptions<T[keyof T]>>} tables - An object containing table options for each table.
+ * @param {Omit<ContainerProps, 'children'>} [options] - Optional container properties excluding 'children'.
+ * @throws {Error} Throws an error if the total number of rows across all tables exceeds 30,000.
+ */
 export declare function printTables<T extends Record<string, unknown>[]>(tables: {
     [P in keyof T]: TableOptions<T[P]>;
 }, options?: Omit<ContainerProps, 'children'>): void;

package/lib/table.js

@@ -37,7 +37,7 @@ function determineConfiguredWidth(providedWidth, columns = process.stdout.column
  * This allows us to use the minimum width required to display the table if the configured width is too small.
  */
 function determineWidthToUse(columns, configuredWidth) {
-    const tableWidth = columns.map((c) => c.width).reduce((a, b) => a + b) + columns.length + 1;
+    const tableWidth = columns.map((c) => c.width).reduce((a, b) => a + b, 0) + columns.length + 1;
     return tableWidth < configuredWidth ? configuredWidth : tableWidth;
 }
 function determineTruncatePosition(overflow) {
@@ -306,7 +306,7 @@ const createStdout = () => {
         const stripped = stripAnsi(f);
         return stripped !== '' && stripped !== '\n';
     })
-        .at(-1);
+        .at(-1) ?? '';
     return stdout;
 };
 class Output {
@@ -355,8 +355,12 @@ function renderTableInChunks(props) {
     footerOutput.maybePrintLastFrame();
 }
 /**
- * Renders a table with the given data.
- * @param options see {@link TableOptions}
+ * Prints a table based on the provided options. If the data length exceeds 50,000 entries,
+ * the table is rendered in chunks to handle large datasets efficiently.
+ *
+ * @template T - A generic type that extends a record with string keys and unknown values.
+ * @param {TableOptions<T>} options - The options for rendering the table, including data and other configurations.
+ * @returns {void}
  */
 export function printTable(options) {
     if (options.data.length > 50_000) {
@@ -368,9 +372,30 @@ export function printTable(options) {
     instance.unmount();
     output.maybePrintLastFrame();
 }
+/**
+ * Generates a table as a string based on the provided options.
+ *
+ * @template T - A generic type extending a record with string keys and unknown values.
+ * @param {TableOptions<T>} options - The options to configure the table.
+ * @returns {string} The rendered table as a string.
+ */
+export function makeTable(options) {
+    const output = new Output();
+    const instance = render(React.createElement(Table, { ...options }), { stdout: output.stream });
+    instance.unmount();
+    return output.stream.lastFrame() ?? '';
+}
 function Container(props) {
     return (React.createElement(Box, { flexWrap: "wrap", flexDirection: props.direction ?? 'row', ...props }, props.children));
 }
+/**
+ * Prints multiple tables to the console.
+ *
+ * @template T - An array of records where each record represents a table.
+ * @param {Object.<keyof T, TableOptions<T[keyof T]>>} tables - An object containing table options for each table.
+ * @param {Omit<ContainerProps, 'children'>} [options] - Optional container properties excluding 'children'.
+ * @throws {Error} Throws an error if the total number of rows across all tables exceeds 30,000.
+ */
 export function printTables(tables, options) {
     if (tables.reduce((acc, table) => acc + table.data.length, 0) > 30_000) {
         throw new Error('The data is too large to print multiple tables. Please use `printTable` instead.');

package/lib/utils.js

@@ -67,7 +67,7 @@ export function getColumns(config, headings) {
         };
     });
     const numberOfBorders = widths.length + 1;
-    const calculateTableWidth = (widths) => widths.map((w) => w.width + w.padding * 2).reduce((a, b) => a + b) + numberOfBorders;
+    const calculateTableWidth = (widths) => widths.map((w) => w.width + w.padding * 2).reduce((a, b) => a + b, 0) + numberOfBorders;
     // If the table is too wide, reduce the width of the largest column as little as possible to fit the table.
     // At most, it will reduce the width to the length of the column's header plus padding.
     // If the table is still too wide, it will reduce the width of the next largest column and so on

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/table",
   "description": "Display table in terminal",
-  "version": "0.1.24",
+  "version": "0.2.1",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/table/issues",
   "dependencies": {