@byteluck-fe/model-driven-controls 7.0.0-props.1 → 7.0.0-props.100

package/dist/types/layoutControls/ListView/property.d.ts

@@ -1,10 +1,20 @@
+/**
+ * name: rok_list_view
+ * description: 列表视图组件。用于展示业务数据列表并驱动联动、子表和树形列表场景。支持数据源绑定、分页排序、行样式、关联关系、子列表触发和主从明细展示能力。
+ */
 import { RuleItem } from 'async-validator';
-import { LayoutControlProperty, PropertyRules, PropertyRuntimeRules, DataSourceBind, SubListPageConfig, JoinRelation, RowStyle, ListTreeData, MasterDetail } from '@byteluck-fe/model-driven-core';
+import { LayoutControlProperty, LayoutControlPropertyInterface, PropertyRules, PropertyRuntimeRules, DataSourceBind, SubListPageConfig, JoinRelation, RowStyle, ListTreeData, MasterDetail } from '@byteluck-fe/model-driven-core';
 /**
  * @internal
  */
 export declare enum TriggerType {
+    /**
+     * 点击整行
+     */
     CLICK_ROW = 1,
+    /**
+     * 点击单元格
+     */
     CLICK_CELL = 2
 }
 /**
@@ -26,11 +36,10 @@ declare class ListViewControlPropertyRules extends PropertyRules {
  * ListView 列表
  * @public
  */
