@floegence/floeterm-terminal-web 0.15.7 → 0.16.1

package/dist/semantic/HistorySearchController.js

@@ -0,0 +1,183 @@
+import { SemanticHistoryError, validateHistoryViewport } from './presentation.js';
+import { runSemanticHistoryRequest } from './historyRequestScheduler.js';
+// Owns the isolated server-side search frontier. Search never borrows or
+// replaces the viewport controller's navigation frontier.
+export class HistorySearchController {
+    constructor(options) {
+        this.options = options;
+        this.latest = null;
+        this.frontier = null;
+        this.transportGeneration = null;
+        this.operation = Promise.resolve();
+        this.epoch = 0;
+        this.searchId = 0;
+        this.disposed = false;
+    }
+    apply(presentation) {
+        if (this.disposed)
+            return;
+        const invalidated = this.latest !== null && ((this.latest.state.contentEpoch ?? 0) !== (presentation.state.contentEpoch ?? 0)
+            || this.latest.geometry.generation !== presentation.geometry.generation
+            || this.latest.geometry.cols !== presentation.geometry.cols
+            || this.latest.geometry.rows !== presentation.geometry.rows);
+        this.latest = presentation;
+        if (invalidated)
+            this.reset();
+    }
+    setTransportGeneration(generation) {
+        if (this.disposed)
+            return;
+        if (generation !== null && (!Number.isSafeInteger(generation) || generation <= 0)) {
+            throw new Error('terminal history transport generation is invalid');
+        }
+        if (this.transportGeneration === generation)
+            return;
+        this.transportGeneration = generation;
+        this.reset();
+    }
+    search(query) {
+        const normalized = query.trim();
+        const epoch = ++this.epoch;
+        const searchId = ++this.searchId;
+        const operation = this.operation.catch(() => undefined).then(async () => {
+            if (this.disposed || epoch !== this.epoch || normalized.length === 0) {
+                return Object.freeze({ query: normalized, matches: Object.freeze([]), truncated: false });
+            }
+            return await this.scan(normalized, epoch, searchId);
+        });
+        this.operation = operation;
+        return operation;
+    }
+    resolveMatch(match) {
+        const epoch = this.epoch;
+        const operation = this.operation.catch(() => undefined).then(async () => {
+            if (this.disposed || epoch !== this.epoch || match.searchId !== this.searchId) {
+                throw new SemanticHistoryError('snapshot_superseded', 'semantic history search result is stale');
+            }
+            if (match.live)
+                return null;
+            const current = this.frontier;
+            if (!current)
+                throw new SemanticHistoryError('snapshot_superseded', 'semantic history search frontier is unavailable');
+            if (current.offset === match.viewportOffset)
+                return current;
+            const direction = match.viewportOffset < current.offset ? 'backward' : 'forward';
+            const next = validateHistoryViewport(await runSemanticHistoryRequest(() => this.options.request({
+                lane: 'search',
+                direction,
+                anchor: current.anchor,
+                snapshotId: current.snapshotId,
+                offset: current.offset,
+                targetOffset: match.viewportOffset,
+                viewportRows: current.rows,
+            })));
+            this.assertViewport(next, current.anchor);
+            if (this.disposed || epoch !== this.epoch) {
+                throw new SemanticHistoryError('snapshot_superseded', 'semantic history search was superseded');
+            }
+            this.frontier = next;
+            return next;
+        });
+        this.operation = operation;
+        return operation;
+    }
+    reset() {
+        if (this.disposed)
+            return;
+        this.epoch += 1;
+        this.frontier = null;
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.epoch += 1;
+        this.frontier = null;
+    }
+    async scan(query, epoch, searchId) {
+        const latest = this.latest;
+        if (!latest)
+            throw new Error('terminal history search requires a live Presentation');
+        const needle = query.toLocaleLowerCase();
+        const matches = [];
+        const seenRows = new Set();
+        const maxMatches = Math.max(1, Math.min(100000, Math.trunc(this.options.maxMatches ?? 10000)));
+        let truncated = false;
+        const collect = (frame, viewportOffset, live, upperBound) => {
+            for (let line = 0; line < frame.rows.length; line += 1) {
+                const absoluteRow = viewportOffset + line;
+                if (absoluteRow >= upperBound || seenRows.has(absoluteRow))
+                    continue;
+                seenRows.add(absoluteRow);
+                if (!semanticHistoryRowText(frame, line).toLocaleLowerCase().includes(needle))
+                    continue;
+                if (matches.length >= maxMatches) {
+                    truncated = true;
+                    continue;
+                }
+                matches.push(Object.freeze({ searchId, viewportOffset, line, live }));
+            }
+        };
+        let current = validateHistoryViewport(await runSemanticHistoryRequest(() => this.options.request({
+            lane: 'search',
+            direction: 'start',
+            viewportRows: latest.geometry.rows,
+        })));
+        this.assertViewport(current);
+        const anchor = current.anchor;
+        const scrollbackEnd = current.screenStartOffset;
+        collect(current.frame, current.offset, false, scrollbackEnd);
+        const finalStart = Math.max(0, scrollbackEnd - current.rows);
+        while (current.offset < finalStart) {
+            if (this.disposed || epoch !== this.epoch) {
+                throw new SemanticHistoryError('snapshot_superseded', 'semantic history search was superseded');
+            }
+            const targetOffset = Math.min(finalStart, current.offset + current.rows);
+            const next = validateHistoryViewport(await runSemanticHistoryRequest(() => this.options.request({
+                lane: 'search',
+                direction: 'forward',
+                anchor: current.anchor,
+                snapshotId: current.snapshotId,
+                offset: current.offset,
+                targetOffset,
+                viewportRows: current.rows,
+            })));
+            this.assertViewport(next, anchor);
+            if (next.offset <= current.offset) {
+                throw new SemanticHistoryError('malformed_snapshot', 'semantic history search did not advance');
+            }
+            current = next;
+            collect(current.frame, current.offset, false, scrollbackEnd);
+        }
+        if (this.disposed || epoch !== this.epoch) {
+            throw new SemanticHistoryError('snapshot_superseded', 'semantic history search was superseded');
+        }
+        this.frontier = current;
+        collect(latest.frame, latest.frame.history.screenStartOffset, true, Number.POSITIVE_INFINITY);
+        return Object.freeze({ query, matches: Object.freeze(matches), truncated });
+    }
+    assertViewport(viewport, anchor) {
+        const latest = this.latest;
+        if (!latest || viewport.lane !== 'search') {
+            throw new SemanticHistoryError('malformed_snapshot', 'semantic history search response belongs to another lane');
+        }
+        if (anchor !== undefined && viewport.anchor !== anchor) {
+            throw new SemanticHistoryError('snapshot_superseded', 'semantic history search frontier changed');
+        }
+        if (viewport.contentEpoch !== (latest.state.contentEpoch ?? 0)
+            || viewport.geometryGeneration !== latest.geometry.generation
+            || viewport.cols !== latest.geometry.cols
+            || viewport.rows !== latest.geometry.rows) {
+            throw new SemanticHistoryError('snapshot_superseded', 'semantic history search geometry changed');
+        }
+        if (this.transportGeneration === null)
+            this.transportGeneration = viewport.transportGeneration;
+        else if (viewport.transportGeneration !== this.transportGeneration) {
+            throw new SemanticHistoryError('transport_stale', 'stale terminal search transport generation');
+        }
+    }
+}
+function semanticHistoryRowText(frame, line) {
+    return frame.rows[line]?.cells.map(cell => cell.text).join('').trimEnd() ?? '';
+}
+//# sourceMappingURL=HistorySearchController.js.map

