@kubohiroya/turbowarp-plus-editor-git 0.7.0 → 0.9.0

package/dist/project-asset-paths.d.ts

@@ -0,0 +1,12 @@
+/** The largest asset a thumbnail reads. */
+export declare const assetLimit: number;
+/** The largest sb3-source.json read to find the assets directory. */
+export declare const folderSettingsLimit: number;
+/** Asset names are plain `<md5>.<ext>` file names; anything else could address a path outside the assets directory. */
+export declare const isAssetName: (name: unknown) => name is string;
+/**
+ * The assets directory named by one version of a project folder's `sb3-source.json`, as path segments relative to the
+ * folder. `assets` when that file or its `assetsDirectory` field is missing or unreadable. `null` when the field names
+ * anything other than a plain relative path inside the folder.
+ */
+export declare function assetsDirectoryParts(settings: string | null): string[] | null;

package/dist/project-assets.d.ts

@@ -0,0 +1,23 @@
+import type { ProjectTarget } from './project-source-patch.js';
+export type ProjectVersion = 'before' | 'after';
+/**
+ * Reads one asset of one version of a project file by its `md5ext` name (for example `0123…cdef.svg`), from the
+ * assets directory of that project. Resolves `null` when that version has no readable file of that name.
+ */
+export type ProjectAssetLoader = (request: {
+    version: ProjectVersion;
+    md5ext: string;
+    signal: AbortSignal;
+}) => Promise<Blob | null>;
+/** The costume a sprite shows, or the backdrop the stage shows, when the project data names an image file for it. */
+export declare function currentCostume(target: ProjectTarget): {
+    name: string;
+    md5ext: string;
+    type: string;
+} | null;
+/** The image type of an asset file name, or `undefined` for sounds and anything that is not an image. */
+export declare function assetImageType(md5ext: string): string | undefined;
+/** Loads one image asset of one version as an object URL, or `null` while it is unavailable or not an image. */
+export declare function useAssetImage(md5ext: string | undefined, version: ProjectVersion, loadAsset?: ProjectAssetLoader): string | null;
+/** Loads the current costume of one version of a target as an object URL for an image, or `null` while it is unavailable. */
+export declare function useCostumeImage(target: ProjectTarget | undefined, version: ProjectVersion, loadAsset?: ProjectAssetLoader): string | null;

package/dist/project-change-list.d.ts

@@ -0,0 +1,81 @@
+import React from 'react';
+import type { ChangedFile, ProjectChangeList, ProjectElementChange, ProjectTargetChanges } from './project-change-model.js';
+import type { ProjectAssetLoader } from './project-assets.js';
+import type { ChangeGroup, FileChange, Repository, Snapshot } from './repository.js';
+import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
+declare const en: {
+    title: string;
+    stage: string;
+    code: (count: number) => string;
+    costumes: string;
+    backdrops: string;
+    sounds: string;
+    data: string;
+    settings: string;
+    project: string;
+    other: string;
+    added: string;
+    removed: string;
+    updated: string;
+    files: string;
+    before: string;
+    after: string;
+    absent: string;
+    loading: string;
+    unreadable: string;
+    fileList: string;
+    property: string;
+    format: string;
+    rate: string;
+    samples: string;
+    file: string;
+    noImage: string;
+    groups: Record<ChangeGroup, string>;
+};
+type Labels = typeof en;
+export declare const projectChangeLabels: (locale: string) => Labels;
+export interface ProjectChanges {
+    list: ProjectChangeList;
+    sources: {
+        before: string | null;
+        after: string | null;
+    };
+    loadAsset: ProjectAssetLoader;
+}
+/**
+ * Reads the selected project folder in the last commit and the working tree (or a commit and its parent) and arranges
+ * the changed files by stage, sprite and element. `undefined` while there is no project; `'loading'` and `'unreadable'`
+ * tell the panel to keep the list by file.
+ */
+export declare function useProjectChanges(repository: Repository | null, snapshot: Snapshot | null, project: string | null, commit: string | null, changes: readonly FileChange[]): ProjectChanges | 'loading' | 'unreadable' | undefined;
+/** The change list arranged by the project's stage, sprites and elements, with files outside the project after them. */
+export declare function ProjectChangeListView({ changes, selected, locale, busy, onSelect, onSelectFile, fileList, fileListOpen, setFileListOpen }: {
+    changes: ProjectChanges;
+    selected: string | null;
+    locale: string;
+    busy: boolean;
+    onSelect(key: string): void;
+    onSelectFile(file: ChangedFile): void;
+    fileList: React.ReactNode;
+    fileListOpen: boolean;
+    setFileListOpen(open: boolean): void;
+}): React.JSX.Element;
+export declare function findElement(list: ProjectChangeList, key: string | null): {
+    element: ProjectElementChange;
+    target: ProjectTargetChanges;
+} | {
+    element: ProjectElementChange;
+    target: null;
+} | null;
+/** The details of one selected row: its code, pictures or values in both versions, and the files behind it. */
+export declare function ProjectElementView({ changes, selection, locale, renderBlock, onSelectFile }: {
+    changes: ProjectChanges;
+    selection: {
+        element: ProjectElementChange;
+        target: ProjectTargetChanges | null;
+    };
+    locale: string;
+    renderBlock?: ProjectBlockRenderer;
+    onSelectFile(file: ChangedFile): void;
+}): React.JSX.Element;
+export {};

