jgy-public-component 0.0.45 → 0.0.46

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

@@ -0,0 +1,46 @@
+import { DefineComponent, ExtractPropTypes, Ref, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+declare const _default: DefineComponent<ExtractPropTypes<{
+    process_code: {
+        type: StringConstructor;
+        default: string;
+    };
+    business_key: {
+        type: StringConstructor;
+        default: string;
+    };
+    request: {
+        type: FunctionConstructor;
+        default: null;
+    };
+}>, {
+    logs: Ref<any[], any[]>;
+    raw: Ref<any, any>;
+    loading: Ref<boolean, boolean>;
+    fetchLogs: () => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    success: (...args: any[]) => void;
+    loaded: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<{
+    process_code: {
+        type: StringConstructor;
+        default: string;
+    };
+    business_key: {
+        type: StringConstructor;
+        default: string;
+    };
+    request: {
+        type: FunctionConstructor;
+        default: null;
+    };
+}>> & Readonly<{
+    onSuccess?: ((...args: any[]) => any) | undefined;
+    onLoaded?: ((...args: any[]) => any) | undefined;
+    onError?: ((...args: any[]) => any) | undefined;
+}>, {
+    process_code: string;
+    business_key: string;
+    request: Function;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;

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

@@ -0,0 +1,4 @@
+/** 审批流程日志（process_code + business_key） */
+export declare const APPROVAL_FLOW_LOGS_URL = "/workhome-app/index/approvalInstance/flowLogs";
+/** 审核通过 / 驳回（先内置，时间线操作后续再用） */
+export declare const APPROVAL_AUDIT_URL = "/workhome-app/index/approvalInstance/audit";

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

@@ -0,0 +1,2 @@
+export { default as JApprovalFlow } from './JApprovalFlow';
+export { APPROVAL_FLOW_LOGS_URL, APPROVAL_AUDIT_URL } from './apiPaths';

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

@@ -10,7 +10,7 @@
  * WMS 可直接用 wmsDocDetailComponents 作为 components。
  */
 export type { DocDetailType, DocDetailAdapters, DocDetailRegistryItem, DocDetailComponents, CreateDocDetailOptions, DocDetailViewOptions, PurchaseOrderTabName, } from './types';
-export { createDocDetail, registerDocDetail, getDocDetailRegistry, getDocDetailAdapters, getDocDetailViewOptions, getDocDetailEntry, isDocDetailInitialized, } from './registry';
+export { createDocDetail, registerDocDetail, getDocDetailRegistry, getDocDetailAdapters, getDocDetailViewOptions, getApprovalProcessCode, hasApprovalFlow, getDocDetailEntry, isDocDetailInitialized, } from './registry';
 export { useDocDetailStore } from './store';
 export { provideDocRequest, setDocRequest, getDocRequest } from './request';
 export type { JDocRequestFn } from './request';

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

@@ -19,6 +19,8 @@ export declare function registerDocDetail(options: Partial<CreateDocDetailOption
 export declare function getDocDetailRegistry(): NormalizedRegistry;
 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 isDocDetailInitialized(): boolean;
 export declare function getDocDetailEntry(type: string): {
     component: Component;

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

@@ -123,6 +123,11 @@ export type DocDetailViewOptions = {
     purchase?: {
         tabOrder?: PurchaseOrderTabName[];
     };
+    /**
+     * 单据 type → 审批流程编码。有非空编码才展示右侧审批列，否则单列铺满。
+     * 会与库内默认值合并；传空字符串可关掉某类单据的审批列。
+     */
+    approvalProcessCodes?: Record<string, string>;
 };
 export type CreateDocDetailOptions = {
     /** type → 详情组件 */

package/dist/components/JImportData/JImportData.d.ts

@@ -0,0 +1,120 @@
+import { JImportDone, JImportHeader, JImportMode, JImportResult } from './types';
+import { DefineComponent, ExtractPropTypes, PropType, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+
+declare const _default: DefineComponent<ExtractPropTypes<{
+    modelValue: PropType<boolean>;
+    title: {
+        type: PropType<string>;
+        default: string;
+    };
+    headers: {
+        type: PropType<JImportHeader[]>;
+        default: () => never[];
+    };
+    moduleName: {
+        type: PropType<string>;
+        default: string;
+    };
+    getHeadersApi: {
+        type: PropType<() => Promise<unknown>>;
+    };
+    downloadTemplateApi: {
+        type: PropType<() => Promise<unknown>>;
+    };
+    importApi: {
+        type: PropType<(data: FormData) => Promise<unknown>>;
+    };
+    modes: {
+        type: PropType<JImportMode[]>;
+        default: () => string[];
+    };
+    maxSizeMb: {
+        type: PropType<number>;
+        default: number;
+    };
+    maxRows: {
+        type: PropType<number>;
+        default: number;
+    };
+    maxCols: {
+        type: PropType<number>;
+        default: number;
+    };
+    templateFileName: {
+        type: PropType<string>;
+        default: string;
+    };
+}>, {
+    setResult: JImportDone;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    close: () => void;
+    success: (result: JImportResult) => void;
+    import: (payload: {
+        mode: JImportMode;
+        file: File;
+        fileName: string;
+        rows: Record<string, unknown>[];
+    }, done: JImportDone) => void;
+}, string, PublicProps, Readonly< ExtractPropTypes<{
+    modelValue: PropType<boolean>;
+    title: {
+        type: PropType<string>;
+        default: string;
+    };
+    headers: {
+        type: PropType<JImportHeader[]>;
+        default: () => never[];
+    };
+    moduleName: {
+        type: PropType<string>;
+        default: string;
+    };
+    getHeadersApi: {
+        type: PropType<() => Promise<unknown>>;
+    };
+    downloadTemplateApi: {
+        type: PropType<() => Promise<unknown>>;
+    };
+    importApi: {
+        type: PropType<(data: FormData) => Promise<unknown>>;
+    };
+    modes: {
+        type: PropType<JImportMode[]>;
+        default: () => string[];
+    };
+    maxSizeMb: {
+        type: PropType<number>;
+        default: number;
+    };
+    maxRows: {
+        type: PropType<number>;
+        default: number;
+    };
+    maxCols: {
+        type: PropType<number>;
+        default: number;
+    };
+    templateFileName: {
+        type: PropType<string>;
+        default: string;
+    };
+}>> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onSuccess?: ((result: JImportResult) => any) | undefined;
+    onImport?: ((payload: {
+        mode: JImportMode;
+        file: File;
+        fileName: string;
+        rows: Record<string, unknown>[];
+    }, done: JImportDone) => any) | undefined;
+}>, {
+    title: string;
+    headers: JImportHeader[];
+    moduleName: string;
+    modes: JImportMode[];
+    maxSizeMb: number;
+    maxRows: number;
+    maxCols: number;
+    templateFileName: string;
+}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+export default _default;

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

@@ -0,0 +1,2 @@
+export { default as JImportData } from './JImportData';
+export type { JImportDataProps, JImportDataEmits, JImportHeader, JImportMode, JImportPayload, JImportResult, JImportDone, JImportGetHeadersApi, JImportDownloadTemplateApi, JImportApi, } from './types';

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

@@ -0,0 +1,65 @@
+/** 导入模式：仅新增 / 仅更新 / 新增和更新 */
+export type JImportMode = 'insert' | 'update' | 'upsert';
+/** 标准模板列：label 为 Excel 表头，prop 为解析后对象字段 */
+export interface JImportHeader {
+    label: string;
+    prop: string;
+    required?: boolean;
+}
+export interface JImportPayload {
+    mode: JImportMode;
+    /** 原始上传文件，业务侧可直接 FormData 提交 */
+    file: File;
+    fileName: string;
+    /** 仅在传入 headers / getHeadersApi 时前端解析；否则为空数组 */
+    rows: Record<string, unknown>[];
+}
+export interface JImportResult {
+    successCount: number;
+    failCount: number;
+    skipCount: number;
+    failUrl?: string;
+    skipUrl?: string;
+    successUrl?: string;
+    /** code === 1 时展示全成功页，否则有 data 时展示失败/未处理页 */
+    fullSuccess?: boolean;
+    failRows?: Record<string, unknown>[];
+    skipRows?: Record<string, unknown>[];
+    /** 有值时停留在填写态并提示，不切结果页 */
+    errorMessage?: string;
+}
+export type JImportDone = (result: JImportResult) => void;
+export type JImportGetHeadersApi = () => Promise<unknown>;
+/** 下载标准模板：返回 Blob，或 { data: Blob }（如 responseType: 'blob' 的 axios 响应） */
+export type JImportDownloadTemplateApi = () => Promise<unknown>;
+/** 点击导入：传入 FormData（file + import_mode），与业务页 importXxx(formData) 一致 */
+export type JImportApi = (data: FormData) => Promise<unknown>;
+export interface JImportDataProps {
+    /** 弹窗标题 */
+    title?: string;
+    /** 用于模板 / 失败 / 未处理文件名 */
+    moduleName?: string;
+    /** 可选。传入后会在前端按表头解析 rows；不传则只保留文件 */
+    headers?: JImportHeader[];
+    /** 可选。打开弹窗时拉取表头（headers 为空才请求） */
+    getHeadersApi?: JImportGetHeadersApi;
+    /** 从后端下载标准模板，不传则「标准模板」不可点 */
+    downloadTemplateApi?: JImportDownloadTemplateApi;
+    /** 点击导入时请求的接口，不传则走 @import 事件 */
+    importApi?: JImportApi;
+    /** 可选导入模式，默认三种都有 */
+    modes?: JImportMode[];
+    /** 文件大小上限 MB */
+    maxSizeMb?: number;
+    /** 数据行上限（不含表头） */
+    maxRows?: number;
+    /** 列数上限 */
+    maxCols?: number;
+    /** 标准模板保存的文件名，默认 `${moduleName}导入模板.xlsx` */
+    templateFileName?: string;
+}
+export interface JImportDataEmits {
+    import: [payload: JImportPayload, done: JImportDone];
+    success: [result: JImportResult];
+    close: [];
+}

package/dist/components/JImportData/utils.d.ts

@@ -0,0 +1,49 @@
+import { JImportHeader, JImportResult } from './types';
+
+export declare function unwrapHeaders(res: unknown): JImportHeader[];
+export declare function formatStamp(date?: Date): string;
+export interface JImportPreviewColumn {
+    key: string;
+    label: string;
+}
+export interface JImportPreviewSheet {
+    name: string;
+    columns: JImportPreviewColumn[];
+    rows: Record<string, string>[];
+}
+/** 点击文件名时在弹窗内预览，避免浏览器把 xlsx 当下载 */
+export declare function previewImportFile(file: File, maxPreviewRows?: number): Promise<{
+    sheets: JImportPreviewSheet[];
+    error?: string;
+}>;
+export declare function parseImportFile(file: File, headers: JImportHeader[], limits: {
+    maxRows: number;
+    maxCols: number;
+}): Promise<{
+    rows: Record<string, unknown>[];
+    error?: string;
+}>;
+/** 取出接口返回的 Blob：兼容直接返回 Blob 或 { data: Blob } */
+export declare function unwrapBlob(res: unknown): Blob | null;
+/** responseType 为 blob 时，后端报错会以 JSON Blob 返回，读出其中的 msg */
+export declare function readBlobError(blob: Blob): Promise<string | null>;
+export declare function saveBlob(blob: Blob, fileName: string): void;
+export declare function downloadResultExcel(options: {
+    headers: JImportHeader[];
+    rows: Record<string, unknown>[];
+    reasonKeys: string[];
+    reasonLabel: string;
+    fileName: string;
+}): void;
+export declare function emptyResult(): JImportResult;
+/** 点击结果页链接，直接打开接口返回的 Excel 地址 */
+export declare function openExcelUrl(url: string): void;
+/**
+ * 解析导入接口：
+ * code === 1 → 全成功
+ * code !== 1 且有 data → 失败/未处理结果页
+ * data: { success: { count, url }, fail: { count, url }, unprocessed: { count, url } }
+ */
+export declare function parseImportApiResponse(res: unknown): JImportResult;
+/** 拦截器 reject 时若挂了 raw，从中解析导入结果 */
+export declare function parseImportApiError(error: unknown): JImportResult;

package/dist/components/JImportExcel/JImportExcel.d.ts

@@ -6,14 +6,14 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<string>;
         default: string;
     };
-    getFieldListApi: {
-        type: PropType<ApiFn>;
-        required: true;
-    };
     importApi: {
         type: PropType<(data: Record<string, any>[]) => Promise<any>>;
         required: true;
     };
+    getFieldListApi: {
+        type: PropType<ApiFn>;
+        required: true;
+    };
     excludeFields: {
         type: PropType<string[]>;
         default: () => string[];
@@ -26,14 +26,14 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<string>;
         default: string;
     };
-    getFieldListApi: {
-        type: PropType<ApiFn>;
-        required: true;
-    };
     importApi: {
         type: PropType<(data: Record<string, any>[]) => Promise<any>>;
         required: true;
     };
+    getFieldListApi: {
+        type: PropType<ApiFn>;
+        required: true;
+    };
     excludeFields: {
         type: PropType<string[]>;
         default: () => string[];

package/dist/components/JSearchInputDialog/JSearchInputDialog.d.ts

@@ -12,6 +12,10 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<string>;
         default: string;
     };
+    rows: {
+        type: PropType<number>;
+        default: number;
+    };
     options: {
         type: PropType<SearchInputOption[]>;
         default: () => never[];
@@ -32,10 +36,6 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<string | number>;
         default: string;
     };
-    rows: {
-        type: PropType<number>;
-        default: number;
-    };
     textareaPlaceholder: {
         type: PropType<string>;
         default: string;
@@ -62,6 +62,10 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<string>;
         default: string;
     };
+    rows: {
+        type: PropType<number>;
+        default: number;
+    };
     options: {
         type: PropType<SearchInputOption[]>;
         default: () => never[];
@@ -82,10 +86,6 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<string | number>;
         default: string;
     };
-    rows: {
-        type: PropType<number>;
-        default: number;
-    };
     textareaPlaceholder: {
         type: PropType<string>;
         default: string;
@@ -100,12 +100,12 @@ declare const _default: DefineComponent<ExtractPropTypes<{
 }>, {
     placeholder: string;
     width: string;
+    rows: number;
     options: SearchInputOption[];
     selectWidth: string;
     separator: string;
     dialogTitle: string;
     dialogWidth: string | number;
-    rows: number;
     textareaPlaceholder: string;
     clearOnTypeChange: boolean;
 }, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;

package/dist/directives/clickLock.d.ts

@@ -0,0 +1,5 @@
+import { Directive } from 'vue';
+
+export type ClickLockValue = number | boolean | undefined;
+export declare const vClickLock: Directive<HTMLElement, ClickLockValue>;
+export default vClickLock;

package/dist/directives/index.d.ts

@@ -0,0 +1,2 @@
+export { vClickLock } from './clickLock';
+export type { ClickLockValue } from './clickLock';

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { JIconRender } from './components/JIconRender';
 import { JSearchHeader } from './components/JSearchHeader';
 import { JListSearchHeader } from './components/JListSearchHeader';
 import { JImportExcel } from './components/JImportExcel';
+import { JImportData } from './components/JImportData';
 import { JSidebar, JSideMenuItem } from './components/JSidebar';
 import { JAdminLayout } from './components/JAdminLayout';
 import { JProductDetailDialog, JSkuLink, ProductDetailHost } from './components/JProductDetail';
@@ -14,19 +15,22 @@ import { JSupplierCycleSelect, JSupplierCycleDisplay } from './components/JSuppl
 import { JProductSelectDialog } from './components/JProductSelectDialog';
 import { DocNoLink, DocDetailHost } from './components/JDocDetail';
 import { JRelatedDocs } from './components/JRelatedDocs';
+import { JApprovalFlow } from './components/JApprovalFlow';
 
 declare const _default: {
     install: (app: App) => void;
 };
 export default _default;
-export { JButton, JUploadImg, JIconRender, JSearchHeader, JListSearchHeader, JImportExcel, JSidebar, JSideMenuItem, JAdminLayout, JProductDetailDialog, JSkuLink, ProductDetailHost, JSearchInputDialog, JRemoteSelect, JSupplierCycleSelect, JSupplierCycleDisplay, JProductSelectDialog, DocNoLink, DocDetailHost, JRelatedDocs, };
+export { JButton, JUploadImg, JIconRender, JSearchHeader, JListSearchHeader, JImportExcel, JImportData, JSidebar, JSideMenuItem, JAdminLayout, JProductDetailDialog, JSkuLink, ProductDetailHost, JSearchInputDialog, JRemoteSelect, JSupplierCycleSelect, JSupplierCycleDisplay, JProductSelectDialog, DocNoLink, DocDetailHost, JRelatedDocs, JApprovalFlow, };
 export { provideRequest, getRequest, setRequest, useInjectedRequest, J_REQUEST_KEY, } from './request';
 export type { JRequestFn } from './request';
 export { useProductDetailDialog, useProductDetailStore, provideProductRequest, resolveProductRequest, useInjectedProductRequest, J_PRODUCT_REQUEST_KEY, } from './components/JProductDetail';
-export { provideDocRequest, setDocRequest, getDocRequest, createDocDetail, registerDocDetail, getDocDetailAdapters, getDocDetailViewOptions, getDocDetailEntry, getDocDetailRegistry, isDocDetailInitialized, useDocDetailStore, wmsDocDetailComponents, ReceiptOrderDetailView, QcOrderDetailView, InboundOrderDetailView, PutawayOrderDetailView, DeliveryOrderDetailView, TransferOrderDetailView, WorkOrderDetailView, AbnormalOrderDetailView, PaymentRequestDetailView, ReturnOrderDetailView, CostExpenseDetailView, ReceiptVoucherDetailView, PurchaseOrderDetailView, PurchasePlanDetailView, PurchaseContractDetailView, DeliveryDocDetailView, StockTakeOrderDetailView, PackingTaskDetailView, TransportOrderDetailView, } from './components/JDocDetail';
+export { provideDocRequest, setDocRequest, getDocRequest, createDocDetail, registerDocDetail, getDocDetailAdapters, getDocDetailViewOptions, getApprovalProcessCode, hasApprovalFlow, getDocDetailEntry, getDocDetailRegistry, isDocDetailInitialized, useDocDetailStore, wmsDocDetailComponents, ReceiptOrderDetailView, QcOrderDetailView, InboundOrderDetailView, PutawayOrderDetailView, DeliveryOrderDetailView, TransferOrderDetailView, WorkOrderDetailView, AbnormalOrderDetailView, PaymentRequestDetailView, ReturnOrderDetailView, CostExpenseDetailView, ReceiptVoucherDetailView, PurchaseOrderDetailView, PurchasePlanDetailView, PurchaseContractDetailView, DeliveryDocDetailView, StockTakeOrderDetailView, PackingTaskDetailView, TransportOrderDetailView, } from './components/JDocDetail';
 export { createRelatedDocs, registerRelatedDocs, getRelatedListAdapter, getRelatedTableComponent, getRelatedDocsTableComponents, isRelatedDocsInitialized, RelatedDocSubTabs, RelatedDocNoCopy, RelatedDocPanel, RelatedReceiptOrderTable, RelatedQcOrderTable, RelatedInboundOrderTable, RelatedPutawayOrderTable, RelatedPurchaseOrderTable, RelatedPurchasePlanTable, RelatedDeliveryDocTable, RelatedProcessingOrderTable, RelatedReturnOrderTable, RelatedAbnormalOrderTable, RelatedPaymentRequestTable, RelatedReceiptVoucherTable, RelatedDeclarationTable, RelatedShipmentOrderTable, flattenOrderItems, sumOrderItemField, useRelatedCollapseExpand, parseListResponse, parseListTotal, } from './components/JRelatedDocs';
 export { toSnakeCase, toCamelCase, pick, omit, deepClone, filterEmpty, flatten, unflatten, toTableColumns, checkBtnPermission, provideBtnPermission, useInjectedBtnPermission, useInjectedBtnPermissions, J_BTN_PERMISSION_KEY, J_BTN_PERMISSIONS_KEY, isAllStatusTab, resolveListStatusParam, toTabName, getAllTabName, syncActiveTabIfAll, buildStatusCountLookup, buildFallbackStatusTabs, unwrapStatusCountList, mapStatusCountToTabs, exportStyledExcel, } from './utils';
 export { useBtnPermissionGate } from './composables/useBtnPermissionGate';
+export { vClickLock } from './directives';
+export type { ClickLockValue } from './directives';
 export type { BtnPermissionInput, BtnPermissionMode, BtnPermissionChecker, StatusCountItem, StatusCountLookup, StatusTabListItem, StatusTabItem, StyledExportOptions, } from './utils';
 export { createRouterGuard, buildRouteTree, transformBackendRoutes, findFirstAllowedRoute, getComponentImport } from './router';
 export type { BackendRoute, RouteStoreAdapter, PermissionStoreAdapter, UserStoreAdapter, RouterGuardOptions } from './router';
@@ -36,6 +40,7 @@ export type { JIconRenderProps } from './components/JIconRender';
 export type { JSearchHeaderProps } from './components/JSearchHeader';
 export type { JListSearchHeaderProps } from './components/JListSearchHeader';
 export type { JImportExcelProps, ApiFn } from './components/JImportExcel';
+export type { JImportDataProps, JImportDataEmits, JImportHeader, JImportMode, JImportPayload, JImportResult, JImportDone, JImportGetHeadersApi, JImportDownloadTemplateApi, JImportApi, } from './components/JImportData';
 export type { SidebarMenuItem, JSidebarProps, JSideMenuItemProps } from './components/JSidebar';
 export type { AdminLayoutMenuItem, JAdminLayoutProps } from './components/JAdminLayout';
 export type { JProductDetailDialogProps, JSkuLinkProps, JProductRequestFn, JProductRequestConfig, } from './components/JProductDetail';
@@ -45,3 +50,4 @@ export type { JSupplierCycleSelectProps, JSupplierCycleSelectValue, JSupplierCyc
 export type { JProductSelectDialogProps, JProductSelectFetchApi, JProductSelectListResult, } from './components/JProductSelectDialog';
 export type { DocDetailType, DocDetailAdapters, DocDetailRegistryItem, DocDetailComponents, CreateDocDetailOptions, DocDetailViewOptions, PurchaseOrderTabName, JDocRequestFn, } from './components/JDocDetail';
 export type { RelatedListAdapter, RelatedDocTypeItem, CreateRelatedDocsOptions, RelatedDocsContainerProps, } from './components/JRelatedDocs';
+export { APPROVAL_FLOW_LOGS_URL, APPROVAL_AUDIT_URL } from './components/JApprovalFlow';