@lvce-editor/api 8.39.0 → 8.41.0

package/dist/index.d.ts

@@ -8,11 +8,11 @@ export { executeDiagnosticProvider, getDiagnosticProviderRegistrySnapshot, regis
 export { executeFormattingProvider, getFormattingProviderRegistrySnapshot, registerFormattingProvider, resetFormattingProviderRegistry, } from './parts/Formatting/Formatting.ts';
 export { exists, mkdir, readDirWithFileTypes, readFile, remove, writeFile } from './parts/FileSystem/FileSystem.ts';
 export { executeHoverProvider, getHoverProviderRegistrySnapshot, registerHoverProvider, resetHoverProviderRegistry } from './parts/Hover/Hover.ts';
-export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, registerSourceControlProvider, resetSourceControlProviderRegistry, } from './parts/SourceControl/SourceControl.ts';
+export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetBadgeCount, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, registerSourceControlProvider, resetSourceControlProviderRegistry, } from './parts/SourceControl/SourceControl.ts';
 export { createViewInstance, dispatchViewEvent, disposeViewInstance, executeViewProvider, getViewRegistrySnapshot, renderViewInstance, registerView, resetViewRegistry, saveViewInstanceState, } from './parts/ViewRegistry/ViewRegistry.ts';
 export { createOutputChannel, getOutputChannelRegistrySnapshot, resetOutputChannelRegistry } from './parts/OutputChannel/OutputChannel.ts';
 export { getStatusBarItemProviderRegistrySnapshot, registerStatusBarItemProvider, resetStatusBarItemProviderRegistry, } from './parts/StatusBar/StatusBar.ts';
-export type { RegisteredView, View, ViewAction, ViewContext, ViewEvent, ViewKind, MenuEntry, ViewRegistrySnapshot, ViewRenderResult, VirtualDomViewInstance, } from './parts/View/View.ts';
+export type { RegisteredView, View, ViewAction, ViewCommand, ViewContext, ViewEvent, ViewKind, MenuEntry, ViewRegistrySnapshot, ViewRenderResult, VirtualDomViewInstance, } from './parts/View/View.ts';
 export { handleExtensionManagementMessagePort } from './parts/HandleExtensionManagementMessagePort/HandleExtensionManagementMessagePort.ts';
 export type { Command } from './parts/Command/Command.ts';
 export type { CommandCallback } from './parts/CommandCallback/CommandCallback.ts';

package/dist/index.js

@@ -8,7 +8,7 @@ export { executeDiagnosticProvider, getDiagnosticProviderRegistrySnapshot, regis
 export { executeFormattingProvider, getFormattingProviderRegistrySnapshot, registerFormattingProvider, resetFormattingProviderRegistry, } from "./parts/Formatting/Formatting.js";
 export { exists, mkdir, readDirWithFileTypes, readFile, remove, writeFile } from "./parts/FileSystem/FileSystem.js";
 export { executeHoverProvider, getHoverProviderRegistrySnapshot, registerHoverProvider, resetHoverProviderRegistry } from "./parts/Hover/Hover.js";
-export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, registerSourceControlProvider, resetSourceControlProviderRegistry, } from "./parts/SourceControl/SourceControl.js";
+export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetBadgeCount, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, registerSourceControlProvider, resetSourceControlProviderRegistry, } from "./parts/SourceControl/SourceControl.js";
 export { createViewInstance, dispatchViewEvent, disposeViewInstance, executeViewProvider, getViewRegistrySnapshot, renderViewInstance, registerView, resetViewRegistry, saveViewInstanceState, } from "./parts/ViewRegistry/ViewRegistry.js";
 export { createOutputChannel, getOutputChannelRegistrySnapshot, resetOutputChannelRegistry } from "./parts/OutputChannel/OutputChannel.js";
 export { getStatusBarItemProviderRegistrySnapshot, registerStatusBarItemProvider, resetStatusBarItemProviderRegistry, } from "./parts/StatusBar/StatusBar.js";

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

