@earendil-works/pi-tui 0.87.1 → 0.99.0

package/dist/wheel-scroll.d.ts

@@ -0,0 +1,23 @@
+/** Lines moved per mouse-wheel event, or `"auto"` to accelerate fast wheel spins. */
+export type WheelScrollLines = number | "auto";
+/**
+ * Converts wheel events into line counts.
+ *
+ * In `"auto"` mode on terminals that do not accelerate wheel input, the count follows event
+ * velocity: an isolated notch moves one line, while a fast spin moves up to six lines per event.
+ * For example, notches 100 ms apart move 1 line each, 50 ms apart move 2, and 20 ms apart move 5.
+ */
+export declare class WheelScrollAccelerator {
+    private lines;
+    private readonly accelerate;
+    private lastTime;
+    private lastDirection;
+    private averageGap;
+    private carry;
+    constructor(lines?: WheelScrollLines, accelerate?: boolean);
+    setLines(lines: WheelScrollLines): void;
+    /** Return the positive line count for a wheel event in `direction` at time `now` (milliseconds). */
+    next(direction: -1 | 1, now: number): number;
+    private reset;
+}
+//# sourceMappingURL=wheel-scroll.d.ts.map

package/dist/wheel-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wheel-scroll.d.ts","sourceRoot":"","sources":["../src/wheel-scroll.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAC;AA0B/C;;;;;;GAMG;AACH,qBAAa,sBAAsB;IAClC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,KAAK,CAAK;IAElB,YAAY,KAAK,GAAE,gBAAyB,EAAE,UAAU,UAA8B,EAGrF;IAED,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAGtC;IAED,oGAAoG;IACpG,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAoB3C;IAED,OAAO,CAAC,KAAK;CAMb"}

package/dist/wheel-scroll.js

@@ -0,0 +1,73 @@
+// Several events closer than this belong to one physical notch (Ghostty emits them ~4 ms apart)
+// or come from a high-resolution source. They move one line each and do not accelerate.
+const BURST_GAP_MS = 5;
+// A pause longer than this ends a scroll gesture.
+const GESTURE_GAP_MS = 200;
+// Average event gap that maps to one line per event. Faster events scale up proportionally.
+const REFERENCE_GAP_MS = 100;
+const MAX_AUTO_LINES = 6;
+/**
+ * Local macOS terminals receive wheel and trackpad deltas that the OS has already accelerated,
+ * and they emit one event per line. Other platforms, and SSH sessions where the client platform
+ * is unknown, usually send one event per wheel notch.
+ */
+function terminalAcceleratesWheel() {
+    const env = process.env;
+    return (process.platform === "darwin" &&
+        env.SSH_CONNECTION === undefined &&
+        env.SSH_CLIENT === undefined &&
+        env.SSH_TTY === undefined);
+}
+/**
+ * Converts wheel events into line counts.
+ *
+ * In `"auto"` mode on terminals that do not accelerate wheel input, the count follows event
+ * velocity: an isolated notch moves one line, while a fast spin moves up to six lines per event.
+ * For example, notches 100 ms apart move 1 line each, 50 ms apart move 2, and 20 ms apart move 5.
+ */
+export class WheelScrollAccelerator {
+    lines;
+    accelerate;
+    lastTime = Number.NEGATIVE_INFINITY;
+    lastDirection = 0;
+    averageGap;
+    carry = 0;
+    constructor(lines = "auto", accelerate = !terminalAcceleratesWheel()) {
+        this.lines = lines;
+        this.accelerate = accelerate;
+    }
+    setLines(lines) {
+        this.lines = lines;
+        this.reset();
+    }
+    /** Return the positive line count for a wheel event in `direction` at time `now` (milliseconds). */
+    next(direction, now) {
+        if (this.lines !== "auto")
+            return Number.isFinite(this.lines) ? Math.max(1, Math.floor(this.lines)) : 1;
+        if (!this.accelerate)
+            return 1;
+        const gap = now - this.lastTime;
+        const sameGesture = direction === this.lastDirection && gap <= GESTURE_GAP_MS;
+        this.lastTime = now;
+        this.lastDirection = direction;
+        if (!sameGesture) {
+            this.averageGap = undefined;
+            this.carry = 0;
+            return 1;
+        }
+        if (gap < BURST_GAP_MS)
+            return 1;
+        this.averageGap = this.averageGap === undefined ? gap : (this.averageGap + gap) / 2;
+        const lines = Math.min(MAX_AUTO_LINES, Math.max(1, REFERENCE_GAP_MS / this.averageGap)) + this.carry;
+        const whole = Math.floor(lines);
+        this.carry = lines - whole;
+        return whole;
+    }
+    reset() {
+        this.lastTime = Number.NEGATIVE_INFINITY;
+        this.lastDirection = 0;
+        this.averageGap = undefined;
+        this.carry = 0;
+    }
+}
+//# sourceMappingURL=wheel-scroll.js.map

