@kubohiroya/turbowarp-plus-editor-git 0.18.0 → 0.19.0

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

@@ -3,6 +3,11 @@ import type { ProjectBlockLocator } from './block-diff-location.js';
 import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
 import './project-source-diff.css';
 export { createGitHubPullRequests, gitHubRepositoryFromOrigin } from './github-pull-requests.js';
+export { createGitHubReviewApi, GitHubReviewError, isReviewThreadPath } from './github-review-api.js';
+export type { GitHubReviewApi, GitHubReviewApiOptions, GitHubReviewErrorCode, ReviewContext, ReviewEvent } from './github-review-api.js';
+export { checkReview, discardReview, emptyReviewDraft, forgetReviewSubmission, planReview, probeReviewRoutes, readReviewDraft, reviewBody, reviewProblem, reviewRoute, sendReview, subscribeReviewDraft, writeReviewDraft } from './review-submit.js';
+export { PullRequestReviewComposer } from './review-composer.js';
+export type { ReviewComment, ReviewDraft, ReviewPlan, ReviewProblem, ReviewResult, ReviewSubmission, ReviewTarget } from './review-submit.js';
 export { ProjectSourceComparison, ProjectSourceReview } from './project-source-review.js';
 export { ProjectComparisonDialog, openProjectComparison } from './project-comparison.js';
 export { openProjectSourceTabs } from './project-source-tabs.js';

package/dist/project-source-diff.js

@@ -1,6 +1,6 @@
-import { a as compareProjectBlocks, o as createProjectSourceDiff, u as readProjectSourceDiff } from "./project-asset-paths-BzwVf9HE.js";
-import { _ 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 } from "./project-comparison-BXOQcZ73.js";
-import { n as init_objectSpread2, t as _objectSpread2 } from "./objectSpread2-Dkd68nJH.js";
+import { a as compareProjectBlocks, o as createProjectSourceDiff, u as readProjectSourceDiff } from "./project-asset-paths-DNaoWs3E.js";
+import { A as assetFileName, C as subscribeReviewDraft, D as GitHubReviewError, F as createPreviewSync, I as usePreviewSync, L as currentCostume, M as projectPropertyLabel, N as compareProjectForReview, O as createGitHubReviewApi, P as BlockPreview, S as sendReview, _ as probeReviewRoutes, a as openProjectSourceTabs, b as reviewProblem, c as gitHubRepositoryFromOrigin, d as PullRequestReviewComposer, f as checkReview, g as planReview, h as forgetReviewSubmission, i as createScratchBlocksDiffLocator, j as organizeProjectChanges, k as isReviewThreadPath, l as ProjectSourceComparison, m as emptyReviewDraft, n as openProjectComparison, p as discardReview, r as createScratchBlocksDiffRenderer, s as createGitHubPullRequests, t as ProjectComparisonDialog, u as ProjectSourceReview, v as readReviewDraft, w as writeReviewDraft, x as reviewRoute, y as reviewBody } from "./project-comparison-B_3QZ6M-.js";
+import { l as _objectSpread2, u as init_objectSpread2 } from "./smart-http-eARzlXHO.js";
 import React, { useEffect, useMemo, useRef, useState } from "react";
 // src/project-source-diff.tsx
 init_objectSpread2();
@@ -170,4 +170,4 @@ function ProjectSourceBlockDiff({ patch, beforeSource, renderBlock, locateBlock,
 		})
 	}, labels.more));
 }
-export { ProjectComparisonDialog, ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, assetFileName, compareProjectForReview, createGitHubPullRequests, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, gitHubRepositoryFromOrigin, openProjectComparison, openProjectSourceTabs, organizeProjectChanges, projectPropertyLabel };
+export { GitHubReviewError, ProjectComparisonDialog, ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, PullRequestReviewComposer, assetFileName, checkReview, compareProjectForReview, createGitHubPullRequests, createGitHubReviewApi, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, discardReview, emptyReviewDraft, forgetReviewSubmission, gitHubRepositoryFromOrigin, isReviewThreadPath, openProjectComparison, openProjectSourceTabs, organizeProjectChanges, planReview, probeReviewRoutes, projectPropertyLabel, readReviewDraft, reviewBody, reviewProblem, reviewRoute, sendReview, subscribeReviewDraft, writeReviewDraft };

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

