@kubohiroya/turbowarp-plus-editor-git 0.9.0 → 0.11.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;