161 lines
5.5 KiB
TypeScript
161 lines
5.5 KiB
TypeScript
import { G2_LENS_WIDTH, GrayImage } from "../../graphics/image";
|
|
import { getDefaultSmallFont } from "../../graphics/ui-fonts";
|
|
import { wrapText } from "../../graphics/textwrap";
|
|
import { clamp } from "../../util/numeric-util";
|
|
import type { ToolDebugEntry } from "../../assistant/tool-registry";
|
|
import { InputEvent } from "../gestures";
|
|
import { Layer, LayerContext, PaintBelow } from "../layers";
|
|
import { MenuLayer, drawListScrollbar, type MenuItem } from "../menu";
|
|
import { minWindowTop, sidebarWidth, TOP_BAR_HEIGHT } from "./geometry";
|
|
import { lineStep } from "../metrics";
|
|
|
|
/**
|
|
* Shell-overlay debug dialog (escape menu > Debug): lists the voice assistant
|
|
* tools registered for the foreground window's app, including ones whose
|
|
* availability gate currently blocks them. Selecting a tool opens a detail
|
|
* page with its full name, gating state, and description.
|
|
*/
|
|
|
|
const DIALOG_WIDTH = 420;
|
|
// Shell overlays align to the min-height window band; the detail box fills
|
|
// the band below the top bar with an 8px margin on each side.
|
|
const DETAIL_HEIGHT = 208;
|
|
|
|
/** Dialog left edge: past the sidebar strip where one reserves width. */
|
|
function dialogX(): number {
|
|
return sidebarWidth() + 8;
|
|
}
|
|
|
|
function detailWidth(): number {
|
|
return G2_LENS_WIDTH - dialogX() - 8;
|
|
}
|
|
|
|
/** Dialog top edge, aligned to the min-height band's content area. */
|
|
function dialogY(): number {
|
|
return minWindowTop() + TOP_BAR_HEIGHT + 8;
|
|
}
|
|
const DETAIL_PADDING = 14;
|
|
|
|
export class ToolDebugMenuLayer extends MenuLayer {
|
|
constructor(appId: string | null, entries: ToolDebugEntry[], private readonly onClosed: () => void) {
|
|
super(appId ? `Assistant tools: ${appId}` : "Assistant tools", buildItems(appId, entries), {
|
|
x: dialogX(),
|
|
y: dialogY(),
|
|
width: DIALOG_WIDTH,
|
|
squareCorners: true,
|
|
minHeight: 0,
|
|
});
|
|
}
|
|
|
|
onRemoved(): void {
|
|
this.onClosed();
|
|
}
|
|
}
|
|
|
|
function buildItems(appId: string | null, entries: ToolDebugEntry[]): MenuItem[] {
|
|
if (!entries.length) {
|
|
return [{ label: "(no tools registered)", onSelect: (ctx) => ctx.stack.pop() }];
|
|
}
|
|
const prefix = appId ? `app.${appId}.` : "";
|
|
return entries.map((entry) => {
|
|
const name = prefix && entry.spec.name.startsWith(prefix)
|
|
? entry.spec.name.slice(prefix.length)
|
|
: entry.spec.name;
|
|
return {
|
|
label: name,
|
|
onSelect: (ctx) => {
|
|
ctx.stack.push(new ToolDetailLayer(entry));
|
|
},
|
|
render: ({ image, x, y, width, selected }) => {
|
|
const font = getDefaultSmallFont();
|
|
const nameValue = selected ? 255 : entry.live ? 200 : 110;
|
|
const status = entry.live ? entry.spec.availability : `${entry.spec.availability} (off)`;
|
|
const statusValue = entry.live ? (selected ? 200 : 150) : 100;
|
|
image.drawText(font, x, y + 3, name, nameValue);
|
|
image.drawText(font, x + width - font.measureText(status) - 2, y + 3, status, statusValue);
|
|
},
|
|
};
|
|
});
|
|
}
|
|
|
|
/** Full-detail page for one tool: canonical name, gating, and description. */
|
|
class ToolDetailLayer implements Layer {
|
|
private scrollRow = 0;
|
|
|
|
constructor(private readonly entry: ToolDebugEntry) {}
|
|
|
|
paint(_ctx: LayerContext, paintBelow: PaintBelow): GrayImage {
|
|
const image = paintBelow();
|
|
const font = getDefaultSmallFont();
|
|
const left = dialogX();
|
|
const width = detailWidth();
|
|
const top = dialogY();
|
|
image.fillRect(left, top, width, DETAIL_HEIGHT, 1);
|
|
image.drawRect(left, top, width, DETAIL_HEIGHT, 72);
|
|
|
|
const textX = left + DETAIL_PADDING;
|
|
const textWidth = width - 2 * DETAIL_PADDING - 8;
|
|
const lines = this.buildLines(textWidth);
|
|
const detailLineH = lineStep(font);
|
|
const visibleRowCount = Math.max(1, ((DETAIL_HEIGHT - 2 * DETAIL_PADDING) / detailLineH) | 0);
|
|
this.scrollRow = clamp(this.scrollRow, 0, Math.max(0, lines.length - visibleRowCount));
|
|
|
|
const lastVisibleRow = Math.min(lines.length, this.scrollRow + visibleRowCount);
|
|
for (let index = this.scrollRow; index < lastVisibleRow; index++) {
|
|
const line = lines[index]!;
|
|
const y = top + DETAIL_PADDING + (index - this.scrollRow) * detailLineH;
|
|
image.drawText(font, textX, y, line.text, line.value);
|
|
}
|
|
if (lines.length > visibleRowCount) {
|
|
drawListScrollbar(
|
|
image,
|
|
left + width - 7,
|
|
top + DETAIL_PADDING,
|
|
DETAIL_HEIGHT - 2 * DETAIL_PADDING,
|
|
this.scrollRow,
|
|
visibleRowCount,
|
|
lines.length,
|
|
);
|
|
}
|
|
return image;
|
|
}
|
|
|
|
private buildLines(width: number): { text: string; value: number }[] {
|
|
const font = getDefaultSmallFont();
|
|
const spec = this.entry.spec;
|
|
const lines: { text: string; value: number }[] = [];
|
|
for (const text of wrapText(font, spec.name, width)) {
|
|
lines.push({ text, value: 235 });
|
|
}
|
|
lines.push({
|
|
text: `${spec.availability}${this.entry.live ? ", live" : ", not live"}${spec.proactive ? ", proactive" : ""}`,
|
|
value: 160,
|
|
});
|
|
if (this.entry.windowId) {
|
|
lines.push({ text: `window: ${this.entry.windowId}`, value: 160 });
|
|
}
|
|
lines.push({ text: "", value: 0 });
|
|
for (const text of wrapText(font, spec.description, width)) {
|
|
lines.push({ text, value: 190 });
|
|
}
|
|
return lines;
|
|
}
|
|
|
|
handleInput(event: InputEvent, ctx: LayerContext): void {
|
|
switch (event.type) {
|
|
case "scroll-up":
|
|
this.scrollRow = Math.max(0, this.scrollRow - 1);
|
|
return;
|
|
case "scroll-down":
|
|
this.scrollRow++;
|
|
return;
|
|
case "click":
|
|
case "double-click":
|
|
ctx.stack.pop();
|
|
return;
|
|
default:
|
|
return;
|
|
}
|
|
}
|
|
}
|