@lvce-editor/api 8.54.0 → 8.56.0

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;
@@ -44,6 +46,7 @@ export interface DomEventListener {
 export interface VirtualDomViewInstance {
     readonly dispose?: () => unknown;
     readonly getContext?: () => Readonly<Record<string, boolean>>;
+    readonly getCss?: () => string | Promise<string>;
     readonly getMenuEntries?: (menuId: string) => readonly MenuEntry[] | Promise<readonly MenuEntry[]>;
     readonly handleEvent?: (event: ViewEvent) => unknown;
     readonly render: () => readonly VirtualDomNode[] | Promise<readonly VirtualDomNode[]>;
@@ -79,6 +82,7 @@ export interface ViewRegistrySnapshot {
     readonly views: readonly RegisteredView[];
 }
 export interface ViewRenderResultDom {
+    readonly css?: string;
     readonly dom: readonly VirtualDomNode[];
     readonly focusSelector?: string;
     readonly scrollPosition?: ViewScrollPosition;
@@ -87,6 +91,7 @@ export interface ViewRenderResultDom {
     readonly type: 'setDom';
 }
 export interface ViewRenderResultPatches {
+    readonly css?: string;
     readonly focusSelector?: string;
     readonly patches: readonly unknown[];
     readonly scrollPosition?: ViewScrollPosition;

package/dist/parts/ViewRegistry/ViewRegistry.js

@@ -362,6 +362,19 @@ const withFocusSelector = async (result, instance, contextChange) => {
         focusSelector,
     };
 };
+const withCss = async (result, instance) => {
+    if (typeof instance.getCss !== 'function') {
+        return result;
+    }
+    const css = await instance.getCss();
+    if (typeof css !== 'string') {
+        throw new ExtensionApiError('view getCss result must be a string');
+    }
+    return {
+        ...result,
+        css,
+    };
+};
 const withTitle = async (result, instance) => {
     if (typeof instance.renderTitle !== 'function') {
         return result;
@@ -402,7 +415,8 @@ const withScrollPosition = async (result, instance) => {
     };
 };
 const withRenderMetadata = async (result, instance, contextChange) => {
-    const resultWithFocus = await withFocusSelector(result, instance, contextChange);
+    const resultWithCss = await withCss(result, instance);
+    const resultWithFocus = await withFocusSelector(resultWithCss, instance, contextChange);
     const resultWithSelections = await withSelections(resultWithFocus, instance);
     const resultWithScrollPosition = await withScrollPosition(resultWithSelections, instance);
     return withTitle(resultWithScrollPosition, instance);
@@ -456,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);

package/package.json

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