bkper 5.2.0 → 5.3.1

package/lib/agent/interactive/logo-3d.d.ts

@@ -0,0 +1,125 @@
+import type { Theme } from '@earendil-works/pi-coding-agent';
+import type { Color, Component, TerminalColorMode, TUI, TuiMouseEvent, TuiMouseEventResult } from '@earendil-works/pi-tui';
+/**
+ * Fullscreen 3D logo easter egg, played by clicking the header logo. The logo bitmap is built from one block per
+ * pixel. The current screen dissolves into braille dust while the model spins in the center and its blocks play a
+ * sliding puzzle. Leaving plays the same timeline backwards, so the screen reassembles.
+ *
+ * The logo lifts off the header, flies to the center, and grows; the dust spreads out from the header logo.
+ *
+ * The blocks are ray cast per braille dot. A braille cell holds 2x4 roughly square dots, so one pixel of a
+ * half-block bitmap is exactly 2x2 dots, and the header logo is drawn at its exact size when it lifts off.
+ *
+ * Adapted from Pi's 3D logo easter egg (MIT License, Copyright (c) Mario Zechner), from
+ * packages/coding-agent/src/modes/interactive/components/easter-egg-3d.ts at pi commit c450f2c0f8. Pi does not
+ * export it; if it ever does, replace this copy with the export. Changes from upstream: the model is built from any
+ * half-block pixel logo instead of the pi logo or Armin, and theme colors are resolved once into a palette because
+ * Pi's theme singleton is internal.
+ */
+export type Rgb = readonly [number, number, number];
+/** Grid position of a block: column and row in the bitmap, and layer (-1, 0, 1) in depth. */
+type Cell3 = readonly [number, number, number];
+/** A bitmap built from one block per foreground pixel. Each is a block that the puzzle slides around. */
+export interface Model {
+    /** Bitmap size in pixels. */
+    columns: number;
+    rows: number;
+    blocks: Array<{
+        home: Cell3;
+        color: Rgb;
+    }>;
+    /** Camera distance from the model's center, in pixels. */
+    cameraDistance: number;
+    /** Farthest distance of any block corner from the center, with blocks on the outer depth layers. */
+    radius: number;
+    /** Largest share of the screen width the spinning model covers. */
+    widthShare: number;
+    /** Number of blocks the puzzle moves per step, given a random number from 0 to 1. */
+    puzzleMoves: (random: number) => number;
+    /**
+     * Top-left cell of the model's half-block rendering on screen. The model lifts off from there and replaces it.
+     * Undefined to grow out of the center.
+     */
+    origin: {
+        column: number;
+        row: number;
+    } | undefined;
+}
+/** A logo as square pixels, one character per pixel and '.' for transparent, rendered with half blocks. */
+export interface PixelLogo {
+    pixels: readonly string[];
+    colors: Readonly<Record<string, Color>>;
+}
+/** Top-left cell of a logo's half-block rendering on screen. */
+export interface LogoOrigin {
+    column: number;
+    row: number;
+}
+/** The 3D model of a pixel logo that lifts off its half-block rendering at `origin`. */
+export declare function createLogoModel(logo: PixelLogo, origin: LogoOrigin): Model;
+/** Colors the animation fades between, resolved from the terminal and theme when it starts. */
+export interface Logo3dPalette {
+    foreground: Rgb;
+    background: Rgb;
+    /** The key and the text of the "escape to return" hint. */
+    hintKey: Rgb;
+    hintText: Rgb;
+    colorMode: TerminalColorMode;
+}
+/** The part of the TUI the animation drives. */
+export type Logo3dHost = Pick<TUI, 'requestRender'> & {
+    readonly terminal: {
+        readonly rows: number;
+    };
+};
+/**
+ * Plays the logo lifting off its half-block rendering at `origin`. Only fullscreen mode can show it, because it
+ * dissolves the rendered screen, which is captured right away. Returns false when it cannot play.
+ */
+export declare function playLogo3d(tui: unknown, theme: Theme, logo: PixelLogo, origin: LogoOrigin): boolean;
+export declare class Logo3dAnimation implements Component {
+    private readonly tui;
+    /** The screen to dissolve, as rendered lines. */
+    private readonly screen;
+    private readonly model;
+    private readonly foreground;
+    private readonly background;
+    private readonly palette;
+    private readonly onDone;
+    private readonly startTime;
+    private lastRender;
+    private timer;
+    private exit;
+    private shuffle;
+    private screenWidth;
+    private screenHeight;
+    /** Star per cell index, or undefined. */
+    private stars;
+    private cells;
+    private readonly ansiCache;
+    private readonly raster;
+    constructor(tui: Logo3dHost, screen: readonly string[], model: Model, palette: Logo3dPalette, onDone: () => void);
+    /** Play the exit animation. A second call skips it. */
+    close(): void;
+    handleInput(data: string): void;
+    handleMouse(event: TuiMouseEvent): TuiMouseEventResult;
+    invalidate(): void;
+    render(width: number): string[];
+    private elapsed;
+    private exitProgress;
+    private finish;
+    /** Each block's displacement from its place in the model at `time`, in grid units. */
+    private blockOffsets;
+    private flyProgress;
+    private starAlpha;
+    private hintAlpha;
+    private pose;
+    private hint;
+    /** A sparse, deterministic starfield: one braille dot in about STAR_DENSITY of all cells. */
+    private prepareStars;
+    private prepareCells;
+    private pack;
+    private ansi;
+}
+export {};
+//# sourceMappingURL=logo-3d.d.ts.map

package/lib/agent/interactive/logo-3d.d.ts.map

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