@peteanderson/ansi 3.0.0 → 3.2.0

package/dist/esm/split-at.js

@@ -0,0 +1,29 @@
+import { scanCSI, skippedSequences } from "./slice.js";
+/**
+ * Split a string into two parts at the given visible index (i.e., the given visible character,
+ * ignoring ANSI escape codes). The returned strings will include any ANSI escape codes from within
+ * each slice.
+ *
+ * Note that unlike {@linkcode slice}, this function doesn't, by default include any SGR codes (m)
+ * from before or after the split point. If you need to preserve the terminal state before and after
+* the split, pass `true` for the `includeSkipped` parameter.
+ */
+export function splitAt(text, visibleIndex, includeSkipped = false) {
+    if (!visibleIndex)
+        return ["", text];
+    if (visibleIndex < 0)
+        throw new Error("visibleIndex must be non-negative");
+    if (visibleIndex > text.length)
+        return [text, ""];
+    const { index } = scanCSI(text, 0, visibleIndex);
+    if (index === text.length)
+        return [text, ""];
+    let start = text.slice(0, index);
+    let end = text.slice(index);
+    if (includeSkipped) {
+        start += skippedSequences(text, index);
+        end = skippedSequences(text, 0, index) + end;
+    }
+    return [start, end];
+}
+//# sourceMappingURL=split-at.js.map

package/dist/esm/split-at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-at.js","sourceRoot":"","sources":["../../src/split-at.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAIlD;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CACtB,IAAuB,EACvB,YAAuB,EACvB,iBAA2B,KAAK;IAEhC,IAAI,CAAC,YAAY;QAChB,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAEnB,IAAI,YAAY,GAAG,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAEtD,IAAI,YAAY,GAAG,IAAI,CAAC,MAAM;QAC7B,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEnB,MAAM,EAAC,KAAK,EAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IAE/C,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM;QACxB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEnB,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACjC,IAAI,GAAG,GAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE9B,IAAI,cAAc,EAAE,CAAC;QACpB,KAAK,IAAI,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,GAAG,GAAM,gBAAgB,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,CAAC;IACjD,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACrB,CAAC"}

package/dist/esm/terminal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/terminal.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;CAwBb,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC;AA4BvC,eAAO,MAAM,YAAY,GAAI,iBAAc,KAAG,QAAyC,CAAC"}
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/terminal.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;CAwBb,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC;AA4BvC,eAAO,MAAM,YAAY,GAAI,iBAAc,KAAG,QAAyC,CAAC"}

package/dist/esm/terminal.js