package/dist/semantic/HistorySearchController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistorySearchController.js","sourceRoot":"","sources":["../../src/semantic/HistorySearchController.ts"],"names":[],"mappings":"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"}

package/dist/semantic/HistoryViewportController.d.ts

@@ -0,0 +1,79 @@
+import type { RendererSurface } from './RendererSurface.js';
+import type { SemanticHistoryRequest, SemanticHistoryViewport, SemanticPresentation } from './presentation.js';
+export type HistoryViewportState = Readonly<{
+    browsing: boolean;
+    busy: boolean;
+    offset: number;
+    totalRows: number;
+    screenStartOffset: number;
+    error: Error | null;
+}>;
+export type HistoryViewportCacheMetrics = Readonly<{
+    entries: number;
+    bytes: number;
+    extraBytes: number;
+    extraCells: number;
+}>;
+export type HistoryViewportControllerOptions = Readonly<{
+    renderer: Pick<RendererSurface, 'apply' | 'project' | 'getCellMetrics'>;
+    request: (request: SemanticHistoryRequest) => Promise<SemanticHistoryViewport>;
+    onState?: (state: HistoryViewportState) => void;
+    requestAnimationFrame?: (callback: FrameRequestCallback) => number;
+    cancelAnimationFrame?: (handle: number) => void;
+}>;
+export declare class HistoryViewportController {
+    private readonly options;
+    private readonly cacheOwner;
+    private latest;
+    private visible;
+    private frontier;
+    private readonly cache;
+    private cacheBytes;
+    private historyAnchor;
+    private desiredOffset;
+    private prefetchOffset;
+    private lane;
+    private epoch;
+    private transportGeneration;
+    private touch;
+    private disposed;
+    private viewVisible;
+    private error;
+    private wheelResidualRows;
+    private wheelFrame;
+    private lastDirection;
+    private readonly requestFrame;
+    private readonly cancelFrame;
+    constructor(options: HistoryViewportControllerOptions);
+    apply(presentation: SemanticPresentation): void;
+    scrollByRows(deltaRows: number): void;
+    handleWheel(delta: number, deltaMode: number): void;
+    showStart(): void;
+    showLatest(): void;
+    showOffset(offset: number): void;
+    setVisible(visible: boolean): void;
+    reset(): void;
+    setTransportGeneration(generation: number | null): void;
+    getState(): HistoryViewportState;
+    getViewport(): SemanticHistoryViewport | null;
+    showViewport(viewport: SemanticHistoryViewport): void;
+    getCacheMetrics(): HistoryViewportCacheMetrics;
+    dispose(): void;
+    private startLane;
+    private runLane;
+    private fetchOffset;
+    private display;
+    private cacheViewport;
+    private evictCache;
+    private schedulePrefetch;
+    private isCompatible;
+    private assertTransportGeneration;
+    private resetHistory;
+    private findCachedViewport;
+    private putCache;
+    private clearCache;
+    private removeCacheEntry;
+    private acceptLineage;
+    private emitState;
+}
+//# sourceMappingURL=HistoryViewportController.d.ts.map

package/dist/semantic/HistoryViewportController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryViewportController.d.ts","sourceRoot":"","sources":["../../src/semantic/HistoryViewportController.ts"],"names":[],"mappings":"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"}