wlwy-package 3.1.63 → 3.2.0

package/dist/types/packages/components/table/type.d.ts

@@ -0,0 +1,179 @@
+import type { FormInstance, FormProps } from 'ant-design-vue';
+import type { VxeColumnProps, VxePagerInstance, VxePagerProps, VxeTableInstance, VxeTableProps, VxeToolbarInstance, VxeToolbarProps } from 'vxe-table';
+import type { RenderCellProps, RenderCellFormatType } from '../../hooks/private';
+import type { Slot } from 'vue';
+/**
+ * w-toolbar 组件属性
+ */
+export interface WToolbarProps extends Omit<VxeToolbarProps, 'id'> {
+    toolid?: string;
+    /** @deprecated 请改用 WTable 顶层的 `showToolbar` */
+    hideToolbar?: boolean;
+}
+/** 多子组件共享，平铺在 WTable 顶层 */
+export type WTableSharedPropKeys = 'loading' | 'size' | 'perfect' | 'border' | 'align';
+export type WToolbarOnlyProps = Omit<WToolbarProps, WTableSharedPropKeys>;
+export type WPagerOnlyProps = Omit<WPagerProps, WTableSharedPropKeys | 'dataSource'>;
+export type WTableOnlyProps<Row = any> = Omit<VxeTableProps<Row>, 'data' | WTableSharedPropKeys>;
+/**
+ * w-table 组件属性
+ */
+export interface WTableProps<Row = any> extends WTableOnlyProps<Row>, Partial<Pick<WToolbarProps & WPagerProps, WTableSharedPropKeys>> {
+    data?: Row[];
+    showPager?: boolean;
+    /** 是否显示复选框列 */
+    showCheckbox?: boolean;
+    /** 是否显示序号列 @default true */
+    showSeq?: boolean;
+    /**
+     * 是否显示工具栏，优先级高于 `toolbar.hideToolbar`。
+     * 若存在 `#toolbar-buttons` / `#toolbar-tools`（或旧 `#buttons` / `#tools`），则以 slot 为准强制显示。
+     */
+    showToolbar?: boolean;
+    toolbar?: Partial<WToolbarOnlyProps>;
+    pager?: Partial<WPagerOnlyProps>;
+}
+/**
+ * w-table 弃用平铺属性（仍可通过 attrs 传入，请迁移至 toolbar / pager 嵌套对象）
+ */
+export interface WTableDeprecatedProps extends Partial<WToolbarOnlyProps>, Partial<Omit<WPagerOnlyProps, keyof WToolbarOnlyProps>> {
+    /** @deprecated 请改用 `data` */
+    dataSource?: unknown[];
+}
+/**
+ * w-table 插槽
+ */
+export interface WTableSlots {
+    'toolbar-buttons'?: Slot;
+    'toolbar-tools'?: Slot;
+    'pager-left'?: Slot;
+    'pager-right'?: Slot;
+    default?: Slot;
+}
+/**
+ * w-pager组件示例
+ */
+export interface WPagerInstance extends VxePagerInstance {
+    /**
+     * 获取分页实例
+     */
+    getPagerInstance: () => VxePagerInstance | undefined;
+}
+/** w-table.resetPager 参数 */
+export type ResetPagerParams = {
+    currentPage?: number;
+    pageSize?: number;
+};
+/** w-table 内部分页快照 */
+export type PagerState = {
+    currentPage: number;
+    pageSize: number;
+};
+/**
+ * w-table组件示例
+ */
+export interface WTableInstance extends VxeTableInstance {
+    /**
+     * 获取表格实例
+     */
+    getTableInstance: () => VxeTableInstance | undefined;
+    /**
+     * 获取表格工具栏实例
+     */
+    getToolbarInstance: () => VxeToolbarInstance | undefined;
+    /**
+     * 获取表格分页实例
+     */
+    getPagerInstance: () => WPagerInstance | undefined;
+    /**
+     * 读取内部分页状态（供列表页拼请求参数）
+     */
+    getPagerState: () => PagerState;
+    /**
+     * 更新内部分页状态（默认回到第 1 页；pageSize 不传则保持）
+     */
+    resetPager: (params?: ResetPagerParams) => void;
+}
+/**
+ * w-column组件属性
+ */
+export type WColumnProp = Omit<RenderCellProps, 'type' | 'field'> & Pick<VxeColumnProps, 'field' | 'title' | 'fixed' | 'width' | 'minWidth' | 'editRender' | 'headerClassName' | 'formatter' | 'showOverflow'> & {
+    /**
+     * 渲染类型
+     */
+    type?: VxeColumnProps['type'] | RenderCellFormatType | 'action';
+    /**
+     * 列是否可排序
+     */
+    sortable?: boolean;
+    /**
+     * 列头提示图标
+     * @default 'QuestionCircleOutlined'
+     */
+    suffixIcon?: 'QuestionCircleOutlined' | 'InfoCircleOutlined' | 'ExclamationCircleOutlined' | Slot;
+    /**
+     * 列头提示图标
+     * @default 'QuestionCircleOutlined'
+     */
+    prefixIcon?: 'QuestionCircleOutlined' | 'InfoCircleOutlined' | 'ExclamationCircleOutlined' | Slot;
+    /**
+     * 列头提示内容
+     */
+    tipsContent?: string | Slot;
+    /**
+     * 默认值
+     */
+    defaultValue?: string;
+};
+/**
+ * w-pager 组件属性
+ */
+export interface WPagerProps<T = any[]> extends VxePagerProps {
+    /**
+     * 数据源
+     */
+    dataSource?: T;
+}
+/**********************WListSearch组件********************** */
+/**
+ * WListSearch 组件属性
+ */
+export interface WListSearchProps extends Pick<FormProps, 'rules'> {
+    /**
+     * 搜索表单 model
+     */
+    model: Record<string, any>;
+    /**
+     * 每行几列，默认 4
+     */
+    column?: number;
+    /**
+     * 列间距
+     */
+    gutter?: number;
+    /**
+     * 查询按钮 loading
+     */
+    loading?: boolean;
+    /**
+     * 是否显示展开/收起
+     */
+    expand?: boolean;
+    /**
+     * 卡片 bordered
+     */
+    bordered?: boolean;
+}
+/**
+ * WListSearch 组件实例
+ */
+export interface WListSearchInstance {
+    /**
+     * 获取 FormInstance
+     */
+    getFormInstance: () => FormInstance | undefined;
+    /**
+     * 触发重置
+     */
+    reset: () => void;
+}

