@oinone/kunlun-vue-widget 6.3.8 → 6.4.0

package/dist/types/src/state/typing.d.ts

@@ -0,0 +1,105 @@
+import { ViewType } from '@oinone/kunlun-meta';
+import { ButtonBizStyle, ButtonType } from '@oinone/kunlun-vue-ui-common';
+declare type StateEntity = {
+    readonly handle: string;
+    [key: string]: any;
+};
+export interface RenderPosition {
+    handle: string;
+    slotName?: string;
+    rowIndex?: number;
+}
+export interface OioViewState extends StateEntity {
+    /**
+     * Vue生命周期时可能有值，用于获取渲染参数处理属性多态的问题
+     */
+    __position: RenderPosition[];
+    fullscreen: boolean;
+    viewType?: ViewType;
+    popupScene?: string;
+    createActionBarState(options: {
+        handle: string;
+    } & Partial<Omit<OioActionBarState, 'handle'>>): OioActionBarState;
+    /**
+     * 此获取方法仅能用在Vue生命周期，否则无法准确获取真实的ActionBar状态变量
+     */
+    getActionBarState(rowIndex?: number): OioActionBarState | undefined;
+    pushField(handle: string, rowIndex?: number): void;
+    popField(handle: string, rowIndex?: number): void;
+    pushAction(handle: string, rowIndex?: number): void;
+    popAction(handle: string, rowIndex?: number): void;
+}
+export interface OioActionBarState extends StateEntity {
+    inline?: boolean;
+    actions: string[];
+    visibleActions: string[];
+    bizStyle?: string;
+    getActionBarBizStyle?(actionHandle: string): {
+        type: ButtonType;
+        bizStyle: ButtonBizStyle;
+    } | undefined;
+}
+export interface OioTableViewState extends OioViewState {
+    searchView?: string;
+    actionBar?: OioActionBarState;
+    actionBars?: Record<string, OioActionBarState>;
+    inlineActionBars?: OioActionBarState[];
+    table?: string;
+    fields?: string[];
+    fieldWidgets?: Record<string, string>;
+}
+export interface OioSearchViewState extends OioViewState {
+    search?: string;
+    fields?: string[];
+    fieldWidgets?: Record<string, string>;
+}
+export interface OioFormViewState extends OioViewState {
+    draftCode?: string;
+    actionBar?: OioActionBarState;
+    actionBars?: Record<string, OioActionBarState>;
+    form?: string;
+    fields?: string[];
+    fieldWidgets?: Record<string, string>;
+}
+export interface OioDetailViewState extends OioViewState {
+    actionBar?: OioActionBarState;
+    actionBars?: Record<string, OioActionBarState>;
+    detail?: string;
+    fields?: string[];
+    fieldWidgets?: Record<string, string>;
+}
+export interface OioCardState extends StateEntity {
+    titleProps?: Record<string, unknown>;
+    contentProps?: Record<string, unknown>;
+    fields?: string[];
+    fieldWidgets?: Record<string, string>;
+}
+export interface OioGalleryViewState extends OioViewState {
+    searchView?: string;
+    actionBar?: OioActionBarState;
+    inlineActionBars?: OioActionBarState[];
+    gallery?: string;
+    cards?: OioCardState[];
+}
+export interface OioTreeViewState extends OioViewState {
+    searchView?: string;
+    actionBar?: OioActionBarState;
+    tree?: string;
+    fields?: string[];
+    fieldWidgets?: Record<string, string>;
+}
+export declare type OioAnyViewState = OioTableViewState | OioSearchViewState | OioFormViewState | OioDetailViewState | OioGalleryViewState | OioTreeViewState;
+export declare type OioListViewState = OioTableViewState | OioGalleryViewState;
+export declare type OioObjectViewState = OioFormViewState | OioDetailViewState | OioSearchViewState;
+export declare function isTableViewState(state: OioAnyViewState): state is OioTableViewState;
+export declare function isSearchViewState(state: OioAnyViewState): state is OioSearchViewState;
+export declare function isFormViewState(state: OioAnyViewState): state is OioFormViewState;
+export declare function isDetailViewState(state: OioAnyViewState): state is OioDetailViewState;
+export declare function isGalleryViewState(state: OioAnyViewState): state is OioGalleryViewState;
+export declare function isTreeViewState(state: OioAnyViewState): state is OioTreeViewState;
+export declare function isListViewState(state: OioAnyViewState): state is OioListViewState;
+export declare function isObjectViewState(state: OioAnyViewState): state is OioObjectViewState;
+export declare function hasFieldsViewState(state: OioAnyViewState): state is OioTableViewState | OioFormViewState | OioDetailViewState;
+export declare function hasActionBarViewState(state: OioAnyViewState): state is OioTableViewState | OioFormViewState | OioDetailViewState | OioGalleryViewState | OioTreeViewState;
+export declare function hasRowActionBarViewState(state: OioAnyViewState): state is OioTableViewState | OioGalleryViewState;
+export {};

