@elaraai/e3-ui-cli 1.0.72 → 1.0.73

package/dist/tui/ui/views/help.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import type { TuiState } from '../../state/actions.js';
+import type { Hit } from '../frame.js';
+import { type Line, type RenderCtx } from '../lines.js';
+/** The clickable tabs of the help strip (body row 0). */
+export declare function helpTabHits(ctx: RenderCtx): Hit[];
+/** The help body. */
+export declare function renderHelp(state: TuiState, ctx: RenderCtx): Line[];
+/** The help hints. */
+export declare const helpHints: {
+    left: string;
+    right: string;
+};
+//# sourceMappingURL=help.d.ts.map

package/dist/tui/ui/views/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../src/tui/ui/views/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAkB,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxE,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,EAAE,CAEjD;AAED,qBAAqB;AACrB,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,EAAE,CAoClE;AAED,sBAAsB;AACtB,eAAO,MAAM,SAAS;;;CAA8D,CAAC"}

package/dist/tui/ui/views/help.js

@@ -0,0 +1,65 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The help view — a tab per page so the commands and keys listed are the
+ * ones that work where `?` was pressed.
+ *
+ * @packageDocumentation
+ */
+import { padEnd } from '../../render/text.js';
+import { HELP_TABS, helpColumns } from '../../model/help.js';
+import { blank, b, d, t } from '../lines.js';
+import { lrLine } from '../lines.js';
+import { tabStripHits } from '../shell/widgets.js';
+/** The clickable tabs of the help strip (body row 0). */
+export function helpTabHits(ctx) {
+    return tabStripHits('HELP', HELP_TABS.map(x => x.label), ctx.g).map(h => ({ row: 0, x0: h.x0, x1: h.x1, target: { kind: 'tab', index: h.index } }));
+}
+/** The help body. */
+export function renderHelp(state, ctx) {
+    if (state.view.kind !== 'help')
+        return [];
+    const width = ctx.layout.columns;
+    const g = ctx.g;
+    const active = HELP_TABS.findIndex(x => x.tab === (state.view.kind === 'help' ? state.view.tab : 'everywhere'));
+    const strip = [t(' '), b('HELP'), t('   ')];
+    HELP_TABS.forEach((tab, i) => {
+        if (i === active)
+            strip.push(b(`${g.tabL}${i + 1} ${tab.label}${g.tabR}`, 'brand'));
+        else
+            strip.push(d(` ${i + 1} ${tab.label} `));
+        strip.push(t(' '));
+    });
+    const out = [lrLine(strip, [d('esc back'), t(' ')], width), blank(width)];
+    const columns = helpColumns(HELP_TABS[active]?.tab ?? 'everywhere');
+    const colWidth = Math.floor((width - 2) / 3);
+    const keyWidth = Math.min(26, Math.floor(colWidth * 0.5));
+    const rows = Math.max(...columns.map(c => c.rows.length)) + 1;
+    for (let r = 0; r < rows; r++) {
+        const line = [t(' ')];
+        columns.forEach((col) => {
+            if (r === 0) {
+                line.push(b(padEnd(col.title, colWidth)));
+                return;
+            }
+            const row = col.rows[r - 1];
+            if (row === undefined) {
+                line.push(t(' '.repeat(colWidth)));
+                return;
+            }
+            const [key, effect] = row;
+            const isHeading = key === '' && effect === '' ? false : key.toUpperCase() === key && key.includes('KEYS');
+            if (isHeading)
+                line.push(b(padEnd(key, colWidth)));
+            else
+                line.push(t(padEnd(key, keyWidth), 'brand'), d(padEnd(effect, colWidth - keyWidth)));
+        });
+        out.push(line);
+    }
+    return out;
+}
+/** The help hints. */
+export const helpHints = { left: '1-6 tabs   tab ⇧tab   ← →   esc back', right: '' };
+//# sourceMappingURL=help.js.map

package/dist/tui/ui/views/help.js.map

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

package/dist/tui/ui/views/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The view router — `renderView(state, ctx)` picks the view module for the
+ * current view and returns its body lines and hint row.
+ *
+ * @packageDocumentation
+ */
+import type { TuiState } from '../../state/actions.js';
+import type { Hit, Pane } from '../frame.js';
+import type { Line, RenderCtx } from '../lines.js';
+import type { RepoFacts } from './about.js';
+/** A rendered view: its body lines, the hint row, and — for the mouse —
+ *  its clickable cells (body-relative rows) and its scrolling pane. */
+export interface RenderedView {
+    body: Line[];
+    hints: {
+        left: string;
+        right: string;
+    };
+    hits?: Hit[] | undefined;
+    pane?: Pane | undefined;
+}
+/**
+ * Registers a view renderer.
+ *
+ * @param kind - The view kind
+ * @param render - The renderer
+ */
+export declare function registerView(kind: string, render: (state: TuiState, ctx: RenderCtx) => RenderedView): void;
+/**
+ * Renders the current view.
+ *
+ * @param state - The store state
+ * @param ctx - The render context
+ * @param facts - Repository facts for the about view
+ * @returns The body and hints
+ */
+export declare function renderView(state: TuiState, ctx: RenderCtx, facts: RepoFacts | null): RenderedView;
+//# sourceMappingURL=index.d.ts.map

package/dist/tui/ui/views/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tui/ui/views/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;uEACuE;AACvE,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC;IACzB,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CAC3B;AAKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,KAAK,YAAY,GAAG,IAAI,CAE1G;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,YAAY,CAYjG"}

package/dist/tui/ui/views/index.js

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { renderAbout, aboutHints } from './about.js';
+import { helpTabHits, renderHelp, helpHints } from './help.js';
+import { renderLaunch, launchHints } from './launch.js';
+import { renderRefusal, refusalHints } from './refusal.js';
+/** Per-view renderers registered by later view modules (repos, workspaces, task, input). */
+const extra = new Map();
+/**
+ * Registers a view renderer.
+ *
+ * @param kind - The view kind
+ * @param render - The renderer
+ */
+export function registerView(kind, render) {
+    extra.set(kind, render);
+}
+/**
+ * Renders the current view.
+ *
+ * @param state - The store state
+ * @param ctx - The render context
+ * @param facts - Repository facts for the about view
+ * @returns The body and hints
+ */
+export function renderView(state, ctx, facts) {
+    switch (state.view.kind) {
+        case 'launch': return { body: renderLaunch(state, ctx), hints: launchHints };
+        case 'refusal': return { body: renderRefusal(state, ctx), hints: refusalHints(state) };
+        case 'help': return { body: renderHelp(state, ctx), hints: helpHints, hits: helpTabHits(ctx) };
+        case 'about': return { body: renderAbout(state, ctx, facts), hints: aboutHints };
+        default: {
+            const registered = extra.get(state.view.kind);
+            if (registered !== undefined)
+                return registered(state, ctx);
+            return { body: [], hints: { left: '', right: '' } };
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tui/ui/views/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tui/ui/views/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAW3D,4FAA4F;AAC5F,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6D,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAyD;IAChG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe,EAAE,GAAc,EAAE,KAAuB;IAC/E,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAC7E,KAAK,SAAS,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACvF,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/F,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACjF,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5D,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;QACxD,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/tui/ui/views/input.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=input.d.ts.map

package/dist/tui/ui/views/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../../src/tui/ui/views/input.ts"],"names":[],"mappings":"AAAA;;;GAGG"}