@@ -31,6 +31,11 @@ export interface ProjectSourceReviewProps {
      * the content of each script, so a mark stays until that script changes. Without it, marks last while the review is open.
      */
     rememberAs?: string;
+    /**
+     * Offers a comment field under each code change, kept in the review draft of this name (such as `owner/repo#42`) and
+     * sent with the review.
+     */
+    commentAs?: string;
 }
 export interface ProjectSourceComparisonProps {
     /** The earlier project.source.json, or `null` when the file did not exist yet. */
@@ -53,7 +58,7 @@ 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;
+export declare function ProjectSourceReview({ title, description, verification, files, renderBlock, locale, rememberAs, commentAs }: 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;

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

@@ -17,6 +17,8 @@ export interface PullRequestOpenLocally {
 export interface PullRequestConnection {
     getSession: GetRemoteSession;
     connected(): boolean;
+    /** Whether the connection was made with the grant to send reviews; then a review can be sent through it. */
+    reviewGranted?(): boolean;
 }
 export declare function PullRequestReviewPanel({ repository, locale, renderBlock, locateFor, openTabs, connection, openLocally }: {
     repository: Repository;

package/dist/remote-operations.d.ts

@@ -1,7 +1,7 @@
 import type { GitSmartHttpOptions } from './smart-http.js';
 export type RemoteOperation = 'fetch' | 'pull' | 'push';
 export type RemoteSession = NonNullable<Awaited<ReturnType<GitSmartHttpOptions['getSession']>>>;
-export type GetRemoteSession = (remote: string, write: boolean) => Promise<RemoteSession | null>;
+export type GetRemoteSession = (remote: string, write: boolean, review?: boolean) => Promise<RemoteSession | null>;
 /**
  * Where a fetched pull request head is kept: outside `refs/heads`, `refs/remotes` and `refs/tags`, so Git CLI lists it
  * with `git for-each-ref refs/pull` and `git log --all` but not as a branch or tag, `git fetch --prune` leaves it alone,

package/dist/{repository-ByKRBftJ.js → repository-DXRZEtYk.js}

@@ -1,6 +1,5 @@
-import { i as __toESM, n as init_objectSpread2, r as __commonJSMin, t as _objectSpread2 } from "./objectSpread2-Dkd68nJH.js";
-import { i as isAssetName, n as assetsDirectoryParts, o as createProjectSourceDiff, p as createTwoFilesPatch, r as folderSettingsLimit, t as assetLimit } from "./project-asset-paths-BzwVf9HE.js";
-import { a as _OverloadYield, i as _wrapAsyncGenerator, o as _asyncIterator, r as createGitSmartHttp, t as GitSmartHttpError } from "./smart-http-BmHEkE7K.js";
+import { c as _asyncIterator, d as __commonJSMin, f as __toESM, i as createGitSmartHttp, l as _objectSpread2, o as _wrapAsyncGenerator, s as _OverloadYield, t as GitSmartHttpError, u as init_objectSpread2 } from "./smart-http-eARzlXHO.js";
+import { i as isAssetName, n as assetsDirectoryParts, o as createProjectSourceDiff, p as createTwoFilesPatch, r as folderSettingsLimit, t as assetLimit } from "./project-asset-paths-DNaoWs3E.js";
 // node_modules/inherits/inherits_browser.js
 var require_inherits_browser = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	if (typeof Object.create === "function") module.exports = function inherits(ctor, superCtor) {

package/dist/repository.js

@@ -1 +1 @@
-export { o as GitPanelError, s as createReadOnlyFs, t as historyPageSize, n as openRepository, a as pullRequestRef, r as upstreamWalkLimit } from "./repository-ByKRBftJ.js";
+export { o as GitPanelError, s as createReadOnlyFs, t as historyPageSize, n as openRepository, a as pullRequestRef, r as upstreamWalkLimit } from "./repository-DXRZEtYk.js";

package/dist/review-composer.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { GitHubReviewApi } from './github-review-api.js';
+import type { ReviewDraft } from './review-submit.js';
+/** The saved draft of a review, updated when any view of the same review writes it. */
+export declare function useReviewDraft(name: string | undefined): ReviewDraft | null;
+/** Changes the saved draft from what is stored now, so other views' words are kept. */
+export declare function changeReviewDraft(name: string, change: (draft: ReviewDraft) => ReviewDraft): void;
+/**
+ * The overall comment, the result, how the code comments will be sent, and the send button of a pull request review.
+ * The code comments are written under each code change of the review that shares `name`.
+ */
+export declare function PullRequestReviewComposer({ api, name, number, head, changedFiles, url, locale }: {
+    api: GitHubReviewApi;
+    /** Where the draft is kept, such as `owner/repo#42`. */
+    name: string;
+    number: number;
+    /** The compared head commit. */
+    head: string;
+    changedFiles: readonly string[];
+    /** The pull request on GitHub. */
+    url: string;
+    locale: string;
+}): React.JSX.Element;

package/dist/review-submit.d.ts

@@ -0,0 +1,144 @@
+import type { GitHubReviewApi, GitHubReviewErrorCode, ReviewEvent } from './github-review-api.js';
+/**
+ * Sending a pull request review through the GitHub connection, apart from React.
+ *
+ * With the proxy's GraphQL routes, a review is sent in three steps under one Review-Submit-Id: a pending review on the
+ * compared commit, one file-level thread on a project.source.json per script comment, then the submission. Until the
+ * last step nobody else can see anything, so a failure before it discards the pending review. An unknown outcome is
+ * never sent again on its own: the person checks it, and only then sends again. Without the GraphQL routes, the whole
+ * review goes in the body of one REST review. The draft stays in the browser until GitHub has the review.
+ */
+/** One comment on a script, kept under the script's review key. */
+export interface ReviewComment {
+    /** The project.source.json the script is in. */
+    file: string;
+    /** Names the stage or sprite, the script and its first block, in the words of the person writing. */
+    heading: string;
+    body: string;
+}
+/**
+ * A submission in progress. The ID is ours, not GitHub's. `threadKeys` are the comments already on the pending review.
+ *  - `starting`, `threading`, `submitting`: a step was sent; a reload while it was out reads as unknown.
+ *  - `start-unknown`, `submit-unknown`: whether GitHub applied the step is unknown; check before anything else.
+ *  - `pending`: the pending review has all its threads, and the last step was refused; send again or discard.
+ *  - `left`: a pending review could not be discarded; discard it again, or on GitHub.
+ */
+export interface ReviewSubmission {
+    id: string;
+    commitOid: string;
+    route: 'threads' | 'body';
+    state: 'starting' | 'threading' | 'submitting' | 'start-unknown' | 'submit-unknown' | 'pending' | 'left';
+    threadKeys: string[];
+    /** The body-only route: a fingerprint of the body that was sent, to recognise the review on GitHub. */
+    sent?: string;
+}
+export interface ReviewDraft {
+    event: ReviewEvent;
+    body: string;
+    comments: Record<string, ReviewComment>;
+    /** Project files whose comments go in the review body because GitHub refused a thread on them. */
+    inBody: string[];
+    /** The pull request head the comments were written for. */
+    head?: string;
+    submit?: ReviewSubmission;
+}
+export declare const emptyReviewDraft: () => ReviewDraft;
+/** The saved draft of a review, such as `owner/repo#42`, or an empty one. */
+export declare function readReviewDraft(name: string): ReviewDraft;
+/** Saves a draft, or removes it with `null`. Without browser storage, the draft is kept while the page is open. */
+export declare function writeReviewDraft(name: string, draft: ReviewDraft | null): void;
+/** Whether the last write reached browser storage. */
+export declare const reviewDraftPersistent: () => boolean;
+export declare function subscribeReviewDraft(name: string, listener: () => void): () => void;
+export declare const MAX_REVIEW_THREADS = 50;
+export declare const MAX_REVIEW_BODY = 65536;
+export interface ReviewPlan {
+    /** File-level threads, in the order they are sent. */
+    threads: {
+        key: string;
+        path: string;
+        body: string;
+    }[];
+    /** Script comments that go in the review body. */
+    inBody: {
+        key: string;
+        comment: ReviewComment;
+    }[];
+    /** The review body: the overall comment, then the script comments that are not threads. */
+    body: string;
+}
+/** Puts the overall comment first, then each script comment that is not a thread under its file and heading. */
+export declare function reviewBody(overall: string, comments: readonly {
+    comment: ReviewComment;
+}[]): string;
+/**
+ * Decides where each script comment goes. A comment becomes a thread when threads are used, its project.source.json is
+ * among the pull request's changed files, GitHub has not refused a thread on that file, and fewer than 50 threads come
+ * before it. Comments in `exclude` are already on the pending review.
+ */
+export declare function planReview(draft: ReviewDraft, { threads, changedFiles, exclude }: {
+    threads: boolean;
+    changedFiles: readonly string[];
+    exclude?: readonly string[];
+}): ReviewPlan;
+export declare const bodyFingerprint: (body: string) => string;
+export type ReviewProblem = GitHubReviewErrorCode | 'EMPTY_REVIEW' | 'TOO_LONG' | 'UNSUPPORTED' | 'BUSY' | 'REVIEW_OUTCOME_UNKNOWN' | 'PENDING_REVIEW_LEFT' | 'NOT_ALLOWED';
+/** What GitHub would refuse before anything is sent. */
+export declare function reviewProblem(event: ReviewEvent, plan: ReviewPlan, route: 'threads' | 'body'): ReviewProblem | null;
+/**
+ * The result of an action. `outcome` says what is now on GitHub:
+ *  - `submitted`: the review is published (the draft is removed);
+ *  - `not-sent`: nothing is on GitHub (the draft is kept);
+ *  - `pending`: a pending review with every thread waits for the last step; send again or discard;
+ *  - `unknown`: whether a step reached GitHub is unknown; check it;
+ *  - `left`: a pending review could not be discarded;
+ *  - `closed`: the check found no review: it was not published, or was discarded on GitHub; send again;
+ *  - `lost`: the proxy no longer knows the submission (the session ended); look on GitHub.
+ */
+export interface ReviewResult {
+    outcome: 'submitted' | 'not-sent' | 'pending' | 'unknown' | 'left' | 'closed' | 'lost';
+    code?: ReviewProblem;
+    /** Seconds to wait before the same action, after a rate limit. */
+    retryAfter?: number;
+    url?: string;
+    /** For `lost`: the person's reviews on the compared commit that GitHub lists, newest first. */
+    reviews?: {
+        state: string;
+        submittedAt: string | null;
+    }[];
+}
+export interface ReviewTarget {
+    api: GitHubReviewApi;
+    /** Where the draft is kept, such as `owner/repo#42`. */
+    name: string;
+    number: number;
+    /** The compared head commit, fetched over Git. */
+    head: string;
+    /** The pull request's changed files. */
+    changedFiles: readonly string[];
+    signal?: AbortSignal;
+}
+/** The route the next submission takes, or `null` when the proxy offers neither. */
+export declare function reviewRoute(api: GitHubReviewApi): 'threads' | 'body' | null;
+/**
+ * Asks the proxy which review routes it offers, with one read: the review context, then, when the GraphQL routes are
+ * off, the list of reviews. A failure other than an unavailable route leaves the route as it was.
+ */
+export declare function probeReviewRoutes(api: GitHubReviewApi, number: number, signal?: AbortSignal): Promise<{
+    context: import("./github-review-api.js").ReviewContext | null;
+    error: unknown;
+} | {
+    context: import("./github-review-api.js").ReviewContext | null;
+    error?: undefined;
+}>;
+/**
+ * Sends the draft, or, after the last step was refused (`pending`), sends that step again with the current event and
+ * overall comment. A submission whose outcome is unknown, or whose pending review was left, is not sent again.
+ */
+export declare function sendReview(target: ReviewTarget): Promise<ReviewResult>;
+/** Finds out what happened to a submission whose outcome is unknown. Reading is safe to repeat. */
+export declare function checkReview(target: ReviewTarget): Promise<ReviewResult>;
+/** Discards the submission's pending review on GitHub, when one was left or the last step was refused. */
+export declare function discardReview(target: ReviewTarget): Promise<ReviewResult>;
+/** Forgets a submission the proxy no longer knows, keeping the words. Anything left on GitHub is handled there. */
+export declare function forgetReviewSubmission(name: string): void;

package/dist/{smart-http-BmHEkE7K.js → smart-http-eARzlXHO.js}

@@ -1,4 +1,103 @@
-import { n as init_objectSpread2, t as _objectSpread2 } from "./objectSpread2-Dkd68nJH.js";
+// \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res, err) => () => {
+	if (err) throw err[0];
+	try {
+		return fn && (res = fn(fn = 0)), res;
+	} catch (e) {
+		throw err = [e], e;
+	}
+};
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod, mod.exports), cb = null), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+// \0@oxc-project+runtime@0.156.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+var init_typeof = __esmMin((() => {}));
+// \0@oxc-project+runtime@0.156.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+var init_toPrimitive = __esmMin((() => {
+	init_typeof();
+}));
+// \0@oxc-project+runtime@0.156.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+var init_toPropertyKey = __esmMin((() => {
+	init_typeof();
+	init_toPrimitive();
+}));
+// \0@oxc-project+runtime@0.156.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+var init_defineProperty = __esmMin((() => {
+	init_toPropertyKey();
+}));
+// \0@oxc-project+runtime@0.156.0/helpers/esm/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r) {
+			return Object.getOwnPropertyDescriptor(e, r).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r) {
+			_defineProperty(e, r, t[r]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r) {
+			Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r));
+		});
+	}
+	return e;
+}
+var init_objectSpread2 = __esmMin((() => {
+	init_defineProperty();
+}));
 // \0@oxc-project+runtime@0.156.0/helpers/esm/asyncIterator.js
 function _asyncIterator(r) {
 	var n, t, o, e = 2;
@@ -300,4 +399,4 @@ function createGitSmartHttp(options) {
 		http: { request }
 	};
 }