package/dist/wheel-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wheel-scroll.js","sourceRoot":"","sources":["../src/wheel-scroll.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,wFAAwF;AACxF,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,kDAAkD;AAClD,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,4FAA4F;AAC5F,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAC7B,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB;;;;GAIG;AACH,SAAS,wBAAwB;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,OAAO,CACN,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC7B,GAAG,CAAC,cAAc,KAAK,SAAS;QAChC,GAAG,CAAC,UAAU,KAAK,SAAS;QAC5B,GAAG,CAAC,OAAO,KAAK,SAAS,CACzB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IAC1B,KAAK,CAAmB;IACf,UAAU,CAAU;IAC7B,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpC,aAAa,GAAG,CAAC,CAAC;IAClB,UAAU,CAAqB;IAC/B,KAAK,GAAG,CAAC,CAAC;IAElB,YAAY,KAAK,GAAqB,MAAM,EAAE,UAAU,GAAG,CAAC,wBAAwB,EAAE;QACrF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,QAAQ,CAAC,KAAuB;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;IAED,oGAAoG;IACpG,IAAI,CAAC,SAAiB,EAAE,GAAW;QAClC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxG,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO,CAAC,CAAC;QAE/B,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAChC,MAAM,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC,aAAa,IAAI,GAAG,IAAI,cAAc,CAAC;QAC9E,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QAC/B,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YACf,OAAO,CAAC,CAAC;QACV,CAAC;QACD,IAAI,GAAG,GAAG,YAAY;YAAE,OAAO,CAAC,CAAC;QAEjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACpF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;QAC3B,OAAO,KAAK,CAAC;IACd,CAAC;IAEO,KAAK;QACZ,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IAChB,CAAC;CACD","sourcesContent":["/** Lines moved per mouse-wheel event, or `\"auto\"` to accelerate fast wheel spins. */\nexport type WheelScrollLines = number | \"auto\";\n\n// Several events closer than this belong to one physical notch (Ghostty emits them ~4 ms apart)\n// or come from a high-resolution source. They move one line each and do not accelerate.\nconst BURST_GAP_MS = 5;\n// A pause longer than this ends a scroll gesture.\nconst GESTURE_GAP_MS = 200;\n// Average event gap that maps to one line per event. Faster events scale up proportionally.\nconst REFERENCE_GAP_MS = 100;\nconst MAX_AUTO_LINES = 6;\n\n/**\n * Local macOS terminals receive wheel and trackpad deltas that the OS has already accelerated,\n * and they emit one event per line. Other platforms, and SSH sessions where the client platform\n * is unknown, usually send one event per wheel notch.\n */\nfunction terminalAcceleratesWheel(): boolean {\n\tconst env = process.env;\n\treturn (\n\t\tprocess.platform === \"darwin\" &&\n\t\tenv.SSH_CONNECTION === undefined &&\n\t\tenv.SSH_CLIENT === undefined &&\n\t\tenv.SSH_TTY === undefined\n\t);\n}\n\n/**\n * Converts wheel events into line counts.\n *\n * In `\"auto\"` mode on terminals that do not accelerate wheel input, the count follows event\n * velocity: an isolated notch moves one line, while a fast spin moves up to six lines per event.\n * For example, notches 100 ms apart move 1 line each, 50 ms apart move 2, and 20 ms apart move 5.\n */\nexport class WheelScrollAccelerator {\n\tprivate lines: WheelScrollLines;\n\tprivate readonly accelerate: boolean;\n\tprivate lastTime = Number.NEGATIVE_INFINITY;\n\tprivate lastDirection = 0;\n\tprivate averageGap: number | undefined;\n\tprivate carry = 0;\n\n\tconstructor(lines: WheelScrollLines = \"auto\", accelerate = !terminalAcceleratesWheel()) {\n\t\tthis.lines = lines;\n\t\tthis.accelerate = accelerate;\n\t}\n\n\tsetLines(lines: WheelScrollLines): void {\n\t\tthis.lines = lines;\n\t\tthis.reset();\n\t}\n\n\t/** Return the positive line count for a wheel event in `direction` at time `now` (milliseconds). */\n\tnext(direction: -1 | 1, now: number): number {\n\t\tif (this.lines !== \"auto\") return Number.isFinite(this.lines) ? Math.max(1, Math.floor(this.lines)) : 1;\n\t\tif (!this.accelerate) return 1;\n\n\t\tconst gap = now - this.lastTime;\n\t\tconst sameGesture = direction === this.lastDirection && gap <= GESTURE_GAP_MS;\n\t\tthis.lastTime = now;\n\t\tthis.lastDirection = direction;\n\t\tif (!sameGesture) {\n\t\t\tthis.averageGap = undefined;\n\t\t\tthis.carry = 0;\n\t\t\treturn 1;\n\t\t}\n\t\tif (gap < BURST_GAP_MS) return 1;\n\n\t\tthis.averageGap = this.averageGap === undefined ? gap : (this.averageGap + gap) / 2;\n\t\tconst lines = Math.min(MAX_AUTO_LINES, Math.max(1, REFERENCE_GAP_MS / this.averageGap)) + this.carry;\n\t\tconst whole = Math.floor(lines);\n\t\tthis.carry = lines - whole;\n\t\treturn whole;\n\t}\n\n\tprivate reset(): void {\n\t\tthis.lastTime = Number.NEGATIVE_INFINITY;\n\t\tthis.lastDirection = 0;\n\t\tthis.averageGap = undefined;\n\t\tthis.carry = 0;\n\t}\n}\n"]}

