@lvce-editor/api 8.55.0 → 8.57.0

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

@@ -37,6 +37,7 @@ export declare const commandMap: {
     'ExtensionApi.getSourceControlProviderRegistrySnapshot': () => import("../SourceControlProviderRegistrySnapshot/SourceControlProviderRegistrySnapshot.ts").SourceControlProviderRegistrySnapshot;
     'ExtensionApi.getStatusBarItems': () => readonly import("../StatusBarItem/StatusBarItem.ts").StatusBarItem[];
     'ExtensionApi.getViewActions': (uid: number) => Promise<readonly import("../View/View.ts").ViewAction[]>;
+    '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.renderViewInstance': (uid: number) => Promise<import("../View/View.ts").ViewRenderResult>;

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

@@ -36,6 +36,7 @@ export declare const commandMap: {
     'ExtensionApi.getSourceControlProviderRegistrySnapshot': () => import("../SourceControlProviderRegistrySnapshot/SourceControlProviderRegistrySnapshot.ts").SourceControlProviderRegistrySnapshot;
     'ExtensionApi.getStatusBarItems': () => readonly import("../StatusBarItem/StatusBarItem.ts").StatusBarItem[];
     'ExtensionApi.getViewActions': (uid: number) => Promise<readonly import("../View/View.ts").ViewAction[]>;
+    '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.renderViewInstance': (uid: number) => Promise<import("../View/View.ts").ViewRenderResult>;

package/dist/parts/ExtensionApiCommandMap/ExtensionApiCommandMap.js

@@ -8,7 +8,7 @@ import { executeLanguageProvider, executeOrganizeImportsProvider } from "../Lang
 import { getLanguageServerRegistrySnapshot } from "../LanguageServer/LanguageServer.js";
 import { getOutputChannelRegistrySnapshot } from "../OutputChannel/OutputChannel.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";
+import { createViewInstance, dispatchViewEvent, disposeViewInstance, executeViewProvider, getViewActions, getViewActionsDom, getViewMenuEntries, getViewRegistrySnapshot, renderViewInstance, saveViewInstanceState, } from "../ViewRegistry/ViewRegistry.js";
 export const commandMap = {
     'ExtensionApi.createViewInstance': createViewInstance,
     'ExtensionApi.dispatchViewEvent': dispatchViewEvent,
@@ -43,6 +43,7 @@ export const commandMap = {
     'ExtensionApi.getSourceControlProviderRegistrySnapshot': getSourceControlProviderRegistrySnapshot,
     'ExtensionApi.getStatusBarItems': getStatusBarItems,
     'ExtensionApi.getViewActions': getViewActions,
+    'ExtensionApi.getViewActionsDom': getViewActionsDom,
     'ExtensionApi.getViewMenuEntries': getViewMenuEntries,
     'ExtensionApi.getViewRegistrySnapshot': getViewRegistrySnapshot,
     'ExtensionApi.renderViewInstance': renderViewInstance,

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

@@ -38,6 +38,7 @@ export declare const commandMap: {
     'ExtensionApi.getSourceControlProviderRegistrySnapshot': () => import("../SourceControlProviderRegistrySnapshot/SourceControlProviderRegistrySnapshot.ts").SourceControlProviderRegistrySnapshot;
     'ExtensionApi.getStatusBarItems': () => readonly import("../StatusBarItem/StatusBarItem.ts").StatusBarItem[];
     'ExtensionApi.getViewActions': (uid: number) => Promise<readonly import("../View/View.ts").ViewAction[]>;
+    '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.renderViewInstance': (uid: number) => Promise<import("../View/View.ts").ViewRenderResult>;

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

@@ -8,6 +8,8 @@ export interface ViewContext {
     readonly viewId: string;
 }
 export interface ViewEvent {
+    readonly args?: readonly unknown[];
+    readonly handler?: string;
     readonly name?: string;
     readonly type: string;
     readonly value?: unknown;
@@ -49,6 +51,7 @@ export interface VirtualDomViewInstance {
     readonly handleEvent?: (event: ViewEvent) => unknown;
     readonly render: () => readonly VirtualDomNode[] | Promise<readonly VirtualDomNode[]>;
     readonly renderActions?: () => readonly ViewAction[] | Promise<readonly ViewAction[]>;
+    readonly renderActionsDom?: () => readonly VirtualDomNode[];
     readonly renderFocus?: (oldContext: Readonly<Record<string, boolean>>, newContext: Readonly<Record<string, boolean>>) => string | Promise<string>;
     readonly renderScrollPosition?: () => readonly [] | ViewScrollPosition | Promise<readonly [] | ViewScrollPosition>;
     readonly renderSelections?: () => readonly ViewSelection[] | Promise<readonly ViewSelection[]>;

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

@@ -1,3 +1,4 @@
+import { type VirtualDomNode } from '@lvce-editor/virtual-dom-worker';
 import type { Disposable } from '../Disposable/Disposable.ts';
 import type { MenuEntry, View, ViewAction, ViewContext, ViewEvent, ViewRegistrySnapshot, ViewRenderResult } from '../View/View.ts';
 export declare const registerView: <State>(view: View<State>) => Disposable;
@@ -9,5 +10,6 @@ export declare const disposeViewInstance: (uid: number) => Promise<void>;
 export declare const saveViewInstanceState: (uid: number) => Promise<unknown>;
 export declare const getViewMenuEntries: (uid: number, menuId: string) => Promise<readonly MenuEntry[]>;
 export declare const getViewActions: (uid: number) => Promise<readonly ViewAction[]>;
+export declare const getViewActionsDom: (uid: number) => readonly VirtualDomNode[] | undefined;
 export declare const getViewRegistrySnapshot: () => ViewRegistrySnapshot;
 export declare const resetViewRegistry: () => void;

package/dist/parts/ViewRegistry/ViewRegistry.js

@@ -470,7 +470,14 @@ export const dispatchViewEvent = async (uid, event) => {
     const instanceUids = instanceUidsByView[contextViewIds[uid]];
     instanceUids.delete(uid);
     instanceUids.add(uid);
-    if (typeof instance.handleEvent === 'function') {
+    if (event.handler) {
+        const handler = instance[event.handler];
+        if (typeof handler !== 'function') {
+            throw new TypeError(`view event handler ${event.handler} is not a function`);
+        }
+        await Reflect.apply(handler, instance, event.args || []);
+    }
+    else if (typeof instance.handleEvent === 'function') {
         await instance.handleEvent(event);
     }
     const result = await renderPatches(uid, instance);
@@ -521,6 +528,17 @@ export const getViewActions = async (uid) => {
     }
     return normalizeViewActions(await instance.renderActions());
 };
+export const getViewActionsDom = (uid) => {
+    const instance = getVirtualDomInstance(uid);
+    if (typeof instance.renderActionsDom !== 'function') {
+        return undefined;
+    }
+    const dom = instance.renderActionsDom();
+    if (!Array.isArray(dom)) {
+        throw new TypeError('view renderActionsDom result must be an array');
+    }
+    return dom;
+};
 export const getViewRegistrySnapshot = () => {
     return {
         views: Object.values(views).map(toRegisteredView),

package/package.json

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