@simon_he/vue-tui 1.0.1 → 1.1.0

package/dist/{trace-CjzYeIxN.js → trace-Bh8WnoMo.js}

@@ -1,3 +1,4 @@
+import { summarizeFramePerf } from "./frame-perf-CHpWhbC4.js";
 import { computed, ref, shallowReactive } from "vue";
 
 //#region src/observability/perf-sink.ts
@@ -136,6 +137,9 @@ function createFramePerfStore(limit = 120, opts) {
 	function list() {
 		return samples.slice();
 	}
+	function summary() {
+		return summarizeFramePerf(samples);
+	}
 	function clear() {
 		samples.length = 0;
 	}
@@ -148,6 +152,7 @@ function createFramePerfStore(limit = 120, opts) {
 		addSink,
 		latest,
 		list,
+		summary,
 		clear
 	};
 }

package/dist/vue/agent/create-png-terminal-graphic-renderer.d.ts

@@ -0,0 +1,19 @@
+import type { TAgentTerminalGraphicRenderer, TAgentTerminalGraphicRendererContext } from "../components/TAgentTerminalGraphic.js";
+import type { TerminalGraphicRenderQueue } from "../../renderer/terminal-graphic-render-queue.js";
+export type PngTerminalGraphicFrame = Readonly<{
+    base64: string;
+    fallback?: string;
+    cols?: number;
+    rows?: number;
+}>;
+export type CreatePngTerminalGraphicRendererOptions = Readonly<{
+    toPngBase64: (content: string, context: TAgentTerminalGraphicRendererContext) => Promise<PngTerminalGraphicFrame>;
+    toSixel?: (pngBase64: string, context: TAgentTerminalGraphicRendererContext) => Promise<string>;
+    fallback?: (content: string, context: TAgentTerminalGraphicRendererContext) => string | Promise<string>;
+    cacheSalt?: string | ((content: string, context: TAgentTerminalGraphicRendererContext) => string);
+    cacheKey?: (content: string, context: TAgentTerminalGraphicRendererContext) => string;
+    queue?: TerminalGraphicRenderQueue;
+    dedupeInflight?: boolean;
+    zIndex?: number;
+}>;
+export declare function createPngTerminalGraphicRenderer(options: CreatePngTerminalGraphicRendererOptions): TAgentTerminalGraphicRenderer;

package/dist/vue/components/T3DViewport.d.ts

