anantham-v2 2.0.0-alpha.1

package/dist/tui/tui-controller.js

@@ -0,0 +1,190 @@
+/**
+ * TUI Controller: Manages navigation, keyboard input, command execution, and render coalescing.
+ * PRD Part 2 Section 188–195.
+ */
+export class TuiController {
+    stateAdapter;
+    renderer;
+    commandRegistry;
+    commandParser;
+    errorHandler;
+    output;
+    coalesceIntervalMs;
+    currentView = "dashboard";
+    isCommandMode = false;
+    commandBuffer = "";
+    errorMessage = "";
+    isRunning = false;
+    renderTimeout;
+    unregisterStateListener;
+    constructor(options) {
+        this.stateAdapter = options.stateAdapter;
+        this.renderer = options.renderer;
+        this.commandRegistry = options.commandRegistry;
+        this.commandParser = options.commandParser;
+        this.errorHandler = options.errorHandler;
+        this.output = options.output ?? process.stdout;
+        this.coalesceIntervalMs = options.coalesceIntervalMs ?? 30;
+        this.attachStateListener();
+    }
+    attachStateListener() {
+        this.unregisterStateListener = this.stateAdapter.subscribe(() => {
+            this.requestRender();
+        });
+    }
+    getCurrentView() {
+        return this.currentView;
+    }
+    setView(view) {
+        this.currentView = view;
+        this.requestRender();
+    }
+    start() {
+        this.isRunning = true;
+        this.renderNow();
+    }
+    stop() {
+        this.isRunning = false;
+        if (this.renderTimeout) {
+            clearTimeout(this.renderTimeout);
+            this.renderTimeout = undefined;
+        }
+        if (this.unregisterStateListener) {
+            this.unregisterStateListener();
+            this.unregisterStateListener = undefined;
+        }
+    }
+    /**
+     * Request a coalesced render frame to prevent event storms.
+     */
+    requestRender() {
+        if (!this.isRunning)
+            return;
+        if (!this.renderTimeout) {
+            this.renderTimeout = setTimeout(() => {
+                this.renderTimeout = undefined;
+                this.renderNow();
+            }, this.coalesceIntervalMs);
+        }
+    }
+    /**
+     * Render immediately to output stream.
+     */
+    renderNow() {
+        const rendered = this.renderer.render(this.currentView, this.stateAdapter, this.isCommandMode ? this.commandBuffer : "", this.errorMessage);
+        // Clear screen and redraw
+        this.output.write("\x1b[2J\x1b[H" + rendered + "\n");
+    }
+    /**
+     * Handle raw keyboard / character input.
+     */
+    async handleInput(char) {
+        this.errorMessage = "";
+        if (this.isCommandMode) {
+            if (char === "\r" || char === "\n") {
+                // Submit command
+                const toExec = this.commandBuffer.trim();
+                this.isCommandMode = false;
+                this.commandBuffer = "";
+                if (toExec) {
+                    await this.executeCommand(toExec);
+                }
+                this.requestRender();
+                return true;
+            }
+            if (char === "\u001B" || char === "\u0003") {
+                // Cancel command mode (ESC or Ctrl+C)
+                this.isCommandMode = false;
+                this.commandBuffer = "";
+                this.requestRender();
+                return true;
+            }
+            if (char === "\u007F" || char === "\b") {
+                // Backspace
+                this.commandBuffer = this.commandBuffer.slice(0, -1);
+                this.requestRender();
+                return true;
+            }
+            // Append character
+            this.commandBuffer += char;
+            this.requestRender();
+            return true;
+        }
+        // Normal navigation mode
+        switch (char) {
+            case "1":
+                this.setView("dashboard");
+                return true;
+            case "2":
+                this.setView("session");
+                return true;
+            case "3":
+                this.setView("tasks");
+                return true;
+            case "4":
+                this.setView("workflows");
+                return true;
+            case "5":
+                this.setView("agents");
+                return true;
+            case "6":
+                this.setView("jobs");
+                return true;
+            case "7":
+                this.setView("nodes");
+                return true;
+            case "8":
+                this.setView("approvals");
+                return true;
+            case "9":
+                this.setView("events");
+                return true;
+            case "?":
+            case "h":
+                this.setView("help");
+                return true;
+            case "/":
+                this.isCommandMode = true;
+                this.commandBuffer = "";
+                this.requestRender();
+                return true;
+            case "r":
+                this.requestRender();
+                return true;
+            case "q":
+            case "\u001B": // ESC
+                this.stop();
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Bridge slash command to authoritative CommandRegistry.
+     */
+    async executeCommand(rawCommand) {
+        if (!this.commandRegistry || !this.commandParser) {
+            this.errorMessage = "Command execution bridge unavailable.";
+            return;
+        }
+        try {
+            const parsed = this.commandParser.parse(rawCommand.startsWith("/") ? rawCommand : `/${rawCommand}`);
+            const result = await this.commandRegistry.execute(parsed);
+            if (!result.success) {
+                this.errorMessage = result.error ?? "Command failed.";
+            }
+            if (result.exitRequested) {
+                this.stop();
+            }
+        }
+        catch (err) {
+            if (this.errorHandler) {
+                const handled = this.errorHandler.handleError("tui", err);
+                this.errorMessage = handled.error ?? "Command error.";
+            }
+            else {
+                this.errorMessage = err instanceof Error ? err.message : String(err);
+            }
+        }
+    }
+}
+//# sourceMappingURL=tui-controller.js.map

package/dist/tui/tui-controller.js.map

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

package/dist/tui/tui-renderer.d.ts

@@ -0,0 +1,37 @@
+import { type TuiStateAdapter } from "./tui-state-adapter.js";
+import { type TuiDimensions, type TuiViewMode } from "../domain/tui.js";
+export interface TuiRendererOptions {
+    dimensions?: TuiDimensions;
+    redactSecrets?: boolean;
+}
+/**
+ * TUI View Renderer for 9 core visual views.
+ * PRD Part 2 Section 185–195.
+ */
+export declare class TuiRenderer {
+    private dimensions;
+    private readonly redactSecrets;
+    private static readonly SECRET_KEYS;
+    constructor(options?: TuiRendererOptions);
+    setDimensions(dims: TuiDimensions): void;
+    getDimensions(): TuiDimensions;
+    /**
+     * Main render dispatcher for active view mode.
+     */
+    render(mode: TuiViewMode, adapter: TuiStateAdapter, commandPrompt?: string, errorMessage?: string): string;
+    renderDashboard(adapter: TuiStateAdapter): string[];
+    renderSession(adapter: TuiStateAdapter): string[];
+    renderTasks(adapter: TuiStateAdapter): string[];
+    renderWorkflows(_adapter: TuiStateAdapter): string[];
+    renderAgents(_adapter: TuiStateAdapter): string[];
+    renderJobs(adapter: TuiStateAdapter): string[];
+    renderNodes(adapter: TuiStateAdapter): string[];
+    renderApprovals(_adapter: TuiStateAdapter): string[];
+    renderEvents(adapter: TuiStateAdapter): string[];
+    renderHelp(): string[];
+    /**
+     * Helper to recursively mask sensitive data.
+     */
+    redactData(data: unknown): unknown;
+}
+//# sourceMappingURL=tui-renderer.d.ts.map

package/dist/tui/tui-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-renderer.d.ts","sourceRoot":"","sources":["../../src/tui/tui-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIxE,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAExC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CASjC;gBAEU,OAAO,GAAE,kBAAuB;IAKrC,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAIxC,aAAa,IAAI,aAAa;IAIrC;;OAEG;IACI,MAAM,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,eAAe,EACxB,aAAa,SAAK,EAClB,YAAY,SAAK,GAChB,MAAM;IAuFF,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE;IAoCnD,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE;IA0BjD,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE;IAyB/C,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE;IAUpD,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE;IAUjD,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE;IAwB9C,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE;IAwB/C,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE;IASpD,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE;IAwBhD,UAAU,IAAI,MAAM,EAAE;IAuB7B;;OAEG;IACI,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAmB1C"}

package/dist/tui/tui-renderer.js

@@ -0,0 +1,290 @@
+import { TerminalLayout } from "./terminal-layout.js";
+import { TuiSanitizer } from "./tui-sanitizer.js";
+/**
+ * TUI View Renderer for 9 core visual views.
+ * PRD Part 2 Section 185–195.
+ */
+export class TuiRenderer {
+    dimensions;
+    redactSecrets;
+    static SECRET_KEYS = [
+        "apiKey",
+        "token",
+        "secret",
+        "password",
+        "auth",
+        "credential",
+        "privateKey",
+        "key",
+    ];
+    constructor(options = {}) {
+        this.dimensions = options.dimensions ?? { width: 80, height: 24 };
+        this.redactSecrets = options.redactSecrets ?? true;
+    }
+    setDimensions(dims) {
+        this.dimensions = dims;
+    }
+    getDimensions() {
+        return this.dimensions;
+    }
+    /**
+     * Main render dispatcher for active view mode.
+     */
+    render(mode, adapter, commandPrompt = "", errorMessage = "") {
+        const lines = [];
+        const width = this.dimensions.width;
+        // 1. Status Bar (Top)
+        lines.push(TerminalLayout.renderStatusBar(adapter.getStatus(), adapter.getActiveProjectId(), adapter.getActiveSessionId(), this.dimensions));
+        lines.push(TerminalLayout.renderDivider(width, "═"));
+        // 2. Navigation Tab Bar
+        const tabs = [
+            { key: "1", label: "Dashboard", mode: "dashboard", active: mode === "dashboard" },
+            { key: "2", label: "Session", mode: "session", active: mode === "session" },
+            { key: "3", label: "Tasks", mode: "tasks", active: mode === "tasks" },
+            { key: "4", label: "Workflows", mode: "workflows", active: mode === "workflows" },
+            { key: "5", label: "Agents", mode: "agents", active: mode === "agents" },
+            { key: "6", label: "Jobs", mode: "jobs", active: mode === "jobs" },
+            { key: "7", label: "Nodes", mode: "nodes", active: mode === "nodes" },
+            { key: "8", label: "Approvals", mode: "approvals", active: mode === "approvals" },
+            { key: "9", label: "Events", mode: "events", active: mode === "events" },
+            { key: "?", label: "Help", mode: "help", active: mode === "help" },
+        ];
+        lines.push(TerminalLayout.renderTabBar(tabs, width));
+        lines.push(TerminalLayout.renderDivider(width, "─"));
+        // 3. View Content
+        let contentLines = [];
+        switch (mode) {
+            case "dashboard":
+                contentLines = this.renderDashboard(adapter);
+                break;
+            case "session":
+                contentLines = this.renderSession(adapter);
+                break;
+            case "tasks":
+                contentLines = this.renderTasks(adapter);
+                break;
+            case "workflows":
+                contentLines = this.renderWorkflows(adapter);
+                break;
+            case "agents":
+                contentLines = this.renderAgents(adapter);
+                break;
+            case "jobs":
+                contentLines = this.renderJobs(adapter);
+                break;
+            case "nodes":
+                contentLines = this.renderNodes(adapter);
+                break;
+            case "approvals":
+                contentLines = this.renderApprovals(adapter);
+                break;
+            case "events":
+                contentLines = this.renderEvents(adapter);
+                break;
+            case "help":
+                contentLines = this.renderHelp();
+                break;
+        }
+        lines.push(...contentLines);
+        // 4. Error banner if present
+        if (errorMessage) {
+            lines.push(TerminalLayout.renderDivider(width, "─"));
+            lines.push(`\x1b[1;31m✖ Error: ${TuiSanitizer.sanitize(errorMessage)}\x1b[0m`);
+        }
+        // 5. Command Bar / Prompt (Bottom)
+        lines.push(TerminalLayout.renderDivider(width, "─"));
+        if (commandPrompt) {
+            lines.push(` : ${TuiSanitizer.sanitize(commandPrompt)}_`);
+        }
+        else {
+            lines.push(" [1-9] Switch View | [/] Command Bar | [r] Refresh | [q] Quit");
+        }
+        return lines.join("\n");
+    }
+    // --- View Implementations ---
+    renderDashboard(adapter) {
+        const projects = adapter.getProjects();
+        const sessions = adapter.getSessions();
+        const tasks = adapter.getTasks();
+        const jobs = adapter.getJobs();
+        const nodes = adapter.getNodes();
+        const events = adapter.getRecentEvents(5);
+        const taskCounts = {
+            available: tasks.filter((t) => t.status === "available" || t.status === "queued").length,
+            running: tasks.filter((t) => t.status === "running" || t.status === "claimed").length,
+            completed: tasks.filter((t) => t.status === "completed").length,
+            failed: tasks.filter((t) => t.status === "failed").length,
+        };
+        const currentProject = projects.find((p) => p.id === adapter.getActiveProjectId());
+        const currentSession = sessions.find((s) => s.id === adapter.getActiveSessionId());
+        const overviewLines = [
+            `Active Project: ${currentProject ? `${currentProject.name} (${currentProject.id})` : (adapter.getActiveProjectId() ?? "None")} (Total: ${projects.length})`,
+            `Active Session: ${currentSession ? `${currentSession.name} (${currentSession.id})` : (adapter.getActiveSessionId() ?? "None")} (Total: ${sessions.length})`,
+            `Tasks: [Available: ${taskCounts.available} | Running: ${taskCounts.running} | Completed: ${taskCounts.completed} | Failed: ${taskCounts.failed}]`,
+            `Background Jobs: ${jobs.length} | Remote Nodes: ${nodes.length} | Recovery State: ${adapter.getStatus()}`,
+        ];
+        const recentEventLines = events.length === 0
+            ? ["  (No events recorded)"]
+            : events.map((e) => `  • [${e.timestamp.slice(11, 19)}] ${e.type} (${e.actor})`);
+        return [
+            ...TerminalLayout.drawBox(overviewLines, { title: "SYSTEM OVERVIEW", width: this.dimensions.width - 2 }),
+            "",
+            ...TerminalLayout.drawBox(recentEventLines, { title: "RECENT EVENT STREAM", width: this.dimensions.width - 2 }),
+        ];
+    }
+    renderSession(adapter) {
+        const activeSessionId = adapter.getActiveSessionId();
+        const sessions = adapter.getSessions();
+        const current = sessions.find((s) => s.id === activeSessionId);
+        if (!current) {
+            return TerminalLayout.drawBox(["No active session selected. Use '/session select <id>' or press 1 to view projects."], { title: "SESSION DETAILS", width: this.dimensions.width - 2 });
+        }
+        const lines = [
+            `Session ID:      ${current.id}`,
+            `Name:            ${current.name}`,
+            `Project ID:      ${current.projectId}`,
+            `Branch:          ${current.branch}`,
+            `Status:          ${current.status}`,
+            `Model Profile:   ${current.modelProfile}`,
+            `Created At:      ${current.createdAt}`,
+            `Updated At:      ${current.updatedAt}`,
+        ];
+        return TerminalLayout.drawBox(lines, { title: `SESSION: ${current.name}`, width: this.dimensions.width - 2 });
+    }
+    renderTasks(adapter) {
+        const tasks = adapter.getTasks();
+        if (tasks.length === 0) {
+            return TerminalLayout.drawBox(["No tasks found in active session. Use '/task create <objective>'."], { title: "TASK BOARD", width: this.dimensions.width - 2 });
+        }
+        const headers = ["Task ID", "Objective", "Status", "Priority", "Updated"];
+        const rows = tasks.map((t) => [
+            t.id,
+            TuiSanitizer.truncate(t.objective, 30),
+            t.status,
+            t.priority ?? "normal",
+            t.updatedAt.slice(11, 19),
+        ]);
+        const colWidths = [12, 32, 12, 10, 10];
+        const tableLines = TerminalLayout.renderTable(headers, rows, colWidths);
+        return TerminalLayout.drawBox(tableLines, { title: `TASKS (${tasks.length})`, width: this.dimensions.width - 2 });
+    }
+    renderWorkflows(_adapter) {
+        const lines = [
+            "Workflow Engine: READY",
+            "Active DAG Runs: 0 active executions",
+            "No active workflow executions in progress. Use '/plan' or execute workflow run.",
+        ];
+        return TerminalLayout.drawBox(lines, { title: "WORKFLOW ENGINE", width: this.dimensions.width - 2 });
+    }
+    renderAgents(_adapter) {
+        const lines = [
+            "Agent Manager: OPERATIONAL",
+            "Configured Agents: 1 (cli_operator)",
+            "Role: Primary CLI Controller | Trust: safe | Model: default",
+        ];
+        return TerminalLayout.drawBox(lines, { title: "AGENT DIRECTORY", width: this.dimensions.width - 2 });
+    }
+    renderJobs(adapter) {
+        const jobs = adapter.getJobs();
+        if (jobs.length === 0) {
+            return TerminalLayout.drawBox(["No background jobs registered. Use BackgroundJobManager."], { title: "BACKGROUND JOBS", width: this.dimensions.width - 2 });
+        }
+        const headers = ["Job ID", "Task ID", "Status", "Agent ID", "Generation"];
+        const rows = jobs.map((j) => [
+            j.id,
+            j.taskId,
+            j.status,
+            j.agentId,
+            String(j.generation ?? 0),
+        ]);
+        const colWidths = [14, 25, 12, 15, 10];
+        const tableLines = TerminalLayout.renderTable(headers, rows, colWidths);
+        return TerminalLayout.drawBox(tableLines, { title: `BACKGROUND JOBS (${jobs.length})`, width: this.dimensions.width - 2 });
+    }
+    renderNodes(adapter) {
+        const nodes = adapter.getNodes();
+        if (nodes.length === 0) {
+            return TerminalLayout.drawBox(["No remote nodes registered. Local node controller operational."], { title: "REMOTE NODES", width: this.dimensions.width - 2 });
+        }
+        const headers = ["Node ID", "Address", "Status", "Capabilities", "Last Ping"];
+        const rows = nodes.map((n) => [
+            n.id,
+            n.endpointUrl,
+            n.status,
+            TuiSanitizer.truncate(n.capabilities.join(","), 20),
+            n.lastHeartbeatAt?.slice(11, 19) ?? "never",
+        ]);
+        const colWidths = [14, 25, 12, 22, 10];
+        const tableLines = TerminalLayout.renderTable(headers, rows, colWidths);
+        return TerminalLayout.drawBox(tableLines, { title: `REMOTE NODES (${nodes.length})`, width: this.dimensions.width - 2 });
+    }
+    renderApprovals(_adapter) {
+        const lines = [
+            "Pending Human Approvals: 0",
+            "All active tools and workflows are operating within permitted safety boundaries.",
+        ];
+        return TerminalLayout.drawBox(lines, { title: "PENDING APPROVALS", width: this.dimensions.width - 2 });
+    }
+    renderEvents(adapter) {
+        const events = adapter.getRecentEvents(15);
+        if (events.length === 0) {
+            return TerminalLayout.drawBox(["No events recorded in event stream yet."], { title: "LIVE EVENT LOG", width: this.dimensions.width - 2 });
+        }
+        const headers = ["Time", "Event Type", "Actor", "Session", "Project"];
+        const rows = events.map((e) => [
+            e.timestamp.slice(11, 19),
+            TuiSanitizer.truncate(e.type, 25),
+            e.actor,
+            e.sessionId ?? "-",
+            e.projectId ?? "-",
+        ]);
+        const colWidths = [10, 26, 15, 14, 14];
+        const tableLines = TerminalLayout.renderTable(headers, rows, colWidths);
+        return TerminalLayout.drawBox(tableLines, { title: `EVENT LOG (${events.length} shown)`, width: this.dimensions.width - 2 });
+    }
+    renderHelp() {
+        const lines = [
+            "KEYBOARD SHORTCUTS:",
+            "  [1] Dashboard    - System Overview & Event Summary",
+            "  [2] Session      - Active Session Details & Hierarchy",
+            "  [3] Tasks        - Kanban Task Board & Leases",
+            "  [4] Workflows    - Active DAG Runs & Wave Progress",
+            "  [5] Agents       - Agent Directory & Capability Profiles",
+            "  [6] Jobs         - Detached Background Jobs & Heartbeats",
+            "  [7] Nodes        - Remote Worker Nodes & Dispatches",
+            "  [8] Approvals    - Human Approval Gates",
+            "  [9] Events       - Real-Time Canonical Event Stream",
+            "  [?] Help         - Keybindings & Usage Guide",
+            "",
+            "COMMAND BAR:",
+            "  [/] Enter Command Bar to execute any slash command (/project, /task, /doctor, etc.)",
+            "  [r] Refresh current view",
+            "  [q] / [ESC] Graceful exit",
+        ];
+        return TerminalLayout.drawBox(lines, { title: "HELP & NAVIGATION GUIDE", width: this.dimensions.width - 2 });
+    }
+    /**
+     * Helper to recursively mask sensitive data.
+     */
+    redactData(data) {
+        if (!this.redactSecrets || !data || typeof data !== "object")
+            return data;
+        if (Array.isArray(data)) {
+            return data.map((item) => this.redactData(item));
+        }
+        const cleaned = {};
+        for (const [key, value] of Object.entries(data)) {
+            if (TuiRenderer.SECRET_KEYS.some((sk) => key.toLowerCase().includes(sk.toLowerCase()))) {
+                cleaned[key] = "[REDACTED]";
+            }
+            else if (typeof value === "object" && value !== null) {
+                cleaned[key] = this.redactData(value);
+            }
+            else {
+                cleaned[key] = value;
+            }
+        }
+        return cleaned;
+    }
+}
+//# sourceMappingURL=tui-renderer.js.map

package/dist/tui/tui-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-renderer.js","sourceRoot":"","sources":["../../src/tui/tui-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgB,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWlD;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,UAAU,CAAgB;IACjB,aAAa,CAAU;IAEhC,MAAM,CAAU,WAAW,GAAG;QACpC,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,UAAU;QACV,MAAM;QACN,YAAY;QACZ,YAAY;QACZ,KAAK;KACN,CAAC;IAEF,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAClE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;IACrD,CAAC;IAEM,aAAa,CAAC,IAAmB;QACtC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAEM,aAAa;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,MAAM,CACX,IAAiB,EACjB,OAAwB,EACxB,aAAa,GAAG,EAAE,EAClB,YAAY,GAAG,EAAE;QAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAEpC,sBAAsB;QACtB,KAAK,CAAC,IAAI,CACR,cAAc,CAAC,eAAe,CAC5B,OAAO,CAAC,SAAS,EAAE,EACnB,OAAO,CAAC,kBAAkB,EAAE,EAC5B,OAAO,CAAC,kBAAkB,EAAE,EAC5B,IAAI,CAAC,UAAU,CAChB,CACF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAErD,wBAAwB;QACxB,MAAM,IAAI,GAAc;YACtB,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,KAAK,WAAW,EAAE;YACjF,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,KAAK,SAAS,EAAE;YAC3E,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,KAAK,OAAO,EAAE;YACrE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,KAAK,WAAW,EAAE;YACjF,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,KAAK,QAAQ,EAAE;YACxE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,MAAM,EAAE;YAClE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,KAAK,OAAO,EAAE;YACrE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,KAAK,WAAW,EAAE;YACjF,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,KAAK,QAAQ,EAAE;YACxE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,MAAM,EAAE;SACnE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAErD,kBAAkB;QAClB,IAAI,YAAY,GAAa,EAAE,CAAC;QAChC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,WAAW;gBACd,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,SAAS;gBACZ,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC3C,MAAM;YACR,KAAK,OAAO;gBACV,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,WAAW;gBACd,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,QAAQ;gBACX,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,MAAM;gBACT,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACxC,MAAM;YACR,KAAK,OAAO;gBACV,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,WAAW;gBACd,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM;YACR,KAAK,QAAQ;gBACX,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC1C,MAAM;YACR,KAAK,MAAM;gBACT,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjC,MAAM;QACV,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QAE5B,6BAA6B;QAC7B,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,sBAAsB,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACjF,CAAC;QAED,mCAAmC;QACnC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,+BAA+B;IAExB,eAAe,CAAC,OAAwB;QAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAE1C,MAAM,UAAU,GAAG;YACjB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;YACxF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YACrF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;YAC/D,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;SAC1D,CAAC;QAEF,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACnF,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAEnF,MAAM,aAAa,GAAG;YACpB,mBAAmB,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,MAAM,CAAC,YAAY,QAAQ,CAAC,MAAM,GAAG;YAC5J,mBAAmB,cAAc,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,KAAK,cAAc,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,IAAI,MAAM,CAAC,YAAY,QAAQ,CAAC,MAAM,GAAG;YAC5J,sBAAsB,UAAU,CAAC,SAAS,eAAe,UAAU,CAAC,OAAO,iBAAiB,UAAU,CAAC,SAAS,cAAc,UAAU,CAAC,MAAM,GAAG;YAClJ,oBAAoB,IAAI,CAAC,MAAM,oBAAoB,KAAK,CAAC,MAAM,sBAAsB,OAAO,CAAC,SAAS,EAAE,EAAE;SAC3G,CAAC;QAEF,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1C,CAAC,CAAC,CAAC,wBAAwB,CAAC;YAC5B,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAEnF,OAAO;YACL,GAAG,cAAc,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACxG,EAAE;YACF,GAAG,cAAc,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;SAChH,CAAC;IACJ,CAAC;IAEM,aAAa,CAAC,OAAwB;QAC3C,MAAM,eAAe,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC;QAE/D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,cAAc,CAAC,OAAO,CAC3B,CAAC,qFAAqF,CAAC,EACvF,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,oBAAoB,OAAO,CAAC,EAAE,EAAE;YAChC,oBAAoB,OAAO,CAAC,IAAI,EAAE;YAClC,oBAAoB,OAAO,CAAC,SAAS,EAAE;YACvC,oBAAoB,OAAO,CAAC,MAAM,EAAE;YACpC,oBAAoB,OAAO,CAAC,MAAM,EAAE;YACpC,oBAAoB,OAAO,CAAC,YAAY,EAAE;YAC1C,oBAAoB,OAAO,CAAC,SAAS,EAAE;YACvC,oBAAoB,OAAO,CAAC,SAAS,EAAE;SACxC,CAAC;QAEF,OAAO,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAChH,CAAC;IAEM,WAAW,CAAC,OAAwB;QACzC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,cAAc,CAAC,OAAO,CAC3B,CAAC,mEAAmE,CAAC,EACrE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC5B,CAAC,CAAC,EAAE;YACJ,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;YACtC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,QAAQ,IAAI,QAAQ;YACtB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;SAC1B,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAExE,OAAO,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,UAAU,KAAK,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACpH,CAAC;IAEM,eAAe,CAAC,QAAyB;QAC9C,MAAM,KAAK,GAAG;YACZ,wBAAwB;YACxB,sCAAsC;YACtC,iFAAiF;SAClF,CAAC;QAEF,OAAO,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;IAEM,YAAY,CAAC,QAAyB;QAC3C,MAAM,KAAK,GAAG;YACZ,4BAA4B;YAC5B,qCAAqC;YACrC,6DAA6D;SAC9D,CAAC;QAEF,OAAO,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACvG,CAAC;IAEM,UAAU,CAAC,OAAwB;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAE/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,cAAc,CAAC,OAAO,CAC3B,CAAC,0DAA0D,CAAC,EAC5D,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAgB,EAAE,EAAE,CAAC;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,OAAO;YACT,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC;SAC1B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAExE,OAAO,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,oBAAoB,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7H,CAAC;IAEM,WAAW,CAAC,OAAwB;QACzC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,cAAc,CAAC,OAAO,CAC3B,CAAC,gEAAgE,CAAC,EAClE,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAC5D,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,MAAM;YACR,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACnD,CAAC,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO;SAC5C,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAExE,OAAO,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,iBAAiB,KAAK,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3H,CAAC;IAEM,eAAe,CAAC,QAAyB;QAC9C,MAAM,KAAK,GAAG;YACZ,4BAA4B;YAC5B,kFAAkF;SACnF,CAAC;QAEF,OAAO,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;IAEM,YAAY,CAAC,OAAwB;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAE3C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,cAAc,CAAC,OAAO,CAC3B,CAAC,yCAAyC,CAAC,EAC3C,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAC9D,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACtE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC7B,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;YACzB,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACjC,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,SAAS,IAAI,GAAG;YAClB,CAAC,CAAC,SAAS,IAAI,GAAG;SACnB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAExE,OAAO,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,MAAM,CAAC,MAAM,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/H,CAAC;IAEM,UAAU;QACf,MAAM,KAAK,GAAG;YACZ,qBAAqB;YACrB,sDAAsD;YACtD,yDAAyD;YACzD,iDAAiD;YACjD,sDAAsD;YACtD,4DAA4D;YAC5D,4DAA4D;YAC5D,uDAAuD;YACvD,2CAA2C;YAC3C,uDAAuD;YACvD,gDAAgD;YAChD,EAAE;YACF,cAAc;YACd,uFAAuF;YACvF,4BAA4B;YAC5B,6BAA6B;SAC9B,CAAC;QAEF,OAAO,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,IAAa;QAC7B,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE1E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;YAC3E,IAAI,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;gBACvF,OAAO,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;YAC9B,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACvD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC"}

package/dist/tui/tui-sanitizer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TUI Output Sanitizer & Terminal Escape Injection Defense.
+ * PRD Part 1 Section 30 & PRD Part 2 Section 186.
+ */
+export declare class TuiSanitizer {
+    private static readonly ANSI_REGEX;
+    private static readonly OSC_REGEX;
+    private static readonly CONTROL_CHAR_REGEX;
+    /**
+     * Strip all ANSI escape sequences, OSC codes, and raw control characters from text.
+     */
+    static sanitize(text: string): string;
+    /**
+     * Truncate string with ellipsis if exceeding maxLength without breaking character layout.
+     */
+    static truncate(text: string, maxLength: number): string;
+    /**
+     * Pad string to fixed width after sanitization.
+     */
+    static pad(text: string, width: number): string;
+}
+//# sourceMappingURL=tui-sanitizer.d.ts.map

package/dist/tui/tui-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-sanitizer.d.ts","sourceRoot":"","sources":["../../src/tui/tui-sanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAE6I;IAI/K,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAIzE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAuC;IAEjF;;OAEG;WACW,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQ5C;;OAEG;WACW,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAO/D;;OAEG;WACW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;CAKvD"}

package/dist/tui/tui-sanitizer.js

@@ -0,0 +1,48 @@
+/**
+ * TUI Output Sanitizer & Terminal Escape Injection Defense.
+ * PRD Part 1 Section 30 & PRD Part 2 Section 186.
+ */
+export class TuiSanitizer {
+    // Regex matching ANSI escape codes (CSI, OSC, etc.)
+    static ANSI_REGEX = 
+    // eslint-disable-next-line no-control-regex
+    /[\u001B\u009B][[\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\d\/#&.:=?%@~_]+)*|[a-zA-Z\d]+(?:;[-a-zA-Z\d\/#&.:=?%@~_]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g;
+    // Regex matching OSC sequences
+    // eslint-disable-next-line no-control-regex
+    static OSC_REGEX = /\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g;
+    // Regex matching non-printable/dangerous control characters (excluding newline \n and tab \t)
+    // eslint-disable-next-line no-control-regex
+    static CONTROL_CHAR_REGEX = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
+    /**
+     * Strip all ANSI escape sequences, OSC codes, and raw control characters from text.
+     */
+    static sanitize(text) {
+        if (typeof text !== "string")
+            return "";
+        return text
+            .replace(this.OSC_REGEX, "")
+            .replace(this.ANSI_REGEX, "")
+            .replace(this.CONTROL_CHAR_REGEX, "");
+    }
+    /**
+     * Truncate string with ellipsis if exceeding maxLength without breaking character layout.
+     */
+    static truncate(text, maxLength) {
+        const clean = this.sanitize(text);
+        if (clean.length <= maxLength)
+            return clean;
+        if (maxLength <= 3)
+            return clean.slice(0, maxLength);
+        return clean.slice(0, maxLength - 3) + "...";
+    }
+    /**
+     * Pad string to fixed width after sanitization.
+     */
+    static pad(text, width) {
+        const clean = this.sanitize(text);
+        if (clean.length >= width)
+            return clean.slice(0, width);
+        return clean + " ".repeat(width - clean.length);
+    }
+}
+//# sourceMappingURL=tui-sanitizer.js.map

package/dist/tui/tui-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-sanitizer.js","sourceRoot":"","sources":["../../src/tui/tui-sanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,oDAAoD;IAC5C,MAAM,CAAU,UAAU;IAChC,4CAA4C;IAC5C,4KAA4K,CAAC;IAE/K,+BAA+B;IAC/B,4CAA4C;IACpC,MAAM,CAAU,SAAS,GAAG,oCAAoC,CAAC;IAEzE,8FAA8F;IAC9F,4CAA4C;IACpC,MAAM,CAAU,kBAAkB,GAAG,mCAAmC,CAAC;IAEjF;;OAEG;IACI,MAAM,CAAC,QAAQ,CAAC,IAAY;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACxC,OAAO,IAAI;aACR,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;aAC3B,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;aAC5B,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,SAAiB;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,KAAa;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC"}