@git-stunts/git-warp 11.2.1 → 11.5.0

package/src/visualization/layouts/elkLayout.js

@@ -7,20 +7,23 @@
 
 /**
  * @typedef {{ id: string, x?: number, y?: number, width?: number, height?: number, labels?: Array<{ text: string }> }} ElkResultChild
- * @typedef {{ id: string, sources?: string[], targets?: string[], labels?: Array<{ text: string }>, sections?: any[] }} ElkResultEdge
+ * @typedef {{ id: string, sources?: string[], targets?: string[], labels?: Array<{ text: string }>, sections?: unknown[] }} ElkResultEdge
  * @typedef {{ children?: ElkResultChild[], edges?: ElkResultEdge[], width?: number, height?: number }} ElkResult
- * @typedef {{ id: string, x: number, y: number, width: number, height: number, label: string }} PosNode
- * @typedef {{ id: string, source: string, target: string, label?: string, sections: any[] }} PosEdge
+ * @typedef {{ id: string, x: number, y: number, width: number, height: number, label?: string }} PosNode
+ * @typedef {{ x: number, y: number }} LayoutPoint
+ * @typedef {{ startPoint?: LayoutPoint, endPoint?: LayoutPoint, bendPoints?: LayoutPoint[] }} LayoutSection
+ * @typedef {{ id: string, source: string, target: string, label?: string, sections?: LayoutSection[] }} PosEdge
  * @typedef {{ nodes: PosNode[], edges: PosEdge[], width: number, height: number }} PositionedGraph
  * @typedef {{ id: string, children?: Array<{ id: string, width?: number, height?: number, labels?: Array<{ text: string }> }>, edges?: Array<{ id: string, sources?: string[], targets?: string[], labels?: Array<{ text: string }> }>, layoutOptions?: Record<string, string> }} ElkGraphInput
+ * @typedef {{ layout: (graph: ElkGraphInput) => Promise<ElkResult> }} ElkEngine
  */
 
-/** @type {Promise<any> | null} */
+/** @type {Promise<unknown> | null} */
 let elkPromise = null;
 
 /**
  * Returns (or creates) a singleton ELK instance.
- * @returns {Promise<any>} ELK instance
+ * @returns {Promise<unknown>} ELK instance
  */
 function getElk() {
   if (!elkPromise) {
@@ -39,7 +42,7 @@ export async function runLayout(elkGraph) {
   /** @type {ElkResult | undefined} */
   let result;
   try {
-    const elk = await getElk();
+    const elk = /** @type {ElkEngine} */ (await getElk());
     result = await elk.layout(elkGraph);
   } catch {
     return fallbackLayout(elkGraph);
@@ -67,7 +70,7 @@ function toPositionedGraph(result) {
     source: e.sources?.[0] ?? '',
     target: e.targets?.[0] ?? '',
     label: e.labels?.[0]?.text,
-    sections: e.sections ?? [],
+    sections: /** @type {LayoutSection[]} */ (e.sections ?? []),
   }));
 
   return {

package/src/visualization/layouts/index.js

@@ -21,7 +21,7 @@ import { runLayout } from './elkLayout.js';
  *
  * @param {{ nodes: Array<{ id: string, label: string }>, edges: Array<{ from: string, to: string, label?: string }> }} graphData - Normalised graph data
  * @param {{ type?: 'query'|'path'|'slice', layoutOptions?: Record<string, string> }} [options]
- * @returns {Promise<{ nodes: any[], edges: any[], width: number, height: number }>} PositionedGraph
+ * @returns {Promise<import('./elkLayout.js').PositionedGraph>} PositionedGraph
  */
 export async function layoutGraph(graphData, options = {}) {
   const elkGraph = toElkGraph(graphData, options);

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

@@ -30,7 +30,7 @@ import { formatOpSummary } from './opSummary.js';
  * @property {number} patchCount
  * @property {Map<string, WriterInfo> | Record<string, WriterInfo>} perWriter
  * @property {{ nodes?: number, edges?: number }} [diff]
- * @property {Record<string, any>} [tickReceipt]
+ * @property {Record<string, unknown>} [tickReceipt]
  * @property {import('../../../domain/services/StateDiff.js').StateDiffResult | null} [structuralDiff]
  * @property {string} [diffBaseline]
  * @property {number | null} [baselineTick]
@@ -73,7 +73,7 @@ function pluralize(n, singular, plural) {
   return n === 1 ? singular : plural;
 }
 
-/** @param {Record<string, any> | undefined} tickReceipt @returns {string[]} */
+/** @param {Record<string, unknown> | undefined} tickReceipt @returns {string[]} */
 function buildReceiptLines(tickReceipt) {
   if (!tickReceipt || typeof tickReceipt !== 'object') {
     return [];
@@ -85,8 +85,12 @@ function buildReceiptLines(tickReceipt) {
 
   const lines = [];
   for (const [writerId, entry] of entries) {
-    const sha = typeof entry.sha === 'string' ? entry.sha : null;
-    const opSummary = entry.opSummary && typeof entry.opSummary === 'object' ? entry.opSummary : entry;
+    /** @type {Record<string, unknown>} */
+    const rec = /** @type {Record<string, unknown>} */ (entry);
+    const sha = typeof rec.sha === 'string' ? rec.sha : null;
+    const opSummary = rec.opSummary && typeof rec.opSummary === 'object'
+      ? /** @type {Record<string, number>} */ (rec.opSummary)
+      : /** @type {Record<string, number>} */ (rec);
     const name = padRight(formatWriterName(writerId, NAME_W), NAME_W);
     const shaStr = sha ? `  ${formatSha(sha)}` : '';
     lines.push(`    ${name}${shaStr}  ${formatOpSummary(opSummary, 40)}`);
@@ -443,14 +447,20 @@ function collectDiffEntries(diff) {
 
 /**
  * Formats a property value for display (truncated if too long).
- * @param {*} value
+ * @param {unknown} value
  * @returns {string}
  */
 function formatPropValue(value) {
   if (value === undefined) {
     return 'undefined';
   }
-  const s = typeof value === 'string' ? `"${value}"` : String(value);
+  if (typeof value === 'string') {
+    const s = `"${value}"`;
+    return s.length > 40 ? `${s.slice(0, 37)}...` : s;
+  }
+  const s = typeof value === 'number' || typeof value === 'boolean'
+    ? String(value)
+    : JSON.stringify(value) ?? '';
   return s.length > 40 ? `${s.slice(0, 37)}...` : s;
 }
 

package/src/visualization/renderers/svg/index.js

@@ -119,7 +119,7 @@ function renderEdge(edge) {
 /**
  * Renders a PositionedGraph as an SVG string.
  *
- * @param {{ nodes?: Array<{ id: string, x: number, y: number, width: number, height: number, label?: string }>, edges?: Array<{ sections?: Array<any>, label?: string }>, width?: number, height?: number }} positionedGraph - PositionedGraph from runLayout()
+ * @param {{ nodes?: Array<{ id: string, x: number, y: number, width: number, height: number, label?: string }>, edges?: Array<{ sections?: Array<{ startPoint?: { x: number, y: number }, endPoint?: { x: number, y: number }, bendPoints?: Array<{ x: number, y: number }> }>, label?: string }>, width?: number, height?: number }} positionedGraph - PositionedGraph from runLayout()
  * @param {{ title?: string }} [options]
  * @returns {string} Complete SVG markup
  */