@kubohiroya/turbowarp-plus-editor-git 0.0.0-stage → 0.8.0

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

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

package/dist/project-assets.d.ts

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

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

@@ -0,0 +1,26 @@
+import React from 'react';
+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 { ProjectSourceComparison, ProjectSourceReview } from './project-source-review.js';
+export type { ProjectSourceComparisonProps, ProjectSourceReviewFile, ProjectSourceReviewProps } from './project-source-review.js';
+export { createScratchBlocksDiffLocator } from './block-diff-location.js';
+export type { ProjectBlockLocation, ProjectBlockLocator, ScratchBlockLocationWorkspace } from './block-diff-location.js';
+export type { BlockPart } from './project-source-patch.js';
+export { createProjectSourceDiff } from './project-source-patch.js';
+export { currentCostume } from './project-assets.js';
+export type { ProjectAssetLoader, ProjectVersion } from './project-assets.js';
+export { createScratchBlocksDiffRenderer } from './scratch-block-diff-renderer.js';
+export type { BlockPreviewView, BlockPreviewViewport, ProjectBlockRenderer, ProjectBlockRendering, ScratchBlockDiffRendererOptions, ScratchBlocksPort } from './scratch-block-diff-renderer.js';
+export { createPreviewSync } from './block-diff-preview.js';
+export type { PreviewSync } from './block-diff-preview.js';
+export interface ProjectSourceBlockDiffProps {
+    patch: string;
+    /** Supply the original JSON if the unified patch omits context. */
+    beforeSource?: string;
+    renderBlock: ProjectBlockRenderer;
+    locateBlock?: ProjectBlockLocator;
+    locale?: string;
+}
+export declare function ProjectSourceBlockDiff({ patch, beforeSource, renderBlock, locateBlock, locale }: ProjectSourceBlockDiffProps): React.JSX.Element;

package/dist/project-source-diff.js

