@byteluck-fe/model-driven-controls 7.0.0-props.99 → 8.0.0-beta.0

package/dist/types/baseControls/PieChart/property.d.ts

@@ -1,13 +1,14 @@
-import { MultistageFillingItem, Property, PropertyInterface, TreeDataSourceBind } from '@byteluck-fe/model-driven-core';
-type PieChartDataMode = 'static' | 'dynamic';
-interface PieChartYFieldItem {
-    field: string;
-    name: string;
-}
+import { MultistageFillingItem, Property, PropertyInterface, PropertyRules, DataSourceBind } from '@byteluck-fe/model-driven-core';
+import { FONT_WEIGHT } from '../../framework';
+import { RuleItem } from 'async-validator';
 type PieSeriesDataConfig = {
-    valueField?: string;
     nameField?: string;
+    valueField?: string;
 };
+declare class PieChartPropertyRules extends PropertyRules {
+    seriesConfig: RuleItem;
+    constructor(props: PieChartProperty);
+}
 interface PieChartPropertyInterface extends PropertyInterface {
     /**
      * 标题
@@ -27,12 +28,42 @@ interface PieChartPropertyInterface extends PropertyInterface {
      * @public
      */
     isShowCaptionTip: boolean;
+    /**
+     * 标题布局；取值：top：上方；left：左侧；
+     * @defaultValue 'top'
+     * @public
+     */
+    labelPosition: 'top' | 'left';
     /**
      * 气泡提示语
      * @defaultValue ''
      * @public
      */
     captionTip: string;
+    /**
+     * 标题大小
+     * @defaultValue ''
+     * @public
+     */
+    captionSize: string;
+    /**
+     * 标题颜色
+     * @defaultValue ''
+     * @public
+     */
+    captionColor: string;
+    /**
+     * 标题斜体
+     * @defaultValue false
+     * @public
+     */
+    isCaptionItalic: boolean;
+    /**
+     * 标题字重；取值：normal：常规；bold：粗体；lighter：更细；
+     * @defaultValue 'normal'
+     * @public
+     */
+    captionFontWeight: FONT_WEIGHT;
     /**
      * 是否隐藏组件
      * @defaultValue false
@@ -45,12 +76,6 @@ interface PieChartPropertyInterface extends PropertyInterface {
      * @public
      */
     template: string;
-    /**
-     * 数据模式；取值：static：静态数据；dynamic：动态数据源；
-     * @defaultValue 'static'
-     * @public
-     */
-    dataMode: PieChartDataMode;
     /**
      * 图表 option JSON
      * @defaultValue '{}'
@@ -65,16 +90,16 @@ interface PieChartPropertyInterface extends PropertyInterface {
     optionConfig: 'datasource';
     /**
      * 数据源绑定
-     * @defaultValue new TreeDataSourceBind({ attributes: PieChartControl.controlCustomAttributes })
+     * @defaultValue new DataSourceBind()
      * @public
      */
-    datasourceBind: TreeDataSourceBind;
+    datasourceBind: DataSourceBind;
     /**
      * 筛选项数据源绑定
-     * @defaultValue new TreeDataSourceBind({ attributes: PieChartControl.controlCustomAttributes })
+     * @defaultValue new DataSourceBind()
      * @public
      */
-    filterItemDatasourceBind: TreeDataSourceBind;
+    filterItemDatasourceBind: DataSourceBind;
     /**
      * 多级填充
      * @defaultValue []
@@ -94,51 +119,130 @@ interface PieChartPropertyInterface extends PropertyInterface {
      */
     openMultistageFilling: boolean;
     /**
-     * X 轴字段
-     * @defaultValue ''
+     * 饼图系列数据映射
+     * @defaultValue []
      * @public
      */
-    xField: string;
+    seriesConfig: PieSeriesDataConfig[];
+}
+declare class PieChartProperty extends Property implements PieChartPropertyInterface {
+    static readonly Rules: typeof PieChartPropertyRules;
     /**
-     * Y 轴字段
-     * @defaultValue ''
+     * 标题
+     * @defaultValue '饼图'
      * @public
      */
-    yField: string;
+    caption: string;
     /**
-     * 多 Y 轴字段
-     * @defaultValue []
+     * 是否隐藏标题
+     * @defaultValue false
      * @public
      */
-    yFields: PieChartYFieldItem[];
+    isHideCaption: boolean;
     /**
-     * 饼图系列数据映射
-     * @defaultValue []
+     * 是否显示气泡提示
+     * @defaultValue false
      * @public
      */
-    seriesConfig: PieSeriesDataConfig[];
-}
-declare class PieChartProperty extends Property implements PieChartPropertyInterface {
-    caption: string;
-    isHideCaption: boolean;
     isShowCaptionTip: boolean;
+    /**
+     * 标题布局；取值：top：上方；left：左侧；
+     * @defaultValue 'top'
+     * @public
+     */
+    labelPosition: 'top' | 'left';
+    /**
+     * 气泡提示语
+     * @defaultValue ''
+     * @public
+     */
     captionTip: string;
+    /**
+     * 标题大小
+     * @defaultValue ''
+     * @public
+     */
+    captionSize: string;
+    /**
+     * 标题颜色
+     * @defaultValue ''
+     * @public
+     */
+    captionColor: string;
+    /**
+     * 标题斜体
+     * @defaultValue false
+     * @public
+     */
+    isCaptionItalic: boolean;
+    /**
+     * 标题字重；取值：normal：常规；bold：粗体；lighter：更细；
+     * @defaultValue 'normal'
+     * @public
+     */
+    captionFontWeight: FONT_WEIGHT;
+    /**
+     * 是否隐藏组件
+     * @defaultValue false
+     * @public
+     */
     isHide: boolean;
+    /**
+     * 图表模板
+     * @defaultValue 'pie-rounded-ring'
+     * @public
+     */
     template: string;
-    dataMode: PieChartDataMode;
+    /**
+     * 图表 option JSON
+     * @defaultValue '{}'
+     * @public
+     */
     optionJson: string;
+    /**
+     * 选项配置方式；取值：datasource：数据源；
+     * @defaultValue 'datasource'
+     * @public
+     */
     optionConfig: 'datasource';
-    datasourceBind: TreeDataSourceBind;
-    filterItemDatasourceBind: TreeDataSourceBind;
+    /**
+     * 数据源绑定
+     * @defaultValue new DataSourceBind()
+     * @public
+     */
+    datasourceBind: DataSourceBind;
+    /**
+     * 筛选项数据源绑定
+     * @defaultValue new DataSourceBind()
+     * @public
+     */
+    filterItemDatasourceBind: DataSourceBind;
+    /**
+     * 多级填充
+     * @defaultValue []
+     * @public
+     */
     multistageFilling: MultistageFillingItem[];
+    /**
+     * 默认值
+     * @defaultValue []
+     * @public
+     */
     defaultValue: string[];
+    /**
+     * 是否开启填充
+     * @defaultValue false
+     * @public
+     */
     openMultistageFilling: boolean;
-    xField: string;
-    yField: string;
-    yFields: PieChartYFieldItem[];
+    /**
+     * 饼图系列数据映射
+     * @defaultValue []
+     * @public
+     */
     seriesConfig: PieSeriesDataConfig[];
     constructor(props?: Partial<PieChartProperty>);
 }
 export default PieChartProperty;
