xtralab 0.15.0 → 0.15.2

package/lib/git/diffWidget.js

@@ -5,7 +5,8 @@ import { ReactWidget } from '@jupyterlab/ui-components';
 import { PromiseDelegate } from '@lumino/coreutils';
 import { Signal } from '@lumino/signaling';
 import { buildDiffAskRequest } from './askRequest';
-import { DIFF_WIDGET_CSS_CLASS, DiffStyleControl, DiffSurface, NotebookViewModeControl, isDarkTheme, isPierreTheme, readStoredDiffStyle, readStoredNotebookViewMode, writeStoredDiffStyle, writeStoredNotebookViewMode } from './diffSurface';
+import { useDiffPreferences } from './diffPreferences';
+import { DIFF_WIDGET_CSS_CLASS, DiffStyleControl, DiffSurface, LineWrapControl, NotebookViewModeControl, isDarkTheme, isPierreTheme } from './diffSurface';
 import { imageDataType } from './imageDiff';
 export { DIFF_WIDGET_CSS_CLASS };
 /**
@@ -16,21 +17,20 @@ export class XtralabDiffWidget extends ReactWidget {
         super();
         this._reloadNonce = 0;
         this._pendingRefresh = null;
-        this._notebookViewModeChanged = new Signal(this);
         this._hasNotebookView = false;
         this._hasNotebookViewChanged = new Signal(this);
-        this._diffStyleChanged = new Signal(this);
         this._fileDiffActive = false;
         this._fileDiffActiveChanged = new Signal(this);
         this._emptied = new Signal(this);
         this._model = model;
         this._context = context;
-        this._notebookViewMode = readStoredNotebookViewMode();
-        this._diffStyle = readStoredDiffStyle();
         // Reuse jupyterlab-git's host sizing while applying xtralab styling.
         this.addClass('jp-git-diff-root');
         this.addClass(DIFF_WIDGET_CSS_CLASS);
     }
+    /**
+     * The git diff model being rendered.
+     */
     get model() {
         return this._model;
     }
@@ -74,23 +74,15 @@ export class XtralabDiffWidget extends ReactWidget {
         this.update();
         await done.promise;
     }
-    get notebookViewMode() {
-        return this._notebookViewMode;
-    }
-    setNotebookViewMode(mode) {
-        if (mode === this._notebookViewMode) {
-            return;
-        }
-        this._notebookViewMode = mode;
-        writeStoredNotebookViewMode(mode);
-        this._notebookViewModeChanged.emit(mode);
-    }
-    get notebookViewModeChanged() {
-        return this._notebookViewModeChanged;
-    }
+    /**
+     * Whether a rendered notebook view is currently available.
+     */
     get hasNotebookView() {
         return this._hasNotebookView;
     }
