@develemit/web-hooks 0.3.1 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,616 @@
1
+ "use client";
2
+
3
+ // src/terminal-output/ansi-sgr.ts
4
+ var FLAG_ON = {
5
+ 1: "bold",
6
+ 2: "dim",
7
+ 3: "italic",
8
+ 4: "underline",
9
+ 7: "inverse"
10
+ };
11
+ var FLAG_OFF = {
12
+ 22: ["bold", "dim"],
13
+ 23: ["italic"],
14
+ 24: ["underline"],
15
+ 27: ["inverse"]
16
+ };
17
+ function byte(n) {
18
+ return Math.max(0, Math.min(255, n));
19
+ }
20
+ function extendedColor(args) {
21
+ if (args[0] === 5 && args.length >= 2) return { kind: "ansi", index: byte(args[1] ?? 0) };
22
+ if (args[0] === 2 && args.length >= 4) {
23
+ const [r = 0, g = 0, b = 0] = args.slice(-3);
24
+ return { kind: "rgb", r: byte(r), g: byte(g), b: byte(b) };
25
+ }
26
+ return null;
27
+ }
28
+ function setKey(style, key, value) {
29
+ if (value === void 0 || value === false) delete style[key];
30
+ else style[key] = value;
31
+ }
32
+ function applySgr(style, params) {
33
+ const next = { ...style };
34
+ const tokens = params === "" ? ["0"] : params.split(";");
35
+ for (let i = 0; i < tokens.length; i++) {
36
+ const parts = (tokens[i] ?? "").split(":").map((p) => p === "" ? 0 : Number(p));
37
+ const code = parts[0] ?? 0;
38
+ if (Number.isNaN(code)) continue;
39
+ if (code === 38 || code === 48) {
40
+ const key = code === 38 ? "fg" : "bg";
41
+ let args = parts.slice(1);
42
+ if (parts.length === 1) {
43
+ args = tokens.slice(i + 1, i + 5).map(Number);
44
+ const used = args[0] === 5 ? 2 : args[0] === 2 ? 4 : 0;
45
+ i += used;
46
+ args = args.slice(0, used);
47
+ }
48
+ const color = extendedColor(args);
49
+ if (color) setKey(next, key, color);
50
+ continue;
51
+ }
52
+ if (code === 0) {
53
+ for (const k of Object.keys(next)) delete next[k];
54
+ } else if (FLAG_ON[code]) setKey(next, FLAG_ON[code], true);
55
+ else if (FLAG_OFF[code]) (FLAG_OFF[code] ?? []).forEach((k) => setKey(next, k, void 0));
56
+ else if (code >= 30 && code <= 37) setKey(next, "fg", { kind: "ansi", index: code - 30 });
57
+ else if (code === 39) setKey(next, "fg", void 0);
58
+ else if (code >= 40 && code <= 47) setKey(next, "bg", { kind: "ansi", index: code - 40 });
59
+ else if (code === 49) setKey(next, "bg", void 0);
60
+ else if (code >= 90 && code <= 97) setKey(next, "fg", { kind: "ansi", index: code - 90 + 8 });
61
+ else if (code >= 100 && code <= 107) setKey(next, "bg", { kind: "ansi", index: code - 100 + 8 });
62
+ }
63
+ return next;
64
+ }
65
+ function colorEquals(a, b) {
66
+ if (a === b) return true;
67
+ if (!a || !b || a.kind !== b.kind) return false;
68
+ if (a.kind === "ansi") return a.index === b.index;
69
+ const o = b;
70
+ return a.r === o.r && a.g === o.g && a.b === o.b;
71
+ }
72
+ function styleEquals(a, b) {
73
+ return a === b || colorEquals(a.fg, b.fg) && colorEquals(a.bg, b.bg) && !!a.bold === !!b.bold && !!a.dim === !!b.dim && !!a.italic === !!b.italic && !!a.underline === !!b.underline && !!a.inverse === !!b.inverse;
74
+ }
75
+
76
+ // src/terminal-output/ansi-screen.ts
77
+ var BLANK = {};
78
+ var newRow = () => ({ cells: [], shared: false });
79
+ var Screen = class _Screen {
80
+ rows = [newRow()];
81
+ row = 0;
82
+ col = 0;
83
+ line() {
84
+ const row = this.rows[this.row] ??= newRow();
85
+ if (row.shared) {
86
+ row.cells = row.cells.slice();
87
+ row.shared = false;
88
+ }
89
+ row.segments = void 0;
90
+ return row.cells;
91
+ }
92
+ write(ch, style, href) {
93
+ const line = this.line();
94
+ while (line.length < this.col) line.push({ ch: " ", style: BLANK });
95
+ line[this.col] = { ch, style, href };
96
+ this.col++;
97
+ }
98
+ newline() {
99
+ this.moveRow(this.row + 1);
100
+ this.col = 0;
101
+ }
102
+ carriageReturn() {
103
+ this.col = 0;
104
+ }
105
+ backspace() {
106
+ this.col = Math.max(0, this.col - 1);
107
+ }
108
+ moveRow(row) {
109
+ this.row = Math.max(0, row);
110
+ while (this.rows.length <= this.row) this.rows.push(newRow());
111
+ }
112
+ moveRowBy(delta) {
113
+ this.moveRow(this.row + delta);
114
+ }
115
+ setColumn(col) {
116
+ this.col = Math.max(0, col);
117
+ }
118
+ /** `ESC[nK`: 0 cursor to end, 1 start to cursor, 2 whole line. */
119
+ eraseLine(mode) {
120
+ const line = this.line();
121
+ if (mode === 2) this.rows[this.row] = newRow();
122
+ else if (mode === 1) {
123
+ for (let i = 0; i < Math.min(this.col + 1, line.length); i++) line[i] = { ch: " ", style: BLANK };
124
+ } else if (this.col < line.length) line.length = this.col;
125
+ }
126
+ /** `ESC[0J`: erase from the cursor to the end of the screen. */
127
+ eraseBelow() {
128
+ this.eraseLine(0);
129
+ this.rows.length = this.row + 1;
130
+ }
131
+ lines() {
132
+ return this.rows.map((row) => row.segments ??= toSegments(row.cells));
133
+ }
134
+ get rowCount() {
135
+ return this.rows.length;
136
+ }
137
+ get cursorRow() {
138
+ return this.row;
139
+ }
140
+ /** Forgets the first `count` rows (never the cursor's row) and returns how many went. */
141
+ dropTop(count) {
142
+ const n = Math.max(0, Math.min(count, this.row));
143
+ this.rows.splice(0, n);
144
+ this.row -= n;
145
+ return n;
146
+ }
147
+ /** An independent copy, so a partial line can be rendered without committing it. */
148
+ clone() {
149
+ const copy = new _Screen();
150
+ for (const row of this.rows) row.shared = true;
151
+ copy.rows = this.rows.map((r) => ({ ...r }));
152
+ copy.row = this.row;
153
+ copy.col = this.col;
154
+ return copy;
155
+ }
156
+ };
157
+ function toSegments(cells) {
158
+ const out = [];
159
+ let current = null;
160
+ let currentStyle = null;
161
+ for (const cell of cells) {
162
+ if (current && currentStyle && current.href === cell.href && styleEquals(currentStyle, cell.style)) {
163
+ current.text += cell.ch;
164
+ continue;
165
+ }
166
+ current = { text: cell.ch, ...cell.style };
167
+ if (cell.href) current.href = cell.href;
168
+ currentStyle = cell.style;
169
+ out.push(current);
170
+ }
171
+ return out;
172
+ }
173
+
174
+ // src/terminal-output/ansi.ts
175
+ var ESCAPE_SOURCE = "\\x1b(?:\\[([0-?]*)([ -/]*)([@-~])|\\]([^\\x07\\x1b]*)(?:\\x07|\\x1b\\\\)|[ -/]+[0-~]|[0-~])";
176
+ var DEFAULT_SCHEMES = ["http", "https", "file"];
177
+ function stripAnsi(text) {
178
+ return text.replace(new RegExp(ESCAPE_SOURCE, "g"), "");
179
+ }
180
+ function allowedHref(uri, schemes) {
181
+ const match = /^([a-z][a-z0-9+.-]*):/i.exec(uri);
182
+ return match && schemes.includes((match[1] ?? "").toLowerCase()) ? uri : void 0;
183
+ }
184
+ function writeText(screen, state, text) {
185
+ for (const ch of text) {
186
+ if (ch === "\n") screen.newline();
187
+ else if (ch === "\r") screen.carriageReturn();
188
+ else if (ch === "\b") screen.backspace();
189
+ else if (ch === " " || ch >= " " && ch !== "\x7F") screen.write(ch, state.style, state.href);
190
+ }
191
+ }
192
+ function applyCsi(screen, state, params, inter, final) {
193
+ if (inter !== "") return;
194
+ if (final === "m") {
195
+ if (/^[0-9;:]*$/.test(params)) state.style = applySgr(state.style, params);
196
+ return;
197
+ }
198
+ if (!/^[0-9;]*$/.test(params)) return;
199
+ const n = params === "" ? NaN : Number(params.split(";")[0]);
200
+ const count = Number.isNaN(n) || n === 0 ? 1 : n;
201
+ const mode = Number.isNaN(n) ? 0 : n;
202
+ if (final === "A") screen.moveRowBy(-count);
203
+ else if (final === "B") screen.moveRowBy(count);
204
+ else if (final === "G") screen.setColumn(count - 1);
205
+ else if (final === "K") screen.eraseLine(mode);
206
+ else if (final === "J" && mode === 0) screen.eraseBelow();
207
+ }
208
+ function applyOsc(state, payload, schemes) {
209
+ if (!payload.startsWith("8;")) return;
210
+ const split = payload.indexOf(";", 2);
211
+ state.href = split === -1 ? void 0 : allowedHref(payload.slice(split + 1), schemes);
212
+ }
213
+ function feedAnsi(screen, state, text, options) {
214
+ const schemes = options.linkSchemes ?? DEFAULT_SCHEMES;
215
+ const re = new RegExp(ESCAPE_SOURCE, "g");
216
+ let last = 0;
217
+ for (let m = re.exec(text); m; m = re.exec(text)) {
218
+ writeText(screen, state, text.slice(last, m.index));
219
+ last = m.index + m[0].length;
220
+ if (m[3] !== void 0) applyCsi(screen, state, m[1] ?? "", m[2] ?? "", m[3]);
221
+ else if (m[4] !== void 0) applyOsc(state, m[4], schemes);
222
+ }
223
+ writeText(screen, state, text.slice(last));
224
+ }
225
+ function run(text, state, options) {
226
+ const screen = new Screen();
227
+ feedAnsi(screen, state, text, options);
228
+ return screen.lines();
229
+ }
230
+ function parseAnsi(text, options = {}) {
231
+ return run(text, { style: {} }, options);
232
+ }
233
+ function createAnsiParser(options = {}) {
234
+ const state = { style: {} };
235
+ return {
236
+ parse: (chunk) => run(chunk, state, options),
237
+ reset: () => {
238
+ state.style = {};
239
+ state.href = void 0;
240
+ }
241
+ };
242
+ }
243
+
244
+ // src/terminal-output/line-split.ts
245
+ var INCOMPLETE_ESCAPE = /\x1b(?:\[[0-?]*[ -/]*|\][^\x07\x1b]*\x1b?|[ -/]*)$/;
246
+ function splitIncompleteEscape(text) {
247
+ const match = INCOMPLETE_ESCAPE.exec(text);
248
+ if (!match) return { complete: text, held: "" };
249
+ return { complete: text.slice(0, match.index), held: match[0] };
250
+ }
251
+ function splitLines(text) {
252
+ const pieces = text.split("\n");
253
+ const rest = pieces.pop() ?? "";
254
+ const lines = pieces.map((line) => line.endsWith("\r") ? line.slice(0, -1) : line);
255
+ return { lines, rest };
256
+ }
257
+
258
+ // src/terminal-output/line-buffer.ts
259
+ function createLineBuffer({ maxLines }) {
260
+ let decoder = new TextDecoder("utf-8");
261
+ let lines = [];
262
+ let pending = "";
263
+ let cursor;
264
+ let dropped = 0;
265
+ function keep(added) {
266
+ lines.push(...added);
267
+ const over = Math.max(0, lines.length - maxLines);
268
+ if (over > 0) lines.splice(0, over);
269
+ dropped += over;
270
+ return over;
271
+ }
272
+ function update(added, over) {
273
+ return { lines: added, partial: splitIncompleteEscape(pending).complete, dropped: over };
274
+ }
275
+ return {
276
+ push(chunk, options) {
277
+ const text = typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true });
278
+ if (options?.cursor !== void 0) cursor = options.cursor;
279
+ const { lines: added, rest } = splitLines(pending + text);
280
+ pending = rest;
281
+ return update(added, keep(added));
282
+ },
283
+ flush() {
284
+ const tail = pending + decoder.decode();
285
+ pending = "";
286
+ const added = tail === "" ? [] : [tail];
287
+ return update(added, keep(added));
288
+ },
289
+ reset() {
290
+ decoder = new TextDecoder("utf-8");
291
+ lines = [];
292
+ pending = "";
293
+ cursor = void 0;
294
+ dropped = 0;
295
+ },
296
+ get lines() {
297
+ return lines;
298
+ },
299
+ get partial() {
300
+ return splitIncompleteEscape(pending).complete;
301
+ },
302
+ get cursor() {
303
+ return cursor;
304
+ },
305
+ get dropped() {
306
+ return dropped;
307
+ }
308
+ };
309
+ }
310
+
311
+ // src/terminal-output/ansi-stream.ts
312
+ var DEFAULT_TAIL = 50;
313
+ var CURSOR_UP = /\x1b\[(\d*)A/g;
314
+ function largestCursorUp(text) {
315
+ let largest = 0;
316
+ for (const m of text.matchAll(CURSOR_UP)) largest = Math.max(largest, Number(m[1] || 1));
317
+ return largest;
318
+ }
319
+ function sameLine(a, b) {
320
+ return a !== void 0 && (a === b || JSON.stringify(a) === JSON.stringify(b));
321
+ }
322
+ function createAnsiStream(options = {}) {
323
+ let tail = options.tailLines ?? DEFAULT_TAIL;
324
+ let screen = new Screen();
325
+ let state = { style: {} };
326
+ let frozen = 0;
327
+ let shown = [];
328
+ let lastPartial = "";
329
+ let finished = false;
330
+ function render(partial) {
331
+ tail = Math.max(tail, largestCursorUp(partial));
332
+ screen.lines();
333
+ const draft = screen.clone();
334
+ feedAnsi(draft, { ...state }, partial, options);
335
+ const rows = draft.lines();
336
+ const first = rows.findIndex((row, i) => !sameLine(shown[i], row));
337
+ const from = first === -1 ? rows.length < shown.length ? rows.length : -1 : first;
338
+ shown = rows;
339
+ const update = from === -1 ? {} : { replaced: { from: frozen + from, lines: rows.slice(from) } };
340
+ const freeze = screen.cursorRow - tail;
341
+ if (freeze > 0) {
342
+ const dropped = screen.dropTop(freeze);
343
+ shown = shown.slice(dropped);
344
+ frozen += dropped;
345
+ }
346
+ return update;
347
+ }
348
+ return {
349
+ push(lines, partial = "") {
350
+ if (finished) return {};
351
+ for (const line of lines) {
352
+ tail = Math.max(tail, largestCursorUp(line));
353
+ feedAnsi(screen, state, `${line}
354
+ `, options);
355
+ }
356
+ lastPartial = partial;
357
+ return render(partial);
358
+ },
359
+ finish(partial = lastPartial) {
360
+ if (finished) return {};
361
+ const update = render(partial);
362
+ finished = true;
363
+ return update;
364
+ },
365
+ reset() {
366
+ finished = false;
367
+ lastPartial = "";
368
+ screen = new Screen();
369
+ state = { style: {} };
370
+ frozen = 0;
371
+ shown = [];
372
+ tail = options.tailLines ?? DEFAULT_TAIL;
373
+ }
374
+ };
375
+ }
376
+
377
+ // src/terminal-output/log-helpers.ts
378
+ var escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
379
+ function queryMatcher(query) {
380
+ const q = query.trim();
381
+ return q ? new RegExp(escapeRegExp(q), "giu") : null;
382
+ }
383
+ function filterLines(lines, query) {
384
+ const matcher = queryMatcher(query);
385
+ const indexes = [];
386
+ lines.forEach((line, i) => {
387
+ if (!matcher) indexes.push(i);
388
+ else {
389
+ matcher.lastIndex = 0;
390
+ if (matcher.test(line)) indexes.push(i);
391
+ }
392
+ });
393
+ return indexes;
394
+ }
395
+ function splitByMatch(line, query) {
396
+ const matcher = queryMatcher(query);
397
+ if (!matcher) return [{ text: line, match: false }];
398
+ const segments = [];
399
+ let last = 0;
400
+ for (const m of line.matchAll(matcher)) {
401
+ const start = m.index ?? 0;
402
+ if (start > last) segments.push({ text: line.slice(last, start), match: false });
403
+ segments.push({ text: m[0], match: true });
404
+ last = start + m[0].length;
405
+ }
406
+ if (last < line.length || segments.length === 0) {
407
+ segments.push({ text: line.slice(last), match: false });
408
+ }
409
+ return segments;
410
+ }
411
+ var FAILURE_PATTERNS = [
412
+ { tool: "tsc", kind: "error", pattern: /\berror TS\d+/ },
413
+ { tool: "pnpm", kind: "error", pattern: /\bERR_PNPM_[A-Z_]+/ },
414
+ { tool: "npm", kind: "error", pattern: /\bnpm (?:ERR!|error\b)/ },
415
+ { tool: "nx", kind: "failed tasks", pattern: /targets failed, including|Failed tasks/ },
416
+ { tool: "nx", kind: "task failed", pattern: /^\s*✖\s+nx run / },
417
+ { tool: "nx", kind: "failed", pattern: /^\s*✖\s+\d+\/\d+ failed/ },
418
+ { tool: "vitest", kind: "fail", pattern: /^\s*FAIL\s/ },
419
+ { tool: "vitest", kind: "test", pattern: /^\s*[×✗]\s/ },
420
+ { tool: "docker", kind: "error", pattern: /^\s*(?:Error response from daemon|ERROR: failed to solve|failed to solve|pull access denied)/ },
421
+ { tool: "docker", kind: "exit", pattern: /^\s*Container \S+\s+(?:Error|exited with code [1-9]\d*)/ },
422
+ { tool: "generic", kind: "error", pattern: /\b\w*Error\b(?: \[\w+\])?:/ }
423
+ ];
424
+ var STACK_FRAME = /^\s*at\s/;
425
+ function findFailures(lines, patterns = FAILURE_PATTERNS) {
426
+ const failures = [];
427
+ lines.forEach((line, index) => {
428
+ if (STACK_FRAME.test(line)) return;
429
+ const hit = patterns.find((p) => p.pattern.test(line));
430
+ if (hit) failures.push({ index, tool: hit.tool, kind: hit.kind });
431
+ });
432
+ return failures;
433
+ }
434
+ function firstFailureIndex(lines, patterns = FAILURE_PATTERNS) {
435
+ return findFailures(lines, patterns)[0]?.index ?? -1;
436
+ }
437
+ var NOISE_PATTERNS = [
438
+ /^\s*[0-9a-f]{12}: (?:Pulling fs layer|Waiting|Downloading|Download complete|Verifying Checksum|Extracting|Pull complete|Already exists)/,
439
+ /^\s*[0-9a-f]{12} (?:Pulling fs layer|Waiting|Downloading|Download complete|Verifying|Extracting|Pull complete|Already exists)/,
440
+ /^\s*Image \S+\s+(?:Pulling|Pulled)\s*$/,
441
+ /^\s*Container \S+\s+(?:Creating|Created|Starting|Started|Running|Waiting|Healthy|Stopping|Stopped|Removing|Removed)\s*$/,
442
+ /^\s*Nx read the output from the cache/
443
+ ];
444
+ function isNoise(line, patterns = NOISE_PATTERNS) {
445
+ return patterns.some((p) => p.test(line));
446
+ }
447
+ function tailMeaningful(lines, n, patterns = NOISE_PATTERNS) {
448
+ const out = [];
449
+ for (let i = lines.length - 1; i >= 0 && out.length < n; i--) {
450
+ const line = (lines[i] ?? "").trimEnd();
451
+ if (line.trim() && !isNoise(line, patterns)) out.unshift(line);
452
+ }
453
+ return out;
454
+ }
455
+
456
+ // src/terminal-output/follow-tail.ts
457
+ var DEFAULT_TAIL_THRESHOLD = 24;
458
+ function distanceFromEnd({ scrollTop, scrollHeight, clientHeight }) {
459
+ return scrollHeight - scrollTop - clientHeight;
460
+ }
461
+ function isNearEnd(metrics, threshold = DEFAULT_TAIL_THRESHOLD) {
462
+ return distanceFromEnd(metrics) <= threshold;
463
+ }
464
+ function shouldStick(prevAtBottom, metrics, userInitiated, threshold = DEFAULT_TAIL_THRESHOLD) {
465
+ if (!userInitiated) return prevAtBottom;
466
+ return isNearEnd(metrics, threshold);
467
+ }
468
+ function isUserScrollUp({ kind, delta = 0, lastTarget, scrollTop }, threshold = DEFAULT_TAIL_THRESHOLD) {
469
+ if (kind === "wheel") return delta < 0;
470
+ if (kind === "touch") return delta > 0;
471
+ if (kind === "gutter") return true;
472
+ return lastTarget !== null && scrollTop < lastTarget - threshold;
473
+ }
474
+ function unreadDelta(prevCount, nextCount, attached) {
475
+ if (attached) return 0;
476
+ return Math.max(0, nextCount - prevCount);
477
+ }
478
+
479
+ // src/terminal-output/use-follow-tail.ts
480
+ import { useCallback, useEffect, useLayoutEffect, useRef, useState } from "react";
481
+ var useIsomorphicLayoutEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
482
+ function useFollowTail({
483
+ scrollRef,
484
+ itemCount,
485
+ scrollToEnd,
486
+ resetKey,
487
+ threshold = DEFAULT_TAIL_THRESHOLD
488
+ }) {
489
+ const [atBottom, setAtBottom] = useState(true);
490
+ const [unread, setUnread] = useState(0);
491
+ const attached = useRef(true);
492
+ const programmatic = useRef(false);
493
+ const lastTarget = useRef(null);
494
+ const lastTop = useRef(0);
495
+ const frame = useRef(0);
496
+ const prevCount = useRef(itemCount);
497
+ const prevReset = useRef(resetKey);
498
+ const latest = useRef({ scrollToEnd, threshold });
499
+ latest.current = { scrollToEnd, threshold };
500
+ const attach = useCallback((value) => {
501
+ attached.current = value;
502
+ setAtBottom(value);
503
+ if (value) setUnread(0);
504
+ }, []);
505
+ const followEnd = useCallback(() => {
506
+ const el = scrollRef.current;
507
+ if (!el) return;
508
+ programmatic.current = true;
509
+ if (latest.current.scrollToEnd) latest.current.scrollToEnd();
510
+ else el.scrollTop = el.scrollHeight;
511
+ lastTarget.current = el.scrollHeight - el.clientHeight;
512
+ if (typeof requestAnimationFrame === "function") {
513
+ cancelAnimationFrame(frame.current);
514
+ frame.current = requestAnimationFrame(() => {
515
+ programmatic.current = false;
516
+ });
517
+ } else {
518
+ programmatic.current = false;
519
+ }
520
+ }, [scrollRef]);
521
+ useIsomorphicLayoutEffect(() => {
522
+ const count = prevCount.current;
523
+ prevCount.current = itemCount;
524
+ if (prevReset.current !== resetKey) {
525
+ prevReset.current = resetKey;
526
+ attach(true);
527
+ followEnd();
528
+ return;
529
+ }
530
+ if (attached.current) {
531
+ if (itemCount > 0) followEnd();
532
+ return;
533
+ }
534
+ const added = unreadDelta(count, itemCount, false);
535
+ if (added > 0) setUnread((n) => n + added);
536
+ }, [itemCount, resetKey, attach, followEnd]);
537
+ useEffect(() => {
538
+ const el = scrollRef.current;
539
+ if (!el) return;
540
+ const takeOver = () => {
541
+ programmatic.current = false;
542
+ lastTarget.current = null;
543
+ if (attached.current) attach(false);
544
+ };
545
+ const onScroll = () => {
546
+ const { threshold: limit } = latest.current;
547
+ const movedUp = el.scrollTop < lastTop.current;
548
+ lastTop.current = el.scrollTop;
549
+ const info = { kind: "scroll", lastTarget: movedUp ? lastTarget.current : null, scrollTop: el.scrollTop };
550
+ const user = isUserScrollUp(info, limit);
551
+ if (user) takeOver();
552
+ const next = shouldStick(attached.current, el, user || !programmatic.current, limit);
553
+ if (next !== attached.current) attach(next);
554
+ };
555
+ const canScrollUp = () => el.scrollHeight > el.clientHeight && el.scrollTop > 0;
556
+ const onWheel = (e) => {
557
+ if (canScrollUp() && isUserScrollUp({ kind: "wheel", delta: e.deltaY, lastTarget: null, scrollTop: el.scrollTop })) takeOver();
558
+ };
559
+ let touchY = 0;
560
+ const onTouchStart = (e) => {
561
+ touchY = e.touches[0]?.clientY ?? 0;
562
+ };
563
+ const onTouchMove = (e) => {
564
+ const delta = (e.touches[0]?.clientY ?? touchY) - touchY;
565
+ if (canScrollUp() && isUserScrollUp({ kind: "touch", delta, lastTarget: null, scrollTop: el.scrollTop })) takeOver();
566
+ };
567
+ const onPointerDown = (e) => {
568
+ const gutter = el.offsetWidth - el.clientWidth;
569
+ if (e.target !== el || gutter <= 0) return;
570
+ if (e.clientX >= el.getBoundingClientRect().left + el.clientWidth) {
571
+ if (isUserScrollUp({ kind: "gutter", lastTarget: null, scrollTop: el.scrollTop })) takeOver();
572
+ }
573
+ };
574
+ el.addEventListener("scroll", onScroll, { passive: true });
575
+ el.addEventListener("wheel", onWheel, { passive: true });
576
+ el.addEventListener("touchstart", onTouchStart, { passive: true });
577
+ el.addEventListener("touchmove", onTouchMove, { passive: true });
578
+ el.addEventListener("pointerdown", onPointerDown, { passive: true });
579
+ return () => {
580
+ el.removeEventListener("scroll", onScroll);
581
+ el.removeEventListener("wheel", onWheel);
582
+ el.removeEventListener("touchstart", onTouchStart);
583
+ el.removeEventListener("touchmove", onTouchMove);
584
+ el.removeEventListener("pointerdown", onPointerDown);
585
+ if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(frame.current);
586
+ };
587
+ }, [scrollRef, attach]);
588
+ const jumpToBottom = useCallback(() => {
589
+ attach(true);
590
+ followEnd();
591
+ }, [attach, followEnd]);
592
+ return { atBottom, unread, jumpToBottom };
593
+ }
594
+
595
+ export {
596
+ stripAnsi,
597
+ parseAnsi,
598
+ createAnsiParser,
599
+ createLineBuffer,
600
+ createAnsiStream,
601
+ filterLines,
602
+ splitByMatch,
603
+ FAILURE_PATTERNS,
604
+ findFailures,
605
+ firstFailureIndex,
606
+ NOISE_PATTERNS,
607
+ isNoise,
608
+ tailMeaningful,
609
+ DEFAULT_TAIL_THRESHOLD,
610
+ distanceFromEnd,
611
+ isNearEnd,
612
+ shouldStick,
613
+ isUserScrollUp,
614
+ unreadDelta,
615
+ useFollowTail
616
+ };