-export type { PieChartDataMode, PieChartPropertyInterface, PieChartYFieldItem, PieSeriesDataConfig, };
-export { PieChartProperty };
+export type { PieChartPropertyInterface, PieSeriesDataConfig };
+export { PieChartProperty, PieChartPropertyRules };

package/dist/types/baseControls/ReferenceList/property.d.ts

@@ -47,10 +47,35 @@ interface ReferenceListPropertyInterface extends PropertyInterface {
  */
 declare class ReferenceListProperty extends Property implements ReferenceListPropertyInterface {
     static readonly Rules: typeof ReferenceListPropertyRules;
+    /**
+     * 是否显示查询栏
+     * @defaultValue true
+     * @public
+     */
     isShowSimpleSearch: boolean;
+    /**
+     * 是否显示工具栏
+     * @defaultValue true
+     * @public
+     */
     isShowToolbar: boolean;
+    /**
+     * 动作设置
+     * @defaultValue new ActionSetting()
+     * @public
+     */
     actionSetting: ActionSetting;
+    /**
+     * 列表高度配置
+     * @defaultValue new ListHeightSetting()
+     * @public
+     */
     listHeightSetting: ListHeightSetting;
+    /**
+     * 列表高度配置
+     * @defaultValue false
+     * @public
+     */
     isHideCaption: boolean;
     constructor(props?: Partial<ReferenceListProperty>);
 }

package/dist/types/baseControls/Text/property.d.ts

@@ -85,17 +85,77 @@ interface TextPropertyInterface extends PropertyInterface {
     background: BackgroundProperty;
 }
 declare class TextProperty extends Property implements TextPropertyInterface {
+    /**
+     * 内容
+     * @defaultValue '说明文字'
+     * @public
+     */
     content: string;
+    /**
+     * 图标
+     * @defaultValue 'page-hint'
+     * @public
+     */
     icon: string;
+    /**
+     * 位置对齐
+     * @defaultValue ''
+     * @public
+     */
     align: string;
+    /**
+     * 显示状态；取值：text：纯文本；imageText：图文；image：纯图片；
+     * @defaultValue 'text'
+     * @public
+     */
     showState: 'text' | 'imageText' | 'image';
+    /**
+     * 标题大小
+     * @defaultValue ''
+     * @public
+     */
     captionSize: string;
+    /**
+     * 标题颜色
+     * @defaultValue ''
+     * @public
+     */
     captionColor: string;
+    /**
+     * 标题斜体
+     * @defaultValue false
+     * @public
+     */
     isCaptionItalic: boolean;
+    /**
+     * 标题字重；取值：normal：常规；bold：粗体；lighter：更细；
+     * @defaultValue 'normal'
+     * @public
+     */
     captionFontWeight: FONT_WEIGHT;
+    /**
+     * 是否开启 AI 内容搜索
+     * @defaultValue false
+     * @public
+     */
     aiContentSearch: boolean;
+    /**
+     * 是否作为标签展示
+     * @defaultValue false
+     * @public
+     */
     isLabel: boolean;
+    /**
+     * 关闭配置
+     * @defaultValue { show: false, text: '关闭' }
+     * @public
+     */
     close: closeProperty;
+    /**
+     * 背景
+     * @defaultValue { type: 'backgroundColor', backgroundColor: '', backgroundImage: '', ... }
+     * @public
+     */
     background: BackgroundProperty;
     constructor(props?: Partial<TextProperty>);
 }

package/dist/types/baseControls/TextOcrButton/property.d.ts

@@ -60,12 +60,47 @@ interface TextOcrButtonPropertyInterface extends ButtonPropertyInterface {
 }
 declare class TextOcrButtonProperty extends ButtonProperty implements TextOcrButtonPropertyInterface {
     static readonly Rules: typeof TextOcrButtonPropertyRules;
+    /**
+     * 标题
+     * @defaultValue 控件名称
+     * @public
+     */
     caption: string;
+    /**
+     * 隐藏标题
+     * @defaultValue false
+     * @public
+     */
     isHideCaption: boolean;
+    /**
+     * 是否开启气泡提示
+     * @defaultValue false
+     * @public
+     */
     isShowCaptionTip: boolean;
+    /**
+     * 气泡提示语
+     * @defaultValue ''
+     * @public
+     */
     captionTip: string;
+    /**
+     * 标题布局；取值：top：上方；left：左侧；
+     * @defaultValue 'top'
+     * @public
+     */
     labelPosition: 'top' | 'left';
+    /**
+     * 识别类型
+     * @defaultValue ''
+     * @public
+     */
     ocrType: string;
+    /**
+     * 填充配置
+     * @defaultValue []
+     * @public
+     */
     fillList: MultistageFillingItem[];
     constructor(props?: Partial<TextOcrButtonProperty>);
 }

package/dist/types/baseControls/Title/property.d.ts

@@ -39,9 +39,29 @@ interface TitlePropertyInterface extends PropertyInterface {
 }
 declare class TitleProperty extends Property implements TitlePropertyInterface {
     static readonly Rules: typeof TitleControlPropertyRules;
+    /**
+     * 数据绑定项
+     * @defaultValue new DataBind()
+     * @public
+     */
     dataBind: DataBind;
+    /**
+     * 标题
+     * @defaultValue ''
+     * @public
+     */
     caption: string;
+    /**
+     * 标题配置项；取值：is_show_biz_key：显示业务标题；is_show_submit_user：显示提交人；is_show_submit_time：显示提交时间；is_show_submit_dept：显示提交部门；is_show_current_approvar：显示当前审批人；is_show_title：显示标题；
+     * @defaultValue ['is_show_submit_user', ...]
+     * @public
+     */
     config: TitleConfigEnum[];
+    /**
+     * 位置
+     * @defaultValue 'top'
+     * @public
+     */
     position: string;
     constructor(props?: Partial<TitleProperty>);
 }

package/dist/types/baseControls/index.d.ts

@@ -32,6 +32,8 @@ export { default as Dashboard } from './Dashboard';
 export type { DashboardPropertyInterface } from './Dashboard';
 export { default as BarChart } from './BarChart';
 export type { BarChartPropertyInterface } from './BarChart';
+export { default as LineChart } from './LineChart';
+export type { LineChartPropertyInterface } from './LineChart';
 export { default as PieChart } from './PieChart';
 export type { PieChartPropertyInterface } from './PieChart';
 export { default as ListViewSelect } from './ListViewSelect';

package/dist/types/baseControls/utils.d.ts

@@ -1,2 +1,11 @@
 import { RuleItem } from 'async-validator';
+type ChartAxisKey = 'xAxis' | 'yAxis';
+interface ChartOptionProps {
+    optionJson: string;
+}
+export declare function isBlankChartField(value: unknown): boolean;
+export declare function isCategoryChartAxis(optionJson: string, axisKey: ChartAxisKey): boolean;
+export declare function createChartAxisFieldRule(props: ChartOptionProps, axisKey: ChartAxisKey, message: string): RuleItem;
+export declare function createChartSeriesConfigRule(message: string): RuleItem;
 export declare function createFillBindRules(): Record<string, RuleItem>;
+export {};

package/dist/types/catalog/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './query';

package/dist/types/catalog/query.d.ts

@@ -0,0 +1,15 @@
+import { ControlCatalogInfo, ControlDefinition, ControlLocaleMessageFact, ControlSettingFact } from './types';
+/** 返回独立副本，避免调用方污染进程内共享 catalog。 */
+export declare function getControlDefinition(type: string): ControlDefinition | undefined;
+/** 控件列表按 type 稳定排序，生成器与运行时查询顺序保持一致。 */
+export declare function listControlDefinitions(): ControlDefinition[];
+export declare function hasControlDefinition(type: string): boolean;
+/** 给 FDE/AI 工具的窄查询，避免为了类型列表复制整份 defaultSchema。 */
+export declare function listControlTypes(): string[];
+export declare function getControlEventKeys(type: string): string[];
+export declare function getControlSettingFacts(type: string): ControlSettingFact[];
+/** headless 按稳定 key 窄查消息事实，避免复制整份 catalog。 */
+export declare function getControlLocaleMessageFact(key: string): ControlLocaleMessageFact | undefined;
+export declare function getControlCatalogInfo(): ControlCatalogInfo;
+export declare const CONTROL_CATALOG_REVISION: string;
+export declare const CONTROL_CATALOG_SIZE: number;

package/dist/types/catalog/types.d.ts

@@ -0,0 +1,103 @@
+import { ControlCatalogSchemaVersion, JsonObject, JsonValue, HeadlessControlNode, ModelDrivenBaseControlType } from '@byteluck-fe/model-driven-core/contracts';
+export type ControlCatalogValueType = 'array' | 'boolean' | 'integer' | 'number' | 'object' | 'string';
+export interface ControlSettingFact {
+    controlType: string;
+    propertyKey: string;
+    savedPropertyKey: string;
+    valueType: ControlCatalogValueType;
+    options?: JsonValue[];
+    min?: number;
+    max?: number;
+}
+/** 由 i18n_messages 发布生成的紧凑文案事实，不包含运行时 i18n 实例。 */
+export interface ControlLocaleMessageFact {
+    key: string;
+    fallback: string;
+    values: Record<string, string>;
+}
+export type ControlDynamicDefault = {
+    fallback: string;
+    kind: 'locale-text';
+    /** 对应 getLocaleText 的稳定 key，供调用方注入任意 locale 文案。 */
+    messageKey: string;
+    path: Array<string | number>;
+    propertyKey: string;
+    values: Record<string, string>;
+    /** 显式传入该根属性时，是否仍应用此国际化默认值。 */
+    applyToExplicit?: boolean;
+} | {
+    fallback: string;
+    kind: 'locale-json-text';
+    messageKey: string;
+    /** JSON 字符串属性名及其内部路径均由源码通用分析生成。 */
+    propertyKey: string;
+    jsonPath: Array<string | number>;
+    values: Record<string, string>;
+    space?: string | number;
+} | {
+    kind: 'generated-id';
+    /** 相对 defaultSchema 的精确路径，只由发布生成器登记。 */
+    path: Array<string | number>;
+} | {
+    kind: 'option-item-ids';
+    propertyKey: string;
+    /** 真实 Option 构造器会把未显式传入的 value 与国际化后的 label 保持一致。 */
+    valueFromLabel?: boolean;
+} | {
+    countPropertyKey: string;
+    kind: 'score-explain';
+    propertyKey: string;
+};
+export interface ControlChildrenPolicy {
+    allowed: boolean;
+    excludes: string[] | false;
+    max?: number;
+}
+/**
+ * catalog 只保存可序列化事实，不保存 Designer/Runtime 构造器或 Vue 组件引用。
+ */
+export interface ControlDefinition {
+    type: string;
+    name: string;
+    description: string;
+    displayName: string;
+    /** controlName 源码声明的回退值：显式第三参数或 message key。 */
+    displayNameFallback: string;
+    /** 控件名对应的稳定消息 key；无旧 i18n key 时使用 catalog 生成的稳定 key。 */
+    displayNameMessageKey: string;
+    localizedDisplayNames: Record<string, string>;
+    baseType: ModelDrivenBaseControlType;
+    fieldType?: string;
+    propsSchema: JsonObject;
+    defaultProps: JsonObject;
+    /** 由真实 Designer.toSchema() 生成的纯 JSON 默认模板。 */
+    defaultSchema: HeadlessControlNode;
+    /** 显式传入空对象/空数组项时，真实嵌套构造器生成的局部模板。 */
+    explicitObjectDefaults: Record<string, JsonObject>;
+    explicitArrayItemDefaults: Record<string, JsonObject>;
+    explicitObjectGeneratedIdPaths: Record<string, Array<Array<string | number>>>;
+    explicitArrayItemGeneratedIdPaths: Record<string, Array<Array<string | number>>>;
+    /** 显式构造存在无法确定性表达的副作用，headless 对这些输入 fail-closed。 */
+    unsupportedExplicitProps: string[];
+    propertyNameMap: Record<string, string>;
+    settings: JsonObject[];
+    settingFacts: ControlSettingFact[];
+    eventKeys: string[];
+    children: ControlChildrenPolicy;
+    dynamicDefaults: ControlDynamicDefault[];
+}
+export interface ControlCatalogDocument {
+    schemaVersion: ControlCatalogSchemaVersion;
+    packageVersion: string;
+    revision: string;
+    sourceRevision: string;
+    localeMessages: Record<string, ControlLocaleMessageFact>;
+    controls: ControlDefinition[];
+}
+export interface ControlCatalogInfo {
+    schemaVersion: ControlCatalogSchemaVersion;
+    packageVersion: string;
+    revision: string;
+    sourceRevision: string;
+    size: number;
+}

package/dist/types/columnControls/ApprovalStatusColumn/property.d.ts

@@ -24,8 +24,23 @@ interface ApprovalStatusColumnPropertyInterface extends ColumnControlPropertyInt
     linkOperationOption: LinkOperationOption;
 }
 declare class ApprovalStatusColumnControlProperty extends ColumnControlProperty implements ApprovalStatusColumnPropertyInterface {
+    /**
+     * 行数设置
+     * @defaultValue 1
+     * @public
+     */
     lineEllipsis: number;
+    /**
+     * 是否显示链接操作
+     * @defaultValue false
+     * @public
+     */
     showLinkOperation: boolean;
+    /**
+     * 链接操作配置
+     * @defaultValue new LinkOperationOption()
+     * @public
+     */
     linkOperationOption: LinkOperationOption;
     constructor(props?: Partial<ApprovalStatusColumnControlProperty>);
 }

