@kgdiff/viewer 0.3.0 → 0.5.0

package/README.md

@@ -1,7 +1,7 @@
 # @kgdiff/viewer
 
-`<kgdiff-viewer>`, a framework-agnostic web component for reviewing graph diffs. Four views
-(Overlay, Swipe, Replay and Changes only), a searchable change list, a detail panel with
+`<kgdiff-viewer>`, a framework-agnostic web component for reviewing graph diffs. Three ways to
+compare (Overlay, Swipe, Replay), each with or without Changes only, a searchable change list, a detail panel with
 character-level diffs, review progress, deep links, keyboard shortcuts, light and dark themes, and
 an English and Chinese UI.
 
@@ -37,9 +37,10 @@ ESM only. Runs in evergreen browsers.
   self-contained script that defines the element and shows embedded payloads. The optional
   `@kgdiff/viewer/standalone/compute` add-on brings the diff engine and force layout for `load()`.
 
-Attributes: `mode` (`overlay` | `swipe` | `replay` | `changes`), `theme`, `palette`, `locale`,
-`sidebar`, `sync-hash`, `global-shortcuts`, `header`, `chrome`, `legend`, `loop`, `loop-delay`,
-`pause-on-hover`. Methods: `load`, `selectHunk`, `next`, `prev`, `play`, `pause`, `fit`,
+Attributes: `mode` (`overlay` | `swipe` | `replay`), `scope` (`all` | `changes`), `theme`,
+`palette`, `locale`, `sidebar`, `sync-hash`, `global-shortcuts`, `header`, `chrome`, `legend`,
+`loop`, `loop-delay`, `pause-on-hover`. The legacy `mode="changes"` still works: it means
+`overlay` with `scope="changes"`. Methods: `load`, `selectHunk`, `next`, `prev`, `play`, `pause`, `fit`,
 `exportDelta`, `reviewState`, `setReviewed`. Events: `kgdiff-ready`, `kgdiff-select`,
 `kgdiff-mode`, `kgdiff-review`, `kgdiff-error`, `kgdiff-replay-end`.
 
@@ -60,9 +61,9 @@ replay loop:
 | `loop-delay` (`loopDelay`)        | ms between the end and restart | `1200`                                           |
 | `pause-on-hover` (`pauseOnHover`) | `false` to keep playing        | on: a looping replay pauses under a mouse or pen |
 
-- `chrome="none"` shows the graph alone: no header (view switch, theme, full screen, help,
-  sidebar button), change list, step caption, playback bar, finished card, zoom buttons, minimap
-  or legend card. The hover tooltip stays, and the legend becomes one line with the families this
+- `chrome="none"` shows the graph alone: no title, actions (theme, help, sidebar button), view
+  dock (with its step caption, playback bar and finished card), change list, zoom buttons,
+  minimap or legend card. The hover tooltip stays, and the legend becomes one line with the families this
   diff has, then unchanged. Clicks and keyboard shortcuts do nothing. The minimum height drops
   from 420px to 120px. The view stays fitted: when the canvas is resized (unless the user
   panned or zoomed since) and at the start of every loop. Labels are never cut at the edge: one

