@astralyn/pi 0.99.0 → 1.0.1

package/dist/modes/interactive/components/easter-egg-3d.d.ts

@@ -0,0 +1,104 @@
+import { type Component, type TUI, type TuiMouseEvent, type TuiMouseEventResult } from "@earendil-works/pi-tui";
+/**
+ * Fullscreen 3D easter eggs: the pi logo (header logo click) and Armin (/arminsayshi). Both are bitmaps 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 pi logo lifts off the header, flies to the center, and grows; the dust spreads out from the header logo.
+ * Armin grows out of a speck at the center; the dust spreads out from the center.
+ *
+ * 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 (4x2 cells) is 8x8 dots when it lifts off.
+ */
+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. */
+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;
+}
+/**
+ * Which easter egg to play. The pi logo lifts off the header logo, whose top-left cell is at `column`, `row`.
+ */
+export type EasterEgg3d = {
+    kind: "pi-logo";
+    column: number;
+    row: number;
+} | {
+    kind: "armin";
+};
+/**
+ * Show the animation as a fullscreen overlay until it is dismissed. The overlay takes focus and mouse input and
+ * returns focus when hidden, so the rest of the UI keeps running underneath untouched.
+ */
+export declare function playEasterEgg3d(tui: TUI, screen: readonly string[], egg: EasterEgg3d): Promise<void>;
+export declare class EasterEgg3dAnimation 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 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: TUI, screen: readonly string[], model: Model, colors: {
+        foreground: Rgb;
+        background: Rgb;
+    }, 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=easter-egg-3d.d.ts.map

package/dist/modes/interactive/components/easter-egg-3d.d.ts.map

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