@optave/codegraph 3.1.2 → 3.1.4

package/src/presentation/result-formatter.js

@@ -0,0 +1,21 @@
+import { printNdjson } from '../paginate.js';
+
+/**
+ * Shared JSON / NDJSON output dispatch for CLI wrappers.
+ *
+ * @param {object} data   - Result object from a *Data() function
+ * @param {string} field  - Array field name for NDJSON streaming (e.g. 'results')
+ * @param {object} opts   - CLI options ({ json?, ndjson? })
+ * @returns {boolean} true if output was handled (caller should return early)
+ */
+export function outputResult(data, field, opts) {
+  if (opts.ndjson) {
+    printNdjson(data, field);
+    return true;
+  }
+  if (opts.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return true;
+  }
+  return false;
+}

package/src/presentation/sequence-renderer.js

@@ -0,0 +1,43 @@
+/**
+ * Mermaid sequence diagram renderer — pure data → string transform.
+ *
+ * Converts sequenceData() output into Mermaid sequenceDiagram syntax.
+ * No DB access, no I/O — just data in, formatted string out.
+ */
+
+/**
+ * Escape special Mermaid characters in labels.
+ */
+function escapeMermaid(str) {
+  return str
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/:/g, '#colon;')
+    .replace(/"/g, '#quot;');
+}
+
+/**
+ * Convert sequenceData result to Mermaid sequenceDiagram syntax.
+ * @param {{ participants, messages, truncated, depth }} seqResult
+ * @returns {string}
+ */
+export function sequenceToMermaid(seqResult) {
+  const lines = ['sequenceDiagram'];
+
+  for (const p of seqResult.participants) {
+    lines.push(`    participant ${p.id} as ${escapeMermaid(p.label)}`);
+  }
+
+  for (const msg of seqResult.messages) {
+    const arrow = msg.type === 'return' ? '-->>' : '->>';
+    lines.push(`    ${msg.from}${arrow}${msg.to}: ${escapeMermaid(msg.label)}`);
+  }
+
+  if (seqResult.truncated && seqResult.participants.length > 0) {
+    lines.push(
+      `    note right of ${seqResult.participants[0].id}: Truncated at depth ${seqResult.depth}`,
+    );
+  }
+
+  return lines.join('\n');
+}

package/src/presentation/table.js

@@ -0,0 +1,47 @@
+/**
+ * Shared table formatting utilities for CLI output.
+ *
+ * Pure data → formatted string transforms. No I/O — callers handle printing.
+ */
+
+/**
+ * Format a table with aligned columns.
+ *
+ * @param {object} opts
+ * @param {Array<{ header: string, width: number, align?: 'left'|'right' }>} opts.columns
+ * @param {string[][]} opts.rows - Each row is an array of string cell values
+ * @param {number} [opts.indent=2] - Leading spaces per line
+ * @returns {string} Formatted table string (header + separator + data rows)
+ */
+export function formatTable({ columns, rows, indent = 2 }) {
+  const prefix = ' '.repeat(indent);
+  const header = columns
+    .map((c) => (c.align === 'right' ? c.header.padStart(c.width) : c.header.padEnd(c.width)))
+    .join(' ');
+  const separator = columns.map((c) => '\u2500'.repeat(c.width)).join(' ');
+  const lines = [`${prefix}${header}`, `${prefix}${separator}`];
+  for (const row of rows) {
+    const cells = columns.map((c, i) => {
+      const val = row[i] ?? '';
+      return c.align === 'right' ? val.padStart(c.width) : val.padEnd(c.width);
+    });
+    lines.push(`${prefix}${cells.join(' ')}`);
+  }
+  return lines.join('\n');
+}
+
+/**
+ * Truncate a string from the end, appending '\u2026' if truncated.
+ */
+export function truncEnd(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return `${str.slice(0, maxLen - 1)}\u2026`;
+}
+
+/**
+ * Truncate a string from the start, prepending '\u2026' if truncated.
+ */
+export function truncStart(str, maxLen) {
+  if (str.length <= maxLen) return str;
+  return `\u2026${str.slice(-(maxLen - 1))}`;
+}