@xenosystem/blocks 0.13.11 → 0.13.12

package/dist/ops/index.d.ts

@@ -1,5 +1,5 @@
-import { PanelModule, PanelManifest } from '@xenosystem/block-sdk';
-import { ReactNode } from 'react';
+import { PanelModule, PanelManifest, BlockDeclaration } from '@xenosystem/block-sdk';
+import { ReactNode, ReactElement } from 'react';
 import { ThrottleClock } from '@xenosystem/tree-core';
 
 /**
@@ -433,6 +433,18 @@ declare class ConsoleController {
     /** Every source seen, with its contribution count and current visibility. */
     sources(): XenoLogSource[];
     /** Follow the tail. Auto-disabled by the view when the user scrolls up. */
+    private expandedId;
+    private viewport;
+    /** Which record's data is expanded under its row, if any. */
+    getExpanded(): string | null;
+    /** Toggle a record's expanded detail (only records carrying `data` expand). */
+    toggleExpanded(recordId: string): void;
+    /** The scroller reports its viewport; the view state windows the rows from it. */
+    setViewport(height: number, scrollTop: number): void;
+    getViewport(): {
+        height: number;
+        scrollTop: number;
+    };
     setFollow(follow: boolean): void;
     /** Collapse adjacent duplicates. */
     setCollapse(collapse: boolean): void;
@@ -512,7 +524,101 @@ declare const CONSOLE_PANEL_ID = "xeno.core.console";
 declare const consoleManifest: PanelManifest;
 
 /**
- * The Console panel view — virtualized, follow-tail, per-source chips.
+ * The Console panel AS A DECLARATION — the fourteenth declared block, and the second virtualized list
+ * (after history): a multiplexed log.
+ *
+ * Everything drawn is data: the toolbar (search, the minimum-level control, the error/warn counts,
+ * copy and clear), the per-source `FilterChip`s (only when there is more than one stream), the
+ * empty states, the windowed rows — each a `Row` whose label is the time, the level `Badge`, the
+ * source and the message, with a repeat badge trailing and the expanded record as a `Code` block
+ * under it — and the status bar. What a declaration cannot hold: the SCROLLER (`console/Scroller`,
+ * the element the virtualizer measures and follow-mode pins to the bottom) — the one runtime-bound
+ * unit. Which row is expanded lives in the controller now, not in React state.
+ */
+
+interface ConsoleViewRow {
+    id: string;
+    time?: string;
+    level: string;
+    tone: 'neutral' | 'info' | 'warning' | 'error';
+    source?: string;
+    message: string;
+    repeat?: string;
+    expanded: boolean;
+    detail?: string;
+}
+interface ConsoleViewSource {
+    id: string;
+    label: string;
+    on: boolean;
+    title: string;
+}
+interface ConsoleViewModel {
+    search: string;
+    levels: {
+        value: string;
+        label: string;
+    }[];
+    level: string;
+    errors?: string;
+    warns?: string;
+    multiSource: boolean;
+    sources: ConsoleViewSource[];
+    empty: boolean;
+    emptyTitle: string;
+    emptyHint: string;
+    listed: boolean;
+    rowHeight: number;
+    totalHeight: number;
+    offsetTop: number;
+    rows: ConsoleViewRow[];
+    countLabel: string;
+    followLabel?: string;
+}
+type ConsoleUiIntent = {
+    kind: 'search';
+    value: string;
+} | {
+    kind: 'level';
+    level: string;
+} | {
+    kind: 'copyVisible';
+} | {
+    kind: 'clear';
+} | {
+    kind: 'source';
+    id: string;
+    on: boolean;
+} | {
+    kind: 'row';
+    id: string;
+} | {
+    kind: 'contextMenu';
+    id: string;
+    x: number;
+    y: number;
+};
+interface ConsoleViewOptions {
+    rowHeight?: number;
+    showTimestamps?: boolean;
+    emptyHint?: string;
+}
+/** Derive the view from the live controller — the runtime calls this on every draw. */
+declare function consoleViewState(c: ConsoleController, options?: ConsoleViewOptions): ConsoleViewModel;
+declare function applyConsoleUi(c: ConsoleController, intent: ConsoleUiIntent): void;
+declare const consoleViewManifest: PanelManifest;
+declare const BEHAVIOURS: {
+    'ops/consolePanelView': (inputs: Record<string, unknown>) => ConsoleViewModel;
+};
+/** The runtime-bound unit: the scroller the virtualizer measures and follow-mode pins. */
+declare const CONSOLE_RUNTIME_UNITS: readonly ["console/Scroller"];
+declare const CONSOLE_DECLARATION: BlockDeclaration;
+
+/**
+ * The Console panel view — the CODE VIEW of `CONSOLE_DECLARATION`, drawing the same
+ * `ConsoleViewModel` byte-identical (the equivalence suite holds the two together). The one thing this
+ * file owns that the declaration cannot is `console/Scroller`: the element the virtualizer measures,
+ * whose scroll position the controller mirrors, and which follow-mode pins to the bottom.
  *
  * Composes `@xenosystem/components/chrome`; the host must ensure `@xenosystem/workbench/primitives.css` is
  * present.
@@ -521,14 +627,18 @@ declare const consoleManifest: PanelManifest;
  */
 
 /** Props for {@link ConsolePanelView}. */
