moderado 0.3.0

package/dist/ui/welcome.d.ts

@@ -0,0 +1,130 @@
+export interface WelcomeLayoutOptions {
+    model: string;
+    tokens: number;
+    cost: string;
+    usageAvailable?: boolean;
+    workspace: string;
+    mode: 'Plan' | 'Execute';
+    autoApprove: boolean;
+    input?: string;
+    width?: number;
+    /** When set, render the full chat window (question row 1 + answer) instead of the logo header. */
+    chatQuestion?: string;
+    chatAnswer?: string;
+    chatThoughtTime?: number;
+    /** Generated completion tokens per second for the preceding response. */
+    outputTokenRate?: number;
+    mentionFiles?: string[];
+    mentionSelection?: number;
+    commandSelection?: number;
+    queuedCommands?: readonly string[];
+    isTurnSettled?: boolean;
+}
+export declare const MODERADO_ASCII_LOGO: string[];
+export declare const COMMAND_HINT = "\u001B[38;5;242mUse \u001B[38;5;75m/\u001B[38;5;242m for slash commands, \u001B[38;5;75m@\u001B[38;5;242m for file mentions\u001B[0m";
+export declare function stripAnsi(str: string): string;
+/** Card width: nearly full terminal width, like OpenCode/Cline. */
+export declare function getWelcomeCardWidth(width?: number): number;
+/** Left indent that centers a block of `blockWidth` visible columns on the terminal. */
+export declare function getWelcomeIndent(blockWidth: number, width?: number): number;
+export declare function renderQueuedCommandsBox(commands: readonly string[], width: number): string[];
+export declare function renderWelcomeCard(options: WelcomeLayoutOptions): string;
+export interface SlashCommand {
+    name: string;
+    desc: string;
+}
+export declare const SLASH_COMMANDS: SlashCommand[];
+export declare function getMatchingCommands(input: string): SlashCommand[];
+export declare function selectCommandCandidate(input: string, currentIndex: number, direction: number): SlashCommand | undefined;
+export declare function renderSuggestionsBox(commands: SlashCommand[], width?: number): string[];
+export declare function renderMentionSuggestionsBox(files: string[], selectedIndex?: number): string[];
+export declare function renderModeradoHeader(): string;
+/** Word-wrap plain text to `maxWidth` visible columns. */
+export declare function wrapText(text: string, maxWidth: number): string[];
+/**
+ * Full chat window (after a question is submitted): no logo — the question is
+ * displayed on the first row, the multi-line model answer below it, then the
+ * same input card as the welcome window at the bottom.
+ */
+export declare function renderChatScreen(options: WelcomeLayoutOptions, height?: number): string;
+/** Place the terminal cursor on the first row of the bottom composer. */
+export declare function renderChatComposerCursor(options: Pick<WelcomeLayoutOptions, 'width'>, inputLength: number): string;
+export declare function navigateQuestionHistory(history: string[], direction: -1 | 1, index: number, draft: string): {
+    input: string;
+    index: number;
+    draft: string;
+};
+/** Update the fixed chat elapsed-time row without repainting the terminal. */
+export declare function renderChatThoughtTimeUpdate(thoughtTime: number): string;
+export interface ChatAnswerPosition {
+    row: number;
+    column: number;
+}
+/** Write one streamed fragment into the answer area without repainting the chat frame. */
+export declare function renderChatAnswerDelta(delta: string, start: ChatAnswerPosition, width: number): ChatAnswerPosition & {
+    sequence: string;
+};
+export declare function renderFullWelcomeScreen(options: WelcomeLayoutOptions, height?: number): string;
+/** Keep the initial welcome screen centered as the terminal viewport changes. */
+export declare function getWelcomeBottomPadding(options: WelcomeLayoutOptions, height?: number): number;
+export declare function renderCenteredWelcomeScreen(options: WelcomeLayoutOptions, height?: number): string;
+/** Compose an OpenCode-style popup layer without losing the welcome background. */
+export declare function renderWelcomePopupLayer(options: WelcomeLayoutOptions, popupLines: string[], width?: number, height?: number): string;
+export declare function renderHelpPopupBox(version: string, workspace: string, width?: number): string[];
+export declare let terminalCleanExitDone: boolean;
+/** Mark that a clean exit already restored + cleared the terminal (guards the process 'exit' hook). */
+export declare function notifyCleanExit(): void;
+export declare function renderExitMessage(message: string): string;
+/**
+ * Exit Moderado cleanly: restore cursor visibility & style, leave the alternate
+ * screen buffer, disable raw mode, fully clear the OS terminal, print the
+ * farewell message, and terminate the process.
+ */
+export declare function exitCleanly(message: string): never;
+export interface InteractiveTurnResult {
+    text: string;
+    mode: 'Plan' | 'Execute';
+    autoApprove: boolean;
+    workflowAction?: 'build';
+}
+export interface PromptInteractiveTurnOptions {
+    model: string;
+    tokens: number;
+    cost: string;
+    usageAvailable?: boolean;
+    workspace: string;
+    version?: string;
+    initialMode?: 'Plan' | 'Execute';
+    initialAutoApprove?: boolean;
+    isFirstTurn?: boolean;
+    signal?: AbortSignal;
+    /** Previous turn's question/answer — when question is set, render the full chat window (no logo). */
+    chatQuestion?: string;
+    chatAnswer?: string;
+    chatThoughtTime?: number;
+    outputTokenRate?: number;
+    questionHistory?: string[];
+    /**
+     * Called when user selects a model via /model. Receives a `drawFrame`
+     * callback that composites popup content as a floating layer on top of the
+     * main TUI window (background stays as-is). The callback owns the selection
+     * UI and returns the new model id, or undefined if cancelled.
+     */
+    onModelSelect?: (drawFrame: (popupLines: string[]) => void) => Promise<string | undefined>;
+    /** Called when user issues /connect. Returns the model label to display. */
+    onConnect?: (drawFrame: (popupLines: string[]) => void) => Promise<string | undefined>;
+    /** Called when user issues /clear so caller can reset conversation history. */
+    onClear?: () => void;
+    onMcp?: (command: string, drawFrame: (popupLines: string[]) => void) => Promise<void>;
+    onSession?: (command: string, drawFrame: (popupLines: string[]) => void) => Promise<void>;
+    onQueue?: (command: string, drawFrame: (popupLines: string[]) => void) => Promise<void>;
+    onBtw?: (command: string, drawFrame: (popupLines: string[], options?: {
+        waitDismiss?: boolean;
+    }) => void | Promise<void>, signal?: AbortSignal) => Promise<void>;
+    onWorkflow?: (command: string, drawFrame: (popupLines: string[]) => void) => Promise<'build' | undefined>;
+    onInit?: (drawFrame: (popupLines: string[]) => void) => Promise<void>;
+    onMentionComplete?: (token: string) => Promise<string[]>;
+    queuedCommands?: readonly string[];
+}
+export declare function promptInteractiveTurn(options: PromptInteractiveTurnOptions): Promise<InteractiveTurnResult>;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/ui/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../../src/ui/welcome.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kGAAkG;IAClG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,mBAAmB,UAM/B,CAAC;AAEF,eAAO,MAAM,YAAY,yIACmG,CAAC;AAE7H,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAOD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3E;AAUD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB5F;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAyEvE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,cAAc,EAAE,YAAY,EAYxC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAIjE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAKvH;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBvF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,aAAa,SAAI,GAAG,MAAM,EAAE,CAgBxF;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAO7C;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAgCvF;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGlH;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAG3J;AAED,8EAA8E;AAC9E,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,MAAM,WAAW,kBAAkB;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE;AAEpE,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CASxI;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAS9F;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9F;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAWlG;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CASR;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAmD/F;AAED,eAAO,IAAI,qBAAqB,SAAQ,CAAC;AAEzC,uGAAuG;AACvG,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAelD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qGAAqG;IACrG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3F,4EAA4E;IAC5E,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvF,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,KAAK,CAAC,EAAE,CACN,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC9F,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAC1G,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAiBD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,qBAAqB,CAAC,CAkmBhC"}