+    /**
+     * Set whether a rendered notebook view is available.
+     */
     setHasNotebookView(value) {
         if (value === this._hasNotebookView) {
             return;
@@ -98,29 +90,21 @@ export class XtralabDiffWidget extends ReactWidget {
         this._hasNotebookView = value;
         this._hasNotebookViewChanged.emit(value);
     }
+    /**
+     * A signal emitted when rendered-notebook availability changes.
+     */
     get hasNotebookViewChanged() {
         return this._hasNotebookViewChanged;
     }
-    get diffStyle() {
-        return this._diffStyle;
-    }
-    setDiffStyle(style) {
-        if (style === this._diffStyle) {
-            return;
-        }
-        this._diffStyle = style;
-        writeStoredDiffStyle(style);
-        this._diffStyleChanged.emit(style);
-    }
-    get diffStyleChanged() {
-        return this._diffStyleChanged;
-    }
     /**
-     * Whether the Split/Unified toolbar selector currently applies.
+     * Whether the Split/Unified and line-wrap toolbar controls currently apply.
      */
     get fileDiffActive() {
         return this._fileDiffActive;
     }
+    /**
+     * Set whether the textual file diff is the active view.
+     */
     setFileDiffActive(value) {
         if (value === this._fileDiffActive) {
             return;
@@ -128,6 +112,9 @@ export class XtralabDiffWidget extends ReactWidget {
         this._fileDiffActive = value;
         this._fileDiffActiveChanged.emit(value);
     }
+    /**
+     * A signal emitted when {@link fileDiffActive} changes.
+     */
     get fileDiffActiveChanged() {
         return this._fileDiffActiveChanged;
     }
@@ -137,27 +124,44 @@ export class XtralabDiffWidget extends ReactWidget {
     get emptied() {
         return this._emptied;
     }
+    /**
+     * Emit the {@link emptied} signal.
+     */
     notifyEmptied() {
         this._emptied.emit();
     }
+    /**
+     * Resolve and clear the pending `refresh()` promise, if any.
+     */
     settleRefresh() {
         const pending = this._pendingRefresh;
         this._pendingRefresh = null;
         pending === null || pending === void 0 ? void 0 : pending.resolve();
     }
+    /**
+     * Dispose of the resources held by the widget.
+     */
     dispose() {
-        // Release any in-flight refresh awaiter so a host that awaits refresh()
-        // (jupyterlab-git re-shows its diff button only once it resolves) does not
-        // hang when the widget is torn down mid-fetch.
+        // jupyterlab-git awaits refresh() to re-show its diff button; release any
+        // in-flight awaiter so it does not hang on mid-fetch teardown.
         this.settleRefresh();
         super.dispose();
     }
+    /**
+     * A counter incremented on each `refresh()` to trigger a content re-fetch.
+     */
     get reloadNonce() {
         return this._reloadNonce;
     }
+    /**
+     * The application-level services used by the rendered diff.
+     */
     get context() {
         return this._context;
     }
+    /**
+     * Render the diff view for the current model.
+     */
     render() {
         return React.createElement(ModelDiffView, { widget: this });
     }
@@ -166,7 +170,8 @@ function ModelDiffView(props) {
     var _a, _b;
     const { widget } = props;
     const model = widget.model;
-    const { contentsManager, rendermime, themeManager, askAgent, trans } = widget.context;
+    const { contentsManager, rendermime, themeManager, askAgent, preferences, trans } = widget.context;
+    const values = useDiffPreferences(preferences);
     const nonce = widget.reloadNonce;
     const [state, setState] = React.useState({
         loading: true,
@@ -174,33 +179,15 @@ function ModelDiffView(props) {
         newText: '',
         error: null
     });
-    // Mirror toolbar-driven notebook view changes into React state.
-    const [notebookViewMode, setNotebookViewMode] = React.useState(() => widget.notebookViewMode);
-    React.useEffect(() => {
-        const handler = (sender, mode) => {
-            setNotebookViewMode(mode);
-        };
-        widget.notebookViewModeChanged.connect(handler);
-        setNotebookViewMode(widget.notebookViewMode);
-        return () => {
-            widget.notebookViewModeChanged.disconnect(handler);
-        };
-    }, [widget]);
     const handleNotebookAvailabilityChange = React.useCallback((available) => {
         widget.setHasNotebookView(available);
     }, [widget]);
-    // Mirror toolbar-driven diff-style changes into React state.
-    const [diffStyle, setDiffStyle] = React.useState(() => widget.diffStyle);
-    React.useEffect(() => {
-        const handler = (sender, style) => {
-            setDiffStyle(style);
-        };
-        widget.diffStyleChanged.connect(handler);
-        setDiffStyle(widget.diffStyle);
-        return () => {
-            widget.diffStyleChanged.disconnect(handler);
-        };
-    }, [widget]);
+    const handleSplitRatioChange = React.useCallback((splitRatio) => {
+        preferences.update({ splitRatio });
+    }, [preferences]);
+    const handleImageViewModeChange = React.useCallback((imageViewMode) => {
+        preferences.update({ imageViewMode });
+    }, [preferences]);
     const handleFileDiffActiveChange = React.useCallback((active) => {
         widget.setFileDiffActive(active);
     }, [widget]);
@@ -226,18 +213,14 @@ function ModelDiffView(props) {
             observer.disconnect();
         };
     }, [themeManager]);
-    // Image diffs use the server's base64 payloads; other binaries show a placeholder.
     const isImage = React.useMemo(() => imageDataType(model.filename) !== null, [model.filename]);
     const isBinary = model.isBinary === true && !isImage;
-    // Used by the launcher to auto-close an emptied diff after discard.
     const [hunkCount, setHunkCount] = React.useState(null);
     const handleMetadataChange = React.useCallback((info) => {
         setHunkCount(info.hunkCount);
     }, []);
-    // Fetch both sides whenever the model or reload nonce changes.
     React.useEffect(() => {
         let cancelled = false;
-        // Non-image binaries do not need content fetches.
         if (isBinary) {
             setState({ loading: false, oldText: '', newText: '', error: null });
             // An in-flight `refresh()` still has to resolve.
@@ -276,7 +259,6 @@ function ModelDiffView(props) {
             }
             finally {
                 if (!cancelled) {
-                    // Let `refresh()` settle once content has loaded.
                     widget.settleRefresh();
                 }
             }
@@ -295,7 +277,6 @@ function ModelDiffView(props) {
             widget.notifyEmptied();
         }
     }, [state.loading, state.error, isBinary, hunkCount, nonce, widget]);
-    // The launcher sets `canDiscard`; jupyterlab-git models fall back to source.
     const canDiscardHunk = (_a = model.canDiscard) !== null && _a !== void 0 ? _a : (model.challenger.source === Git.Diff.SpecialRef.WORKING &&
         model.hasConflict !== true);
     const serverPath = React.useMemo(() => { var _a; return PathExt.join((_a = model.repositoryPath) !== null && _a !== void 0 ? _a : '', model.filename); }, [model.repositoryPath, model.filename]);
@@ -309,7 +290,6 @@ function ModelDiffView(props) {
             });
         },
         onAfterSave: () => {
-            // Re-pull so the diff reflects the reverted hunk.
             void widget.refresh();
         }
     }), [canDiscardHunk, contentsManager, serverPath, widget]);
@@ -328,7 +308,7 @@ function ModelDiffView(props) {
             }));
         };
     }, [askAgent, model, state.oldText, state.newText, trans]);