@@ -1,23 +1,24 @@
+import { csi } from "./utils.js";
 const terminal = {
     focusReporting: {
-        enable: "\x1b[?1004h",
-        disable: "\x1b[?1004l",
-        focus: "\x1b[I",
-        blur: "\x1b[O",
+        enable: csi("?1004h"),
+        disable: csi("?1004l"),
+        focus: csi("I"),
+        blur: csi("O"),
     },
     alternateScreen: {
-        enable: "\x1b[?1049h",
-        disable: "\x1b[?1049l",
+        enable: csi("?1049h"),
+        disable: csi("?1049l"),
         legacy: {
-            enable: "\x1b[?47h",
-            disable: "\x1b[?47l",
+            enable: csi("?47h"),
+            disable: csi("?47l"),
         },
     },
     bracketedPaste: {
-        enable: "\x1b[?2004h",
-        disable: "\x1b[?2004l",
-        start: "\x1b[200~",
-        end: "\x1b[201~",
+        enable: csi("?2004h"),
+        disable: csi("?2004l"),
+        start: csi("200~"),
+        end: csi("201~"),
     },
 };
 const disabled = {

package/dist/esm/terminal.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/terminal.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG;IAChB,cAAc,EAAE;QACf,MAAM,EAAI,aAAa;QACvB,OAAO,EAAG,aAAa;QACvB,KAAK,EAAK,QAAQ;QAClB,IAAI,EAAM,QAAQ;KAClB;IAED,eAAe,EAAE;QAChB,MAAM,EAAI,aAAa;QACvB,OAAO,EAAG,aAAa;QAEvB,MAAM,EAAE;YACP,MAAM,EAAI,WAAW;YACrB,OAAO,EAAG,WAAW;SACrB;KACD;IAED,cAAc,EAAE;QACf,MAAM,EAAI,aAAa;QACvB,OAAO,EAAG,aAAa;QACvB,KAAK,EAAK,WAAW;QACrB,GAAG,EAAO,WAAW;KACrB;CACD,CAAC;AAIF,MAAM,QAAQ,GAAa;IAC1B,cAAc,EAAE;QACf,MAAM,EAAI,EAAE;QACZ,OAAO,EAAG,EAAE;QACZ,KAAK,EAAK,EAAE;QACZ,IAAI,EAAM,EAAE;KACZ;IAED,eAAe,EAAE;QAChB,MAAM,EAAI,EAAE;QACZ,OAAO,EAAG,EAAE;QAEZ,MAAM,EAAE;YACP,MAAM,EAAI,EAAE;YACZ,OAAO,EAAG,EAAE;SACZ;KACD;IAED,cAAc,EAAE;QACf,MAAM,EAAI,EAAE;QACZ,OAAO,EAAG,EAAE;QACZ,KAAK,EAAK,EAAE;QACZ,GAAG,EAAO,EAAE;KACZ;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,GAAG,IAAI,EAAY,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC"}
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,SAAS,CAAC;AAE5B,MAAM,QAAQ,GAAG;IAChB,cAAc,EAAE;QACf,MAAM,EAAI,GAAG,CAAC,QAAQ,CAAC;QACvB,OAAO,EAAG,GAAG,CAAC,QAAQ,CAAC;QACvB,KAAK,EAAK,GAAG,CAAC,GAAG,CAAC;QAClB,IAAI,EAAM,GAAG,CAAC,GAAG,CAAC;KAClB;IAED,eAAe,EAAE;QAChB,MAAM,EAAI,GAAG,CAAC,QAAQ,CAAC;QACvB,OAAO,EAAG,GAAG,CAAC,QAAQ,CAAC;QAEvB,MAAM,EAAE;YACP,MAAM,EAAI,GAAG,CAAC,MAAM,CAAC;YACrB,OAAO,EAAG,GAAG,CAAC,MAAM,CAAC;SACrB;KACD;IAED,cAAc,EAAE;QACf,MAAM,EAAI,GAAG,CAAC,QAAQ,CAAC;QACvB,OAAO,EAAG,GAAG,CAAC,QAAQ,CAAC;QACvB,KAAK,EAAK,GAAG,CAAC,MAAM,CAAC;QACrB,GAAG,EAAO,GAAG,CAAC,MAAM,CAAC;KACrB;CACD,CAAC;AAIF,MAAM,QAAQ,GAAa;IAC1B,cAAc,EAAE;QACf,MAAM,EAAI,EAAE;QACZ,OAAO,EAAG,EAAE;QACZ,KAAK,EAAK,EAAE;QACZ,IAAI,EAAM,EAAE;KACZ;IAED,eAAe,EAAE;QAChB,MAAM,EAAI,EAAE;QACZ,OAAO,EAAG,EAAE;QAEZ,MAAM,EAAE;YACP,MAAM,EAAI,EAAE;YACZ,OAAO,EAAG,EAAE;SACZ;KACD;IAED,cAAc,EAAE;QACf,MAAM,EAAI,EAAE;QACZ,OAAO,EAAG,EAAE;QACZ,KAAK,EAAK,EAAE;QACZ,GAAG,EAAO,EAAE;KACZ;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,GAAG,IAAI,EAAY,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC"}

package/dist/esm/types.d.ts

@@ -6,6 +6,7 @@ import type { Scroll } from "./scroll.js";
 import type { SGR } from "./sgr/index.js";
 import type { Simplify } from "./simplify/index.js";
 import type { Slice } from "./slice.js";
+import type { SplitAt } from "./split-at.js";
 import type { Sanitize, Strip, VisibleLength } from "./strip.js";
 import type { Terminal } from "./terminal.js";
 export type Ansi = SGR & {
@@ -19,6 +20,7 @@ export type Ansi = SGR & {
     visibleLength: VisibleLength;
     sanitize: Sanitize;
     slice: Slice;
+    splitAt: SplitAt;
     simplify: Simplify;
     features: Features;
 };

package/dist/esm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAA8B,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,KAAK,EAAC,MAA+B,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAA4B,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAC,MAAM,EAAE,QAAQ,EAAC,MAAoB,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAC,MAAM,EAAC,MAA8B,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,GAAG,EAAC,MAAiC,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAA4B,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAC,KAAK,EAAC,MAA+B,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAC,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAA4B,YAAY,CAAC;AAE/D,MAAM,MAAM,IAAI,GAAG,GAAG,GAAG;IACxB,MAAM,EAAK,MAAM,CAAC;IAClB,KAAK,EAAM,KAAK,CAAC;IACjB,MAAM,EAAK,MAAM,CAAC;IAClB,QAAQ,EAAG,QAAQ,CAAC;IAEpB,MAAM,EAAK,MAAM,CAAC;IAClB,QAAQ,EAAG,QAAQ,CAAC;IAEpB,KAAK,EAAW,KAAK,CAAC;IACtB,aAAa,EAAG,aAAa,CAAC;IAC9B,QAAQ,EAAQ,QAAQ,CAAC;IACzB,KAAK,EAAW,KAAK,CAAC;IACtB,QAAQ,EAAQ,QAAQ,CAAC;IAEzB,QAAQ,EAAG,QAAQ,CAAC;CACpB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAA8B,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,KAAK,EAAC,MAA+B,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAA4B,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAC,MAAM,EAAE,QAAQ,EAAC,MAAoB,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAC,MAAM,EAAC,MAA8B,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,GAAG,EAAC,MAAiC,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAA4B,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAC,KAAK,EAAC,MAA+B,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAC,OAAO,EAAC,MAA6B,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAC,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAC,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAC,QAAQ,EAAC,MAA4B,YAAY,CAAC;AAE/D,MAAM,MAAM,IAAI,GAAG,GAAG,GAAG;IACxB,MAAM,EAAK,MAAM,CAAC;IAClB,KAAK,EAAM,KAAK,CAAC;IACjB,MAAM,EAAK,MAAM,CAAC;IAClB,QAAQ,EAAG,QAAQ,CAAC;IAEpB,MAAM,EAAK,MAAM,CAAC;IAClB,QAAQ,EAAG,QAAQ,CAAC;IAEpB,KAAK,EAAW,KAAK,CAAC;IACtB,aAAa,EAAG,aAAa,CAAC;IAC9B,QAAQ,EAAQ,QAAQ,CAAC;IACzB,KAAK,EAAW,KAAK,CAAC;IACtB,OAAO,EAAS,OAAO,CAAC;IACxB,QAAQ,EAAQ,QAAQ,CAAC;IAEzB,QAAQ,EAAG,QAAQ,CAAC;CACpB,CAAC"}

package/dist/esm/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function csi(command: string): string;
+export declare function csi(params: string | number | undefined, command: string): string;
+export declare const count: <Param extends [number?] = [count?: number]>(code: string) => (...args: Param) => string;
+export declare const noop: () => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;AAC7C,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;AAQlF,eAAO,MAAM,KAAK,GAAI,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAC/D,MAAM,MAAM,KACV,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,MACmE,CAAC;AAE3F,eAAO,MAAM,IAAI,cAAW,CAAC"}

package/dist/esm/utils.js

@@ -0,0 +1,8 @@
+export function csi(...args) {
+    const command = args.pop();
+    const params = args.pop();
+    return `\x1b[${params === undefined ? "" : params}${command}`;
+}
+export const count = (code) => (count) => count === 0 ? "" : csi(count === 1 ? undefined : count, code);
+export const noop = () => "";
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,CAAC,GAAG,IAAsD;IAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAY,CAAC;IACrC,MAAM,MAAM,GAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,OAAO,QAAQ,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,CACpB,IAAY,EACiB,EAAE,CAC/B,CAAC,KAAc,EAAU,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAE3F,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name"            : "@peteanderson/ansi",
-	"version"         : "3.0.0",
+	"version"         : "3.2.0",
 	"description"     : "ANSI escape sequence generation with automatic feature detection",
 	"author"          : {
 		"name"  : "Pete Anderson",

package/src/ansi.ts

@@ -6,6 +6,7 @@ import {makeScroll}                     from "./scroll";
 import {makeSGR}                        from "./sgr";
 import {simplify}                       from "./simplify";
 import {slice}                          from "./slice";
+import {splitAt}                        from "./split-at";
 import {sanitize, strip, visibleLength} from "./strip";
 import {makeTerminal}                   from "./terminal";
 
@@ -32,6 +33,7 @@ export function makeAnsi(...args: Args): Ansi {
 		sanitize,
 		slice,
 		simplify,
+		splitAt,
 
 		features,
 	};
@@ -41,7 +43,7 @@ export const ansi = makeAnsi();
 
 export const {fg, bg, style, reset, cursor, erase, scroll, terminal} = ansi;
 
-export {padEnd, padStart, strip, visibleLength}
+export {padEnd, padStart, splitAt, strip, visibleLength}
 
 export default Object.assign(
 	Object.defineProperty(makeAnsi.bind(undefined), "name", {value: "ansi"}),

package/src/cursor.ts

@@ -1,7 +1,4 @@
-const move = (code: string) => (count?: number): string =>
-	`\x1b[${count === undefined ? "" : count ? count : "?"}${code}`;
-
-const noop = (): string => "";
+import {csi, count as move, noop} from "./utils";
 
 const cursor = {
 	up       : move("A"),
@@ -11,35 +8,38 @@ const cursor = {
 	nextLine : move("E"),
 	prevLine : move("F"),
 
-	x: (x: number): string => `\x1b[${x}G`,
+	// Don't use `move`/`count` here, because it will output an empty string if `x` is `0`, but the
+	// terminal accepts `\x1b[0G` and will process it the same as `\x1b[1G`/`x1b[G`. Also, the
+	// parameter for `move`/`count` is optional, but the parameter for `x` is required.
+	x: (x: number) => csi(x, "G"),
 
 	// These are the old VT100 codes, but they're widely supported by old and new terminals. The
 	// newer VT220 codes are standardized by ECMA and ISO, and are also widely supported, but might
 	// not work in some older terminals. The VT220 codes are:
 	//
 	// ```
-	// save    : "\x1b[s",
-	// restore : "\x1b[u",
+	// save    : csi("s"),
+	// restore : csi("u"),
 	// ```
 	save    : "\x1b7",
 	restore : "\x1b8",
 
-	hide : "\x1b[?25l",
-	show : "\x1b[?25h",
+	hide : csi("?25l"),
+	show : csi("?25h"),
 
 	position: {
-		get: "\x1b[6n",
-		set: (x: number, y: number): string => `\x1b[${y};${x}H`,
+		get: csi("6n"),
+		set: (x: number, y: number): string => csi(`${y};${x}H`),
 	},
 
 	shape: {
-		steadyBlock       : "\x1b[2 q",
-		steadyBar         : "\x1b[6 q",
-		steadyUnderline   : "\x1b[4 q",
-		blinkingBlock     : "\x1b[1 q",
-		blinkingBar       : "\x1b[5 q",
-		blinkingUnderline : "\x1b[3 q",
-		default           : "\x1b[0 q",
+		steadyBlock       : csi("2 q"),
+		steadyBar         : csi("6 q"),
+		steadyUnderline   : csi("4 q"),
+		blinkingBlock     : csi("1 q"),
+		blinkingBar       : csi("5 q"),
+		blinkingUnderline : csi("3 q"),
+		default           : csi("0 q"),
 	},
 };
 

package/src/erase.ts

@@ -1,14 +1,16 @@
+import {csi} from "./utils";
+
 const erase = {
 	line: {
-		toStart : "\x1b[1K",
-		toEnd   : "\x1b[0K",
-		full    : "\x1b[2K",
+		toStart : csi("1K"),
+		toEnd   : csi("0K"),
+		full    : csi("2K"),
 	},
 	screen: {
-		toStart    : "\x1b[1J",
-		toEnd      : "\x1b[0J",
-		full       : "\x1b[2J",
-		scrollback : "\x1b[3J",
+		toStart    : csi("1J"),
+		toEnd      : csi("0J"),
+		full       : csi("2J"),
+		scrollback : csi("3J"),
 	},
 };
 

package/src/scroll.ts

@@ -1,13 +1,15 @@
+import {count, noop} from "./utils";
+
 const scroll = {
-	up   : (lines?: number): string => `\x1b[${lines ?? 1}S`,
-	down : (lines?: number): string => `\x1b[${lines ?? 1}T`,
+	up   : count<[lines?: number]>("S"),
+	down : count<[lines?: number]>("T"),
 };
 
 export type Scroll = typeof scroll;
 
 const disabled: Scroll = {
-	up   : () => "",
-	down : () => "",
+	up   : noop,
+	down : noop,
 };
 
 export const makeScroll = (enabled = true): Scroll => enabled ? scroll : disabled;

package/src/sgr/color/channel.ts

@@ -1,3 +1,4 @@
+import {csi}               from "../../utils";
 import {lazy}              from "../lazy";
 import {buildContext}      from "./context";
 import {makeRGB, makeX256} from "./rgb";
@@ -29,7 +30,7 @@ export function makeChannel(
 	const rtn = {
 		rgb     : makeRGB(ctx),
 		x256    : makeX256(ctx),
-		default : colorDepth > 1 ? `\x1b[${close}m` : "",
+		default : colorDepth > 1 ? csi(close, "m") : "",
 	} as Channel;
 
 	for (let i = 0; i < colors.length; i++) {

package/src/sgr/format-builder.ts

@@ -1,4 +1,5 @@
 import {define}       from "@peteanderson/props";
+import {csi}          from "../utils";
 import {combineCodes} from "./combine";
 import {lazy}         from "./lazy";
 
@@ -19,8 +20,8 @@ export const makeFormatBuilder = (makeChain: ChainBuilder): FormatBuilder =>
 		const empty         = Array.isArray(open) && !open.length;
 		const openCode      = empty ? "" : codeSequence(open);
 		const closeCode     = empty ? "" : codeSequence(close);
-		const openSequence  = empty ? "" :`\x1b[${openCode}m`;
-		const closeSequence = empty ? "" :`\x1b[${closeCode}m`;
+		const openSequence  = empty ? "" : csi(openCode, "m");
+		const closeSequence = empty ? "" : csi(closeCode, "m");
 		const reopenCode    = reset && !empty ? `${closeCode};${openCode}` : openCode;
 
 		const rxClose = new RegExp(

package/src/sgr/reset.ts

@@ -1 +1,3 @@
-export const makeReset = (enabled = true): string => enabled ? "\x1b[m" : "";
+import {csi} from "../utils";
+
+export const makeReset = (enabled = true): string => enabled ? csi("m") : "";

package/src/simplify/simplify.ts

@@ -1,4 +1,5 @@
 import {rxSGR} from "../patterns";
+import {csi}   from "../utils";
 import {State} from "./state";
 
 export function simplify(text: string): string {
@@ -20,7 +21,7 @@ export function simplify(text: string): string {
 
 		const newCodes = state.update(codes);
 		if (newCodes.length)
-			result += `\x1b[${newCodes.join(";")}m`;
+			result += csi(newCodes.join(";"), "m");
 		result += chunk;
 	}
 

package/src/slice.ts

@@ -2,7 +2,7 @@ import {rxCSI, rxSGR}  from "./patterns";
 import {simplify}      from "./simplify";
 import {visibleLength} from "./strip";
 
-function scanCSI(
+export function scanCSI(
 	text            : string,
 	fromStringIndex : number,
 	visibleCount    : number,
@@ -30,7 +30,7 @@ function scanCSI(
 	return {index, length};
 }
 
-function skippedSequences(text: string, start: number, end?: number): string {
+export function skippedSequences(text: string, start: number, end?: number): string {
 	const sequences = text.slice(start, end).match(new RegExp(rxSGR));
 	return sequences ? simplify(sequences.join("")) : "";
 }
@@ -54,17 +54,18 @@ function skippedSequences(text: string, start: number, end?: number): string {
  * of the slice as it would be if the whole string were printed. This function is intended mostly
  * for text that contains SGR codes, but no other ANSI codes or control characters.
  */
-export function slice(text: string, start: number, end: number): string {
+export function slice(text: string, start: number, end?: number): string {
 	let textVisibleLength: number | undefined;
 	const getVisibleLength = () => textVisibleLength ??= visibleLength(text);
 
-	if (start < 0 || end < 0) {
-		textVisibleLength = getVisibleLength();
-		if (start < 0)
-			start = Math.max(0, textVisibleLength + start);
-		if (end < 0)
-			end = Math.max(0, textVisibleLength + end);
-	}
+	if (end === undefined)
+		end = getVisibleLength();
+
+	if (start < 0)
+		start = Math.max(0, getVisibleLength() + start);
+	if (end < 0)
+		end = Math.max(0, getVisibleLength() + end);
+
 	if (start > end)
 		return "";
 

package/src/split-at.ts

@@ -0,0 +1,44 @@
+import {scanCSI, skippedSequences} from "./slice";
+
+import type {slice} from "./slice";
+
+/**
+ * Split a string into two parts at the given visible index (i.e., the given visible character,
+ * ignoring ANSI escape codes). The returned strings will include any ANSI escape codes from within
+ * each slice.
+ *
+ * Note that unlike {@linkcode slice}, this function doesn't, by default include any SGR codes (m)
+ * from before or after the split point. If you need to preserve the terminal state before and after
+* the split, pass `true` for the `includeSkipped` parameter.
+ */
+export function splitAt(
+	text           : string,
+	visibleIndex   : number,
+	includeSkipped : boolean = false,
+): [start: string, end: string] {
+	if (!visibleIndex)
+		return ["", text];
+
+	if (visibleIndex < 0)
+		throw new Error("visibleIndex must be non-negative");
+
+	if (visibleIndex > text.length)
+		return [text, ""];
+
+	const {index} = scanCSI(text, 0, visibleIndex);
+
+	if (index === text.length)
+		return [text, ""];
+
+	let start = text.slice(0, index);
+	let end   = text.slice(index);
+
+	if (includeSkipped) {
+		start += skippedSequences(text, index);
+		end    = skippedSequences(text, 0, index) + end;
+	}
+
+	return [start, end];
+}
+
+export type SplitAt = typeof splitAt;

package/src/terminal.ts

@@ -1,26 +1,28 @@
+import {csi} from "./utils";
+
 const terminal = {
 	focusReporting: {
-		enable  : "\x1b[?1004h",
-		disable : "\x1b[?1004l",
-		focus   : "\x1b[I",
-		blur    : "\x1b[O",
+		enable  : csi("?1004h"),
+		disable : csi("?1004l"),
+		focus   : csi("I"),
+		blur    : csi("O"),
 	},
 
 	alternateScreen: {
-		enable  : "\x1b[?1049h",
-		disable : "\x1b[?1049l",
+		enable  : csi("?1049h"),
+		disable : csi("?1049l"),
 
 		legacy: {
-			enable  : "\x1b[?47h",
-			disable : "\x1b[?47l",
+			enable  : csi("?47h"),
+			disable : csi("?47l"),
 		},
 	},
 
 	bracketedPaste: {
-		enable  : "\x1b[?2004h",
-		disable : "\x1b[?2004l",
-		start   : "\x1b[200~",
-		end     : "\x1b[201~",
+		enable  : csi("?2004h"),
+		disable : csi("?2004l"),
+		start   : csi("200~"),
+		end     : csi("201~"),
 	},
 };
 

package/src/types.ts

@@ -6,6 +6,7 @@ import type {Scroll}                         from "./scroll";
 import type {SGR}                            from "./sgr";
 import type {Simplify}                       from "./simplify";
 import type {Slice}                          from "./slice";
+import type {SplitAt}                        from "./split-at";
 import type {Sanitize, Strip, VisibleLength} from "./strip";
 import type {Terminal}                       from "./terminal";
 
@@ -22,6 +23,7 @@ export type Ansi = SGR & {
 	visibleLength : VisibleLength;
 	sanitize      : Sanitize;
 	slice         : Slice;
+	splitAt       : SplitAt;
 	simplify      : Simplify;
 
 	features : Features;

package/src/utils.ts

@@ -0,0 +1,15 @@
+export function csi(command: string): string;
+export function csi(params: string | number | undefined, command: string): string;
+export function csi(...args: [string] | [string | number | undefined, string]): string {
+	const command = args.pop() as string;
+	const params  = args.pop();
+
+	return `\x1b[${params === undefined ? "" : params}${command}`;
+}
+
+export const count = <Param extends [number?] = [count?: number]>(
+	code: string
+): (...args: Param) => string =>
+	(count?: number): string => count === 0 ? "" : csi(count === 1 ? undefined : count, code);
+
+export const noop = () => "";