package/dist/types/columnControls/ArrayColumn/property.d.ts

@@ -48,10 +48,35 @@ interface ArrayColumnPropertyInterface extends ColumnControlPropertyInterface {
 }
 declare class ArrayColumnControlProperty extends ColumnControlProperty implements ArrayColumnPropertyInterface {
     static readonly Rules: typeof ArrayColumnControlPropertyRules;
+    /**
+     * 选项配置；取值：none：无；custom：自定义；datasource：数据源；
+     * @defaultValue 'none'
+     * @public
+     */
     optionConfig: 'none' | 'custom' | 'datasource';
+    /**
+     * 关联数据源
+     * @defaultValue new DataSourceBind()
+     * @public
+     */
     datasourceBind: DataSourceBind;
+    /**
+     * 是否显示链接操作
+     * @defaultValue false
+     * @public
+     */
     showLinkOperation: boolean;
+    /**
+     * 链接操作配置
+     * @defaultValue new LinkOperationOption()
+     * @public
+     */
     linkOperationOption: LinkOperationOption;
+    /**
+     * 自定义选项
+     * @defaultValue [{}]
+     * @public
+     */
     options: OptionSetting[];
     constructor(props?: Partial<ArrayColumnControlProperty>);
 }

package/dist/types/columnControls/AutoNumberColumn/property.d.ts