package/dist/types/packages/components/table/useWTableConfig.d.ts

@@ -0,0 +1,34 @@
+import { type ComputedRef, type Slots } from 'vue';
+import type { WPagerOnlyProps, WTableProps, WToolbarOnlyProps } from './type';
+export type WTableResolvedConfig = {
+    toolbar: Partial<WToolbarOnlyProps> & {
+        hideToolbar?: boolean;
+        toolid?: string;
+    };
+    pager: Partial<WPagerOnlyProps>;
+    table: Record<string, unknown>;
+};
+/** 父组件 vnode 上是否显式传入过该 prop */
+export declare function isPropExplicit(vnodeProps: Record<string, unknown>, key: string): boolean;
+/** 父组件 vnode 上真正传过的 prop（未传的 Boolean 不会出现在这里，避免 Vue 缺省 false 覆盖 setConfig） */
+export declare function pickExplicitProps(props: Record<string, unknown>, vnodeProps: Record<string, unknown> | null | undefined): Record<string, unknown>;
+export declare function resolveWTableConfig(props: WTableProps, attrs: Record<string, unknown>, vnodeProps?: Record<string, unknown> | null): WTableResolvedConfig;
+export declare function useWTableConfig(props: WTableProps, attrs: Record<string, unknown>): {
+    config: ComputedRef<WTableResolvedConfig>;
+};
+export declare function resolveWTableSlots(slots: Slots): {
+    hasToolbarButtons: boolean;
+    hasToolbarTools: boolean;
+    hasPagerLeft: boolean;
+    hasPagerRight: boolean;
+    hasToolbarSlots: boolean;
+    tableSlotNames: string[];
+};
+export declare function useWTableSlots(slots: Slots): ComputedRef<{
+    hasToolbarButtons: boolean;
+    hasToolbarTools: boolean;
+    hasPagerLeft: boolean;
+    hasPagerRight: boolean;
+    hasToolbarSlots: boolean;
+    tableSlotNames: string[];
+}>;

