@asm-agent/tui 0.8.2

package/dist/fullscreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullscreen.d.ts","sourceRoot":"","sources":["../src/fullscreen.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Fullscreen (alternate-screen) viewport: a scrollable window over the\n * transcript with a dock (editor/footer) pinned to the bottom rows. Frames\n * are a fixed grid painted with absolute addressing and diffed row-by-row;\n * scroll position is application state, not terminal scrollback.\n */\n\nimport type { TableCellSelectionRegion } from \"./selection-metadata.js\";\nimport { isImageLine } from \"./terminal-image.js\";\nimport { sliceByColumn, stripAnsi, urlAtColumn, visibleWidth } from \"./utils.js\";\n\nexport const FULLSCREEN_MIN_TRANSCRIPT_ROWS = 3;\n\nexport function clippedFullscreenDockHeight(dockLength: number, height: number): number {\n\tconst maxDock = Math.max(0, height - FULLSCREEN_MIN_TRANSCRIPT_ROWS);\n\treturn Math.min(dockLength, maxDock);\n}\n\n// Kitty images span multiple physical rows and cannot be clipped to a window.\nconst IMAGE_PLACEHOLDER = \"\\x1b[2m[image — view in inline mode]\\x1b[0m\";\n\nexport interface ScrollInfo {\n\tfollowing: boolean;\n\tlinesBelow: number;\n\tlinesAbove: number;\n}\n\nexport type SelectionScrollDirection = -1 | 1;\n\n// Transcript-anchored selection endpoint (line index + visible column), so\n// streaming appends and scrolling never shift what is selected.\ninterface SelectionPoint {\n\tline: number;\n\tcol: number;\n}\n\ninterface FrameSelectionRegion {\n\tline: number;\n\tcol: number;\n\twidth: number;\n}\n\ninterface ColumnSpan {\n\tfrom: number;\n\tto: number;\n}\n\ninterface FrameSelectionSnapshot {\n\tframe: string[];\n\tregions: FrameSelectionRegion[];\n\tvisibleStart: number;\n\tvisibleHeight: number;\n}\n\ninterface TableCellPosition {\n\trow: number;\n\tcolumn: number;\n}\n\ninterface ActiveTableSelection {\n\ttable: object;\n\tanchor: TableCellPosition;\n}\n\ninterface TableSelectionRange {\n\tfromRow: number;\n\ttoRow: number;\n\tfromColumn: number;\n\ttoColumn: number;\n}\n\ntype SelectionMode = \"transcript\" | \"table\" | \"frame\";\n\nexport class FullscreenViewport {\n\tprivate scrollTop = 0;\n\tprivate following = true;\n\tprivate prevFrame: string[] = [];\n\tprivate prevWidth = 0;\n\tprivate prevHeight = 0;\n\tprivate lastMaxScroll = 0;\n\tprivate lastWindowHeight = 0;\n\tprivate lastTranscript: string[] = [];\n\tprivate lastFrame: string[] = [];\n\tprivate lastFrameVisibleStart = 0;\n\tprivate lastFrameVisibleHeight = 0;\n\tprivate frameSelectionRegions: ReadonlyArray<FrameSelectionRegion> = [];\n\tprivate tableCellSelectionRegions: ReadonlyArray<TableCellSelectionRegion> = [];\n\tprivate activeFrameSelection: FrameSelectionSnapshot | null = null;\n\tprivate activeTableSelection: ActiveTableSelection | null = null;\n\tprivate selectionAnchor: SelectionPoint | null = null;\n\tprivate selectionHead: SelectionPoint | null = null;\n\tprivate selectionMode: SelectionMode | null = null;\n\n\t/**\n\t * Compose a frame of exactly `height` lines: scrolled transcript window on\n\t * top, dock pinned to the bottom. Following pins the window to the\n\t * transcript end; otherwise it stays frozen while content appends.\n\t */\n\tcomposeFrame(\n\t\ttranscript: string[],\n\t\tdock: string[],\n\t\theight: number,\n\t\ttableCellSelectionRegions: ReadonlyArray<TableCellSelectionRegion> = [],\n\t): string[] {\n\t\tlet dockLines = dock;\n\t\tconst dockHeight = clippedFullscreenDockHeight(dockLines.length, height);\n\t\tif (dockLines.length > dockHeight) {\n\t\t\tdockLines = dockLines.slice(dockLines.length - dockHeight);\n\t\t}\n\t\tconst windowHeight = height - dockLines.length;\n\t\tconst maxScroll = Math.max(0, transcript.length - windowHeight);\n\n\t\tif (this.following) {\n\t\t\tthis.scrollTop = maxScroll;\n\t\t} else {\n\t\t\tthis.scrollTop = Math.max(0, Math.min(this.scrollTop, maxScroll));\n\t\t}\n\t\tthis.lastMaxScroll = maxScroll;\n\t\tthis.lastWindowHeight = windowHeight;\n\t\tthis.lastTranscript = transcript;\n\t\tthis.tableCellSelectionRegions = tableCellSelectionRegions;\n\n\t\tconst window = transcript.slice(this.scrollTop, this.scrollTop + windowHeight);\n\t\tfor (let i = 0; i < window.length; i++) {\n\t\t\tif (isImageLine(window[i])) window[i] = IMAGE_PLACEHOLDER;\n\t\t}\n\t\tthis.highlightSelection(window);\n\t\twhile (window.length < windowHeight) {\n\t\t\twindow.push(\"\");\n\t\t}\n\t\treturn [...window, ...dockLines];\n\t}\n\n\tprivate orderedSelection(): { start: SelectionPoint; end: SelectionPoint } | null {\n\t\tconst a = this.selectionAnchor;\n\t\tconst b = this.selectionHead;\n\t\tif (!a || !b || (a.line === b.line && a.col === b.col)) return null;\n\t\tconst flipped = a.line > b.line || (a.line === b.line && a.col > b.col);\n\t\treturn flipped ? { start: b, end: a } : { start: a, end: b };\n\t}\n\n\tprivate selectionSpan(lineIndex: number, sel: { start: SelectionPoint; end: SelectionPoint }): ColumnSpan | null {\n\t\tif (lineIndex < sel.start.line || lineIndex > sel.end.line) return null;\n\t\treturn {\n\t\t\tfrom: lineIndex === sel.start.line ? sel.start.col : 0,\n\t\t\tto: lineIndex === sel.end.line ? sel.end.col : Number.MAX_SAFE_INTEGER,\n\t\t};\n\t}\n\n\tprivate highlightSelection(window: string[]): void {\n\t\tif (this.selectionMode !== \"transcript\" && this.selectionMode !== \"table\") return;\n\t\tconst sel = this.orderedSelection();\n\t\tif (!sel) return;\n\t\tfor (let i = 0; i < window.length; i++) {\n\t\t\tconst lineIndex = this.scrollTop + i;\n\t\t\tconst spans =\n\t\t\t\tthis.selectionMode === \"table\"\n\t\t\t\t\t? this.selectedTableSpans(lineIndex, sel)\n\t\t\t\t\t: [this.selectionSpan(lineIndex, sel)].filter((span): span is ColumnSpan => span !== null);\n\t\t\tfor (let spanIndex = spans.length - 1; spanIndex >= 0; spanIndex--) {\n\t\t\t\twindow[i] = this.highlightLine(window[i], spans[spanIndex]);\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Begin a selection at a screen position; false when outside the transcript window. */\n\tbeginSelection(screenRow: number, screenCol: number): boolean {\n\t\tconst line = this.transcriptLineForScreenRow(screenRow, false);\n\t\tif (line === null) {\n\t\t\tthis.clearSelection();\n\t\t\treturn false;\n\t\t}\n\t\tconst point = { line, col: Math.max(0, screenCol) };\n\t\tthis.selectionAnchor = point;\n\t\tthis.selectionHead = { ...point };\n\t\tconst table = this.tableAtPoint(point);\n\t\tconst tableCell = table ? this.closestTableCell(table, point) : null;\n\t\tif (table && tableCell) {\n\t\t\tthis.activeTableSelection = { table, anchor: tableCell };\n\t\t\tthis.selectionMode = \"table\";\n\t\t} else {\n\t\t\tthis.activeTableSelection = null;\n\t\t\tthis.selectionMode = \"transcript\";\n\t\t}\n\t\treturn true;\n\t}\n\n\textendSelection(screenRow: number, screenCol: number): void {\n\t\tif (!this.selectionAnchor || (this.selectionMode !== \"transcript\" && this.selectionMode !== \"table\")) return;\n\t\tconst line = this.transcriptLineForScreenRow(screenRow, true);\n\t\tif (line === null) return;\n\t\tthis.selectionHead = { line, col: Math.max(0, screenCol) };\n\t}\n\n\tselectionAutoScrollDirection(screenRow: number): SelectionScrollDirection | null {\n\t\tif (\n\t\t\t!this.selectionAnchor ||\n\t\t\t!this.selectionHead ||\n\t\t\t(this.selectionMode !== \"transcript\" && this.selectionMode !== \"table\")\n\t\t)\n\t\t\treturn null;\n\t\tconst bounds = this.transcriptScreenBounds();\n\t\tif (!bounds) return null;\n\t\tif (this.selectionHead.line < this.selectionAnchor.line && screenRow <= bounds.firstRow && this.scrollTop > 0) {\n\t\t\treturn -1;\n\t\t}\n\t\tif (\n\t\t\tthis.selectionHead.line > this.selectionAnchor.line &&\n\t\t\tscreenRow >= bounds.lastRow &&\n\t\t\tthis.scrollTop < this.lastMaxScroll\n\t\t) {\n\t\t\treturn 1;\n\t\t}\n\t\treturn null;\n\t}\n\n\tscrollSelection(direction: SelectionScrollDirection, screenCol: number): boolean {\n\t\tif (!this.selectionAnchor || (this.selectionMode !== \"transcript\" && this.selectionMode !== \"table\"))\n\t\t\treturn false;\n\t\tconst previousScrollTop = this.scrollTop;\n\t\tthis.scrollBy(direction);\n\t\tif (this.scrollTop === previousScrollTop) return false;\n\t\tconst bounds = this.transcriptScreenBounds();\n\t\tif (!bounds) return false;\n\t\tthis.extendSelection(direction === -1 ? bounds.firstRow : bounds.lastRow, screenCol);\n\t\treturn true;\n\t}\n\n\t/** Finish the selection and return its plain text (null when empty). */\n\tendSelection(): string | null {\n\t\tif (this.selectionMode !== \"transcript\" && this.selectionMode !== \"table\") {\n\t\t\tthis.clearSelection();\n\t\t\treturn null;\n\t\t}\n\t\tconst sel = this.orderedSelection();\n\t\tconst text = sel\n\t\t\t? this.selectionMode === \"table\"\n\t\t\t\t? this.extractTableSelectionText(this.lastTranscript, sel)\n\t\t\t\t: this.extractSelectionText(this.lastTranscript, sel)\n\t\t\t: null;\n\t\tthis.clearSelection();\n\t\treturn text;\n\t}\n\n\textendActiveSelection(screenRow: number, screenCol: number): void {\n\t\tif (this.selectionMode === \"frame\") {\n\t\t\tthis.extendFrameSelection(screenRow, screenCol);\n\t\t} else if (this.selectionMode === \"transcript\" || this.selectionMode === \"table\") {\n\t\t\tthis.extendSelection(screenRow, screenCol);\n\t\t}\n\t}\n\n\tendActiveSelection(): string | null {\n\t\tif (this.selectionMode === \"frame\") {\n\t\t\treturn this.endFrameSelection();\n\t\t}\n\t\tif (this.selectionMode === \"transcript\" || this.selectionMode === \"table\") {\n\t\t\treturn this.endSelection();\n\t\t}\n\t\tthis.clearSelection();\n\t\treturn null;\n\t}\n\n\t/** Snapshot and highlight the final screen frame for overlay/dock selection. */\n\tapplyFrameSelection(frame: string[], height: number, selectableRegions: ReadonlyArray<FrameSelectionRegion>): void {\n\t\tthis.lastFrame = frame;\n\t\tthis.lastFrameVisibleHeight = Math.min(Math.max(0, height), frame.length);\n\t\tthis.lastFrameVisibleStart = Math.max(0, frame.length - this.lastFrameVisibleHeight);\n\t\tthis.frameSelectionRegions = selectableRegions;\n\t\tif (this.selectionMode !== \"frame\") return;\n\t\tconst sel = this.orderedSelection();\n\t\tif (!sel) return;\n\t\tfor (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {\n\t\t\tlet line = frame[lineIndex];\n\t\t\tif (line === undefined) continue;\n\t\t\tconst spans = this.selectedFrameSpans(lineIndex, sel);\n\t\t\tfor (let i = spans.length - 1; i >= 0; i--) {\n\t\t\t\tline = this.highlightLine(line, spans[i]);\n\t\t\t}\n\t\t\tframe[lineIndex] = line;\n\t\t}\n\t}\n\n\tbeginFrameSelection(screenRow: number, screenCol: number): boolean {\n\t\tconst point = this.framePoint(screenRow, screenCol);\n\t\tif (!point || !this.isFrameSelectable(point)) {\n\t\t\tthis.clearSelection();\n\t\t\treturn false;\n\t\t}\n\t\tthis.activeFrameSelection = {\n\t\t\tframe: [...this.lastFrame],\n\t\t\tregions: this.frameSelectionRegions.map((region) => ({ ...region })),\n\t\t\tvisibleStart: this.lastFrameVisibleStart,\n\t\t\tvisibleHeight: this.lastFrameVisibleHeight,\n\t\t};\n\t\tthis.selectionAnchor = point;\n\t\tthis.selectionHead = { ...point };\n\t\tthis.selectionMode = \"frame\";\n\t\treturn true;\n\t}\n\n\textendFrameSelection(screenRow: number, screenCol: number): void {\n\t\tif (!this.selectionAnchor || this.selectionMode !== \"frame\") return;\n\t\tconst point = this.framePoint(screenRow, screenCol, this.activeFrameSelection);\n\t\tif (!point) return;\n\t\tconst clamped = this.clampFrameSelectionPoint(point);\n\t\tif (!clamped) return;\n\t\tthis.selectionHead = clamped;\n\t}\n\n\tendFrameSelection(): string | null {\n\t\tif (this.selectionMode !== \"frame\") {\n\t\t\tthis.clearSelection();\n\t\t\treturn null;\n\t\t}\n\t\tconst sel = this.orderedSelection();\n\t\tconst active = this.activeFrameSelection;\n\t\tconst sourceLines = active?.frame ?? this.lastFrame;\n\t\tconst regions = active?.regions ?? this.frameSelectionRegions;\n\t\tthis.clearSelection();\n\t\tif (!sel) return null;\n\t\treturn this.extractFrameSelectionText(sourceLines, regions, sel);\n\t}\n\n\tprivate highlightLine(line: string, span: ColumnSpan): string {\n\t\tconst width = visibleWidth(line);\n\t\tconst from = Math.min(span.from, width);\n\t\tconst to = Math.min(span.to, width);\n\t\tif (to <= from) return line;\n\t\tconst before = sliceByColumn(line, 0, from);\n\t\tconst selected = stripAnsi(sliceByColumn(line, from, to - from));\n\t\tconst after = sliceByColumn(line, to, Math.max(0, width - to));\n\t\treturn `${before}\\x1b[0m\\x1b[7m${selected}\\x1b[27m${after}`;\n\t}\n\n\tprivate framePoint(\n\t\tscreenRow: number,\n\t\tscreenCol: number,\n\t\tsnapshot: FrameSelectionSnapshot | null = null,\n\t): SelectionPoint | null {\n\t\tconst visibleHeight = snapshot?.visibleHeight ?? this.lastFrameVisibleHeight;\n\t\tif (visibleHeight === 0) return null;\n\t\tconst visibleStart = snapshot?.visibleStart ?? this.lastFrameVisibleStart;\n\t\tconst frameLength = snapshot?.frame.length ?? this.lastFrame.length;\n\t\tconst row = Math.max(0, Math.min(screenRow, visibleHeight - 1));\n\t\tconst line = visibleStart + row;\n\t\tif (line < 0 || line >= frameLength) return null;\n\t\treturn { line, col: Math.max(0, screenCol) };\n\t}\n\n\tprivate transcriptScreenBounds(): {\n\t\tfirstRow: number;\n\t\tlastRow: number;\n\t\tvisibleStart: number;\n\t\tvisibleHeight: number;\n\t\ttranscriptStart: number;\n\t\ttranscriptEnd: number;\n\t} | null {\n\t\tif (this.lastWindowHeight <= 0) return null;\n\t\tconst visibleHeight = this.lastFrameVisibleHeight > 0 ? this.lastFrameVisibleHeight : this.lastWindowHeight;\n\t\tif (visibleHeight <= 0) return null;\n\t\tconst visibleStart = this.lastFrameVisibleHeight > 0 ? this.lastFrameVisibleStart : 0;\n\t\tconst visibleEnd = visibleStart + visibleHeight - 1;\n\t\tconst transcriptStart = Math.max(0, visibleStart);\n\t\tconst transcriptEnd = Math.min(this.lastWindowHeight - 1, visibleEnd);\n\t\tif (transcriptStart > transcriptEnd) return null;\n\t\treturn {\n\t\t\tfirstRow: transcriptStart - visibleStart,\n\t\t\tlastRow: transcriptEnd - visibleStart,\n\t\t\tvisibleStart,\n\t\t\tvisibleHeight,\n\t\t\ttranscriptStart,\n\t\t\ttranscriptEnd,\n\t\t};\n\t}\n\n\tprivate transcriptLineForScreenRow(screenRow: number, clamp: boolean): number | null {\n\t\tconst bounds = this.transcriptScreenBounds();\n\t\tif (!bounds) return null;\n\t\tif (!clamp && (screenRow < 0 || screenRow >= bounds.visibleHeight)) return null;\n\t\tconst row = clamp ? Math.max(0, Math.min(screenRow, bounds.visibleHeight - 1)) : screenRow;\n\t\tconst frameLine = bounds.visibleStart + row;\n\t\tif (!clamp && (frameLine < bounds.transcriptStart || frameLine > bounds.transcriptEnd)) return null;\n\t\treturn this.scrollTop + Math.max(bounds.transcriptStart, Math.min(frameLine, bounds.transcriptEnd));\n\t}\n\n\tprivate isFrameSelectable(point: SelectionPoint): boolean {\n\t\treturn this.frameSelectionRegions.some(\n\t\t\t(region) => region.line === point.line && point.col >= region.col && point.col < region.col + region.width,\n\t\t);\n\t}\n\n\tprivate tableRegions(table: object): TableCellSelectionRegion[] {\n\t\treturn this.tableCellSelectionRegions.filter((region) => region.table === table);\n\t}\n\n\tprivate tableAtPoint(point: SelectionPoint): object | null {\n\t\tconst tables = new Set(this.tableCellSelectionRegions.map((region) => region.table));\n\t\tfor (const table of tables) {\n\t\t\tconst region = this.tableRegions(table)[0];\n\t\t\tif (\n\t\t\t\tregion &&\n\t\t\t\tpoint.line >= region.tableTop &&\n\t\t\t\tpoint.line <= region.tableBottom &&\n\t\t\t\tpoint.col >= Math.max(0, region.tableLeft - 1) &&\n\t\t\t\tpoint.col <= region.tableRight\n\t\t\t) {\n\t\t\t\treturn table;\n\t\t\t}\n\t\t}\n\t\treturn null;\n\t}\n\n\tprivate closestTableCell(table: object, point: SelectionPoint): TableCellPosition | null {\n\t\tlet closest: TableCellPosition | null = null;\n\t\tlet closestLineDistance = Number.POSITIVE_INFINITY;\n\t\tlet closestColumnDistance = Number.POSITIVE_INFINITY;\n\t\tfor (const region of this.tableRegions(table)) {\n\t\t\tconst lineDistance = Math.abs(point.line - region.line);\n\t\t\tconst end = region.col + region.width;\n\t\t\tconst columnDistance = point.col < region.col ? region.col - point.col : point.col > end ? point.col - end : 0;\n\t\t\tif (\n\t\t\t\tlineDistance < closestLineDistance ||\n\t\t\t\t(lineDistance === closestLineDistance && columnDistance < closestColumnDistance)\n\t\t\t) {\n\t\t\t\tclosest = { row: region.row, column: region.column };\n\t\t\t\tclosestLineDistance = lineDistance;\n\t\t\t\tclosestColumnDistance = columnDistance;\n\t\t\t}\n\t\t}\n\t\treturn closest;\n\t}\n\n\tprivate activeTableRange(): TableSelectionRange | null {\n\t\tconst active = this.activeTableSelection;\n\t\tconst head = this.selectionHead;\n\t\tif (!active || !head) return null;\n\t\tconst headCell = this.closestTableCell(active.table, head);\n\t\tif (!headCell) return null;\n\t\treturn {\n\t\t\tfromRow: Math.min(active.anchor.row, headCell.row),\n\t\t\ttoRow: Math.max(active.anchor.row, headCell.row),\n\t\t\tfromColumn: Math.min(active.anchor.column, headCell.column),\n\t\t\ttoColumn: Math.max(active.anchor.column, headCell.column),\n\t\t};\n\t}\n\n\tprivate selectedTableSpans(lineIndex: number, sel: { start: SelectionPoint; end: SelectionPoint }): ColumnSpan[] {\n\t\tconst active = this.activeTableSelection;\n\t\tconst range = this.activeTableRange();\n\t\tif (!active || !range) return [];\n\t\tconst singleCell = range.fromRow === range.toRow && range.fromColumn === range.toColumn;\n\t\tconst selectionSpan = singleCell ? this.selectionSpan(lineIndex, sel) : null;\n\t\tif (singleCell && !selectionSpan) return [];\n\n\t\tconst spans: ColumnSpan[] = [];\n\t\tfor (const region of this.tableCellSelectionRegions) {\n\t\t\tif (\n\t\t\t\tregion.line !== lineIndex ||\n\t\t\t\tregion.table !== active.table ||\n\t\t\t\tregion.row < range.fromRow ||\n\t\t\t\tregion.row > range.toRow ||\n\t\t\t\tregion.column < range.fromColumn ||\n\t\t\t\tregion.column > range.toColumn\n\t\t\t)\n\t\t\t\tcontinue;\n\t\t\tconst from = selectionSpan ? Math.max(selectionSpan.from, region.col) : region.col;\n\t\t\tconst to = selectionSpan ? Math.min(selectionSpan.to, region.col + region.width) : region.col + region.width;\n\t\t\tif (to > from) spans.push({ from, to });\n\t\t}\n\t\treturn spans.sort((a, b) => a.from - b.from);\n\t}\n\n\tprivate frameRegionsForLine(\n\t\tline: number,\n\t\tregions = this.activeFrameSelection?.regions ?? this.frameSelectionRegions,\n\t): FrameSelectionRegion[] {\n\t\treturn regions.filter((region) => region.line === line && region.width > 0).sort((a, b) => a.col - b.col);\n\t}\n\n\tprivate clampFrameSelectionPoint(point: SelectionPoint): SelectionPoint | null {\n\t\tconst regions = this.frameRegionsForLine(point.line);\n\t\tif (regions.length === 0) return null;\n\t\tlet closest = regions[0].col;\n\t\tlet distance = Number.POSITIVE_INFINITY;\n\t\tfor (const region of regions) {\n\t\t\tconst start = region.col;\n\t\t\tconst end = region.col + region.width;\n\t\t\tif (point.col >= start && point.col <= end) {\n\t\t\t\treturn { line: point.line, col: Math.max(start, Math.min(point.col, end)) };\n\t\t\t}\n\t\t\tfor (const col of [start, end]) {\n\t\t\t\tconst nextDistance = Math.abs(point.col - col);\n\t\t\t\tif (nextDistance < distance) {\n\t\t\t\t\tclosest = col;\n\t\t\t\t\tdistance = nextDistance;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { line: point.line, col: closest };\n\t}\n\n\tprivate selectedFrameSpans(\n\t\tlineIndex: number,\n\t\tsel: { start: SelectionPoint; end: SelectionPoint },\n\t\tregions = this.activeFrameSelection?.regions ?? this.frameSelectionRegions,\n\t): ColumnSpan[] {\n\t\tconst span = this.selectionSpan(lineIndex, sel);\n\t\tif (!span) return [];\n\t\tconst spans: ColumnSpan[] = [];\n\t\tfor (const region of this.frameRegionsForLine(lineIndex, regions)) {\n\t\t\tconst from = Math.max(span.from, region.col);\n\t\t\tconst to = Math.min(span.to, region.col + region.width);\n\t\t\tif (to > from) spans.push({ from, to });\n\t\t}\n\t\treturn spans;\n\t}\n\n\tprivate extractFrameSelectionText(\n\t\tsourceLines: string[],\n\t\tregions: ReadonlyArray<FrameSelectionRegion>,\n\t\tsel: { start: SelectionPoint; end: SelectionPoint },\n\t): string | null {\n\t\tconst lines: string[] = [];\n\t\tfor (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {\n\t\t\tconst line = sourceLines[lineIndex] ?? \"\";\n\t\t\tconst spans = this.selectedFrameSpans(lineIndex, sel, regions);\n\t\t\tif (spans.length === 0) continue;\n\t\t\tconst parts: string[] = [];\n\t\t\tfor (const span of spans) {\n\t\t\t\tparts.push(stripAnsi(sliceByColumn(line, span.from, Math.max(0, span.to - span.from))));\n\t\t\t}\n\t\t\tlines.push(parts.join(\"\").trimEnd());\n\t\t}\n\t\tconst text = lines.join(\"\\n\");\n\t\treturn text.trim().length > 0 ? text : null;\n\t}\n\n\tprivate extractSelectionText(\n\t\tsourceLines: string[],\n\t\tsel: { start: SelectionPoint; end: SelectionPoint },\n\t): string | null {\n\t\tconst lines: string[] = [];\n\t\tfor (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {\n\t\t\tconst line = sourceLines[lineIndex] ?? \"\";\n\t\t\tconst span = this.selectionSpan(lineIndex, sel);\n\t\t\tif (!span) continue;\n\t\t\tconst width = visibleWidth(line);\n\t\t\tconst from = Math.min(span.from, width);\n\t\t\tconst to = Math.min(span.to, width);\n\t\t\tlines.push(stripAnsi(sliceByColumn(line, from, Math.max(0, to - from))).trimEnd());\n\t\t}\n\t\tconst text = lines.join(\"\\n\");\n\t\treturn text.trim().length > 0 ? text : null;\n\t}\n\n\tprivate compareSelectionPoints(a: SelectionPoint, b: SelectionPoint): number {\n\t\treturn a.line === b.line ? a.col - b.col : a.line - b.line;\n\t}\n\n\tprivate extractTableSelectionText(\n\t\tsourceLines: string[],\n\t\tsel: { start: SelectionPoint; end: SelectionPoint },\n\t): string | null {\n\t\tconst active = this.activeTableSelection;\n\t\tconst range = this.activeTableRange();\n\t\tif (!active || !range) return null;\n\n\t\tif (range.fromRow !== range.toRow || range.fromColumn !== range.toColumn) {\n\t\t\tconst contents = new Map<string, string>();\n\t\t\tfor (const region of this.tableRegions(active.table)) {\n\t\t\t\tcontents.set(`${region.row}:${region.column}`, region.content);\n\t\t\t}\n\t\t\tconst rows: string[] = [];\n\t\t\tfor (let row = range.fromRow; row <= range.toRow; row++) {\n\t\t\t\tconst cells: string[] = [];\n\t\t\t\tfor (let column = range.fromColumn; column <= range.toColumn; column++) {\n\t\t\t\t\tcells.push(contents.get(`${row}:${column}`) ?? \"\");\n\t\t\t\t}\n\t\t\t\trows.push(cells.join(\"\\t\"));\n\t\t\t}\n\t\t\tconst text = rows.join(\"\\n\");\n\t\t\treturn text.trim().length > 0 ? text : null;\n\t\t}\n\n\t\tconst cellRegions = this.tableRegions(active.table)\n\t\t\t.filter((region) => region.row === range.fromRow && region.column === range.fromColumn)\n\t\t\t.sort((a, b) => a.line - b.line || a.segment - b.segment);\n\t\tconst first = cellRegions[0];\n\t\tconst last = cellRegions.at(-1);\n\t\tif (first && last) {\n\t\t\tconst cellStart = { line: first.line, col: first.col };\n\t\t\tconst cellEnd = { line: last.line, col: last.col + last.width };\n\t\t\tif (\n\t\t\t\tthis.compareSelectionPoints(sel.start, cellStart) <= 0 &&\n\t\t\t\tthis.compareSelectionPoints(sel.end, cellEnd) >= 0\n\t\t\t) {\n\t\t\t\treturn first.content.trim().length > 0 ? first.content : null;\n\t\t\t}\n\t\t}\n\n\t\tconst lines: string[] = [];\n\t\tfor (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {\n\t\t\tconst line = sourceLines[lineIndex] ?? \"\";\n\t\t\tconst spans = this.selectedTableSpans(lineIndex, sel);\n\t\t\tif (spans.length === 0) continue;\n\t\t\tconst parts = spans.map((span) => stripAnsi(sliceByColumn(line, span.from, Math.max(0, span.to - span.from))));\n\t\t\tlines.push(parts.join(\"\").trimEnd());\n\t\t}\n\t\tconst text = lines.join(\"\\n\");\n\t\treturn text.trim().length > 0 ? text : null;\n\t}\n\n\tclearSelection(): void {\n\t\tthis.selectionAnchor = null;\n\t\tthis.selectionHead = null;\n\t\tthis.selectionMode = null;\n\t\tthis.activeFrameSelection = null;\n\t\tthis.activeTableSelection = null;\n\t}\n\n\thasSelection(): boolean {\n\t\treturn this.orderedSelection() !== null;\n\t}\n\n\t/**\n\t * OSC 8 hyperlink URL at a screen position in the last painted frame, or\n\t * null when the position is not over a hyperlink. Covers the transcript\n\t * window, the dock, and composited overlays.\n\t */\n\thyperlinkAt(screenRow: number, screenCol: number): string | null {\n\t\tif (screenRow < 0 || screenCol < 0 || this.lastFrameVisibleHeight === 0) return null;\n\t\tif (screenRow >= this.lastFrameVisibleHeight) return null;\n\t\tconst line = this.lastFrame[this.lastFrameVisibleStart + screenRow];\n\t\tif (line === undefined || isImageLine(line)) return null;\n\t\treturn urlAtColumn(line, screenCol);\n\t}\n\n\t/** Row-diff a composed frame against the previous one with absolute addressing. */\n\tpaint(\n\t\twrite: (data: string) => void,\n\t\tframe: string[],\n\t\twidth: number,\n\t\theight: number,\n\t\tcursorPos: { row: number; col: number } | null,\n\t): void {\n\t\tif (frame.length > height) {\n\t\t\tframe = frame.slice(frame.length - height);\n\t\t}\n\n\t\tlet buffer = \"\\x1b[?2026h\";\n\t\tif (width !== this.prevWidth || height !== this.prevHeight || this.prevFrame.length === 0) {\n\t\t\tbuffer += \"\\x1b[2J\\x1b[H\";\n\t\t\tthis.prevFrame = [];\n\t\t}\n\t\tfor (let row = 0; row < height; row++) {\n\t\t\tconst line = frame[row] ?? \"\";\n\t\t\tif (this.prevFrame[row] === line) continue;\n\t\t\tbuffer += `\\x1b[${row + 1};1H\\x1b[2K`;\n\t\t\t// an overwide line would wrap and shear the grid; clamp instead of crash\n\t\t\tbuffer += visibleWidth(line) > width ? sliceByColumn(line, 0, width, true) : line;\n\t\t}\n\t\tif (cursorPos) {\n\t\t\tbuffer += `\\x1b[${Math.min(cursorPos.row, height - 1) + 1};${cursorPos.col + 1}H`;\n\t\t}\n\t\tbuffer += \"\\x1b[?2026l\";\n\t\twrite(buffer);\n\n\t\tthis.prevFrame = frame;\n\t\tthis.prevWidth = width;\n\t\tthis.prevHeight = height;\n\t}\n\n\t/** Force the next paint to clear and repaint the whole screen. */\n\treset(): void {\n\t\tthis.prevFrame = [];\n\t}\n\n\t/** Scrolling up pauses following; reaching the bottom resumes it. */\n\tscrollBy(delta: number): void {\n\t\tconst base = this.following ? this.lastMaxScroll : this.scrollTop;\n\t\tthis.scrollTop = Math.max(0, Math.min(base + delta, this.lastMaxScroll));\n\t\tthis.following = this.scrollTop >= this.lastMaxScroll;\n\t}\n\n\tscrollToTop(): void {\n\t\tthis.scrollTop = 0;\n\t\tthis.following = this.lastMaxScroll === 0;\n\t}\n\n\tscrollToBottom(): void {\n\t\tthis.scrollTop = this.lastMaxScroll;\n\t\tthis.following = true;\n\t}\n\n\tpageSize(): number {\n\t\treturn Math.max(1, this.lastWindowHeight - 1);\n\t}\n\n\twindowHeight(): number {\n\t\treturn this.lastWindowHeight;\n\t}\n\n\tisFollowing(): boolean {\n\t\treturn this.following;\n\t}\n\n\tscrollInfo(): ScrollInfo {\n\t\treturn {\n\t\t\tfollowing: this.following,\n\t\t\tlinesBelow: Math.max(0, this.lastMaxScroll - this.scrollTop),\n\t\t\tlinesAbove: this.scrollTop,\n\t\t};\n\t}\n}\n"]}