-    return (React.createElement(DiffSurface, { loading: state.loading, error: state.error, isBinary: isBinary, oldText: state.oldText, newText: state.newText, newName: model.filename, oldName: (_b = model.oldFilename) !== null && _b !== void 0 ? _b : model.filename, dark: dark, pierreTheme: pierre, rendermime: rendermime, notebookViewMode: notebookViewMode, diffStyle: diffStyle, onNotebookAvailabilityChange: handleNotebookAvailabilityChange, onFileDiffActiveChange: handleFileDiffActiveChange, onMetadataChange: handleMetadataChange, hunkDiscard: hunkDiscard, onLineAsk: handleLineAsk, trans: trans }));
+    return (React.createElement(DiffSurface, { loading: state.loading, error: state.error, isBinary: isBinary, oldText: state.oldText, newText: state.newText, newName: model.filename, oldName: (_b = model.oldFilename) !== null && _b !== void 0 ? _b : model.filename, dark: dark, pierreTheme: pierre, rendermime: rendermime, notebookViewMode: values.notebookViewMode, diffStyle: values.diffStyle, lineWrap: values.lineWrap, splitRatio: values.splitRatio, onSplitRatioChange: handleSplitRatioChange, imageViewMode: values.imageViewMode, onImageViewModeChange: handleImageViewModeChange, onNotebookAvailabilityChange: handleNotebookAvailabilityChange, onFileDiffActiveChange: handleFileDiffActiveChange, onMetadataChange: handleMetadataChange, hunkDiscard: hunkDiscard, onLineAsk: handleLineAsk, trans: trans }));
 }
 /**
  * Notebook/JSON toggle mounted into a host-owned toolbar.
@@ -339,32 +319,29 @@ class NotebookViewModeToolbarItem extends ReactWidget {
         this._widget = widget;
         this.addClass('jp-xtralab-DiffWidget-viewModeToolbarItem');
     }
+    /**
+     * Render the Notebook/JSON toggle.
+     */
     render() {
         return React.createElement(NotebookViewModeToolbarControl, { widget: this._widget });
     }
 }
 function NotebookViewModeToolbarControl(props) {
     const { widget } = props;
-    const [mode, setMode] = React.useState(() => widget.notebookViewMode);
+    const { preferences, trans } = widget.context;
+    const { notebookViewMode } = useDiffPreferences(preferences);
     const [available, setAvailable] = React.useState(() => widget.hasNotebookView);
     React.useEffect(() => {
-        const onMode = (sender, next) => {
-            setMode(next);
-        };
         const onAvailable = (sender, next) => {
             setAvailable(next);
         };
-        widget.notebookViewModeChanged.connect(onMode);
         widget.hasNotebookViewChanged.connect(onAvailable);
-        setMode(widget.notebookViewMode);
         setAvailable(widget.hasNotebookView);
         return () => {
-            widget.notebookViewModeChanged.disconnect(onMode);
             widget.hasNotebookViewChanged.disconnect(onAvailable);
         };
     }, [widget]);
-    const trans = widget.context.trans;
-    return (React.createElement(NotebookViewModeControl, { mode: mode, available: available, onChange: next => widget.setNotebookViewMode(next), trans: trans }));
+    return (React.createElement(NotebookViewModeControl, { mode: notebookViewMode, available: available, onChange: next => preferences.update({ notebookViewMode: next }), trans: trans }));
 }
 /**
  * Split/Unified toggle mounted into a host-owned toolbar.
@@ -375,32 +352,60 @@ class DiffStyleToolbarItem extends ReactWidget {
         this._widget = widget;
         this.addClass('jp-xtralab-DiffWidget-diffStyleToolbarItem');
     }
+    /**
+     * Render the Split/Unified toggle.
+     */
     render() {
         return React.createElement(DiffStyleToolbarControl, { widget: this._widget });
     }
 }
 function DiffStyleToolbarControl(props) {
     const { widget } = props;
-    const [style, setStyle] = React.useState(() => widget.diffStyle);
-    const [available, setAvailable] = React.useState(() => widget.fileDiffActive);
+    const { preferences, trans } = widget.context;
+    const { diffStyle, diffStyleControl } = useDiffPreferences(preferences);
+    const available = useFileDiffActive(widget);
+    return (React.createElement(DiffStyleControl, { diffStyle: diffStyle, control: diffStyleControl, available: available, onChange: next => preferences.update({ diffStyle: next }), trans: trans }));
+}
+/**
+ * Line-wrap toggle mounted into a host-owned toolbar.
+ */
+class LineWrapToolbarItem extends ReactWidget {
+    constructor(widget) {
+        super();
+        this._widget = widget;
+        this.addClass('jp-xtralab-DiffWidget-lineWrapToolbarItem');
+    }
+    /**
+     * Render the line-wrap toggle.
+     */
+    render() {
+        return React.createElement(LineWrapToolbarControl, { widget: this._widget });
+    }
+}
+function LineWrapToolbarControl(props) {
+    const { widget } = props;
+    const { preferences, trans } = widget.context;
+    const { lineWrap } = useDiffPreferences(preferences);
+    const available = useFileDiffActive(widget);
+    return (React.createElement(LineWrapControl, { lineWrap: lineWrap, available: available, onChange: next => preferences.update({ lineWrap: next }), trans: trans }));
+}
+/**
+ * Track {@link XtralabDiffWidget.fileDiffActive} for the split/unified and
+ * line-wrap controls.
+ */
+function useFileDiffActive(widget) {
+    const [active, setActive] = React.useState(() => widget.fileDiffActive);
     React.useEffect(() => {
-        const onStyle = (sender, next) => {
-            setStyle(next);
-        };
-        const onAvailable = (sender, next) => {
-            setAvailable(next);
+        const onActive = (sender, next) => {
+            setActive(next);
         };
-        widget.diffStyleChanged.connect(onStyle);
-        widget.fileDiffActiveChanged.connect(onAvailable);
-        setStyle(widget.diffStyle);
-        setAvailable(widget.fileDiffActive);
+        widget.fileDiffActiveChanged.connect(onActive);
+        setActive(widget.fileDiffActive);
         return () => {
-            widget.diffStyleChanged.disconnect(onStyle);
-            widget.fileDiffActiveChanged.disconnect(onAvailable);
+            widget.fileDiffActiveChanged.disconnect(onActive);
         };
     }, [widget]);
-    const trans = widget.context.trans;
-    return (React.createElement(DiffStyleControl, { diffStyle: style, available: available, onChange: next => widget.setDiffStyle(next), trans: trans }));
+    return active;
 }
 /**
  * Mount the shared diff toolbar controls into a host-owned toolbar.
@@ -408,4 +413,5 @@ function DiffStyleToolbarControl(props) {
 export function addDiffToolbarItems(toolbar, widget) {
     toolbar.addItem('xtralab-notebook-view-mode', new NotebookViewModeToolbarItem(widget));
     toolbar.addItem('xtralab-diff-style', new DiffStyleToolbarItem(widget));
+    toolbar.addItem('xtralab-diff-line-wrap', new LineWrapToolbarItem(widget));
 }

package/lib/git/imageDiff.d.ts

@@ -1,14 +1,15 @@
 import * as React from 'react';
 import type { TranslationBundle } from '@jupyterlab/translation';
-/**
- * The file extensions registered as the xtralab image diff provider.
- */
+import type { ImageDiffViewMode } from './diffPreferences';
 export declare const IMAGE_DIFF_EXTENSIONS: string[];
 /**
  * The `data:` MIME subtype for a path xtralab renders as an image, or
  * `null` when the path is not a supported raster image.
  */
 export declare function imageDataType(path: string): string | null;
+/**
+ * Props for {@link ImageDiffView}.
+ */
 interface IImageDiffViewProps {
     /**
      * Base64 of the reference (old) revision; empty when added.
@@ -22,15 +23,22 @@ interface IImageDiffViewProps {
      * MIME subtype from {@link imageDataType}.
      */
     fileType: string;
+    /**
+     * The selected comparison mode (host-controlled).
+     */
+    mode: ImageDiffViewMode;
+    /**
+     * Called when the user picks another comparison mode.
+     */
+    onModeChange: (mode: ImageDiffViewMode) => void;
     /**
      * Translation bundle for user-facing strings.
      */
     trans: TranslationBundle;
 }
 /**
- * The image comparison surface: a segmented mode selector (reusing the
- * diff segmented-control styling so it matches the Notebook/JSON toggle)
- * plus the selected 2-up / swipe / onion-skin view.
+ * The image comparison surface: a mode selector (reusing the diff widget's
+ * segmented-control styling) plus the selected 2-up / swipe / onion view.
  */
 export declare function ImageDiffView(props: IImageDiffViewProps): React.ReactElement;
 export {};

package/lib/git/imageDiff.js

@@ -1,20 +1,14 @@
 import * as React from 'react';
 /**
  * xtralab's image diff, registered in place of `@jupyterlab/git:image-diff`.
- *
- * The git server base64-encodes binary content, so both diff hosts receive
- * the two sides as base64 strings through the same `content()` getters used
- * for text. This module turns those strings into `<img>` elements and
- * offers the 2-up / swipe / onion-skin comparison modes; no diffing library
- * is involved (`@pierre/diffs` is text-only).
+ * Both sides arrive base64-encoded through the same `content()` getters used
+ * for text; the 2-up/swipe/onion views are hand-rolled (`@pierre/diffs` is
+ * text-only).
  */
 /**
- * Raster image extensions xtralab renders as an image diff, mapped to the
- * MIME subtype used in the `data:image/<subtype>;base64,…` URL.
- *
- * `.svg` is intentionally absent: it is XML text, so the `@pierre/diffs`
- * text diff (the fallback provider) is more useful for it than an image
- * comparison.
+ * Raster extensions mapped to the `data:image/<subtype>` MIME subtype.
+ * `.svg` is intentionally absent: it is XML text, so the fallback text diff
+ * is more useful than an image comparison.
  */
 const IMAGE_DATA_TYPES = {
     '.png': 'png',
@@ -25,9 +19,6 @@ const IMAGE_DATA_TYPES = {
     '.bmp': 'bmp',
     '.ico': 'x-icon'
 };
-/**
- * The file extensions registered as the xtralab image diff provider.
- */
 export const IMAGE_DIFF_EXTENSIONS = Object.keys(IMAGE_DATA_TYPES);
 /**
  * The `data:` MIME subtype for a path xtralab renders as an image, or
@@ -42,40 +33,14 @@ export function imageDataType(path) {
     }
     return (_a = IMAGE_DATA_TYPES[lower.slice(dot)]) !== null && _a !== void 0 ? _a : null;
 }
-const IMAGE_DIFF_VIEW_MODE_STORAGE_KEY = 'xtralab:image-diff-view-mode';
-function readStoredImageViewMode() {
-    try {
-        const raw = window.localStorage.getItem(IMAGE_DIFF_VIEW_MODE_STORAGE_KEY);
-        if (raw === '2-up' || raw === 'swipe' || raw === 'onion') {
-            return raw;
-        }
-    }
-    catch (_a) {
-        // localStorage can throw in privacy/sandboxed contexts — 2-up is the
-        // sensible default anyway.
-    }
-    return '2-up';
-}
-function writeStoredImageViewMode(mode) {
-    try {
-        window.localStorage.setItem(IMAGE_DIFF_VIEW_MODE_STORAGE_KEY, mode);
-    }
-    catch (_a) {
-        // Best-effort.
-    }
-}
 /**
- * Strip whitespace from a base64 payload. Python's `base64.encodebytes`
- * (used by the git server) inserts a newline every 76 characters; most
- * browsers tolerate that inside a `data:` URL but some are stricter, and
- * the cleaned length also lets us size the file accurately.
+ * Strip whitespace from a base64 payload: the server's `base64.encodebytes`
+ * inserts newlines some browsers reject in `data:` URLs, and the cleaned
+ * length sizes the file accurately.
  */
 function cleanBase64(value) {
     return value.replace(/\s+/g, '');
 }
-/**
- * Decoded byte length of a (whitespace-free) base64 string.
- */
 function base64ByteLength(clean) {
     if (clean.length === 0) {
         return 0;
@@ -107,26 +72,20 @@ function toSide(raw, fileType) {
     };
 }
 /**
- * The image comparison surface: a segmented mode selector (reusing the
- * diff segmented-control styling so it matches the Notebook/JSON toggle)
- * plus the selected 2-up / swipe / onion-skin view.
+ * The image comparison surface: a mode selector (reusing the diff widget's
+ * segmented-control styling) plus the selected 2-up / swipe / onion view.
  */
 export function ImageDiffView(props) {
-    const { reference, challenger, fileType, trans } = props;
+    const { reference, challenger, fileType, mode, onModeChange, trans } = props;
     const ref = React.useMemo(() => toSide(reference, fileType), [reference, fileType]);
     const chall = React.useMemo(() => toSide(challenger, fileType), [challenger, fileType]);
-    const [mode, setMode] = React.useState(() => readStoredImageViewMode());
-    const changeMode = React.useCallback((next) => {
-        setMode(next);
-        writeStoredImageViewMode(next);
-    }, []);
     return (React.createElement("div", { className: "jp-xtralab-ImageDiff" },
         React.createElement("div", { className: "jp-xtralab-ImageDiff-header" },
             React.createElement("div", { className: "jp-xtralab-DiffWidget-segmented", role: "tablist", "aria-label": trans.__('Image diff view mode') }, [
                 ['2-up', trans.__('2-up')],
                 ['swipe', trans.__('Swipe')],
                 ['onion', trans.__('Onion Skin')]
-            ].map(([value, label]) => (React.createElement("button", { key: value, type: "button", role: "tab", "aria-selected": mode === value, "data-active": mode === value, className: "jp-xtralab-DiffWidget-segmentedButton", onClick: () => changeMode(value) }, label))))),
+            ].map(([value, label]) => (React.createElement("button", { key: value, type: "button", role: "tab", "aria-selected": mode === value, "data-active": mode === value, className: "jp-xtralab-DiffWidget-segmentedButton", onClick: () => onModeChange(value) }, label))))),
         React.createElement("div", { className: "jp-xtralab-ImageDiff-body" }, mode === '2-up' ? (React.createElement(TwoUp, { reference: ref, challenger: chall, trans: trans })) : mode === 'swipe' ? (React.createElement(Swipe, { reference: ref, challenger: chall, trans: trans })) : (React.createElement(OnionSkin, { reference: ref, challenger: chall, trans: trans })))));
 }
 function useNaturalSize() {
@@ -157,21 +116,14 @@ function TwoUp({ reference, challenger, trans }) {
             React.createElement("div", { className: "jp-xtralab-ImageDiff-frame", "data-side": "challenger" }, challenger.uri !== null ? (React.createElement("img", { className: "jp-xtralab-ImageDiff-img", src: challenger.uri, alt: trans.__('Challenger revision'), onLoad: onChallLoad })) : (React.createElement("div", { className: "jp-xtralab-ImageDiff-empty" }, trans.__('Deleted')))),
             React.createElement("figcaption", { className: "jp-xtralab-ImageDiff-caption" }, caption(challenger, challSize, trans.__('Deleted'))))));
 }
