@kubohiroya/turbowarp-plus-editor-git 0.15.0 → 0.16.0

package/dist/local-operations.d.ts

@@ -13,6 +13,20 @@ export type LocalOperation = {
     kind: 'commit';
     message: string;
     author?: GitAuthor;
+}
+/**
+ * Creates `name` at HEAD, at the commit `at`, or at `origin/<name>` with `fromRemote`, and switches to it with
+ * `checkout`.
+ */
+ | {
+    kind: 'createBranch';
+    name: string;
+    fromRemote?: boolean;
+    at?: string;
+    checkout: boolean;
+} | {
+    kind: 'switchBranch';
+    name: string;
 };
 /**
  * Stages, unstages or commits in the granted repository. Like pull, Git's writes are collected first and applied

package/dist/messages.d.ts

@@ -42,6 +42,10 @@ export declare const messages: {
         outdated: string;
         unsupported: string;
         commitMessage: string;
+        switchUnsafe: string;
+        branchExists: string;
+        locked: string;
+        branchName: string;
         pullUnsafe: string;
         diverged: string;
         session: string;
@@ -60,6 +64,16 @@ export declare const messages: {
         saveFirst: string;
         author: string;
         nothingStaged: string;
+        switchTo: string;
+        currentBranch: string;
+        createBranch: string;
+        newBranch: string;
+        switchAfterCreate: string;
+        createFromRemote: string;
+        remoteBranches: string;
+        switched: string;
+        branchCreated: string;
+        projectMissing: string;
         pulledProject: string;
         confirmPush: string;
         details: string;
@@ -80,6 +94,18 @@ export declare const messages: {
         records: string;
         checkedAt: string;
         failed: string;
+        historyMore: string;
+        historyLoading: string;
+        historyFailed: string;
+        historyActions: string;
+        historyCreateHere: string;
+        historySwitch: string;
+        historyCreateFromRemote: string;
+        historyCopy: string;
+        historyCopied: string;
+        historyCopyFailed: string;
+        historyRefs: string;
+        cancel: string;
     };
     ja: {
         pullRequests: string;
@@ -124,6 +150,10 @@ export declare const messages: {
         outdated: string;
         unsupported: string;
         commitMessage: string;
+        switchUnsafe: string;
+        branchExists: string;
+        locked: string;
+        branchName: string;
         pullUnsafe: string;
         diverged: string;
         session: string;
@@ -142,6 +172,16 @@ export declare const messages: {
         saveFirst: string;
         author: string;
         nothingStaged: string;
+        switchTo: string;
+        currentBranch: string;
+        createBranch: string;
+        newBranch: string;
+        switchAfterCreate: string;
+        createFromRemote: string;
+        remoteBranches: string;
+        switched: string;
+        branchCreated: string;
+        projectMissing: string;
         pulledProject: string;
         confirmPush: string;
         details: string;
@@ -162,6 +202,18 @@ export declare const messages: {
         records: string;
         checkedAt: string;
         failed: string;
+        historyMore: string;
+        historyLoading: string;
+        historyFailed: string;
+        historyActions: string;
+        historyCreateHere: string;
+        historySwitch: string;
+        historyCreateFromRemote: string;
+        historyCopy: string;
+        historyCopied: string;
+        historyCopyFailed: string;
+        historyRefs: string;
+        cancel: string;
     };
 };
 export type Labels = typeof messages.en;

package/dist/{project-comparison-LAyP_beL.js → project-comparison-MU0qD2wo.js}

@@ -1569,17 +1569,22 @@ function useBlockLocation(comparison, locateBlock) {
 		status: (side) => (location === null || location === void 0 ? void 0 : location.comparison) === comparison && location.locator === locateBlock && location.key === sideKey(side) ? location.status : void 0
 	};
 }
-function ScriptComparison({ script, labels, reviewed = false, setReviewed, renderBlock, loadAsset, location }) {
-	const [open, setOpen] = useState(false);
+/** What a script is called in a review: its hat block, or both hat blocks when the change replaced it. */
+function scriptReviewTitle(script, labels) {
+	const beforeTitle = script.before[0] && scriptTitle(script.before[0], labels);
+	const afterTitle = script.after[0] && scriptTitle(script.after[0], labels);
+	return beforeTitle && afterTitle && beforeTitle !== afterTitle ? beforeTitle + " → " + afterTitle : afterTitle !== null && afterTitle !== void 0 ? afterTitle : beforeTitle;
+}
+function ScriptComparison({ script, labels, reviewed = false, setReviewed, renderBlock, loadAsset, location, expanded = false }) {
+	const [open, setOpen] = useState(expanded);
 	const { sync, toggle } = usePreviewSync(labels === ja ? "ja" : "en");
 	const status = script.kind;
 	const locale = labels === ja ? "ja" : "en";
 	const summary = script.summary.map((item) => summaryPhrase(item, locale)).join(labels === ja ? "、" : ", ");
-	const beforeTitle = script.before[0] && scriptTitle(script.before[0], labels);
-	const afterTitle = script.after[0] && scriptTitle(script.after[0], labels);
-	const title = beforeTitle && afterTitle && beforeTitle !== afterTitle ? beforeTitle + " → " + afterTitle : afterTitle !== null && afterTitle !== void 0 ? afterTitle : beforeTitle;
+	const title = scriptReviewTitle(script, labels);
 	return /* @__PURE__ */ React.createElement("details", {
 		className: "twgit-review-script",
+		open: expanded || void 0,
 		onToggle: (event) => setOpen(event.currentTarget.open)
 	}, /* @__PURE__ */ React.createElement("summary", null, /* @__PURE__ */ React.createElement("span", { className: "twgit-review-status" }, labels[status]), /* @__PURE__ */ React.createElement("strong", null, title), status === "reorganized" && /* @__PURE__ */ React.createElement("small", null, script.before.length, " → ", script.after.length), summary && /* @__PURE__ */ React.createElement("small", { className: "twgit-review-summary" }, summary), reviewed && /* @__PURE__ */ React.createElement("small", null, labels.reviewed)), open && /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("div", { className: "twgit-block-diff-sides" }, ["before", "after"].map((version) => /* @__PURE__ */ React.createElement("div", { key: version }, script[version].length ? script[version].map((side, index, sides) => /* @__PURE__ */ React.createElement(BlockPreview, {
 		key: side.id,
@@ -1781,7 +1786,20 @@ var scriptPrint = (script) => fingerprint([
 	script.after.map(scriptBlocks)
 ]);
 var storageKey = (name) => `turbowarp-plus-git:reviewed:${name}`;
-var readMarks = (name) => {
+var memoryMarks = /* @__PURE__ */ new Map();
+var markListeners = /* @__PURE__ */ new Map();
+var subscribeMarks = (name, listener) => {
+	var _markListeners$get;
+	const listeners = (_markListeners$get = markListeners.get(name)) !== null && _markListeners$get !== void 0 ? _markListeners$get : /* @__PURE__ */ new Set();
+	markListeners.set(name, listeners.add(listener));
+	return () => {
+		listeners.delete(listener);
+		if (!listeners.size) markListeners.delete(name);
+	};
+};
+var readMarks = (name, remember = true) => {
+	var _memoryMarks$get;
+	if (!remember) return (_memoryMarks$get = memoryMarks.get(name)) !== null && _memoryMarks$get !== void 0 ? _memoryMarks$get : {};
 	try {
 		var _globalThis$localStor, _globalThis$localStor2;
 		const value = JSON.parse((_globalThis$localStor = (_globalThis$localStor2 = globalThis.localStorage) === null || _globalThis$localStor2 === void 0 ? void 0 : _globalThis$localStor2.getItem(storageKey(name))) !== null && _globalThis$localStor !== void 0 ? _globalThis$localStor : "{}");
@@ -1790,12 +1808,18 @@ var readMarks = (name) => {
 		return {};
 	}
 };
-var writeMarks = (name, marks) => {
+var writeMarks = (name, marks, remember = true) => {
+	var _markListeners$get2;
+	if (!remember) {
+		if (Object.keys(marks).length) memoryMarks.set(name, marks);
+		else memoryMarks.delete(name);
+	}
 	try {
 		var _globalThis$localStor3, _globalThis$localStor4;
-		if (Object.keys(marks).length) (_globalThis$localStor3 = globalThis.localStorage) === null || _globalThis$localStor3 === void 0 || _globalThis$localStor3.setItem(storageKey(name), JSON.stringify(marks));
-		else (_globalThis$localStor4 = globalThis.localStorage) === null || _globalThis$localStor4 === void 0 || _globalThis$localStor4.removeItem(storageKey(name));
+		if (remember && Object.keys(marks).length) (_globalThis$localStor3 = globalThis.localStorage) === null || _globalThis$localStor3 === void 0 || _globalThis$localStor3.setItem(storageKey(name), JSON.stringify(marks));
+		else if (remember) (_globalThis$localStor4 = globalThis.localStorage) === null || _globalThis$localStor4 === void 0 || _globalThis$localStor4.removeItem(storageKey(name));
 	} catch (_unused4) {}
+	(_markListeners$get2 = markListeners.get(name)) === null || _markListeners$get2 === void 0 || _markListeners$get2.forEach((listener) => listener());
 };
 function ProjectSourceReview({ title, description, verification, files, renderBlock, locale = "en", rememberAs }) {
 	const labels = locale.startsWith("ja") ? ja : en;
@@ -1826,20 +1850,24 @@ function ProjectSourceReview({ title, description, verification, files, renderBl
 		return prints;
 	}, [entries]);
 	const [checked, setChecked] = useState();
+	const [, refresh] = useState(0);
+	useEffect(() => rememberAs ? subscribeMarks(rememberAs, () => {
+		setChecked(void 0);
+		refresh((count) => count + 1);
+	}) : void 0, [rememberAs]);
 	const marks = (checked === null || checked === void 0 ? void 0 : checked.entries) === entries ? checked.marks : rememberAs ? readMarks(rememberAs) : {};
 	const reviewed = new Set([...scriptPrints].filter(([key, print]) => marks[key] === print).map(([key]) => key));
-	const setReviewed = (key, value) => setChecked((previous) => {
-		const current = (previous === null || previous === void 0 ? void 0 : previous.entries) === entries ? previous.marks : rememberAs ? readMarks(rememberAs) : {};
+	const setReviewed = (key, value) => {
 		const next = {};
-		for (const [name, print] of scriptPrints) if (current[name] === print) next[name] = print;
+		for (const [name, print] of scriptPrints) if (marks[name] === print) next[name] = print;
 		if (value) next[key] = scriptPrints.get(key);
 		else delete next[key];
 		if (rememberAs) writeMarks(rememberAs, next);
-		return {
+		setChecked({
 			entries,
 			marks: next
-		};
-	});
+		});
+	};
 	const targets = entries.reduce((total, entry) => {
 		var _entry$comparison$tar, _entry$comparison;
 		return total + ((_entry$comparison$tar = (_entry$comparison = entry.comparison) === null || _entry$comparison === void 0 ? void 0 : _entry$comparison.targets.length) !== null && _entry$comparison$tar !== void 0 ? _entry$comparison$tar : 0);
@@ -1871,6 +1899,62 @@ function ProjectSourceReview({ title, description, verification, files, renderBl
 		}
 	}))));
 }
+/** The words of one tab of a project comparison opened as tabs. */
+function reviewTabWords(locale) {
+	const labels = locale.startsWith("ja") ? ja : en;
+	return {
+		script: (script) => `${scriptReviewTitle(script, labels)} · ${labels[script.kind]}`,
+		target: (target) => target.isStage ? labels.stage : target.name,
+		targetDetails: labels.properties,
+		project: labels.comparison,
+		noChanges: labels.noChanges
+	};
+}
+function useReviewMark(place, script) {
+	const [, refresh] = useState(0);
+	useEffect(() => place && subscribeMarks(place.name, () => refresh((count) => count + 1)), [place === null || place === void 0 ? void 0 : place.name]);
+	if (!place) return {};
+	const key = reviewKey(place.file, place.target, script);
+	const print = scriptPrint(script);
+	return {
+		reviewed: readMarks(place.name, place.remember)[key] === print,
+		setReviewed(value) {
+			const marks = _objectSpread2({}, readMarks(place.name, place.remember));
+			if (value) marks[key] = print;
+			else delete marks[key];
+			writeMarks(place.name, marks, place.remember);
+		}
+	};
+}
+/** One script of a comparison, open, for a tab of its own. */
+function ScriptReviewTab({ comparison, script, renderBlock, locale = "en", loadAsset, locateBlock, mark }) {
+	const labels = locale.startsWith("ja") ? ja : en;
+	const location = useBlockLocation(comparison, locateBlock);
+	const { reviewed, setReviewed } = useReviewMark(mark, script);
+	return /* @__PURE__ */ React.createElement("section", { className: "twgit-block-diff twgit-review twgit-review-tab" }, /* @__PURE__ */ React.createElement(ScriptComparison, {
+		script,
+		labels,
+		renderBlock,
+		loadAsset,
+		location,
+		expanded: true,
+		reviewed,
+		setReviewed
+	}), /* @__PURE__ */ React.createElement(Legend, { labels }));
+}
+/**
+* What changed in a stage or sprite outside its code, or in the project as a whole when no target is given,
+* for a tab of its own.
+*/
+function TargetReviewTab({ comparison, target, locale = "en", loadAsset }) {
+	const labels = locale.startsWith("ja") ? ja : en;
+	if (!target) return /* @__PURE__ */ React.createElement("section", { className: "twgit-block-diff twgit-review twgit-review-tab" }, comparison.properties.length > 0 ? /* @__PURE__ */ React.createElement("p", null, labels.properties, " · ", propertyNames(comparison.properties, labels)) : /* @__PURE__ */ React.createElement("p", null, labels.noChanges));
+	return /* @__PURE__ */ React.createElement("section", { className: "twgit-block-diff twgit-review twgit-review-tab" }, /* @__PURE__ */ React.createElement("h5", null, /* @__PURE__ */ React.createElement(TargetThumbnails, {
+		target,
+		labels,
+		loadAsset
+	}), target.isStage ? labels.stage : target.name), target.status !== "updated" && /* @__PURE__ */ React.createElement("p", { className: "twgit-review-target-status" }, (target.status === "added" ? labels.targetAdded : labels.targetRemoved)(target.name, target.isStage)), target.status === "updated" && target.properties.length > 0 && /* @__PURE__ */ React.createElement("p", null, labels.properties, " · ", propertyNames(target.properties, labels)), target.scripts.length > 0 && /* @__PURE__ */ React.createElement("p", null, labels.scriptCount(target.scripts.length)));
+}
 // src/github-pull-requests.ts
 init_objectSpread2();
 var PullRequestError = class extends Error {
@@ -2116,6 +2200,119 @@ function createGitHubPullRequests(repository, send = fetch) {
 		}
 	};
 }
+// src/project-source-tabs.tsx
+var providerId = "turbowarp-plus-git";
+var statusColor = {
+	added: "green",
+	removed: "red",
+	updated: "blue"
+};
+/** Renders its content once the tab is first shown, so a comparison with many scripts draws only what is looked at. */
+function WhenShown({ children }) {
+	const element = useRef(null);
+	const [shown, setShown] = useState(false);
+	useEffect(() => {
+		var _element$current;
+		const view = (_element$current = element.current) === null || _element$current === void 0 ? void 0 : _element$current.ownerDocument.defaultView;
+		if (shown || !element.current) return;
+		if (!(view === null || view === void 0 ? void 0 : view.IntersectionObserver)) {
+			setShown(true);
+			return;
+		}
+		const observer = new view.IntersectionObserver((entries) => {
+			if (entries.some((entry) => entry.isIntersecting)) setShown(true);
+		});
+		observer.observe(element.current);
+		return () => observer.disconnect();
+	}, [shown]);
+	return /* @__PURE__ */ React.createElement("div", {
+		ref: element,
+		className: "twgit-review-tab-body"
+	}, shown && children);
+}
+/**
+* Opens a comparison of project.source.json files as tabs of the host's workspace: a tab group for each changed
+* stage or sprite, holding a tab for each changed script and one for its changes outside the code.
+* Returns how many tabs were asked for, or `0` when the host has no workspace to take them.
+*/
+function openProjectSourceTabs(openPanel, { key, files, renderBlock, locale = "en", rememberAs }) {
+	if (!openPanel) return 0;
+	const words = reviewTabWords(locale);
+	const area = `${providerId}:diff:${key}`;
+	const requests = [];
+	const tab = (documentId, title, content, tabGroup) => ({
+		reference: {
+			providerId,
+			documentId: `diff:${key}:${documentId}`
+		},
+		filename: title,
+		title,
+		transient: true,
+		area,
+		tabGroup,
+		inactive: requests.length > 0,
+		mount(element) {
+			element.classList.add("twgit-panel-tab", "twgit-review-tab-slot");
+			render(/* @__PURE__ */ React.createElement(WhenShown, null, content()), element);
+			return {
+				requestClose: () => {},
+				dispose: () => {
+					unmountComponentAtNode(element);
+				}
+			};
+		}
+	});
+	for (const file of files) {
+		const comparison = compareProjectForReview(file.before, file.after);
+		const prefix = files.length > 1 ? file.path.split("/").slice(0, -1).join("/") : "";
+		const labelOf = (target) => prefix ? `${prefix}: ${words.target(target)}` : words.target(target);
+		if (comparison.properties.length || !comparison.targets.length) {
+			const title = prefix ? `${prefix}: ${words.project}` : words.project;
+			requests.push(tab(`${file.path}:project`, title, () => /* @__PURE__ */ React.createElement(TargetReviewTab, {
+				comparison,
+				locale
+			})));
+		}
+		for (const target of comparison.targets) {
+			const targetKey = JSON.stringify([
+				file.path,
+				target.isStage,
+				target.name
+			]);
+			const tabGroup = {
+				id: `${area}:${targetKey}`,
+				label: labelOf(target),
+				color: statusColor[target.status]
+			};
+			if (target.status !== "updated" || target.properties.length || !target.scripts.length) requests.push(tab(`${targetKey}:details`, words.targetDetails, () => /* @__PURE__ */ React.createElement(TargetReviewTab, {
+				comparison,
+				target,
+				locale,
+				loadAsset: file.loadAsset
+			}), tabGroup));
+			for (const script of target.scripts) requests.push(tab(`${targetKey}:${script.id}`, words.script(script), () => /* @__PURE__ */ React.createElement(ScriptReviewTab, {
+				comparison,
+				script,
+				renderBlock,
+				locale,
+				loadAsset: file.loadAsset,
+				locateBlock: file.locateBlock,
+				mark: {
+					name: rememberAs !== null && rememberAs !== void 0 ? rememberAs : area,
+					remember: !!rememberAs,
+					file: file.path,
+					target
+				}
+			}), tabGroup));
+		}
+	}
+	let opened = 0;
+	for (const request of requests) {
+		if (!openPanel(request)) break;
+		opened++;
+	}
+	return opened;
+}
 // src/block-diff-location.ts
 function markBlockLocation(block, parts) {
 	const root = block.getSvgRoot();
@@ -2546,4 +2743,4 @@ function openProjectComparison(document, options) {
 		render(/* @__PURE__ */ React.createElement(ProjectComparisonDialog, _objectSpread2(_objectSpread2({}, options), {}, { onChoose: choose })), root);
 	});
 }
-export { readProjectSourceDiff as C, parseProjectSource as S, currentCostume as _, PullRequestError as a, compareProjectBlocks as b, ProjectSourceComparison as c, organizeProjectChanges as d, projectPropertyLabel as f, usePreviewSync as g, createPreviewSync as h, createScratchBlocksDiffLocator as i, ProjectSourceReview as l, BlockPreview as m, openProjectComparison as n, createGitHubPullRequests as o, compareProjectForReview as p, createScratchBlocksDiffRenderer as r, gitHubRepositoryFromOrigin as s, ProjectComparisonDialog as t, assetFileName as u, useAssetImage as v, createProjectSourceDiff as x, useCostumeImage as y };
+export { parseProjectSource as C, createProjectSourceDiff as S, usePreviewSync as _, openProjectSourceTabs as a, useCostumeImage as b, gitHubRepositoryFromOrigin as c, assetFileName as d, organizeProjectChanges as f, createPreviewSync as g, BlockPreview as h, createScratchBlocksDiffLocator as i, ProjectSourceComparison as l, compareProjectForReview as m, openProjectComparison as n, PullRequestError as o, projectPropertyLabel as p, createScratchBlocksDiffRenderer as r, createGitHubPullRequests as s, ProjectComparisonDialog as t, ProjectSourceReview as u, currentCostume as v, readProjectSourceDiff as w, compareProjectBlocks as x, useAssetImage as y };

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

@@ -5,6 +5,8 @@ import './project-source-diff.css';
 export { createGitHubPullRequests, gitHubRepositoryFromOrigin } from './github-pull-requests.js';
 export { ProjectSourceComparison, ProjectSourceReview } from './project-source-review.js';
 export { ProjectComparisonDialog, openProjectComparison } from './project-comparison.js';
+export { openProjectSourceTabs } from './project-source-tabs.js';
+export type { ProjectSourceTabsFile, ProjectSourceTabsOptions } from './project-source-tabs.js';
 export type { ProjectComparisonAction, ProjectComparisonDialogProps, ProjectComparisonOptions, ProjectComparisonSection } from './project-comparison.js';
 export type { ProjectSourceComparisonProps, ProjectSourceReviewFile, ProjectSourceReviewProps } from './project-source-review.js';
 export { createScratchBlocksDiffLocator } from './block-diff-location.js';

package/dist/project-source-diff.js

@@ -1,4 +1,4 @@
-import { C as readProjectSourceDiff, _ as currentCostume, b as compareProjectBlocks, c as ProjectSourceComparison, d as organizeProjectChanges, f as projectPropertyLabel, g as usePreviewSync, h as createPreviewSync, i as createScratchBlocksDiffLocator, l as ProjectSourceReview, m as BlockPreview, n as openProjectComparison, o as createGitHubPullRequests, p as compareProjectForReview, r as createScratchBlocksDiffRenderer, s as gitHubRepositoryFromOrigin, t as ProjectComparisonDialog, u as assetFileName, x as createProjectSourceDiff } from "./project-comparison-LAyP_beL.js";
+import { S as createProjectSourceDiff, _ as usePreviewSync, a as openProjectSourceTabs, c as gitHubRepositoryFromOrigin, d as assetFileName, f as organizeProjectChanges, g as createPreviewSync, h as BlockPreview, i as createScratchBlocksDiffLocator, l as ProjectSourceComparison, m as compareProjectForReview, n as openProjectComparison, p as projectPropertyLabel, r as createScratchBlocksDiffRenderer, s as createGitHubPullRequests, t as ProjectComparisonDialog, u as ProjectSourceReview, v as currentCostume, w as readProjectSourceDiff, x as compareProjectBlocks } from "./project-comparison-MU0qD2wo.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 { ProjectComparisonDialog, ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, assetFileName, compareProjectForReview, createGitHubPullRequests, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, gitHubRepositoryFromOrigin, openProjectComparison, organizeProjectChanges, projectPropertyLabel };
+export { ProjectComparisonDialog, ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, assetFileName, compareProjectForReview, createGitHubPullRequests, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, gitHubRepositoryFromOrigin, openProjectComparison, openProjectSourceTabs, organizeProjectChanges, projectPropertyLabel };

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

@@ -1,7 +1,10 @@
 import React from 'react';
+import { compareProjectForReview } from './project-source-review-model.js';
+import type { ScriptReview, TargetReview } from './project-source-review-model.js';
 import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
 import type { ProjectBlockLocator } from './block-diff-location.js';
 import type { ProjectAssetLoader } from './project-assets.js';
+type Comparison = ReturnType<typeof compareProjectForReview>;
 export type ProjectSourceReviewFile = {
     path: string;
     summary?: string;
@@ -51,3 +54,43 @@ 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, locateBlock, target }: ProjectSourceComparisonProps): React.JSX.Element;
 export declare function ProjectSourceReview({ title, description, verification, files, renderBlock, locale, rememberAs }: ProjectSourceReviewProps): React.JSX.Element;
+/** The words of one tab of a project comparison opened as tabs. */
+export declare function reviewTabWords(locale: string): {
+    script: (script: ScriptReview) => string;
+    target: (target: TargetReview) => string;
+    targetDetails: string;
+    project: string;
+    noChanges: string;
+};
+/**
+ * Where a tab keeps its reviewed mark: under `name` with the review of the same name, in the browser when
+ * `remember` is set, or else while the page is open.
+ */
+export interface ReviewMarkPlace {
+    name: string;
+    remember: boolean;
+    file: string;
+    target: TargetReview;
+}
+/** One script of a comparison, open, for a tab of its own. */
+export declare function ScriptReviewTab({ comparison, script, renderBlock, locale, loadAsset, locateBlock, mark }: {
+    comparison: Comparison;
+    script: ScriptReview;
+    renderBlock: ProjectBlockRenderer;
+    locale?: string;
+    loadAsset?: ProjectAssetLoader;
+    locateBlock?: ProjectBlockLocator;
+    /** Offers the reviewed mark, shared with the review panel and other tabs that use the same place. */
+    mark?: ReviewMarkPlace;
+}): React.JSX.Element;
+/**
+ * What changed in a stage or sprite outside its code, or in the project as a whole when no target is given,
+ * for a tab of its own.
+ */
+export declare function TargetReviewTab({ comparison, target, locale, loadAsset }: {
+    comparison: Comparison;
+    target?: TargetReview;
+    locale?: string;
+    loadAsset?: ProjectAssetLoader;
+}): React.JSX.Element;
+export {};

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

@@ -0,0 +1,35 @@
+import type { ProjectSource } from './project-source-patch.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';
+import type { GitPanelRequest } from './index.js';
+/** One project.source.json of a comparison, read into both versions. */
+export interface ProjectSourceTabsFile {
+    path: string;
+    before: ProjectSource;
+    after: ProjectSource;
+    loadAsset?: ProjectAssetLoader;
+    /** Offers "Highlight in Editor" on the after version, which the caller has matched with the open project. */
+    locateBlock?: ProjectBlockLocator;
+}
+export interface ProjectSourceTabsOptions {
+    /**
+     * Names this comparison, such as `owner/repo#42@<head>` or `<commit>:project.source.json`. Its tabs share one
+     * split, and opening the same comparison again brings its tabs forward instead of adding them twice.
+     */
+    key: string;
+    files: readonly ProjectSourceTabsFile[];
+    renderBlock: ProjectBlockRenderer;
+    locale?: string;
+    /**
+     * Shares the reviewed marks of the script tabs with the review of this name, such as `owner/repo#42`, and keeps
+     * them in the browser. Without it, the marks are kept for this comparison while the page is open.
+     */
+    rememberAs?: string;
+}
+/**
+ * Opens a comparison of project.source.json files as tabs of the host's workspace: a tab group for each changed
+ * stage or sprite, holding a tab for each changed script and one for its changes outside the code.
+ * Returns how many tabs were asked for, or `0` when the host has no workspace to take them.
+ */
+export declare function openProjectSourceTabs(openPanel: ((request: GitPanelRequest) => boolean) | undefined, { key, files, renderBlock, locale, rememberAs }: ProjectSourceTabsOptions): number;

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

@@ -2,10 +2,15 @@ import React from 'react';
 import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
 import type { Repository } from './repository.js';
 import type { ProjectBlockLocator } from './block-diff-location.js';
-export declare function PullRequestReviewPanel({ repository, locale, renderBlock, locateFor }: {
+import type { ProjectSourceTabsFile } from './project-source-tabs.js';
+type OpenTabs = (key: string, files: readonly ProjectSourceTabsFile[], rememberAs?: string) => number;
+export declare function PullRequestReviewPanel({ repository, locale, renderBlock, locateFor, openTabs }: {
     repository: Repository;
     locale: string;
     renderBlock: ProjectBlockRenderer;
+    /** Opens a pull request's project changes as tabs of the host's layout. */
+    openTabs?: OpenTabs;
     /** 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;
+export {};