@develemit/web-hooks 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.0 - 2026-11-06
+
+- **New optional peer dependency:** `@tanstack/react-virtual` (`^3.13.0`), needed only by apps that import `@develemit/web-hooks/virtual-list`. Every other entry, including the root, works without it.
+- `virtual-list`: `useVirtualLog({ lines, scrollRef, query, estimateSize, overscan, resetKey, filename })` combines `useVirtualList` with `useFollowTail`, a deferred `filterLines` search, incremental `findFailures` with `jumpToFailure` / `nextFailure` / `previousFailure` by index, and `copyText` / `download` over the whole log. Also exports `logToText` and `downloadText`. Budgets measured in WebKit on a 20,765-line, 1.4 MB log: first render about 20 ms with 40 rows in the page, filter keystrokes under 50 ms, about 3 ms of render per batch of appended lines.
+- `virtual-list`: new subpath with `useVirtualList({ count, estimateSize, scrollRef | windowScroll, scrollMargin, overscan = 10, measure = true, getItemKey, initialCount = 30 })` returning `{ items, totalSize, measureRef, scrollToIndex, scrollToOffset, virtualizer }`, plus the pure `measuredOrEstimate`, `shouldRealign`, `targetOffset` and `initialVisibleCount`. Rows are measured by default (a 0 reading falls back to the estimate), it can scroll an element or the window, `scrollToIndex` re-aligns for up to 3 frames after measuring so it lands on unrendered rows, and the server render includes the first rows. `@tanstack/react-virtual` (`^3.13.0`) is an **optional** peer dependency used only by this subpath; the root index does not re-export it.
+
 ## 0.4.0 - 2026-11-06
 
 - `terminal-output`: `useFollowTail` detaches on a user scroll up even when output streams every frame. It now detects intent (wheel up, a finger dragging down, a press on the scrollbar gutter, or a scroll event above where the hook last scrolled to) instead of ignoring scroll events in the frame after its own scroll. New pure `isUserScrollUp`.

package/README.md

@@ -25,6 +25,7 @@ that every app ends up hand-copying from the last one.
 | `@develemit/web-hooks/keyboard-inset` | On-screen keyboard height, without the phantom gap in standalone iPhone PWAs |
 | `@develemit/web-hooks/push` | Web push subscription, with iOS install detection and silent re-subscribe |
 | `@develemit/web-hooks/terminal-output` | Strip and parse ANSI, buffer streamed lines, search logs and find failures, and follow the tail of a scrolling log |
+| `@develemit/web-hooks/virtual-list` | Virtualize long lists on `@tanstack/react-virtual` with phone-safe defaults (optional peer) |
 
 Behavior only. No styling and no components: each app keeps its own look.
 
