@xenosystem/blocks 0.13.17 → 0.13.19

package/dist/icons/index.js

@@ -2,7 +2,7 @@ import {
   ICONS,
   ICON_UNITS,
   Svg
-} from "../chunk-PI5WOATA.js";
+} from "../chunk-7S2RKUAM.js";
 import "../chunk-2KG3PWR4.js";
 export {
   ICONS,

package/dist/ops/index.d.ts

@@ -607,7 +607,7 @@ interface ConsoleViewOptions {
 declare function consoleViewState(c: ConsoleController, options?: ConsoleViewOptions): ConsoleViewModel;
 declare function applyConsoleUi(c: ConsoleController, intent: ConsoleUiIntent): void;
 declare const consoleViewManifest: PanelManifest;
-declare const BEHAVIOURS$1: {
+declare const BEHAVIOURS$2: {
     'ops/consolePanelView': (inputs: Record<string, unknown>) => ConsoleViewModel;
 };
 /** The runtime-bound unit: the scroller the virtualizer measures and follow-mode pins. */
@@ -1518,7 +1518,7 @@ interface RunsViewOptions {
 declare function runsViewState(c: RunsController, options?: RunsViewOptions): RunsViewModel;
 declare function applyRunsUi(c: RunsController, intent: RunsUiIntent): void;
 declare const runsViewManifest: PanelManifest;
-declare const BEHAVIOURS: {
+declare const BEHAVIOURS$1: {
     'ops/runsPanelView': (inputs: Record<string, unknown>) => RunsViewModel;
 };
 declare const RUNS_RUNTIME_UNITS: readonly [];
@@ -2424,24 +2424,173 @@ declare const DIFF_PANEL_ID = "xeno.core.diff";
 declare const diffManifest: PanelManifest;
 
 /**
- * The Diff panel view.
+ * The Diff panel AS A DECLARATION — the twentieth block written the §8d way.
  *
- * **Where primitives fit and where they do not.** Toolbar, badges, section headers and the empty
- * states are primitives. The diff body is not: a two-column, line-numbered, monospaced grid whose
- * rows must align across both columns has no primitive, and the one thing it must never be is a
- * `RowList` — those rows are variable-height and this grid's correctness depends on them not being.
+ * Presentation contract: input `view` (a {@link DiffViewModel} the runtime derives from the
+ * controller on every draw — the status decided, every file, hunk and line as DATA), output `ui`
+ * (a {@link DiffUiIntent}) applied by the runtime to the controller's own methods.
  *
- * @module
+ * A file is a `chrome/Section` (collapsible, the status as its badge, the counts as its actions); a
+ * hunk is a `chrome/Hunk` (focused by the cursor, settled once applied, the range and the decision
+ * chip in its header, the review actions at its end); a line is a `chrome/DiffLine` whose text is
+ * RUNS — the host's word-level marks when it computed them (they carry more information than a
+ * token colour, and a prose diff has no tokens at all), else the highlighter's tokens, else plain —
+ * with whitespace made visible here, in the model, when asked. Split view pairs lines in a
+ * `chrome/DiffSplitRow` with a blank side. No runtime-bound unit.
+ *
+ * Three facts the model keeps distinct because a reviewer reads them differently: a comparison that
+ * FAILED has established nothing (never "no changes"); a file OMITTED (binary, too large) was not
+ * compared (never an empty body); a decision in CONFLICT is not one that failed (the file moved, so
+ * it must be made again).
  */
 
-/** Props for {@link DiffPanelView}. */
-interface DiffPanelViewProps {
-    controller: DiffController;
+/** The half of a renderer's config the view reads. */
+interface DiffViewOptions {
     /** Optional syntax seam. No highlighter means plain text, never a missing panel. */
     highlighter?: XenoDiffHighlighter;
+    /** Show the review actions. */
     review?: boolean;
 }
+interface DiffViewRun {
+    text: string;
+    mark?: 'insert' | 'delete';
+    token?: string;
+}
+interface DiffViewLine {
+    key: string;
+    kind: 'added' | 'removed' | 'context' | 'blank';
+    gutter: (number | string)[];
+    sigil?: string;
+    runs: DiffViewRun[];
+}
+interface DiffViewSplitRow {
+    key: string;
+    left: DiffViewLine;
+    right: DiffViewLine;
+}
+interface DiffViewHunk {
+    key: string;
+    path: string;
+    id: string;
+    header: string;
+    focused: boolean;
+    settled: boolean;
+    chipPending: boolean;
+    chipConflict: boolean;
+    conflictTitle: string;
+    chipFailed: boolean;
+    failedTitle?: string;
+    chipApplied: boolean;
+    appliedText: string;
+    /** Review actions shown; `attention` swaps accept/reject for re-review. */
+    review: boolean;
+    attention: boolean;
+    deciding: boolean;
+    unified: boolean;
+    split: boolean;
+    lines: DiffViewLine[];
+    rows: DiffViewSplitRow[];
+}
+interface DiffViewFile {
+    key: string;
+    path: string;
+    title: string;
+    status: string;
+    counts: string;
+    collapsed: boolean;
+    omitted: boolean;
+    omission: string;
+    hunks: DiffViewHunk[];
+}
+interface DiffViewModel {
+    idle: boolean;
+    computing: boolean;
+    failed: boolean;
+    failedHint: string;
+    identical: boolean;
+    active: boolean;
+    view: XenoDiffView;
+    views: {
+        label: string;
+        value: XenoDiffView;
+    }[];
+    wrap: boolean;
+    wrapLabel: string;
+    whitespaceLabel: string;
+    conflictNotice?: string;
+    files: DiffViewFile[];
+    countLabel: string;
+    rightLabel: string;
+}
+type DiffUiIntent = {
+    kind: 'view';
+    view: XenoDiffView;
+} | {
+    kind: 'toggleWrap';
+} | {
+    kind: 'toggleWhitespace';
+} | {
+    kind: 'prev';
+} | {
+    kind: 'next';
+} | {
+    kind: 'collapse';
+    path: string;
+    collapsed: boolean;
+} | {
+    kind: 'contextMenu';
+    path: string;
+    id: string;
+    x: number;
+    y: number;
+} | {
+    kind: 'decide';
+    path: string;
+    id: string;
+    action: 'accept' | 'reject';
+} | {
+    kind: 'reReview';
+    path: string;
+    id: string;
+};
+/** Derive the view model from the live controller — the runtime calls this on every draw. */
+declare function diffViewState(c: DiffController, options?: DiffViewOptions): DiffViewModel;
+/** Apply a `ui` intent to the controller — the runtime's half of the contract. */
+declare function applyDiffUi(c: DiffController, intent: DiffUiIntent): void;
+declare const diffViewManifest: PanelManifest;
+declare const BEHAVIOURS: {
+    'ops/diffPanelView': (inputs: Record<string, unknown>) => DiffViewModel;
+};
+declare const DIFF_DECLARATION: BlockDeclaration;
+
+/**
+ * The Diff panel view — the CODE VIEW of `DIFF_DECLARATION`, drawing the same {@link DiffViewModel}
+ * byte-identical (the equivalence suite holds the two together). No runtime-bound unit; every
+ * intent goes through `applyDiffUi`.
+ *
+ * Composes `@xenosystem/components/chrome` — a file is a `Section`, a hunk a `Hunk`, a line a
+ * `DiffLine` of runs; the host must ensure `@xenosystem/workbench/primitives.css` is present.
+ *
+ * @module
+ */
+
+/** Props for {@link DiffPanelView}. */
+interface DiffPanelViewProps extends DiffViewOptions {
+    controller: DiffController;
+}
 /** The Diff panel view. */
-declare function DiffPanelView({ controller, highlighter, review }: DiffPanelViewProps): ReactNode;
+declare function DiffPanelView({ controller, ...options }: DiffPanelViewProps): ReactNode;
+
+/**
+ * `@xenosystem/blocks/ops` — the canonical XENO Diff panel (`xeno.core.diff`).
+ *
+ * Renders a **host-computed** comparison and emits hunk decisions as intents. Bundles no diff
+ * engine and no editor.
+ *
+ * @packageDocumentation
+ */
+
+/** The unit names the runtime supplies for this block — none; every unit is a chrome unit. */
+declare const DIFF_RUNTIME_UNITS: readonly [];
 
-export { ALL_STATUSES, BEHAVIOURS$1 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, BEHAVIOURS as RUNS_BEHAVIOURS, RUNS_DECLARATION, RUNS_PANEL_ID, RUNS_RUNTIME_UNITS, RUN_PATH_SEPARATOR, RUN_STATUSES, RunsController, type RunsControllerOptions, type RunsHostBridge, type RunsPanelState, RunsPanelView, type RunsPanelViewProps, type RunsRenderContext, type RunsUiIntent, type RunsViewChip, type RunsViewModel, type RunsViewOptions, type RunsViewRow, 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, applyRunsUi, 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, runsViewManifest, runsViewState, safeJson, spliceRedactedAppend, splitRows, statusLabel, terminalManifest, terminalPanel, terminalThemeVar, toneOf, truncateLogMessage };
+export { ALL_STATUSES, BEHAVIOURS$2 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, BEHAVIOURS as DIFF_BEHAVIOURS, DIFF_DECLARATION, DIFF_PANEL_ID, DIFF_RUNTIME_UNITS, DiffController, type DiffControllerOptions, type DiffFileView, type DiffHostBridge, type DiffPanelState, DiffPanelView, type DiffPanelViewProps, type DiffRenderContext, type DiffUiIntent, type DiffViewFile, type DiffViewHunk, type DiffViewLine, type DiffViewModel, type DiffViewOptions, type DiffViewRun, type DiffViewSplitRow, type DiffViewState, type FlattenOptions, LEVEL_ORDER, MESSAGE_ELISION, REDACTION_CARRY, BEHAVIOURS$1 as RUNS_BEHAVIOURS, RUNS_DECLARATION, RUNS_PANEL_ID, RUNS_RUNTIME_UNITS, RUN_PATH_SEPARATOR, RUN_STATUSES, RunsController, type RunsControllerOptions, type RunsHostBridge, type RunsPanelState, RunsPanelView, type RunsPanelViewProps, type RunsRenderContext, type RunsUiIntent, type RunsViewChip, type RunsViewModel, type RunsViewOptions, type RunsViewRow, 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, applyDiffUi, applyRunsUi, canCancel, canRetry, collapseAdjacent, computeStats, consoleManifest, consolePanel, consoleRuntimeComponents, consoleViewManifest, consoleViewState, countChanges, createConsolePanel, createDiffPanel, createRunsPanel, createTerminalPanel, decodeRunPath, diffManifest, diffPanel, diffViewManifest, diffViewState, 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, runsViewManifest, runsViewState, safeJson, spliceRedactedAppend, splitRows, statusLabel, terminalManifest, terminalPanel, terminalThemeVar, toneOf, truncateLogMessage };