@lvce-editor/api 8.41.0 → 8.42.0

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

@@ -42,6 +42,7 @@ export interface VirtualDomViewInstance {
     readonly render: () => readonly VirtualDomNode[] | Promise<readonly VirtualDomNode[]>;
     readonly renderActions?: () => readonly ViewAction[] | Promise<readonly ViewAction[]>;
     readonly renderFocus?: (oldContext: Readonly<Record<string, boolean>>, newContext: Readonly<Record<string, boolean>>) => string | Promise<string>;
+    readonly renderTitle?: () => string | Promise<string>;
     readonly saveState?: () => unknown;
 }
 export type ViewCommand<State = VirtualDomViewInstance, Args extends readonly any[] = readonly any[]> = (state: State, ...args: Args) => State | Promise<State>;
@@ -71,11 +72,13 @@ export interface ViewRegistrySnapshot {
 export interface ViewRenderResultDom {
     readonly dom: readonly VirtualDomNode[];
     readonly focusSelector?: string;
+    readonly title?: string;
     readonly type: 'setDom';
 }
 export interface ViewRenderResultPatches {
     readonly focusSelector?: string;
     readonly patches: readonly unknown[];
+    readonly title?: string;
     readonly type: 'setPatches';
 }
 export type ViewRenderResult = ViewRenderResultDom | ViewRenderResultPatches;

package/dist/parts/ViewRegistry/ViewRegistry.js

@@ -323,6 +323,23 @@ const withFocusSelector = async (result, instance, contextChange) => {
         focusSelector,
     };
 };
+const withTitle = async (result, instance) => {
+    if (typeof instance.renderTitle !== 'function') {
+        return result;
+    }
+    const title = await instance.renderTitle();
+    if (typeof title !== 'string') {
+        throw new ExtensionApiError('view renderTitle result must be a string');
+    }
+    return {
+        ...result,
+        title,
+    };
+};
+const withRenderMetadata = async (result, instance, contextChange) => {
+    const resultWithFocus = await withFocusSelector(result, instance, contextChange);
+    return withTitle(resultWithFocus, instance);
+};
 const maybeClearContext = async (uid, viewId) => {
     if (!contexts[uid]) {
         return;
@@ -365,7 +382,7 @@ export const createViewInstance = async (viewId, uid, context) => {
         type: 'setDom',
     };
     const contextChange = await maybeNotifyContextChanged(uid, viewId, instance);
-    return withFocusSelector(result, instance, contextChange);
+    return withRenderMetadata(result, instance, contextChange);
 };
 export const dispatchViewEvent = async (uid, event) => {
     const instance = getVirtualDomInstance(uid);
@@ -377,13 +394,13 @@ export const dispatchViewEvent = async (uid, event) => {
     }
     const result = await renderPatches(uid, instance);
     const contextChange = await maybeNotifyContextChanged(uid, contextViewIds[uid], instance);
-    return withFocusSelector(result, instance, contextChange);
+    return withRenderMetadata(result, instance, contextChange);
 };
 export const renderViewInstance = async (uid) => {
     const instance = getVirtualDomInstance(uid);
     const result = await renderPatches(uid, instance);
     const contextChange = await maybeNotifyContextChanged(uid, contextViewIds[uid], instance);
-    return withFocusSelector(result, instance, contextChange);
+    return withRenderMetadata(result, instance, contextChange);
 };
 export const disposeViewInstance = async (uid) => {
     const instance = instances[uid];

package/package.json

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