@@ -13,6 +13,7 @@ export declare const commandMap: {
     'ExtensionApi.executeSourceControlAdd': (id: string, path: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlDiscard': (id: string, path: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlGenerateCommitMessage': (id: string) => Promise<unknown>;
+    'ExtensionApi.executeSourceControlGetBadgeCount': (id: string) => Promise<number>;
     'ExtensionApi.executeSourceControlGetChangedFiles': (id: string) => Promise<readonly unknown[]>;
     'ExtensionApi.executeSourceControlGetFeatures': (id: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlGetFileBefore': (id: string, uri: string) => Promise<unknown>;

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

@@ -12,6 +12,7 @@ export declare const commandMap: {
     'ExtensionApi.executeSourceControlAdd': (id: string, path: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlDiscard': (id: string, path: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlGenerateCommitMessage': (id: string) => Promise<unknown>;
+    'ExtensionApi.executeSourceControlGetBadgeCount': (id: string) => Promise<number>;
     'ExtensionApi.executeSourceControlGetChangedFiles': (id: string) => Promise<readonly unknown[]>;
     'ExtensionApi.executeSourceControlGetFeatures': (id: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlGetFileBefore': (id: string, uri: string) => Promise<unknown>;

package/dist/parts/ExtensionApiCommandMap/ExtensionApiCommandMap.js

@@ -5,7 +5,7 @@ import { executeFormattingProvider, getFormattingProviderRegistrySnapshot } from
 import { getStatusBarItems } from "../GetStatusBarItems/GetStatusBarItems.js";
 import { executeHoverProvider, getHoverProviderRegistrySnapshot } from "../Hover/Hover.js";
 import { getOutputChannelRegistrySnapshot } from "../OutputChannel/OutputChannel.js";
-import { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, getSourceControlProviderRegistrySnapshot, } from "../SourceControl/SourceControl.js";
+import { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetBadgeCount, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, getSourceControlProviderRegistrySnapshot, } from "../SourceControl/SourceControl.js";
 import { createViewInstance, dispatchViewEvent, disposeViewInstance, executeViewProvider, getViewActions, getViewMenuEntries, getViewRegistrySnapshot, renderViewInstance, saveViewInstanceState, } from "../ViewRegistry/ViewRegistry.js";
 export const commandMap = {
     'ExtensionApi.createViewInstance': createViewInstance,
@@ -21,6 +21,7 @@ export const commandMap = {
     'ExtensionApi.executeSourceControlAdd': executeSourceControlAdd,
     'ExtensionApi.executeSourceControlDiscard': executeSourceControlDiscard,
     'ExtensionApi.executeSourceControlGenerateCommitMessage': executeSourceControlGenerateCommitMessage,
+    'ExtensionApi.executeSourceControlGetBadgeCount': executeSourceControlGetBadgeCount,
     'ExtensionApi.executeSourceControlGetChangedFiles': executeSourceControlGetChangedFiles,
     'ExtensionApi.executeSourceControlGetFeatures': executeSourceControlGetFeatures,
     'ExtensionApi.executeSourceControlGetFileBefore': executeSourceControlGetFileBefore,

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

@@ -14,6 +14,7 @@ export declare const commandMap: {
     'ExtensionApi.executeSourceControlAdd': (id: string, path: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlDiscard': (id: string, path: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlGenerateCommitMessage': (id: string) => Promise<unknown>;
+    'ExtensionApi.executeSourceControlGetBadgeCount': (id: string) => Promise<number>;
     'ExtensionApi.executeSourceControlGetChangedFiles': (id: string) => Promise<readonly unknown[]>;
     'ExtensionApi.executeSourceControlGetFeatures': (id: string) => Promise<unknown>;
     'ExtensionApi.executeSourceControlGetFileBefore': (id: string, uri: string) => Promise<unknown>;

package/dist/parts/RegisteredSourceControlProvider/RegisteredSourceControlProvider.d.ts

@@ -3,6 +3,7 @@ export interface RegisteredSourceControlProvider {
     readonly add?: (path: string) => unknown | Promise<unknown>;
     readonly discard?: (path: string) => unknown | Promise<unknown>;
     readonly generateCommitMessage?: () => unknown | Promise<unknown>;
+    readonly getBadgeCount?: () => number | Promise<number>;
     readonly getChangedFiles: () => readonly unknown[] | Promise<readonly unknown[]>;
     readonly getFeatures?: () => unknown | Promise<unknown>;
     readonly getFileBefore?: (uri: string) => unknown | Promise<unknown>;

package/dist/parts/SourceControl/SourceControl.d.ts

@@ -1,4 +1,4 @@
-export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, getSourceControlProviderRegistrySnapshot, registerSourceControlProvider, resetSourceControlProviderRegistry, } from '../SourceControlProviderRegistry/SourceControlProviderRegistry.ts';
+export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetBadgeCount, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, getSourceControlProviderRegistrySnapshot, registerSourceControlProvider, resetSourceControlProviderRegistry, } from '../SourceControlProviderRegistry/SourceControlProviderRegistry.ts';
 export type { RegisteredSourceControlProvider } from '../RegisteredSourceControlProvider/RegisteredSourceControlProvider.ts';
 export type { SourceControlProvider } from '../SourceControlProvider/SourceControlProvider.ts';
 export type { SourceControlProviderRegistrySnapshot } from '../SourceControlProviderRegistrySnapshot/SourceControlProviderRegistrySnapshot.ts';

package/dist/parts/SourceControl/SourceControl.js

@@ -1 +1 @@
-export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, getSourceControlProviderRegistrySnapshot, registerSourceControlProvider, resetSourceControlProviderRegistry, } from "../SourceControlProviderRegistry/SourceControlProviderRegistry.js";
+export { executeSourceControlAcceptInput, executeSourceControlAdd, executeSourceControlDiscard, executeSourceControlGenerateCommitMessage, executeSourceControlGetBadgeCount, executeSourceControlGetChangedFiles, executeSourceControlGetFeatures, executeSourceControlGetFileBefore, executeSourceControlGetFileDecorations, executeSourceControlGetGroups, executeSourceControlIsActive, getSourceControlProviderRegistrySnapshot, registerSourceControlProvider, resetSourceControlProviderRegistry, } from "../SourceControlProviderRegistry/SourceControlProviderRegistry.js";

package/dist/parts/SourceControlProvider/SourceControlProvider.d.ts

@@ -3,6 +3,7 @@ export interface SourceControlProvider {
     readonly add?: (path: string) => unknown | Promise<unknown>;
     readonly discard?: (path: string) => unknown | Promise<unknown>;
     readonly generateCommitMessage?: () => unknown | Promise<unknown>;
+    readonly getBadgeCount?: () => number | Promise<number>;
     readonly getChangedFiles: () => readonly unknown[] | Promise<readonly unknown[]>;
     readonly getFeatures?: () => unknown | Promise<unknown>;
     readonly getFileBefore?: (uri: string) => unknown | Promise<unknown>;

package/dist/parts/SourceControlProviderRegistry/SourceControlProviderRegistry.d.ts

@@ -7,6 +7,7 @@ export declare const executeSourceControlAdd: (id: string, path: string) => Prom
 export declare const executeSourceControlDiscard: (id: string, path: string) => Promise<unknown>;
 export declare const executeSourceControlGenerateCommitMessage: (id: string) => Promise<unknown>;
 export declare const executeSourceControlGetChangedFiles: (id: string) => Promise<readonly unknown[]>;
+export declare const executeSourceControlGetBadgeCount: (id: string) => Promise<number>;
 export declare const executeSourceControlGetFeatures: (id: string) => Promise<unknown>;
 export declare const executeSourceControlGetFileBefore: (id: string, uri: string) => Promise<unknown>;
 export declare const executeSourceControlGetFileDecorations: (id: string, uris: readonly string[]) => Promise<unknown>;

package/dist/parts/SourceControlProviderRegistry/SourceControlProviderRegistry.js

@@ -5,6 +5,7 @@ const optionalMethods = [
     'add',
     'discard',
     'generateCommitMessage',
+    'getBadgeCount',
     'getFeatures',
     'getFileBefore',
     'getFileDecorations',
@@ -59,6 +60,9 @@ const mapSourceControlProvider = (provider) => {
     if (provider.generateCommitMessage) {
         registeredProvider.generateCommitMessage = () => provider.generateCommitMessage();
     }
+    if (provider.getBadgeCount) {
+        registeredProvider.getBadgeCount = () => provider.getBadgeCount();
+    }
     if (provider.getFeatures) {
         registeredProvider.getFeatures = () => provider.getFeatures();
     }
@@ -100,6 +104,14 @@ export const executeSourceControlGenerateCommitMessage = async (id) => {
 export const executeSourceControlGetChangedFiles = async (id) => {
     return getProvider(id).getChangedFiles();
 };
+export const executeSourceControlGetBadgeCount = async (id) => {
+    const provider = getProvider(id);
+    if (provider.getBadgeCount) {
+        return provider.getBadgeCount();
+    }
+    const files = await provider.getChangedFiles();
+    return files.length;
+};
 export const executeSourceControlGetFeatures = async (id) => {
     return getProvider(id).getFeatures?.() ?? {};
 };

package/dist/parts/View/View.d.ts

@@ -44,8 +44,10 @@ export interface VirtualDomViewInstance {
     readonly renderFocus?: (oldContext: Readonly<Record<string, boolean>>, newContext: Readonly<Record<string, boolean>>) => string | Promise<string>;
     readonly saveState?: () => unknown;
 }
-export interface View {
-    readonly create: (context?: ViewContext) => unknown;
+export type ViewCommand<State = VirtualDomViewInstance, Args extends readonly any[] = readonly any[]> = (state: State, ...args: Args) => State | Promise<State>;
+export interface View<State = unknown> {
+    readonly commands?: Readonly<Record<string, ViewCommand<State>>>;
+    readonly create: (context?: ViewContext) => State | Promise<State>;
     readonly displayName?: string;
     readonly eventListeners?: readonly DomEventListener[];
     readonly icon?: string;

package/dist/parts/ViewRegistry/ViewRegistry.d.ts

@@ -1,6 +1,6 @@
 import type { Disposable } from '../Disposable/Disposable.ts';
 import type { MenuEntry, View, ViewAction, ViewContext, ViewEvent, ViewRegistrySnapshot, ViewRenderResult } from '../View/View.ts';
-export declare const registerView: (view: View) => Disposable;
+export declare const registerView: <State>(view: View<State>) => Disposable;
 export declare const executeViewProvider: (id: string) => unknown;
 export declare const createViewInstance: (viewId: string, uid: number, context?: ViewContext) => Promise<ViewRenderResult>;
 export declare const dispatchViewEvent: (uid: number, event: ViewEvent) => Promise<ViewRenderResult>;

package/dist/parts/ViewRegistry/ViewRegistry.js

@@ -1,11 +1,14 @@
 import { ExtensionManagementWorker } from '@lvce-editor/rpc-registry';
 import { diffTree } from '@lvce-editor/virtual-dom-worker';
+import { registerCommand } from "../CommandRegistry/CommandRegistry.js";
 import { ExtensionApiError } from "../ExtensionApiError/ExtensionApiError.js";
 const views = Object.create(null);
 const instances = Object.create(null);
+const instanceUidsByView = Object.create(null);
 const renderedDoms = Object.create(null);
 const contexts = Object.create(null);
 const contextViewIds = Object.create(null);
+const viewCommandDisposables = Object.create(null);
 const assertBoolean = (value, message) => {
     if (value !== undefined && typeof value !== 'boolean') {
         throw new ExtensionApiError(message);
@@ -48,6 +51,23 @@ const assertEventListeners = (view) => {
         assertEventListener(view.id, listener, index);
     }
 };
+const assertCommands = (view) => {
+    if (view.commands === undefined) {
+        return;
+    }
+    if (view.kind !== 'virtualDom') {
+        throw new ExtensionApiError(`view ${view.id} commands require virtualDom kind`);
+    }
+    if (!view.commands || typeof view.commands !== 'object' || Array.isArray(view.commands)) {
+        throw new ExtensionApiError(`view ${view.id} commands must be an object`);
+    }
+    for (const [id, command] of Object.entries(view.commands)) {
+        assertString(id, `view ${view.id} command is missing id`);
+        if (typeof command !== 'function') {
+            throw new ExtensionApiError(`view ${view.id} command ${id} must be a function`);
+        }
+    }
+};
 const assertView = (view) => {
     if (!view) {
         throw new ExtensionApiError('view is not defined');
@@ -61,6 +81,7 @@ const assertView = (view) => {
     if (view.id in views) {
         throw new ExtensionApiError(`view ${view.id} is already registered`);
     }
+    assertCommands(view);
     assertEventListeners(view);
 };
 const toRegisteredView = (view) => {
@@ -81,12 +102,61 @@ const toRegisteredView = (view) => {
     }
     return registeredView;
 };
+const getActiveViewInstance = (viewId) => {
+    const instanceUids = instanceUidsByView[viewId];
+    if (!instanceUids) {
+        return undefined;
+    }
+    const uid = [...instanceUids].at(-1);
+    if (uid === undefined) {
+        return undefined;
+    }
+    return [uid, instances[uid]];
+};
+const executeViewCommand = async (view, commandId, args) => {
+    const activeInstance = getActiveViewInstance(view.id);
+    if (!activeInstance) {
+        return;
+    }
+    const [uid, instance] = activeInstance;
+    const command = view.commands[commandId];
+    const newInstance = await command(instance, ...args);
+    assertVirtualDomViewInstance(view.id, newInstance);
+    instances[uid] = newInstance;
+    await ExtensionManagementWorker.invoke('Extensions.requestViewRerender', uid);
+};
+const registerViewCommands = (view) => {
+    const disposables = [];
+    try {
+        for (const id of Object.keys(view.commands || {})) {
+            disposables.push(registerCommand({
+                execute(...args) {
+                    return executeViewCommand(view, id, args);
+                },
+                id,
+            }));
+        }
+    }
+    catch (error) {
+        for (const disposable of disposables) {
+            disposable.dispose();
+        }
+        throw error;
+    }
+    return disposables;
+};
 export const registerView = (view) => {
     assertView(view);
+    const commandDisposables = registerViewCommands(view);
     views[view.id] = view;
+    viewCommandDisposables[view.id] = commandDisposables;
     return {
         dispose() {
+            for (const disposable of commandDisposables) {
+                disposable.dispose();
+            }
             delete views[view.id];
+            delete viewCommandDisposables[view.id];
         },
     };
 };
@@ -284,6 +354,9 @@ export const createViewInstance = async (viewId, uid, context) => {
     });
     assertVirtualDomViewInstance(viewId, instance);
     instances[uid] = instance;
+    const instanceUids = instanceUidsByView[viewId] || new Set();
+    instanceUids.add(uid);
+    instanceUidsByView[viewId] = instanceUids;
     contextViewIds[uid] = viewId;
     const dom = await renderDom(instance);
     renderedDoms[uid] = dom;
@@ -296,6 +369,9 @@ export const createViewInstance = async (viewId, uid, context) => {
 };
 export const dispatchViewEvent = async (uid, event) => {
     const instance = getVirtualDomInstance(uid);
+    const instanceUids = instanceUidsByView[contextViewIds[uid]];
+    instanceUids.delete(uid);
+    instanceUids.add(uid);
     if (typeof instance.handleEvent === 'function') {
         await instance.handleEvent(event);
     }
@@ -315,6 +391,12 @@ export const disposeViewInstance = async (uid) => {
         await instance.dispose();
     }
     await maybeClearContext(uid, contextViewIds[uid]);
+    const viewId = contextViewIds[uid];
+    const instanceUids = instanceUidsByView[viewId];
+    instanceUids?.delete(uid);
+    if (instanceUids?.size === 0) {
+        delete instanceUidsByView[viewId];
+    }
     delete instances[uid];
     delete renderedDoms[uid];
     delete contextViewIds[uid];
@@ -348,7 +430,11 @@ export const getViewRegistrySnapshot = () => {
 };
 export const resetViewRegistry = () => {
     for (const id of Object.keys(views)) {
+        for (const disposable of viewCommandDisposables[id] || []) {
+            disposable.dispose();
+        }
         delete views[id];
+        delete viewCommandDisposables[id];
     }
     for (const uid of Object.keys(instances)) {
         delete instances[Number(uid)];
@@ -362,4 +448,7 @@ export const resetViewRegistry = () => {
     for (const uid of Object.keys(contextViewIds)) {
         delete contextViewIds[Number(uid)];
     }
+    for (const viewId of Object.keys(instanceUidsByView)) {
+        delete instanceUidsByView[viewId];
+    }
 };

package/package.json

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