jgy-public-component 0.0.46 → 0.0.48

package/README.md

@@ -56,10 +56,13 @@ import 'jgy-public-component/dist/style.css'
 | JProductDetailDialog / JSkuLink | 产品详情 / SKU 链接（需注入 request） |
 | DocNoLink / DocDetailHost | 单号链接 + 全局单据详情（需 createDocDetail 注册） |
 | JRelatedDocs | 关联单据子 Tab 容器（需 createRelatedDocs 注入接口） |
+| JApprovalFlow / JApprovalActions | 审批进度 + 底部操作（审核/转审/回退/加签，需注入 request） |
 
 工具方法：数据转换、按钮权限、状态条数 / Tabs、`exportStyledExcel` 前端导出 Excel、路由守卫。
 
-> 完整 Props / 事件 / 插槽、业务组件接入步骤与排错，见 [`docs/index.html`](docs/index.html)（可离线打开）。
+> 完整 Props / 事件 / 插槽、业务组件接入步骤与排错，见 [`docs/index.html`](docs/index.html)（可离线打开）。  
+> 列表筛选四件套（`JListSearchHeader` / `JRemoteSelect` / `JSupplierCycleSelect` / `JSupplierCycleDisplay`）见 [`docs/JListSearchHeader-JRemoteSelect-JSupplierCycle-使用文档.md`](docs/JListSearchHeader-JRemoteSelect-JSupplierCycle-使用文档.md)。  
+> 审批进度 `JApprovalFlow` 见 [`docs/JApprovalFlow-使用文档.md`](docs/JApprovalFlow-使用文档.md)。
 
 ### JListSearchHeader 快速示例
 

package/dist/components/JApprovalFlow/JApprovalActions.d.ts

@@ -0,0 +1,3 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const _default: DefineComponent<{}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/JApprovalFlow/JApprovalAddSignDialog.d.ts

