@visual-z/xeno 0.2.0 → 0.3.0

package/src/vendor/pi-tui/layout-node.ts

@@ -1,51 +0,0 @@
-import type { Component } from "./tui.ts";
-
-export const LAYOUT_NODE = Symbol.for("@earendil-works/pi-tui/layout-node");
-
-export interface LayoutViewport {
-	width: number;
-	height: number;
-}
-
-export interface StackLayoutEntry {
-	component: Component;
-	basis?: number | "auto";
-	grow?: number;
-	shrink?: number;
-	minSize?: number;
-	maxSize?: number;
-	visible?: (viewport: LayoutViewport) => boolean;
-}
-
-export interface StackLayoutNode {
-	type: "vstack" | "hstack";
-	entries: readonly StackLayoutEntry[];
-	gap: number;
-	align: "stretch" | "start" | "center" | "end";
-}
-
-export interface ScrollLayoutState {
-	readonly scrollTop: number;
-	readonly primary: boolean;
-	readonly overscroll: "chain" | "contain";
-	readonly viewportHeight: number;
-	getContentWidth(width: number): number;
-	updateLayout(contentHeight: number, viewportHeight: number, requestRender: () => void): void;
-}
-
-export interface ScrollLayoutNode {
-	type: "scroll";
-	component: Component;
-	state: ScrollLayoutState;
-}
-
-export type LayoutNode = StackLayoutNode | ScrollLayoutNode;
-
-export interface LayoutComponent extends Component {
-	[LAYOUT_NODE](): LayoutNode;
-}
-
-export function getLayoutNode(component: Component): LayoutNode | undefined {
-	const candidate = component as Partial<LayoutComponent>;
-	return typeof candidate[LAYOUT_NODE] === "function" ? candidate[LAYOUT_NODE]() : undefined;
-}

package/src/vendor/pi-tui/layout.ts