-declare class ListViewControlProperty extends LayoutControlProperty {
-    static readonly Rules: typeof ListViewControlPropertyRules;
-    static readonly RuntimeRules: typeof ListViewControlPropertyRuntimeRules;
+interface ListViewPropertyInterface extends LayoutControlPropertyInterface {
     /**
      * 数据高级设置
+     * @defaultValue new DataSourceBind()
      * @public
      */
     datasourceBind: DataSourceBind;
@@ -47,31 +56,38 @@ declare class ListViewControlProperty extends LayoutControlProperty {
      */
     isShowSubList: boolean;
     /**
-     * 触发时机 1=整行，2=字段
+     * 触发时机 1=整行，2=字段；取值：1：点击整行；2：点击单元格；
      * @defaultValue 1
      * @public
      */
     triggerType: TriggerType;
     /**
      * 触发字段
+     * @defaultValue ''
      * @public
      */
     triggerFieldCode: string;
     /**
      * 抽屉内容配置
+     * @defaultValue new SubListPageConfig()
      * @public
      */
     sublistPage: SubListPageConfig;
     /**
      * 显示连接表
+     * @defaultValue false
+     * @public
      */
     isShowJoinRelation: boolean;
     /**
      * 连接表配置
+     * @defaultValue new JoinRelation()
      * @public
      */
     joinRelation: JoinRelation;
     /**
+     * 提供给关联单选中复用list-view的能力；取值：stretch：拉伸；shrink：收缩；
+     * @defaultValue 'stretch'
      * @internal
      */
     showType: 'stretch' | 'shrink';
@@ -88,8 +104,8 @@ declare class ListViewControlProperty extends LayoutControlProperty {
      */
     isFixedHeader: boolean;
     /**
-     * 显示选择框类型
-     * @defaultValue  undefined | 'multiple' | 'radio'
+     * 显示选择框类型；取值：multiple：多选；single：单选；
+     * @defaultValue 'multiple'
      * @public
      */
     selectionType: undefined | 'multiple' | 'single';
@@ -106,8 +122,8 @@ declare class ListViewControlProperty extends LayoutControlProperty {
      */
     isAllLoaded: boolean;
     /**
-     * 计数模式
-     * @defaultValue 'async'
+     * 计数模式；取值：sync：同步；async：异步；none：无；
+     * @defaultValue undefined
      * @public
      */
     countType?: 'sync' | 'async' | 'none';
@@ -119,21 +135,60 @@ declare class ListViewControlProperty extends LayoutControlProperty {
     countLimit?: number;
     /**
      * 行背景规则
-     * @defaultValue 'none'
+     * @defaultValue new RowStyle()
+     * @public
      */
     rowStyle: RowStyle;
     /**
      * 是否树状列表
      * @defaultValue false
+     * @public
      */
     isTreeData?: boolean;
     /**
      * 树状列表配置详情
+     * @defaultValue new ListTreeData()
+     * @public
+     */
+    treeData?: ListTreeData;
+    /**
+     * 是否开启嵌套列表
+     * @defaultValue false
+     * @public
+     */
+    isMasterDetail?: boolean;
+    /**
+     * 嵌套列表的关联表配置
+     * @defaultValue new MasterDetail()
+     * @public
      */
+    masterDetail?: MasterDetail;
+}
+declare class ListViewControlProperty extends LayoutControlProperty implements ListViewPropertyInterface {
+    static readonly Rules: typeof ListViewControlPropertyRules;
+    static readonly RuntimeRules: typeof ListViewControlPropertyRuntimeRules;
+    datasourceBind: DataSourceBind;
+    isLoading: boolean;
+    isShowSubList: boolean;
+    triggerType: TriggerType;
+    triggerFieldCode: string;
+    sublistPage: SubListPageConfig;
+    isShowJoinRelation: boolean;
+    joinRelation: JoinRelation;
+    showType: 'stretch' | 'shrink';
+    showFullScreen: boolean;
+    isFixedHeader: boolean;
+    selectionType: undefined | 'multiple' | 'single';
+    isShowSelection: boolean;
+    isAllLoaded: boolean;
+    countType?: 'sync' | 'async' | 'none';
+    countLimit?: number;
+    rowStyle: RowStyle;
+    isTreeData?: boolean;
     treeData?: ListTreeData;
     isMasterDetail?: boolean;
     masterDetail?: MasterDetail;
     constructor(props?: Partial<ListViewControlProperty>);
 }
 export default ListViewControlProperty;
-export { ListViewControlProperty, ListViewControlPropertyRules };
+export { ListViewControlProperty, ListViewPropertyInterface, ListViewControlPropertyRules };

package/dist/types/layoutControls/Page/property.d.ts

@@ -1,15 +1,47 @@
-import { LayoutControlProperty } from '@byteluck-fe/model-driven-core';
-declare class PageProperty extends LayoutControlProperty {
+/**
+ * name: rok_page
+ * description: 页面容器组件。用于定义整页内容区域的基础展示结构。支持隐藏页头、背景色、最小/最大宽度和高度填充策略设置。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface } from '@byteluck-fe/model-driven-core';
+interface PagePropertyInterface extends LayoutControlPropertyInterface {
+    /**
+     * 隐藏头
+     * @defaultValue false
+     * @public
+     */
     hideHeader: boolean;
+    /**
+     * 背景
+     * @defaultValue '#fff'
+     * @public
+     */
     background: string;
+    /**
+     * 最小宽度
+     * @defaultValue ''
+     * @public
+     */
     minWidth: number | '';
+    /**
+     * 最大宽度
+     * @defaultValue ''
+     * @public
+     */
     maxWidth: number | '';
     /**
-     * 最小高度
-     * auto指内容多高它多高
-     * fill指最小占一屏幕高
-     * */
+     * 最小高度；取值：auto：自动；fill：填充；
+     * @defaultValue 'auto'
+     * @public
+     */
+    heightConfig: 'auto' | 'fill';
+}
+declare class PageProperty extends LayoutControlProperty implements PagePropertyInterface {
+    hideHeader: boolean;
+    background: string;
+    minWidth: number | '';
+    maxWidth: number | '';
     heightConfig: 'auto' | 'fill';
     constructor(props?: Partial<PageProperty>);
 }
 export default PageProperty;
+export { PageProperty, PagePropertyInterface };

package/dist/types/layoutControls/Position/property.d.ts

@@ -1,5 +1,35 @@
-import { LayoutControlProperty } from '@byteluck-fe/model-driven-core';
-declare class PositionProperty extends LayoutControlProperty {
+/**
+ * name: rok_position
+ * description: 定位布局项组件。用于在定位容器中按坐标和占比放置内容。支持宽高占比以及顶部、左侧偏移，适合自由布局场景。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface } from '@byteluck-fe/model-driven-core';
+interface PositionPropertyInterface extends LayoutControlPropertyInterface {
+    /**
+     * 宽度占比
+     * @defaultValue 12
+     * @public
+     */
+    widthSpan: number;
+    /**
+     * 高度占比
+     * @defaultValue 12
+     * @public
+     */
+    heightSpan: number;
+    /**
+     * 左侧偏移
+     * @defaultValue 0
+     * @public
+     */
+    left: number;
+    /**
+     * 顶部偏移
+     * @defaultValue 0
+     * @public
+     */
+    top: number;
+}
+declare class PositionProperty extends LayoutControlProperty implements PositionPropertyInterface {
     widthSpan: number;
     heightSpan: number;
     left: number;
@@ -7,3 +37,4 @@ declare class PositionProperty extends LayoutControlProperty {
     constructor(props?: Partial<PositionProperty>);
 }
 export default PositionProperty;
+export { PositionProperty, PositionPropertyInterface };

package/dist/types/layoutControls/PositioningContainer/property.d.ts

@@ -1,5 +1,12 @@
-import { LayoutControlProperty } from '@byteluck-fe/model-driven-core';
-declare class PositioningContainerProperty extends LayoutControlProperty {
+/**
+ * name: rok_positioning_container
+ * description: 定位容器组件。用于承载自由摆放的定位布局内容。当前继承基础布局属性，适合与定位项配合搭建画布式页面。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface } from '@byteluck-fe/model-driven-core';
+interface PositioningContainerPropertyInterface extends LayoutControlPropertyInterface {
+}
+declare class PositioningContainerProperty extends LayoutControlProperty implements PositioningContainerPropertyInterface {
     constructor(props?: Partial<PositioningContainerProperty>);
 }
 export default PositioningContainerProperty;
+export { PositioningContainerProperty, PositioningContainerPropertyInterface };

package/dist/types/layoutControls/Row/property.d.ts

@@ -1,5 +1,35 @@
-import { LayoutControlProperty, Margin, Padding } from '@byteluck-fe/model-driven-core';
-declare class RowControlProperty extends LayoutControlProperty {
+/**
+ * name: rok_row
+ * description: 行布局容器组件。用于按行组织多个控件并进行横向编排。支持预设/自定义布局模式、间距、主侧轴对齐、内外边距和整行占满设置。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface, Margin, Padding } from '@byteluck-fe/model-driven-core';
+interface RowPropertyInterface extends LayoutControlPropertyInterface {
+    /**
+     * 布局模式；取值：select：选择预设布局；custom：自定义布局；
+     * @defaultValue 'select'
+     * @public
+     */
+    layoutMode: 'select' | 'custom';
+    /**
+     * 内边距配置
+     * @defaultValue new Padding()
+     * @public
+     */
+    padding: Padding;
+    /**
+     * 外边距配置
+     * @defaultValue new Margin()
+     * @public
+     */
+    margin: Margin;
+    /**
+     * 是否占满整行
+     * @defaultValue false
+     * @public
+     */
+    isFull: boolean;
+}
+declare class RowControlProperty extends LayoutControlProperty implements RowPropertyInterface {
     layoutMode: 'select' | 'custom';
     gutter: number;
     align: string;
@@ -10,4 +40,4 @@ declare class RowControlProperty extends LayoutControlProperty {
     constructor(props?: Partial<RowControlProperty>);
 }
 export default RowControlProperty;
-export { RowControlProperty };
+export { RowControlProperty, RowPropertyInterface };

package/dist/types/layoutControls/Step/property.d.ts

@@ -1,66 +1,96 @@
-import { LayoutControlProperty, StepButtons } from '@byteluck-fe/model-driven-core';
-declare class StepControlProperty extends LayoutControlProperty {
+/**
+ * name: rok_step
+ * description: 步骤条容器组件。用于分步骤表单、流程导航和向导式填写场景。支持方向、标签位置、尺寸、导航样式、粘性展示、步骤状态以及前后切换按钮配置。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface, StepButtons } from '@byteluck-fe/model-driven-core';
+interface StepPropertyInterface extends LayoutControlPropertyInterface {
     /**
      * 步骤条方向；horizontal：水平方向；vertical：垂直方向
-     * @defaultValue horizontal
+     * @defaultValue 'horizontal'
+     * @public
      */
     direction: 'horizontal' | 'vertical';
     /**
      * 标签放置位置；horizontal：水平方向；vertical：竖直方向
-     * @defaultValue horizontal
+     * @defaultValue 'horizontal'
+     * @public
      */
     labelPlacement: 'horizontal' | 'vertical';
     /**
-     * 大小；small：迷你； default：普通；
-     * @defaultValue default
+     * 大小；取值：small：小尺寸；default：默认尺寸；large：大尺寸；
+     * @defaultValue 'default'
+     * @public
      */
     size: 'small' | 'default' | 'large';
     /**
      * 步骤条类型；default：默认； navigation：导航
-     * @defaultValue default
+     * @defaultValue 'default'
+     * @public
      */
     type: 'default' | 'navigation';
     /**
      * 是否粘性
      * @defaultValue false
+     * @public
      */
     isSticky: boolean;
     /**
      * 步骤条间距，可输入%或px
-     * @defaultValue
+     * @defaultValue ''
+     * @public
      */
     step: string;
     /**
      * 是否居中对齐
      * @defaultValue false
+     * @public
      */
     isCenter: boolean;
     /**
      * 是否允许结束步骤点击
      * @defaultValue false
+     * @public
      */
     isStopStepClick: boolean;
     /**
      * 当前步骤的状态，wait：等待； process：进行中； finish：完成； error：错误；
-     * @defaultValue process
+     * @defaultValue 'process'
+     * @public
      */
     status: 'wait' | 'process' | 'finish' | 'error';
     /**
      * 结束步骤的状态，wait：等待； process：进行中； finish：完成； error：错误；
-     * @defaultValue finish
+     * @defaultValue 'finish'
+     * @public
      */
     stopStatus: 'wait' | 'process' | 'finish' | 'error';
     /**
      * 是否显示步骤条按钮
      * @defaultValue false
+     * @public
      */
     isShowStepButton: boolean;
     /**
      * 步骤条按钮配置
-     * @defaultValue {prev: {icon: 'iconleft', label: '上一步'}, next: {icon: 'iconxiangyou', label: '下一步'}, }
+     * @defaultValue new StepButtons()
+     * @public
      */
     stepButtons: StepButtons;
+}
+declare class StepControlProperty extends LayoutControlProperty implements StepPropertyInterface {
+    direction: 'horizontal' | 'vertical';
+    labelPlacement: 'horizontal' | 'vertical';
+    size: 'small' | 'default' | 'large';
+    type: 'default' | 'navigation';
+    isSticky: boolean;
+    step: string;
+    isCenter: boolean;
+    isStopStepClick: boolean;
+    status: 'wait' | 'process' | 'finish' | 'error';
+    stopStatus: 'wait' | 'process' | 'finish' | 'error';
+    isShowStepButton: boolean;
+    stepButtons: StepButtons;
     constructor(props?: Partial<StepControlProperty>);
 }
 export default StepControlProperty;
-export { StepControlProperty };
+export { StepControlProperty, StepPropertyInterface };

package/dist/types/layoutControls/StepPane/property.d.ts

@@ -1,5 +1,59 @@
-import { LayoutControlProperty } from '@byteluck-fe/model-driven-core';
-declare class StepPaneControlProperty extends LayoutControlProperty {
+/**
+ * name: rok_step_pane
+ * description: 步骤项组件。用于定义步骤条中的单个步骤内容与状态。支持标题、副标题、图标、颜色、状态、描述、禁用和默认选中设置。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface } from '@byteluck-fe/model-driven-core';
+interface StepPanePropertyInterface extends LayoutControlPropertyInterface {
+    /**
+     * 主标题
+     * @defaultValue ''
+     * @public
+     */
+    title: string;
+    /**
+     * 副标题
+     * @defaultValue ''
+     * @public
+     */
+    subTitle?: string;
+    /**
+     * 是否禁用点击
+     * @defaultValue false
+     * @public
+     */
+    disabled: boolean;
+    /**
+     * 步骤图标
+     * @defaultValue ''
+     * @public
+     */
+    icon: string;
+    /**
+     * 步骤激活颜色；取值：primary：主色；danger：危险；warning：警告；success：成功；info：信息；blue：蓝色；
+     * @defaultValue ''
+     * @public
+     */
+    color: string;
+    /**
+     * 步骤状态；取值：wait：等待；process：进行中；finish：完成；error：错误；
+     * @defaultValue 'wait'
+     * @public
+     */
+    status: 'wait' | 'process' | 'finish' | 'error';
+    /**
+     * 步骤描述
+     * @defaultValue ''
+     * @public
+     */
+    description?: string;
+    /**
+     * 是否默认选中
+     * @defaultValue false
+     * @public
+     */
+    isDefault?: boolean;
+}
+declare class StepPaneControlProperty extends LayoutControlProperty implements StepPanePropertyInterface {
     title: string;
     subTitle?: string;
     disabled: boolean;
@@ -11,4 +65,4 @@ declare class StepPaneControlProperty extends LayoutControlProperty {
     constructor(props?: Partial<StepPaneControlProperty>);
 }
 export default StepPaneControlProperty;
-export { StepPaneControlProperty, };
+export { StepPaneControlProperty, StepPanePropertyInterface, };

package/dist/types/layoutControls/SubTableColumn/property.d.ts

@@ -1,39 +1,62 @@
+/**
+ * name: rok_sub_table_column
+ * description: 子表列配置组件。用于定义明细子表中每列的标题与展示行为。支持列宽配置、固定列、标题提示和标题显隐控制。
+ */
 import { RuleItem } from 'async-validator';
-import { LayoutControlProperty, PropertyRules, MetaAutoWidth } from '@byteluck-fe/model-driven-core';
+import { LayoutControlProperty, LayoutControlPropertyInterface, PropertyRules, MetaAutoWidth } from '@byteluck-fe/model-driven-core';
 declare class SubTableColumnControlPropertyRules extends PropertyRules {
     caption: RuleItem;
     width: RuleItem;
     captionTip: RuleItem;
     constructor(props: SubTableColumnControlProperty);
 }
-declare class SubTableColumnControlProperty extends LayoutControlProperty {
-    static readonly Rules: typeof SubTableColumnControlPropertyRules;
+interface SubTableColumnPropertyInterface extends LayoutControlPropertyInterface {
     /**
      * 设置宽度在移动和pc - 宽度
-     * pc 电脑端   mobile -手机端
-     * */
+     * @defaultValue new MetaAutoWidth()
+     * @public
+     */
     metaAutoWidth: MetaAutoWidth;
     /**
      * 列标题
-     * */
+     * @defaultValue ''
+     * @public
+     */
     caption: string;
     /**
      * 是否固定列
-     * */
+     * @defaultValue false
+     * @public
+     */
     fixed: boolean;
     /**
      * 是否开启气泡提示
-     * */
+     * @defaultValue false
+     * @public
+     */
     isShowCaptionTip: boolean;
     /**
      * 气泡提示语
-     * */
+     * @defaultValue ''
+     * @public
+     */
     captionTip: string;
     /**
      * 隐藏标题一直为false
-     * */
+     * @defaultValue false
+     * @public
+     */
+    isHideCaption: boolean;
+}
+declare class SubTableColumnControlProperty extends LayoutControlProperty implements SubTableColumnPropertyInterface {
+    static readonly Rules: typeof SubTableColumnControlPropertyRules;
+    metaAutoWidth: MetaAutoWidth;
+    caption: string;
+    fixed: boolean;
+    isShowCaptionTip: boolean;
+    captionTip: string;
     isHideCaption: boolean;
     constructor(props?: Partial<SubTableColumnControlProperty>);
 }
 export default SubTableColumnControlProperty;
-export { SubTableColumnControlProperty, SubTableColumnControlPropertyRules };
+export { SubTableColumnControlProperty, SubTableColumnPropertyInterface, SubTableColumnControlPropertyRules };

package/dist/types/layoutControls/SubTableRow/property.d.ts

@@ -1,6 +1,12 @@
-import { LayoutControlProperty } from '@byteluck-fe/model-driven-core';
-declare class SubtableRowControlProperty extends LayoutControlProperty {
+/**
+ * name: rok_sub_table_row
+ * description: 子表行容器组件。用于组织明细子表中的单行布局内容。当前继承基础布局属性，适合与子表列共同构建明细结构。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface } from '@byteluck-fe/model-driven-core';
+interface SubtableRowPropertyInterface extends LayoutControlPropertyInterface {
+}
+declare class SubtableRowControlProperty extends LayoutControlProperty implements SubtableRowPropertyInterface {
     constructor(props?: Partial<SubtableRowControlProperty>);
 }
 export default SubtableRowControlProperty;
-export { SubtableRowControlProperty };
+export { SubtableRowControlProperty, SubtableRowPropertyInterface };

package/dist/types/layoutControls/Tab/property.d.ts

@@ -1,31 +1,47 @@
-import { LayoutControlProperty } from '@byteluck-fe/model-driven-core';
-declare class TabControlProperty extends LayoutControlProperty {
+/**
+ * name: rok_tab
+ * description: 选项卡容器组件。用于将内容分为多个页签按需切换展示。支持移动端展示方式、线条/卡片风格、页签位置、标签撑开和内容延迟渲染。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface } from '@byteluck-fe/model-driven-core';
+interface TabPropertyInterface extends LayoutControlPropertyInterface {
     /**
-     * 移动端展示样式
-     * @defaultValue vertical
+     * 移动端展示样式；取值：horizontal：横向；vertical：纵向；
+     * @defaultValue 'vertical'
+     * @public
      */
     mobileShowType: 'horizontal' | 'vertical';
     /**
      * 风格类型，line：默认样式；card：选项卡样式；
-     * @defaultValue line
+     * @defaultValue 'line'
+     * @public
      */
     type: 'line' | 'card';
     /**
      * 页签位置，top：页签在上；bottom：页签在下；left：页签在左侧；right：页签在右侧；
-     * @defaultValue top
+     * @defaultValue 'top'
+     * @public
      */
     tabPosition: 'top' | 'bottom' | 'left' | 'right';
     /**
      * 页签宽度是否自动撑开
      * @defaultValue false
+     * @public
      */
     isLabelFlat: boolean;
     /**
      * 内容是否延迟渲染
      * @defaultValue false
+     * @public
      */
     isDelay: boolean;
+}
+declare class TabControlProperty extends LayoutControlProperty implements TabPropertyInterface {
+    mobileShowType: 'horizontal' | 'vertical';
+    type: 'line' | 'card';
+    tabPosition: 'top' | 'bottom' | 'left' | 'right';
+    isLabelFlat: boolean;
+    isDelay: boolean;
     constructor(props?: Partial<TabControlProperty>);
 }
 export default TabControlProperty;
-export { TabControlProperty };
+export { TabControlProperty, TabPropertyInterface };

package/dist/types/layoutControls/TabPane/property.d.ts

@@ -1,13 +1,25 @@
-import { LayoutControlProperty, PropertyRules } from '@byteluck-fe/model-driven-core';
+/**
+ * name: rok_tab_pane
+ * description: 选项卡子页签组件。用于承载单个页签对应的内容区域。支持配置页签标题，适合与选项卡容器组合实现分组切换展示。
+ */
+import { LayoutControlProperty, LayoutControlPropertyInterface, PropertyRules } from '@byteluck-fe/model-driven-core';
 import { RuleItem } from 'async-validator';
 declare class TabPaneControlPropertyRules extends PropertyRules {
     caption: RuleItem;
     constructor(props: TabPaneControlProperty);
 }
-declare class TabPaneControlProperty extends LayoutControlProperty {
+interface TabPanePropertyInterface extends LayoutControlPropertyInterface {
+    /**
+     * 标题
+     * @defaultValue 控件名称
+     * @public
+     */
+    caption: string;
+}
+declare class TabPaneControlProperty extends LayoutControlProperty implements TabPanePropertyInterface {
     static readonly Rules: typeof TabPaneControlPropertyRules;
     caption: string;
     constructor(props?: Partial<TabPaneControlProperty>);
 }
 export default TabPaneControlProperty;
-export { TabPaneControlProperty, TabPaneControlPropertyRules };
+export { TabPaneControlProperty, TabPaneControlPropertyRules, TabPanePropertyInterface };