@north-light/crouter 0.3.170 → 0.3.172

package/dist/clients/inbox/review/document-region.d.ts

@@ -0,0 +1,120 @@
+import type { SurfaceRegion } from '../../surfaces/region.js';
+import { type CommentAuthority } from './comments-client.js';
+import type { LiveSource } from './live-source.js';
+/** What the composed owner supplies a region that cannot own the pane itself.
+ *
+ *  `submit` exists because the approved leader table keeps `space s` on the
+ *  document region while the review lifecycle adapter belongs to the composed
+ *  owner: the region reports the intent, the owner runs `reviewClient.submit`. */
+export interface CompositionServices {
+    notice(text: string): void;
+    suspendForChild(): () => void;
+    requestClose(): void;
+    submit(): void;
+}
+export interface DocumentRegionOptions {
+    reviewId: string;
+    absFile: string;
+    cwd: string;
+    source: LiveSource;
+    comments: CommentAuthority;
+    services: CompositionServices;
+}
+/** The reviewed document as a composed region: existing review rendering and
+ *  navigation over a live file, with comments projected from the daemon and
+ *  ranges remapped by this terminal as the file changes. */
+export declare class DocumentRegion implements SurfaceRegion {
+    private readonly absFile;
+    private readonly fileLabel;
+    private readonly kind;
+    private readonly source;
+    private readonly comments;
+    private readonly services;
+    private readonly unsubscribeComments;
+    private readonly ready;
+    private cols;
+    private rows;
+    private focused;
+    private closed;
+    private spaceArmed;
+    private state;
+    private cache;
+    /** Every non-deleted comment the daemon currently projects, newest last. */
+    private projection;
+    private status;
+    /** Region-local error/summary state — never a host notice (D1). */
+    private problem;
+    private composeAnchorLost;
+    private dirty;
+    /** Serializes base-hash transitions so B→C cannot overtake A→B. */
+    private remapChain;
+    constructor(opts: DocumentRegionOptions);
+    /** Resolves once the daemon coordinate base has been aligned to the file on
+     *  disk. The owner may await it so the first painted frame already carries
+     *  current ranges; painting earlier shows only a preparing line, never a
+     *  comment at a coordinate the daemon has not accepted. */
+    open(): Promise<void>;
+    hasUnsentCompose(): boolean;
+    setViewport(cols: number, rows: number): void;
+    render(): string[];
+    handleInput(data: string): boolean;
+    handleWheel(direction: 'up' | 'down', lines: number): boolean;
+    setFocused(value: boolean): void;
+    summary(): string;
+    onDirty(fn: () => void): void;
+    /** Releases this region's render cache and stops every projected repaint.
+     *  This region closes the source it was handed; that close stops its watcher. */
+    close(): void;
+    /** Bring the daemon's comment coordinates onto the bytes now on disk, then
+     *  build the first state from what the daemon accepted. The zero-comment case
+     *  still submits its batch: the base digest itself is what advances, and a
+     *  later create against current bytes is rejected until it does. */
+    private align;
+    private movedSince;
+    /** Re-derive this region from the daemon's own coordinate base. The only
+     *  honest recovery once a batch is rejected: the local map that produced it
+     *  is no longer a true description of what the daemon holds. */
+    private realign;
+    private buildState;
+    private onSourceChanged;
+    /** One transaction covering every non-deleted comment. A rejection is stated
+     *  in this region's own footer and the projection is re-read from the
+     *  authority, which is the only thing that can still be true afterwards. */
+    private submitBatch;
+    private refreshProjection;
+    private mutate;
+    private handleComposeKey;
+    private handleLeaderKey;
+    private handleListKey;
+    private handleViewKey;
+    /** The reviewed file is the deliverable: the person's own editor writes it,
+     *  this region never does. The source is re-read the moment the editor exits
+     *  rather than waiting for the watcher's coalescing window. */
+    private editInEditor;
+    /** The composition owns cursor focus; its focused document region contributes
+     * exactly one whole marker at the same visual location the document already
+     * calls active. There is deliberately no synthetic fallback row: a marker is
+     * only valid when it belongs to a rendered anchor or the compose/list cursor. */
+    private markCursorLocation;
+    /** The frame paints source rows after its three-line header. Scroll indicators
+     * replace their source rows, so they are never cursor targets. */
+    private activeAnchorFrameRow;
+    private reflow;
+    private document;
+    private bodyHeight;
+    private composeWidth;
+    private gutterWidth;
+    /** The region's own footer line: its error, then its stale verdict. */
+    private footerLine;
+    private renderPlaceholder;
+    /** `frame.ts` renders the ordinary list. Detached anchors need stronger
+     *  treatment: their own leading group plus the original range and snippet,
+     *  because no document marker can lead a person back to them. */
+    private renderGroupedList;
+    /** The compose header states a lost anchor where the person is already
+     *  looking, leaving the footer's compose keys intact. */
+    private statedComposeAnchor;
+    private commentListRow;
+    private topVisibleSourceLine;
+    private repaint;
+}