@@ -26,7 +26,17 @@ interface AutoNumberColumnPropertyInterface extends ColumnControlPropertyInterfa
  */
 declare class AutoNumberColumnControlProperty extends ColumnControlProperty implements AutoNumberColumnPropertyInterface {
     static readonly Rules: typeof AutoNumberColumnControlPropertyRules;
+    /**
+     * 是否显示链接操作
+     * @defaultValue false
+     * @public
+     */
     showLinkOperation: boolean;
+    /**
+     * 链接操作配置
+     * @defaultValue new LinkOperationOption()
+     * @public
+     */
     linkOperationOption: LinkOperationOption;
     constructor(props?: Partial<AutoNumberColumnControlProperty>);
 }

package/dist/types/columnControls/CustomColumn/designer.d.ts

@@ -1,4 +1,4 @@
-import { DesignerColumnControl, DesignerControl, SettingOption, ColumnControlSchema, DataBindModelType } from '@byteluck-fe/model-driven-core';
+import { DesignerColumnControl, SettingOption, ColumnControlSchema, DataBindModelType } from '@byteluck-fe/model-driven-core';
 import CustomColumnControlProperty from './property';
 declare class CustomColumnControl extends DesignerColumnControl {
     static readonly controlType = "custom-column";
@@ -11,7 +11,6 @@ declare class CustomColumnControl extends DesignerColumnControl {
     childrenMaxLength: number;
     static setting: SettingOption[];
     readonly props: CustomColumnControlProperty;
-    children: DesignerControl[];
     constructor(props?: ColumnControlSchema<'custom-column'>);
     judgeJoinChildren(type: string): boolean;
     toDataBindModel(parentId: string | null): DataBindModelType | DataBindModelType[] | undefined;