@dazhicheng/ui 1.5.99 → 1.5.101

package/dist/api/dataTypeContext.d.ts

@@ -0,0 +1,4 @@
+/** 此处后端没有提供注释 POST /dataTypeContext/queryDataPermissionDetail */
+export declare function queryDataPermissionDetailDataTypeContext(params: IamAPI.UserDataPermissionQueryParam, options?: {
+    [key: string]: any;
+}): Promise<IamAPI.DataPermissionDetailDTO[]>;

package/dist/components/tt-form/src/types/forms.d.ts

@@ -4,6 +4,7 @@ import { ComputedRef, MaybeRef, MaybeRefOrGetter, Ref } from 'vue';
 import { FlattenAndSetPathsType, GenericObject, MapValuesPathsToRefs, MaybeArray, MaybePromise } from './common';
 import { Path, PathValue } from './paths';
 import { FieldValidationMetaInfo } from './shared';
+import { Recordable } from '../../../../../../utils/src';
 export type ValidationResult<TValue = unknown> = {
     errors: string[];
     valid: boolean;
@@ -86,13 +87,13 @@ export type PathState<TInput = unknown, TOutput = TInput> = {
     };
     validate?: FieldValidator<TOutput>;
 };
-export type FieldEntry<TValue = unknown> = {
+export type FieldEntry<TValue = Recordable> = {
     value: TValue;
     key: string | number;
     isFirst: boolean;
     isLast: boolean;
 };
-export type FieldArrayContext<TValue = unknown> = {
+export type FieldArrayContext<TValue = Recordable> = {
     fields: FieldEntry<TValue>[];
     remove: (idx: number) => void;
     replace: (newArray: TValue[]) => void;

package/dist/components/tt-form/src/types.d.ts

@@ -58,6 +58,7 @@ export type MaybeComponentPropKey = "options" | "placeholder" | "title" | keyof
 export type MaybeComponentProps = {
     [K in MaybeComponentPropKey]?: any;
 };
+/** 数组操作方法 */
 export interface FormArrayActions {
     get: <TValue = unknown>(name: string) => Readonly<FieldArrayContext<TValue>> | undefined;
     push: <TValue = unknown>(name: string, value: TValue) => void;

package/dist/hooks/useFormSchemasLink.d.ts

@@ -0,0 +1,152 @@
+import { TtFormSchema } from '../components/tt-form';
+import { Recordable } from '../../../utils/src';
+import { MaybeRef, Ref } from 'vue';
+/**
+ * 数据权限接口支持的联动数据类型。
+ *
+ * - platformId：平台
+ * - shopId：店铺，默认会跟随平台值联动过滤
+ * - purchasePlaceId：采购地
+ * - businessType：业务线
+ * - lockUserId：锁单人
+ */
+export type DataType = "platformId" | "shopId" | "purchasePlaceId" | "businessType" | "lockUserId";
+/**
+ * 表单使用场景。
+ *
+ * list 用于查询筛选场景；action 用于新增、编辑等操作场景。
+ * action 场景下，当平台选择“全部”或选择多个平台时，店铺字段会被禁用并改为非必填。
+ */
+export type FormScene = "list" | "action";
+type FieldComponentProps = Recordable | ((values: Recordable, actions: any, options: SelectOption[]) => Recordable);
+type FieldSchemaConfig = Partial<TtFormSchema> | ((schema: TtFormSchema, dataType: DataType) => TtFormSchema);
+/**
+ * 字段 onChange 回调上下文。
+ *
+ * 业务侧通过 field(dataType, { onChange }) 追加字段变更逻辑时，
+ * 可以从这里拿到当前表单值、表单操作对象、字段名、原始选项和当前选中项。
+ */
+export interface FieldOnChangeContext {
+    /** 当前表单值对象 */
+    values: Recordable;
+    /** 表单渲染器透出的操作对象 */
+    actions: any;
+    /** 当前字段最终绑定的字段名，已合并 fieldName 自定义配置 */
+    fieldName: string;
+    /** 当前触发变更的数据类型 */
+    dataType: DataType;
+    /** 当前字段可选项 */
+    options: SelectOption[];
+    /** 当前选中项。多选时为数组，单选时为单个选项。 */
+    currentOption: SelectOption[] | SelectOption | undefined;
+}
+/**
+ * 单个联动字段的覆盖配置。
+ *
+ * 该配置通过 builder.field(dataType, config) 传入，用于覆盖默认字段名、标签、
+ * 组件 props、校验规则、依赖关系和追加 onChange 行为。
+ */
+export interface UseFormSchemasLinkFieldConfig {
+    /** 业务中实际需要绑定的字段名称 */
+    fieldName?: string;
+    /** 业务中实际需要绑定的label名称 */
+    label?: string;
+    /** 是否多选 默认多选 */
+    multiple?: boolean;
+    /** 多选时是否折叠 tag，默认 true */
+    collapseTags?: boolean;
+    /** 透传给 ElSelectV2 的 props；传函数时会在渲染时接收表单值、操作对象和当前选项 */
+    componentProps?: FieldComponentProps;
+    /** 追加或覆盖 TtFormSchema.dependencies */
+    dependencies?: TtFormSchema["dependencies"];
+    /** 字段值变化后的追加回调。默认联动逻辑会先执行，再执行该回调。 */
+    onChange?: (values: unknown, context: FieldOnChangeContext) => void;
+    /** 字段校验规则 */
+    rules?: TtFormSchema["rules"];
+    /** 是否在当前字段选项前追加“全部”，默认 true */
+    showAll?: boolean;
+}
+/**
+ * useFormSchemasLink 的批量配置。
+ *
+ * 可以通过 fromOptions(options) 一次性传入，也可以使用 builder 链式方法逐项配置。
+ */
+export interface UseFormSchemasLinkOptions {
+    /** 表单场景，默认 list */
+    scene?: FormScene;
+    /** 外部数据源。未传时会按 codes 调用 queryDataPermissionDetailDataTypeContext。 */
+    dataSource?: MaybeRef<IamAPI.DataPermissionDetailDTO[] | undefined>;
+    /** 字段级配置，key 为 DataType */
+    fieldConfigs?: Partial<Record<DataType, UseFormSchemasLinkFieldConfig>>;
+    /** Schema 级覆盖。传函数时可基于默认 schema 做增量修改。 */
+    schemas?: Partial<Record<DataType, FieldSchemaConfig>>;
+}
+/**
+ * ElSelectV2 消费的统一选项结构。
+ */
+export type SelectOption = Recordable & {
+    /** 展示文案 */
+    label: string;
+    /** 选项值 */
+    value: string | number;
+    /** 店铺所属平台 id，用于平台和店铺联动过滤 */
+    platformId?: string | number;
+};
+/**
+ * 构建后的表单 schema 集合。
+ *
+ * 返回值会包含每个 DataType 对应的 TtFormSchema，以及当前已归一化的下拉数据源。
+ */
+type UseFormSchemasLinkResult = Record<DataType, TtFormSchema> & {
+    dataSource: Ref<Record<DataType, SelectOption[]>>;
+};
+type FormSchemasLinkBuilder = {
+    /** 设置为查询筛选场景 */
+    list(): FormSchemasLinkBuilder;
+    /** 设置为新增、编辑等操作场景 */
+    action(): FormSchemasLinkBuilder;
+    /** 设置表单场景 */
+    scene(scene: FormScene): FormSchemasLinkBuilder;
+    /** 指定需要请求和构建的字段类型，默认包含全部 DataType */
+    codes(codes: DataType[]): FormSchemasLinkBuilder;
+    /** 使用外部数据源，跳过内部接口请求 */
+    dataSource(dataSource: MaybeRef<IamAPI.DataPermissionDetailDTO[] | undefined>): FormSchemasLinkBuilder;
+    /** 覆盖单个字段配置 */
+    field(dataType: DataType, config: UseFormSchemasLinkFieldConfig): FormSchemasLinkBuilder;
+    /** 覆盖单个字段的完整 schema 或基于默认 schema 做增量修改 */
+    schema(dataType: DataType, schema: FieldSchemaConfig): FormSchemasLinkBuilder;
+    /** 批量合并配置 */
+    fromOptions(options: UseFormSchemasLinkOptions): FormSchemasLinkBuilder;
+    /** 生成最终 schema 和数据源 */
+    build(): UseFormSchemasLinkResult;
+};
+/**
+ * 构建数据权限相关的表单联动 schema。
+ *
+ * 调用 build() 后会生成平台、店铺、采购地、
+ * 业务线、锁单人的默认 TtFormSchema，并自动处理以下逻辑：
+ * - 未传 dataSource 时按 codes 请求数据权限下拉数据
+ * - 以 route.meta.permissionOnlyCode 和 route.path 为 key 缓存数据源
+ * - 平台变更时清空店铺值，并按平台过滤店铺选项
+ * - 多选字段支持“全部”互斥选择逻辑
+ * - action 场景下平台为“全部”或多平台时禁用店铺并取消必填
+ *
+ * @example
+ * ```ts
+ * const { platformId, shopId, businessType } = useFormSchemasLink()
+ *   .list()
+ *   .codes(["platformId", "shopId", "businessType"])
+ *   .field("platformId", {
+ *     fieldName: "platformIds",
+ *     label: "平台",
+ *     onChange(value, context) {
+ *       console.log(value, context.currentOption);
+ *     },
+ *   })
+ *   .build();
+ *
+ * const schemas = [platformId, shopId, businessType];
+ * ```
+ */
+export declare function useFormSchemasLink(): FormSchemasLinkBuilder;
+export {};

package/dist/index.d.ts

@@ -21,6 +21,7 @@ export * from './components/tt-upload';
 export * from './components/tt-nav-anchor';
 export * from './components/tt-api-component';
 export * from './components/tt-log';
+export { useFormSchemasLink } from './hooks/useFormSchemasLink';
 export { useFormat } from './hooks/useFormat';
 export { useLoading } from './hooks/useLoading';
 export { setXHR };