package/dist/word-navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"word-navigation.d.ts","sourceRoot":"","sources":["../src/word-navigation.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACrC,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,yGAAyG;IACzG,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAgDtG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAuCrG","sourcesContent":["import { getWordSegmenter, isWhitespaceChar, PUNCTUATION_REGEX } from \"./utils.ts\";\n\nconst wordSegmenter = getWordSegmenter();\n\n/**\n * Options for word navigation functions.\n * When omitted, uses the default Intl.Segmenter word segmentation.\n */\nexport interface WordNavigationOptions {\n\t/** Custom segmenter returning word segments for the given text. */\n\tsegment?: (text: string) => Iterable<Intl.SegmentData>;\n\t/** Predicate identifying atomic segments that should be treated as single units (e.g. paste markers). */\n\tisAtomicSegment?: (segment: string) => boolean;\n}\n\n/**\n * Find the cursor position after moving one word backward from `cursor` in `text`.\n * Skips trailing whitespace, then stops at the next word/punctuation boundary.\n *\n * Pure function - does not mutate any state.\n */\nexport function findWordBackward(text: string, cursor: number, options?: WordNavigationOptions): number {\n\tif (cursor <= 0) return 0;\n\n\tconst textBeforeCursor = text.slice(0, cursor);\n\tconst segmentFn = options?.segment;\n\tconst isAtomic = options?.isAtomicSegment;\n\tconst segments = segmentFn ? [...segmentFn(textBeforeCursor)] : [...wordSegmenter.segment(textBeforeCursor)];\n\tlet newCursor = cursor;\n\n\t// Skip trailing whitespace\n\twhile (\n\t\tsegments.length > 0 &&\n\t\t!isAtomic?.(segments[segments.length - 1]?.segment || \"\") &&\n\t\tisWhitespaceChar(segments[segments.length - 1]?.segment || \"\")\n\t) {\n\t\tnewCursor -= segments.pop()?.segment.length || 0;\n\t}\n\n\tif (segments.length === 0) return newCursor;\n\n\tconst last = segments[segments.length - 1]!;\n\n\tif (isAtomic?.(last.segment)) {\n\t\t// Skip one atomic segment.\n\t\tnewCursor -= last.segment.length;\n\t} else if (last.isWordLike) {\n\t\t// Skip inside one word-like segment, preserving ASCII punctuation boundaries.\n\t\tconst segment = last.segment;\n\t\tconst matches = [...segment.matchAll(new RegExp(PUNCTUATION_REGEX, \"g\"))];\n\t\tif (matches.length <= 0) {\n\t\t\tnewCursor -= segment.length;\n\t\t} else {\n\t\t\tconst lastMatch = matches[matches.length - 1]!;\n\t\t\tnewCursor -= segment.length - (lastMatch.index + lastMatch[0].length);\n\t\t}\n\t} else {\n\t\t// Skip non-word non-whitespace run (punctuation)\n\t\twhile (\n\t\t\tsegments.length > 0 &&\n\t\t\t!isAtomic?.(segments[segments.length - 1]?.segment || \"\") &&\n\t\t\t!segments[segments.length - 1]?.isWordLike &&\n\t\t\t!isWhitespaceChar(segments[segments.length - 1]?.segment || \"\")\n\t\t) {\n\t\t\tnewCursor -= segments.pop()?.segment.length || 0;\n\t\t}\n\t}\n\n\treturn newCursor;\n}\n\n/**\n * Find the cursor position after moving one word forward from `cursor` in `text`.\n * Skips leading whitespace, then stops at the next word/punctuation boundary.\n *\n * Pure function - does not mutate any state.\n */\nexport function findWordForward(text: string, cursor: number, options?: WordNavigationOptions): number {\n\tif (cursor >= text.length) return text.length;\n\n\tconst textAfterCursor = text.slice(cursor);\n\tconst segmentFn = options?.segment;\n\tconst isAtomic = options?.isAtomicSegment;\n\tconst segments = segmentFn ? segmentFn(textAfterCursor) : wordSegmenter.segment(textAfterCursor);\n\tconst iterator = segments[Symbol.iterator]();\n\tlet next = iterator.next();\n\tlet newCursor = cursor;\n\n\t// Skip leading whitespace\n\twhile (!next.done && !isAtomic?.(next.value.segment) && isWhitespaceChar(next.value.segment)) {\n\t\tnewCursor += next.value.segment.length;\n\t\tnext = iterator.next();\n\t}\n\n\tif (next.done) return newCursor;\n\n\tif (isAtomic?.(next.value.segment)) {\n\t\t// Skip one atomic segment.\n\t\tnewCursor += next.value.segment.length;\n\t} else if (next.value.isWordLike) {\n\t\t// Skip inside one word-like segment, preserving ASCII punctuation boundaries.\n\t\tnewCursor += PUNCTUATION_REGEX.exec(next.value.segment)?.index ?? next.value.segment.length;\n\t} else {\n\t\t// Skip non-word non-whitespace run (punctuation)\n\t\twhile (\n\t\t\t!next.done &&\n\t\t\t!isAtomic?.(next.value.segment) &&\n\t\t\t!next.value.isWordLike &&\n\t\t\t!isWhitespaceChar(next.value.segment)\n\t\t) {\n\t\t\tnewCursor += next.value.segment.length;\n\t\t\tnext = iterator.next();\n\t\t}\n\t}\n\n\treturn newCursor;\n}\n"]}
+{"version":3,"file":"word-navigation.d.ts","sourceRoot":"","sources":["../src/word-navigation.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACrC,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,yGAAyG;IACzG,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC/C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAgDtG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAuCrG"}

package/dist/word-navigation.js.map

@@ -1 +1 @@
-{"version":3,"file":"word-navigation.js","sourceRoot":"","sources":["../src/word-navigation.ts"],"names":[],"mappings":"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","sourcesContent":["import { getWordSegmenter, isWhitespaceChar, PUNCTUATION_REGEX } from \"./utils.ts\";\n\nconst wordSegmenter = getWordSegmenter();\n\n/**\n * Options for word navigation functions.\n * When omitted, uses the default Intl.Segmenter word segmentation.\n */\nexport interface WordNavigationOptions {\n\t/** Custom segmenter returning word segments for the given text. */\n\tsegment?: (text: string) => Iterable<Intl.SegmentData>;\n\t/** Predicate identifying atomic segments that should be treated as single units (e.g. paste markers). */\n\tisAtomicSegment?: (segment: string) => boolean;\n}\n\n/**\n * Find the cursor position after moving one word backward from `cursor` in `text`.\n * Skips trailing whitespace, then stops at the next word/punctuation boundary.\n *\n * Pure function - does not mutate any state.\n */\nexport function findWordBackward(text: string, cursor: number, options?: WordNavigationOptions): number {\n\tif (cursor <= 0) return 0;\n\n\tconst textBeforeCursor = text.slice(0, cursor);\n\tconst segmentFn = options?.segment;\n\tconst isAtomic = options?.isAtomicSegment;\n\tconst segments = segmentFn ? [...segmentFn(textBeforeCursor)] : [...wordSegmenter.segment(textBeforeCursor)];\n\tlet newCursor = cursor;\n\n\t// Skip trailing whitespace\n\twhile (\n\t\tsegments.length > 0 &&\n\t\t!isAtomic?.(segments[segments.length - 1]?.segment || \"\") &&\n\t\tisWhitespaceChar(segments[segments.length - 1]?.segment || \"\")\n\t) {\n\t\tnewCursor -= segments.pop()?.segment.length || 0;\n\t}\n\n\tif (segments.length === 0) return newCursor;\n\n\tconst last = segments[segments.length - 1]!;\n\n\tif (isAtomic?.(last.segment)) {\n\t\t// Skip one atomic segment.\n\t\tnewCursor -= last.segment.length;\n\t} else if (last.isWordLike) {\n\t\t// Skip inside one word-like segment, preserving ASCII punctuation boundaries.\n\t\tconst segment = last.segment;\n\t\tconst matches = [...segment.matchAll(new RegExp(PUNCTUATION_REGEX, \"g\"))];\n\t\tif (matches.length <= 0) {\n\t\t\tnewCursor -= segment.length;\n\t\t} else {\n\t\t\tconst lastMatch = matches[matches.length - 1]!;\n\t\t\tnewCursor -= segment.length - (lastMatch.index + lastMatch[0].length);\n\t\t}\n\t} else {\n\t\t// Skip non-word non-whitespace run (punctuation)\n\t\twhile (\n\t\t\tsegments.length > 0 &&\n\t\t\t!isAtomic?.(segments[segments.length - 1]?.segment || \"\") &&\n\t\t\t!segments[segments.length - 1]?.isWordLike &&\n\t\t\t!isWhitespaceChar(segments[segments.length - 1]?.segment || \"\")\n\t\t) {\n\t\t\tnewCursor -= segments.pop()?.segment.length || 0;\n\t\t}\n\t}\n\n\treturn newCursor;\n}\n\n/**\n * Find the cursor position after moving one word forward from `cursor` in `text`.\n * Skips leading whitespace, then stops at the next word/punctuation boundary.\n *\n * Pure function - does not mutate any state.\n */\nexport function findWordForward(text: string, cursor: number, options?: WordNavigationOptions): number {\n\tif (cursor >= text.length) return text.length;\n\n\tconst textAfterCursor = text.slice(cursor);\n\tconst segmentFn = options?.segment;\n\tconst isAtomic = options?.isAtomicSegment;\n\tconst segments = segmentFn ? segmentFn(textAfterCursor) : wordSegmenter.segment(textAfterCursor);\n\tconst iterator = segments[Symbol.iterator]();\n\tlet next = iterator.next();\n\tlet newCursor = cursor;\n\n\t// Skip leading whitespace\n\twhile (!next.done && !isAtomic?.(next.value.segment) && isWhitespaceChar(next.value.segment)) {\n\t\tnewCursor += next.value.segment.length;\n\t\tnext = iterator.next();\n\t}\n\n\tif (next.done) return newCursor;\n\n\tif (isAtomic?.(next.value.segment)) {\n\t\t// Skip one atomic segment.\n\t\tnewCursor += next.value.segment.length;\n\t} else if (next.value.isWordLike) {\n\t\t// Skip inside one word-like segment, preserving ASCII punctuation boundaries.\n\t\tnewCursor += PUNCTUATION_REGEX.exec(next.value.segment)?.index ?? next.value.segment.length;\n\t} else {\n\t\t// Skip non-word non-whitespace run (punctuation)\n\t\twhile (\n\t\t\t!next.done &&\n\t\t\t!isAtomic?.(next.value.segment) &&\n\t\t\t!next.value.isWordLike &&\n\t\t\t!isWhitespaceChar(next.value.segment)\n\t\t) {\n\t\t\tnewCursor += next.value.segment.length;\n\t\t\tnext = iterator.next();\n\t\t}\n\t}\n\n\treturn newCursor;\n}\n"]}
+{"version":3,"file":"word-navigation.js","sourceRoot":"","sources":["../src/word-navigation.ts"],"names":[],"mappings":"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","sourcesContent":["import { getWordSegmenter, isWhitespaceChar, PUNCTUATION_REGEX } from \"./utils.ts\";\n\nconst wordSegmenter = getWordSegmenter();\n\n/**\n * Options for word navigation functions.\n * When omitted, uses the default Intl.Segmenter word segmentation.\n */\nexport interface WordNavigationOptions {\n\t/** Custom segmenter returning word segments for the given text. */\n\tsegment?: (text: string) => Iterable<Intl.SegmentData>;\n\t/** Predicate identifying atomic segments that should be treated as single units (e.g. paste markers). */\n\tisAtomicSegment?: (segment: string) => boolean;\n}\n\n/**\n * Find the cursor position after moving one word backward from `cursor` in `text`.\n * Skips trailing whitespace, then stops at the next word/punctuation boundary.\n *\n * Pure function - does not mutate any state.\n */\nexport function findWordBackward(text: string, cursor: number, options?: WordNavigationOptions): number {\n\tif (cursor <= 0) return 0;\n\n\tconst textBeforeCursor = text.slice(0, cursor);\n\tconst segmentFn = options?.segment;\n\tconst isAtomic = options?.isAtomicSegment;\n\tconst segments = segmentFn ? [...segmentFn(textBeforeCursor)] : [...wordSegmenter.segment(textBeforeCursor)];\n\tlet newCursor = cursor;\n\n\t// Skip trailing whitespace\n\twhile (\n\t\tsegments.length > 0 &&\n\t\t!isAtomic?.(segments[segments.length - 1]?.segment || \"\") &&\n\t\tisWhitespaceChar(segments[segments.length - 1]?.segment || \"\")\n\t) {\n\t\tnewCursor -= segments.pop()?.segment.length || 0;\n\t}\n\n\tif (segments.length === 0) return newCursor;\n\n\tconst last = segments[segments.length - 1]!;\n\n\tif (isAtomic?.(last.segment)) {\n\t\t// Skip one atomic segment.\n\t\tnewCursor -= last.segment.length;\n\t} else if (last.isWordLike) {\n\t\t// Skip inside one word-like segment, preserving ASCII punctuation boundaries.\n\t\tconst segment = last.segment;\n\t\tconst matches = [...segment.matchAll(new RegExp(PUNCTUATION_REGEX, \"g\"))];\n\t\tif (matches.length <= 0) {\n\t\t\tnewCursor -= segment.length;\n\t\t} else {\n\t\t\tconst lastMatch = matches[matches.length - 1]!;\n\t\t\tnewCursor -= segment.length - (lastMatch.index + lastMatch[0].length);\n\t\t}\n\t} else {\n\t\t// Skip non-word non-whitespace run (punctuation)\n\t\twhile (\n\t\t\tsegments.length > 0 &&\n\t\t\t!isAtomic?.(segments[segments.length - 1]?.segment || \"\") &&\n\t\t\t!segments[segments.length - 1]?.isWordLike &&\n\t\t\t!isWhitespaceChar(segments[segments.length - 1]?.segment || \"\")\n\t\t) {\n\t\t\tnewCursor -= segments.pop()?.segment.length || 0;\n\t\t}\n\t}\n\n\treturn newCursor;\n}\n\n/**\n * Find the cursor position after moving one word forward from `cursor` in `text`.\n * Skips leading whitespace, then stops at the next word/punctuation boundary.\n *\n * Pure function - does not mutate any state.\n */\nexport function findWordForward(text: string, cursor: number, options?: WordNavigationOptions): number {\n\tif (cursor >= text.length) return text.length;\n\n\tconst textAfterCursor = text.slice(cursor);\n\tconst segmentFn = options?.segment;\n\tconst isAtomic = options?.isAtomicSegment;\n\tconst segments = segmentFn ? segmentFn(textAfterCursor) : wordSegmenter.segment(textAfterCursor);\n\tconst iterator = segments[Symbol.iterator]();\n\tlet next = iterator.next();\n\tlet newCursor = cursor;\n\n\t// Skip leading whitespace\n\twhile (!next.done && !isAtomic?.(next.value.segment) && isWhitespaceChar(next.value.segment)) {\n\t\tnewCursor += next.value.segment.length;\n\t\tnext = iterator.next();\n\t}\n\n\tif (next.done) return newCursor;\n\n\tif (isAtomic?.(next.value.segment)) {\n\t\t// Skip one atomic segment.\n\t\tnewCursor += next.value.segment.length;\n\t} else if (next.value.isWordLike) {\n\t\t// Skip inside one word-like segment, preserving ASCII punctuation boundaries.\n\t\tnewCursor += PUNCTUATION_REGEX.exec(next.value.segment)?.index ?? next.value.segment.length;\n\t} else {\n\t\t// Skip non-word non-whitespace run (punctuation)\n\t\twhile (\n\t\t\t!next.done &&\n\t\t\t!isAtomic?.(next.value.segment) &&\n\t\t\t!next.value.isWordLike &&\n\t\t\t!isWhitespaceChar(next.value.segment)\n\t\t) {\n\t\t\tnewCursor += next.value.segment.length;\n\t\t\tnext = iterator.next();\n\t\t}\n\t}\n\n\treturn newCursor;\n}\n"]}

package/native/clipboard.h

@@ -7,8 +7,17 @@
 #include <string.h>
 #endif
 
-typedef enum { CLIPBOARD_TEXT, CLIPBOARD_IMAGE, CLIPBOARD_WRITE } clipboard_operation;
-typedef enum { CLIPBOARD_UNAVAILABLE, CLIPBOARD_EMPTY, CLIPBOARD_UTF8, CLIPBOARD_LATIN1, CLIPBOARD_UTF16, CLIPBOARD_BUFFER } clipboard_format;
+typedef enum { CLIPBOARD_TEXT, CLIPBOARD_IMAGE, CLIPBOARD_WRITE, CLIPBOARD_FILES } clipboard_operation;
+// CLIPBOARD_PATHS stores concatenated, NUL-terminated UTF-8 paths in clipboard_job.data.
+typedef enum {
+    CLIPBOARD_UNAVAILABLE,
+    CLIPBOARD_EMPTY,
+    CLIPBOARD_UTF8,
+    CLIPBOARD_LATIN1,
+    CLIPBOARD_UTF16,
+    CLIPBOARD_BUFFER,
+    CLIPBOARD_PATHS
+} clipboard_format;
 
 typedef struct {
     napi_async_work work;
@@ -63,6 +72,33 @@ static void PI_NAPI_CALL execute_clipboard_work(napi_env env, void* data) {
     clipboard_execute(data);
 }
 
+static int create_clipboard_paths_value(
+    napi_env env,
+    const clipboard_job* job,
+    napi_create_string_utf8_fn create_string,
+    napi_value* result
+) {
+    napi_create_array_fn create_array = (napi_create_array_fn)node_symbol("napi_create_array");
+    napi_set_element_fn set_element = (napi_set_element_fn)node_symbol("napi_set_element");
+    if (!create_array || !set_element || create_array(env, result) != 0) return 1;
+
+    const char* cursor = job->data;
+    const char* end = cursor + job->length;
+    for (uint32_t index = 0; cursor < end; index++) {
+        const char* terminator = cursor;
+        while (terminator < end && *terminator != '\0') terminator++;
+        if (terminator == end) return 1;
+
+        napi_value item = 0;
+        if (create_string(env, cursor, (size_t)(terminator - cursor), &item) != 0 ||
+            set_element(env, *result, index, item) != 0) {
+            return 1;
+        }
+        cursor = terminator + 1;
+    }
+    return 0;
+}
+
 static void PI_NAPI_CALL complete_clipboard_work(napi_env env, int status, void* data) {
     clipboard_job* job = data;
     napi_create_string_utf8_fn create_string = (napi_create_string_utf8_fn)node_symbol("napi_create_string_utf8");
@@ -71,6 +107,8 @@ static void PI_NAPI_CALL complete_clipboard_work(napi_env env, int status, void*
     if (!job->error && job->operation != CLIPBOARD_WRITE) {
         if (job->format == CLIPBOARD_EMPTY) {
             result = null_value(env);
+        } else if (job->format == CLIPBOARD_PATHS) {
+            status = create_clipboard_paths_value(env, job, create_string, &result);
         } else if (job->format == CLIPBOARD_BUFFER) {
             napi_create_buffer_copy_fn create_buffer = (napi_create_buffer_copy_fn)node_symbol("napi_create_buffer_copy");
             status = create_buffer(env, job->length, job->data, 0, &result);

package/native/darwin/README.md

@@ -1,6 +1,6 @@
 # Darwin native prebuilds
 
-Provides modifier-key state and asynchronous text/image clipboard access using AppKit.
+Provides modifier-key state and asynchronous text, image, and file-path clipboard access using AppKit.
 
 ## Building
 

package/native/darwin/src/darwin-platform.m

@@ -66,6 +66,40 @@ static void clipboard_execute(clipboard_job* job) {
             } else {
                 clipboard_copy(job, text.UTF8String, [text lengthOfBytesUsingEncoding:NSUTF8StringEncoding], CLIPBOARD_UTF8);
             }
+        } else if (job->operation == CLIPBOARD_FILES) {
+            NSArray* urls = [pasteboard readObjectsForClasses:@[[NSURL class]]
+                options:@{NSPasteboardURLReadingFileURLsOnlyKey: @YES}];
+            size_t total = 0;
+            for (NSURL* url in urls) {
+                const char* path = url.fileSystemRepresentation;
+                if (!path) continue;
+                size_t length = strlen(path);
+                if (length == SIZE_MAX || total > SIZE_MAX - length - 1) {
+                    job->error = "Clipboard file paths are too large";
+                    return;
+                }
+                total += length + 1;
+            }
+            if (total == 0) {
+                job->format = CLIPBOARD_EMPTY;
+                return;
+            }
+            char* paths = clipboard_alloc(total);
+            if (!paths) {
+                job->error = "Out of memory";
+                return;
+            }
+            char* cursor = paths;
+            for (NSURL* url in urls) {
+                const char* path = url.fileSystemRepresentation;
+                if (!path) continue;
+                size_t length = strlen(path);
+                memcpy(cursor, path, length + 1);
+                cursor += length + 1;
+            }
+            job->data = paths;
+            job->length = total;
+            job->format = CLIPBOARD_PATHS;
         } else {
             if (![pasteboard availableTypeFromArray:@[ NSPasteboardTypePNG, NSPasteboardTypeTIFF ]]) {
                 job->format = CLIPBOARD_EMPTY;
@@ -84,10 +118,15 @@ static void clipboard_execute(clipboard_job* job) {
     }
 }
 
+static napi_value PI_NAPI_CALL get_clipboard_file_paths(napi_env env, napi_callback_info info) {
+    return queue_clipboard(env, info, CLIPBOARD_FILES);
+}
+
 PI_NAPI_EXPORT napi_value napi_register_module_v1(napi_env env, napi_value exports) {
     set_function_export(env, exports, "isModifierPressed", is_modifier_pressed);
     set_function_export(env, exports, "getText", get_clipboard_text);
     set_function_export(env, exports, "setText", set_clipboard_text);
     set_function_export(env, exports, "getImage", get_clipboard_image);
+    set_function_export(env, exports, "getFilePaths", get_clipboard_file_paths);
     return exports;
 }

package/native/napi.h

@@ -26,6 +26,7 @@ typedef void* napi_deferred;
 typedef void (PI_NAPI_CALL *napi_async_execute_callback)(napi_env, void*);
 typedef void (PI_NAPI_CALL *napi_async_complete_callback)(napi_env, int, void*);
 typedef int (PI_NAPI_CALL *napi_create_async_work_fn)(napi_env, napi_value, napi_value, napi_async_execute_callback, napi_async_complete_callback, void*, napi_async_work*);
+typedef int (PI_NAPI_CALL *napi_create_array_fn)(napi_env, napi_value*);
 typedef int (PI_NAPI_CALL *napi_async_work_fn)(napi_env, napi_async_work);
 typedef int (PI_NAPI_CALL *napi_create_promise_fn)(napi_env, napi_deferred*, napi_value*);
 typedef int (PI_NAPI_CALL *napi_settle_deferred_fn)(napi_env, napi_deferred, napi_value);
@@ -41,6 +42,7 @@ typedef int (PI_NAPI_CALL *napi_get_value_fn)(napi_env, napi_value*);
 typedef int (PI_NAPI_CALL *napi_get_value_string_utf8_fn)(napi_env, napi_value, char*, size_t, size_t*);
 typedef int (PI_NAPI_CALL *napi_get_value_string_utf16_fn)(napi_env, napi_value, uint16_t*, size_t, size_t*);
 typedef int (PI_NAPI_CALL *napi_set_named_property_fn)(napi_env, napi_value, const char*, napi_value);
+typedef int (PI_NAPI_CALL *napi_set_element_fn)(napi_env, napi_value, uint32_t, napi_value);
 typedef int (PI_NAPI_CALL *napi_throw_error_fn)(napi_env, const char*, const char*);
 
 static void* node_symbol(const char* name) {

package/package.json

@@ -1,12 +1,12 @@
 {
 	"name": "@earendil-works/pi-tui",
-	"version": "0.87.1",
+	"version": "0.99.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
 	"main": "dist/index.js",
 	"scripts": {
 		"clean": "shx rm -rf dist",
-		"build": "tsgo -p tsconfig.build.json",
+		"build": "tsc -p tsconfig.build.json",
 		"build:native:darwin": "native/darwin/build.sh",
 		"build:native:linux": "native/linux/build.sh",
 		"build:native:win32": "node native/win32/build.mjs",