@webda/debug 4.0.0-beta.3

package/lib/tui/panels/models.js

@@ -0,0 +1,193 @@
+import { ScrollablePanel } from "./panel.js";
+/**
+ * Models panel: displays registered models in a scrollable list.
+ * Press Enter to toggle detail view showing schema, relations, and actions.
+ */
+export class ModelsPanel extends ScrollablePanel {
+    /**
+     * @param client - Debug API client
+     */
+    constructor(client) {
+        super();
+        this.client = client;
+        this.name = "Models";
+        this.models = [];
+        this.detailMode = false;
+        /** Number of visible rows in the viewport (updated on render) */
+        this.visibleRows = 0;
+    }
+    /**
+     * Fetch models from the debug server.
+     */
+    async refresh() {
+        try {
+            this.models = await this.client.getModels();
+            this.itemCount = this.models.length;
+            this.cursor = Math.min(this.cursor, Math.max(0, this.itemCount - 1));
+        }
+        catch {
+            this.models = [];
+            this.itemCount = 0;
+        }
+    }
+    /**
+     * Handle keyboard input.
+     * @param key - key name from terminal-kit
+     */
+    onKey(key) {
+        if (this.detailMode) {
+            if (key === "ESCAPE" || key === "BACKSPACE" || key === "ENTER") {
+                this.detailMode = false;
+            }
+            return;
+        }
+        switch (key) {
+            case "UP":
+                this.moveCursor(-1, this.visibleRows);
+                break;
+            case "DOWN":
+                this.moveCursor(1, this.visibleRows);
+                break;
+            case "ENTER":
+                if (this.models.length > 0) {
+                    this.detailMode = true;
+                }
+                break;
+        }
+    }
+    /**
+     * Render the models list or detail view.
+     * @param term - terminal-kit instance
+     * @param startRow - first available row
+     * @param endRow - last available row
+     * @param width - terminal width in columns
+     */
+    render(term, startRow, endRow, width) {
+        this.visibleRows = endRow - startRow;
+        if (this.models.length === 0) {
+            term.moveTo(1, startRow);
+            term.eraseLine();
+            term("  No models found. Is the debug server running?");
+            return;
+        }
+        if (this.detailMode) {
+            this.renderDetail(term, startRow, endRow, width);
+            return;
+        }
+        // Column header
+        term.moveTo(1, startRow);
+        term.eraseLine();
+        term.bold("  ID" + " ".repeat(Math.max(1, 40 - 4)) + "Plural" + " ".repeat(Math.max(1, 20 - 6)) + "Actions");
+        const dataStart = startRow + 1;
+        const visible = endRow - dataStart;
+        for (let i = 0; i < visible; i++) {
+            const idx = this.scrollOffset + i;
+            const row = dataStart + i;
+            term.moveTo(1, row);
+            term.eraseLine();
+            if (idx >= this.models.length)
+                continue;
+            const model = this.models[idx];
+            const isSelected = idx === this.cursor;
+            const id = (model.id || "unknown").substring(0, 38);
+            const plural = (model.plural || "").substring(0, 18);
+            const actions = (model.actions || []).join(", ").substring(0, width - 65);
+            const line = `  ${id.padEnd(38)}  ${plural.padEnd(18)}  ${actions}`;
+            if (isSelected) {
+                term.inverse(line.padEnd(width));
+            }
+            else {
+                term(line);
+            }
+        }
+    }
+    /**
+     * Render detail view for the selected model.
+     * @param term - terminal-kit instance
+     * @param startRow - first available row
+     * @param endRow - last available row
+     * @param width - terminal width in columns
+     */
+    renderDetail(term, startRow, endRow, width) {
+        const model = this.models[this.cursor];
+        if (!model)
+            return;
+        const lines = [];
+        const addText = function addTextLine(text, style) {
+            lines.push({
+                render: function renderText(t, w) {
+                    const s = text.substring(0, w);
+                    if (style === "bold")
+                        t.bold(s);
+                    else if (style === "dim")
+                        t.dim(s);
+                    else if (style === "cyan")
+                        t.cyan(s);
+                    else
+                        t(s);
+                }
+            });
+        };
+        const addEmpty = function addEmptyLine() {
+            lines.push({ render: function renderEmpty() { } });
+        };
+        addText(`  Model: ${model.id}`, "bold");
+        if (model.plural)
+            addText(`  Plural: ${model.plural}`);
+        if (model.store)
+            addText(`  Store: ${model.store}${model.storeType ? " (" + model.storeType + ")" : ""}`);
+        addEmpty();
+        // Inheritance
+        const ancestors = model.metadata?.Ancestors || [];
+        const subclasses = model.metadata?.Subclasses || [];
+        if (ancestors.length > 0 || subclasses.length > 0) {
+            addText("  Inheritance:", "bold");
+            if (ancestors.length > 0) {
+                addText(`    Ancestors: ${[...ancestors].reverse().join(" → ")} → ${model.id.split("/").pop()}`);
+            }
+            if (subclasses.length > 0) {
+                addText(`    Subclasses: ${subclasses.join(", ")}`);
+            }
+            addEmpty();
+        }
+        // Relations
+        const rel = model.relations || {};
+        const relLines = [];
+        if (rel.parent)
+            relLines.push(`    parent    ${rel.parent.attribute.padEnd(20)} → ${rel.parent.model}`);
+        (rel.links || []).forEach((l) => relLines.push(`    ${(l.type || "link").padEnd(10)} ${l.attribute.padEnd(20)} → ${l.model}`));
+        (rel.queries || []).forEach((q) => relLines.push(`    query     ${q.attribute.padEnd(20)} → ${q.model}`));
+        (rel.maps || []).forEach((m) => relLines.push(`    map       ${m.attribute.padEnd(20)} → ${m.model}`));
+        (rel.children || []).forEach((c) => relLines.push(`    child     ${"".padEnd(20)} → ${c}`));
+        (rel.binaries || []).forEach((b) => relLines.push(`    binary    ${b.attribute.padEnd(20)}   (${b.cardinality})`));
+        if (relLines.length > 0) {
+            addText("  Relations:", "bold");
+            relLines.forEach(l => addText(l));
+            addEmpty();
+        }
+        // Actions
+        if (model.actions?.length > 0) {
+            addText("  Actions:", "bold");
+            addText(`    ${model.actions.join(", ")}`);
+            addEmpty();
+        }
+        addText("  Press ENTER or ESC to go back", "dim");
+        // Render with scroll (reuse detailMode scroll if we had one)
+        const visible = endRow - startRow;
+        for (let i = 0; i < visible; i++) {
+            const row = startRow + i;
+            term.moveTo(1, row);
+            term.eraseLine();
+            if (i < lines.length) {
+                lines[i].render(term, width);
+            }
+        }
+    }
+    /**
+     * Clean up panel resources.
+     */
+    destroy() {
+        this.models = [];
+    }
+}
+//# sourceMappingURL=models.js.map

