@kubohiroya/turbowarp-plus-editor-git 0.10.0 → 0.12.0

package/dist/editor-block-locator.d.ts

@@ -0,0 +1,27 @@
+import type { ProjectBlockLocator, ScratchBlockLocationWorkspace } from './block-diff-location.js';
+/** The parts of a Scratch VM the locator reads to find a stage or sprite. */
+export interface LocatorVM {
+    runtime: {
+        targets: readonly {
+            id: string;
+            isOriginal?: boolean;
+            isStage: boolean;
+            getName(): string;
+        }[];
+    };
+    editingTarget?: {
+        id: string;
+    } | null;
+}
+export interface EditorBlockLocatorOptions {
+    vm: LocatorVM;
+    /** Opens the code of one stage or sprite in the Editor, as project search does. */
+    openTargetCode(targetId: string): void | Promise<void>;
+    /** The Editor's code workspace as it is now, or `null` while none is shown. */
+    getWorkspace(): ScratchBlockLocationWorkspace | null | Promise<ScratchBlockLocationWorkspace | null>;
+}
+/**
+ * Finds the stage or sprite of a compared version in the open project, opens its code and waits for the block,
+ * then centers and outlines it. The caller decides which version matches the open project.
+ */
+export declare function createEditorBlockLocator({ vm, openTargetCode, getWorkspace }: EditorBlockLocatorOptions): ProjectBlockLocator;

package/dist/file-diff-view.d.ts

@@ -3,16 +3,18 @@ import type { FileChange, FileDiff } from './repository.js';
 import type { labelsFor } from './messages.js';
 import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
 import type { ProjectAssetLoader } from './project-assets.js';
+import type { ProjectBlockLocator } from './block-diff-location.js';
 /** Project sources are the files the panel opens as projects. */
 export declare const isProjectSource: (path: string) => boolean;
 /**
  * Shows one changed file. Project sources are compared as blocks by default, with their text diff one switch away.
  */
