v2.3.1

Author: nshiab

deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@nshiab/journalism",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "exports": {
     ".": "./src/index.ts",
     "./web": "./src/web.ts"
@@ -24,7 +24,7 @@
     "@nshiab/journalism-dataviz": "jsr:@nshiab/journalism-dataviz@^1.0.3",
     "@nshiab/journalism-extras": "jsr:@nshiab/journalism-extras@^1.0.2",
     "@nshiab/journalism-finance": "jsr:@nshiab/journalism-finance@^1.1.0",
-    "@nshiab/journalism-format": "jsr:@nshiab/journalism-format@^1.1.0",
+    "@nshiab/journalism-format": "jsr:@nshiab/journalism-format@^1.1.1",
     "@nshiab/journalism-geo": "jsr:@nshiab/journalism-geo@^1.0.3",
     "@nshiab/journalism-google": "jsr:@nshiab/journalism-google@^1.0.4",
     "@nshiab/journalism-statistics": "jsr:@nshiab/journalism-statistics@^1.0.2",

deno.lock

@@ -5944,6 +5944,69 @@ const specificDuration = prettyDuration(start, { end });
 console.log(specificDuration); // Returns "22 days, 6 h, 3 min, 15 sec, 0 ms"
 ```
 
+## printTable
+
+Prints a formatted table to the console with support for word wrapping within
+cells. Unlike console.table(), this function properly handles multi-line content
+within cells, making it ideal for displaying data with long text values.
+
+This function has been created for the
+[simple-data-analysis library](https://github.com/nshiab/simple-data-analysis),
+but can be used independently for any array of objects.
+
+### Signature
+
+```typescript
+function printTable(
+  data: Record<string, unknown>[],
+  options?: {
+    maxColumnWidth?: number;
+    minColumnWidth?: number;
+    typesRowIndex?: number;
+  },
+): void;
+```
+
+### Parameters
+
+- **`data`**: - An array of objects representing the rows of the table. Each
+  object should have string keys.
+- **`options`**: - Optional configuration for table rendering.
+- **`options.maxColumnWidth`**: - The maximum width for any column (default:
+  75). Values exceeding this width will be wrapped at word boundaries.
+- **`options.minColumnWidth`**: - The minimum width for any column (default: 3).
+- **`options.typesRowIndex`**: - The index of a row that contains type
+  annotations (e.g. "VARCHAR/string"). This row will be rendered in grey. If
+  omitted, no row is treated as a types row.
+
+### Returns
+
+void - The table is printed directly to the console.
+
+### Examples
+
+```typescript
+const data = [
+  {
+    name: "Alice",
+    description: "A software engineer with expertise in TypeScript",
+  },
+  { name: "Bob", description: "A product manager" },
+];
+printTable(data, { maxColumnWidth: 30 });
+// Outputs a nicely formatted table with word-wrapped description column
+```
+
+```typescript
+// With types row
+const types = { name: "VARCHAR/string", age: "INTEGER/number" };
+const data = [
+  { name: "Alice", age: 30 },
+  { name: "Bob", age: 25 },
+];
+printTable([types, ...data], { typesRowIndex: 0 });
+```
+
 ## publishChartDW
 
 Publishes a specified Datawrapper chart, table, or map. This function