@flowgram.ai/form-core 0.2.16 → 0.2.18

package/dist/index.d.mts

@@ -6,6 +6,11 @@ import { ContainerModule } from 'inversify';
 import * as _flowgram_ai_utils from '@flowgram.ai/utils';
 import { Emitter, MaybePromise, Event, DisposableCollection } from '@flowgram.ai/utils';
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface ErrorData {
     error: Error | null;
 }
@@ -16,16 +21,36 @@ declare class FlowNodeErrorData extends EntityData {
     getError(): Error;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface NodeErrorRenderProps {
     error: Error;
     context: NodeContext;
 }
 type NodeErrorRender = Render<NodeErrorRenderProps>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const ErrorContainerModule: ContainerModule;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function getNodeError(node: FlowNodeEntity): Error;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface NodeContext {
     node: FlowNodeEntity;
     playgroundContext: PlaygroundContext;
@@ -39,6 +64,11 @@ interface NodeRenderProps {
 }
 type NodeRenderHoc = (Component: React.JSXElementConstructor<NodeRenderProps>) => React.JSXElementConstructor<NodeRenderProps>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare enum MaterialRenderKey {
     CustomNodeError = "Material_CustomNodeError"
 }
@@ -58,18 +88,36 @@ declare class NodeManager {
     protected init(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const NodeContribution: unique symbol;
 interface NodeContribution {
     onRegister?(nodeManager: NodeManager): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const NodeContainerModule: ContainerModule;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare const PLUGIN_KEY: {
     FORM: string;
     ERROR: string;
 };
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare const MATERIAL_KEY: {
     NODE_ERROR_RENDER: string;
     NODE_PLACEHOLDER_RENDER: string;
@@ -98,13 +146,27 @@ declare class NodeEngineContext {
     private updateJSON;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class NodeEngine {
     nodeManager: NodeManager;
     context: NodeEngineContext;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const FormCoreContainerModule: ContainerModule;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 interface FormItemAbility {
     type: string;
     /**
@@ -117,6 +179,10 @@ interface AbilityClass {
     new (): FormItemAbility;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 interface IFormItem<T = any> {
     value: T;
 }
@@ -140,6 +206,11 @@ interface FormItemDomRef {
     current: HTMLElement | null;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface FormItemAbilityMeta<Options = any> {
     type: string;
     options: Options;
@@ -191,6 +262,11 @@ interface FormItemHooks<T> {
     onValidate?: (params: FormItemHookParams & T) => void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FormDataTypeName = 'string' | 'number' | 'integer' | 'boolean' | 'object' | 'array' | 'null';
 type FormDataType = string | number | boolean | FormDataObject | DataArray | null;
 interface FormDataObject {
@@ -248,7 +324,7 @@ interface IFormMeta {
     /**
      * 表单树结构root
      */
-    root: IFormItemMeta;
+    root?: IFormItemMeta;
     /**
      * 表单全局配置
      */
@@ -271,6 +347,11 @@ interface FormMetaGeneratorParams<PlaygroundContext, FormValue = any> {
 type FormMetaGenerator<PlaygroundContext = any, FormValue = any> = (params: FormMetaGeneratorParams<FormValue, FormValue>) => MaybePromise<IFormMeta>;
 type FormMetaOrFormMetaGenerator = FormMetaGenerator | IFormMeta;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 type FormModelFactory = (entity: FlowNodeEntity) => FormModel;
 declare const FormModelFactory: unique symbol;
 declare const FormModelEntity: unique symbol;
@@ -289,7 +370,7 @@ declare abstract class FormModel {
      * @deprecated
      */
     abstract get formManager(): FormManager;
-    abstract get formMeta(): IFormMeta;
+    abstract get formMeta(): any;
     abstract get initialized(): boolean;
     abstract get valid(): FormModelValid;
     abstract updateFormValues(value: any): void;
@@ -339,6 +420,11 @@ declare abstract class FormItem {
     dispose(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface FormMetaTraverseParams {
     formItemMeta: IFormItemMeta;
     parentPath?: string;
@@ -356,6 +442,10 @@ declare class FormMeta implements IFormMeta {
     static traverse({ formItemMeta, parentPath, handle }: FormMetaTraverseParams): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 interface Extension {
     key: string;
 }
@@ -367,6 +457,11 @@ declare class FormAbilityExtensionRegistry {
     get collection(): Extension[];
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface FormItemMaterialContext {
     /**
      * 当前表单项的meta
@@ -407,16 +502,31 @@ interface FormItemMaterialContext {
     index?: number | undefined;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class SetterAbility implements FormItemAbility {
     static readonly type = "setter";
     get type(): string;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class ValidationAbility implements FormItemAbility {
     static readonly type = "validation";
     get type(): string;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface IValidateResult {
     type: 'error' | 'warning';
     message: string;
@@ -443,6 +553,11 @@ interface ValidationExtension {
     validator: ValidatorFunction;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface SetterAbilityOptions {
     /**
      * 已注册的setter的唯一标识
@@ -474,11 +589,21 @@ interface SetterExtension {
 }
 type SetterHoc = (Component: React.JSXElementConstructor<SetterComponentProps>) => React.JSXElementConstructor<SetterComponentProps>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class DecoratorAbility implements FormItemAbility {
     static readonly type = "decorator";
     get type(): string;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface DecoratorAbilityOptions {
     /**
      * 已注册的decorator的唯一标识
@@ -496,6 +621,11 @@ interface DecoratorExtension {
     component: (props: DecoratorComponentProps) => any;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface VisibilityAbilityOptions {
     /**
      * 是否隐藏
@@ -511,11 +641,21 @@ declare class VisibilityAbility implements FormItemAbility {
     get type(): string;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class EffectAbility implements FormItemAbility {
     static readonly type = "effect";
     get type(): string;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface EffectAbilityOptions {
     /**
      * 已注册的effect 唯一标识
@@ -548,11 +688,21 @@ interface EffectExtension {
     effect: EffectFunction;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class DefaultAbility implements FormItemAbility {
     static readonly type = "default";
     get type(): string;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 interface GetDefaultValueProps extends FormItemContext {
     options: DefaultAbilityOptions;
     context: FormItemMaterialContext;
@@ -561,6 +711,10 @@ interface DefaultAbilityOptions<T = any> {
     getDefaultValue: (params: GetDefaultValueProps) => T;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare class FormPathService {
     static readonly ROOT = "/";
     static readonly DIVIDER = "/";
@@ -578,6 +732,11 @@ declare class FormPathService {
     simplify(path: string): string;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare class FormContextMaker {
     readonly nodeEngineContext: NodeEngineContext;
     readonly playgroundContext: PlaygroundContext;
@@ -617,6 +776,11 @@ declare class FormManager {
     protected init(): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const FormContribution: unique symbol;
 interface FormContribution {
     onRegister?(formManager: FormManager): void;
@@ -666,22 +830,61 @@ declare class FlowNodeFormData extends EntityData {
     fireDetaiChange(detailChangeEvent: DetailChangeEvent): void;
 }
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function isNodeFormReady(node: FlowNodeEntity): boolean;
 declare function getFormModel(node: FlowNodeEntity): FormModel;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
 declare function createNodeContainerModules(): inversify.ContainerModule[];
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const NodeRender: React.MemoExoticComponent<({ node }: NodeRenderProps) => React.JSX.Element>;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function registerNodeErrorRender(nodeManager: NodeManager, render: Render): void;
 declare function registerNodePlaceholderRender(nodeManager: NodeManager, render: NodePlaceholderRender): void;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function createNodeEntityDatas(): EntityDataRegistry[];
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function useNodeEngineContext(): NodeEngineContext;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare function useFormItem(path: string): IFormItem | undefined;
 
+/**
+ * Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+
 declare const NodeEngineReactContext: React.Context<INodeEngineContext>;
 
 export { type AbilityClass, type DataArray, DecoratorAbility, type DecoratorAbilityOptions, type DecoratorComponentProps, type DecoratorExtension, DefaultAbility, type DefaultAbilityOptions, type DetailChangeEvent, EffectAbility, type EffectAbilityOptions, type EffectEvent, type EffectExtension, type EffectFunction, type EffectProps, ErrorContainerModule, type ErrorData, type Extension, FORM_VOID, type FeedbackStatus, type FeedbackText, FlowNodeErrorData, FlowNodeFormData, FormAbilityExtensionRegistry, FormContextMaker, FormContribution, FormCoreContainerModule, type FormDataObject, type FormDataType, type FormDataTypeName, type FormFeedback, FormItem, type FormItemAbility, type FormItemAbilityMeta, type FormItemContext, type FormItemDomRef, FormItemEventName, type FormItemFeedback, type FormItemHookParams, type FormItemHooks, type FormItemMaterialContext, FormManager, FormMeta, type FormMetaGenerator, type FormMetaGeneratorParams, type FormMetaOrFormMetaGenerator, type FormMetaTraverseParams, FormModel, FormModelEntity, FormModelFactory, type FormModelValid, FormPathService, type GetDefaultValueProps, type IFormItem, type IFormItemMeta, type IFormMeta, type IFormMetaOptions, type INodeEngineContext, type IValidateResult, MATERIAL_KEY, MaterialRenderKey, NodeContainerModule, type NodeContext, NodeContribution, NodeEngine, NodeEngineContext, NodeEngineReactContext, type NodeErrorRender, type NodeErrorRenderProps, type NodeFormContext, NodeManager, type NodePlaceholderRender, type NodePluginRender, NodeRender, type NodeRenderHoc, type NodeRenderProps, type OnFormValuesChangePayload, PLUGIN_KEY, type Render, SetterAbility, type SetterAbilityOptions, type SetterComponentProps, type SetterExtension, type SetterHoc, type SetterOrDecoratorContext, type TreeNode, ValidationAbility, type ValidationAbilityOptions, type ValidationExtension, type ValidatorFunction, type ValidatorFunctionResponse, type ValidatorProps, VisibilityAbility, type VisibilityAbilityOptions, createNodeContainerModules, createNodeEntityDatas, getFormModel, getNodeError, isNodeFormReady, registerNodeErrorRender, registerNodePlaceholderRender, useFormItem, useNodeEngineContext };