-export { _OverloadYield as a, _wrapAsyncGenerator as i, MAX_GIT_REQUEST_BYTES as n, _asyncIterator as o, createGitSmartHttp as r, GitSmartHttpError as t };
+export { remoteUrl as a, _asyncIterator as c, __commonJSMin as d, __toESM as f, createGitSmartHttp as i, _objectSpread2 as l, MAX_GIT_REQUEST_BYTES as n, _wrapAsyncGenerator as o, checkConnection as r, _OverloadYield as s, GitSmartHttpError as t, init_objectSpread2 as u };

package/dist/smart-http.d.ts

@@ -33,6 +33,8 @@ export declare class GitSmartHttpError extends Error {
     readonly requestId?: string | undefined;
     constructor(code: GitSmartHttpErrorCode, statusCode?: number | undefined, requestId?: string | undefined);
 }
+export declare function remoteUrl(remote: string): string;
+export declare function checkConnection({ mode, proxyOrigin }: GitProxyConnection): void;
 export declare function createGitSmartHttp(options: GitSmartHttpOptions): {
     url: string;
     corsProxy: "";

package/dist/smart-http.js

@@ -1 +1 @@
-export { t as GitSmartHttpError, n as MAX_GIT_REQUEST_BYTES, r as createGitSmartHttp } from "./smart-http-BmHEkE7K.js";
+export { t as GitSmartHttpError, n as MAX_GIT_REQUEST_BYTES, r as checkConnection, i as createGitSmartHttp, a as remoteUrl } from "./smart-http-eARzlXHO.js";

package/dist/style.css

@@ -120,6 +120,16 @@
 .twgit-review-target-status { font-weight: 600; }
 .twgit-review-asset { display: flex; align-items: center; gap: 8px; }
 .twgit-review-asset img { width: 32px; height: 32px; object-fit: contain; }
+.twgit-review-field { display: grid; gap: 4px; }
+.twgit-review-field textarea { font: inherit; resize: vertical; min-height: 3em; }
+.twgit-review-comment { padding: 0 12px 10px; }
+.twgit-review-composer { display: grid; gap: 10px; margin-top: 14px; padding: 12px 14px; border: 1px solid var(--twgit-review-line, color-mix(in srgb, CanvasText 18%, Canvas)); border-radius: 8px; }
+.twgit-review-composer h3 { margin: 0; }
+.twgit-review-events { display: flex; flex-wrap: wrap; gap: 6px 16px; margin: 0; padding: 6px 10px; border: 1px solid var(--twgit-review-line, color-mix(in srgb, CanvasText 18%, Canvas)); border-radius: 6px; }
+.twgit-review-summary, .twgit-review-note, .twgit-review-state { margin: 0; }
+.twgit-review-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; }
+.twgit-review-result { display: flex; align-items: flex-start; justify-content: space-between; gap: 8px; margin: 0; }
+.twgit-review-result p { margin: 0; }
 :root{--diff-background-color:initial;--diff-text-color:initial;--diff-font-family:Consolas,Courier,monospace;--diff-selection-background-color:#b3d7ff;--diff-selection-text-color:var(--diff-text-color);--diff-gutter-insert-background-color:#d6fedb;--diff-gutter-insert-text-color:var(--diff-text-color);--diff-gutter-delete-background-color:#fadde0;--diff-gutter-delete-text-color:var(--diff-text-color);--diff-gutter-selected-background-color:#fffce0;--diff-gutter-selected-text-color:var(--diff-text-color);--diff-code-insert-background-color:#eaffee;--diff-code-insert-text-color:var(--diff-text-color);--diff-code-delete-background-color:#fdeff0;--diff-code-delete-text-color:var(--diff-text-color);--diff-code-insert-edit-background-color:#c0dc91;--diff-code-insert-edit-text-color:var(--diff-text-color);--diff-code-delete-edit-background-color:#f39ea2;--diff-code-delete-edit-text-color:var(--diff-text-color);--diff-code-selected-background-color:#fffce0;--diff-code-selected-text-color:var(--diff-text-color);--diff-omit-gutter-line-color:#cb2a1d;}.diff{background-color:var(--diff-background-color);border-collapse:collapse;color:var(--diff-text-color);table-layout:fixed;width:100%;}.diff::-moz-selection{background-color:#b3d7ff;background-color:var(--diff-selection-background-color);color:var(--diff-text-color);color:var(--diff-selection-text-color);}.diff::selection{background-color:#b3d7ff;background-color:var(--diff-selection-background-color);color:var(--diff-text-color);color:var(--diff-selection-text-color);}.diff td{padding-bottom:0;padding-top:0;vertical-align:top;}.diff-line{font-family:Consolas,Courier,monospace;font-family:var(--diff-font-family);line-height:1.5;}.diff-gutter>a{color:inherit;display:block;}.diff-gutter{cursor:pointer;padding:0 1ch;text-align:right;-webkit-user-select:none;-moz-user-select:none;user-select:none;}.diff-gutter-insert{background-color:#d6fedb;background-color:var(--diff-gutter-insert-background-color);color:var(--diff-text-color);color:var(--diff-gutter-insert-text-color);}.diff-gutter-delete{background-color:#fadde0;background-color:var(--diff-gutter-delete-background-color);color:var(--diff-text-color);color:var(--diff-gutter-delete-text-color);}.diff-gutter-omit{cursor:default;}.diff-gutter-selected{background-color:#fffce0;background-color:var(--diff-gutter-selected-background-color);color:var(--diff-text-color);color:var(--diff-gutter-selected-text-color);}.diff-code{word-wrap:break-word;padding:0 0 0 .5em;white-space:pre-wrap;word-break:break-all;}.diff-code-edit{color:inherit;}.diff-code-insert{background-color:#eaffee;background-color:var(--diff-code-insert-background-color);color:var(--diff-text-color);color:var(--diff-code-insert-text-color);}.diff-code-insert .diff-code-edit{background-color:#c0dc91;background-color:var(--diff-code-insert-edit-background-color);color:var(--diff-text-color);color:var(--diff-code-insert-edit-text-color);}.diff-code-delete{background-color:#fdeff0;background-color:var(--diff-code-delete-background-color);color:var(--diff-text-color);color:var(--diff-code-delete-text-color);}.diff-code-delete .diff-code-edit{background-color:#f39ea2;background-color:var(--diff-code-delete-edit-background-color);color:var(--diff-text-color);color:var(--diff-code-delete-edit-text-color);}.diff-code-selected{background-color:#fffce0;background-color:var(--diff-code-selected-background-color);color:var(--diff-text-color);color:var(--diff-code-selected-text-color);}.diff-widget-content{vertical-align:top;}.diff-gutter-col{width:7ch;}.diff-gutter-omit{height:0;}.diff-gutter-omit:before{background-color:#cb2a1d;background-color:var(--diff-omit-gutter-line-color);content:" ";display:block;height:100%;margin-left:4.6ch;overflow:hidden;white-space:pre;width:2px;}.diff-decoration{line-height:1.5;-webkit-user-select:none;-moz-user-select:none;user-select:none;}.diff-decoration-content{font-family:Consolas,Courier,monospace;font-family:var(--diff-font-family);padding:0;}.twgit-backdrop { position: fixed; inset: 0; z-index: 65000; background: #0006; display: flex; align-items: center; justify-content: center; }
 .twgit-panel { width: 94vw; height: 90vh; display: flex; flex-direction: column; background: Canvas; color: CanvasText; border: 1px solid GrayText; border-radius: 8px; box-shadow: 0 12px 48px #0005; font: 14px/1.5 system-ui, sans-serif; overflow: hidden; }
 .twgit-panel > header { display: flex; gap: 8px; align-items: center; padding: 10px 16px; border-bottom: 1px solid GrayText; }
@@ -242,4 +252,17 @@
 .twgit-branch-popup form input:not([type]) { flex: 1; min-width: 10em; font: inherit; }
 .twgit-branch-popup form button { color: inherit; background: transparent; border: 1px solid currentColor; border-radius: 4px; padding: 3px 8px; font: inherit; cursor: pointer; }
 .twgit-branch-popup form button:disabled { opacity: .5; cursor: default; }
+/* The branch button's result, at the bottom of the window, in the project folder status's look. */
+.twgit-snackbar { position: fixed; z-index: 1000; bottom: 1rem; left: 50%; transform: translateX(-50%); display: flex; align-items: center;
+    gap: 10px; box-sizing: border-box; max-width: min(32rem, calc(100vw - 2rem)); padding: .5rem .5rem .5rem .85rem; background: Canvas;
+    color: CanvasText; border: 1px solid currentColor; border-radius: .4rem; box-shadow: 0 4px 16px #0003; font: 14px/1.5 system-ui, sans-serif; }
+.twgit-snackbar > span { flex: 1; min-width: 0; overflow-wrap: anywhere; }
+.twgit-snackbar button { flex: none; color: inherit; background: transparent; border: 1px solid currentColor; border-radius: 4px;
+    padding: 2px 8px; font: inherit; cursor: pointer; }
+.twgit-snackbar button.twgit-close { border-color: transparent; padding: 0; }
+.twgit-snackbar button:focus-visible { outline: 2px solid currentColor; outline-offset: 1px; }
+/* The history in a side panel of the host. */
+.twgit-history-view { box-sizing: border-box; padding: 8px; font: 13px/1.5 system-ui, sans-serif; }
+.twgit-history-view > p { margin: 0 0 8px; }
+.twgit-history-view > button { color: inherit; background: transparent; border: 1px solid currentColor; border-radius: 4px; padding: 3px 8px; font: inherit; cursor: pointer; }
 /*$vite$:1*/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kubohiroya/turbowarp-plus-editor-git",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Read-only local Git panel for TurboWarp Plus Editor",
   "type": "module",
   "license": "MPL-2.0",

package/src/branch-button.tsx

@@ -1,4 +1,6 @@
 import React, {useEffect, useLayoutEffect, useRef, useState} from 'react';
+import {createPortal} from 'react-dom';
+import {CloseButton} from './close-button.js';
 import type {HistoryActionResult} from './history-graph-view.js';
 import {labelsFor} from './messages.js';
 import type {BranchRefs} from './repository.js';
@@ -11,11 +13,15 @@ export interface BranchButtonState extends BranchRefs {
     writable: boolean;
     /** Whether the panel is running an operation. */
     busy: boolean;
+    /** Whether a project folder is selected in the panel, so a switch can offer to reload it. */
+    project: boolean;
 }
 /** What the branch button asks the Git panel to do. Branch operations resolve as the panel's own buttons do. */
 export interface BranchButtonActions {
     open(): void;
     choose(): void;
+    /** The panel's Reload Project, which asks before replacing unsaved edits. */
+    reload(): void;
     switchBranch(name: string): Promise<HistoryActionResult>;
     /** Creates a branch at HEAD. */
     createBranch(name: string, checkout: boolean): Promise<HistoryActionResult>;
@@ -29,6 +35,74 @@ export interface BranchButtonProps extends BranchButtonActions {
 interface Item {id: string; label: string; checked?: boolean; disabled?: boolean; separatorBefore?: boolean; run(): void}
 
 const menuItems = '[role="menuitem"], [role="menuitemradio"]';
+/** How long a snackbar stays when it is neither hovered nor focused. */
+export const snackbarDuration = 6000;
+interface Snack {id: number; text: string; alert: boolean; action?: {label: string; run(): void}}
+
+/**
+ * A short result at the bottom of the window, with the project folder's status look. It stays while hovered or
+ * focused, Escape or the close button dismisses it, and focus is never moved into it.
+ */
+function Snackbar({snack, closeLabel, onClose}: {snack: Snack; closeLabel: string; onClose(focus: boolean): void}) {
+    // Kept outside React state, so a pointer or focus arriving just before the timeout stops it at once.
+    const held = useRef({hover: false, focus: false});
+    const timer = useRef<ReturnType<typeof setTimeout>>();
+    const hold = (change: Partial<typeof held.current>) => {
+        held.current = {...held.current, ...change};
+        clearTimeout(timer.current);
+        if (!held.current.hover && !held.current.focus) timer.current = setTimeout(() => onClose(false), snackbarDuration);
+    };
+    useEffect(() => {
+        hold({});
+        return () => clearTimeout(timer.current);
+    }, []);
+    return createPortal(<div className="twgit-snackbar" data-git-snackbar=""
+        onMouseEnter={() => hold({hover: true})} onMouseLeave={() => hold({hover: false})}
+        onFocus={() => hold({focus: true})}
+        onBlur={event => {
+            if (!event.currentTarget.contains(event.relatedTarget as Node | null)) hold({focus: false});
+        }}
+        onKeyDown={event => {
+            if (event.key !== 'Escape') return;
+            event.preventDefault();
+            event.stopPropagation();
+            onClose(true);
+        }}>
+        <span role={snack.alert ? 'alert' : 'status'}>{snack.text}</span>
+        {snack.action && <button type="button" onClick={() => {onClose(true); snack.action!.run();}}>{snack.action.label}</button>}
+        <CloseButton label={closeLabel} onClick={() => onClose(true)}/>
+    </div>, document.body);
+}
+
+/**
+ * The results of branch operations in a snackbar, as the branch button and the history view tell them: a switch with
+ * Reload Project while a project folder is selected, a new branch, or the reason for a refusal with Open Local Git.
+ * A declined confirmation tells nothing. `restoreFocus` takes the focus back when the snackbar closes from inside.
+ */
+export function useBranchSnackbar(locale: string, project: boolean, actions: Pick<BranchButtonActions, 'open' | 'reload'>,
+    restoreFocus?: () => void) {
+    const labels = labelsFor(locale);
+    const [snack, setSnack] = useState<Snack | null>(null);
+    const snacks = useRef(0);
+    const mounted = useRef(true);
+    useEffect(() => () => {mounted.current = false;}, []);
+    const show = (text: string, alert: boolean, action?: Snack['action']) => {
+        if (mounted.current) setSnack({id: ++snacks.current, text, alert, action});
+    };
+    const report = (result: HistoryActionResult, switched: boolean) => {
+        if (result.done) {
+            if (!switched) show(labels.branchCreated, false);
+            // The switch rewrote the files; the open project shows them after Reload Project.
+            else show(labels.switchedShort, false, project ? {label: labels.reload, run: actions.reload} : undefined);
+        } else if (result.error) show(result.error, true, {label: labels.openPanel, run: actions.open});
+    };
+    const element = snack && <Snackbar key={snack.id} snack={snack} closeLabel={labels.close} onClose={focus => {
+        setSnack(previous => previous?.id === snack.id ? null : previous);
+        // Focus inside the snackbar would be lost with it.
+        if (focus) restoreFocus?.();
+    }}/>;
+    return {report, element};
+}
 
 /** Git's branch glyph, drawn in the text color. */
 function BranchIcon() {
@@ -100,11 +174,9 @@ export function BranchButton({state, locale = 'en', ...actions}: BranchButtonPro
         setInitial(from);
         setMode('menu');
     };
-    /** Runs a branch operation and shows its result, or why it did not run, in the panel. */
-    const change = async (operation: () => Promise<HistoryActionResult>) => {
-        const result = await operation();
-        if (result.done || result.error) actions.open();
-    };
+    const {report, element: snackbar} = useBranchSnackbar(locale, state.project, actions,
+        () => trigger.current?.focus({preventScroll: true}));
+    const change = async (operation: () => Promise<HistoryActionResult>) => report(await operation(), true);
     const items: Item[] = [];
     if (!state.repository) {
         items.push({id: 'choose', label: labels.choose, run: () => {close(); actions.choose();}});
@@ -169,7 +241,7 @@ export function BranchButton({state, locale = 'en', ...actions}: BranchButtonPro
         setCreating(false);
         if (result.done) {
             close();
-            actions.open();
+            report(result, checkout);
         } else setCreateError(result.error ?? '');
     };
     return <div className="twgit-branch-entry" ref={root} onBlur={event => {
@@ -212,5 +284,6 @@ export function BranchButton({state, locale = 'en', ...actions}: BranchButtonPro
                 </span>
             </form>
         </div>}
+        {snackbar}
     </div>;
 }

package/src/change-marks.ts

@@ -0,0 +1,22 @@
+import type {FileChange} from './repository.js';
+
+/** How a file stands in Git, as a folder explorer marks it. */
+export type ChangeMark = 'added' | 'modified' | 'deleted' | 'untracked';
+
+/**
+ * The marks of the working tree's changes under `folder` (a path inside the repository, '' for its root), by path
+ * relative to `folder`. A file with both staged and unstaged changes is marked as its working tree stands.
+ */
+export function changeMarks(changes: readonly FileChange[], folder: string): Map<string, ChangeMark> {
+    const prefix = folder.replace(/^\/+|\/+$/gu, '');
+    const marks = new Map<string, ChangeMark>();
+    for (const group of ['staged', 'unstaged', 'untracked'] as const) {
+        for (const change of changes) {
+            if (change.group !== group) continue;
+            if (prefix && !change.path.startsWith(prefix + '/')) continue;
+            const path = prefix ? change.path.slice(prefix.length + 1) : change.path;
+            marks.set(path, group === 'untracked' ? 'untracked' : !change.after ? 'deleted' : !change.before ? 'added' : 'modified');
+        }
+    }
+    return marks;
+}

package/src/connection-settings.tsx

@@ -1,6 +1,7 @@
 import React, {useEffect, useRef, useState} from 'react';
 import type {GitAuthState, GitConnectionMode as Mode} from '@kubohiroya/turbowarp-plus-editor-auth';
 import type {GetRemoteSession, RemoteOperation} from './remote-operations.js';
+import {reviewLabelsFor} from './messages.js';
 
 export interface GitConnectionSettings {
     modes: readonly Mode[];
@@ -9,10 +10,12 @@ export interface GitConnectionSettings {
         state: GitAuthState;
         proxyOrigin?: string;
         write?: boolean;
+        /** Whether the connection was made with the grant to send pull request reviews. */
+        review?: boolean;
         authorization?: {url: string; userCode?: string};
     };
     select(mode: Mode): Promise<void>;
-    connect(remote: string, write?: boolean): Promise<void>;
+    connect(remote: string, write?: boolean, review?: boolean): Promise<void>;
     refresh(): Promise<void>;
     disconnect(): Promise<void>;
     getSession?: GetRemoteSession;
@@ -49,6 +52,7 @@ export function ConnectionSettings({settings, locale, readOrigin, runOperation}:
     const [, update] = useState(0);
     const [busy, setBusy] = useState(false);
     const [allowPush, setAllowPush] = useState(false);
+    const [allowReview, setAllowReview] = useState(false);
     const [error, setError] = useState<'error' | 'invalid' | null>(null);
     const active = useRef(true);
     useEffect(() => {active.current = true; return () => {active.current = false;};}, []);
@@ -66,7 +70,7 @@ export function ConnectionSettings({settings, locale, readOrigin, runOperation}:
     const connect = () => run(async () => {
         const remote = await readOrigin?.();
         if (!remote) throw new Error('INVALID_REMOTE');
-        await settings.connect(remote, allowPush);
+        await (allowReview ? settings.connect(remote, allowPush, true) : settings.connect(remote, allowPush));
     });
     const connected = !!mode && state.status === 'connected';
     // Sync sits beside the GitHub status; the settings open over the list instead of pushing it down.
@@ -92,6 +96,9 @@ export function ConnectionSettings({settings, locale, readOrigin, runOperation}:
                 {runOperation && <label><input type="checkbox" checked={allowPush}
                     disabled={busy || state.status === 'connecting' || state.status === 'connected'}
                     onChange={event => setAllowPush(event.currentTarget.checked)}/> {labels.allowPush}</label>}
+                <label><input type="checkbox" data-git-allow-review="" checked={allowReview}
+                    disabled={busy || state.status === 'connecting' || state.status === 'connected'}
+                    onChange={event => setAllowReview(event.currentTarget.checked)}/> {reviewLabelsFor(locale).allowReview}</label>
                 <button disabled={busy || !readOrigin || state.status === 'connecting' || state.status === 'connected'}
                     onClick={connect}>{labels.connect}</button>
                 {authorization && <p>{authorization.userCode && <code>{authorization.userCode} </code>}