@@ -0,0 +1,172 @@
+import { a as gitHubRepositoryFromOrigin, c as BlockPreview, d as currentCostume, f as compareProjectBlocks, i as createGitHubPullRequests, l as createPreviewSync, m as readProjectSourceDiff, n as createScratchBlocksDiffLocator, o as ProjectSourceComparison, p as createProjectSourceDiff, s as ProjectSourceReview, t as createScratchBlocksDiffRenderer, u as usePreviewSync } from "./scratch-block-diff-renderer-xS8OYsRl.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
+init_objectSpread2();
+var en = {
+	title: "Block changes",
+	before: "Before",
+	after: "After",
+	added: "Added",
+	removed: "Removed",
+	updated: "Changed",
+	inputs: "Inputs",
+	fields: "Fields",
+	opcode: "Block type",
+	mutation: "Block shape",
+	position: "Position",
+	connection: "Connections",
+	properties: "Other block properties",
+	absent: "No block on this side",
+	omitted: (count) => `${count} unchanged blocks omitted from the change list`,
+	context: "Highlight in the surrounding code",
+	more: "Show more changes",
+	noChanges: "No block changes.",
+	locate: "Highlight in Editor",
+	locating: "Finding the block in the Editor…",
+	located: "Highlighted in the Editor.",
+	missingLocation: "This version or block is unavailable in the Editor. Open its surrounding code here.",
+	partLegend: "Orange outlines mark changed inputs and fields.",
+	otherChanges: "The project also has changes outside its block code.",
+	invalid: "This diff could not be read. Use a full-context project diff, or provide the original project.",
+	loading: "Rendering blocks…",
+	unavailable: "This block could not be rendered. Check the block definitions available in the host."
+};
+var ja = {
+	title: "ブロックの変更",
+	before: "変更前",
+	after: "変更後",
+	added: "追加",
+	removed: "削除",
+	updated: "変更",
+	inputs: "入力値",
+	fields: "フィールド",
+	opcode: "ブロックの種類",
+	mutation: "ブロックの形",
+	position: "位置",
+	connection: "つなぎ方",
+	properties: "その他のブロック属性",
+	absent: "この側にはブロックがありません",
+	omitted: (count) => `変更のないブロック ${count} 個を一覧から省略`,
+	context: "元のコード内で強調",
+	more: "続きを表示",
+	noChanges: "ブロックの変更はありません。",
+	locate: "編集画面で強調",
+	locating: "編集画面でブロックを検索中…",
+	located: "編集画面で強調しました。",
+	missingLocation: "編集画面に該当する版またはブロックがありません。元のコードをここで展開できます。",
+	partLegend: "オレンジの枠は、変更された入力欄やフィールドです。",
+	otherChanges: "ブロックのコード以外にも作品の変更があります。",
+	invalid: "差分を読み込めません。全体の文脈を含む差分を使うか、変更前の作品を指定してください。",
+	loading: "ブロックを描画中…",
+	unavailable: "ブロックを描画できません。ホストのブロック定義を確認してください。"
+};
+var propertyLabels = /* @__PURE__ */ new Map([
+	["inputs", "inputs"],
+	["fields", "fields"],
+	["opcode", "opcode"],
+	["mutation", "mutation"],
+	["x", "position"],
+	["y", "position"],
+	["next", "connection"],
+	["parent", "connection"],
+	["topLevel", "connection"]
+]);
+function ChangeCard({ change, renderBlock, labels, onLocate, location }) {
+	var _change$after;
+	const [withContext, setWithContext] = useState(false);
+	const { sync, toggle } = usePreviewSync(labels === en ? "en" : "ja");
+	const notes = [...new Set(change.fields.map((field) => {
+		var _propertyLabels$get;
+		return labels[(_propertyLabels$get = propertyLabels.get(field)) !== null && _propertyLabels$get !== void 0 ? _propertyLabels$get : "properties"];
+	}))];
+	const name = ((_change$after = change.after) !== null && _change$after !== void 0 ? _change$after : change.before).target.name;
+	return /* @__PURE__ */ React.createElement("article", { className: `twgit-block-diff-card twgit-block-diff-${change.kind}` }, /* @__PURE__ */ React.createElement("header", null, /* @__PURE__ */ React.createElement("h3", null, /* @__PURE__ */ React.createElement("span", null, labels[change.kind]), " ", name), !!notes.length && /* @__PURE__ */ React.createElement("p", null, notes.join(" · ")), !!change.parts.length && /* @__PURE__ */ React.createElement("p", { className: "twgit-block-diff-legend" }, labels.partLegend)), /* @__PURE__ */ React.createElement("div", { className: "twgit-block-diff-sides" }, ["before", "after"].map((version) => /* @__PURE__ */ React.createElement(BlockPreview, {
+		key: version,
+		side: change[version],
+		title: labels[version],
+		renderBlock,
+		withContext,
+		labels,
+		parts: change.parts,
+		onLocate: onLocate && (() => onLocate(version)),
+		version,
+		sync,
+		locationStatus: (location === null || location === void 0 ? void 0 : location.version) === version ? location.status : void 0
+	}))), toggle, /* @__PURE__ */ React.createElement("label", null, /* @__PURE__ */ React.createElement("input", {
+		type: "checkbox",
+		checked: withContext,
+		onChange: (event) => setWithContext(event.currentTarget.checked)
+	}), " ", labels.context));
+}
+var pageSize = 12;
+var empty = {
+	changes: [],
+	unchanged: 0,
+	otherChanges: false
+};
+function ProjectSourceBlockDiff({ patch, beforeSource, renderBlock, locateBlock, locale = "en" }) {
+	const labels = locale.startsWith("ja") ? ja : en;
+	const result = useMemo(() => {
+		try {
+			const projects = readProjectSourceDiff(patch, beforeSource);
+			return projects ? compareProjectBlocks(...projects) : empty;
+		} catch (_unused) {
+			return null;
+		}
+	}, [patch, beforeSource]);
+	const [page, setPage] = useState({
+		result,
+		visible: pageSize
+	});
+	const request = useRef();
+	const [location, setLocation] = useState();
+	useEffect(() => () => {
+		var _request$current;
+		return (_request$current = request.current) === null || _request$current === void 0 ? void 0 : _request$current.abort();
+	}, [result, locateBlock]);
+	const locate = async (change, version) => {
+		var _request$current2;
+		const side = change[version];
+		if (!side || !locateBlock) return;
+		(_request$current2 = request.current) === null || _request$current2 === void 0 || _request$current2.abort();
+		const controller = new AbortController();
+		request.current = controller;
+		const selected = {
+			result,
+			key: change.key,
+			version,
+			locator: locateBlock
+		};
+		setLocation(_objectSpread2(_objectSpread2({}, selected), {}, { status: "locating" }));
+		let found = false;
+		try {
+			found = await locateBlock(_objectSpread2(_objectSpread2({}, side), {}, {
+				version,
+				parts: change.parts,
+				signal: controller.signal
+			}));
+		} catch (_unused2) {}
+		if (!controller.signal.aborted) setLocation(_objectSpread2(_objectSpread2({}, selected), {}, { status: found ? "located" : "missingLocation" }));
+	};
+	if (!result) return /* @__PURE__ */ React.createElement("p", { role: "alert" }, labels.invalid);
+	const visible = page.result === result ? page.visible : pageSize;
+	return /* @__PURE__ */ React.createElement("section", {
+		className: "twgit-block-diff",
+		"aria-label": labels.title
+	}, /* @__PURE__ */ React.createElement("h2", null, labels.title, " · ", result.changes.length), result.unchanged > 0 && /* @__PURE__ */ React.createElement("p", null, labels.omitted(result.unchanged)), result.otherChanges && /* @__PURE__ */ React.createElement("p", null, labels.otherChanges), !result.changes.length && /* @__PURE__ */ React.createElement("p", null, labels.noChanges), result.changes.slice(0, visible).map((change) => /* @__PURE__ */ React.createElement(ChangeCard, {
+		key: change.key,
+		change,
+		renderBlock,
+		labels,
+		onLocate: locateBlock && ((version) => void locate(change, version)),
+		location: (location === null || location === void 0 ? void 0 : location.result) === result && location.locator === locateBlock && location.key === change.key ? location : void 0
+	})), visible < result.changes.length && /* @__PURE__ */ React.createElement("button", {
+		type: "button",
+		onClick: () => setPage({
+			result,
+			visible: visible + pageSize
+		})
+	}, labels.more));
+}
+export { ProjectSourceBlockDiff, ProjectSourceComparison, ProjectSourceReview, createGitHubPullRequests, createPreviewSync, createProjectSourceDiff, createScratchBlocksDiffLocator, createScratchBlocksDiffRenderer, currentCostume, gitHubRepositoryFromOrigin };

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