package/dist/context.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The Web Components community context protocol
+ * (https://github.com/webcomponents-cg/community-protocols/blob/main/proposals/context.md),
+ * without dependencies: how the viewer's regions find the root whose session they show
+ * (RFC 0001 §2).
+ *
+ * A consumer dispatches a `context-request` event (bubbling, composed: it crosses shadow roots
+ * on its way up); the nearest provider of that context answers through the callback and stops
+ * the event. Requests nobody answered reach `document`, where they wait; a provider that
+ * connects later announces itself with `context-provider` and the waiting requests are sent
+ * again, so definition and connection order do not matter. A consumer outside the provider's
+ * subtree sends its request through an element inside it (`via`: the root named by `for`).
+ */
+export interface Context<T> {
+    /**
+     * `Symbol.for(name)`: equal across copies of the library on one page (an IIFE report bundle
+     * next to an ESM build), so a component of one copy finds the root of another. The name is
+     * versioned when the provided value changes incompatibly.
+     */
+    readonly key: symbol;
+    /** Carries the value type only. */
+    readonly __value?: T;
+}
+export declare const createContext: <T>(name: string) => Context<T>;
+export declare class ContextRequestEvent<T> extends Event {
+    readonly context: Context<T>;
+    /** The consumer, which may differ from the element the event is dispatched on (`via`). */
+    readonly consumer: Element;
+    readonly callback: (value: T) => void;
+    constructor(context: Context<T>, 
+    /** The consumer, which may differ from the element the event is dispatched on (`via`). */
+    consumer: Element, callback: (value: T) => void);
+}
+export declare class ContextProviderEvent<T> extends Event {
+    readonly context: Context<T>;
+    constructor(context: Context<T>);
+}
+/** Ask for `context` for `consumer`, through `via` (an element of the provider's subtree). */
+export declare function requestContext<T>(consumer: Element, context: Context<T>, callback: (value: T) => void, via?: Element | null): void;
+/** Answer requests for `context` reaching `host`; returns the function that stops answering. */
+export declare function provideContext<T>(host: Element, context: Context<T>, value: () => T): () => void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;CACtB;AAED,eAAO,MAAM,aAAa,GAAI,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,CAAC,CAAgC,CAAC;AAE1F,qBAAa,mBAAmB,CAAC,CAAC,CAAE,SAAQ,KAAK;IAE7C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,OAAO;IAC1B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI;IAJvC,YACW,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,0FAA0F;IACjF,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAGtC;CACF;AAED,qBAAa,oBAAoB,CAAC,CAAC,CAAE,SAAQ,KAAK;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAAxC,YAAqB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAEvC;CACF;AAwCD,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC5B,GAAG,GAAE,OAAO,GAAG,IAAW,GACzB,IAAI,CAGN;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,IAAI,CAWhG"}

package/dist/context.js

@@ -0,0 +1,87 @@
+/**
+ * The Web Components community context protocol
+ * (https://github.com/webcomponents-cg/community-protocols/blob/main/proposals/context.md),
+ * without dependencies: how the viewer's regions find the root whose session they show
+ * (RFC 0001 §2).
+ *
+ * A consumer dispatches a `context-request` event (bubbling, composed: it crosses shadow roots
+ * on its way up); the nearest provider of that context answers through the callback and stops
+ * the event. Requests nobody answered reach `document`, where they wait; a provider that
+ * connects later announces itself with `context-provider` and the waiting requests are sent
+ * again, so definition and connection order do not matter. A consumer outside the provider's
+ * subtree sends its request through an element inside it (`via`: the root named by `for`).
+ */
+export const createContext = (name) => ({ key: Symbol.for(name) });
+export class ContextRequestEvent extends Event {
+    context;
+    consumer;
+    callback;
+    constructor(context, 
+    /** The consumer, which may differ from the element the event is dispatched on (`via`). */
+    consumer, callback) {
+        super('context-request', { bubbles: true, composed: true });
+        this.context = context;
+        this.consumer = consumer;
+        this.callback = callback;
+    }
+}
+export class ContextProviderEvent extends Event {
+    context;
+    constructor(context) {
+        super('context-provider', { bubbles: true, composed: true });
+        this.context = context;
+    }
+}
+const waiting = new Set();
+let collecting = false;
+/** Keep the requests nobody answered, and send them again when a provider connects. */
+function collect() {
+    if (collecting || typeof document === 'undefined')
+        return;
+    collecting = true;
+    document.addEventListener('context-request', (e) => {
+        // Consumers that left the document since they asked are forgotten, closures and all.
+        for (const w of waiting)
+            if (!w.consumer.isConnected)
+                waiting.delete(w);
+        const r = e;
+        waiting.add({
+            context: r.context,
+            consumer: r.consumer,
+            via: e.composedPath()[0] ?? r.consumer,
+            callback: r.callback,
+        });
+    });
+    document.addEventListener('context-provider', (e) => {
+        const key = e.context.key;
+        for (const w of [...waiting]) {
+            if (w.context.key !== key)
+                continue;
+            waiting.delete(w);
+            // Unanswered again: it waits again on its way through `document`.
+            if (w.consumer.isConnected) {
+                w.via.dispatchEvent(new ContextRequestEvent(w.context, w.consumer, w.callback));
+            }
+        }
+    });
+}
+/** Ask for `context` for `consumer`, through `via` (an element of the provider's subtree). */
+export function requestContext(consumer, context, callback, via = null) {
+    collect();
+    (via ?? consumer).dispatchEvent(new ContextRequestEvent(context, consumer, callback));
+}
+/** Answer requests for `context` reaching `host`; returns the function that stops answering. */
+export function provideContext(host, context, value) {
+    collect();
+    const answer = (e) => {
+        const r = e;
+        if (r.context?.key !== context.key)
+            return;
+        e.stopPropagation();
+        r.callback(value());
+    };
+    host.addEventListener('context-request', answer);
+    host.dispatchEvent(new ContextProviderEvent(context));
+    return () => host.removeEventListener('context-request', answer);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,IAAY,EAAc,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAE1F,MAAM,OAAO,mBAAuB,SAAQ,KAAK;IAEpC,OAAO;IAEP,QAAQ;IACR,QAAQ;IAJnB,YACW,OAAmB;IAC5B,0FAA0F;IACjF,QAAiB,EACjB,QAA4B;QAErC,KAAK,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;uBALnD,OAAO;wBAEP,QAAQ;wBACR,QAAQ;IAGnB,CAAC;CACF;AAED,MAAM,OAAO,oBAAwB,SAAQ,KAAK;IAC3B,OAAO;IAA5B,YAAqB,OAAmB;QACtC,KAAK,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;uBAD1C,OAAO;IAE5B,CAAC;CACF;AASD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAW,CAAC;AACnC,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,uFAAuF;AACvF,SAAS,OAAO;IACd,IAAI,UAAU,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC1D,UAAU,GAAG,IAAI,CAAC;IAClB,QAAQ,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE;QACjD,qFAAqF;QACrF,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;gBAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,GAAG,CAAiC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC;YACV,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,GAAG,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ;YACtC,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE;QAClD,MAAM,GAAG,GAAI,CAAmC,CAAC,OAAO,CAAC,GAAG,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG;gBAAE,SAAS;YACpC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAClB,kEAAkE;YAClE,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,mBAAmB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAC5B,QAAiB,EACjB,OAAmB,EACnB,QAA4B,EAC5B,GAAG,GAAmB,IAAI;IAE1B,OAAO,EAAE,CAAC;IACV,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC,aAAa,CAAC,IAAI,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAAI,IAAa,EAAE,OAAmB,EAAE,KAAc;IAClF,OAAO,EAAE,CAAC;IACV,MAAM,MAAM,GAAG,CAAC,CAAQ,EAAQ,EAAE;QAChC,MAAM,CAAC,GAAG,CAA2B,CAAC;QACtC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG;YAAE,OAAO;QAC3C,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IACtB,CAAC,CAAC;IACF,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,aAAa,CAAC,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AACnE,CAAC"}

package/dist/controller.d.ts

@@ -1,52 +1,29 @@
 /**
- * Viewer state and orchestration, independent of the UI:
+ * The canvas side of the viewer: a `DiffSession` (state, commands, events; `session.ts`) plus
+ * the one view that draws it (RFC 0001 §1: renderer, camera, framing, minimap), behind the
+ * `SessionView` boundary. Phase 3 of the RFC moves this view out into a `StageView` of its own,
+ * so one session can drive several canvases.
  *
- * - load pipeline with progress steps (sources or a precomputed report);
- * - mode, selection (with an animated spotlight `emphasis`), family filters, review progress;
- * - changes-only focus with expandable collapsed groups (`extendLayout` + scene rebuild);
- * - replay clock driven by one requestAnimationFrame loop that sleeps when idle, with a camera
- *   that follows the playing hunk / chapter unless the user moved it in the last 2 s;
- * - swipe position, hover, theme / palette / locale (rebuilding the scene when they change).
- *
- * The UI subscribes to topic notifications (batched per microtask) and reads public fields.
+ * - draws the session's view state into the renderer (and the minimap, throttled while
+ *   replaying);
+ * - frames what the session asks for in the free part of the canvas, clear of the chrome over
+ *   it (`framing.ts`); the replay camera follows the playing hunk / chapter unless the user
+ *   moved it in the last 2 s;
+ * - fits a new diff once the canvas is laid out, and again on resize with `autoFit`;
+ * - turns canvas hovers and clicks into session commands.
  */
-import type { DiffResult, DiffStats, Locale, Rect, UnionId } from '@kgdiff/core';
-import type { LayoutResult } from '@kgdiff/layout';
+import type { Rect } from '@kgdiff/core';
 import { type Camera } from '@kgdiff/renderer';
-import { type ChangeFamily, type FocusState, type PaletteName, type Scene, type Theme, type ThemeName, type VisualResolver } from '@kgdiff/scene';
 import { type ChromeLayout } from './framing.js';
-import type { LoadOptions, ReportPayload, ReviewState, ThemePreference, ViewerMode } from './index.js';
-import { type ListModel } from './list-model.js';
-import { type LoadedDiff, type LoadStep } from './pipeline.js';
-import { ReplayClock } from './replay.js';
-import { type StorageLike } from './review-store.js';
-import { type SearchHit } from './search.js';
-export type Status = 'idle' | 'loading' | 'ready' | 'error';
-export type Topic = 'status' | 'data' | 'mode' | 'selection' | 'filters' | 'review' | 'replay' | 'hover' | 'theme' | 'locale' | 'focus' | 'swipe';
-export interface ControllerHost {
-    ready(stats: DiffStats): void;
-    select(hunk: string | null, node: string | null): void;
-    mode(mode: ViewerMode): void;
-    review(hunk: string, reviewed: boolean, progress: ReviewState): void;
-    error(error: Error): void;
-    announce(text: string): void;
-    /** Playback reached the end of the replay; `loop`: it starts again after the loop delay. */
-    replayEnd(loop: boolean): void;
-}
+import { DiffSession, type SessionDeps, type SessionHost, type SessionView } from './session.js';
+export type { Preference, Status, Topic } from './session.js';
+export type ControllerHost = SessionHost;
+export type ControllerDeps = SessionDeps;
 export interface FitOptions {
     readonly animate?: boolean;
     /** Room around the content, px (default `FRAME_PADDING`); kept for later automatic fits. */
     readonly padding?: number;
 }
-export interface ControllerDeps {
-    readonly now: () => number;
-    readonly requestFrame: (cb: (time: number) => void) => number;
-    readonly cancelFrame: (id: number) => void;
-    /** Resolves once the browser had a chance to paint (between loading steps). */
-    readonly yieldToPaint: () => Promise<void>;
-    readonly storage: StorageLike | null;
-}
-export type Preference = 'mode' | 'theme' | 'palette' | 'locale';
 /** Camera follow is suppressed this long after the user moved the camera (ms). */
 export declare const USER_CAMERA_GRACE = 2000;
 /** The camera follows when less than this share of the target bounds is in view. */
@@ -55,42 +32,12 @@ export declare const FOLLOW_COVERAGE = 0.7;
 export declare const FLY_MAX_ZOOM = 1.8;
 /** Fitting everything never zooms in further (the renderer's default). */
 export declare const FIT_MAX_ZOOM = 2.5;
+/** Everything counts as in view (the minimap hides) from this share of the content bounds on. */
+export declare const OVERVIEW_COVERAGE = 0.98;
 /** Share of `bounds` inside `view`, in [0, 1]. */
 export declare function coverage(bounds: Rect, view: Rect): number;
-export declare class ViewerController {
+export declare class ViewerController extends DiffSession implements SessionView {
     #private;
-    status: Status;
-    /** Steps of the current load, in order; `step` is the running one. */
-    steps: LoadStep[];
-    step: LoadStep | null;
-    error: Error | null;
-    data: LoadedDiff | null;
-    layout: LayoutResult | null;
-    scene: Scene | null;
-    resolver: VisualResolver | null;
-    list: ListModel;
-    mode: ViewerMode;
-    themePreference: ThemePreference;
-    palette: PaletteName;
-    locale: Locale;
-    systemDark: boolean;
-    reducedMotion: boolean;
-    /** Preferences set explicitly by the embedder (a report's `view` does not override them). */
-    readonly explicit: Set<Preference>;
-    selectedHunk: number;
-    selectedNode: number;
-    /** An edge emphasized from the detail panel (drawn as hovered). */
-    pinnedEdge: number;
-    hoverNode: number;
-    hoverEdge: number;
-    hoverGroup: number;
-    readonly families: Set<ChangeFamily>;
-    hops: number;
-    readonly expanded: Set<string>;
-    focus: FocusState | null;
-    clock: ReplayClock | null;
-    split: number;
-    emphasis: number;
     /**
      * Keep the view fitted (embeds without controls): fit again when the canvas is resized unless
      * the user moved the camera since, and at the start of every loop.
@@ -98,21 +45,9 @@ export declare class ViewerController {
     autoFit: boolean;
     /** Canvas clicks select (and double clicks fly); off for embeds without controls. */
     selectOnClick: boolean;
-    constructor(host: ControllerHost, deps: ControllerDeps);
-    subscribe(listener: (topics: ReadonlySet<Topic>) => void): () => void;
-    /** Deliver pending notifications now (also used by tests). */
-    flush(): void;
-    get themeName(): ThemeName;
-    get theme(): Theme;
-    get diff(): DiffResult | null;
-    get hunkCount(): number;
-    isReviewed(hunkId: string): boolean;
-    reviewState(): ReviewState;
-    search(query: string, limit?: number): SearchHit[];
-    load(options: LoadOptions): Promise<void>;
-    loadPayload(payload: ReportPayload): Promise<void>;
-    /** Show an error state (bad payload, failed load). */
-    fail(error: Error): void;
+    /** The whole content is in view (the minimap has nothing to add). */
+    overview: boolean;
+    constructor(host: SessionHost, deps: SessionDeps);
     attach(stage: HTMLElement, minimapHost: HTMLElement | null): void;
     detach(): void;
     destroy(): void;
@@ -134,99 +69,21 @@ export declare class ViewerController {
     layoutChanged(): void;
     /** The user panned / zoomed: suspend replay camera follow for `USER_CAMERA_GRACE`. */
     noteUserCamera(): void;
-    /** Redraw on the next animation frame. */
-    invalidate(): void;
     /** Resolve the current view and hand it to the renderer (and the minimap). */
     draw(now?: number): void;
-    setMode(value: ViewerMode): void;
-    selectHunkById(id: string | null, options?: {
-        fly?: boolean;
-    }): void;
-    /**
-     * Select hunk `h` (scene index; -1 clears). `node` focuses one of its nodes in the detail
-     * panel. `fly` (default true) brings it into view. In replay, seeks to the end of its window.
-     */
-    selectHunk(h: number, options?: {
-        fly?: boolean;
-        node?: number;
-    }): void;
-    /** Select a node: its hunk when it has one, else the node itself. */
-    selectNode(i: number, options?: {
-        fly?: boolean;
-    }): void;
-    clearSelection(): void;
-    next(): void;
-    prev(): void;
-    first(): void;
-    last(): void;
-    /** Emphasize an edge (from the detail panel) and fly to it. */
-    pinEdge(j: number): void;
-    flyToHunk(h: number): void;
-    flyToNode(i: number): void;
-    flyToSelection(): void;
+    sceneChanged(): void;
+    installed(): void;
+    drawnChanged(): void;
+    show(bounds: Rect): void;
+    /** Follow `bounds` (replay): fly unless the user steered recently or it is mostly visible. */
+    follow(bounds: Rect): void;
+    looped(): void;
+    viewport(): Rect | null;
     /**
      * Fit everything visible (the focus in changes-only mode), labels included, into the free part
      * of the canvas. Before the canvas is laid out it falls back to the renderer's own fit.
      */
     fit(options?: FitOptions): Promise<void>;
     zoom(direction: 1 | -1): void;
-    /** Clear hover state (pointer left the canvas). */
-    clearHover(): void;
-    toggleFamily(family: ChangeFamily): void;
-    /** Replace the family filter (empty = all). Setting the current set again clears it. */
-    setFamilies(families: readonly ChangeFamily[]): void;
-    setHops(hops: number): void;
-    /**
-     * Expand collapsed group `index` of the current focus: its in-scene members become visible
-     * and, for a `changes`-scoped layout, the neighbours left out of the layout are placed with
-     * `extendLayout` (nothing already placed moves) and the scene is rebuilt.
-     */
-    expandGroup(index: number): void;
-    /**
-     * The collapsed group nearest the selection (else the view center), or -1. Groups that can
-     * be expanded at least partly come first.
-     */
-    nearestGroup(): number;
-    /** Expand the group nearest the selection (keyboard `e`); announces what happened. */
-    expandNearest(): void;
-    /**
-     * Whether collapsed group `index` can be expanded completely: always, unless some members lie
-     * outside a `changes`-scoped layout and the layout engine is known to be unavailable
-     * (standalone report without the compute add-on).
-     */
-    canExpand(index: number): boolean;
-    /** Bring a union node into the scene and the focus (search results), then select it. */
-    revealNode(id: UnionId): Promise<void>;
-    play(): void;
-    /** Pause; a looping replay stays paused (until `play`, a new diff or loop turned on again). */
-    pause(): void;
-    togglePlay(): void;
-    /**
-     * Play the replay over and over: `delay` ms after it ends it starts again; null plays it
-     * once. Turning the loop on starts a replay that is shown but not playing.
-     */
-    setLoop(delay: number | null): void;
-    get loopDelay(): number | null;
-    /**
-     * Hold playback while the pointer rests on the graph (`pause-on-hover`): a playing replay
-     * pauses and continues on release; a pending loop restart waits for the release, then the
-     * full loop delay.
-     */
-    hold(held: boolean): void;
-    seek(t: number): void;
-    stepReplay(direction: 1 | -1): void;
-    restart(): void;
-    cycleSpeed(): void;
-    setSpeed(speed: number): void;
-    setSplit(split: number): void;
-    setReviewed(hunkId: string, reviewed: boolean): void;
-    /** Another tab changed review progress (`storage` event): re-read it. */
-    syncReview(key: string | null): void;
-    toggleReviewed(hunkId?: string): void;
-    setThemePreference(pref: ThemePreference): void;
-    setPalette(palette: PaletteName): void;
-    setLocale(locale: Locale): void;
-    setSystemDark(dark: boolean): void;
-    setReducedMotion(reduced: boolean): void;
 }
 //# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EACL,KAAK,YAAY,EAOlB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EAEX,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC9D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AACzC,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,oFAAoF;AACpF,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,sFAAsF;AACtF,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,0EAA0E;AAC1E,eAAO,MAAM,YAAY,MAAM,CAAC;AAGhC,iGAAiG;AACjG,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAQtC,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAazD;AAED,qBAAa,gBAAiB,SAAQ,WAAY,YAAW,WAAW;;IACtE;;;OAGG;IACH,OAAO,UAAS;IAChB,qFAAqF;IACrF,aAAa,UAAQ;IACrB,qEAAqE;IACrE,QAAQ,UAAQ;IAyBhB,YAAY,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAI/C;IAID,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAsBhE;IAED,MAAM,IAAI,IAAI,CASb;IAEQ,OAAO,IAAI,IAAI,CAGvB;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,YAAY,CAAC,GAAG,IAAI,GAAG,IAAI,CAErD;IAED;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGrC;IAED;;;OAGG;IACH,aAAa,IAAI,IAAI,CAmBpB;IAED,sFAAsF;IACtF,cAAc,IAAI,IAAI,CAGrB;IAID,8EAA8E;IAC9E,IAAI,CAAC,GAAG,SAAc,GAAG,IAAI,CA0B5B;IAED,YAAY,IAAI,IAAI,CAKnB;IAED,SAAS,IAAI,IAAI,CAMhB;IAED,YAAY,IAAI,IAAI,CAGnB;IAED,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAEvB;IAED,8FAA8F;IAC9F,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,CAKzB;IAED,MAAM,IAAI,IAAI,CAEb;IAED,QAAQ,IAAI,IAAI,GAAG,IAAI,CAEtB;IA8BD;;;OAGG;IACH,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3C;IAqED,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAG5B;CA4CF"}