package/dist/types/packages/components/table/vxeDefaultConfig.d.ts

@@ -0,0 +1,8 @@
+import type { VxePagerProps, VxeTableProps, VxeToolbarProps } from 'vxe-table';
+export type WTableVxeDefaultConfig = {
+    table: Partial<VxeTableProps>;
+    toolbar: Partial<VxeToolbarProps>;
+    pager: Partial<VxePagerProps>;
+};
+/** WTable 组件约定的 vxe 全局默认配置 */
+export declare const WTABLE_VXE_DEFAULT_CONFIG: WTableVxeDefaultConfig;

package/dist/types/packages/components/table/warnDeprecated.d.ts

@@ -0,0 +1,6 @@
+export declare function warnDeprecated(oldKey: string, newPath: string): void;
+export declare function warnDeprecatedSlot(oldName: string, newName: string): void;
+export declare function warnPropConflict(key: string, namespace: 'toolbar' | 'pager'): void;
+export declare function warnShowToolbarConflict(): void;
+/** toolbar slot 与显式关闭工具栏冲突时，以 slot 为准 */
+export declare function warnToolbarSlotConflict(source: 'showToolbar' | 'toolbar.hideToolbar'): void;

package/dist/types/packages/hooks/private/index.d.ts

@@ -1,2 +1,2 @@
-export { default as useRenderCell, type RenderCellProps } from './src/useRenderCell';
+export { default as useRenderCell, toFormatCellOptions, resolveLegacyEnumMap, type RenderCellProps, type RenderCellFormatByType, type RenderCellFormatType, type RenderCellLegacyProps } from './src/useRenderCell';
 export { default as useKey } from './src/useKey';

package/dist/types/packages/hooks/private/src/useRenderCell.d.ts

@@ -1,55 +1,71 @@
 import { type DictBasicNameType } from '../../business';
 import type { OptionType } from '../../../type';
-type RenderType = 'date' | 'i18n' | 'amount';
+import { type FormatCellBooleanOptions, type FormatCellEnumMap, type FormatCellEnumOptionsExtension, type FormatCellI18nOptions, type FormatCellNumberOptions, type FormatCellOptions, type FormatCellPercentOptions, type FormatCellTemporalOptions } from '../../../utils/formatCellValue';
+type TemporalExtra = Pick<FormatCellTemporalOptions, 'format' | 'timeZone'>;
 type FieldPath = string | number | string[] | number[];
