@lvce-editor/api 8.70.0 → 8.71.0

package/dist/index.d.ts

@@ -11,6 +11,7 @@ export { executeCompletionProvider, executeResolveCompletionItemProvider, getCom
 export { executeDiagnosticProvider, getDiagnosticProviderRegistrySnapshot, registerDiagnosticProvider, resetDiagnosticProviderRegistry, } from './parts/Diagnostic/Diagnostic.ts';
 export { executeFormattingProvider, getFormattingProviderRegistrySnapshot, registerFormattingProvider, resetFormattingProviderRegistry, } from './parts/Formatting/Formatting.ts';
 export { exists, mkdir, readAsObjectUrl, readDirWithFileTypes, readFile, remove, stat, writeFile, type ReadAsObjectUrlResult, } from './parts/FileSystem/FileSystem.ts';
+export { registerFileChangeHandler, type FileChangeHandler, type FileChanges } from './parts/FileChangeHandler/FileChangeHandler.ts';
 export { executeFileSystemProviderGetPathSeparator, executeFileSystemProviderIsReadonly, executeFileSystemProviderReadDirWithFileTypes, executeFileSystemProviderReadFile, getFileSystemProviderRegistrySnapshot, registerFileSystemProvider, resetFileSystemProviderRegistry, } from './parts/FileSystemProviderRegistry/FileSystemProviderRegistry.ts';
 export { confirm, getWorkspaceFolder, getWorkspaceUri, handleWorkspaceRefresh, openUri, showNotification, type NotificationType, } from './parts/Host/Host.ts';
 export { executeHoverProvider, getHoverProviderRegistrySnapshot, registerHoverProvider, resetHoverProviderRegistry } from './parts/Hover/Hover.ts';

package/dist/index.js

@@ -11,6 +11,7 @@ export { executeCompletionProvider, executeResolveCompletionItemProvider, getCom
 export { executeDiagnosticProvider, getDiagnosticProviderRegistrySnapshot, registerDiagnosticProvider, resetDiagnosticProviderRegistry, } from "./parts/Diagnostic/Diagnostic.js";
 export { executeFormattingProvider, getFormattingProviderRegistrySnapshot, registerFormattingProvider, resetFormattingProviderRegistry, } from "./parts/Formatting/Formatting.js";
 export { exists, mkdir, readAsObjectUrl, readDirWithFileTypes, readFile, remove, stat, writeFile, } from "./parts/FileSystem/FileSystem.js";
+export { registerFileChangeHandler } from "./parts/FileChangeHandler/FileChangeHandler.js";
 export { executeFileSystemProviderGetPathSeparator, executeFileSystemProviderIsReadonly, executeFileSystemProviderReadDirWithFileTypes, executeFileSystemProviderReadFile, getFileSystemProviderRegistrySnapshot, registerFileSystemProvider, resetFileSystemProviderRegistry, } from "./parts/FileSystemProviderRegistry/FileSystemProviderRegistry.js";
 export { confirm, getWorkspaceFolder, getWorkspaceUri, handleWorkspaceRefresh, openUri, showNotification, } from "./parts/Host/Host.js";
 export { executeHoverProvider, getHoverProviderRegistrySnapshot, registerHoverProvider, resetHoverProviderRegistry } from "./parts/Hover/Hover.js";

package/dist/parts/CommandMap/CommandMap.d.ts

@@ -46,6 +46,7 @@ export declare const commandMap: {
     'ExtensionApi.getViewActionsDom': (uid: number) => readonly import("@lvce-editor/virtual-dom-worker").VirtualDomNode[] | undefined;
     'ExtensionApi.getViewMenuEntries': (uid: number, menuId: string) => Promise<readonly import("../View/View.ts").MenuEntry[]>;
     'ExtensionApi.getViewRegistrySnapshot': () => import("../View/View.ts").ViewRegistrySnapshot;
+    'ExtensionApi.handleFileChanges': (changes?: Readonly<import("../FileChangeHandler/FileChangeHandler.ts").FileChanges>) => Promise<void>;
     'ExtensionApi.renderViewInstance': (uid: number) => Promise<import("../View/View.ts").ViewRenderResult>;
     'ExtensionApi.saveViewInstanceState': (uid: number) => Promise<unknown>;
     'ExtensionHostDebug.evaluate': (id: string, expression: string, callFrameId: string) => Promise<unknown>;

package/dist/parts/ExtensionApiCommandMap/ExtensionApiCommandMap.d.ts

@@ -45,6 +45,7 @@ export declare const commandMap: {
     'ExtensionApi.getViewActionsDom': (uid: number) => readonly import("@lvce-editor/virtual-dom-worker").VirtualDomNode[] | undefined;
     'ExtensionApi.getViewMenuEntries': (uid: number, menuId: string) => Promise<readonly import("../View/View.ts").MenuEntry[]>;
     'ExtensionApi.getViewRegistrySnapshot': () => import("../View/View.ts").ViewRegistrySnapshot;
+    'ExtensionApi.handleFileChanges': (changes?: Readonly<import("../FileChangeHandler/FileChangeHandler.ts").FileChanges>) => Promise<void>;
     'ExtensionApi.renderViewInstance': (uid: number) => Promise<import("../View/View.ts").ViewRenderResult>;
     'ExtensionApi.saveViewInstanceState': (uid: number) => Promise<unknown>;
     'ExtensionHostDebug.evaluate': (id: string, expression: string, callFrameId: string) => Promise<unknown>;

package/dist/parts/ExtensionApiCommandMap/ExtensionApiCommandMap.js

@@ -2,6 +2,7 @@ import { executeCommand, getCommandRegistrySnapshot } from "../CommandRegistry/C
 import { executeCompletionProvider, executeResolveCompletionItemProvider, getCompletionProviderRegistrySnapshot } from "../Completion/Completion.js";
 import { executeDebugEvaluate, executeDebugGetProperties, executeDebugListProcesses, executeDebugPause, executeDebugResume, executeDebugSetPauseOnExceptions, executeDebugStart, executeDebugStep, executeDebugStepInto, executeDebugStepOut, executeDebugStepOver, } from "../Debug/Debug.js";
 import { executeDiagnosticProvider, getDiagnosticProviderRegistrySnapshot } from "../Diagnostic/Diagnostic.js";
+import { handleFileChanges } from "../FileChangeHandler/FileChangeHandler.js";
 import { executeFileSystemProviderGetPathSeparator, executeFileSystemProviderIsReadonly, executeFileSystemProviderReadDirWithFileTypes, executeFileSystemProviderReadFile, getFileSystemProviderRegistrySnapshot, } from "../FileSystemProviderRegistry/FileSystemProviderRegistry.js";
 import { executeFormattingProvider, getFormattingProviderRegistrySnapshot } from "../Formatting/Formatting.js";
 import { getStatusBarItems } from "../GetStatusBarItems/GetStatusBarItems.js";
@@ -54,6 +55,7 @@ export const commandMap = {
     'ExtensionApi.getViewActionsDom': getViewActionsDom,
     'ExtensionApi.getViewMenuEntries': getViewMenuEntries,
     'ExtensionApi.getViewRegistrySnapshot': getViewRegistrySnapshot,
+    'ExtensionApi.handleFileChanges': handleFileChanges,
     'ExtensionApi.renderViewInstance': renderViewInstance,
     'ExtensionApi.saveViewInstanceState': saveViewInstanceState,
     'ExtensionHostDebug.evaluate': executeDebugEvaluate,

package/dist/parts/ExtensionApiWorkerCommandMap/ExtensionApiWorkerCommandMap.d.ts

@@ -47,6 +47,7 @@ export declare const commandMap: {
     'ExtensionApi.getViewActionsDom': (uid: number) => readonly import("@lvce-editor/virtual-dom-worker").VirtualDomNode[] | undefined;
     'ExtensionApi.getViewMenuEntries': (uid: number, menuId: string) => Promise<readonly import("../View/View.ts").MenuEntry[]>;
     'ExtensionApi.getViewRegistrySnapshot': () => import("../View/View.ts").ViewRegistrySnapshot;
+    'ExtensionApi.handleFileChanges': (changes?: Readonly<import("../FileChangeHandler/FileChangeHandler.ts").FileChanges>) => Promise<void>;
     'ExtensionApi.renderViewInstance': (uid: number) => Promise<import("../View/View.ts").ViewRenderResult>;
     'ExtensionApi.saveViewInstanceState': (uid: number) => Promise<unknown>;
     'ExtensionHostDebug.evaluate': (id: string, expression: string, callFrameId: string) => Promise<unknown>;

package/dist/parts/FileChangeHandler/FileChangeHandler.d.ts

@@ -0,0 +1,12 @@
+import type { Disposable } from '../Disposable/Disposable.ts';
+type UriRename = readonly [oldUri: string, newUri: string];
+export interface FileChanges {
+    readonly changed?: readonly string[];
+    readonly deleted?: readonly string[];
+    readonly renamed?: readonly UriRename[];
+}
+export type FileChangeHandler = (changes: Readonly<FileChanges>) => unknown | Promise<unknown>;
+export declare const registerFileChangeHandler: (handler: FileChangeHandler) => Disposable;
+export declare const handleFileChanges: (changes?: Readonly<FileChanges>) => Promise<void>;
+export declare const resetFileChangeHandlers: () => void;
+export {};

package/dist/parts/FileChangeHandler/FileChangeHandler.js

@@ -0,0 +1,42 @@
+import { ExtensionManagementWorker } from '@lvce-editor/rpc-registry';
+import { ExtensionApiError } from "../ExtensionApiError/ExtensionApiError.js";
+const handlers = new Set();
+const registerWithExtensionManagement = () => {
+    void ExtensionManagementWorker.invoke('Extensions.registerFileChangeHandler');
+};
+const unregisterWithExtensionManagement = () => {
+    void ExtensionManagementWorker.invoke('Extensions.unregisterFileChangeHandler');
+};
+export const registerFileChangeHandler = (handler) => {
+    if (typeof handler !== 'function') {
+        throw new ExtensionApiError('file change handler must be a function');
+    }
+    if (handlers.has(handler)) {
+        throw new ExtensionApiError('file change handler is already registered');
+    }
+    const wasEmpty = handlers.size === 0;
+    handlers.add(handler);
+    if (wasEmpty) {
+        registerWithExtensionManagement();
+    }
+    return {
+        dispose() {
+            if (!handlers.delete(handler)) {
+                return;
+            }
+            if (handlers.size === 0) {
+                unregisterWithExtensionManagement();
+            }
+        },
+    };
+};
+export const handleFileChanges = async (changes = {}) => {
+    await Promise.all(Array.from(handlers, async (handler) => handler(changes)));
+};
+export const resetFileChangeHandlers = () => {
+    if (handlers.size === 0) {
+        return;
+    }
+    handlers.clear();
+    unregisterWithExtensionManagement();
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lvce-editor/api",
-  "version": "8.70.0",
+  "version": "8.71.0",
   "description": "Tree-shakeable extension API for Lvce Editor extensions.",
   "keywords": [
     "lvce-editor",