@git-stunts/git-warp 12.3.0 → 12.4.1

package/src/visualization/renderers/ascii/path.js

@@ -55,11 +55,7 @@ function segmentFits(currentWidth, segmentWidth, maxWidth) {
 
 /**
  * Creates a path segment with node and optional arrow.
- * @param {Object} opts - Segment options
- * @param {string} opts.nodeId - Node ID
- * @param {number} opts.index - Position in path
- * @param {number} opts.pathLength - Total path length
- * @param {string[]} [opts.edges] - Optional edge labels
+ * @param {{ nodeId: string, index: number, pathLength: number, edges?: string[] }} opts - Segment options
  * @returns {{segment: string, width: number}} Segment string and its width
  */
 function createPathSegment({ nodeId, index, pathLength, edges }) {
@@ -164,13 +160,7 @@ function renderSameNode(nodeId) {
 
 /**
  * Renders a found path.
- * @param {Object} payload - Path payload
- * @param {string} payload.graph - Graph name
- * @param {string} payload.from - Source node ID
- * @param {string} payload.to - Target node ID
- * @param {string[]} payload.path - Array of node IDs in the path
- * @param {number} payload.length - Path length (number of edges)
- * @param {string[]} [payload.edges] - Optional array of edge labels
+ * @param {{ graph: string, from: string, to: string, path: string[], length: number, edges?: string[] }} payload - Path payload
  * @param {number} [terminalWidth] - Terminal width for wrapping
  * @returns {string} Formatted ASCII output
  */
@@ -203,16 +193,8 @@ function renderFoundPath(payload, terminalWidth = DEFAULT_TERMINAL_WIDTH) {
 
 /**
  * Renders the path view.
- * @param {Object} payload - The path command payload
- * @param {string} payload.graph - Graph name
- * @param {string} payload.from - Source node ID
- * @param {string} payload.to - Target node ID
- * @param {boolean} payload.found - Whether a path was found
- * @param {string[]} payload.path - Array of node IDs in the path
- * @param {number} payload.length - Path length (number of edges)
- * @param {string[]} [payload.edges] - Optional array of edge labels
- * @param {Object} [options] - Rendering options
- * @param {number} [options.terminalWidth] - Terminal width for wrapping
+ * @param {{ graph: string, from: string, to: string, found: boolean, path: string[], length: number, edges?: string[] }} payload - The path command payload
+ * @param {{ terminalWidth?: number }} [options] - Rendering options
  * @returns {string} Formatted ASCII output
  */
 export function renderPathView(payload, options = {}) {

package/src/visualization/renderers/ascii/progress.js

@@ -7,10 +7,7 @@ import chalk from 'chalk';
  *
  * @param {number} percent - Percentage value (clamped to 0-100)
  * @param {number} [width=20] - Character width of the bar
- * @param {Object} [options] - Display options
- * @param {string} [options.filled='█'] - Character for filled segments
- * @param {string} [options.empty='░'] - Character for empty segments
- * @param {boolean} [options.showPercent=true] - Whether to append the percentage value
+ * @param {{ filled?: string, empty?: string, showPercent?: boolean }} [options] - Display options
  * @returns {string} The rendered progress bar with ANSI colors
  */
 export function progressBar(percent, width = 20, options = {}) {

package/src/visualization/renderers/ascii/seek.js

@@ -234,11 +234,7 @@ function buildLane(patchSet, points, currentTick) {
  * Between consecutive columns, connector characters of the appropriate style
  * fill the gap (COL_W − 1 chars).
  *
- * @param {Object} opts
- * @param {string} opts.writerId
- * @param {WriterInfo} opts.writerInfo - `{ ticks, tipSha, tickShas }`
- * @param {{ points: number[] }} opts.win - Computed window
- * @param {number} opts.currentTick - Active seek cursor tick
+ * @param {{ writerId: string, writerInfo: WriterInfo, win: { points: number[] }, currentTick: number }} opts
  * @returns {string} Formatted, indented swimlane line
  */
 function buildWriterSwimRow({ writerId, writerInfo, win, currentTick }) {

package/src/visualization/renderers/ascii/table.js

@@ -3,9 +3,7 @@ import Table from 'cli-table3';
 /**
  * Creates a cli-table3 instance with default WARP styling.
  *
- * @param {Object} [options] - Options forwarded to cli-table3 constructor
- * @param {string[]} [options.head] - Column headers
- * @param {Object} [options.style] - Style overrides (defaults: head=cyan, border=gray)
+ * @param {{ head?: string[], style?: Record<string, unknown>, [key: string]: unknown }} [options] - Options forwarded to cli-table3 constructor
  * @returns {InstanceType<typeof Table>} A cli-table3 instance
  */
 export function createTable(options = {}) {