@@ -0,0 +1,473 @@
+import type { Style } from "../../core/types.js";
+import type { TVideoFrame, TVideoFrameEvent, TVideoFrameFormat } from "../video/types.js";
+import type { ExtractPublicPropTypes, PropType } from "vue";
+/** Motion state supplied to every {@link T3DRenderer.render} call. */
+export type T3DViewportMotion = Readonly<{
+    yaw: number;
+    pitch: number;
+    yawVelocity: number;
+    pitchVelocity: number;
+    pointerX: number;
+    pointerY: number;
+    pointerSpeed: number;
+    hovering: boolean;
+    zoom: number;
+    zoomVelocity: number;
+    hoveredObjectId: number | null;
+    selectedObjectId: number | null;
+}>;
+/** Object metadata returned by an optional {@link T3DRenderer.hitTest}. */
+export type T3DHitResult = Readonly<{
+    objectId: number;
+    label?: string;
+    href?: string;
+}>;
+/** Synchronous pointer context supplied to an optional {@link T3DRenderer.hitTest}. */
+export type T3DHitTestContext = Readonly<{
+    pointerX: number;
+    pointerY: number;
+    pixelWidth: number;
+    pixelHeight: number;
+    cellWidth: number;
+    cellHeight: number;
+    motion: T3DViewportMotion;
+}>;
+/** Pull-render context for a single terminal 3D frame. */
+export type T3DRenderContext = Readonly<{
+    timeMs: number;
+    deltaMs: number;
+    frame: number;
+    pixelWidth: number;
+    pixelHeight: number;
+    format: TVideoFrameFormat;
+    signal: AbortSignal;
+    motion: T3DViewportMotion;
+}>;
+/** Renderer contract used by {@link T3DViewport}. */
+export type T3DRenderer = Readonly<{
+    render: (context: T3DRenderContext) => TVideoFrame | Promise<TVideoFrame>;
+    /** Optional synchronous object picking for hover and click selection. */
+    hitTest?: (context: T3DHitTestContext) => T3DHitResult | null;
+    dispose?: () => void;
+}>;
+/** Public methods exposed by {@link T3DViewport}. */
+export type T3DViewportHandle = Readonly<{
+    resetMotion: () => void;
+}>;
+export declare const t3DViewportProps: {
+    /** Horizontal position in terminal cells. */
+    readonly x: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Vertical position in terminal cells. */
+    readonly y: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Width in terminal cells. */
+    readonly w: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Height in terminal cells. */
+    readonly h: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Paint and pointer hit-test stacking order. */
+    readonly zIndex: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Pull renderer captured at mount; remount the component to replace it. */
+    readonly renderer: {
+        readonly type: PropType<T3DRenderer>;
+        readonly required: true;
+    };
+    /** Stops frame pulling while true. */
+    readonly paused: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** Maximum requested frames per second. */
+    readonly maxFps: {
+        readonly type: NumberConstructor;
+        readonly default: 24;
+    };
+    /** Requested source width in pixels; TVideo may adapt it for ASCII output. */
+    readonly pixelWidth: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+    /** Requested source height in pixels; TVideo may adapt it for ASCII output. */
+    readonly pixelHeight: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+    /** Text displayed before a frame is available or after rendering fails. */
+    readonly fallback: {
+        readonly type: StringConstructor;
+        readonly default: "[3D viewport]";
+    };
+    /** Terminal style applied to fallback and ASCII output. */
+    readonly style: {
+        readonly type: PropType<Style>;
+        readonly default: undefined;
+    };
+    /** Clears cells underneath each video frame. */
+    readonly clear: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Enables pointer orbit, wheel zoom, and hover motion tracking. */
+    readonly interactive: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Initial yaw angle in radians, also restored by resetMotion(). */
+    readonly initialYaw: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Initial pitch angle in radians, also restored by resetMotion(). */
+    readonly initialPitch: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Enables continuous yaw rotation when not dragging. */
+    readonly autoRotate: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Automatic yaw rotation speed in radians per second. */
+    readonly autoRotateSpeed: {
+        readonly type: NumberConstructor;
+        readonly default: 0.35;
+    };
+    /** Drag sensitivity in radians per terminal cell. */
+    readonly pointerSensitivity: {
+        readonly type: NumberConstructor;
+        readonly default: 0.055;
+    };
+    /** Initial camera zoom, also restored by resetMotion(). */
+    readonly initialZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /** Minimum camera zoom accepted from wheel and trackpad gestures. */
+    readonly minZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 0.65;
+    };
+    /** Maximum camera zoom accepted from wheel and trackpad gestures. */
+    readonly maxZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 1.65;
+    };
+    /** Zoom impulse per normalized wheel or trackpad unit. */
+    readonly zoomSensitivity: {
+        readonly type: NumberConstructor;
+        readonly default: 0.1;
+    };
+};
+export type T3DViewportProps = ExtractPublicPropTypes<typeof t3DViewportProps>;
+/**
+ * Browser-safe interactive 3D viewport. Frames are pulled from a renderer and
+ * delegated directly to TVideo, which owns frame coalescing and terminal output.
+ *
+ * @event frame Emitted after TVideo commits a rendered frame.
+ * @event error Emitted when the renderer or TVideo frame handling fails.
+ */
+export declare const T3DViewport: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** Horizontal position in terminal cells. */
+    readonly x: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Vertical position in terminal cells. */
+    readonly y: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Width in terminal cells. */
+    readonly w: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Height in terminal cells. */
+    readonly h: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Paint and pointer hit-test stacking order. */
+    readonly zIndex: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Pull renderer captured at mount; remount the component to replace it. */
+    readonly renderer: {
+        readonly type: PropType<T3DRenderer>;
+        readonly required: true;
+    };
+    /** Stops frame pulling while true. */
+    readonly paused: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** Maximum requested frames per second. */
+    readonly maxFps: {
+        readonly type: NumberConstructor;
+        readonly default: 24;
+    };
+    /** Requested source width in pixels; TVideo may adapt it for ASCII output. */
+    readonly pixelWidth: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+    /** Requested source height in pixels; TVideo may adapt it for ASCII output. */
+    readonly pixelHeight: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+    /** Text displayed before a frame is available or after rendering fails. */
+    readonly fallback: {
+        readonly type: StringConstructor;
+        readonly default: "[3D viewport]";
+    };
+    /** Terminal style applied to fallback and ASCII output. */
+    readonly style: {
+        readonly type: PropType<Style>;
+        readonly default: undefined;
+    };
+    /** Clears cells underneath each video frame. */
+    readonly clear: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Enables pointer orbit, wheel zoom, and hover motion tracking. */
+    readonly interactive: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Initial yaw angle in radians, also restored by resetMotion(). */
+    readonly initialYaw: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Initial pitch angle in radians, also restored by resetMotion(). */
+    readonly initialPitch: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Enables continuous yaw rotation when not dragging. */
+    readonly autoRotate: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Automatic yaw rotation speed in radians per second. */
+    readonly autoRotateSpeed: {
+        readonly type: NumberConstructor;
+        readonly default: 0.35;
+    };
+    /** Drag sensitivity in radians per terminal cell. */
+    readonly pointerSensitivity: {
+        readonly type: NumberConstructor;
+        readonly default: 0.055;
+    };
+    /** Initial camera zoom, also restored by resetMotion(). */
+    readonly initialZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /** Minimum camera zoom accepted from wheel and trackpad gestures. */
+    readonly minZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 0.65;
+    };
+    /** Maximum camera zoom accepted from wheel and trackpad gestures. */
+    readonly maxZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 1.65;
+    };
+    /** Zoom impulse per normalized wheel or trackpad unit. */
+    readonly zoomSensitivity: {
+        readonly type: NumberConstructor;
+        readonly default: 0.1;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    /** A frame was committed by TVideo. */
+    frame: (_event: TVideoFrameEvent) => true;
+    /** Rendering or frame processing failed. */
+    error: (_error: unknown) => true;
+    /** Hovered renderer object changed, or cleared to null. */
+    objecthover: (_hit: T3DHitResult | null) => true;
+    /** Click-locked renderer object changed, or cleared to null. */
+    objectselect: (_hit: T3DHitResult | null) => true;
+}, string, (import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps), Readonly<import("vue").ExtractPropTypes<{
+    /** Horizontal position in terminal cells. */
+    readonly x: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Vertical position in terminal cells. */
+    readonly y: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Width in terminal cells. */
+    readonly w: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Height in terminal cells. */
+    readonly h: {
+        readonly type: NumberConstructor;
+        readonly required: true;
+    };
+    /** Paint and pointer hit-test stacking order. */
+    readonly zIndex: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Pull renderer captured at mount; remount the component to replace it. */
+    readonly renderer: {
+        readonly type: PropType<T3DRenderer>;
+        readonly required: true;
+    };
+    /** Stops frame pulling while true. */
+    readonly paused: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** Maximum requested frames per second. */
+    readonly maxFps: {
+        readonly type: NumberConstructor;
+        readonly default: 24;
+    };
+    /** Requested source width in pixels; TVideo may adapt it for ASCII output. */
+    readonly pixelWidth: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+    /** Requested source height in pixels; TVideo may adapt it for ASCII output. */
+    readonly pixelHeight: {
+        readonly type: NumberConstructor;
+        readonly default: undefined;
+    };
+    /** Text displayed before a frame is available or after rendering fails. */
+    readonly fallback: {
+        readonly type: StringConstructor;
+        readonly default: "[3D viewport]";
+    };
+    /** Terminal style applied to fallback and ASCII output. */
+    readonly style: {
+        readonly type: PropType<Style>;
+        readonly default: undefined;
+    };
+    /** Clears cells underneath each video frame. */
+    readonly clear: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Enables pointer orbit, wheel zoom, and hover motion tracking. */
+    readonly interactive: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Initial yaw angle in radians, also restored by resetMotion(). */
+    readonly initialYaw: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Initial pitch angle in radians, also restored by resetMotion(). */
+    readonly initialPitch: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    /** Enables continuous yaw rotation when not dragging. */
+    readonly autoRotate: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Automatic yaw rotation speed in radians per second. */
+    readonly autoRotateSpeed: {
+        readonly type: NumberConstructor;
+        readonly default: 0.35;
+    };
+    /** Drag sensitivity in radians per terminal cell. */
+    readonly pointerSensitivity: {
+        readonly type: NumberConstructor;
+        readonly default: 0.055;
+    };
+    /** Initial camera zoom, also restored by resetMotion(). */
+    readonly initialZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /** Minimum camera zoom accepted from wheel and trackpad gestures. */
+    readonly minZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 0.65;
+    };
+    /** Maximum camera zoom accepted from wheel and trackpad gestures. */
+    readonly maxZoom: {
+        readonly type: NumberConstructor;
+        readonly default: 1.65;
+    };
+    /** Zoom impulse per normalized wheel or trackpad unit. */
+    readonly zoomSensitivity: {
+        readonly type: NumberConstructor;
+        readonly default: 0.1;
+    };
+}>> & Readonly<{
+    onError?: ((_error: unknown) => any) | undefined;
+    onFrame?: ((_event: Readonly<{
+        timestampMs: number;
+        pixelWidth: number;
+        pixelHeight: number;
+        droppedFrames: number;
+        durationMs?: number;
+        playbackRate?: import("../video/types.js").TVideoPlaybackRate;
+    }>) => any) | undefined;
+    onObjecthover?: ((_hit: Readonly<{
+        objectId: number;
+        label?: string;
+        href?: string;
+    }> | null) => any) | undefined;
+    onObjectselect?: ((_hit: Readonly<{
+        objectId: number;
+        label?: string;
+        href?: string;
+    }> | null) => any) | undefined;
+}>, {
+    readonly style: Readonly<{
+        fg?: string;
+        bg?: string;
+        bold?: boolean;
+        dim?: boolean;
+        italic?: boolean;
+        underline?: boolean;
+        inverse?: boolean;
+        href?: string;
+    }>;
+    readonly zIndex: number;
+    readonly clear: boolean;
+    readonly fallback: string;
+    readonly maxFps: number;
+    readonly pixelWidth: number;
+    readonly pixelHeight: number;
+    readonly paused: boolean;
+    readonly interactive: boolean;
+    readonly initialYaw: number;
+    readonly initialPitch: number;
+    readonly autoRotate: boolean;
+    readonly autoRotateSpeed: number;
+    readonly pointerSensitivity: number;
+    readonly initialZoom: number;
+    readonly minZoom: number;
+    readonly maxZoom: number;
+    readonly zoomSensitivity: number;
+}, {}>;