@@ -1,449 +0,0 @@
-import type { ScrollView } from "./components/scroll-view.ts";
-import { allocateStackSizes, visibleStackEntries } from "./components/stack.ts";
-import { getLayoutNode } from "./layout-node.ts";
-import { cropKittyImageLine, getKittyImageMetadata, isImageLine } from "./terminal-image.ts";
-import { type Component, CURSOR_MARKER, compositeTuiLine } from "./tui.ts";
-import {
-	extractAnsiCode,
-	getActiveBackgroundAnsi,
-	getGraphemeCellRange,
-	sliceByColumn,
-	visibleWidth,
-} from "./utils.ts";
-
-const OSC133_ZONE_PREFIX = /^(?:\x1b\]133;[ABC](?:\x07|\x1b\\))+/;
-
-export interface LayoutRect {
-	x: number;
-	y: number;
-	width: number;
-	height: number;
-}
-
-export interface LayoutBox {
-	component: Component;
-	rect: LayoutRect;
-	clip: LayoutRect;
-	children: LayoutBox[];
-	parent?: LayoutBox;
-	lines?: readonly string[];
-	lineOffset?: number;
-	scrollView?: ScrollView;
-	scrollContentLines?: readonly string[];
-	layer: number;
-}
-
-export interface LayoutFrame {
-	root: LayoutBox;
-	width: number;
-	height: number;
-	lines: string[];
-	primaryScrollView?: ScrollView;
-}
-
-export interface ScrollbarGeometry {
-	column: number;
-	trackTop: number;
-	trackHeight: number;
-	thumbTop: number;
-	thumbHeight: number;
-	maxScrollTop: number;
-}
-
-interface LayoutContext {
-	viewport: { width: number; height: number };
-	renderCache: Map<Component, Map<number, string[]>>;
-	requestRender: () => void;
-	primaryScrollView: ScrollView | undefined;
-}
-
-function intersect(a: LayoutRect, b: LayoutRect): LayoutRect {
-	const x = Math.max(a.x, b.x);
-	const y = Math.max(a.y, b.y);
-	const right = Math.min(a.x + a.width, b.x + b.width);
-	const bottom = Math.min(a.y + a.height, b.y + b.height);
-	return { x, y, width: Math.max(0, right - x), height: Math.max(0, bottom - y) };
-}
-
-function renderCached(context: LayoutContext, component: Component, width: number): string[] {
-	const safeWidth = Math.max(1, Math.floor(width));
-	let widths = context.renderCache.get(component);
-	if (!widths) {
-		widths = new Map<number, string[]>();
-		context.renderCache.set(component, widths);
-	}
-	let lines = widths.get(safeWidth);
-	if (!lines) {
-		lines = component.render(safeWidth);
-		widths.set(safeWidth, lines);
-	}
-	return lines;
-}
-
-function measureHeight(context: LayoutContext, component: Component, width: number): number {
-	return renderCached(context, component, width).length;
-}
-
-function measureWidth(context: LayoutContext, component: Component, width: number): number {
-	return renderCached(context, component, width).reduce((max, line) => Math.max(max, visibleWidth(line)), 0);
-}
-
-function withParent(box: LayoutBox, parent: LayoutBox): LayoutBox {
-	box.parent = parent;
-	return box;
-}
-
-function translateBox(box: LayoutBox, deltaY: number): void {
-	box.rect.y += deltaY;
-	for (const child of box.children) translateBox(child, deltaY);
-}
-
-function updateClips(box: LayoutBox, parentClip: LayoutRect): void {
-	box.clip = intersect(parentClip, box.rect);
-	for (const child of box.children) updateClips(child, box.clip);
-}
-
-function layoutComponent(
-	context: LayoutContext,
-	component: Component,
-	x: number,
-	y: number,
-	width: number,
-	height: number | undefined,
-	clip: LayoutRect,
-): LayoutBox {
-	const safeWidth = Math.max(1, Math.floor(width));
-	const node = getLayoutNode(component);
-	if (!node) {
-		const lines = renderCached(context, component, safeWidth);
-		const allocatedHeight = height === undefined ? lines.length : Math.max(0, Math.floor(height));
-		let lineOffset = 0;
-		if (lines.length > allocatedHeight && allocatedHeight > 0) {
-			const cursorLine = lines.findIndex((line) => line.includes(CURSOR_MARKER));
-			if (cursorLine >= allocatedHeight) lineOffset = cursorLine - allocatedHeight + 1;
-		}
-		return {
-			component,
-			rect: { x, y, width: safeWidth, height: allocatedHeight },
-			clip: intersect(clip, { x, y, width: safeWidth, height: allocatedHeight }),
-			children: [],
-			lines,
-			lineOffset,
-			layer: 0,
-		};
-	}
-
-	if (node.type === "scroll") {
-		const previousScrollTop = node.state.scrollTop;
-		const contentWidth = node.state.getContentWidth(safeWidth);
-		const childBox = layoutComponent(
-			context,
-			node.component,
-			x,
-			y - previousScrollTop,
-			contentWidth,
-			undefined,
-			clip,
-		);
-		const contentHeight = childBox.rect.height;
-		const viewportHeight = height === undefined ? contentHeight : Math.max(0, Math.floor(height));
-		node.state.updateLayout(contentHeight, viewportHeight, context.requestRender);
-		translateBox(childBox, previousScrollTop - node.state.scrollTop);
-		const scrollView = node.state as ScrollView;
-		if (node.state.primary || !context.primaryScrollView) context.primaryScrollView = scrollView;
-		const rect = { x, y, width: safeWidth, height: viewportHeight };
-		const childClip = intersect(clip, rect);
-		const box: LayoutBox = {
-			component,
-			rect,
-			clip: childClip,
-			children: [childBox],
-			scrollView,
-			scrollContentLines: renderCached(context, node.component, contentWidth),
-			layer: 0,
-		};
-		childBox.parent = box;
-		updateClips(childBox, childClip);
-		return box;
-	}
-
-	const entries = visibleStackEntries(node.entries, context.viewport);
-	const gapTotal = Math.max(0, entries.length - 1) * node.gap;
-	if (node.type === "vstack") {
-		const intrinsicHeights = entries.map((entry) =>
-			typeof entry.basis === "number" ? entry.basis : measureHeight(context, entry.component, safeWidth),
-		);
-		const sizes = allocateStackSizes(entries, intrinsicHeights, height, node.gap);
-		const naturalHeight = sizes.reduce((sum, size) => sum + size, 0) + gapTotal;
-		const allocatedHeight = height === undefined ? naturalHeight : Math.max(0, Math.floor(height));
-		const rect = { x, y, width: safeWidth, height: allocatedHeight };
-		const box: LayoutBox = {
-			component,
-			rect,
-			clip: intersect(clip, rect),
-			children: [],
-			layer: 0,
-		};
-		let childY = y;
-		for (let index = 0; index < entries.length; index++) {
-			box.children.push(
-				withParent(
-					layoutComponent(context, entries[index]!.component, x, childY, safeWidth, sizes[index]!, box.clip),
-					box,
-				),
-			);
-			childY += sizes[index]! + node.gap;
-		}
-		return box;
-	}
-
-	const intrinsicWidths = entries.map((entry) =>
-		typeof entry.basis === "number" ? entry.basis : measureWidth(context, entry.component, safeWidth),
-	);
-	const widths = allocateStackSizes(entries, intrinsicWidths, safeWidth, node.gap);
-	const intrinsicHeights = entries.map((entry, index) =>
-		measureHeight(context, entry.component, Math.max(1, widths[index]!)),
-	);
-	const allocatedHeight =
-		height === undefined
-			? intrinsicHeights.reduce((max, childHeight) => Math.max(max, childHeight), 0)
-			: Math.max(0, height);
-	const rect = { x, y, width: safeWidth, height: allocatedHeight };
-	const box: LayoutBox = {
-		component,
-		rect,
-		clip: intersect(clip, rect),
-		children: [],
-		layer: 0,
-	};
-	let childX = x;
-	for (let index = 0; index < entries.length; index++) {
-		const naturalChildHeight = intrinsicHeights[index]!;
-		const childHeight = node.align === "stretch" ? allocatedHeight : Math.min(allocatedHeight, naturalChildHeight);
-		let childY = y;
-		if (node.align === "center") childY += Math.floor((allocatedHeight - childHeight) / 2);
-		else if (node.align === "end") childY += allocatedHeight - childHeight;
-		const childWidth = widths[index]!;
-		if (childWidth === 0) {
-			box.children.push({
-				component: entries[index]!.component,
-				rect: { x: childX, y: childY, width: 0, height: childHeight },
-				clip: { x: childX, y: childY, width: 0, height: 0 },
-				children: [],
-				parent: box,
-				layer: 0,
-			});
-		} else {
-			box.children.push(
-				withParent(
-					layoutComponent(context, entries[index]!.component, childX, childY, childWidth, childHeight, box.clip),
-					box,
-				),
-			);
-		}
-		childX += childWidth + node.gap;
-	}
-	return box;
-}
-
-function replaceScrollbarCell(
-	line: string,
-	column: number,
-	totalWidth: number,
-	replacement: string,
-	preserveTargetBackground: boolean,
-): string {
-	if (isImageLine(line)) return line;
-
-	const graphemeRange = getGraphemeCellRange(line, column);
-	const start = graphemeRange?.start ?? column;
-	const end = graphemeRange?.end ?? column + 1;
-	const before = sliceByColumn(line, 0, start, true);
-	const target = sliceByColumn(line, start, end - start, true);
-	const after = sliceByColumn(line, end, Math.max(0, totalWidth - end), true);
-
-	let targetPrefix = "";
-	let targetIndex = 0;
-	while (targetIndex < target.length) {
-		const ansi = extractAnsiCode(target, targetIndex);
-		if (!ansi) break;
-		targetPrefix += ansi.code;
-		targetIndex += ansi.length;
-	}
-	const beforePadding = " ".repeat(Math.max(0, start - visibleWidth(before)));
-	const cellPaddingBefore = " ".repeat(Math.max(0, column - start));
-	const cellPaddingAfter = " ".repeat(Math.max(0, end - column - 1));
-	const targetStyle = `\x1b[0m\x1b]8;;\x07${preserveTargetBackground ? getActiveBackgroundAnsi(targetPrefix) : ""}`;
-	return `${before}${beforePadding}${targetStyle}${cellPaddingBefore}${replacement}${cellPaddingAfter}${after}`;
-}
-
-export function getScrollbarGeometry(box: LayoutBox, includeHiddenAuto = false): ScrollbarGeometry | undefined {
-	if (!box.scrollView || box.rect.width <= 0 || box.rect.height <= 0) return undefined;
-
-	const contentHeight = box.children[0]?.rect.height ?? box.scrollContentLines?.length ?? 0;
-	const trackHeight = box.rect.height;
-	const canRevealHiddenAuto = includeHiddenAuto && box.scrollView.scrollbar === "auto" && contentHeight > trackHeight;
-	if (!box.scrollView.isScrollbarVisible && !canRevealHiddenAuto) return undefined;
-
-	const minThumbHeight = Math.min(2, trackHeight);
-	const thumbHeight = Math.max(
-		minThumbHeight,
-		Math.min(trackHeight, Math.round((trackHeight * trackHeight) / contentHeight)),
-	);
-	const maxScrollTop = Math.max(0, contentHeight - trackHeight);
-	const maxThumbTop = trackHeight - thumbHeight;
-	const thumbOffset = maxScrollTop === 0 ? 0 : Math.round((box.scrollView.scrollTop / maxScrollTop) * maxThumbTop);
-	const column = box.rect.x + box.rect.width - 1;
-	if (column < box.clip.x || column >= box.clip.x + box.clip.width) return undefined;
-
-	return {
-		column,
-		trackTop: box.rect.y,
-		trackHeight,
-		thumbTop: box.rect.y + thumbOffset,
-		thumbHeight,
-		maxScrollTop,
-	};
-}
-
-function paintScrollbar(box: LayoutBox, screen: string[], totalWidth: number): void {
-	const geometry = getScrollbarGeometry(box);
-	if (!geometry || !box.scrollView) return;
-
-	for (let offset = 0; offset < geometry.trackHeight; offset++) {
-		const row = geometry.trackTop + offset;
-		if (row < box.clip.y || row >= box.clip.y + box.clip.height || row < 0 || row >= screen.length) continue;
-		const isThumb = row >= geometry.thumbTop && row < geometry.thumbTop + geometry.thumbHeight;
-		const replacement = isThumb
-			? box.scrollView.scrollbarThumbStyle(box.scrollView.isScrollbarActive ? "█" : "┃")
-			: box.scrollView.scrollbarTrackStyle("│");
-		screen[row] = replaceScrollbarCell(
-			screen[row] ?? "",
-			geometry.column,
-			totalWidth,
-			replacement,
-			box.scrollView.scrollbar !== "always",
-		);
-	}
-}
-
-function paintBox(box: LayoutBox, screen: string[], totalWidth: number): void {
-	if (box.lines) {
-		const offset = box.lineOffset ?? 0;
-		const firstRow = Math.max(box.rect.y, box.clip.y, 0);
-		const lastRow = Math.min(box.rect.y + box.rect.height, box.clip.y + box.clip.height, screen.length);
-		for (let row = firstRow; row < lastRow; row++) {
-			const sourceLine = box.lines[offset + row - box.rect.y];
-			if (sourceLine === undefined) continue;
-			let line = sourceLine.replace(OSC133_ZONE_PREFIX, "");
-			const imageMetadata = getKittyImageMetadata(line);
-			if (imageMetadata) {
-				const clipBottom = Math.min(screen.length, box.clip.y + box.clip.height);
-				const visibleRows = Math.min(imageMetadata.rows, clipBottom - row);
-				if (visibleRows < imageMetadata.rows) line = cropKittyImageLine(line, 0, visibleRows);
-			}
-			// Fast path: a full-width box painting onto an untouched row can use the
-			// source line reference directly. Compositing here would rebuild the row
-			// string through ANSI/grapheme segmentation every frame; padding is
-			// unnecessary because rows are written with erase-line and the final
-			// width clamp still truncates over-wide lines.
-			if (box.rect.x === 0 && box.rect.width >= totalWidth && (isImageLine(line) || !screen[row])) {
-				screen[row] = line;
-			} else {
-				screen[row] = compositeTuiLine(screen[row] ?? "", line, box.rect.x, box.rect.width, totalWidth);
-			}
-		}
-	}
-	for (const child of box.children) paintBox(child, screen, totalWidth);
-
-	if (box.scrollView && box.scrollContentLines && box.scrollView.scrollTop > 0 && box.rect.height > 0) {
-		for (let imageRow = box.scrollView.scrollTop - 1; imageRow >= 0; imageRow--) {
-			const imageLine = box.scrollContentLines[imageRow] ?? "";
-			const metadata = getKittyImageMetadata(imageLine);
-			if (metadata) {
-				const hiddenRows = box.scrollView.scrollTop - imageRow;
-				if (hiddenRows < metadata.rows) {
-					const visibleRows = Math.min(box.rect.height, metadata.rows - hiddenRows);
-					const cropped = cropKittyImageLine(imageLine, hiddenRows, visibleRows);
-					if (box.rect.x === 0 && box.rect.width >= totalWidth) screen[box.rect.y] = cropped;
-				}
-				break;
-			}
-			if (imageLine !== "") break;
-		}
-	}
-
-	paintScrollbar(box, screen, totalWidth);
-}
-
-export function renderLayoutFrame(
-	root: Component,
-	width: number,
-	height: number,
-	requestRender: () => void,
-): LayoutFrame {
-	const safeWidth = Math.max(1, Math.floor(width));
-	const safeHeight = Math.max(1, Math.floor(height));
-	const context: LayoutContext = {
-		viewport: { width: safeWidth, height: safeHeight },
-		renderCache: new Map(),
-		requestRender,
-		primaryScrollView: undefined,
-	};
-	const rootBox = layoutComponent(context, root, 0, 0, safeWidth, safeHeight, {
-		x: 0,
-		y: 0,
-		width: safeWidth,
-		height: safeHeight,
-	});
-	const lines = Array.from({ length: safeHeight }, () => "");
-	paintBox(rootBox, lines, safeWidth);
-	return {
-		root: rootBox,
-		width: safeWidth,
-		height: safeHeight,
-		lines,
-		...(context.primaryScrollView === undefined ? {} : { primaryScrollView: context.primaryScrollView }),
-	};
-}
-
-function containsPoint(rect: LayoutRect, x: number, y: number): boolean {
-	return x >= rect.x && x < rect.x + rect.width && y >= rect.y && y < rect.y + rect.height;
-}
-
-/** Return the visual hit path from the deepest component to the layout root. */
-export function getLayoutBoxesAt(frame: LayoutFrame, x: number, y: number): LayoutBox[] {
-	const result: Array<{ box: LayoutBox; depth: number }> = [];
-	const visit = (box: LayoutBox, depth: number): void => {
-		if (!containsPoint(box.clip, x, y)) return;
-		result.push({ box, depth });
-		for (const child of box.children) visit(child, depth + 1);
-	};
-	visit(frame.root, 0);
-	result.sort((a, b) => b.box.layer - a.box.layer || b.depth - a.depth);
-	return result.map(({ box }) => box);
-}
-
-export function getScrollViewBox(frame: LayoutFrame, scrollView: ScrollView): LayoutBox | undefined {
-	const visit = (box: LayoutBox): LayoutBox | undefined => {
-		if (box.scrollView === scrollView) return box;
-		for (const child of box.children) {
-			const match = visit(child);
-			if (match) return match;
-		}
-		return undefined;
-	};
-	return visit(frame.root);
-}
-
-export function getScrollViewsAt(frame: LayoutFrame, x: number, y: number): ScrollView[] {
-	const result: Array<{ scrollView: ScrollView; depth: number }> = [];
-	const visit = (box: LayoutBox, depth: number): void => {
-		if (!containsPoint(box.clip, x, y)) return;
-		if (box.scrollView && containsPoint(box.rect, x, y)) result.push({ scrollView: box.scrollView, depth });
-		for (const child of box.children) visit(child, depth + 1);
-	};
-	visit(frame.root, 0);
-	result.sort((a, b) => b.depth - a.depth);
-	return result.map((entry) => entry.scrollView);
-}