@@ -457,3 +458,65 @@ const COLORS = ['text-black', 'text-red', 'text-green', 'text-yellow', 'text-blu
   </div>
 ))}
 ```
+
+### virtual-list
+
+`@develemit/web-hooks/virtual-list` wraps `@tanstack/react-virtual` (v3.13+). Install it yourself (`pnpm add @tanstack/react-virtual`); it is an **optional** peer, needed only by apps that import this subpath. The root `@develemit/web-hooks` import does not re-export it, so root imports never need the peer.
+
+`useVirtualList({ count, estimateSize, scrollRef? | windowScroll: true, scrollMargin = 0, overscan = 10, measure = true, getItemKey?, initialCount = 30 })` returns `{ items, totalSize, measureRef, scrollToIndex(i, { align }), scrollToOffset, virtualizer }`; `items` are `{ index, key, start, size }`, and `virtualizer` is the raw escape hatch.
+
+- Rows are measured by default; a row that reads 0 before layout keeps its estimate, so the list never collapses. Pass `measure: false` if your own maths relies on flat estimates.
+- `windowScroll: true` scrolls with the page (use `scrollMargin` for the list's distance from the page top; item `start` is relative to the list).
+- `scrollToIndex` to a row that isn't rendered yet scrolls to the estimate, then re-aligns after measuring, for up to 3 frames.
+- The server render includes the first `initialCount` rows.
+
+```tsx
+const ref = useRef<HTMLDivElement>(null);
+const { items, totalSize, measureRef } = useVirtualList({ count: lines.length, estimateSize: () => 20, scrollRef: ref });
+
+<div ref={ref} className="h-96 overflow-auto">
+  <div style={{ height: totalSize, position: 'relative' }}>
+    {items.map((it) => (
+      <div key={it.key} data-index={it.index} ref={measureRef}
+           style={{ position: 'absolute', top: 0, left: 0, width: '100%', transform: `translateY(${it.start}px)` }}>
+        {lines[it.index]}
+      </div>
+    ))}
+  </div>
+</div>
+```
+
+Each row needs `data-index={it.index}` and `ref={measureRef}`.
+
+#### useVirtualLog
+
+`useVirtualLog({ lines, scrollRef, query = '', estimateSize = () => 18, overscan = 12, resetKey?, filename = 'log.txt' })` joins `useVirtualList` with the `terminal-output` helpers for a live, searchable log. Pass the lines as strings (strip or keep escape codes; search and failure scans run on what you pass, so give it plain text if you want to search plain text).
+
+It returns `rows` (`{ index, lineIndex, key, start, size }`, where `lineIndex` is the row's place in `lines`), `totalSize`, `measureRef`, `isFiltering`, `shownCount`, `atBottom`, `unread`, `jumpToBottom`, `failures`, `failurePosition`, `jumpToFailure(n)`, `nextFailure()`, `previousFailure()`, `text()`, `copyText()` and `download(filename?)`.
+
+- Search goes through `useDeferredValue`, so typing stays instant on 20k lines. Rows are the matches; map them back with `lines[row.lineIndex]` for highlighting with `splitByMatch`.
+- It follows the tail and stops when the user scrolls up. While a filter is on, following pauses and `unread` counts matches that arrived since the filter began.
+- `failures` is scanned once per content change, and only on appended rows. `jumpToFailure(n)` scrolls by index (so it works for rows that aren't rendered) and returns `false` if that failure is hidden by the filter.
+- `copyText()` and `download()` use the whole log with escape codes stripped, however few rows are in the page. `logToText(lines, { stripAnsi })` and `downloadText(filename, text)` are exported on their own.
+- `lines` is an array, not a stream: keep your own state (for example `createLineBuffer` + `createAnsiStream`) and pass its rows.
+
+```tsx
+const ref = useRef<HTMLDivElement>(null);
+const [query, setQuery] = useState('');
+const log = useVirtualLog({ lines, scrollRef: ref, query });
+
+<div ref={ref} className="h-96 overflow-auto">
+  <div style={{ height: log.totalSize, position: 'relative' }}>
+    {log.rows.map((row) => (
+      <div key={row.key} data-index={row.index} ref={log.measureRef}
+           style={{ position: 'absolute', top: 0, left: 0, width: '100%', transform: `translateY(${row.start}px)` }}>
+        {log.isFiltering
+          ? splitByMatch(lines[row.lineIndex] ?? '', query).map((s, j) => (s.match ? <mark key={j}>{s.text}</mark> : <span key={j}>{s.text}</span>))
+          : lines[row.lineIndex]}
+      </div>
+    ))}
+  </div>
+</div>
+{!log.atBottom && <button onClick={log.jumpToBottom}>{log.unread} new</button>}
+<button onClick={log.nextFailure}>Next failure</button>
+```

package/dist/{chunk-TE2FRIPF.js → chunk-IVLRQ23V.js}

@@ -241,139 +241,6 @@ function createAnsiParser(options = {}) {
   };
 }
 
-// src/terminal-output/line-split.ts
-var INCOMPLETE_ESCAPE = /\x1b(?:\[[0-?]*[ -/]*|\][^\x07\x1b]*\x1b?|[ -/]*)$/;
-function splitIncompleteEscape(text) {
-  const match = INCOMPLETE_ESCAPE.exec(text);
-  if (!match) return { complete: text, held: "" };
-  return { complete: text.slice(0, match.index), held: match[0] };
-}
-function splitLines(text) {
-  const pieces = text.split("\n");
-  const rest = pieces.pop() ?? "";
-  const lines = pieces.map((line) => line.endsWith("\r") ? line.slice(0, -1) : line);
-  return { lines, rest };
-}
-
-// src/terminal-output/line-buffer.ts
-function createLineBuffer({ maxLines }) {
-  let decoder = new TextDecoder("utf-8");
-  let lines = [];
-  let pending = "";
-  let cursor;
-  let dropped = 0;
-  function keep(added) {
-    lines.push(...added);
-    const over = Math.max(0, lines.length - maxLines);
-    if (over > 0) lines.splice(0, over);
-    dropped += over;
-    return over;
-  }
-  function update(added, over) {
-    return { lines: added, partial: splitIncompleteEscape(pending).complete, dropped: over };
-  }
-  return {
-    push(chunk, options) {
-      const text = typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true });
-      if (options?.cursor !== void 0) cursor = options.cursor;
-      const { lines: added, rest } = splitLines(pending + text);
-      pending = rest;
-      return update(added, keep(added));
-    },
-    flush() {
-      const tail = pending + decoder.decode();
-      pending = "";
-      const added = tail === "" ? [] : [tail];
-      return update(added, keep(added));
-    },
-    reset() {
-      decoder = new TextDecoder("utf-8");
-      lines = [];
-      pending = "";
-      cursor = void 0;
-      dropped = 0;
-    },
-    get lines() {
-      return lines;
-    },
-    get partial() {
-      return splitIncompleteEscape(pending).complete;
-    },
-    get cursor() {
-      return cursor;
-    },
-    get dropped() {
-      return dropped;
-    }
-  };
-}
-
-// src/terminal-output/ansi-stream.ts
-var DEFAULT_TAIL = 50;
-var CURSOR_UP = /\x1b\[(\d*)A/g;
-function largestCursorUp(text) {
-  let largest = 0;
-  for (const m of text.matchAll(CURSOR_UP)) largest = Math.max(largest, Number(m[1] || 1));
-  return largest;
-}
-function sameLine(a, b) {
-  return a !== void 0 && (a === b || JSON.stringify(a) === JSON.stringify(b));
-}
-function createAnsiStream(options = {}) {
-  let tail = options.tailLines ?? DEFAULT_TAIL;
-  let screen = new Screen();
-  let state = { style: {} };
-  let frozen = 0;
-  let shown = [];
-  let lastPartial = "";
-  let finished = false;
-  function render(partial) {
-    tail = Math.max(tail, largestCursorUp(partial));
-    screen.lines();
-    const draft = screen.clone();
-    feedAnsi(draft, { ...state }, partial, options);
-    const rows = draft.lines();
-    const first = rows.findIndex((row, i) => !sameLine(shown[i], row));
-    const from = first === -1 ? rows.length < shown.length ? rows.length : -1 : first;
-    shown = rows;
-    const update = from === -1 ? {} : { replaced: { from: frozen + from, lines: rows.slice(from) } };
-    const freeze = screen.cursorRow - tail;
-    if (freeze > 0) {
-      const dropped = screen.dropTop(freeze);
-      shown = shown.slice(dropped);
-      frozen += dropped;
-    }
-    return update;
-  }
-  return {
-    push(lines, partial = "") {
-      if (finished) return {};
-      for (const line of lines) {
-        tail = Math.max(tail, largestCursorUp(line));
-        feedAnsi(screen, state, `${line}
-`, options);
-      }
-      lastPartial = partial;
-      return render(partial);
-    },
-    finish(partial = lastPartial) {
-      if (finished) return {};
-      const update = render(partial);
-      finished = true;
-      return update;
-    },
-    reset() {
-      finished = false;
-      lastPartial = "";
-      screen = new Screen();
-      state = { style: {} };
-      frozen = 0;
-      shown = [];
-      tail = options.tailLines ?? DEFAULT_TAIL;
-    }
-  };
-}
-
 // src/terminal-output/log-helpers.ts
 var escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 function queryMatcher(query) {
@@ -593,11 +460,11 @@ function useFollowTail({
 }
 
 export {
+  Screen,
   stripAnsi,
+  feedAnsi,
   parseAnsi,
   createAnsiParser,
-  createLineBuffer,
-  createAnsiStream,
   filterLines,
   splitByMatch,
   FAILURE_PATTERNS,

package/dist/chunk-JTLQQSLO.js

@@ -0,0 +1,143 @@
+"use client";
+import {
+  Screen,
+  feedAnsi
+} from "./chunk-IVLRQ23V.js";
+
+// src/terminal-output/line-split.ts
+var INCOMPLETE_ESCAPE = /\x1b(?:\[[0-?]*[ -/]*|\][^\x07\x1b]*\x1b?|[ -/]*)$/;
+function splitIncompleteEscape(text) {
+  const match = INCOMPLETE_ESCAPE.exec(text);
+  if (!match) return { complete: text, held: "" };
+  return { complete: text.slice(0, match.index), held: match[0] };
+}
+function splitLines(text) {
+  const pieces = text.split("\n");
+  const rest = pieces.pop() ?? "";
+  const lines = pieces.map((line) => line.endsWith("\r") ? line.slice(0, -1) : line);
+  return { lines, rest };
+}
+
+// src/terminal-output/line-buffer.ts
+function createLineBuffer({ maxLines }) {
+  let decoder = new TextDecoder("utf-8");
+  let lines = [];
+  let pending = "";
+  let cursor;
+  let dropped = 0;
+  function keep(added) {
+    lines.push(...added);
+    const over = Math.max(0, lines.length - maxLines);
+    if (over > 0) lines.splice(0, over);
+    dropped += over;
+    return over;
+  }
+  function update(added, over) {
+    return { lines: added, partial: splitIncompleteEscape(pending).complete, dropped: over };
+  }
+  return {
+    push(chunk, options) {
+      const text = typeof chunk === "string" ? chunk : decoder.decode(chunk, { stream: true });
+      if (options?.cursor !== void 0) cursor = options.cursor;
+      const { lines: added, rest } = splitLines(pending + text);
+      pending = rest;
+      return update(added, keep(added));
+    },
+    flush() {
+      const tail = pending + decoder.decode();
+      pending = "";
+      const added = tail === "" ? [] : [tail];
+      return update(added, keep(added));
+    },
+    reset() {
+      decoder = new TextDecoder("utf-8");
+      lines = [];
+      pending = "";
+      cursor = void 0;
+      dropped = 0;
+    },
+    get lines() {
+      return lines;
+    },
+    get partial() {
+      return splitIncompleteEscape(pending).complete;
+    },
+    get cursor() {
+      return cursor;
+    },
+    get dropped() {
+      return dropped;
+    }
+  };
+}
+
+// src/terminal-output/ansi-stream.ts
+var DEFAULT_TAIL = 50;
+var CURSOR_UP = /\x1b\[(\d*)A/g;
+function largestCursorUp(text) {
+  let largest = 0;
+  for (const m of text.matchAll(CURSOR_UP)) largest = Math.max(largest, Number(m[1] || 1));
+  return largest;
+}
+function sameLine(a, b) {
+  return a !== void 0 && (a === b || JSON.stringify(a) === JSON.stringify(b));
+}
+function createAnsiStream(options = {}) {
+  let tail = options.tailLines ?? DEFAULT_TAIL;
+  let screen = new Screen();
+  let state = { style: {} };
+  let frozen = 0;
+  let shown = [];
+  let lastPartial = "";
+  let finished = false;
+  function render(partial) {
+    tail = Math.max(tail, largestCursorUp(partial));
+    screen.lines();
+    const draft = screen.clone();
+    feedAnsi(draft, { ...state }, partial, options);
+    const rows = draft.lines();
+    const first = rows.findIndex((row, i) => !sameLine(shown[i], row));
+    const from = first === -1 ? rows.length < shown.length ? rows.length : -1 : first;
+    shown = rows;
+    const update = from === -1 ? {} : { replaced: { from: frozen + from, lines: rows.slice(from) } };
+    const freeze = screen.cursorRow - tail;
+    if (freeze > 0) {
+      const dropped = screen.dropTop(freeze);
+      shown = shown.slice(dropped);
+      frozen += dropped;
+    }
+    return update;
+  }
+  return {
+    push(lines, partial = "") {
+      if (finished) return {};
+      for (const line of lines) {
+        tail = Math.max(tail, largestCursorUp(line));
+        feedAnsi(screen, state, `${line}
+`, options);
+      }
+      lastPartial = partial;
+      return render(partial);
+    },
+    finish(partial = lastPartial) {
+      if (finished) return {};
+      const update = render(partial);
+      finished = true;
+      return update;
+    },
+    reset() {
+      finished = false;
+      lastPartial = "";
+      screen = new Screen();
+      state = { style: {} };
+      frozen = 0;
+      shown = [];
+      tail = options.tailLines ?? DEFAULT_TAIL;
+    }
+  };
+}
+
+export {
+  createLineBuffer,
+  createAnsiStream
+};

package/dist/index.d.cts

@@ -17,5 +17,6 @@ export { ServiceWorkerState, UpdateStateInput, UseServiceWorkerOptions, deriveUp
 export { ShareInput, ShareResult, ShareStatus, canShareFiles, isShareCancel, shareOrCopy, shareTextFor, useShareFeedback } from './share.cjs';
 export { InsetReading, UseKeyboardInsetOptions, computeKeyboardInset, isEditableElement, useKeyboardInset } from './keyboard-inset.cjs';
 export { PushEnv, PushPermission, PushSubscriptionState, PushSupport, ResubscribeInput, UsePushSubscriptionOptions, getPushSupport, shouldResubscribe, urlBase64ToUint8Array, usePushSubscription } from './push.cjs';
-export { AnsiColor, AnsiLine, AnsiSegment, AnsiStream, AnsiStreamOptions, AnsiStreamUpdate, AnsiStyle, DEFAULT_TAIL_THRESHOLD, FAILURE_PATTERNS, Failure, FailurePattern, FailureTool, LineBuffer, LineBufferOptions, LineBufferUpdate, NOISE_PATTERNS, ParseAnsiOptions, ScrollEventInfo, ScrollEventKind, ScrollMetrics, StreamCursor, TextSegment, UseFollowTailOptions, UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, filterLines, findFailures, firstFailureIndex, isNearEnd, isNoise, isUserScrollUp, parseAnsi, shouldStick, splitByMatch, stripAnsi, tailMeaningful, unreadDelta, useFollowTail } from './terminal-output.cjs';
+export { AnsiColor, AnsiLine, AnsiSegment, AnsiStream, AnsiStreamOptions, AnsiStreamUpdate, AnsiStyle, DEFAULT_TAIL_THRESHOLD, LineBuffer, LineBufferOptions, LineBufferUpdate, ParseAnsiOptions, ScrollEventInfo, ScrollEventKind, ScrollMetrics, StreamCursor, UseFollowTailOptions, UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, isNearEnd, isUserScrollUp, parseAnsi, shouldStick, stripAnsi, unreadDelta, useFollowTail } from './terminal-output.cjs';
+export { F as FAILURE_PATTERNS, a as Failure, b as FailurePattern, c as FailureTool, N as NOISE_PATTERNS, T as TextSegment, f as filterLines, d as findFailures, e as firstFailureIndex, i as isNoise, s as splitByMatch, t as tailMeaningful } from './log-helpers-rkbgYqZW.cjs';
 import 'react';

package/dist/index.d.ts

@@ -17,5 +17,6 @@ export { ServiceWorkerState, UpdateStateInput, UseServiceWorkerOptions, deriveUp
 export { ShareInput, ShareResult, ShareStatus, canShareFiles, isShareCancel, shareOrCopy, shareTextFor, useShareFeedback } from './share.js';
 export { InsetReading, UseKeyboardInsetOptions, computeKeyboardInset, isEditableElement, useKeyboardInset } from './keyboard-inset.js';
 export { PushEnv, PushPermission, PushSubscriptionState, PushSupport, ResubscribeInput, UsePushSubscriptionOptions, getPushSupport, shouldResubscribe, urlBase64ToUint8Array, usePushSubscription } from './push.js';
-export { AnsiColor, AnsiLine, AnsiSegment, AnsiStream, AnsiStreamOptions, AnsiStreamUpdate, AnsiStyle, DEFAULT_TAIL_THRESHOLD, FAILURE_PATTERNS, Failure, FailurePattern, FailureTool, LineBuffer, LineBufferOptions, LineBufferUpdate, NOISE_PATTERNS, ParseAnsiOptions, ScrollEventInfo, ScrollEventKind, ScrollMetrics, StreamCursor, TextSegment, UseFollowTailOptions, UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, filterLines, findFailures, firstFailureIndex, isNearEnd, isNoise, isUserScrollUp, parseAnsi, shouldStick, splitByMatch, stripAnsi, tailMeaningful, unreadDelta, useFollowTail } from './terminal-output.js';
+export { AnsiColor, AnsiLine, AnsiSegment, AnsiStream, AnsiStreamOptions, AnsiStreamUpdate, AnsiStyle, DEFAULT_TAIL_THRESHOLD, LineBuffer, LineBufferOptions, LineBufferUpdate, ParseAnsiOptions, ScrollEventInfo, ScrollEventKind, ScrollMetrics, StreamCursor, UseFollowTailOptions, UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, isNearEnd, isUserScrollUp, parseAnsi, shouldStick, stripAnsi, unreadDelta, useFollowTail } from './terminal-output.js';
+export { F as FAILURE_PATTERNS, a as Failure, b as FailurePattern, c as FailureTool, N as NOISE_PATTERNS, T as TextSegment, f as filterLines, d as findFailures, e as firstFailureIndex, i as isNoise, s as splitByMatch, t as tailMeaningful } from './log-helpers-rkbgYqZW.js';
 import 'react';

package/dist/index.js

@@ -22,13 +22,15 @@ import {
   urlBase64ToUint8Array,
   usePushSubscription
 } from "./chunk-R2PFNE3U.js";
+import {
+  createAnsiStream,
+  createLineBuffer
+} from "./chunk-JTLQQSLO.js";
 import {
   DEFAULT_TAIL_THRESHOLD,
   FAILURE_PATTERNS,
   NOISE_PATTERNS,
   createAnsiParser,
-  createAnsiStream,
-  createLineBuffer,
   distanceFromEnd,
   filterLines,
   findFailures,
@@ -43,7 +45,7 @@ import {
   tailMeaningful,
   unreadDelta,
   useFollowTail
-} from "./chunk-TE2FRIPF.js";
+} from "./chunk-IVLRQ23V.js";
 import {
   nextDelay,
   useVisibilityPolling

package/dist/log-helpers-rkbgYqZW.d.cts

@@ -0,0 +1,25 @@
+interface TextSegment {
+    text: string;
+    match: boolean;
+}
+type FailureTool = 'vitest' | 'nx' | 'tsc' | 'pnpm' | 'npm' | 'docker' | 'generic';
+interface FailurePattern {
+    tool: FailureTool;
+    kind: string;
+    pattern: RegExp;
+}
+interface Failure {
+    index: number;
+    tool: FailureTool;
+    kind: string;
+}
+declare function filterLines(lines: readonly string[], query: string): number[];
+declare function splitByMatch(line: string, query: string): TextSegment[];
+declare const FAILURE_PATTERNS: readonly FailurePattern[];
+declare function findFailures(lines: readonly string[], patterns?: readonly FailurePattern[]): Failure[];
+declare function firstFailureIndex(lines: readonly string[], patterns?: readonly FailurePattern[]): number;
+declare const NOISE_PATTERNS: readonly RegExp[];
+declare function isNoise(line: string, patterns?: readonly RegExp[]): boolean;
+declare function tailMeaningful(lines: readonly string[], n: number, patterns?: readonly RegExp[]): string[];
+
+export { FAILURE_PATTERNS as F, NOISE_PATTERNS as N, type TextSegment as T, type Failure as a, type FailurePattern as b, type FailureTool as c, findFailures as d, firstFailureIndex as e, filterLines as f, isNoise as i, splitByMatch as s, tailMeaningful as t };

package/dist/log-helpers-rkbgYqZW.d.ts

@@ -0,0 +1,25 @@
+interface TextSegment {
+    text: string;
+    match: boolean;
+}
+type FailureTool = 'vitest' | 'nx' | 'tsc' | 'pnpm' | 'npm' | 'docker' | 'generic';
+interface FailurePattern {
+    tool: FailureTool;
+    kind: string;
+    pattern: RegExp;
+}
+interface Failure {
+    index: number;
+    tool: FailureTool;
+    kind: string;
+}
+declare function filterLines(lines: readonly string[], query: string): number[];
+declare function splitByMatch(line: string, query: string): TextSegment[];
+declare const FAILURE_PATTERNS: readonly FailurePattern[];
+declare function findFailures(lines: readonly string[], patterns?: readonly FailurePattern[]): Failure[];
+declare function firstFailureIndex(lines: readonly string[], patterns?: readonly FailurePattern[]): number;
+declare const NOISE_PATTERNS: readonly RegExp[];
+declare function isNoise(line: string, patterns?: readonly RegExp[]): boolean;
+declare function tailMeaningful(lines: readonly string[], n: number, patterns?: readonly RegExp[]): string[];
+
+export { FAILURE_PATTERNS as F, NOISE_PATTERNS as N, type TextSegment as T, type Failure as a, type FailurePattern as b, type FailureTool as c, findFailures as d, firstFailureIndex as e, filterLines as f, isNoise as i, splitByMatch as s, tailMeaningful as t };

package/dist/terminal-output.d.cts

@@ -1,3 +1,4 @@
+export { F as FAILURE_PATTERNS, a as Failure, b as FailurePattern, c as FailureTool, N as NOISE_PATTERNS, T as TextSegment, f as filterLines, d as findFailures, e as firstFailureIndex, i as isNoise, s as splitByMatch, t as tailMeaningful } from './log-helpers-rkbgYqZW.cjs';
 import { RefObject } from 'react';
 
 type AnsiColor = {
@@ -110,30 +111,6 @@ interface AnsiStream {
  */
 declare function createAnsiStream(options?: AnsiStreamOptions): AnsiStream;
 
-interface TextSegment {
-    text: string;
-    match: boolean;
-}
-type FailureTool = 'vitest' | 'nx' | 'tsc' | 'pnpm' | 'npm' | 'docker' | 'generic';
-interface FailurePattern {
-    tool: FailureTool;
-    kind: string;
-    pattern: RegExp;
-}
-interface Failure {
-    index: number;
-    tool: FailureTool;
-    kind: string;
-}
-declare function filterLines(lines: readonly string[], query: string): number[];
-declare function splitByMatch(line: string, query: string): TextSegment[];
-declare const FAILURE_PATTERNS: readonly FailurePattern[];
-declare function findFailures(lines: readonly string[], patterns?: readonly FailurePattern[]): Failure[];
-declare function firstFailureIndex(lines: readonly string[], patterns?: readonly FailurePattern[]): number;
-declare const NOISE_PATTERNS: readonly RegExp[];
-declare function isNoise(line: string, patterns?: readonly RegExp[]): boolean;
-declare function tailMeaningful(lines: readonly string[], n: number, patterns?: readonly RegExp[]): string[];
-
 interface ScrollMetrics {
     scrollTop: number;
     scrollHeight: number;
@@ -183,4 +160,4 @@ interface UseFollowTailResult {
 }
 declare function useFollowTail({ scrollRef, itemCount, scrollToEnd, resetKey, threshold, }: UseFollowTailOptions): UseFollowTailResult;
 
-export { type AnsiColor, type AnsiLine, type AnsiSegment, type AnsiStream, type AnsiStreamOptions, type AnsiStreamUpdate, type AnsiStyle, DEFAULT_TAIL_THRESHOLD, FAILURE_PATTERNS, type Failure, type FailurePattern, type FailureTool, type LineBuffer, type LineBufferOptions, type LineBufferUpdate, NOISE_PATTERNS, type ParseAnsiOptions, type ScrollEventInfo, type ScrollEventKind, type ScrollMetrics, type StreamCursor, type TextSegment, type UseFollowTailOptions, type UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, filterLines, findFailures, firstFailureIndex, isNearEnd, isNoise, isUserScrollUp, parseAnsi, shouldStick, splitByMatch, stripAnsi, tailMeaningful, unreadDelta, useFollowTail };
+export { type AnsiColor, type AnsiLine, type AnsiSegment, type AnsiStream, type AnsiStreamOptions, type AnsiStreamUpdate, type AnsiStyle, DEFAULT_TAIL_THRESHOLD, type LineBuffer, type LineBufferOptions, type LineBufferUpdate, type ParseAnsiOptions, type ScrollEventInfo, type ScrollEventKind, type ScrollMetrics, type StreamCursor, type UseFollowTailOptions, type UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, isNearEnd, isUserScrollUp, parseAnsi, shouldStick, stripAnsi, unreadDelta, useFollowTail };

package/dist/terminal-output.d.ts

@@ -1,3 +1,4 @@
+export { F as FAILURE_PATTERNS, a as Failure, b as FailurePattern, c as FailureTool, N as NOISE_PATTERNS, T as TextSegment, f as filterLines, d as findFailures, e as firstFailureIndex, i as isNoise, s as splitByMatch, t as tailMeaningful } from './log-helpers-rkbgYqZW.js';
 import { RefObject } from 'react';
 
 type AnsiColor = {
@@ -110,30 +111,6 @@ interface AnsiStream {
  */
 declare function createAnsiStream(options?: AnsiStreamOptions): AnsiStream;
 
-interface TextSegment {
-    text: string;
-    match: boolean;
-}
-type FailureTool = 'vitest' | 'nx' | 'tsc' | 'pnpm' | 'npm' | 'docker' | 'generic';
-interface FailurePattern {
-    tool: FailureTool;
-    kind: string;
-    pattern: RegExp;
-}
-interface Failure {
-    index: number;
-    tool: FailureTool;
-    kind: string;
-}
-declare function filterLines(lines: readonly string[], query: string): number[];
-declare function splitByMatch(line: string, query: string): TextSegment[];
-declare const FAILURE_PATTERNS: readonly FailurePattern[];
-declare function findFailures(lines: readonly string[], patterns?: readonly FailurePattern[]): Failure[];
-declare function firstFailureIndex(lines: readonly string[], patterns?: readonly FailurePattern[]): number;
-declare const NOISE_PATTERNS: readonly RegExp[];
-declare function isNoise(line: string, patterns?: readonly RegExp[]): boolean;
-declare function tailMeaningful(lines: readonly string[], n: number, patterns?: readonly RegExp[]): string[];
-
 interface ScrollMetrics {
     scrollTop: number;
     scrollHeight: number;
@@ -183,4 +160,4 @@ interface UseFollowTailResult {
 }
 declare function useFollowTail({ scrollRef, itemCount, scrollToEnd, resetKey, threshold, }: UseFollowTailOptions): UseFollowTailResult;
 
-export { type AnsiColor, type AnsiLine, type AnsiSegment, type AnsiStream, type AnsiStreamOptions, type AnsiStreamUpdate, type AnsiStyle, DEFAULT_TAIL_THRESHOLD, FAILURE_PATTERNS, type Failure, type FailurePattern, type FailureTool, type LineBuffer, type LineBufferOptions, type LineBufferUpdate, NOISE_PATTERNS, type ParseAnsiOptions, type ScrollEventInfo, type ScrollEventKind, type ScrollMetrics, type StreamCursor, type TextSegment, type UseFollowTailOptions, type UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, filterLines, findFailures, firstFailureIndex, isNearEnd, isNoise, isUserScrollUp, parseAnsi, shouldStick, splitByMatch, stripAnsi, tailMeaningful, unreadDelta, useFollowTail };
+export { type AnsiColor, type AnsiLine, type AnsiSegment, type AnsiStream, type AnsiStreamOptions, type AnsiStreamUpdate, type AnsiStyle, DEFAULT_TAIL_THRESHOLD, type LineBuffer, type LineBufferOptions, type LineBufferUpdate, type ParseAnsiOptions, type ScrollEventInfo, type ScrollEventKind, type ScrollMetrics, type StreamCursor, type UseFollowTailOptions, type UseFollowTailResult, createAnsiParser, createAnsiStream, createLineBuffer, distanceFromEnd, isNearEnd, isUserScrollUp, parseAnsi, shouldStick, stripAnsi, unreadDelta, useFollowTail };

package/dist/terminal-output.js

@@ -1,11 +1,13 @@
 "use client";
+import {
+  createAnsiStream,
+  createLineBuffer
+} from "./chunk-JTLQQSLO.js";
 import {
   DEFAULT_TAIL_THRESHOLD,
   FAILURE_PATTERNS,
   NOISE_PATTERNS,
   createAnsiParser,
-  createAnsiStream,
-  createLineBuffer,
   distanceFromEnd,
   filterLines,
   findFailures,
@@ -20,7 +22,7 @@ import {
   tailMeaningful,
   unreadDelta,
   useFollowTail
-} from "./chunk-TE2FRIPF.js";
+} from "./chunk-IVLRQ23V.js";
 export {
   DEFAULT_TAIL_THRESHOLD,
   FAILURE_PATTERNS,