linecraft 0.5.3 → 0.5.5

package/lib/utils/text.d.ts

@@ -15,8 +15,8 @@ export declare function stripAnsi(text: string): string;
  * Truncate text to a maximum visual width while preserving ANSI escape codes
  *
  * This function truncates text based on its visual width (ignoring ANSI codes),
- * but preserves all ANSI escape sequences in the output. This is the base function
- * used by all other truncate functions.
+ * but preserves all ANSI escape sequences in the output. Active ANSI codes are
+ * preserved in the truncated result.
  *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
@@ -29,6 +29,9 @@ export declare function truncateToWidth(text: string, maxWidth: number): string;
 /**
  * Truncate text with ellipsis at the end, preserving ANSI escape codes
  *
+ * Active ANSI codes from the truncated portion are preserved, and the ellipsis
+ * is added after the truncated text (without ANSI codes).
+ *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
  * @returns Truncated text with '...' at the end, ANSI codes preserved
@@ -40,6 +43,10 @@ export declare function truncateEnd(text: string, maxWidth: number): string;
 /**
  * Truncate text with ellipsis at the beginning, preserving ANSI escape codes
  *
+ * When truncating from the start, we preserve ANSI codes that are active in the
+ * remaining portion. The ellipsis is added at the beginning (without ANSI codes),
+ * and active codes from the original text are re-applied to the remaining portion.
+ *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
  * @returns Truncated text with '...' at the beginning, ANSI codes preserved
@@ -51,6 +58,9 @@ export declare function truncateStart(text: string, maxWidth: number): string;
 /**
  * Truncate text with ellipsis in the middle, preserving ANSI escape codes
  *
+ * When truncating in the middle, we preserve ANSI codes from the start portion
+ * and re-apply them to the end portion to maintain consistent styling.
+ *
  * @param text - Text that may contain ANSI escape codes
  * @param maxWidth - Maximum visual width (number of visible characters)
  * @returns Truncated text with '...' in the middle, ANSI codes preserved
@@ -59,8 +69,60 @@ export declare function truncateStart(text: string, maxWidth: number): string;
  * truncateMiddle('\x1b[31mHello World\x1b[0m', 8) // '\x1b[31mHel...ld\x1b[0m'
  */
 export declare function truncateMiddle(text: string, maxWidth: number): string;
+/**
+ * Map an original column position to its display position in truncated text
+ *
+ * This function takes the original text, the truncated result, and the visible range
+ * that was shown, and maps an original column to where it appears in the truncated text.
+ *
+ * @param originalText - The original text (plain, no ANSI)
+ * @param truncatedText - The truncated text result (may have ellipsis)
+ * @param visibleStartCol - The first column that was shown (1-based, includes truncated before)
+ * @param visibleEndCol - The last column that was shown (1-based, includes truncated after)
+ * @param originalCol - The original column to map (1-based)
+ * @param rangeStartCol - The start column of the main range (1-based, optional, for better accuracy)
+ * @param rangeEndCol - The end column of the main range (1-based, optional, for better accuracy)
+ * @returns The display position in the truncated text (1-based, visible characters)
+ */
+export declare function mapColumnToDisplay(originalText: string, truncatedText: string, visibleStartCol: number, visibleEndCol: number, originalCol: number, rangeStartCol?: number, rangeEndCol?: number): number;
+/**
+ * Result of truncateFocusRange, including information about what range was shown
+ */
+export interface TruncateFocusRangeResult {
+    /** The truncated text with target range visible */
+    text: string;
+    /** The first column that was shown (1-based, includes truncated before portion) */
+    visibleStartCol: number;
+    /** The last column that was shown (1-based, includes truncated after portion) */
+    visibleEndCol: number;
+    /** The start column of the main range (1-based, the focused portion) */
+    rangeStartCol: number;
+    /** The end column of the main range (1-based, the focused portion) */
+    rangeEndCol: number;
+}
+/**
+ * Truncate text to show a specific column range, with ellipsis as needed
+ *
+ * This function ensures a target range (startCol to endCol) is visible in the output,
+ * adding ellipsis at the start, end, or both as needed to fit within maxWidth.
+ * All ANSI codes and OSC 8 hyperlinks are preserved.
+ *
+ * @param text - Text that may contain ANSI escape codes
+ * @param maxWidth - Maximum visual width (number of visible characters)
+ * @param targetStartCol - Start column of target range (1-based)
+ * @param targetEndCol - End column of target range (1-based, optional)
+ * @param maxColumn - Maximum column to show (optional, for limiting display)
+ * @returns Truncated text with target range visible, ANSI codes preserved, and visible range info
+ *
+ * @example
+ * truncateFocusRange('console.log("hello world");', 20, 1, 11)
+ * // Returns text showing columns 1-11 with ellipsis if needed
+ */
+export declare function truncateFocusRange(text: string, maxWidth: number, targetStartCol: number, targetEndCol?: number, maxColumn?: number): TruncateFocusRangeResult;
 /**
  * Wrap text to fit within a width, breaking on spaces
+ * Never breaks words mid-word - if a word is too long, it will extend the line
+ * ANSI-aware: calculates width based on visible characters, not raw string length
  */
 export declare function wrapText(text: string, width: number): string[];
 /**

package/lib/utils/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsCtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiCpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0CrE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAoD9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAGD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBtD;AAwCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA6CrG"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB9C;AAwDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgCtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsCrE;AAqBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CA+DR;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,wBAAwB,CAgK1B;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuK9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAGD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBtD;AA2JD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAyCrG"}