-export declare function FileDiffView({ change, diff, labels, locale, renderBlock, loadAsset }: {
+export declare function FileDiffView({ change, diff, labels, locale, renderBlock, loadAsset, locateBlock }: {
     change: FileChange;
     diff: FileDiff | null;
     labels: ReturnType<typeof labelsFor>;
     locale: string;
     renderBlock?: ProjectBlockRenderer;
     loadAsset?: ProjectAssetLoader;
+    locateBlock?: ProjectBlockLocator;
 }): React.JSX.Element;

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 import type { GitConnectionSettings } from './connection-settings.js';
 import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
+import type { ScratchBlockLocationWorkspace } from './block-diff-location.js';
+export { createScratchBlocksDiffLocator } from './block-diff-location.js';
+export { createEditorBlockLocator } from './editor-block-locator.js';
 export { createScratchBlocksDiffRenderer } from './scratch-block-diff-renderer.js';
 export type { ScratchBlockDiffRendererOptions, ScratchBlocksPort } from './scratch-block-diff-renderer.js';
 export { openRepository, createReadOnlyFs, GitPanelError } from './repository.js';
@@ -11,6 +14,28 @@ export interface GitHost {
     isProjectDirty(): boolean;
     isProjectRunning?(): boolean;
     subscribe?(listener: (event: 'loaded' | 'changed') => void): () => void;
+    /**
+     * Opens the panel as a tab of the host's layout, with the same shape as the layout package's DocumentPanelRequest.
+     * Returning `false` keeps the modal dialog.
+     */
+    openPanel?(request: GitPanelRequest): boolean;
+    /** Opens the code of one stage or sprite, so a diff can point at its block. Without it, no block is located. */
+    openTargetCode?(targetId: string): void | Promise<void>;
+    /** The Editor's code workspace as it is now. */
+    getWorkspace?(): ScratchBlockLocationWorkspace | null | Promise<ScratchBlockLocationWorkspace | null>;
+}
+export interface GitPanelRequest {
+    reference: {
+        providerId: string;
+        documentId: string;
+    };
+    filename: string;
+    title?: string;
+    transient?: boolean;
+    mount(element: HTMLElement, close: () => void): {
+        requestClose(): void;
+        dispose(): void;
+    };
 }
 export declare function mountGitPanel({ vm, document, host }: {
     vm: object;

package/dist/index.js

@@ -1,9 +1,9 @@
-import { a as gitHubRepositoryFromOrigin, c as projectPropertyLabel, g as useCostumeImage, h as useAssetImage, i as createGitHubPullRequests, l as ProjectSourceComparison, r as PullRequestError, s as organizeProjectChanges, t as createScratchBlocksDiffRenderer, u as ProjectSourceReview, y as parseProjectSource } from "./scratch-block-diff-renderer-DZR8ep-T.js";
+import { _ as useCostumeImage, a as gitHubRepositoryFromOrigin, b as parseProjectSource, g as useAssetImage, i as createGitHubPullRequests, l as organizeProjectChanges, n as createScratchBlocksDiffLocator, o as ProjectSourceComparison, r as PullRequestError, s as ProjectSourceReview, t as createScratchBlocksDiffRenderer, u as projectPropertyLabel } from "./scratch-block-diff-renderer-e_drVlHE.js";
 import { n as init_objectSpread2, r as __commonJSMin, t as _objectSpread2$1 } from "./objectSpread2-Dkd68nJH.js";
 import { i as createReadOnlyFs, r as GitPanelError, t as openRepository } from "./repository-CtvWYPQ8.js";
 import * as m from "react";
 import React, { createContext, memo, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
-import { render, unmountComponentAtNode } from "react-dom";
+import { createPortal, render, unmountComponentAtNode } from "react-dom";
 // builtin:esm-external-require-react
 var require_builtin_esm_external_require_react = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	init_objectSpread2();
@@ -2684,7 +2684,7 @@ var isProjectSource = (path) => path.split("/").pop() === "project.source.json";
 /**
 * Shows one changed file. Project sources are compared as blocks by default, with their text diff one switch away.
 */
-function FileDiffView({ change, diff, labels, locale, renderBlock, loadAsset }) {
+function FileDiffView({ change, diff, labels, locale, renderBlock, loadAsset, locateBlock }) {
 	var _change$oldMode, _change$newMode;
 	const [view, setView] = useState("blocks");
 	const names = locale.startsWith("ja") ? ja$3 : en$3;
@@ -2713,6 +2713,7 @@ function FileDiffView({ change, diff, labels, locale, renderBlock, loadAsset })
 		locale,
 		fallback: text,
 		loadAsset,
+		locateBlock,
 		before: change.before === null ? null : sources.before,
 		after: change.after === null ? null : sources.after
 	}) : text);
@@ -2965,7 +2966,7 @@ var show = (value) => {
 	return text.length > 400 ? text.slice(0, 400) + "…" : text;
 };
 /** The details of one selected row: its code, pictures or values in both versions, and the files behind it. */
-function ProjectElementView({ changes, selection, locale, renderBlock, onSelectFile }) {
+function ProjectElementView({ changes, selection, locale, renderBlock, onSelectFile, locateBlock }) {
 	var _element$properties2;
 	const labels = projectChangeLabels(locale);
 	const { element, target } = selection;
@@ -3000,7 +3001,8 @@ function ProjectElementView({ changes, selection, locale, renderBlock, onSelectF
 		target: {
 			isStage: target.isStage,
 			name: target.name
-		}
+		},
+		locateBlock
 	}), element.kind === "costumes" && /* @__PURE__ */ React.createElement("div", { className: "twgit-element-pictures" }, ["before", "after"].map((version) => {
 		var _element$md5ext3, _element$version;
 		return /* @__PURE__ */ React.createElement(Picture, {
@@ -3299,6 +3301,7 @@ function ConnectionSettings({ settings, locale, readOrigin, runOperation }) {
 	}, labels[error]));
 }
 // src/pull-request-panel.tsx
+init_objectSpread2();
 var en = {
 	title: "Pull requests",
 	number: "Pull request number",
@@ -3344,7 +3347,7 @@ var ja = {
 function errorMessage(error, labels) {
 	return error instanceof PullRequestError ? labels[error.code] : labels.failed;
 }
-function PullRequests({ name, labels, locale, renderBlock }) {
+function PullRequests({ name, labels, locale, renderBlock, locateFor }) {
 	const client = useMemo(() => createGitHubPullRequests(name), [name]);
 	const [page, setPage] = useState(1);
 	const [listing, setListing] = useState();
@@ -3432,12 +3435,12 @@ function PullRequests({ name, labels, locale, renderBlock }) {
 	}, labels.onGitHub)), /* @__PURE__ */ React.createElement(ProjectSourceReview, {
 		title: pr.title,
 		description: pr.description,
-		files: pr.files,
+		files: locateFor ? pr.files.map((file) => "patch" in file ? _objectSpread2$1(_objectSpread2$1({}, file), {}, { locateBlock: locateFor(file.path, pr.head.sha) }) : file) : pr.files,
 		renderBlock,
 		locale
 	}))));
 }
-function PullRequestReviewPanel({ repository, locale, renderBlock }) {
+function PullRequestReviewPanel({ repository, locale, renderBlock, locateFor }) {
 	const labels = locale.startsWith("ja") ? ja : en;
 	const [origin, setOrigin] = useState();
 	useEffect(() => {
@@ -3471,7 +3474,44 @@ function PullRequestReviewPanel({ repository, locale, renderBlock }) {
 		name: origin.name,
 		labels,
 		locale,
-		renderBlock
+		renderBlock,
+		locateFor
+	});
+}
+// src/editor-block-locator.ts
+/**
+* Finds the stage or sprite of a compared version in the open project, opens its code and waits for the block,
+* then centers and outlines it. The caller decides which version matches the open project.
+*/
+function createEditorBlockLocator({ vm, openTargetCode, getWorkspace }) {
+	return createScratchBlocksDiffLocator(async ({ target, id: blockId, signal }) => {
+		const found = vm.runtime.targets.find((item) => target.isStage ? item.isStage : !item.isStage && item.isOriginal !== false && item.getName() === target.name);
+		if (!found || signal.aborted) return null;
+		await openTargetCode(found.id);
+		const deadline = Date.now() + waitLimit;
+		while (!signal.aborted) {
+			var _vm$editingTarget;
+			if (((_vm$editingTarget = vm.editingTarget) === null || _vm$editingTarget === void 0 ? void 0 : _vm$editingTarget.id) === found.id) {
+				const workspace = await getWorkspace();
+				if (signal.aborted) break;
+				if (workspace === null || workspace === void 0 ? void 0 : workspace.getBlockById(blockId)) return workspace;
+			}
+			if (Date.now() >= deadline) break;
+			await nextFrame(signal);
+		}
+		return null;
+	});
+}
+var waitLimit = 2e3;
+function nextFrame(signal) {
+	return new Promise((resolve) => {
+		const done = () => {
+			signal.removeEventListener("abort", done);
+			resolve();
+		};
+		signal.addEventListener("abort", done, { once: true });
+		if (typeof requestAnimationFrame === "function") requestAnimationFrame(done);
+		else setTimeout(done, 16);
 	});
 }
 // src/index.tsx
@@ -3490,9 +3530,20 @@ var initial = {
 };
 var controllers = /* @__PURE__ */ new WeakMap();
 var watchInterval = 2e3;
-function GitPanel({ document, host, controller }) {
-	var _state$repository, _state$snapshot$head$, _state$snapshot$head, _state$snapshot;
+function GitPanel({ vm, document, host, controller }) {
+	var _state$repository, _state$snapshot$head$, _state$snapshot$head, _state$snapshot2;
 	const [visible, setVisible] = useState(false);
+	const [slot, setSlot] = useState(null);
+	const shown = visible || slot !== null;
+	const locator = useMemo(() => slot && host.openTargetCode && host.getWorkspace ? createEditorBlockLocator({
+		vm,
+		openTargetCode: host.openTargetCode,
+		getWorkspace: host.getWorkspace
+	}) : void 0, [
+		slot !== null,
+		host,
+		vm
+	]);
 	const [review, setReview] = useState(false);
 	const [locale, setLocale] = useState(document.documentElement.lang || "en");
 	const [dirty, setDirty] = useState(host.isProjectDirty());
@@ -3550,8 +3601,34 @@ function GitPanel({ document, host, controller }) {
 		}
 	};
 	controller.open = (language) => {
+		var _host$openPanel;
 		setLocale(language);
-		setVisible(true);
+		if (!((_host$openPanel = host.openPanel) === null || _host$openPanel === void 0 ? void 0 : _host$openPanel.call(host, {
+			reference: {
+				providerId: "turbowarp-plus-git",
+				documentId: "local-git"
+			},
+			filename: "Git",
+			title: labelsFor(language).title,
+			transient: true,
+			mount(element, close) {
+				setVisible(false);
+				setSlot({
+					element,
+					close
+				});
+				return {
+					requestClose: close,
+					dispose() {
+						setSlot((previous) => (previous === null || previous === void 0 ? void 0 : previous.element) === element ? null : previous);
+					}
+				};
+			}
+		}))) setVisible(true);
+	};
+	const closePanel = () => {
+		if (slot) slot.close();
+		else setVisible(false);
 	};
 	controller.refresh = async (automatic = false) => {
 		if (!alive.current || !current.current.repository) return;
@@ -3600,7 +3677,7 @@ function GitPanel({ document, host, controller }) {
 	}, [host]);
 	useEffect(() => {
 		const repository = state.repository;
-		if (!visible || !repository) return;
+		if (!shown || !repository) return;
 		const view = document.defaultView;
 		let stopped = false;
 		let checking = false;
@@ -3647,19 +3724,19 @@ function GitPanel({ document, host, controller }) {
 			observer === null || observer === void 0 || observer.disconnect();
 		};
 	}, [
-		visible,
+		shown,
 		state.repository,
 		locale
 	]);
 	useEffect(() => {
 		var _dialog$current;
-		if (!visible) return;
+		if (!visible || slot) return;
 		const previous = document.activeElement;
 		(_dialog$current = dialog.current) === null || _dialog$current === void 0 || _dialog$current.focus();
 		return () => {
 			if (previous === null || previous === void 0 ? void 0 : previous.isConnected) previous.focus();
 		};
-	}, [visible]);
+	}, [visible, slot]);
 	const chooseRoot = async () => {
 		const view = document.defaultView;
 		await run(async () => {
@@ -3696,6 +3773,7 @@ function GitPanel({ document, host, controller }) {
 		} finally {
 			opening.current = false;
 		}
+		if (slot) controller.open(locale);
 		if (!alive.current) return {};
 		setDirty(host.isProjectDirty());
 		setState((previous) => _objectSpread2$1(_objectSpread2$1({}, previous), {}, {
@@ -3776,7 +3854,7 @@ function GitPanel({ document, host, controller }) {
 	const focusTrap = (event) => {
 		if (event.key === "Escape") {
 			event.stopPropagation();
-			setVisible(false);
+			closePanel();
 			return;
 		}
 		if (event.key !== "Tab") return;
@@ -3795,23 +3873,21 @@ function GitPanel({ document, host, controller }) {
 		state.snapshot,
 		state.selected
 	]);
-	if (!visible) return null;
+	if (!shown) return null;
 	const groups = state.commit ? ["commit"] : [
 		"staged",
 		"unstaged",
 		"untracked"
 	];
 	const projectList = typeof projectChanges === "object" ? projectChanges : null;
+	const projectFile = state.project === null ? null : [state.project, "project.source.json"].filter(Boolean).join("/");
+	const fileLocator = (change) => locator && change.path === projectFile && (change.group === "unstaged" || change.group === "untracked" || change.group === "staged" && !state.changes.some((item) => item.path === change.path && item.group === "unstaged")) ? locator : void 0;
+	const reviewLocator = (path, headSha) => {
+		var _state$snapshot;
+		return locator && path === projectFile && ((_state$snapshot = state.snapshot) === null || _state$snapshot === void 0 ? void 0 : _state$snapshot.head) === headSha && !state.changes.length ? locator : void 0;
+	};
 	const selection = projectList && !state.selected ? findElement(projectList.list, element) : null;
-	return /* @__PURE__ */ React.createElement("div", { className: "twgit-backdrop" }, /* @__PURE__ */ React.createElement("div", {
-		className: "twgit-panel",
-		ref: dialog,
-		tabIndex: -1,
-		role: "dialog",
-		"aria-modal": "true",
-		"aria-label": labels.title,
-		onKeyDown: focusTrap
-	}, /* @__PURE__ */ React.createElement("header", null, /* @__PURE__ */ React.createElement("h2", null, labels.title), /* @__PURE__ */ React.createElement("button", {
+	const content = /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("header", null, /* @__PURE__ */ React.createElement("h2", null, labels.title), /* @__PURE__ */ React.createElement("button", {
 		onClick: chooseRoot,
 		disabled: state.busy
 	}, labels.choose), !review && /* @__PURE__ */ React.createElement("button", {
@@ -3824,7 +3900,7 @@ function GitPanel({ document, host, controller }) {
 		type: "button",
 		disabled: state.busy,
 		onClick: () => setReview(!review)
-	}, review ? labels.localChanges : labels.pullRequests), /* @__PURE__ */ React.createElement("button", { onClick: () => setVisible(false) }, labels.close)), /* @__PURE__ */ React.createElement("div", { className: "twgit-context" }, /* @__PURE__ */ React.createElement("span", null, labels.repository, " · ", ((_state$repository = state.repository) === null || _state$repository === void 0 ? void 0 : _state$repository.root.name) || "—"), /* @__PURE__ */ React.createElement("span", null, labels.project, " · ", state.project === null ? labels.none : state.project || labels.root), /* @__PURE__ */ React.createElement("span", { "data-git-dirty": "" }, dirty ? labels.dirty : labels.saved), state.snapshot && /* @__PURE__ */ React.createElement("span", {
+	}, review ? labels.localChanges : labels.pullRequests), /* @__PURE__ */ React.createElement("button", { onClick: closePanel }, labels.close)), /* @__PURE__ */ React.createElement("div", { className: "twgit-context" }, /* @__PURE__ */ React.createElement("span", null, labels.repository, " · ", ((_state$repository = state.repository) === null || _state$repository === void 0 ? void 0 : _state$repository.root.name) || "—"), /* @__PURE__ */ React.createElement("span", null, labels.project, " · ", state.project === null ? labels.none : state.project || labels.root), /* @__PURE__ */ React.createElement("span", { "data-git-dirty": "" }, dirty ? labels.dirty : labels.saved), state.snapshot && /* @__PURE__ */ React.createElement("span", {
 		"data-git-upstream": state.snapshot.upstream.state,
 		title: labels.checkedAt
 	}, upstreamText(state.snapshot, labels)), !review && host.connectionSettings && /* @__PURE__ */ React.createElement(ConnectionSettings, {
@@ -3845,7 +3921,8 @@ function GitPanel({ document, host, controller }) {
 	}, state.notice), state.busy && /* @__PURE__ */ React.createElement("p", { role: "status" }, labels.loading), !state.repository && /* @__PURE__ */ React.createElement("p", null, labels.empty), review && state.repository && host.renderReviewBlock && /* @__PURE__ */ React.createElement(PullRequestReviewPanel, {
 		repository: state.repository,
 		locale,
-		renderBlock: host.renderReviewBlock
+		renderBlock: host.renderReviewBlock,
+		locateFor: reviewLocator
 	}), !review && state.repository && /* @__PURE__ */ React.createElement("div", { className: "twgit-content" }, /* @__PURE__ */ React.createElement("aside", null, state.browser && /* @__PURE__ */ React.createElement("details", null, /* @__PURE__ */ React.createElement("summary", null, labels.browse), /* @__PURE__ */ React.createElement("p", null, /* @__PURE__ */ React.createElement("code", null, state.browser.path || "/")), /* @__PURE__ */ React.createElement("button", {
 		disabled: state.busy || !state.browser.path,
 		onClick: () => void browse(state.browser.path.split("/").slice(0, -1).join("/"))
@@ -3878,7 +3955,7 @@ function GitPanel({ document, host, controller }) {
 			fileListOpen,
 			setFileListOpen
 		}) : fileList;
-	})(), !state.changes.length && /* @__PURE__ */ React.createElement("p", null, labels.clean), /* @__PURE__ */ React.createElement("h3", null, labels.history), /* @__PURE__ */ React.createElement("ol", { className: "twgit-history" }, (_state$snapshot = state.snapshot) === null || _state$snapshot === void 0 ? void 0 : _state$snapshot.commits.map((commit) => /* @__PURE__ */ React.createElement("li", { key: commit.oid }, /* @__PURE__ */ React.createElement("button", {
+	})(), !state.changes.length && /* @__PURE__ */ React.createElement("p", null, labels.clean), /* @__PURE__ */ React.createElement("h3", null, labels.history), /* @__PURE__ */ React.createElement("ol", { className: "twgit-history" }, (_state$snapshot2 = state.snapshot) === null || _state$snapshot2 === void 0 ? void 0 : _state$snapshot2.commits.map((commit) => /* @__PURE__ */ React.createElement("li", { key: commit.oid }, /* @__PURE__ */ React.createElement("button", {
 		disabled: state.busy,
 		"aria-pressed": state.commit === commit.oid,
 		title: commit.oid,
@@ -3887,6 +3964,7 @@ function GitPanel({ document, host, controller }) {
 		changes: projectList,
 		selection,
 		locale,
+		locateBlock: state.commit ? void 0 : locator,
 		renderBlock: host.renderReviewBlock,
 		onSelectFile: openFile
 	}) : state.selected ? /* @__PURE__ */ React.createElement(FileDiffView, {
@@ -3894,9 +3972,24 @@ function GitPanel({ document, host, controller }) {
 		diff: state.diff,
 		labels,
 		locale,
+		locateBlock: fileLocator(state.selected),
 		renderBlock: host.renderReviewBlock,
 		loadAsset
-	}) : /* @__PURE__ */ React.createElement("p", null, labels.select)))));
+	}) : /* @__PURE__ */ React.createElement("p", null, labels.select))));
+	if (slot) return createPortal(/* @__PURE__ */ React.createElement("div", {
+		className: "twgit-panel twgit-panel-tab",
+		role: "region",
+		"aria-label": labels.title
+	}, content), slot.element);
+	return /* @__PURE__ */ React.createElement("div", { className: "twgit-backdrop" }, /* @__PURE__ */ React.createElement("div", {
+		className: "twgit-panel",
+		ref: dialog,
+		tabIndex: -1,
+		role: "dialog",
+		"aria-modal": "true",
+		"aria-label": labels.title,
+		onKeyDown: focusTrap
+	}, content));
 }
 /** The GitHub relation in plain words, with the number of records where it helps. */
 function upstreamText({ upstream }, labels) {
@@ -3919,6 +4012,7 @@ function mountGitPanel({ vm, document, host }) {
 	};
 	controllers.set(vm, controller);
 	render(/* @__PURE__ */ React.createElement(GitPanel, {
+		vm,
 		document,
 		host,
 		controller
@@ -3945,4 +4039,4 @@ function renderGitMenu(createElement, { vm, locale = "en", MenuItem, MenuSection
 		}
 	}, labelsFor(locale).menu));
 }
-export { GitPanelError, createReadOnlyFs, createScratchBlocksDiffRenderer, mountGitPanel, openRepository, renderGitMenu };
+export { GitPanelError, createEditorBlockLocator, createReadOnlyFs, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, mountGitPanel, openRepository, renderGitMenu };

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

@@ -3,6 +3,7 @@ import type { ChangedFile, ProjectChangeList, ProjectElementChange, ProjectTarge
 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';
+import type { ProjectBlockLocator } from './block-diff-location.js';
 declare const en: {
     title: string;
     stage: string;
@@ -68,7 +69,7 @@ export declare function findElement(list: ProjectChangeList, key: string | null)
     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 }: {
+export declare function ProjectElementView({ changes, selection, locale, renderBlock, onSelectFile, locateBlock }: {
     changes: ProjectChanges;
     selection: {
         element: ProjectElementChange;
@@ -77,5 +78,6 @@ export declare function ProjectElementView({ changes, selection, locale, renderB
     locale: string;
     renderBlock?: ProjectBlockRenderer;
     onSelectFile(file: ChangedFile): void;
+    locateBlock?: ProjectBlockLocator;
 }): React.JSX.Element;
 export {};

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

@@ -9,6 +9,8 @@ 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 { compareProjectForReview } from './project-source-review-model.js';
+export type { ScriptChangeKind, ScriptReview, ScriptReviewSide, ScriptSummaryItem, TargetReview } from './project-source-review-model.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';

package/dist/project-source-diff.js

@@ -1,4 +1,4 @@
-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 { a as gitHubRepositoryFromOrigin, c as assetFileName, d as compareProjectForReview, f as BlockPreview, h as currentCostume, i as createGitHubPullRequests, l as organizeProjectChanges, m as usePreviewSync, n as createScratchBlocksDiffLocator, o as ProjectSourceComparison, p as createPreviewSync, s as ProjectSourceReview, t as createScratchBlocksDiffRenderer, u as projectPropertyLabel, v as compareProjectBlocks, x as readProjectSourceDiff, y as createProjectSourceDiff } from "./scratch-block-diff-renderer-e_drVlHE.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
@@ -169,4 +169,4 @@ function ProjectSourceBlockDiff({ patch, beforeSource, renderBlock, locateBlock,
 		})
 	}, labels.more));
 }
-export { ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, assetFileName, createGitHubPullRequests, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, gitHubRepositoryFromOrigin, organizeProjectChanges, projectPropertyLabel };
+export { ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, assetFileName, compareProjectForReview, createGitHubPullRequests, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, gitHubRepositoryFromOrigin, organizeProjectChanges, projectPropertyLabel };

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

@@ -3,14 +3,49 @@ import type { ScriptBlockMark } from './scratch-block-diff-renderer.js';
 export interface ScriptReviewSide extends BlockSide {
     marks: ScriptBlockMark[];
 }
+/**
+ * What happened to one script. `moved` means only positions changed, `reordered` only how blocks connect;
+ * neither changes what the script does.
+ */
+export type ScriptChangeKind = 'added' | 'removed' | 'updated' | 'reorganized' | 'moved' | 'reordered';
+/** One phrase of a script's summary, in the order shown. The view words it in the reader's language. */
+export type ScriptSummaryItem = {
+    kind: 'hatReplaced';
+    before: string;
+    after: string;
+} | {
+    kind: 'wrapped';
+    opcode: string;
+} | {
+    kind: 'branchAdded';
+    opcode: string;
+} | {
+    kind: 'valueChanged';
+    opcode: string;
+    name: string;
+} | {
+    kind: 'blocksAdded';
+    count: number;
+} | {
+    kind: 'blocksRemoved';
+    count: number;
+} | {
+    kind: 'reordered';
+} | {
+    kind: 'moved';
+};
 export interface ScriptReview {
     id: string;
     before: ScriptReviewSide[];
     after: ScriptReviewSide[];
+    kind: ScriptChangeKind;
+    summary: ScriptSummaryItem[];
 }
 export interface TargetReview {
     name: string;
     isStage: boolean;
+    /** Added or removed as a whole, or changed. Added and removed targets list no properties. */
+    status: 'added' | 'removed' | 'updated';
     /** The stage or sprite in each version, absent where it does not exist. */
     before?: ProjectTarget;
     after?: ProjectTarget;

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 { ProjectBlockLocator } from './block-diff-location.js';
 import type { ProjectAssetLoader } from './project-assets.js';
 export type ProjectSourceReviewFile = {
     path: string;
@@ -10,6 +11,8 @@ export type ProjectSourceReviewFile = {
     patch: string;
     beforeSource?: string;
     loadAsset?: ProjectAssetLoader;
+    /** Offers "Highlight in Editor" on this file's after version, which the caller has matched with the open project. */
+    locateBlock?: ProjectBlockLocator;
 } | {
     status: 'added' | 'removed' | 'updated';
 });
@@ -32,6 +35,8 @@ export interface ProjectSourceComparisonProps {
     fallback?: React.ReactNode;
     /** Reads the images of both versions for thumbnails. Without it, stages and sprites are shown by name. */
     loadAsset?: ProjectAssetLoader;
+    /** Offers "Highlight in Editor" on the after version, which the caller has matched with the open project. */
+    locateBlock?: ProjectBlockLocator;
     /** Shows only the code of this stage or sprite, without the overview and the changes outside the code. */
     target?: {
         isStage: boolean;
@@ -39,5 +44,5 @@ export interface ProjectSourceComparisonProps {
     };
 }
 /** 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 ProjectSourceComparison({ before, after, renderBlock, locale, fallback, loadAsset, locateBlock, target }: ProjectSourceComparisonProps): React.JSX.Element;
 export declare function ProjectSourceReview({ title, description, verification, files, renderBlock, locale }: ProjectSourceReviewProps): React.JSX.Element;

package/dist/pull-request-panel.d.ts

@@ -1,8 +1,11 @@
 import React from 'react';
 import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
 import type { Repository } from './repository.js';
-export declare function PullRequestReviewPanel({ repository, locale, renderBlock }: {
+import type { ProjectBlockLocator } from './block-diff-location.js';
+export declare function PullRequestReviewPanel({ repository, locale, renderBlock, locateFor }: {
     repository: Repository;
     locale: string;
     renderBlock: ProjectBlockRenderer;
+    /** Returns a locator for a project file whose PR head matches the open project, or `undefined`. */
+    locateFor?(path: string, headSha: string): ProjectBlockLocator | undefined;
 }): React.JSX.Element;

package/dist/review-words.d.ts

@@ -0,0 +1,6 @@
+import type { ScriptSummaryItem } from './project-source-review-model.js';
+export declare function hatName(opcode: string, locale: string): string | undefined;
+/** One phrase per summary item, in the reader's language. */
+export declare function summaryPhrase(item: ScriptSummaryItem, locale: string): string;
+/** The colours of the previews, said once at the top of a review. */
+export declare const legend: (locale: string) => readonly [readonly ["added", "緑の縁: 追加したブロック"], readonly ["removed", "赤の縁: 削除したブロック"], readonly ["updated", "紫の縁: 中身を変えたブロック"], readonly ["part", "オレンジの枠: 値を変えた欄"]] | readonly [readonly ["added", "Green outline: added block"], readonly ["removed", "Red outline: removed block"], readonly ["updated", "Purple outline: block with changed contents"], readonly ["part", "Orange frame: changed value"]];