@@ -0,0 +1,28 @@
+import { DefineComponent, ExtractPropTypes, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, PropType } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+    addSignPrepare?: Record<string, any> | null;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    success: () => void;
+    "update:visible": (value: boolean) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+    addSignPrepare?: Record<string, any> | null;
+}>>> & Readonly<{
+    onSuccess?: (() => any) | undefined;
+    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/JApprovalFlow/JApprovalAuditDialog.d.ts

@@ -0,0 +1,26 @@
+import { DefineComponent, ExtractPropTypes, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, PropType } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    success: () => void;
+    "update:visible": (value: boolean) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+}>>> & Readonly<{
+    onSuccess?: (() => any) | undefined;
+    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/JApprovalFlow/JApprovalFlow.d.ts

@@ -1,4 +1,5 @@
-import { DefineComponent, ExtractPropTypes, Ref, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+import { PropType, DefineComponent, ExtractPropTypes, Ref, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+
 declare const _default: DefineComponent<ExtractPropTypes<{
     process_code: {
         type: StringConstructor;
@@ -9,18 +10,28 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         default: string;
     };
     request: {
-        type: FunctionConstructor;
+        type: PropType<(config: any) => Promise<any>>;
         default: null;
     };
+    hideHeader: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    hideActions: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>, {
     logs: Ref<any[], any[]>;
     raw: Ref<any, any>;
     loading: Ref<boolean, boolean>;
+    instance: Ref<any, any>;
     fetchLogs: () => Promise<void>;
+    fetchInstance: () => Promise<void>;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     success: (...args: any[]) => void;
-    loaded: (...args: any[]) => void;
     error: (...args: any[]) => void;
+    loaded: (...args: any[]) => void;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
     process_code: {
         type: StringConstructor;
@@ -31,16 +42,26 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         default: string;
     };
     request: {
-        type: FunctionConstructor;
+        type: PropType<(config: any) => Promise<any>>;
         default: null;
     };
+    hideHeader: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    hideActions: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>> & Readonly<{
     onSuccess?: ((...args: any[]) => any) | undefined;
-    onLoaded?: ((...args: any[]) => any) | undefined;
     onError?: ((...args: any[]) => any) | undefined;
+    onLoaded?: ((...args: any[]) => any) | undefined;
 }>, {
     process_code: string;
     business_key: string;
-    request: Function;
+    request: (config: any) => Promise<any>;
+    hideHeader: boolean;
+    hideActions: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/JApprovalFlow/JApprovalReturnDialog.d.ts

@@ -0,0 +1,28 @@
+import { DefineComponent, ExtractPropTypes, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, PropType } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+    returnPrepare?: Record<string, any> | null;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    success: () => void;
+    "update:visible": (value: boolean) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+    returnPrepare?: Record<string, any> | null;
+}>>> & Readonly<{
+    onSuccess?: (() => any) | undefined;
+    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/JApprovalFlow/JApprovalTransferDialog.d.ts

@@ -0,0 +1,28 @@
+import { DefineComponent, ExtractPropTypes, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, PropType } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+    transferPrepare?: Record<string, any> | null;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    success: () => void;
+    "update:visible": (value: boolean) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    visible: boolean;
+    processCode: string;
+    businessKey: string;
+    transferPrepare?: Record<string, any> | null;
+}>>> & Readonly<{
+    onSuccess?: (() => any) | undefined;
+    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/JApprovalFlow/apiPaths.d.ts

@@ -1,4 +1,22 @@
-/** 审批流程日志（process_code + business_key） */
+/** 审批流程日志（入参 process_code + business_key，按节点返回 users） */
 export declare const APPROVAL_FLOW_LOGS_URL = "/workhome-app/index/approvalInstance/flowLogs";
-/** 审核通过 / 驳回（先内置，时间线操作后续再用） */
+/** 审批实例列表（取 status / transfer_prepare / return_prepare / add_sign_prepare / can_cancel，决定底部按钮显隐） */
+export declare const APPROVAL_INSTANCE_LIST_URL = "/workhome-app/index/approvalInstance/list";
+/** 审核：通过 approved / 驳回 rejected（意见必填） */
 export declare const APPROVAL_AUDIT_URL = "/workhome-app/index/approvalInstance/audit";
+/** 转审前置校验（can_transfer、mode=self|proxy、pending_handlers） */
+export declare const APPROVAL_TRANSFER_PREPARE_URL = "/workhome-app/index/approvalInstance/transferPrepare";
+/** 转审提交（transfer_user，管理员代转需带 task_id） */
+export declare const APPROVAL_TRANSFER_URL = "/workhome-app/index/approvalInstance/transfer";
+/** 回退前置校验（can_return、上一节点 prev_node_name、pending_handlers） */
+export declare const APPROVAL_RETURN_PREPARE_URL = "/workhome-app/index/approvalInstance/returnPrepare";
+/** 回退至上一审批节点（本人回退 comment 必填，代退需 task_id） */
+export declare const APPROVAL_RETURN_URL = "/workhome-app/index/approvalInstance/returnPrevious";
+/** 加签前置校验（can_add_sign、current_node_name、exclude_users） */
+export declare const APPROVAL_ADD_SIGN_PREPARE_URL = "/workhome-app/index/approvalInstance/addSignPrepare";
+/** 当前节点加签（add_sign_user，代加签需 task_id） */
+export declare const APPROVAL_ADD_SIGN_URL = "/workhome-app/index/approvalInstance/addSign";
+/** 取消审批（发起人或有权限时终止流程） */
+export declare const APPROVAL_CANCEL_URL = "/workhome-app/index/approvalInstance/cancel";
+/** 转审/加签选人（用户列表 username + name） */
+export declare const APPROVAL_USER_LIST_URL = "/rms-app/comm/user/list";

package/dist/components/JApprovalFlow/index.d.ts

@@ -1,2 +1,5 @@
 export { default as JApprovalFlow } from './JApprovalFlow';
-export { APPROVAL_FLOW_LOGS_URL, APPROVAL_AUDIT_URL } from './apiPaths';
+export { default as JApprovalActions } from './JApprovalActions';
+export { createApprovalFlow, useApprovalFlow, J_APPROVAL_FLOW_KEY, J_DOC_APPROVAL_BUSINESS_KEY, J_DOC_APPROVAL_PROCESS_CODE, J_DOC_APPROVAL_SHOW_ACTIONS, } from './useApprovalFlow';
+export type { ApprovalFlowApi } from './useApprovalFlow';
+export { APPROVAL_FLOW_LOGS_URL, APPROVAL_AUDIT_URL, APPROVAL_INSTANCE_LIST_URL, } from './apiPaths';

package/dist/components/JApprovalFlow/useApprovalFlow.d.ts

@@ -0,0 +1,43 @@
+import { ComputedRef, InjectionKey, MaybeRefOrGetter, Ref } from 'vue';
+
+export type ApprovalFlowApi = {
+    process_code: ComputedRef<string>;
+    business_key: ComputedRef<string>;
+    loading: Ref<boolean>;
+    logs: Ref<any[]>;
+    raw: Ref<any>;
+    instance: Ref<any>;
+    auditVisible: Ref<boolean>;
+    transferVisible: Ref<boolean>;
+    returnVisible: Ref<boolean>;
+    addSignVisible: Ref<boolean>;
+    canShowAudit: ComputedRef<boolean>;
+    canShowTransfer: ComputedRef<boolean>;
+    canShowReturn: ComputedRef<boolean>;
+    canShowAddSign: ComputedRef<boolean>;
+    canShowCancel: ComputedRef<boolean>;
+    hasActions: ComputedRef<boolean>;
+    handleCancel: () => Promise<void>;
+    handleActionSuccess: () => void;
+    loadFlow: () => void;
+    fetchLogs: () => Promise<void>;
+    fetchInstance: () => Promise<void>;
+};
+export declare const J_APPROVAL_FLOW_KEY: InjectionKey<ApprovalFlowApi>;
+/** DocDetailHost 注入：审批 flow logs 用 business_key，与单据详情单号分开 */
+export declare const J_DOC_APPROVAL_BUSINESS_KEY: InjectionKey<ComputedRef<string>>;
+/** DocDetailHost 注入：AIOP 行上的 process_code（同一详情可对应多个流程） */
+export declare const J_DOC_APPROVAL_PROCESS_CODE: InjectionKey<ComputedRef<string>>;
+/** DocDetailHost 注入：是否展示底部审批按钮（查看 false / 审批 true） */
+export declare const J_DOC_APPROVAL_SHOW_ACTIONS: InjectionKey<ComputedRef<boolean>>;
+export declare function createApprovalFlow(options: {
+    process_code: MaybeRefOrGetter<string>;
+    business_key: MaybeRefOrGetter<string>;
+    /** 为 false 时不打 flowLogs / instance。单据详情未接入审批或未传入 process_code 时应关掉 */
+    enabled?: MaybeRefOrGetter<boolean>;
+    request?: ((config: any) => Promise<any>) | null;
+    onSuccess?: () => void;
+    onLoaded?: (logs: any[], raw: any) => void;
+    onError?: (msg: string) => void;
+}): ApprovalFlowApi;
+export declare function useApprovalFlow(): ApprovalFlowApi;

package/dist/components/JApprovalFlow/useApprovalHttp.d.ts

@@ -0,0 +1,7 @@
+export declare const isOkFlag: (value: unknown) => value is true | 1 | "1" | "true";
+export declare function useApprovalHttp(): (config: {
+    url: string;
+    method?: string;
+    data?: any;
+    params?: any;
+}) => Promise<any>;

package/dist/components/JDocDetail/apiPaths.d.ts

@@ -52,6 +52,30 @@ export declare const DOC_DETAIL_API: {
         url: string;
         param: string;
     };
+    appointment: {
+        url: string;
+        param: string;
+    };
+    supplier: {
+        url: string;
+        param: string;
+    };
+    supplierProductProfile: {
+        url: string;
+        param: string;
+    };
+    supplierProductQuote: {
+        url: string;
+        param: string;
+    };
+    supplierProfileChange: {
+        url: string;
+        param: string;
+    };
+    logisticsProvider: {
+        url: string;
+        param: string;
+    };
     purchase: {
         url: string;
         param: string;
@@ -80,9 +104,37 @@ export declare const DOC_DETAIL_API: {
         url: string;
         param: string;
     };
+    frameContract: {
+        url: string;
+        param: string;
+    };
+    purchaseBudget: {
+        url: string;
+        param: string;
+    };
+    fbaShipPlan: {
+        url: string;
+        param: string;
+    };
+    tmsPayment: {
+        url: string;
+        param: string;
+    };
+    inventoryAdjust: {
+        url: string;
+        param: string;
+    };
+    replenishmentPlan: {
+        url: string;
+        param: string;
+    };
 };
 /** 合同详情第二步（用列表拿到的 id） */
 export declare const PURCHASE_CONTRACT_DETAIL_URL = "/scm-app/comm/PurchaseContract/queryContract";
+/** 采购预算列表兜底（queryBudget 无数据时按 id 取一条） */
+export declare const PURCHASE_BUDGET_LIST_URL = "/scm-app/comm/PurchaseBudget/budgetList";
+/** FBA 发货计划列表兜底（getDetail 无数据时按 plan_no 取一条再查详情） */
+export declare const FBA_SHIP_PLAN_LIST_URL = "/inbound-app/admin/shippingPlan/list";
 /** 打开详情后，按 Tab / 附属数据再打的接口 */
 export declare const DOC_EXTRA_API: {
     skuDetail: {
@@ -136,6 +188,14 @@ export declare const DOC_EXTRA_API: {
         url: string;
         param: string;
     };
+    inventoryAdjustLogs: {
+        url: string;
+        param: string;
+    };
+    replenishmentPlanLogs: {
+        url: string;
+        param: string;
+    };
 };
 /** 关联单据列表。入参字段由各详情里的 relatedDocTypes.paramKey 决定，这里只收 URL */
 export declare const RELATED_DOC_API: {

package/dist/components/JDocDetail/fetch.d.ts

@@ -1,6 +1,11 @@
 export declare function postDoc(url: string, data?: any): Promise<any>;
 /** 按单据 type 打详情。合同 / 送货单现网是先列表再取一条。 */
 export declare function fetchDocByType(type: string, orderNo: string): Promise<any>;
+export declare function fetchInventoryAdjustLogs(orderId: string | number): Promise<{
+    code: any;
+    data: any[];
+    msg: any;
+}>;
 export declare function fetchSkuDetail(skuCode: string): Promise<any>;
 export declare function fetchActionLogList(params: any): Promise<any>;
 export declare function fetchPurchaseItemList(purchaseNo: string): Promise<any>;
@@ -26,6 +31,14 @@ export declare function fetchDeliveryDocPurchaseItems(deliveryNo: string): Promi
     data: any[];
     msg: any;
 }>;
+export declare function fetchReceiptVoucherLogs(params: {
+    id?: string | number;
+    receipt_voucher_no: string;
+}): Promise<{
+    code: any;
+    data: any[];
+    msg: any;
+}>;
 export declare function fetchDeliveryDocProductTags(deliveryNo: string): Promise<{
     code: any;
     data: any[];

package/dist/components/JDocDetail/index.d.ts

@@ -10,11 +10,11 @@
  * WMS 可直接用 wmsDocDetailComponents 作为 components。
  */
 export type { DocDetailType, DocDetailAdapters, DocDetailRegistryItem, DocDetailComponents, CreateDocDetailOptions, DocDetailViewOptions, PurchaseOrderTabName, } from './types';
-export { createDocDetail, registerDocDetail, getDocDetailRegistry, getDocDetailAdapters, getDocDetailViewOptions, getApprovalProcessCode, hasApprovalFlow, getDocDetailEntry, isDocDetailInitialized, } from './registry';
+export { createDocDetail, registerDocDetail, getDocDetailRegistry, getDocDetailAdapters, getDocDetailViewOptions, getApprovalProcessCode, hasApprovalFlow, getDocTypeByProcessCode, getDocDetailEntry, isDocDetailInitialized, } from './registry';
 export { useDocDetailStore } from './store';
 export { provideDocRequest, setDocRequest, getDocRequest } from './request';
 export type { JDocRequestFn } from './request';
 export { DOC_DETAIL_API, DOC_EXTRA_API, RELATED_DOC_API, PURCHASE_CONTRACT_DETAIL_URL, } from './apiPaths';
 export { default as DocNoLink } from './DocNoLink';
 export { default as DocDetailHost } from './DocDetailHost';
-export { wmsDocDetailComponents, ReceiptOrderDetailView, QcOrderDetailView, InboundOrderDetailView, PutawayOrderDetailView, DeliveryOrderDetailView, TransferOrderDetailView, WorkOrderDetailView, AbnormalOrderDetailView, PaymentRequestDetailView, ReturnOrderDetailView, CostExpenseDetailView, ReceiptVoucherDetailView, PurchaseOrderDetailView, PurchasePlanDetailView, PurchaseContractDetailView, DeliveryDocDetailView, StockTakeOrderDetailView, PackingTaskDetailView, TransportOrderDetailView, } from './wmsViews';
+export { wmsDocDetailComponents, ReceiptOrderDetailView, QcOrderDetailView, InboundOrderDetailView, PutawayOrderDetailView, DeliveryOrderDetailView, TransferOrderDetailView, WorkOrderDetailView, AbnormalOrderDetailView, PaymentRequestDetailView, ReturnOrderDetailView, CostExpenseDetailView, ReceiptVoucherDetailView, PurchaseOrderDetailView, PurchasePlanDetailView, PurchaseContractDetailView, FrameContractDetailView, PurchaseBudgetDetailView, DeliveryDocDetailView, StockTakeOrderDetailView, PackingTaskDetailView, TransportOrderDetailView, AppointmentOrderDetailView, SupplierDetailView, SupplierProductProfileAuditView, SupplierProductQuoteAuditView, SupplierProfileChangeAuditView, LogisticsProviderDetailView, FbaShipPlanDetailView, TmsPaymentRequestDetailView, InventoryAdjustDetailView, ReplenishmentPlanDetailView, } from './wmsViews';

package/dist/components/JDocDetail/registry.d.ts

@@ -21,6 +21,7 @@ export declare function getDocDetailAdapters(): DocDetailAdapters;
 export declare function getDocDetailViewOptions(): DocDetailViewOptions;
 export declare function getApprovalProcessCode(type: string): string;
 export declare function hasApprovalFlow(type: string): boolean;
+export declare function getDocTypeByProcessCode(processCode: string): string;
 export declare function isDocDetailInitialized(): boolean;
 export declare function getDocDetailEntry(type: string): {
     component: Component;

package/dist/components/JDocDetail/store.d.ts

@@ -4,28 +4,42 @@ import { Ref } from 'vue';
 
 /**
  * 全局单据详情状态
- * 业务页：DocNoLink / store.open(type, orderNo)
+ * 业务页：DocNoLink / store.open(type, orderNo, businessKey?, processCode?, showApprovalActions?)
  * 宿主：DocDetailHost 按 registry 渲染
+ *
+ * orderNo：业务单号（AIOP 的 business_no），打单据详情接口
+ * businessKey：审批实例键（AIOP 的 business_key），只给 JApprovalFlow / flow logs
+ * processCode：明确传入才拉审批进度（DocNoLink 不传则只有单据）
+ * showApprovalActions：true 时底部才出审核/转审/回退/加签（AIOP「审批」入口）
  */
 export declare const useDocDetailStore: StoreDefinition<"jgyDocDetail", Pick<{
     visible: Ref<boolean, boolean>;
     type: Ref<string, string>;
     orderNo: Ref<string, string>;
-    open: (docType: DocDetailType, no: string) => Promise<void>;
+    businessKey: Ref<string, string>;
+    processCode: Ref<string, string>;
+    showApprovalActions: Ref<boolean, boolean>;
+    open: (docType: DocDetailType, no: string, approvalKey?: string, approvalProcessCode?: string, withApprovalActions?: boolean) => Promise<void>;
     close: () => void;
     reset: () => void;
-}, "type" | "orderNo" | "visible">, Pick<{
+}, "type" | "visible" | "processCode" | "businessKey" | "orderNo" | "showApprovalActions">, Pick<{
     visible: Ref<boolean, boolean>;
     type: Ref<string, string>;
     orderNo: Ref<string, string>;
-    open: (docType: DocDetailType, no: string) => Promise<void>;
+    businessKey: Ref<string, string>;
+    processCode: Ref<string, string>;
+    showApprovalActions: Ref<boolean, boolean>;
+    open: (docType: DocDetailType, no: string, approvalKey?: string, approvalProcessCode?: string, withApprovalActions?: boolean) => Promise<void>;
     close: () => void;
     reset: () => void;
 }, never>, Pick<{
     visible: Ref<boolean, boolean>;
     type: Ref<string, string>;
     orderNo: Ref<string, string>;
-    open: (docType: DocDetailType, no: string) => Promise<void>;
+    businessKey: Ref<string, string>;
+    processCode: Ref<string, string>;
+    showApprovalActions: Ref<boolean, boolean>;
+    open: (docType: DocDetailType, no: string, approvalKey?: string, approvalProcessCode?: string, withApprovalActions?: boolean) => Promise<void>;
     close: () => void;
     reset: () => void;
 }, "close" | "open" | "reset">>;

package/dist/components/JDocDetail/types.d.ts

@@ -103,6 +103,38 @@ export type DocDetailAdapters = {
      * 返回：{ code, data, msg }；data 为单条合同（含 purchase_order_detail_list）
      */
     getPurchaseContractDetail?: (contractNo: string) => Promise<any>;
+    /**
+     * 框架合同详情，入参 contract_no
+     * 接口 PurchaseFrameContract/contractList，从 list 取一条
+     */
+    getFrameContractDetail?: (contractNo: string) => Promise<any>;
+    /**
+     * 采购预算详情，入参为预算 id（审批 business_key）
+     * 接口 queryBudget / budgetList
+     */
+    getPurchaseBudgetDetail?: (budgetId: string) => Promise<any>;
+    /** 预约单详情，入参 appointment_order_no */
+    getAppointmentDetail?: (appointmentOrderNo: string) => Promise<any>;
+    /** 供应商详情，入参 supplier_code */
+    getSupplierDetail?: (supplierCode: string) => Promise<any>;
+    /** 供应商产品资料审核，入参 audit_no */
+    getSupplierProductProfileAudit?: (auditNo: string) => Promise<any>;
+    /** 供应商产品报价审核，入参 audit_no */
+    getSupplierProductQuoteAudit?: (auditNo: string) => Promise<any>;
+    /** 供应商资料变更审核，入参 audit_no */
+    getSupplierProfileChangeAudit?: (auditNo: string) => Promise<any>;
+    /** 物流商详情，入参 provider_code */
+    getLogisticsProviderDetail?: (providerCode: string) => Promise<any>;
+    /** FBA发货计划详情，入参 plan_no（或数字 id） */
+    getFbaShipPlanDetail?: (planNo: string) => Promise<any>;
+    /** 物流请款单详情，入参 id；勿与 SCM 采购请款 getPaymentRequestDetail 混淆 */
+    getTmsPaymentDetail?: (id: string) => Promise<any>;
+    /** 库存调整单详情，入参 doc_no */
+    getInventoryAdjustDetail?: (docNo: string) => Promise<any>;
+    /** 库存调整单操作日志，入参 order_id */
+    getInventoryAdjustLogs?: (orderId: string | number) => Promise<any>;
+    /** 补货计划详情，入参 replenishment_plan_no；接口列表取一条 */
+    getReplenishmentPlanDetail?: (replenishmentPlanNo: string) => Promise<any>;
     /** 业务方可自行扩展 key */
     [key: string]: ((...args: any[]) => any) | undefined;
 };
@@ -127,7 +159,7 @@ export type DocDetailViewOptions = {
      * 单据 type → 审批流程编码。有非空编码才展示右侧审批列，否则单列铺满。
      * 会与库内默认值合并；传空字符串可关掉某类单据的审批列。
      */
-    approvalProcessCodes?: Record<string, string>;
+    approvalProcessCodes?: Record<string, string | string[]>;
 };
 export type CreateDocDetailOptions = {
     /** type → 详情组件 */

package/dist/components/JDocDetail/useDocDetailApproval.d.ts

@@ -0,0 +1,13 @@
+import { MaybeRefOrGetter, ComputedRef } from 'vue';
+
+/**
+ * 单据详情里的审批：必须同时满足
+ * 1. 该 type 接入了审批组件（DEFAULT_APPROVAL_PROCESS_CODES 有编码）
+ * 2. 打开时明确传入了 process_code（AIOP store.open 第 4 参，如 scm0004）
+ *
+ * DocNoLink 只传 type + 单号，不传 process_code，不出右栏、不打 flowLogs。
+ */
+export declare function useDocDetailApproval(type: string, businessKey: MaybeRefOrGetter<string>, onSuccess?: () => void): {
+    showApproval: ComputedRef<boolean>;
+    approvalProcessCode: ComputedRef<string>;
+};

package/dist/components/JDocDetail/utils/paymentRequestDisplay.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 付款单详情展示映射，对齐 scm mapPaymentRequestDetail。
+ * 已映射过的数据（含 details）原样使用；后端原字段（purchase_orders 等）在这里转成弹窗字段。
+ */
+/** 把 queryPaymentRequest 原数据转成 PaymentRequestDetailView 展示态 */
+export declare function normalizePaymentRequestDetail(input: any): any;

package/dist/components/JDocDetail/utils/receiptVoucherDisplay.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 收款单详情展示映射，对齐 scm mapReceiptVoucherDetail。
+ */
+export declare function getReturnExchangeNoList(row: any): string[];
+export declare function mapReceiptVoucherLogRow(row: any): {
+    ctime: any;
+    operator: any;
+    operat_type: any;
+    operat_msg: any;
+};
+export declare function normalizeReceiptVoucherDetail(input: any): any;

package/dist/components/JDocDetail/views/AppointmentOrderDetailView.d.ts

@@ -0,0 +1,22 @@
+import { DefineComponent, ExtractPropTypes, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, PropType } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    modelValue: boolean;
+    appointmentOrderNo: string;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "update:modelValue": (val: boolean) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    modelValue: boolean;
+    appointmentOrderNo: string;
+}>>> & Readonly<{
+    "onUpdate:modelValue"?: ((val: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/JDocDetail/views/AuditDiffPanel.d.ts

@@ -0,0 +1,32 @@
+import { DefineComponent, ExtractPropTypes, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, PropType } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    profileDiff?: {
+        fields?: Array<Record<string, unknown>>;
+        sections?: Array<Record<string, unknown>>;
+        stats?: {
+            total: number;
+            changed: number;
+            unchanged: number;
+        };
+    };
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    profileDiff?: {
+        fields?: Array<Record<string, unknown>>;
+        sections?: Array<Record<string, unknown>>;
+        stats?: {
+            total: number;
+            changed: number;
+            unchanged: number;
+        };
+    };
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/components/JDocDetail/views/FbaShipPlanDetailView.d.ts

@@ -0,0 +1,22 @@
+import { DefineComponent, ExtractPropTypes, ComponentOptionsMixin, PublicProps, ComponentProvideOptions, PropType } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    modelValue: boolean;
+    fbaPlanNo: string;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "update:modelValue": (val: boolean) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+    modelValue: boolean;
+    fbaPlanNo: string;
+}>>> & Readonly<{
+    "onUpdate:modelValue"?: ((val: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};