wlwy-package 4.0.0-beta.20 → 4.0.0-beta.21

package/dist/types/components/form/default/src/formMultiItemOption.vue.d.ts

@@ -3,6 +3,7 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WFormMulti
     default?: ((props: {
         form: import("vue").ComputedRef<object>;
         model: string;
+        value: any;
     }) => any) | undefined;
 }>;
 export default _default;

package/dist/types/components/form/default/src/inputMatch.vue.d.ts

@@ -9,8 +9,8 @@ declare const _default: import("vue").DefineComponent<WInputMatchProps, {}, {},
     allowClear: boolean;
     tokenSeparators: string[];
     labelModel: string;
-    afterModel: string;
     labelOptions: WDropdownListItem[];
+    afterModel: string;
     afterOptions: {
         key: import("../../../../type.ts").KeyType;
         value: import("../../../../type.ts").KeyType;

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

@@ -1,5 +1,7 @@
 export { default as useRenderCell, toFormatCellOptions, resolveLegacyEnumMap, type RenderCellProps, type RenderCellFormatByType, type RenderCellFormatType, type RenderCellLegacyProps } from './src/useRenderCell';
 export { default as useKey } from './src/useKey';
 export { default as useFormItemProps } from './src/useFormItemProps';
+export { default as useFormFieldRegister } from './src/useFormFieldRegister';
+export { default as useFormDefaultValue, useMultiItemContext, type UseFormDefaultValueOptions } from './src/useFormDefaultValue';
 export { default as useFormContext } from './src/useFormContext';
 export { default as useTabsNav } from './src/useTabsNav';

package/dist/types/hooks/private/src/useFormDefaultValue.d.ts

@@ -0,0 +1,42 @@
+import type { DefaultValueType } from '../../../utils/type';
+/**
+ * MultiItem 上下文能力（供表单控件统一使用）：
+ * - `isInactive()`：处于 `w-form-multi-item` 内且当前不是本 Option
+ * - `registerClear()`：注册「切换离开本 Option」时的字段清理（多字段控件用）
+ *
+ * 不在 MultiItem 内时 `isInactive()` 恒为 false，`registerClear()` 为空实现。
+ */
+export declare function useMultiItemContext(): {
+    isInactive: () => boolean;
+    registerClear: (clear: () => void) => void;
+};
+export type UseFormDefaultValueOptions<T> = {
+    /** defaultValue 取值（getter，保证读到最新 props） */
+    getDefaultValue: () => DefaultValueType<T> | undefined;
+    /** 目标字段是否为空（非 force 场景判定；异步解析完成后会再判一次） */
+    isEmpty: () => boolean;
+    /** 写入解析结果 */
+    write: (resolved: T) => void;
+    /**
+     * 其余回写：label / after 默认值、未传 defaultValue 时 force 写空值等。
+     * 与 defaultValue 回写一样受 MultiItem 守卫保护。
+     */
+    extra?: (force: boolean) => void;
+    /** 是否在挂载时写入默认值，默认 true */
+    applyOnMount?: boolean;
+};
+/**
+ * 表单默认值 + 搜索重置统一处理：
+ * - 挂载时写入默认值（非 force：仅当字段为空）
+ * - 在 `w-list-search` / `w-detail-search` 内注册重置回调（force：强制回写）
+ * - 处于 `w-form-multi-item` 内且非当前选中项时跳过回写（含异步 defaultValue 解析完成后，
+ *   避免 Search 清空又被 default-value 钩子写回）
+ *
+ * @see WSearchRegisterResetKey
+ * @see FormMultiItemContextKey
+ */
+export declare function useFormDefaultValue<T>(options: UseFormDefaultValueOptions<T>): {
+    applyDefaultValue: (force?: boolean) => void;
+    isInactive: () => boolean;
+};
+export default useFormDefaultValue;

package/dist/types/hooks/private/src/useFormFieldRegister.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 向最近的搜索区（`w-search` / `w-list-search` / `w-detail-search`）上报本控件占用的 form 字段名。
+ *
+ * - 传入 getter（而非快照），字段名随 props 变化时无需重新注册
+ * - 不在搜索区内时为空实现，对详情 / 编辑等场景无副作用
+ * - 挂载时注册、卸载时取消；`w-form-multi-item` 下未激活的 Option 不挂载故不上报，
+ *   其字段由 MultiItem 自身上报全部 `option.model` 兜底
+ *
+ * @param getKeys 返回本控件占用的 form 字段名（如 `[model, startKey, endKey, labelModel]`）
+ * @see WSearchRegisterFieldKey
+ */
+export declare function useFormFieldRegister(getKeys: () => string[]): void;
+export default useFormFieldRegister;

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

@@ -7,6 +7,19 @@ export declare const WIconSizeKey: InjectionKey<NonNullable<WIconProp['size']>>;
 /** WSearch 重置时回调注册（如 DateRange 回写 defaultValue；可异步） */
 export type WSearchRegisterReset = (fn: () => void | Promise<void>) => () => void;
 export declare const WSearchRegisterResetKey: InjectionKey<WSearchRegisterReset>;
+/**
+ * WSearch 字段注册（表单控件自报本控件占用的 form 字段名）。
+ * 传入 getter（而非快照），字段名随 props 变化时无需重新注册。
+ */
+export type WSearchRegisterField = (getKeys: () => string[]) => () => void;
+export declare const WSearchRegisterFieldKey: InjectionKey<WSearchRegisterField>;
+/** WSearch 字段注册域：首行（main）/ 折叠区（more） */
+export type WSearchFieldScope = 'main' | 'more';
+/** WSearch 内部字段注册表（供内部作用域组件切换注册域） */
+export interface WSearchFieldRegistry {
+    add: (getKeys: () => string[], scope: WSearchFieldScope) => () => void;
+}
+export declare const WSearchFieldRegistryKey: InjectionKey<WSearchFieldRegistry>;
 /**
  * w-form-multi-item 已注册的 option 快照（由 WFormMultiItemOption 上报）
  */