package/src/vendor/pi-tui/native/UPSTREAM.json

@@ -1,23 +0,0 @@
-{
-  "commit": "02eed88fd8912e54a804ddebd409e2e4c08ac5ef",
-  "files": {
-    "clipboard.h": "4e7d0a70f8e530017307816f097d355b94227c4d",
-    "darwin/README.md": "74c5c5911b480e3cffa23b18ec39a00a68fb71bd",
-    "darwin/build.sh": "65f7fa4f8cdc19be744b9519e95687bbb046df0e",
-    "darwin/prebuilds/darwin-arm64/darwin-platform.node": "3294b6bffd36eaab70d61134e9955992f31f9a8f",
-    "darwin/prebuilds/darwin-x64/darwin-platform.node": "014383575508654d9f898ee25631b88db8d9740c",
-    "darwin/src/darwin-platform.m": "5cdd8f9122309f2e4ed0aa107fe1f556b9f8934d",
-    "linux/README.md": "5efdb5cb69af75d5b596423a11a8411138a43ccd",
-    "linux/build.sh": "121b6c45d56020fb2bb78aa6f1a5627f0c094986",
-    "linux/prebuilds/linux-arm64/linux-platform-x11.node": "6d3abc4e33fe4fc8f9029cda1201a3a2aee5c050",
-    "linux/prebuilds/linux-x64/linux-platform-x11.node": "54fcd629b88533ee6c788a830038aa46cf78c1d7",
-    "linux/src/clipboard-worker.h": "93c79d0e7112096b86f38d6fdb1e21c0a72293d4",
-    "linux/src/linux-platform-x11.c": "578a850e43de0c4a00cff4f46c8d1cd31dc74a5f",
-    "napi.h": "816a8202e2fd4d69d3d1f834fbe353b7ef71744a",
-    "win32/README.md": "f3b58607cbaa893d1cdff1b0321ed39e793677ea",
-    "win32/build.mjs": "df1ed206131af71e22d042f5924649e7d742c09b",
-    "win32/prebuilds/win32-arm64/win32-platform.node": "ec330840e70b863b2b0f295437b78378fb8ac84b",
-    "win32/prebuilds/win32-x64/win32-platform.node": "2d0b749b53a17d6049f3e1629c73a847d3851d04",
-    "win32/src/win32-platform.c": "a637dda892b695a525ca2cb6b22ee9a8a55cae59"
-  }
-}