package/dist/project-change-model.d.ts

@@ -0,0 +1,73 @@
+import type { ChangeGroup } from './repository.js';
+import type { ProjectSource, ProjectTarget } from './project-source-patch.js';
+/** One changed file of the repository, with the Git group it was listed under. A path can appear in several groups. */
+export interface ChangedFile {
+    path: string;
+    group: ChangeGroup;
+}
+export type ProjectElementKind = 'code' | 'costumes' | 'sounds' | 'data' | 'settings';
+export type ProjectChangeStatus = 'added' | 'removed' | 'updated';
+/** One row of the project-shaped change list: something a person recognizes in the Editor. */
+export interface ProjectElementChange {
+    /** Stable within one list, for React keys and selection. */
+    key: string;
+    kind: ProjectElementKind;
+    status: ProjectChangeStatus;
+    /** Costume or sound name; absent for code, data and settings rows. */
+    name?: string;
+    /** The costume or sound entry in each version, for costume and sound rows. */
+    before?: Record<string, unknown>;
+    after?: Record<string, unknown>;
+    /** Asset file names (`md5ext`) of each version, for costume and sound rows. */
+    md5ext?: {
+        before?: string;
+        after?: string;
+    };
+    /**
+     * Changed property keys, for data and settings rows (for example `variables`, `x`, `visible`), and for
+     * project-level rows (`monitors`, `extensions`, `meta`).
+     */
+    properties?: string[];
+    /** Number of changed code items (as counted by the review comparison), for code rows. */
+    scripts?: number;
+    /** The changed repository files behind this row, so the details view can show them with their Git groups. */
+    files: ChangedFile[];
+}
+export interface ProjectTargetChanges {
+    key: string;
+    name: string;
+    isStage: boolean;
+    status: ProjectChangeStatus;
+    before?: ProjectTarget;
+    after?: ProjectTarget;
+    /** In the order code, costumes, sounds, data, settings; costumes and sounds in their order in the target. */
+    elements: ProjectElementChange[];
+}
+export interface ProjectChangeList {
+    /** The stage first, then sprites in project order; removed targets after the existing ones. */
+    targets: ProjectTargetChanges[];
+    /** Project-level changes outside the targets (monitors, extensions, meta and other top-level keys). */
+    project: ProjectElementChange[];
+    /** Changed files that belong to no element: sb3-source.json, embedded-extensions.json, unreferenced assets and the rest. */
+    other: ChangedFile[];
+}
+export interface OrganizeProjectChangesInput {
+    /** The project folder relative to the repository root, `''` for the root. */
+    folder: string;
+    /** The project data of each version, `null` where the version has no project file. */
+    before: ProjectSource | null;
+    after: ProjectSource | null;
+    /** The assets directory of each version, relative to the folder (from sb3-source.json; `assets` by default). */
+    assetsDirectory: {
+        before: string;
+        after: string;
+    };
+    /** Every changed file in the folder, from all Git groups. */
+    files: readonly ChangedFile[];
+}
+/** The Japanese or English name of a project or target property key; unknown keys are returned as they are. */
+export declare function projectPropertyLabel(key: string, locale?: string): string;
+/** The asset file name of a costume or sound entry: `md5ext`, or `assetId.dataFormat`; `''` when it has neither. */
+export declare function assetFileName(entry: Record<string, unknown>): string;
+/** Arranges the changed files of one project folder by stage, sprite and element. Pure; reads nothing. */
+export declare function organizeProjectChanges(input: OrganizeProjectChangesInput): ProjectChangeList;

