tickmarkr 2.4.2 → 2.5.1

package/dist/tui/cockpit/keys.js

@@ -632,3 +632,34 @@ export function resolveSetupKeyBinding(bindings, event) {
 export function dispatchSetupKey(event, state, bindings = SETUP_KEY_BINDINGS) {
     return resolveSetupKeyBinding(bindings, event)?.apply(state, event);
 }
+/** Installed FINAL actions, shared by shell dispatch, help and pointer buttons. */
+export const SHELL_BINDINGS = [
+    { key: "1", label: "Home", action: "home" },
+    { key: "4", label: "Run", action: "run" },
+    { key: "5", label: "Evidence", action: "evidence" },
+    { key: "Tab", label: "Focus", action: "focus" },
+    { key: "Enter", label: "Open", action: "open" },
+    { key: "a", label: "Actions", action: "actions" },
+    { key: "/", label: "Filter", action: "filter" },
+    { key: "e", label: "Export", action: "export" },
+    { key: "f", label: "Follow", action: "follow" },
+    { key: "PageUp/PageDown", label: "Page", action: "page" },
+    { key: "?", label: "Keys", action: "help" },
+    { key: "q", label: "Quit", action: "quit" },
+    { key: "+", label: "Widen shortcuts", action: "widen" },
+    { key: "-", label: "Narrow shortcuts", action: "narrow" },
+];
+/** Advertise only installed operations with a target in this view. */
+export function shellBindings(context) {
+    return SHELL_BINDINGS.filter(binding => {
+        if (binding.action === "open")
+            return context.canOpen !== false && (context.view !== "evidence" || !context.evidenceSection);
+        if (binding.action === "widen" || binding.action === "narrow")
+            return context.canResize === true;
+        if (binding.action === "export")
+            return context.view === "evidence";
+        if (binding.action === "filter" || binding.action === "follow")
+            return context.view === "evidence" && !context.evidenceSection;
+        return true;
+    });
+}

package/dist/tui/cockpit/layout.d.ts

@@ -304,4 +304,18 @@ export type FramePlan = PlannedFrame | PlainFallbackPlan;
  */
 export declare function planFrame(size: MeasuredSize, view?: FrameView, state?: FrameState): FramePlan;
 export declare function resolveCockpitLayout(columns: number, rows: number): CockpitLayout;
+/** FINAL §3.1: one geometry for paint, focus and pointer hit testing. */
+export declare function planShell(columns: number, rows: number, shortcutColumns?: number): {
+    columns: number;
+    rows: number;
+    refused: boolean;
+    rail: number;
+    shortcuts: number;
+    bodyColumn: number;
+    bodyColumns: number;
+    bodyRow: number;
+    bodyRows: number;
+    focus: ("content" | "rail" | "shortcuts")[];
+};
+export type ShellPlan = ReturnType<typeof planShell>;
 export {};

package/dist/tui/cockpit/layout.js

@@ -389,3 +389,18 @@ export function resolveCockpitLayout(columns, rows) {
         },
     };
 }
+/** FINAL §3.1: one geometry for paint, focus and pointer hit testing. */
+export function planShell(columns, rows, shortcutColumns = 22) {
+    columns = Math.max(0, Math.floor(columns));
+    rows = Math.max(0, Math.floor(rows));
+    const rail = columns >= 90 ? 15 : 0;
+    const shortcuts = columns >= 120 ? Math.max(20, Math.min(columns - 59, Math.floor(shortcutColumns))) : 0;
+    const bodyColumn = 1 + (rail ? rail + 1 : 0);
+    return {
+        columns, rows, refused: columns < 40 || rows < 14,
+        rail, shortcuts, bodyColumn,
+        bodyColumns: Math.max(0, columns - 2 - (rail ? rail + 1 : 0) - (shortcuts ? shortcuts + 1 : 0)),
+        bodyRow: 3, bodyRows: Math.max(0, rows - 7),
+        focus: [...(rail ? ["rail"] : []), "content", ...(shortcuts ? ["shortcuts"] : [])],
+    };
+}

package/dist/tui/cockpit/live-runtime.d.ts

@@ -0,0 +1,46 @@
+import { type LiveStore, type LiveStoreSnapshot } from "./live-store.js";
+import { type HomeNeedsYouTarget } from "./home-view.js";
+import { type ShellState, type ShellCommit } from "./shell.js";
+import { type RunKeyEvent } from "./keys.js";
+import { type PointerReport } from "./pointer.js";
+import { type FocusTarget, type FocusResult } from "../../drivers/types.js";
+/** React 19 development measures retain fiber details in Node's global timeline.
+ * Drain only React DevTools entries, sharing one observer across independent mounts.
+ * No environment mutation, global performance monkey patch, or retained frame archive. */
+export declare function borrowRuntimeTimeline(): () => void;
+export declare const SHELL_TERMINAL_ENTER: string;
+export declare const SHELL_TERMINAL_RESTORE: string;
+export interface ShellDelivery {
+    snapshot: () => {
+        state: ShellState;
+        store: LiveStoreSnapshot;
+        interaction: ShellState;
+    };
+    refresh: () => boolean;
+    key: (event: RunKeyEvent) => boolean;
+    pointer: (report: PointerReport) => boolean;
+    diagnostics: LiveStore["diagnostics"];
+    stage: (edits: readonly string[]) => void;
+    geometry: () => ShellCommit | undefined;
+}
+export interface ConsolidatedOptions {
+    input: NodeJS.ReadStream;
+    output: NodeJS.WriteStream;
+    cwd: string;
+    runId: string;
+    binaryVersion: string;
+    refreshMs?: number;
+    now?: () => number;
+    debug?: boolean;
+    initialView?: ShellState["view"];
+    initialParks?: boolean;
+    observeRun?: boolean;
+    focusDriver?: (target: FocusTarget, driver: string) => Promise<FocusResult>;
+    /** Compatibility observer retained for the pre-existing production-mount harness. */
+    onDelivery?: (delivery: ShellDelivery) => void;
+    onShellDelivery?: (delivery: ShellDelivery) => void;
+    environment?: NodeJS.ProcessEnv;
+    diagnostics?: readonly HomeNeedsYouTarget[];
+}
+/** The live entry mounts the dependency-owned leaves, using only C2 snapshots/history/page. */
+export declare function runConsolidatedCockpit(options: ConsolidatedOptions): Promise<void>;