package/lib/tui/panels/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../src/tui/panels/models.ts"],"names":[],"mappings":"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"}

package/lib/tui/panels/operations.d.ts

@@ -0,0 +1,55 @@
+import { ScrollablePanel } from "./panel.js";
+import { DebugClient } from "../client.js";
+/**
+ * Operations panel: displays all registered operations in a table
+ * with ID, REST method/URL, and input/output schemas.
+ * Press Enter for detail view with implementor, schemas, and code.
+ */
+export declare class OperationsPanel extends ScrollablePanel {
+    private client;
+    name: string;
+    private operations;
+    private visibleRows;
+    private detailMode;
+    private detailScroll;
+    /**
+     * @param client - Debug API client
+     */
+    constructor(client: DebugClient);
+    /**
+     * Fetch operations from the debug server.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Handle keyboard input.
+     * @param key - key name from terminal-kit
+     */
+    onKey(key: string): void;
+    /**
+     * Color an HTTP method string.
+     * @param term - terminal-kit instance
+     * @param method - HTTP method
+     * @param inverse - apply inverse
+     */
+    private colorMethod;
+    /**
+     * Render the operations table or detail view.
+     * @param term - terminal-kit instance
+     * @param startRow - first available row
+     * @param endRow - last available row
+     * @param width - terminal width in columns
+     */
+    render(term: any, startRow: number, endRow: number, width: number): void;
+    /**
+     * Render detail view for the selected operation.
+     * @param term - terminal-kit instance
+     * @param startRow - first available row
+     * @param endRow - last available row
+     * @param width - terminal width in columns
+     */
+    private renderDetail;
+    /**
+     * Clean up panel resources.
+     */
+    destroy(): void;
+}