-export type RenderCellProps = {
-    /**
-     * 渲染字段名
-     */
-    field?: FieldPath;
-    /**
-     * 渲染类型
-     */
-    type?: RenderType;
-    /**
-     * 时间格式
-     * @default 'YYYY-MM-DD HH:mm:ss'
-     */
+/** 与 {@link FormatCellOptions} 对齐的按 `type` 区分的格式化 props */
+export type RenderCellFormatByType = {
+    type?: 'raw';
+} | ({
+    type: 'date';
+} & TemporalExtra) | ({
+    type: 'time';
+} & TemporalExtra) | ({
+    type: 'datetime';
+} & TemporalExtra) | ({
+    type: 'number';
+} & Pick<FormatCellNumberOptions, 'precision'>) | ({
+    type: 'percent';
+} & Pick<FormatCellPercentOptions, 'valueScale'>) | ({
+    type: 'boolean';
+} & Pick<FormatCellBooleanOptions, 'trueText' | 'falseText'>) | ({
+    type: 'enum';
+} & FormatCellEnumOptionsExtension & {
+    name?: string;
+    map?: FormatCellEnumMap;
+}) | ({
+    type: 'i18n';
+} & Pick<FormatCellI18nOptions, 'values'>)
+/** @deprecated 请改用 `type: 'number'` 且 `precision: 2` */
+ | {
+    type: 'amount';
+};
+/** @deprecated 旧版平铺 props，由 {@link toFormatCellOptions} 自动映射 */
+export type RenderCellLegacyProps = {
+    /** @deprecated 请改用 `format` */
     dateFormat?: string;
-    /**
-     * 枚举值
-     */
     enum?: OptionType[] | Record<string, string> | string;
-    /**
-     * options值
-     */
     options?: OptionType[];
-    /**
-     * 枚举值字段名等效fieldNames
-     * @default { label: 'label', value: 'value' }
-     */
     enumFieldNames?: {
         label?: string;
         value?: string;
     };
-    /**
-     * 枚举值字段名等效enumFieldNames
-     * @default { label: 'label', value: 'value' }
-     */
     fieldNames?: {
         label?: string;
         value?: string;
     };
-    /**
-     * 字典名称
-     */
     dictName?: DictBasicNameType;
-    /**
-     * 数字精度
-     */
+    /** @deprecated 请配合 `type: 'number'` 使用 */
     precision?: number;
 };
+export type RenderCellFormatType = NonNullable<RenderCellFormatByType['type']>;
+export type RenderCellProps = {
+    field?: FieldPath;
+} & RenderCellFormatByType & Partial<RenderCellLegacyProps>;
+export declare function resolveLegacyEnumMap(props: RenderCellProps, context: {
+    translate: (key: string) => string;
+    dictOptions?: OptionType[];
+    labelKey: string;
+    valueKey: string;
+}): FormatCellEnumMap | undefined;
+export declare function toFormatCellOptions(props: RenderCellProps, context?: {
+    enumMap?: FormatCellEnumMap;
+    translate?: (key: string) => string;
+    dictOptions?: OptionType[];
+    labelKey?: string;
+    valueKey?: string;
+}): FormatCellOptions;
 export default function useRenderCell(props: RenderCellProps): {
-    getRenderValue: (row?: any) => any;
+    getRenderValue: (row?: Record<string, unknown>) => string | undefined;
 };
 export {};

package/dist/types/packages/hooks/web/index.d.ts

@@ -14,5 +14,4 @@ export { default as useTabsNav } from './src/useTabsNav';
 export { default as useUpload } from './src/useUpload';
 export { default as useWatchForm, type UseWatchFormType } from './src/useWatchForm';
 export { default as useWindowSize } from './src/useWindowSize';
-export { default as useExposeRef } from './src/useExposeRef';
 export { default as useEmitBack } from './src/useEmitBack';

package/dist/types/packages/hooks/web/src/usePrefixTitle.d.ts

@@ -1,3 +1,7 @@
-export default function (): {
-    getTitle(title?: string, mode?: string): string;
+import { getTitle } from '../../../utils/getPrefixTitle';
+/**
+ * @deprecated 请改用 { getTitle } from 'wlwy-package'
+ */
+export default function usePrefixTitle(): {
+    getTitle: typeof getTitle;
 };

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

@@ -9,8 +9,10 @@ export * from './setup';
 export * from './type';
 export * from './keys';
 export { default as WCharts, type WChartsProps, type WChartsInstance } from './components/lazy/charts';
+export { default as WEditor, type WEditorInstance, type WEditorProps, type InsertFnType, type customUploadFnType } from './components/lazy/editor';
 export { useService, type ServiceType } from './axios';
 export { type Config } from './config';
+export { getTitle } from './utils';
 export declare const install: (app: App) => App<any>;
 declare const _default: {
     install: (app: App<any>) => App<any>;

package/dist/types/packages/keys/index.d.ts

@@ -1,3 +1,6 @@
 import type { InjectionKey, ModelRef } from 'vue';
 import type { FormProps } from 'ant-design-vue';
+import type { WIconProp } from '../components/icon/type';
 export declare const WHeaderForm: InjectionKey<ModelRef<Partial<FormProps>>>;
+/** w-column type="action" 内 w-icon 的默认 size */
+export declare const WIconSizeKey: InjectionKey<NonNullable<WIconProp['size']>>;

package/dist/types/packages/setup/vxe.d.ts

@@ -3,4 +3,8 @@ import 'vxe-table/lib/style.css';
 import type { App } from 'vue';
 import * as VxeUIAll from 'vxe-pc-ui';
 import * as VxeUITable from 'vxe-table';
-export declare const setupVxe: (app: App<Element>, callback?: (ui: typeof VxeUIAll, table: typeof VxeUITable) => void) => void;
+export type SetupVxeCallback = (ui: typeof VxeUIAll, table: typeof VxeUITable) => void;
+export type SetupVxeOptions = Parameters<typeof VxeUIAll.VxeUI.setConfig>[0];
+export declare function setupVxe(app: App<Element>): void;
+export declare function setupVxe(app: App<Element>, callback: SetupVxeCallback): void;
+export declare function setupVxe(app: App<Element>, options: SetupVxeOptions, callback?: SetupVxeCallback): void;

package/dist/types/packages/utils/createRefInstanceProxy.d.ts

@@ -0,0 +1,13 @@
+import type { Ref } from 'vue';
+export type CreateRefInstanceProxyOptions = {
+    /** 优先从 target 自身读取的 key（如 defineExpose 自定义方法） */
+    ownKeys?: Set<string> | readonly string[];
+    /** 是否将 inner 上的方法 bind 到 inner 实例，默认 true */
+    bindMethods?: boolean;
+};
+/**
+ * 将外层 ref / expose 对齐到 Ref 指向的内部实例（转发属性读写与 Reflect API）。
+ * 差异化 props/slots 逻辑放在各封装组件内处理，勿写入本文件。
+ */
+export declare function createRefInstanceProxy<TInner extends object>(innerRef: Ref<TInner | null | undefined>): TInner;
+export declare function createRefInstanceProxy<TTarget extends object, TInner extends object>(innerRef: Ref<TInner | null | undefined>, target: TTarget, options?: CreateRefInstanceProxyOptions): TTarget & TInner;

package/dist/types/packages/utils/formatCellValue.d.ts

@@ -0,0 +1,82 @@
+export interface FormatCellTemporalOptions {
+    /** dayjs 格式串；未传则用各 `type` 默认 */
+    format?: string;
+    /** IANA 时区，如 `Asia/Shanghai`；未传则按本地时区 */
+    timeZone?: string;
+}
+export interface FormatCellDateOnlyOptions extends FormatCellTemporalOptions {
+    type: 'date';
+}
+export interface FormatCellTimeOnlyOptions extends FormatCellTemporalOptions {
+    type: 'time';
+}
+export interface FormatCellDateTimeOptions extends FormatCellTemporalOptions {
+    type: 'datetime';
+}
+export interface FormatCellRawOptions {
+    type: 'raw';
+}
+export interface FormatCellNumberOptions {
+    type: 'number';
+    /** 小数位数：0 为整数，1 为一位小数，以此类推 */
+    precision?: number;
+}
+export interface FormatCellPercentOptions {
+    type: 'percent';
+    /** `ratio`：`0.12` → 12%；`hundred`：`12` → 12% */
+    valueScale?: 'ratio' | 'hundred';
+}
+export interface FormatCellBooleanOptions {
+    type: 'boolean';
+    trueText?: string;
+    falseText?: string;
+}
+/** 枚举项（`map` 为数组时的元素形状） */
+export interface FormatCellEnumEntry {
+    key: string | number;
+    text: string | number;
+}
+/** 枚举查表数据：`Record` 或 `{ key, text }[]` */
+export type FormatCellEnumMap = Record<string, string> | FormatCellEnumEntry[];
+/**
+ * 宿主可对 `type: 'enum'` 的选项做声明合并扩展（勿在本接口上写必填字段，否则与合并语义冲突）。
+ *
+ * `name` 的强类型约束请通过 {@link useEnum} 的 `formatCell` 使用 `keyof R`。
+ *
+ * @example
+ * ```ts
+ * declare module 'wlwy-package' {
+ *   interface FormatCellEnumOptionsExtension {
+ *     columnKey?: string
+ *   }
+ * }
+ * ```
+ */
+export interface FormatCellEnumOptionsExtension {
+}
+export interface FormatCellEnumOptions extends FormatCellEnumOptionsExtension {
+    type: 'enum';
+    /** 枚举名；仅 `useEnum().formatCell` 解析，需配合注册表。与 `map` 同时存在时忽略 */
+    name?: string;
+    /** 查表数据；未传时须由 `useEnum` 根据 `name` 注入 */
+    map?: FormatCellEnumMap;
+}
+/** 将 {@link FormatCellEnumMap} 规范为 `Record<string, string>` */
+export declare function normalizeEnumMap(map: FormatCellEnumMap): Record<string, string>;
+export interface FormatCellI18nOptions {
+    type: 'i18n';
+    /** vue-i18n 插值参数 */
+    values?: Record<string, unknown>;
+}
+export type FormatCellOptions = FormatCellRawOptions | FormatCellDateOnlyOptions | FormatCellTimeOnlyOptions | FormatCellDateTimeOptions | FormatCellNumberOptions | FormatCellPercentOptions | FormatCellBooleanOptions | FormatCellEnumOptions | FormatCellI18nOptions;
+/** 非「空单元格」场景：非法日期/数字等原样展示 */
+export declare function preserveRawCellValue(value: unknown): string;
+/**
+ * 单元格格式化核心：不包含「空值 → placeholder」逻辑，调用方需先处理占位或与 {@link formatCellValue} 配合使用。
+ */
+export declare function formatCellValueCore(value: unknown, options: FormatCellOptions): string;
+/**
+ * 表格/描述列表等场景的单元格格式化：按 `options.type` 输出字符串；
+ * 无法识别为日期/数字等时 **原样字符串化**，不使用 `Invalid Date`。
+ */
+export declare function formatCellValue(value: unknown, options: FormatCellOptions): string;

package/dist/types/packages/utils/getPrefixTitle.d.ts

@@ -0,0 +1,5 @@
+import type { HandlerMode } from '../type';
+/**
+ * 拼接表单模式前缀与标题（中文无空格，英文加空格）
+ */
+export declare function getTitle(title: string, mode?: HandlerMode): string;

package/dist/types/packages/utils/index.d.ts

@@ -1,5 +1,8 @@
 import type { PickMultipleResult, TargetsType } from './type';
 export type { PickMultipleFn } from './type';
+export { createRefInstanceProxy, type CreateRefInstanceProxyOptions } from './createRefInstanceProxy';
+export { getTitle } from './getPrefixTitle';
+export { formatCellValue, formatCellValueCore, normalizeEnumMap, preserveRawCellValue, type FormatCellOptions, type FormatCellEnumMap, type FormatCellEnumEntry, type FormatCellEnumOptionsExtension, type FormatCellTemporalOptions, type FormatCellDateOnlyOptions, type FormatCellTimeOnlyOptions, type FormatCellDateTimeOptions, type FormatCellRawOptions, type FormatCellNumberOptions, type FormatCellPercentOptions, type FormatCellBooleanOptions, type FormatCellEnumOptions, type FormatCellI18nOptions } from './formatCellValue';
 /**
  *  列表语言翻译
  *