@lvce-editor/api 9.29.1 → 9.30.0

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

@@ -73,9 +73,11 @@ interface ViewBase<State> {
     readonly preferredLocation?: ViewPreferredLocation;
     readonly title?: string;
 }
-export interface InstanceView<State = unknown> extends ViewBase<State> {
+export interface InstanceView<State = unknown, ComponentState = unknown> extends ViewBase<State> {
     readonly create: (context?: ViewContext) => State | Promise<State>;
     readonly createInitialState?: never;
+    readonly getComponentState?: (instance: State) => ComponentState | Promise<ComponentState>;
+    readonly setComponentState?: (instance: State, state: ComponentState) => void | Promise<void>;
 }
 export interface StatefulView<State = unknown> extends ViewBase<State> {
     readonly create?: never;
@@ -95,7 +97,7 @@ export interface StatefulView<State = unknown> extends ViewBase<State> {
     readonly renderTitle?: (state: State) => string | Promise<string>;
     readonly saveState?: (state: State) => unknown;
 }
-export type View<State = unknown> = InstanceView<State> | StatefulView<State>;
+export type View<State = unknown, ComponentState = unknown> = InstanceView<State, ComponentState> | StatefulView<State>;
 export interface RegisteredView {
     readonly displayName?: string;
     readonly eventListeners?: readonly DomEventListener[];

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

@@ -1,7 +1,7 @@
 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;
+export declare const registerView: <State, ComponentState = unknown>(view: View<State, ComponentState>) => 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

@@ -91,6 +91,11 @@ const assertView = (view) => {
     if (typeof candidate.createInitialState === 'function' && typeof candidate.render !== 'function') {
         throw new ExtensionApiError(`view ${view.id} is missing render function`);
     }
+    if (!isStatefulView(view) &&
+        (view.getComponentState !== undefined || view.setComponentState !== undefined) &&
+        (typeof view.getComponentState !== 'function' || typeof view.setComponentState !== 'function')) {
+        throw new ExtensionApiError(`view ${view.id} component state requires getComponentState and setComponentState`);
+    }
     if (view.id in views) {
         throw new ExtensionApiError(`view ${view.id} is already registered`);
     }
@@ -109,7 +114,7 @@ const toRegisteredView = (view) => {
         id: view.id,
         name: view.name,
         preferredLocation: view.preferredLocation || 'sideBar',
-        ...(isStatefulView(view) && { stateful: true }),
+        ...((isStatefulView(view) || typeof view.getComponentState === 'function') && { stateful: true }),
         title: displayName,
     };
     if (view.kind) {
@@ -625,13 +630,29 @@ export const saveViewInstanceState = async (uid) => {
     return instance.saveState();
 };
 export const getViewInstanceState = (uid) => {
-    getVirtualDomInstance(uid);
+    const instance = getVirtualDomInstance(uid);
+    const view = views[contextViewIds[uid]];
+    if (!isStatefulView(view) && view.getComponentState) {
+        return view.getComponentState(instance);
+    }
     return ViewletStates.get(uid);
 };
 export const setViewInstanceState = async (uid, newState) => {
-    getVirtualDomInstance(uid);
+    const instance = getVirtualDomInstance(uid);
     const viewId = contextViewIds[uid];
+    const view = views[viewId];
     assertViewState(viewId, newState);
+    if (!isStatefulView(view) && view.getComponentState && view.setComponentState) {
+        const oldState = structuredClone(await view.getComponentState(instance));
+        try {
+            await view.setComponentState(instance, newState);
+            return await renderViewInstance(uid);
+        }
+        catch (error) {
+            await view.setComponentState(instance, oldState);
+            throw error;
+        }
+    }
     const oldState = ViewletStates.get(uid);
     ViewletStates.replace(uid, newState);
     try {

package/package.json

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