package/lib/tui/panels/operations.js

@@ -0,0 +1,241 @@
+import { ScrollablePanel } from "./panel.js";
+/**
+ * Operations panel: displays all registered operations in a table
+ * with ID, REST method/URL, and input/output schemas.
+ * Press Enter for detail view with implementor, schemas, and code.
+ */
+export class OperationsPanel extends ScrollablePanel {
+    /**
+     * @param client - Debug API client
+     */
+    constructor(client) {
+        super();
+        this.client = client;
+        this.name = "Operations";
+        this.operations = [];
+        this.visibleRows = 0;
+        this.detailMode = false;
+        this.detailScroll = 0;
+    }
+    /**
+     * Fetch operations from the debug server.
+     */
+    async refresh() {
+        try {
+            this.operations = await this.client.getOperations();
+            this.itemCount = this.operations.length;
+            this.cursor = Math.min(this.cursor, Math.max(0, this.itemCount - 1));
+        }
+        catch {
+            this.operations = [];
+            this.itemCount = 0;
+        }
+    }
+    /**
+     * Handle keyboard input.
+     * @param key - key name from terminal-kit
+     */
+    onKey(key) {
+        if (this.detailMode) {
+            switch (key) {
+                case "ESCAPE":
+                case "BACKSPACE":
+                    this.detailMode = false;
+                    this.detailScroll = 0;
+                    break;
+                case "UP":
+                    this.detailScroll = Math.max(0, this.detailScroll - 1);
+                    break;
+                case "DOWN":
+                    this.detailScroll++;
+                    break;
+                case "PAGE_UP":
+                    this.detailScroll = Math.max(0, this.detailScroll - this.visibleRows);
+                    break;
+                case "PAGE_DOWN":
+                    this.detailScroll += this.visibleRows;
+                    break;
+            }
+            return;
+        }
+        switch (key) {
+            case "UP":
+                this.moveCursor(-1, this.visibleRows);
+                break;
+            case "DOWN":
+                this.moveCursor(1, this.visibleRows);
+                break;
+            case "ENTER":
+                if (this.operations.length > 0) {
+                    this.detailMode = true;
+                    this.detailScroll = 0;
+                }
+                break;
+        }
+    }
+    /**
+     * Color an HTTP method string.
+     * @param term - terminal-kit instance
+     * @param method - HTTP method
+     * @param inverse - apply inverse
+     */
+    colorMethod(term, method, inverse = false) {
+        const m = (method || "").toUpperCase();
+        const fn = m === "GET"
+            ? term.green
+            : m === "POST"
+                ? term.cyan
+                : m === "PUT"
+                    ? term.yellow
+                    : m === "DELETE"
+                        ? term.red
+                        : m === "PATCH"
+                            ? term.magenta
+                            : term;
+        if (inverse)
+            fn.inverse(m.padEnd(7));
+        else
+            fn(m.padEnd(7));
+    }
+    /**
+     * Render the operations table or detail view.
+     * @param term - terminal-kit instance
+     * @param startRow - first available row
+     * @param endRow - last available row
+     * @param width - terminal width in columns
+     */
+    render(term, startRow, endRow, width) {
+        this.visibleRows = endRow - startRow - 1;
+        if (this.operations.length === 0) {
+            term.moveTo(1, startRow);
+            term.eraseLine();
+            term("  No operations found. Is the debug server running?");
+            return;
+        }
+        if (this.detailMode) {
+            this.renderDetail(term, startRow, endRow, width);
+            return;
+        }
+        // Header
+        term.moveTo(1, startRow);
+        term.eraseLine();
+        term.bold("  Method  ID" + " ".repeat(Math.max(1, 32 - 2)) + "URL");
+        const dataStart = startRow + 1;
+        const visible = endRow - dataStart;
+        for (let i = 0; i < visible; i++) {
+            const idx = this.scrollOffset + i;
+            const row = dataStart + i;
+            term.moveTo(1, row);
+            term.eraseLine();
+            if (idx >= this.operations.length)
+                continue;
+            const op = this.operations[idx];
+            const isSelected = idx === this.cursor;
+            const rest = typeof op.rest === "object" ? op.rest : null;
+            if (isSelected)
+                term.inverse("  ");
+            else
+                term("  ");
+            // HTTP method
+            if (rest?.method) {
+                this.colorMethod(term, rest.method, isSelected);
+            }
+            else {
+                if (isSelected)
+                    term.inverse("       ");
+                else
+                    term("       ");
+            }
+            const id = (op.id || "unknown").substring(0, 30);
+            const url = (rest?.url || "").substring(0, width - 45);
+            if (isSelected) {
+                term.inverse(`  ${id.padEnd(30)}  `);
+                term.dim.inverse(url.padEnd(Math.max(0, width - 43)));
+            }
+            else {
+                term(`  ${id.padEnd(30)}  `);
+                term.dim(url);
+            }
+        }
+    }
+    /**
+     * Render detail view for the selected operation.
+     * @param term - terminal-kit instance
+     * @param startRow - first available row
+     * @param endRow - last available row
+     * @param width - terminal width in columns
+     */
+    renderDetail(term, startRow, endRow, width) {
+        const op = this.operations[this.cursor];
+        if (!op)
+            return;
+        const lines = [];
+        const add = function addLine(text) {
+            lines.push(text);
+        };
+        add(`  Operation: ${op.id}`);
+        if (op.summary)
+            add(`  ${op.summary}`);
+        add("");
+        // REST
+        const rest = typeof op.rest === "object" ? op.rest : null;
+        if (rest?.method) {
+            add(`  REST: ${rest.method.toUpperCase()} ${rest.url || rest.path || "/"}`);
+        }
+        // Input/Output
+        add(`  Input:  ${op.input || "void"}`);
+        add(`  Output: ${op.output || "void"}`);
+        add("");
+        // Implementor
+        if (op.implementor) {
+            const impl = op.implementor;
+            add(`  ${impl.type === "model" ? "Model" : "Service"}: ${impl.name}${impl.method ? "." + impl.method + "()" : ""}`);
+            add("");
+            // Code
+            if (impl.code) {
+                add("  Code:");
+                const codeLines = impl.code.split("\n");
+                for (const line of codeLines) {
+                    add(`    ${line}`);
+                }
+                add("");
+            }
+        }
+        // Tags
+        if (op.tags?.length > 0) {
+            add(`  Tags: ${op.tags.join(", ")}`);
+            add("");
+        }
+        add("  Press ESC to go back  |  UP/DOWN to scroll");
+        // Render with scroll
+        const visible = endRow - startRow;
+        this.detailScroll = Math.min(this.detailScroll, Math.max(0, lines.length - visible));
+        for (let i = 0; i < visible; i++) {
+            const lineIdx = this.detailScroll + i;
+            const row = startRow + i;
+            term.moveTo(1, row);
+            term.eraseLine();
+            if (lineIdx < lines.length) {
+                const text = lines[lineIdx].substring(0, width);
+                // Highlight keywords
+                if (text.startsWith("  Operation:") || text.startsWith("  Code:") || text.startsWith("  REST:")) {
+                    term.bold(text);
+                }
+                else if (text.startsWith("    ")) {
+                    // Code lines
+                    term.dim(text);
+                }
+                else {
+                    term(text);
+                }
+            }
+        }
+    }
+    /**
+     * Clean up panel resources.
+     */
+    destroy() {
+        this.operations = [];
+    }
+}
+//# sourceMappingURL=operations.js.map

