import { G2_LENS_HEIGHT, G2_LENS_WIDTH, GrayImage } from "../graphics/image"; import { BdfFont } from "../graphics/bdffont"; import { spanCurrent } from "../native/frame-timings"; import { type ConfigSettingString } from "./dashboard-settings"; export type DashboardInputEvent = | { type: "click"; source: "ring" | "left-arm" | "right-arm" } | { type: "double-click"; source: "ring" | "left-arm" | "right-arm" } | { type: "scroll-up" } | { type: "scroll-down" } | { type: "long-press"; source: "ring" | "left-arm" | "right-arm" } | { type: "long-press-release"; source: "ring" | "left-arm" | "right-arm" } /** * The on-glasses "Hey Even" wakeword fired. Delivered on sid 0x07 by the * stock firmware regardless of CFW; the CFW additionally suppresses the stock * Even AI app so this is ours to handle. Unlike every other input event this * one is honoured while the screen is off. */ | { type: "wakeword" } | { type: "unknown"; kind: string; eventSource: number; eventType: number }; export type LayerActions = { /** Ask for a dashboard repaint+transmit, e.g. when async data arrives. */ requestRender: () => void; disconnect: () => Promise | void; startTextSettingEdit: (setting: ConfigSettingString) => Promise | void; endTextSettingEdit: () => Promise | void; /** * Start push-to-talk voice capture with the provider chosen in settings. * With `endpointing`, the capture also ends itself when the speaker stops * (hands-free); otherwise it runs until stopVoiceCapture. */ startVoiceCapture: (endpointing?: boolean) => Promise | void; /** Stop push-to-talk; for a cloud provider this also commits for a final result. */ stopVoiceCapture: () => Promise | void; /** Start continuous capture (Transcribe); shares the mic with push-to-talk. */ startContinuousVoiceCapture: () => Promise | void; stopContinuousVoiceCapture: () => Promise | void; /** Play a CFW tone-sequencer payload (see sound-effects.ts). */ playBuzzerSequence: (payload: Uint8Array) => Promise | void; }; export type PaintBelow = () => GrayImage; function notifyRemoved(layer: Layer | undefined): void { try { layer?.onRemoved?.(); } catch (error) { console.warn("layer onRemoved failed", error); } } export interface LayerContext { readonly stack: LayerStack; readonly actions: LayerActions; } export interface Layer { readonly paintOverBase?: boolean; paint(ctx: LayerContext, paintBelow: PaintBelow): GrayImage; handleInput(event: DashboardInputEvent, ctx: LayerContext): Promise | void; /** Called when the layer leaves the stack by any path (pop or clearToBase). */ onRemoved?(): void; } export class LayerStack { private readonly layers: Layer[]; private readonly ctx: LayerContext; private readonly baseWidth: number; private readonly baseHeight: number; private readonly focusedFn: () => boolean; constructor( baseLayer: Layer, actions: LayerActions, baseSize?: { width: number; height: number }, // Whether this stack is the current input target; drives the strength of // selection highlights (a visible-but-unfocused window dims its selection). // Defaults to always-focused for shell overlays and standalone stacks. isFocused: () => boolean = () => true, ) { this.layers = [baseLayer]; this.ctx = { stack: this, actions, }; this.baseWidth = baseSize?.width ?? G2_LENS_WIDTH; this.baseHeight = baseSize?.height ?? G2_LENS_HEIGHT; this.focusedFn = isFocused; } isFocused(): boolean { return this.focusedFn(); } push(layer: Layer): void { this.layers.push(layer); } pop(): void { if (this.layers.length > 1) { notifyRemoved(this.layers.pop()); } } /** Whether the top layer matches (without popping it). */ topMatches(predicate: (layer: Layer) => boolean): boolean { return this.layers.length > 1 && predicate(this.layers[this.layers.length - 1]!); } /** Pop the top layer only if it matches; returns whether a layer was popped. */ popIfTop(predicate: (layer: Layer) => boolean): boolean { if (this.layers.length > 1 && predicate(this.layers[this.layers.length - 1]!)) { notifyRemoved(this.layers.pop()); return true; } return false; } clearToBase(): void { for (const layer of this.layers.splice(1)) { notifyRemoved(layer); } } isAtBase(): boolean { return this.layers.length === 1; } getBaseSize(): { width: number; height: number } { return { width: this.baseWidth, height: this.baseHeight }; } setActions(actions: Partial): void { Object.assign(this.ctx.actions, actions); } paint(): GrayImage { return this.paintLayer(this.layers.length - 1); } async handleInput(event: DashboardInputEvent): Promise { await this.layers[this.layers.length - 1]!.handleInput(event, this.ctx); } private paintLayer(index: number): GrayImage { const layer = this.layers[index]!; let cachedBelow: GrayImage | null = null; return spanCurrent(`paint[${index}]:${layer.constructor.name}`, () => layer.paint(this.ctx, () => { if (cachedBelow) { return cachedBelow; } if (index <= 0) { cachedBelow = new GrayImage(this.baseWidth, this.baseHeight, 0); } else if (layer.paintOverBase) { cachedBelow = this.paintLayer(0); } else { cachedBelow = this.paintLayer(index - 1); } return cachedBelow; }), ); } }