package/dist/types/src/state/use-state.d.ts

@@ -0,0 +1,16 @@
+import { OioGlobalState } from './global';
+import { OioAnyViewState } from './typing';
+export declare function useOioState(): {
+    globalState: OioGlobalState;
+    viewState: OioAnyViewState | undefined;
+    createViewState: (handle: string) => OioAnyViewState;
+    getViewState: (handle: string) => OioAnyViewState | undefined;
+    clearViewState: (handle: string) => OioAnyViewState | undefined;
+};
+export declare function useOioState(handle: string): {
+    globalState: OioGlobalState;
+    viewState: OioAnyViewState | undefined;
+    createViewState: () => OioAnyViewState;
+    getViewState: () => OioAnyViewState | undefined;
+    clearViewState: () => OioAnyViewState | undefined;
+};

package/dist/types/src/state/view.d.ts

@@ -0,0 +1,5 @@
+import { OioAnyViewState } from './typing';
+export declare function createViewState(handle: string): OioAnyViewState;
+export declare function getViewState(handle?: string): OioAnyViewState | undefined;
+export declare function setViewState(state: OioAnyViewState): void;
+export declare function clearViewState(handle?: string): OioAnyViewState | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oinone/kunlun-vue-widget",
-  "version": "6.3.8",
+  "version": "6.4.0",
   "main": "index.ts",
   "scripts": {
     "prebuild": "rimraf dist",
@@ -11,18 +11,18 @@
     "x-postpublish": "node ../../scripts/postpublish.js"
   },
   "dependencies": {
-    "@oinone/kunlun-config": "~6.3.0",
-    "@oinone/kunlun-vue-ui-common": "6.3.8"
+    "@oinone/kunlun-vue-ui-common": "6.4.0"
   },
   "devDependencies": {
-    "@oinone/kunlun-dsl": "~6.3.0",
-    "@oinone/kunlun-engine": "~6.3.0",
-    "@oinone/kunlun-event": "~6.3.0",
-    "@oinone/kunlun-meta": "~6.3.0",
-    "@oinone/kunlun-router": "~6.3.0",
-    "@oinone/kunlun-shared": "~6.3.0",
-    "@oinone/kunlun-spi": "~6.3.0",
-    "@oinone/kunlun-state": "~6.3.0",
+    "@oinone/kunlun-config": "~6.4.0",
+    "@oinone/kunlun-dsl": "~6.4.0",
+    "@oinone/kunlun-engine": "~6.4.0",
+    "@oinone/kunlun-event": "~6.4.0",
+    "@oinone/kunlun-meta": "~6.4.0",
+    "@oinone/kunlun-router": "~6.4.0",
+    "@oinone/kunlun-shared": "~6.4.0",
+    "@oinone/kunlun-spi": "~6.4.0",
+    "@oinone/kunlun-state": "~6.4.0",
     "@types/lodash": "4.14.182",
     "@types/lodash-es": "4.17.6",
     "lodash": "4.17.21",

package/src/basic/VueWidget.ts

@@ -1,6 +1,6 @@
 import { genStaticPath, translateValueByKey, WidgetConstructor, WidgetProps } from '@oinone/kunlun-engine';
-import { ReturnPromise, uniqueKeyGenerator } from '@oinone/kunlun-shared';
-import { ComponentPublicInstance, SetupContext } from '@vue/runtime-core';
+import { uniqueKeyGenerator } from '@oinone/kunlun-shared';
+import { ComponentPublicInstance } from '@vue/runtime-core';
 import {
   Component,
   ComponentOptions,

package/src/basic/Widget.ts

@@ -3,10 +3,17 @@ import { instantiate } from '@oinone/kunlun-shared';
 import { BehaviorSubject, Subject, Subscription } from '@oinone/kunlun-state';
 import { InnerWidgetType } from '../typing/typing';
 
+type WidgetTypeKey = keyof typeof InnerWidgetType;
+
+type AnySubject<T = unknown> = Subject<T> | BehaviorSubject<T>;
+
 interface NameContextMap<T> {
   paramName_NameMap: Map<string, Symbol>;
   subject: BehaviorSubject<T> | Subject<T>;
   value?: T;
+  option?: {
+    scope?: WidgetTypeKey;
+  };
 }
 
 interface BaseWidgetSubjection<T> {
@@ -46,6 +53,8 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
 
   private $$props?: string[];
 
+  private $$subNames?: string[];
+
   private static Attribute(params?: { displayName?: string; render?: boolean }) {
     return <T extends Widget, K>(target: T, nativeName: string, description?: TypedPropertyDescriptor<K>) => {
       const widgetType = target.constructor;
@@ -98,21 +107,35 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
     };
   }
 
-  private static Sub<T>(name: Symbol, SubjectType: { new (T): Subject<T> | BehaviorSubject<T> }, value?: T) {
+  private static Sub<T>(
+    name: Symbol,
+    SubjectType: { new (T): Subject<T> | BehaviorSubject<T> },
+    value?: T,
+    option?: { scope?: WidgetTypeKey }
+  ) {
     return <K extends Widget>(target: K, paramName: string) => {
       const nameContextMap = this.nameContextMap.get(name);
       if (!nameContextMap) {
         const subject = new SubjectType(value);
         const paramName_NameMap = new Map<string, Symbol>();
         paramName_NameMap.set(paramName, name);
+
         this.nameContextMap.set(name, {
           paramName_NameMap,
           subject,
-          value
+          value,
+          option
         } as NameContextMap<unknown>);
       } else if (nameContextMap && !nameContextMap.paramName_NameMap.get(paramName)) {
         nameContextMap.paramName_NameMap.set(paramName, name);
       }
+
+      const widgetType = target.constructor;
+      const $$subNames = widgetType.prototype.$$subNames || [];
+      if (!$$subNames.includes(paramName)) {
+        $$subNames.push(paramName);
+      }
+      target.$$subNames = $$subNames;
     };
   }
 
@@ -121,6 +144,7 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
    *
    * @param  {Symbol} name 唯一标示
    * @param  {unknown} value? 默认值
+   * @param {scope?: WidgetTypeKey} option? 作用域检查，如果设置了该值，那么发布的时候会携带发布者的widget实例，订阅的时候会检查发布者的widget实例是否和订阅者在同一个作用域下，如果是，那么才会触发订阅函数
    *
    * @example
    *
@@ -146,8 +170,8 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
    * }
    *
    */
-  protected static BehaviorSubContext(name: Symbol, value?: unknown) {
-    return Widget.Sub(name, BehaviorSubject, value);
+  protected static BehaviorSubContext(name: Symbol, value?: unknown, option?: { scope?: WidgetTypeKey }) {
+    return Widget.Sub(name, BehaviorSubject, value, option);
   }
 
   /**
@@ -155,9 +179,10 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
    *
    * @param  {Symbol} name 唯一标示
    * @param  {unknown} value? 默认值
+   * @param {scope?: WidgetTypeKey} option? 作用域检查，如果设置了该值，那么发布订阅只会在同一个作用域下的widget之间进行
    */
-  protected static SubContext(name: Symbol, value?: unknown) {
-    return Widget.Sub(name, Subject, value);
+  protected static SubContext(name: Symbol, value?: unknown, option?: { scope?: WidgetTypeKey }) {
+    return Widget.Sub(name, Subject, value, option);
   }
 
   /**
@@ -320,23 +345,6 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
     this.config = config;
     Widget.widgetMap.set(this.getHandle(), this);
 
-    Widget.nameContextMap.forEach((contextMap) => {
-      const { subject, paramName_NameMap } = contextMap;
-      const d: BaseWidgetSubjection<unknown> = {
-        subscribe: (func) => {
-          const subscription = subject.subscribe((data) => {
-            func(data);
-          });
-          this.subscriptionMap.set(Symbol('random'), subscription);
-          return subscription;
-        },
-        subject
-      };
-      paramName_NameMap.forEach((_name, paramName) => {
-        this[paramName] = d;
-      });
-    });
-
     if (this.$$innerWidgetType) {
       const parentWidget = this.getParentWidget();
       if (parentWidget && parentWidget.$$innerWidgetType) {
@@ -344,9 +352,104 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
       }
     }
 
+    this.startSubscription();
+
     return this;
   }
 
+  /**
+   * 启动订阅
+   */
+  private startSubscription() {
+    if (!this.$$subNames?.length) {
+      return;
+    }
+
+    for (const [, contextMap] of Widget.nameContextMap) {
+      for (const [paramName] of contextMap.paramName_NameMap) {
+        if (this.$$subNames?.includes(paramName)) {
+          this[paramName] = this.createWidgetSubjection(contextMap);
+        }
+      }
+    }
+  }
+
+  /**
+   * 包装发布者事件
+   * 如果启动了作用域检查，那么发布的时候会携带发布者的widget实例
+   **/
+  private wrapSubjectWithScope(subject: AnySubject, scope?: WidgetTypeKey): AnySubject {
+    if (!scope) {
+      return subject;
+    }
+
+    const next = subject.next;
+    const self = this;
+
+    subject.next = function (payload) {
+      next.call(
+        subject,
+        payload.__publisherWidget
+          ? payload
+          : {
+              payload,
+              __publisherWidget: self
+            }
+      );
+    };
+
+    const behaviorSubject = subject as BehaviorSubject<any>;
+
+    if (behaviorSubject.getValue) {
+      const getValue = behaviorSubject.getValue;
+      behaviorSubject.getValue = function () {
+        const value = getValue.call(behaviorSubject);
+        if (value.__publisherWidget) {
+          return value.payload;
+        }
+
+        return value;
+      };
+    }
+
+    return subject as AnySubject;
+  }
+
+  /**
+   * 创建发布订阅对象
+   */
+  private createWidgetSubjection(contextMap: NameContextMap<unknown>): BaseWidgetSubjection<unknown> {
+    const { subject, option } = contextMap;
+
+    return {
+      subscribe: (func) => {
+        const subscription = subject.subscribe((data: any) => {
+          /**
+           * 订阅
+           * 如果启动了作用域检查，那么订阅的时候会检查发布者的widget实例是否和订阅者在同一个作用域下
+           */
+          if (option?.scope && data?.__publisherWidget) {
+            if (this.isSameScopeWidget(data.__publisherWidget, option?.scope)) {
+              func(data.payload);
+            }
+          } else {
+            func(option?.scope && data?.__publisherWidget ? data.payload : data);
+          }
+        });
+        this.subscriptionMap.set(Symbol('random'), subscription);
+        return subscription;
+      },
+      subject: this.wrapSubjectWithScope(subject, option?.scope)
+    } as BaseWidgetSubjection<unknown>;
+  }
+
+  private isSameScopeWidget(otherWidget: Widget, widgetType: WidgetTypeKey): boolean {
+    const selfWidget = this.getParentWidgetByType(widgetType);
+    const otherOther = otherWidget.getParentWidgetByType(widgetType);
+
+    return (selfWidget === otherOther && selfWidget !== null) || this.getHandle() === otherOther?.getHandle();
+  }
+
   /**
    * 销毁widget
    *
@@ -527,6 +630,17 @@ export abstract class Widget<Props extends WidgetProps = WidgetProps, R = unknow
     return this.parent;
   }
 
+  private getParentWidgetByType(type: WidgetTypeKey) {
+    let current = this.parent;
+    while (current) {
+      if (current.$$innerWidgetType === type) {
+        return current;
+      }
+      current = current.parent;
+    }
+    return null;
+  }
+
   /**
    * 获取子元素
    */

package/src/data/ActiveRecordsWidget.ts

@@ -17,6 +17,7 @@ import {
   UpdateEntity
 } from '@oinone/kunlun-engine';
 import { Widget } from '../basic';
+import { OioAnyViewState, useOioState } from '../state';
 import { PathWidget, PathWidgetProps } from './PathWidget';
 
 export interface ActiveRecordsWidgetProps extends PathWidgetProps {
@@ -30,6 +31,20 @@ export interface ActiveRecordsWidgetProps extends PathWidgetProps {
 export class ActiveRecordsWidget<
   Props extends ActiveRecordsWidgetProps = ActiveRecordsWidgetProps
 > extends PathWidget<Props> {
+  /**
+   * 视图级别状态, 在 beforeMounted 后可获取到有效值
+   * @protected
+   */
+  protected viewState: OioAnyViewState | undefined;
+
+  public getViewState(): OioAnyViewState | undefined {
+    return this.viewState;
+  }
+
+  public setViewState(state: OioAnyViewState) {
+    this.viewState = state;
+  }
+
   public initialize(props: Props) {
     super.initialize(props);
     const { dataSource, activeRecords } = props;
@@ -175,10 +190,11 @@ export class ActiveRecordsWidget<
    *
    * @param records 数据
    * @param predict 推送判定
+   * @param index 推送到指定位置; 0 表示插入到数组头; 未传入或-1 表示插入到数组尾;
    */
   @Widget.Method()
   @Widget.Provide()
-  public pushDataSource(records: ActiveRecords, predict?: PushActiveRecordsPredict) {
+  public pushDataSource(records: ActiveRecords, predict?: PushActiveRecordsPredict, index?: number) {
     if (this.parentPushDataSource && this.getCurrentDataSource() === undefined) {
       this.parentPushDataSource(records, predict);
     } else {
@@ -188,7 +204,7 @@ export class ActiveRecordsWidget<
         pushPredict = ActiveRecordsOperator.defaultPushPredict.bind(submitCache);
       }
       const nextDataSource = ActiveRecordsOperator.operator(this.getCurrentDataSource() || undefined, this.submitCache)
-        .push(records, pushPredict)
+        .push(records, pushPredict, index)
         .get();
       if (!submitCache) {
         this.setCurrentDataSource(nextDataSource);
@@ -314,24 +330,6 @@ export class ActiveRecordsWidget<
     }
   }
 
-
-  @Widget.Method()
-  @Widget.Inject('createDataSourceByEntity')
-  protected parentCreateDataSourceByEntity: PushActiveRecordsFunction | undefined;
-
-
-  @Widget.Method()
-  @Widget.Provide()
-  public createDataSourceByEntity(records:ActiveRecords,predict?:PushActiveRecordsPredict){
-    if (this.parentCreateDataSourceByEntity && this.getCurrentDataSource() === undefined) {
-      this.parentCreateDataSourceByEntity(records, predict);
-    } else {
-      const nextDataSource = Array.isArray(records) ? records : [records];
-      const oldDataSource = this.getCurrentDataSource() || [];
-      this.setCurrentDataSource([...nextDataSource, ...oldDataSource]);
-    }
-  }
-
   @Widget.Method()
   @Widget.Inject('flushDataSource')
   protected parentFlushDataSource: FlushActiveRecordsFunction | undefined;
@@ -569,4 +567,58 @@ export class ActiveRecordsWidget<
       this.currentActiveRecords = [];
     }
   }
+
+  protected $$initViewStatePosition(state: OioAnyViewState): void {
+    // do nothing.
+  }
+
+  protected $$clearViewStatePosition(state: OioAnyViewState): void {
+    // do nothing.
+  }
+
+  protected $$initViewState(state: OioAnyViewState): void {
+    // do nothing.
+  }
+
+  protected $$clearViewState(state: OioAnyViewState): void {
+    // do nothing.
+  }
+
+  protected $$beforeMount() {
+    super.$$beforeMount();
+    let isInitStatePosition = false;
+    if (!this.viewState) {
+      this.viewState = useOioState().viewState;
+      if (this.viewState) {
+        isInitStatePosition = true;
+        this.$$initViewStatePosition(this.viewState);
+        this.$$initViewState(this.viewState);
+      }
+    }
+    if (this.viewState && !isInitStatePosition) {
+      this.$$initViewStatePosition(this.viewState);
+    }
+  }
+
+  protected $$mounted() {
+    super.$$mounted();
+    if (this.viewState) {
+      this.$$clearViewStatePosition(this.viewState);
+      this.$$clearViewState(this.viewState);
+    }
+  }
+
+  protected $$beforeUnmount() {
+    super.$$beforeUnmount();
+    if (this.viewState) {
+      this.$$initViewStatePosition(this.viewState);
+    }
+  }
+
+  protected $$unmounted() {
+    super.$$unmounted();
+    if (this.viewState) {
+      this.$$clearViewStatePosition(this.viewState);
+    }
+  }
 }

package/src/dsl/DslDefinitionWidget.ts

@@ -7,7 +7,7 @@ import {
   RuntimeContextManager,
   RuntimeModelField
 } from '@oinone/kunlun-engine';
-import { BooleanHelper } from '@oinone/kunlun-shared';
+import { BooleanHelper, CSSClass, CSSStyle } from '@oinone/kunlun-shared';
 import { isNil } from 'lodash-es';
 import { Widget } from '../basic';
 import { InvisibleSupported, isAllInvisible } from '../feature';
@@ -30,7 +30,7 @@ export interface DslDefinitionWidgetProps extends DslRenderWidgetProps {
    */
   inline?: boolean;
   /**
-   * 自动组件
+   * 自动渲染组件
    */
   automatic?: boolean;
 }
@@ -52,6 +52,16 @@ export class DslDefinitionWidget<Props extends DslDefinitionWidgetProps = DslDef
     return this.metadataHandle;
   }
 
+  @Widget.Reactive()
+  protected get class(): CSSClass | undefined {
+    return this.getDsl().class;
+  }
+
+  @Widget.Reactive()
+  protected get style(): string | Partial<CSSStyle> | undefined {
+    return this.getDsl().style;
+  }
+
   @Widget.Reactive()
   protected rootHandle: string | undefined;
 
@@ -128,26 +138,36 @@ export class DslDefinitionWidget<Props extends DslDefinitionWidgetProps = DslDef
   }
 
   public get metadataRuntimeContext(): RuntimeContext {
+    const runtimeContext = this.metadataRuntimeContextNullable;
+    if (!runtimeContext) {
+      throw new Error('Invalid metadata runtime context.');
+    }
+    return runtimeContext;
+  }
+
+  public get metadataRuntimeContextNullable(): RuntimeContext | undefined {
     const { metadataHandle } = this;
     let runtimeContext: RuntimeContext | undefined;
     if (metadataHandle) {
       runtimeContext = RuntimeContextManager.get(metadataHandle);
     }
+    return runtimeContext;
+  }
+
+  public get rootRuntimeContext(): RuntimeContext {
+    const runtimeContext = this.rootRuntimeContextNullable;
     if (!runtimeContext) {
-      throw new Error('Invalid metadata runtime context.');
+      throw new Error('Invalid root runtime context.');
     }
     return runtimeContext;
   }
 
-  public get rootRuntimeContext(): RuntimeContext {
+  public get rootRuntimeContextNullable(): RuntimeContext | undefined {
     const { rootHandle } = this;
     let runtimeContext: RuntimeContext | undefined;
     if (rootHandle) {
       runtimeContext = RuntimeContextManager.get(rootHandle);
     }
-    if (!runtimeContext) {
-      throw new Error('Invalid root runtime context.');
-    }
     return runtimeContext;
   }
 

package/src/index.ts

@@ -3,6 +3,7 @@ export * from './data';
 export * from './dsl';
 export * from './feature';
 export * from './hooks';
+export * from './state';
 export * from './token';
 export * from './typing';
 export * from './util';

package/src/state/context.ts

@@ -0,0 +1,57 @@
+import { ViewType } from '@oinone/kunlun-meta';
+import { computed, ComputedRef, inject, InjectionKey, provide } from 'vue';
+
+/**
+ * 元数据上下文
+ */
+export interface MetaContext {
+  viewType: ComputedRef<ViewType>;
+  model: ComputedRef<string>;
+  modelName: ComputedRef<string>;
+  module: ComputedRef<string>;
+  moduleName: ComputedRef<string>;
+  metadataHandle: ComputedRef<string>;
+  rootHandle: ComputedRef<string>;
+  parentHandle: ComputedRef<string>;
+  slotName: ComputedRef<string | undefined>;
+  inline: ComputedRef<boolean>;
+}
+
+/**
+ * 默认元数据上下文
+ */
+export const defaultMetaContext = {
+  viewType: computed(() => ViewType.Form),
+  model: computed(() => ''),
+  modelName: computed(() => ''),
+  module: computed(() => ''),
+  moduleName: computed(() => ''),
+  metadataHandle: computed(() => ''),
+  rootHandle: computed(() => ''),
+  parentHandle: computed(() => ''),
+  slotName: computed(() => undefined),
+  inline: computed(() => false)
+};
+
+/**
+ * 元数据Provider/Inject键
+ */
+const MetaContextKey: InjectionKey<MetaContext> = Symbol('MetaContext');
+
+/**
+ * 提供元数据上下文
+ * @param state 元数据可选项
+ */
+export const useProviderMetaContext = (state: Partial<MetaContext>): void => {
+  provide(MetaContextKey, {
+    ...defaultMetaContext,
+    ...state
+  });
+};
+
+/**
+ * 获取元数据上下文
+ */
+export const useInjectMetaContext = (): MetaContext => {
+  return inject(MetaContextKey, defaultMetaContext);
+};