package/lib/tui/panels/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/tui/panels/operations.ts"],"names":[],"mappings":"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"}

package/lib/tui/panels/panel.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Interface for TUI panels.
+ *
+ * Each panel represents a tab in the debug dashboard and is responsible
+ * for rendering its content area and handling keyboard input.
+ */
+export interface Panel {
+    /** Display name shown in the tab bar */
+    name: string;
+    /**
+     * Render the panel content into the terminal.
+     *
+     * @param term - terminal-kit terminal instance
+     * @param startRow - first row available for content (after header)
+     * @param endRow - last row available for content (before status bar)
+     * @param width - terminal width in columns
+     */
+    render(term: any, startRow: number, endRow: number, width: number): void;
+    /**
+     * Handle a keypress while this panel is active.
+     *
+     * @param key - Key name from terminal-kit (e.g. "UP", "DOWN", "ENTER")
+     */
+    onKey?(key: string): void;
+    /**
+     * Update panel data (called on initial load and on restart events).
+     */
+    refresh?(): Promise<void>;
+    /**
+     * Clean up resources when the panel is no longer needed.
+     */
+    destroy(): void;
+}
+/**
+ * Base class for panels that display a scrollable list of items.
+ * Provides cursor movement and scroll offset logic.
+ */
+export declare abstract class ScrollablePanel implements Panel {
+    abstract name: string;
+    /** Current cursor position in the items array */
+    protected cursor: number;
+    /** Scroll offset (first visible row index) */
+    protected scrollOffset: number;
+    /** Total number of items */
+    protected itemCount: number;
+    /**
+     * Move the cursor, clamping to valid range and adjusting scroll.
+     *
+     * @param delta - Number of rows to move (negative = up)
+     * @param visibleRows - Number of rows visible in the viewport
+     */
+    protected moveCursor(delta: number, visibleRows: number): void;
+    abstract render(term: any, startRow: number, endRow: number, width: number): void;
+    abstract destroy(): void;
+}