@@ -0,0 +1,39 @@
+export type BlockTable = Record<string, unknown>;
+export interface ProjectTarget {
+    name: string;
+    isStage: boolean;
+    blocks: BlockTable;
+}
+export type ProjectSource = Record<string, unknown> & {
+    targets: ProjectTarget[];
+};
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+/** Reads one version of a project.source.json. `null` stands for a version in which the file does not exist. */
+export declare function parseProjectSource(source: string | null): ProjectSource;
+/** Keep the original lines and include enough context to render both sides from the patch alone. */
+export declare function createProjectSourceDiff(before: string, after: string): string;
+export declare function readProjectSourceDiff(patch: string, beforeSource?: string): [ProjectSource, ProjectSource] | null;
+export declare function equal(a: unknown, b: unknown): boolean;
+export declare const targetKey: (target: ProjectTarget) => string;
+export interface BlockSide {
+    target: ProjectTarget;
+    id: string;
+}
+export interface BlockPart {
+    kind: 'input' | 'field';
+    name: string;
+}
+export type BlockChangeKind = 'added' | 'removed' | 'updated';
+export interface BlockChange {
+    key: string;
+    before?: BlockSide;
+    after?: BlockSide;
+    kind: BlockChangeKind;
+    fields: string[];
+    parts: BlockPart[];
+}
+export declare function compareProjectBlocks(before: ProjectSource, after: ProjectSource): {
+    changes: BlockChange[];
+    unchanged: number;
+    otherChanges: boolean;
+};

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

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

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

@@ -0,0 +1,38 @@
+import React from 'react';
+import type { ProjectBlockRenderer } from './scratch-block-diff-renderer.js';
+import type { ProjectAssetLoader } from './project-assets.js';
+export type ProjectSourceReviewFile = {
+    path: string;
+    summary?: string;
+    previousPath?: string;
+    unavailable?: boolean;
+} & ({
+    patch: string;
+    beforeSource?: string;
+    loadAsset?: ProjectAssetLoader;
+} | {
+    status: 'added' | 'removed' | 'updated';
+});
+export interface ProjectSourceReviewProps {
+    title: string;
+    description?: string;
+    verification?: readonly string[];
+    files: readonly ProjectSourceReviewFile[];
+    renderBlock: ProjectBlockRenderer;
+    locale?: string;
+}
+export interface ProjectSourceComparisonProps {
+    /** The earlier project.source.json, or `null` when the file did not exist yet. */
+    before: string | null;
+    /** The later project.source.json, or `null` when the file was removed. */
+    after: string | null;
+    renderBlock: ProjectBlockRenderer;
+    locale?: string;
+    /** Shown after an explanation when either version cannot be read as a project. Without it, only an error is shown. */
+    fallback?: React.ReactNode;
+    /** Reads the images of both versions for thumbnails. Without it, stages and sprites are shown by name. */
+    loadAsset?: ProjectAssetLoader;
+}
+/** 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 }: 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

@@ -0,0 +1,8 @@
+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 }: {
+    repository: Repository;
+    locale: string;
+    renderBlock: ProjectBlockRenderer;
+}): React.JSX.Element;

package/dist/remote-operations.d.ts

@@ -0,0 +1,5 @@
+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 declare function runRemoteOperation(root: FileSystemDirectoryHandle, operation: RemoteOperation, getSession: GetRemoteSession, guard: () => void, signal?: AbortSignal): Promise<void>;