package/dist/fullscreen.js

@@ -0,0 +1,597 @@
+/**
+ * Fullscreen (alternate-screen) viewport: a scrollable window over the
+ * transcript with a dock (editor/footer) pinned to the bottom rows. Frames
+ * are a fixed grid painted with absolute addressing and diffed row-by-row;
+ * scroll position is application state, not terminal scrollback.
+ */
+import { isImageLine } from "./terminal-image.js";
+import { sliceByColumn, stripAnsi, urlAtColumn, visibleWidth } from "./utils.js";
+export const FULLSCREEN_MIN_TRANSCRIPT_ROWS = 3;
+export function clippedFullscreenDockHeight(dockLength, height) {
+    const maxDock = Math.max(0, height - FULLSCREEN_MIN_TRANSCRIPT_ROWS);
+    return Math.min(dockLength, maxDock);
+}
+// Kitty images span multiple physical rows and cannot be clipped to a window.
+const IMAGE_PLACEHOLDER = "\x1b[2m[image — view in inline mode]\x1b[0m";
+export class FullscreenViewport {
+    scrollTop = 0;
+    following = true;
+    prevFrame = [];
+    prevWidth = 0;
+    prevHeight = 0;
+    lastMaxScroll = 0;
+    lastWindowHeight = 0;
+    lastTranscript = [];
+    lastFrame = [];
+    lastFrameVisibleStart = 0;
+    lastFrameVisibleHeight = 0;
+    frameSelectionRegions = [];
+    tableCellSelectionRegions = [];
+    activeFrameSelection = null;
+    activeTableSelection = null;
+    selectionAnchor = null;
+    selectionHead = null;
+    selectionMode = null;
+    /**
+     * Compose a frame of exactly `height` lines: scrolled transcript window on
+     * top, dock pinned to the bottom. Following pins the window to the
+     * transcript end; otherwise it stays frozen while content appends.
+     */
+    composeFrame(transcript, dock, height, tableCellSelectionRegions = []) {
+        let dockLines = dock;
+        const dockHeight = clippedFullscreenDockHeight(dockLines.length, height);
+        if (dockLines.length > dockHeight) {
+            dockLines = dockLines.slice(dockLines.length - dockHeight);
+        }
+        const windowHeight = height - dockLines.length;
+        const maxScroll = Math.max(0, transcript.length - windowHeight);
+        if (this.following) {
+            this.scrollTop = maxScroll;
+        }
+        else {
+            this.scrollTop = Math.max(0, Math.min(this.scrollTop, maxScroll));
+        }
+        this.lastMaxScroll = maxScroll;
+        this.lastWindowHeight = windowHeight;
+        this.lastTranscript = transcript;
+        this.tableCellSelectionRegions = tableCellSelectionRegions;
+        const window = transcript.slice(this.scrollTop, this.scrollTop + windowHeight);
+        for (let i = 0; i < window.length; i++) {
+            if (isImageLine(window[i]))
+                window[i] = IMAGE_PLACEHOLDER;
+        }
+        this.highlightSelection(window);
+        while (window.length < windowHeight) {
+            window.push("");
+        }
+        return [...window, ...dockLines];
+    }
+    orderedSelection() {
+        const a = this.selectionAnchor;
+        const b = this.selectionHead;
+        if (!a || !b || (a.line === b.line && a.col === b.col))
+            return null;
+        const flipped = a.line > b.line || (a.line === b.line && a.col > b.col);
+        return flipped ? { start: b, end: a } : { start: a, end: b };
+    }
+    selectionSpan(lineIndex, sel) {
+        if (lineIndex < sel.start.line || lineIndex > sel.end.line)
+            return null;
+        return {
+            from: lineIndex === sel.start.line ? sel.start.col : 0,
+            to: lineIndex === sel.end.line ? sel.end.col : Number.MAX_SAFE_INTEGER,
+        };
+    }
+    highlightSelection(window) {
+        if (this.selectionMode !== "transcript" && this.selectionMode !== "table")
+            return;
+        const sel = this.orderedSelection();
+        if (!sel)
+            return;
+        for (let i = 0; i < window.length; i++) {
+            const lineIndex = this.scrollTop + i;
+            const spans = this.selectionMode === "table"
+                ? this.selectedTableSpans(lineIndex, sel)
+                : [this.selectionSpan(lineIndex, sel)].filter((span) => span !== null);
+            for (let spanIndex = spans.length - 1; spanIndex >= 0; spanIndex--) {
+                window[i] = this.highlightLine(window[i], spans[spanIndex]);
+            }
+        }
+    }
+    /** Begin a selection at a screen position; false when outside the transcript window. */
+    beginSelection(screenRow, screenCol) {
+        const line = this.transcriptLineForScreenRow(screenRow, false);
+        if (line === null) {
+            this.clearSelection();
+            return false;
+        }
+        const point = { line, col: Math.max(0, screenCol) };
+        this.selectionAnchor = point;
+        this.selectionHead = { ...point };
+        const table = this.tableAtPoint(point);
+        const tableCell = table ? this.closestTableCell(table, point) : null;
+        if (table && tableCell) {
+            this.activeTableSelection = { table, anchor: tableCell };
+            this.selectionMode = "table";
+        }
+        else {
+            this.activeTableSelection = null;
+            this.selectionMode = "transcript";
+        }
+        return true;
+    }
+    extendSelection(screenRow, screenCol) {
+        if (!this.selectionAnchor || (this.selectionMode !== "transcript" && this.selectionMode !== "table"))
+            return;
+        const line = this.transcriptLineForScreenRow(screenRow, true);
+        if (line === null)
+            return;
+        this.selectionHead = { line, col: Math.max(0, screenCol) };
+    }
+    selectionAutoScrollDirection(screenRow) {
+        if (!this.selectionAnchor ||
+            !this.selectionHead ||
+            (this.selectionMode !== "transcript" && this.selectionMode !== "table"))
+            return null;
+        const bounds = this.transcriptScreenBounds();
+        if (!bounds)
+            return null;
+        if (this.selectionHead.line < this.selectionAnchor.line && screenRow <= bounds.firstRow && this.scrollTop > 0) {
+            return -1;
+        }
+        if (this.selectionHead.line > this.selectionAnchor.line &&
+            screenRow >= bounds.lastRow &&
+            this.scrollTop < this.lastMaxScroll) {
+            return 1;
+        }
+        return null;
+    }
+    scrollSelection(direction, screenCol) {
+        if (!this.selectionAnchor || (this.selectionMode !== "transcript" && this.selectionMode !== "table"))
+            return false;
+        const previousScrollTop = this.scrollTop;
+        this.scrollBy(direction);
+        if (this.scrollTop === previousScrollTop)
+            return false;
+        const bounds = this.transcriptScreenBounds();
+        if (!bounds)
+            return false;
+        this.extendSelection(direction === -1 ? bounds.firstRow : bounds.lastRow, screenCol);
+        return true;
+    }
+    /** Finish the selection and return its plain text (null when empty). */
+    endSelection() {
+        if (this.selectionMode !== "transcript" && this.selectionMode !== "table") {
+            this.clearSelection();
+            return null;
+        }
+        const sel = this.orderedSelection();
+        const text = sel
+            ? this.selectionMode === "table"
+                ? this.extractTableSelectionText(this.lastTranscript, sel)
+                : this.extractSelectionText(this.lastTranscript, sel)
+            : null;
+        this.clearSelection();
+        return text;
+    }
+    extendActiveSelection(screenRow, screenCol) {
+        if (this.selectionMode === "frame") {
+            this.extendFrameSelection(screenRow, screenCol);
+        }
+        else if (this.selectionMode === "transcript" || this.selectionMode === "table") {
+            this.extendSelection(screenRow, screenCol);
+        }
+    }
+    endActiveSelection() {
+        if (this.selectionMode === "frame") {
+            return this.endFrameSelection();
+        }
+        if (this.selectionMode === "transcript" || this.selectionMode === "table") {
+            return this.endSelection();
+        }
+        this.clearSelection();
+        return null;
+    }
+    /** Snapshot and highlight the final screen frame for overlay/dock selection. */
+    applyFrameSelection(frame, height, selectableRegions) {
+        this.lastFrame = frame;
+        this.lastFrameVisibleHeight = Math.min(Math.max(0, height), frame.length);
+        this.lastFrameVisibleStart = Math.max(0, frame.length - this.lastFrameVisibleHeight);
+        this.frameSelectionRegions = selectableRegions;
+        if (this.selectionMode !== "frame")
+            return;
+        const sel = this.orderedSelection();
+        if (!sel)
+            return;
+        for (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {
+            let line = frame[lineIndex];
+            if (line === undefined)
+                continue;
+            const spans = this.selectedFrameSpans(lineIndex, sel);
+            for (let i = spans.length - 1; i >= 0; i--) {
+                line = this.highlightLine(line, spans[i]);
+            }
+            frame[lineIndex] = line;
+        }
+    }
+    beginFrameSelection(screenRow, screenCol) {
+        const point = this.framePoint(screenRow, screenCol);
+        if (!point || !this.isFrameSelectable(point)) {
+            this.clearSelection();
+            return false;
+        }
+        this.activeFrameSelection = {
+            frame: [...this.lastFrame],
+            regions: this.frameSelectionRegions.map((region) => ({ ...region })),
+            visibleStart: this.lastFrameVisibleStart,
+            visibleHeight: this.lastFrameVisibleHeight,
+        };
+        this.selectionAnchor = point;
+        this.selectionHead = { ...point };
+        this.selectionMode = "frame";
+        return true;
+    }
+    extendFrameSelection(screenRow, screenCol) {
+        if (!this.selectionAnchor || this.selectionMode !== "frame")
+            return;
+        const point = this.framePoint(screenRow, screenCol, this.activeFrameSelection);
+        if (!point)
+            return;
+        const clamped = this.clampFrameSelectionPoint(point);
+        if (!clamped)
+            return;
+        this.selectionHead = clamped;
+    }
+    endFrameSelection() {
+        if (this.selectionMode !== "frame") {
+            this.clearSelection();
+            return null;
+        }
+        const sel = this.orderedSelection();
+        const active = this.activeFrameSelection;
+        const sourceLines = active?.frame ?? this.lastFrame;
+        const regions = active?.regions ?? this.frameSelectionRegions;
+        this.clearSelection();
+        if (!sel)
+            return null;
+        return this.extractFrameSelectionText(sourceLines, regions, sel);
+    }
+    highlightLine(line, span) {
+        const width = visibleWidth(line);
+        const from = Math.min(span.from, width);
+        const to = Math.min(span.to, width);
+        if (to <= from)
+            return line;
+        const before = sliceByColumn(line, 0, from);
+        const selected = stripAnsi(sliceByColumn(line, from, to - from));
+        const after = sliceByColumn(line, to, Math.max(0, width - to));
+        return `${before}\x1b[0m\x1b[7m${selected}\x1b[27m${after}`;
+    }
+    framePoint(screenRow, screenCol, snapshot = null) {
+        const visibleHeight = snapshot?.visibleHeight ?? this.lastFrameVisibleHeight;
+        if (visibleHeight === 0)
+            return null;
+        const visibleStart = snapshot?.visibleStart ?? this.lastFrameVisibleStart;
+        const frameLength = snapshot?.frame.length ?? this.lastFrame.length;
+        const row = Math.max(0, Math.min(screenRow, visibleHeight - 1));
+        const line = visibleStart + row;
+        if (line < 0 || line >= frameLength)
+            return null;
+        return { line, col: Math.max(0, screenCol) };
+    }
+    transcriptScreenBounds() {
+        if (this.lastWindowHeight <= 0)
+            return null;
+        const visibleHeight = this.lastFrameVisibleHeight > 0 ? this.lastFrameVisibleHeight : this.lastWindowHeight;
+        if (visibleHeight <= 0)
+            return null;
+        const visibleStart = this.lastFrameVisibleHeight > 0 ? this.lastFrameVisibleStart : 0;
+        const visibleEnd = visibleStart + visibleHeight - 1;
+        const transcriptStart = Math.max(0, visibleStart);
+        const transcriptEnd = Math.min(this.lastWindowHeight - 1, visibleEnd);
+        if (transcriptStart > transcriptEnd)
+            return null;
+        return {
+            firstRow: transcriptStart - visibleStart,
+            lastRow: transcriptEnd - visibleStart,
+            visibleStart,
+            visibleHeight,
+            transcriptStart,
+            transcriptEnd,
+        };
+    }
+    transcriptLineForScreenRow(screenRow, clamp) {
+        const bounds = this.transcriptScreenBounds();
+        if (!bounds)
+            return null;
+        if (!clamp && (screenRow < 0 || screenRow >= bounds.visibleHeight))
+            return null;
+        const row = clamp ? Math.max(0, Math.min(screenRow, bounds.visibleHeight - 1)) : screenRow;
+        const frameLine = bounds.visibleStart + row;
+        if (!clamp && (frameLine < bounds.transcriptStart || frameLine > bounds.transcriptEnd))
+            return null;
+        return this.scrollTop + Math.max(bounds.transcriptStart, Math.min(frameLine, bounds.transcriptEnd));
+    }
+    isFrameSelectable(point) {
+        return this.frameSelectionRegions.some((region) => region.line === point.line && point.col >= region.col && point.col < region.col + region.width);
+    }
+    tableRegions(table) {
+        return this.tableCellSelectionRegions.filter((region) => region.table === table);
+    }
+    tableAtPoint(point) {
+        const tables = new Set(this.tableCellSelectionRegions.map((region) => region.table));
+        for (const table of tables) {
+            const region = this.tableRegions(table)[0];
+            if (region &&
+                point.line >= region.tableTop &&
+                point.line <= region.tableBottom &&
+                point.col >= Math.max(0, region.tableLeft - 1) &&
+                point.col <= region.tableRight) {
+                return table;
+            }
+        }
+        return null;
+    }
+    closestTableCell(table, point) {
+        let closest = null;
+        let closestLineDistance = Number.POSITIVE_INFINITY;
+        let closestColumnDistance = Number.POSITIVE_INFINITY;
+        for (const region of this.tableRegions(table)) {
+            const lineDistance = Math.abs(point.line - region.line);
+            const end = region.col + region.width;
+            const columnDistance = point.col < region.col ? region.col - point.col : point.col > end ? point.col - end : 0;
+            if (lineDistance < closestLineDistance ||
+                (lineDistance === closestLineDistance && columnDistance < closestColumnDistance)) {
+                closest = { row: region.row, column: region.column };
+                closestLineDistance = lineDistance;
+                closestColumnDistance = columnDistance;
+            }
+        }
+        return closest;
+    }
+    activeTableRange() {
+        const active = this.activeTableSelection;
+        const head = this.selectionHead;
+        if (!active || !head)
+            return null;
+        const headCell = this.closestTableCell(active.table, head);
+        if (!headCell)
+            return null;
+        return {
+            fromRow: Math.min(active.anchor.row, headCell.row),
+            toRow: Math.max(active.anchor.row, headCell.row),
+            fromColumn: Math.min(active.anchor.column, headCell.column),
+            toColumn: Math.max(active.anchor.column, headCell.column),
+        };
+    }
+    selectedTableSpans(lineIndex, sel) {
+        const active = this.activeTableSelection;
+        const range = this.activeTableRange();
+        if (!active || !range)
+            return [];
+        const singleCell = range.fromRow === range.toRow && range.fromColumn === range.toColumn;
+        const selectionSpan = singleCell ? this.selectionSpan(lineIndex, sel) : null;
+        if (singleCell && !selectionSpan)
+            return [];
+        const spans = [];
+        for (const region of this.tableCellSelectionRegions) {
+            if (region.line !== lineIndex ||
+                region.table !== active.table ||
+                region.row < range.fromRow ||
+                region.row > range.toRow ||
+                region.column < range.fromColumn ||
+                region.column > range.toColumn)
+                continue;
+            const from = selectionSpan ? Math.max(selectionSpan.from, region.col) : region.col;
+            const to = selectionSpan ? Math.min(selectionSpan.to, region.col + region.width) : region.col + region.width;
+            if (to > from)
+                spans.push({ from, to });
+        }
+        return spans.sort((a, b) => a.from - b.from);
+    }
+    frameRegionsForLine(line, regions = this.activeFrameSelection?.regions ?? this.frameSelectionRegions) {
+        return regions.filter((region) => region.line === line && region.width > 0).sort((a, b) => a.col - b.col);
+    }
+    clampFrameSelectionPoint(point) {
+        const regions = this.frameRegionsForLine(point.line);
+        if (regions.length === 0)
+            return null;
+        let closest = regions[0].col;
+        let distance = Number.POSITIVE_INFINITY;
+        for (const region of regions) {
+            const start = region.col;
+            const end = region.col + region.width;
+            if (point.col >= start && point.col <= end) {
+                return { line: point.line, col: Math.max(start, Math.min(point.col, end)) };
+            }
+            for (const col of [start, end]) {
+                const nextDistance = Math.abs(point.col - col);
+                if (nextDistance < distance) {
+                    closest = col;
+                    distance = nextDistance;
+                }
+            }
+        }
+        return { line: point.line, col: closest };
+    }
+    selectedFrameSpans(lineIndex, sel, regions = this.activeFrameSelection?.regions ?? this.frameSelectionRegions) {
+        const span = this.selectionSpan(lineIndex, sel);
+        if (!span)
+            return [];
+        const spans = [];
+        for (const region of this.frameRegionsForLine(lineIndex, regions)) {
+            const from = Math.max(span.from, region.col);
+            const to = Math.min(span.to, region.col + region.width);
+            if (to > from)
+                spans.push({ from, to });
+        }
+        return spans;
+    }
+    extractFrameSelectionText(sourceLines, regions, sel) {
+        const lines = [];
+        for (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {
+            const line = sourceLines[lineIndex] ?? "";
+            const spans = this.selectedFrameSpans(lineIndex, sel, regions);
+            if (spans.length === 0)
+                continue;
+            const parts = [];
+            for (const span of spans) {
+                parts.push(stripAnsi(sliceByColumn(line, span.from, Math.max(0, span.to - span.from))));
+            }
+            lines.push(parts.join("").trimEnd());
+        }
+        const text = lines.join("\n");
+        return text.trim().length > 0 ? text : null;
+    }
+    extractSelectionText(sourceLines, sel) {
+        const lines = [];
+        for (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {
+            const line = sourceLines[lineIndex] ?? "";
+            const span = this.selectionSpan(lineIndex, sel);
+            if (!span)
+                continue;
+            const width = visibleWidth(line);
+            const from = Math.min(span.from, width);
+            const to = Math.min(span.to, width);
+            lines.push(stripAnsi(sliceByColumn(line, from, Math.max(0, to - from))).trimEnd());
+        }
+        const text = lines.join("\n");
+        return text.trim().length > 0 ? text : null;
+    }
+    compareSelectionPoints(a, b) {
+        return a.line === b.line ? a.col - b.col : a.line - b.line;
+    }
+    extractTableSelectionText(sourceLines, sel) {
+        const active = this.activeTableSelection;
+        const range = this.activeTableRange();
+        if (!active || !range)
+            return null;
+        if (range.fromRow !== range.toRow || range.fromColumn !== range.toColumn) {
+            const contents = new Map();
+            for (const region of this.tableRegions(active.table)) {
+                contents.set(`${region.row}:${region.column}`, region.content);
+            }
+            const rows = [];
+            for (let row = range.fromRow; row <= range.toRow; row++) {
+                const cells = [];
+                for (let column = range.fromColumn; column <= range.toColumn; column++) {
+                    cells.push(contents.get(`${row}:${column}`) ?? "");
+                }
+                rows.push(cells.join("\t"));
+            }
+            const text = rows.join("\n");
+            return text.trim().length > 0 ? text : null;
+        }
+        const cellRegions = this.tableRegions(active.table)
+            .filter((region) => region.row === range.fromRow && region.column === range.fromColumn)
+            .sort((a, b) => a.line - b.line || a.segment - b.segment);
+        const first = cellRegions[0];
+        const last = cellRegions.at(-1);
+        if (first && last) {
+            const cellStart = { line: first.line, col: first.col };
+            const cellEnd = { line: last.line, col: last.col + last.width };
+            if (this.compareSelectionPoints(sel.start, cellStart) <= 0 &&
+                this.compareSelectionPoints(sel.end, cellEnd) >= 0) {
+                return first.content.trim().length > 0 ? first.content : null;
+            }
+        }
+        const lines = [];
+        for (let lineIndex = sel.start.line; lineIndex <= sel.end.line; lineIndex++) {
+            const line = sourceLines[lineIndex] ?? "";
+            const spans = this.selectedTableSpans(lineIndex, sel);
+            if (spans.length === 0)
+                continue;
+            const parts = spans.map((span) => stripAnsi(sliceByColumn(line, span.from, Math.max(0, span.to - span.from))));
+            lines.push(parts.join("").trimEnd());
+        }
+        const text = lines.join("\n");
+        return text.trim().length > 0 ? text : null;
+    }
+    clearSelection() {
+        this.selectionAnchor = null;
+        this.selectionHead = null;
+        this.selectionMode = null;
+        this.activeFrameSelection = null;
+        this.activeTableSelection = null;
+    }
+    hasSelection() {
+        return this.orderedSelection() !== null;
+    }
+    /**
+     * OSC 8 hyperlink URL at a screen position in the last painted frame, or
+     * null when the position is not over a hyperlink. Covers the transcript
+     * window, the dock, and composited overlays.
+     */
+    hyperlinkAt(screenRow, screenCol) {
+        if (screenRow < 0 || screenCol < 0 || this.lastFrameVisibleHeight === 0)
+            return null;
+        if (screenRow >= this.lastFrameVisibleHeight)
+            return null;
+        const line = this.lastFrame[this.lastFrameVisibleStart + screenRow];
+        if (line === undefined || isImageLine(line))
+            return null;
+        return urlAtColumn(line, screenCol);
+    }
+    /** Row-diff a composed frame against the previous one with absolute addressing. */
+    paint(write, frame, width, height, cursorPos) {
+        if (frame.length > height) {
+            frame = frame.slice(frame.length - height);
+        }
+        let buffer = "\x1b[?2026h";
+        if (width !== this.prevWidth || height !== this.prevHeight || this.prevFrame.length === 0) {
+            buffer += "\x1b[2J\x1b[H";
+            this.prevFrame = [];
+        }
+        for (let row = 0; row < height; row++) {
+            const line = frame[row] ?? "";
+            if (this.prevFrame[row] === line)
+                continue;
+            buffer += `\x1b[${row + 1};1H\x1b[2K`;
+            // an overwide line would wrap and shear the grid; clamp instead of crash
+            buffer += visibleWidth(line) > width ? sliceByColumn(line, 0, width, true) : line;
+        }
+        if (cursorPos) {
+            buffer += `\x1b[${Math.min(cursorPos.row, height - 1) + 1};${cursorPos.col + 1}H`;
+        }
+        buffer += "\x1b[?2026l";
+        write(buffer);
+        this.prevFrame = frame;
+        this.prevWidth = width;
+        this.prevHeight = height;
+    }
+    /** Force the next paint to clear and repaint the whole screen. */
+    reset() {
+        this.prevFrame = [];
+    }
+    /** Scrolling up pauses following; reaching the bottom resumes it. */
+    scrollBy(delta) {
+        const base = this.following ? this.lastMaxScroll : this.scrollTop;
+        this.scrollTop = Math.max(0, Math.min(base + delta, this.lastMaxScroll));
+        this.following = this.scrollTop >= this.lastMaxScroll;
+    }
+    scrollToTop() {
+        this.scrollTop = 0;
+        this.following = this.lastMaxScroll === 0;
+    }
+    scrollToBottom() {
+        this.scrollTop = this.lastMaxScroll;
+        this.following = true;
+    }
+    pageSize() {
+        return Math.max(1, this.lastWindowHeight - 1);
+    }
+    windowHeight() {
+        return this.lastWindowHeight;
+    }
+    isFollowing() {
+        return this.following;
+    }
+    scrollInfo() {
+        return {
+            following: this.following,
+            linesBelow: Math.max(0, this.lastMaxScroll - this.scrollTop),
+            linesAbove: this.scrollTop,
+        };
+    }
+}
+//# sourceMappingURL=fullscreen.js.map