package/lib/tui/panels/panel.js

@@ -0,0 +1,31 @@
+/**
+ * Base class for panels that display a scrollable list of items.
+ * Provides cursor movement and scroll offset logic.
+ */
+export class ScrollablePanel {
+    constructor() {
+        /** Current cursor position in the items array */
+        this.cursor = 0;
+        /** Scroll offset (first visible row index) */
+        this.scrollOffset = 0;
+        /** Total number of items */
+        this.itemCount = 0;
+    }
+    /**
+     * Move the cursor, clamping to valid range and adjusting scroll.
+     *
+     * @param delta - Number of rows to move (negative = up)
+     * @param visibleRows - Number of rows visible in the viewport
+     */
+    moveCursor(delta, visibleRows) {
+        this.cursor = Math.max(0, Math.min(this.itemCount - 1, this.cursor + delta));
+        // Adjust scroll offset to keep cursor visible
+        if (this.cursor < this.scrollOffset) {
+            this.scrollOffset = this.cursor;
+        }
+        else if (this.cursor >= this.scrollOffset + visibleRows) {
+            this.scrollOffset = this.cursor - visibleRows + 1;
+        }
+    }
+}
+//# sourceMappingURL=panel.js.map

package/lib/tui/panels/panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.js","sourceRoot":"","sources":["../../../src/tui/panels/panel.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,MAAM,OAAgB,eAAe;IAArC;QAEE,iDAAiD;QACvC,WAAM,GAAG,CAAC,CAAC;QACrB,8CAA8C;QACpC,iBAAY,GAAG,CAAC,CAAC;QAC3B,4BAA4B;QAClB,cAAS,GAAG,CAAC,CAAC;IAoB1B,CAAC;IAlBC;;;;;OAKG;IACO,UAAU,CAAC,KAAa,EAAE,WAAmB;QACrD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;QAC7E,8CAA8C;QAC9C,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;QAClC,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,GAAG,WAAW,EAAE,CAAC;YAC1D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CAIF"}