@visual-z/xeno 0.8.4 → 0.9.0

package/src/tui/ui/pictures.ts

@@ -1,108 +0,0 @@
-/**
- * A row of pictures, or the line that stands for them (docs/tasks/feat-tui-inline-images.md).
- *
- * Pictures are drawn by OpenTUI's ImageRenderable (Kitty graphics, Sixel or
- * block characters). Each picture node retains the shared decoded image
- * from the app's cache and lets go of it when the node is destroyed, so a
- * picture that scrolls out of the mounted window frees itself. Where
- * pictures are off, or the terminal can only draw block characters, the
- * row is a single muted line: `▣ shot.png · 1280×720   +2 more`.
- *
- * A click on a drawn picture asks the source to open its full-size original
- * (docs/tasks/feat-tui-image-full-size.md): a thumbnail cannot show a
- * screenshot's text, the system viewer can.
- *
- * The view never reads a file: the app's source loads and verifies bytes.
- */
-import { BoxRenderable, ImageRenderable, type CliRenderer, type ImageRenderProtocol, type NativeImage } from "@opentui/core";
-import { Canvas } from "./canvas.ts";
-import type { UiColors } from "./colors.ts";
-import { splitLine, type Seg } from "./edge.ts";
-import { imageCells, IMAGES_PER_ITEM } from "./image-size.ts";
-import type { ImageView } from "./items.ts";
-
-export interface PictureSource {
-  /** Draw pictures, or only the line that names them. */
-  readonly mode: "picture" | "chip";
-  readonly protocol: ImageRenderProtocol;
-  /** Pixels per terminal cell. */
-  readonly cell: { readonly width: number; readonly height: number };
-  /** The widest a picture may be, in cells (`terminal.imageWidthCells`). */
-  readonly widthCells: number;
-  readonly reason?: string;
-  /** The decoded picture for a blob, shared by every node that shows it, or its preparation failure. */
-  load(sha256: string): Promise<PictureLoad>;
-  /** Show a blob at full size outside the terminal; absent where nothing can (tests, print mode). */
-  open?(sha256: string): void;
-}
-
-export type PictureLoad = { readonly kind: "ready"; readonly image: NativeImage } |
-  { readonly kind: "error"; readonly reason: "missing" | "corrupt" | "decode" | "limit" | "busy" | "closed" };
-
-let serial = 0;
-
-export function chipLine(images: readonly ImageView[], limit: number): Seg[] {
-  const shown = images.slice(0, limit);
-  const segs: Seg[] = [];
-  shown.forEach((image, i) => {
-    if (i) segs.push({ text: "   ", role: "muted" });
-    segs.push({ text: "▣ ", role: "muted" }, { text: image.name, role: "text" }, { text: ` · ${image.width}×${image.height}`, role: "muted" });
-  });
-  if (images.length > shown.length) segs.push({ text: `   +${images.length - shown.length} more`, role: "muted" });
-  return segs;
-}
-
-export class Pictures extends BoxRenderable {
-  readonly pictures: readonly ImageRenderable[];
-
-  constructor(ctx: CliRenderer, colors: UiColors, images: readonly ImageView[], source: PictureSource,
-    options: { maxCols: number; maxRows: number; limit?: number; marginTop?: number; marginLeft?: number }) {
-    const id = `pictures-${serial++}`;
-    super(ctx, { id, flexDirection: "column", flexShrink: 0, marginTop: options.marginTop ?? 0, marginLeft: options.marginLeft ?? 0 });
-    const limit = options.limit ?? IMAGES_PER_ITEM;
-    const shown = images.slice(0, limit);
-    const pictures: ImageRenderable[] = [];
-    const states = shown.map(() => source.mode === "picture" ? "preparing" : source.reason ?? "preview unavailable");
-    const caption = new Canvas(ctx, { id: `${id}-caption`, height: Math.max(1, shown.length), flexShrink: 0, colors });
-    // A long filename must not hide the preparation state or the reason a preview failed.
-    const paintCaption = () => caption.setRows(shown.length ? shown.map((image, i) => splitLine(options.maxCols, [
-      { segs: [{ text: "▣ ", role: "muted" }, { text: image.name, role: "text" }], priority: 0, min: 4, shrinkPriority: 5 },
-      { segs: [{ text: `${image.width}×${image.height}`, role: "muted" }], priority: 3 },
-      ...(i === shown.length - 1 && images.length > shown.length ? [{ segs: [{ text: `+${images.length - shown.length} more`, role: "muted" as const }], priority: 4 }] : []),
-    ], [{ segs: [{ text: states[i]!, role: states[i]?.startsWith("preview failed") ? "warning" : "muted" }], priority: 0 }], 1, [{ text: " · ", role: "muted" }])) : [chipLine(images, limit)]);
-    if (source.mode === "picture" && shown.length) {
-      const row = new BoxRenderable(ctx, { id: `${id}-row`, flexDirection: "row", flexShrink: 0, columnGap: 1 });
-      // Pictures share the width; each keeps its own proportions.
-      const each = Math.max(1, Math.floor((Math.min(options.maxCols, source.widthCells * shown.length) - (shown.length - 1)) / shown.length));
-      for (const [index, image] of shown.entries()) {
-        const size = imageCells(image, Math.min(each, source.widthCells), options.maxRows, source.cell);
-        const picture = new ImageRenderable(ctx, { id: `${id}-${image.sha256.slice(0, 8)}-${serial++}`, width: size.cols, height: size.rows,
-          fit: "fit", protocol: source.protocol, flexShrink: 0,
-          onLoad: () => { states[index] = source.open ? "click to open" : "decoded"; if (!caption.isDestroyed) paintCaption(); },
-          onError: () => { states[index] = "preview failed: decode"; picture.visible = false; if (!caption.isDestroyed) paintCaption(); } });
-        void source.load(image.sha256).then(result => {
-          if (picture.isDestroyed) return;
-          if (result.kind === "ready") picture.source = result.image;
-          else { picture.visible = false; states[index] = `preview failed: ${result.reason}`; paintCaption(); }
-        }).catch(() => {
-          if (picture.isDestroyed) return;
-          picture.visible = false; states[index] = "preview failed: decode"; paintCaption();
-        });
-        const open = source.open;
-        if (open) {
-          // Same rule as a tool card's head: press and release on one cell is a click; anything else is a selection.
-          let down: { x: number; y: number } | undefined;
-          picture.onMouseDown = event => { down = { x: event.x, y: event.y }; };
-          picture.onMouseUp = event => { if (down && down.x === event.x && down.y === event.y && picture.image) open(image.full ?? image.sha256); down = undefined; };
-        }
-        pictures.push(picture);
-        row.add(picture);
-      }
-      this.add(row);
-    }
-    this.pictures = pictures;
-    // The names stay visible beside the pictures (and stand in for them in chip mode).
-    paintCaption();
-    this.add(caption);
-  }
-}