-/**
- * Range slider shared by the swipe and onion-skin views. A native
- * `<input type="range">` (styled via CSS) keeps the bundle free of a UI
- * component dependency.
- */
 function RangeSlider(props) {
     const { value, onChange, ariaLabel } = props;
     return (React.createElement("input", { className: "jp-xtralab-ImageDiff-slider", type: "range", min: 0, max: 100, step: 1, value: value, "aria-label": ariaLabel, onChange: event => onChange(Number(event.target.value)) }));
 }
 /**
- * Fit a `naturalWidth × naturalHeight` image inside an `areaWidth ×
- * areaHeight` box without upscaling past its intrinsic size — the same
- * "contain, never enlarge" rule the 2-up and onion views get for free from
- * `max-width/height: 100%; width/height: auto`. Returns the displayed pixel
- * box, or `null` until both the image and the area have been measured.
+ * Fit an image inside an area without upscaling past its intrinsic size —
+ * the "contain, never enlarge" rule the other views get from CSS. Returns
+ * the displayed pixel box, or `null` until both sizes are measured.
  */
 function containBox(naturalWidth, naturalHeight, areaWidth, areaHeight) {
     if (naturalWidth <= 0 ||
@@ -183,9 +135,6 @@ function containBox(naturalWidth, naturalHeight, areaWidth, areaHeight) {
     const scale = Math.min(areaWidth / naturalWidth, areaHeight / naturalHeight, 1);
     return { width: naturalWidth * scale, height: naturalHeight * scale };
 }
-/**
- * Track an element's content-box size, kept current across layout changes.
- */
 function useElementSize() {
     const ref = React.useRef(null);
     const [size, setSize] = React.useState({ width: 0, height: 0 });
@@ -214,13 +163,9 @@ function Swipe({ reference, challenger, trans }) {
     const [challSize, onChallLoad] = useNaturalSize();
     const [areaRef, area] = useElementSize();
     const frameRef = React.useRef(null);
-    // Display both revisions in a single box — the union of their intrinsic
-    // sizes, scaled down to fit but never enlarged — and size the frame to
-    // exactly that box. The divider's `left: N%`, the pointer-to-percent
-    // mapping (below) and each image's `clip-path` inset then all resolve
-    // against the same width, so the white line sits precisely on the seam
-    // between the two revisions at every position. A full-width frame instead
-    // let the line drift off the seam by as much as half the letterbox.
+    // Size the frame to the union box of both revisions so the divider %, the
+    // pointer mapping and the clip-paths all resolve against the same width;
+    // a full-width frame lets the line drift off the seam.
     const naturalWidth = Math.max((_a = refSize === null || refSize === void 0 ? void 0 : refSize[0]) !== null && _a !== void 0 ? _a : 0, (_b = challSize === null || challSize === void 0 ? void 0 : challSize[0]) !== null && _b !== void 0 ? _b : 0);
     const naturalHeight = Math.max((_c = refSize === null || refSize === void 0 ? void 0 : refSize[1]) !== null && _c !== void 0 ? _c : 0, (_d = challSize === null || challSize === void 0 ? void 0 : challSize[1]) !== null && _d !== void 0 ? _d : 0);
     const box = containBox(naturalWidth, naturalHeight, area.width, area.height);
@@ -237,7 +182,6 @@ function Swipe({ reference, challenger, trans }) {
         setPosition(Math.max(0, Math.min(100, next)));
     }, []);
     const onPointerDown = React.useCallback((event) => {
-        // Only react to the primary pointer (left click / touch / pen tip).
         if (event.button !== 0) {
             return;
         }

package/lib/git/index.d.ts

@@ -1,8 +1,5 @@
 import { JupyterFrontEndPlugin } from '@jupyterlab/application';
 import { CommandArguments, CommandIDs } from './commands';
-/**
- * Plugins contributed by xtralab's git integration.
- */
 declare const plugins: JupyterFrontEndPlugin<unknown>[];
 export { CommandArguments, CommandIDs };
 export default plugins;