clarifies nature of 'table' output format

Author: jacoscaz

src/bin.ts

@@ -6,14 +6,13 @@ import { fileURLToPath } from 'node:url';
 import { cwd } from 'node:process';
 import { resolve } from 'node:path';
 import { readFileSync } from 'node:fs';
-import { writeFile } from 'node:fs/promises';
 
 import { ArgumentParser } from 'argparse';
 
 import { parseFolder } from './parse.js';
 import { renderCSV } from './renderers/csv.js';
 import { renderJSON } from './renderers/json.js';
-import { renderTabular } from './renderers/table.js';
+import { renderMarkdownTable } from './renderers/markdown-table.js';
 
 import { 
   compileTagFilterExpressions, 
@@ -68,7 +67,7 @@ arg_parser.add_argument('-U', '--unchecked', {
 
 arg_parser.add_argument('-o', '--out', {
   required: false,
-  default: 'tabular',
+  default: 'table',
   choices: ['table', 'csv', 'json'],
   help: 'set output format'
 });
@@ -150,8 +149,12 @@ const render_opts: RenderOpts = {
 const render_fn = ({
   json: renderJSON,
   csv: renderCSV,
-  table: renderTabular,
-} satisfies Record<string, RenderItemsFn>)[cli_args.out as string] ?? renderTabular;
+  table: renderMarkdownTable,
+} satisfies Record<string, RenderItemsFn>)[cli_args.out as string];
+
+if (!render_fn) {
+  throw new Error(`Unsupported output format "${cli_args.out}"`);
+}
 
 // ============================================================================
 //                              RENDERING HELPER

src/renderers/table.ts src/renderers/markdown-table.tssrc/renderers/table.ts renamed to src/renderers/markdown-table.ts

@@ -78,7 +78,7 @@ const buildColumnDescriptors = (show_tags: string[]): ColumnDescriptor[] => {
  * If the "text" tag is selected for display, longer values are truncated and
  * ellipsed in a best-effort to fit each line within the width of the terminal.
  */
-export const renderTabular: RenderItemsFn = (items, show_tags, opts) => {
+export const renderMarkdownTable: RenderItemsFn = (items, show_tags, opts) => {
 
   const { terminal_width } = opts;