package/src/tui/ui/prompt-history.ts

@@ -1,60 +0,0 @@
-/**
- * Up/Down prompt recall as a pure value, so its one promise -- navigating
- * never loses text -- is a property test rather than a hope.
- *
- * Readline's precedent: an edit to a recalled line is kept for that line
- * while the user walks elsewhere, and dropped only when something is
- * submitted. Without it, walking Down from an edited entry restores the
- * stashed draft and the edit is gone (docs/tasks/fix-composer-history.md).
- */
-
-/**
- * Entries kept, newest first. Assumed, not measured: the composer kept 200
- * before this module existed and nothing has asked for more. Raising it
- * only costs memory; lowering it drops the oldest prompts from recall.
- */
-export const HISTORY_LIMIT = 200;
-
-export type PromptHistory = {
-  /** Submitted prompts, newest first. Navigation never changes them. */
-  readonly entries: readonly string[];
-  /** -1 is the draft; 0.. index entries. */
-  readonly at: number;
-  /** Unsubmitted text per position (-1 included), so leaving a position keeps what was typed there. */
-  readonly edits: ReadonlyMap<number, string>;
-};
-
-export const emptyHistory: PromptHistory = { entries: [], at: -1, edits: new Map() };
-
-/** A submit ends the walk: edits are discarded and the draft starts empty. */
-export function rememberPrompt(history: PromptHistory, entry: string, limit = HISTORY_LIMIT): PromptHistory {
-  if (!entry.trim()) return { ...history, at: -1, edits: new Map() };
-  // A repeat of the newest entry records once, so Up reaches the previous distinct prompt.
-  const entries = history.entries[0] === entry ? history.entries : [entry, ...history.entries].slice(0, limit);
-  return { entries, at: -1, edits: new Map() };
-}
-
-/**
- * Older (-1) or newer (+1). `current` is the text at the present position.
- * Null means there is nowhere to go; the caller decides whether that
- * consumes the key.
- */
-export function stepHistory(history: PromptHistory, direction: -1 | 1, current: string): { history: PromptHistory; text: string } | null {
-  const at = history.at - direction;
-  if (at < -1 || at >= history.entries.length) return null;
-  const edits = new Map(history.edits);
-  // An unchanged entry needs no edit; the draft is always kept, even when empty.
-  if (history.at === -1 || current !== history.entries[history.at]) edits.set(history.at, current);
-  else edits.delete(history.at);
-  return { history: { entries: history.entries, at, edits }, text: edits.get(at) ?? history.entries[at] ?? "" };
-}
-
-/** 1-based position for the box edge, or undefined while editing the draft. */
-export function historyPosition(history: PromptHistory): { index: number; total: number } | undefined {
-  return history.at < 0 ? undefined : { index: history.at + 1, total: history.entries.length };
-}
-
-/** Rewrites entries (session change: labels that no longer resolve) and starts a fresh walk. */
-export function projectHistory(history: PromptHistory, project: (text: string) => string): PromptHistory {
-  return { entries: history.entries.map(project).filter(Boolean), at: -1, edits: new Map() };
-}