-interface ConsolePanelViewProps {
+interface ConsolePanelViewProps extends ConsoleViewOptions {
     controller: ConsoleController;
-    rowHeight?: number;
-    showTimestamps?: boolean;
-    emptyHint?: string;
 }
+/** `console/Scroller` — measures the viewport for the virtualizer, mirrors scroll, pins follow-mode to the bottom. */
+declare function ConsoleScroller({ controller, rowHeight, children }: {
+    controller: ConsoleController;
+    rowHeight?: number;
+    children?: ReactNode;
+}): ReactElement;
+declare function consoleRuntimeComponents(controller: ConsoleController, rowHeight?: number): Record<(typeof CONSOLE_RUNTIME_UNITS)[number], React.ComponentType<any>>;
 /** The Console panel view. */
-declare function ConsolePanelView({ controller, rowHeight, showTimestamps, emptyHint, }: ConsolePanelViewProps): ReactNode;
+declare function ConsolePanelView({ controller, ...options }: ConsolePanelViewProps): ReactNode;
 
 /**
  * The `xeno.core.runs` contract.
@@ -2232,4 +2342,4 @@ interface DiffPanelViewProps {
 /** The Diff panel view. */
 declare function DiffPanelView({ controller, highlighter, review }: DiffPanelViewProps): ReactNode;
 
-export { ALL_STATUSES, CONSOLE_PANEL_ID, ConsoleController, type ConsoleControllerOptions, type ConsoleHostBridge, type ConsolePanelState, ConsolePanelView, type ConsolePanelViewProps, type ConsoleRenderContext, type ConsoleViewState, type CreateConsolePanelOptions, type CreateDiffPanelOptions, type CreateRunsPanelOptions, type CreateTerminalPanelOptions, DEFAULT_MAX_STEP_DEPTH, DIFF_PANEL_ID, DiffController, type DiffControllerOptions, type DiffFileView, type DiffHostBridge, type DiffPanelState, DiffPanelView, type DiffPanelViewProps, type DiffRenderContext, type DiffViewState, type FlattenOptions, LEVEL_ORDER, MESSAGE_ELISION, REDACTION_CARRY, RUNS_PANEL_ID, RUN_PATH_SEPARATOR, RUN_STATUSES, RunsController, type RunsControllerOptions, type RunsHostBridge, type RunsPanelState, RunsPanelView, type RunsPanelViewProps, type RunsRenderContext, type RunsViewState, TERMINAL_PANEL_ID, TERMINAL_STATUSES, TerminalController, type TerminalControllerOptions, type TerminalHostBridge, type TerminalInstanceView, type TerminalPanelState, TerminalPanelView, type TerminalPanelViewProps, type TerminalRenderContext, type TerminalViewState, XENO_TERMINAL_THEME_KEYS, type XenoDiffAction, type XenoDiffDecision, type XenoDiffDecisionIntent, type XenoDiffDecisionState, type XenoDiffFile, type XenoDiffFileOmission, type XenoDiffHighlighter, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, type XenoDiffModel, type XenoDiffNavigate, type XenoDiffSegment, type XenoDiffStatus, type XenoDiffView, type XenoLogActivate, type XenoLogDelta, type XenoLogFilter, type XenoLogLevel, type XenoLogPatch, type XenoLogRecord, type XenoLogSource, type XenoRun, type XenoRunAction, type XenoRunActivate, type XenoRunDelta, type XenoRunError, type XenoRunFilter, type XenoRunLifecycle, type XenoRunPath, type XenoRunRow, type XenoRunRunRow, type XenoRunStats, type XenoRunStatus, type XenoRunStep, type XenoRunStepAppend, type XenoRunStepPatch, type XenoRunStepRow, type XenoRunTruncation, type XenoTerminalData, type XenoTerminalEmulator, type XenoTerminalId, type XenoTerminalIntent, type XenoTerminalSession, type XenoTerminalStatus, type XenoTerminalTheme, appendStepsAtPath, canCancel, canRetry, collapseAdjacent, computeStats, consoleManifest, consolePanel, countChanges, createConsolePanel, createDiffPanel, createRunsPanel, createTerminalPanel, decodeRunPath, diffManifest, diffPanel, durationOf, encodeRunPath, flattenHunks, flattenRunRows, formatDuration, formatRecord, isActive, isLive, isSettled, isTerminal, isWaiting, lifecycleOf, matchesSearch as matchesRunSearch, matchesSearch$1 as matchesSearch, measuredSize, meetsLevel, needsAttention, omissionLabel, patchStepAtPath, queueDurationOf, readTerminalTheme, resolveStepPath, runsManifest, runsPanel, safeJson, spliceRedactedAppend, splitRows, statusLabel, terminalManifest, terminalPanel, terminalThemeVar, truncateLogMessage };
+export { ALL_STATUSES, BEHAVIOURS as CONSOLE_BEHAVIOURS, CONSOLE_DECLARATION, CONSOLE_PANEL_ID, CONSOLE_RUNTIME_UNITS, ConsoleController, type ConsoleControllerOptions, type ConsoleHostBridge, type ConsolePanelState, ConsolePanelView, type ConsolePanelViewProps, type ConsoleRenderContext, ConsoleScroller, type ConsoleUiIntent, type ConsoleViewModel, type ConsoleViewOptions, type ConsoleViewRow, type ConsoleViewSource, type ConsoleViewState, type CreateConsolePanelOptions, type CreateDiffPanelOptions, type CreateRunsPanelOptions, type CreateTerminalPanelOptions, DEFAULT_MAX_STEP_DEPTH, DIFF_PANEL_ID, DiffController, type DiffControllerOptions, type DiffFileView, type DiffHostBridge, type DiffPanelState, DiffPanelView, type DiffPanelViewProps, type DiffRenderContext, type DiffViewState, type FlattenOptions, LEVEL_ORDER, MESSAGE_ELISION, REDACTION_CARRY, RUNS_PANEL_ID, RUN_PATH_SEPARATOR, RUN_STATUSES, RunsController, type RunsControllerOptions, type RunsHostBridge, type RunsPanelState, RunsPanelView, type RunsPanelViewProps, type RunsRenderContext, type RunsViewState, TERMINAL_PANEL_ID, TERMINAL_STATUSES, TerminalController, type TerminalControllerOptions, type TerminalHostBridge, type TerminalInstanceView, type TerminalPanelState, TerminalPanelView, type TerminalPanelViewProps, type TerminalRenderContext, type TerminalViewState, XENO_TERMINAL_THEME_KEYS, type XenoDiffAction, type XenoDiffDecision, type XenoDiffDecisionIntent, type XenoDiffDecisionState, type XenoDiffFile, type XenoDiffFileOmission, type XenoDiffHighlighter, type XenoDiffHunk, type XenoDiffLine, type XenoDiffLineKind, type XenoDiffModel, type XenoDiffNavigate, type XenoDiffSegment, type XenoDiffStatus, type XenoDiffView, type XenoLogActivate, type XenoLogDelta, type XenoLogFilter, type XenoLogLevel, type XenoLogPatch, type XenoLogRecord, type XenoLogSource, type XenoRun, type XenoRunAction, type XenoRunActivate, type XenoRunDelta, type XenoRunError, type XenoRunFilter, type XenoRunLifecycle, type XenoRunPath, type XenoRunRow, type XenoRunRunRow, type XenoRunStats, type XenoRunStatus, type XenoRunStep, type XenoRunStepAppend, type XenoRunStepPatch, type XenoRunStepRow, type XenoRunTruncation, type XenoTerminalData, type XenoTerminalEmulator, type XenoTerminalId, type XenoTerminalIntent, type XenoTerminalSession, type XenoTerminalStatus, type XenoTerminalTheme, appendStepsAtPath, applyConsoleUi, canCancel, canRetry, collapseAdjacent, computeStats, consoleManifest, consolePanel, consoleRuntimeComponents, consoleViewManifest, consoleViewState, countChanges, createConsolePanel, createDiffPanel, createRunsPanel, createTerminalPanel, decodeRunPath, diffManifest, diffPanel, durationOf, encodeRunPath, flattenHunks, flattenRunRows, formatDuration, formatRecord, isActive, isLive, isSettled, isTerminal, isWaiting, lifecycleOf, matchesSearch as matchesRunSearch, matchesSearch$1 as matchesSearch, measuredSize, meetsLevel, needsAttention, omissionLabel, patchStepAtPath, queueDurationOf, readTerminalTheme, resolveStepPath, runsManifest, runsPanel, safeJson, spliceRedactedAppend, splitRows, statusLabel, terminalManifest, terminalPanel, terminalThemeVar, truncateLogMessage };