package/dist/project-source-diff.d.ts

@@ -9,8 +9,14 @@ export { createScratchBlocksDiffLocator } from './block-diff-location.js';
 export type { ProjectBlockLocation, ProjectBlockLocator, ScratchBlockLocationWorkspace } from './block-diff-location.js';
 export type { BlockPart } from './project-source-patch.js';
 export { createProjectSourceDiff } from './project-source-patch.js';
+export { currentCostume } from './project-assets.js';
+export { assetFileName, organizeProjectChanges, projectPropertyLabel } from './project-change-model.js';
+export type { ChangedFile, OrganizeProjectChangesInput, ProjectChangeList, ProjectChangeStatus, ProjectElementChange, ProjectElementKind, ProjectTargetChanges } from './project-change-model.js';
+export type { ProjectAssetLoader, ProjectVersion } from './project-assets.js';
 export { createScratchBlocksDiffRenderer } from './scratch-block-diff-renderer.js';
-export type { ProjectBlockRenderer, ScratchBlockDiffRendererOptions, ScratchBlocksPort } from './scratch-block-diff-renderer.js';
+export type { BlockPreviewView, BlockPreviewViewport, ProjectBlockRenderer, ProjectBlockRendering, ScratchBlockDiffRendererOptions, ScratchBlocksPort } from './scratch-block-diff-renderer.js';
+export { createPreviewSync } from './block-diff-preview.js';
+export type { PreviewSync } from './block-diff-preview.js';
 export interface ProjectSourceBlockDiffProps {
     patch: string;
     /** Supply the original JSON if the unified patch omits context. */

package/dist/project-source-diff.js

@@ -1,4 +1,4 @@
-import { a as gitHubRepositoryFromOrigin, c as compareProjectBlocks, d as BlockPreview, i as createGitHubPullRequests, l as createProjectSourceDiff, n as createScratchBlocksDiffLocator, o as ProjectSourceComparison, s as ProjectSourceReview, t as createScratchBlocksDiffRenderer, u as readProjectSourceDiff } from "./scratch-block-diff-renderer-CLYoOIB2.js";
+import { _ as compareProjectBlocks, a as gitHubRepositoryFromOrigin, b as readProjectSourceDiff, c as projectPropertyLabel, d as BlockPreview, f as createPreviewSync, i as createGitHubPullRequests, l as ProjectSourceComparison, m as currentCostume, n as createScratchBlocksDiffLocator, o as assetFileName, p as usePreviewSync, s as organizeProjectChanges, t as createScratchBlocksDiffRenderer, u as ProjectSourceReview, v as createProjectSourceDiff } from "./scratch-block-diff-renderer-DZR8ep-T.js";
 import { n as init_objectSpread2, t as _objectSpread2 } from "./objectSpread2-Dkd68nJH.js";
 import React, { useEffect, useMemo, useRef, useState } from "react";
 // src/project-source-diff.tsx
@@ -19,13 +19,13 @@ var en = {
 	properties: "Other block properties",
 	absent: "No block on this side",
 	omitted: (count) => `${count} unchanged blocks omitted from the change list`,
-	context: "Highlight in the surrounding script",
+	context: "Highlight in the surrounding code",
 	more: "Show more changes",
 	noChanges: "No block changes.",
 	locate: "Highlight in Editor",
 	locating: "Finding the block in the Editor…",
 	located: "Highlighted in the Editor.",
-	missingLocation: "This version or block is unavailable in the Editor. Open its surrounding script here.",
+	missingLocation: "This version or block is unavailable in the Editor. Open its surrounding code here.",
 	partLegend: "Orange outlines mark changed inputs and fields.",
 	otherChanges: "The project also has changes outside its block code.",
 	invalid: "This diff could not be read. Use a full-context project diff, or provide the original project.",
@@ -48,13 +48,13 @@ var ja = {
 	properties: "その他のブロック属性",
 	absent: "この側にはブロックがありません",
 	omitted: (count) => `変更のないブロック ${count} 個を一覧から省略`,
-	context: "元のスクリプト内で強調",
+	context: "元のコード内で強調",
 	more: "続きを表示",
 	noChanges: "ブロックの変更はありません。",
 	locate: "編集画面で強調",
 	locating: "編集画面でブロックを検索中…",
 	located: "編集画面で強調しました。",
-	missingLocation: "編集画面に該当する版またはブロックがありません。元のスクリプトをここで展開できます。",
+	missingLocation: "編集画面に該当する版またはブロックがありません。元のコードをここで展開できます。",
 	partLegend: "オレンジの枠は、変更された入力欄やフィールドです。",
 	otherChanges: "ブロックのコード以外にも作品の変更があります。",
 	invalid: "差分を読み込めません。全体の文脈を含む差分を使うか、変更前の作品を指定してください。",
@@ -75,6 +75,7 @@ var propertyLabels = /* @__PURE__ */ new Map([
 function ChangeCard({ change, renderBlock, labels, onLocate, location }) {
 	var _change$after;
 	const [withContext, setWithContext] = useState(false);
+	const { sync, toggle } = usePreviewSync(labels === en ? "en" : "ja");
 	const notes = [...new Set(change.fields.map((field) => {
 		var _propertyLabels$get;
 		return labels[(_propertyLabels$get = propertyLabels.get(field)) !== null && _propertyLabels$get !== void 0 ? _propertyLabels$get : "properties"];
@@ -89,8 +90,10 @@ function ChangeCard({ change, renderBlock, labels, onLocate, location }) {
 		labels,
 		parts: change.parts,
 		onLocate: onLocate && (() => onLocate(version)),
+		version,
+		sync,
 		locationStatus: (location === null || location === void 0 ? void 0 : location.version) === version ? location.status : void 0
-	}))), /* @__PURE__ */ React.createElement("label", null, /* @__PURE__ */ React.createElement("input", {
+	}))), toggle, /* @__PURE__ */ React.createElement("label", null, /* @__PURE__ */ React.createElement("input", {
 		type: "checkbox",
 		checked: withContext,
 		onChange: (event) => setWithContext(event.currentTarget.checked)
@@ -166,4 +169,4 @@ function ProjectSourceBlockDiff({ patch, beforeSource, renderBlock, locateBlock,
 		})
 	}, labels.more));
 }
-export { ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, createGitHubPullRequests, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, gitHubRepositoryFromOrigin };
+export { ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, assetFileName, createGitHubPullRequests, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, gitHubRepositoryFromOrigin, organizeProjectChanges, projectPropertyLabel };

package/dist/project-source-review-model.d.ts

@@ -1,4 +1,4 @@
-import type { BlockSide, ProjectSource } from './project-source-patch.js';
+import type { BlockSide, ProjectSource, ProjectTarget } from './project-source-patch.js';
 import type { ScriptBlockMark } from './scratch-block-diff-renderer.js';
 export interface ScriptReviewSide extends BlockSide {
     marks: ScriptBlockMark[];
@@ -11,6 +11,9 @@ export interface ScriptReview {
 export interface TargetReview {
     name: string;
     isStage: boolean;
+    /** The stage or sprite in each version, absent where it does not exist. */
+    before?: ProjectTarget;
+    after?: ProjectTarget;
     scripts: ScriptReview[];
     properties: string[];
 }

package/dist/project-source-review.d.ts

@@ -1,5 +1,6 @@
 import React from 'react';
 import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
+import type { ProjectAssetLoader } from './project-assets.js';
 export type ProjectSourceReviewFile = {
     path: string;
     summary?: string;
@@ -8,6 +9,7 @@ export type ProjectSourceReviewFile = {
 } & ({
     patch: string;
     beforeSource?: string;
+    loadAsset?: ProjectAssetLoader;
 } | {
     status: 'added' | 'removed' | 'updated';
 });
@@ -28,7 +30,14 @@ export interface ProjectSourceComparisonProps {
     locale?: string;
     /** Shown after an explanation when either version cannot be read as a project. Without it, only an error is shown. */
     fallback?: React.ReactNode;
+    /** Reads the images of both versions for thumbnails. Without it, stages and sprites are shown by name. */
+    loadAsset?: ProjectAssetLoader;
+    /** Shows only the code of this stage or sprite, without the overview and the changes outside the code. */
+    target?: {
+        isStage: boolean;
+        name: string;
+    };
 }
-/** Compares two versions of a project.source.json by stage, sprite and script, as the pull request review does. */
-export declare function ProjectSourceComparison({ before, after, renderBlock, locale, fallback }: ProjectSourceComparisonProps): React.JSX.Element;
+/** Compares two versions of a project.source.json by stage, sprite and code, as the pull request review does. */
+export declare function ProjectSourceComparison({ before, after, renderBlock, locale, fallback, loadAsset, target }: ProjectSourceComparisonProps): React.JSX.Element;
 export declare function ProjectSourceReview({ title, description, verification, files, renderBlock, locale }: ProjectSourceReviewProps): React.JSX.Element;

package/dist/{repository-DplMQiuo.js → repository-VBp-UNWc.js}

@@ -1,5 +1,5 @@
 import { i as __toESM, n as init_objectSpread2, r as __commonJSMin, t as _objectSpread2 } from "./objectSpread2-Dkd68nJH.js";
-import { t as createTwoFilesPatch } from "./libesm-OWRWzmu_.js";
+import { a as createTwoFilesPatch, i as isAssetName, n as assetsDirectoryParts, r as folderSettingsLimit, t as assetLimit } from "./project-asset-paths-KV715791.js";
 import { a as _OverloadYield, i as _wrapAsyncGenerator, o as _asyncIterator, r as createGitSmartHttp, t as GitSmartHttpError } from "./smart-http-BmHEkE7K.js";
 // node_modules/inherits/inherits_browser.js
 var require_inherits_browser = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -16795,6 +16795,7 @@ async function runRemoteOperation(root, operation, getSession, guard, signal) {
 }
 // src/repository.ts
 init_objectSpread2();
+var projectSourceLimit = 16777216;
 var emptyTree = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
 var textLimit = 1048576;
 var inScope = (path, scope) => !scope || path === scope || path.startsWith(scope + "/");
@@ -17055,7 +17056,8 @@ async function openRepository(root) {
 				after: (_b$oid = b === null || b === void 0 ? void 0 : b.oid) !== null && _b$oid !== void 0 ? _b$oid : null,
 				oldMode: (_a$mode = a === null || a === void 0 ? void 0 : a.mode) !== null && _a$mode !== void 0 ? _a$mode : null,
 				newMode: (_b$mode = b === null || b === void 0 ? void 0 : b.mode) !== null && _b$mode !== void 0 ? _b$mode : null,
-				worktree: false
+				worktree: false,
+				commit: oid
 			});
 		}
 		await assertSnapshot(snapshot);
@@ -17127,6 +17129,121 @@ async function openRepository(root) {
 			text
 		});
 	};
+	const sourceOf = async (snapshot, change, version) => {
+		if (change[version] === null) return null;
+		switch (change.group) {
+			case "staged": return version === "after" ? { kind: "index" } : snapshot.head ? {
+				kind: "tree",
+				ref: snapshot.head
+			} : null;
+			case "unstaged": return version === "after" ? { kind: "worktree" } : { kind: "index" };
+			case "untracked": return version === "after" ? { kind: "worktree" } : null;
+			case "commit": {
+				if (!change.commit) return null;
+				if (version === "after") return {
+					kind: "tree",
+					ref: change.commit
+				};
+				const parent = (await readCommit(_objectSpread2(_objectSpread2({}, options), {}, {
+					cache,
+					oid: change.commit
+				}))).commit.parent[0];
+				return parent ? {
+					kind: "tree",
+					ref: parent
+				} : null;
+			}
+		}
+	};
+	/** Reads one regular file of one version, or `null` when it is missing or larger than the limit. */
+	const readVersion = async (source, path, limit) => {
+		if (source.kind === "worktree") {
+			const stat = await fs.promises.stat("/" + path).catch(() => null);
+			if (!(stat === null || stat === void 0 ? void 0 : stat.isFile()) || stat.size > limit) return null;
+			const bytes = await readOptional(fs, "/" + path);
+			return bytes && bytes.byteLength <= limit ? bytes : null;
+		}
+		const entry = (await entries(source.kind === "tree" ? source.ref : null, path)).get(path);
+		if (!entry || entry.mode !== 33188 && entry.mode !== 33261) return null;
+		const { blob } = await readBlob(_objectSpread2(_objectSpread2({}, options), {}, {
+			cache,
+			oid: entry.oid
+		}));
+		return blob.byteLength <= limit ? blob : null;
+	};
+	const comparisonSource = async (snapshot, comparison, version) => {
+		if (comparison.kind === "worktree") return version === "after" ? { kind: "worktree" } : snapshot.head ? {
+			kind: "tree",
+			ref: snapshot.head
+		} : null;
+		if (version === "after") return {
+			kind: "tree",
+			ref: comparison.commit
+		};
+		const parent = (await readCommit(_objectSpread2(_objectSpread2({}, options), {}, {
+			cache,
+			oid: comparison.commit
+		}))).commit.parent[0];
+		return parent ? {
+			kind: "tree",
+			ref: parent
+		} : null;
+	};
+	const readAsset = (snapshot, change, version, md5ext, signal) => readFolderAsset(snapshot, pathParts(change.path).slice(0, -1), () => sourceOf(snapshot, change, version), md5ext, signal);
+	const readFolderAsset = async (snapshot, folder, resolve, md5ext, signal) => {
+		if (signal.aborted) return null;
+		fs.clearReads();
+		await assertSnapshot(snapshot);
+		const source = await resolve();
+		if (!source) return null;
+		const settings = await readVersion(source, [...folder, "sb3-source.json"].join("/"), folderSettingsLimit);
+		const directory = assetsDirectoryParts(settings && new TextDecoder().decode(settings));
+		if (!directory || signal.aborted) return null;
+		const bytes = await readVersion(source, [
+			...folder,
+			...directory,
+			md5ext
+		].join("/"), assetLimit);
+		await fs.checkReads();
+		return bytes && !signal.aborted ? new Blob([bytes]) : null;
+	};
+	/** Reads the project file and the assets directory of both versions of a project folder. */
+	const readProject = async (snapshot, folder, comparison) => {
+		fs.clearReads();
+		await assertSnapshot(snapshot);
+		const parts = pathParts(folder);
+		const read = async (version) => {
+			const source = await comparisonSource(snapshot, comparison, version);
+			if (!source) return {
+				source: null,
+				assetsDirectory: "assets"
+			};
+			const bytes = await readVersion(source, [...parts, "project.source.json"].join("/"), projectSourceLimit);
+			const settings = await readVersion(source, [...parts, "sb3-source.json"].join("/"), folderSettingsLimit);
+			const directory = assetsDirectoryParts(settings && new TextDecoder().decode(settings));
+			let text = null;
+			if (bytes) try {
+				text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+			} catch (_unused4) {
+				throw new GitPanelError("unsupported");
+			}
+			return {
+				source: text,
+				assetsDirectory: directory ? directory.join("/") : "assets"
+			};
+		};
+		const before = await read("before"), after = await read("after");
+		await assertSnapshot(snapshot);
+		await fs.checkReads();
+		return {
+			before: before.source,
+			after: after.source,
+			assetsDirectory: {
+				before: before.assetsDirectory,
+				after: after.assetsDirectory
+			}
+		};
+	};
 	const directoryAt = async (path) => {
 		let directory = root;
 		for (const part of pathParts(path)) directory = await directory.getDirectoryHandle(part);
@@ -17206,7 +17323,21 @@ async function openRepository(root) {
 		}),
 		read: (scope) => serial(() => read(scope)),
 		readDiff: (snapshot, change) => serial(() => readDiff(snapshot, change)),
-		historyChanges: (snapshot, oid) => serial(() => historyChanges(snapshot, oid))
+		historyChanges: (snapshot, oid) => serial(() => historyChanges(snapshot, oid)),
+		/**
+		* Reads the assets of both versions of a selected project file, for thumbnails. Staged changes compare HEAD with
+		* the index, unstaged ones the index with the working tree, untracked ones nothing with the working tree, and
+		* commit changes the first parent with the commit. Each version's sb3-source.json names its assets directory.
+		* Reads never write, and resolve `null` for anything missing, invalid, larger than 10 MiB or changed since the snapshot.
+		*/
+		assetLoader: (snapshot, change) => ({ version, md5ext, signal }) => !isAssetName(md5ext) || signal.aborted ? Promise.resolve(null) : serial(() => readAsset(snapshot, change, version, md5ext, signal)).catch(() => null),
+		/**
+		* Reads the project file of a folder in both versions of a comparison, with each version's assets directory.
+		* `null` stands for a version without the file. Throws `changed` when the repository changed since the snapshot.
+		*/
+		readProject: (snapshot, folder, comparison) => serial(() => readProject(snapshot, folder, comparison)),
+		/** Reads the assets of a folder in both versions of a comparison, like `assetLoader`. */
+		projectAssetLoader: (snapshot, folder, comparison) => ({ version, md5ext, signal }) => !isAssetName(md5ext) || signal.aborted ? Promise.resolve(null) : serial(() => readFolderAsset(snapshot, pathParts(folder), () => comparisonSource(snapshot, comparison, version), md5ext, signal)).catch(() => null)
 	};
 }
 export { GitPanelError as n, createReadOnlyFs as r, openRepository as t };

package/dist/repository.d.ts

@@ -1,4 +1,5 @@
 import type { GetRemoteSession, RemoteOperation } from './remote-operations.js';
+import type { ProjectAssetLoader } from './project-assets.js';
 export { createReadOnlyFs, GitPanelError } from './filesystem.js';
 export type ChangeGroup = 'staged' | 'unstaged' | 'untracked' | 'commit';
 export interface FileChange {
@@ -9,6 +10,8 @@ export interface FileChange {
     worktree: boolean;
     oldMode: number | null;
     newMode: number | null;
+    /** For `commit` changes, the commit compared with its first parent. */
+    commit?: string;
 }
 export interface Commit {
     oid: string;
@@ -16,6 +19,16 @@ export interface Commit {
     author: string;
     timestamp: number;
 }
+/**
+ * Two versions of a project folder as a person sees them: the last commit and the working tree, so changes split
+ * across the index and the working tree read as one; or one commit and its first parent.
+ */
+export type ProjectComparison = {
+    kind: 'worktree';
+} | {
+    kind: 'commit';
+    commit: string;
+};
 type Metadata = Map<string, Uint8Array | null>;
 export interface Snapshot {
     branch: string | undefined;
@@ -57,5 +70,26 @@ export declare function openRepository(root: FileSystemDirectoryHandle): Promise
     read: (scope?: string) => Promise<Snapshot>;
     readDiff: (snapshot: Snapshot, change: FileChange) => Promise<FileDiff>;
     historyChanges: (snapshot: Snapshot, oid: string) => Promise<FileChange[]>;
+    /**
+     * Reads the assets of both versions of a selected project file, for thumbnails. Staged changes compare HEAD with
+     * the index, unstaged ones the index with the working tree, untracked ones nothing with the working tree, and
+     * commit changes the first parent with the commit. Each version's sb3-source.json names its assets directory.
+     * Reads never write, and resolve `null` for anything missing, invalid, larger than 10 MiB or changed since the snapshot.
+     */
+    assetLoader: (snapshot: Snapshot, change: FileChange) => ProjectAssetLoader;
+    /**
+     * Reads the project file of a folder in both versions of a comparison, with each version's assets directory.
+     * `null` stands for a version without the file. Throws `changed` when the repository changed since the snapshot.
+     */
+    readProject: (snapshot: Snapshot, folder: string, comparison: ProjectComparison) => Promise<{
+        before: string | null;
+        after: string | null;
+        assetsDirectory: {
+            before: string;
+            after: string;
+        };
+    }>;
+    /** Reads the assets of a folder in both versions of a comparison, like `assetLoader`. */
+    projectAssetLoader: (snapshot: Snapshot, folder: string, comparison: ProjectComparison) => ProjectAssetLoader;
 }>;
 export type Repository = Awaited<ReturnType<typeof openRepository>>;

package/dist/repository.js

@@ -1 +1 @@
-export { n as GitPanelError, r as createReadOnlyFs, t as openRepository } from "./repository-DplMQiuo.js";
+export { n as GitPanelError, r as createReadOnlyFs, t as openRepository } from "./repository-VBp-UNWc.js";