@fox-js/foxui-pc 4.1.1-30 → 4.1.1-32

package/dist/style.js

@@ -1,3 +1,3 @@
 /*!
-* @fox-js/foxui-desktop v4.0.0 2026-04-20T14:37:29.729Z
+* @fox-js/foxui-desktop v4.0.0 2026-05-09T11:49:42.598Z
 */

package/dist/types/index.d.ts

@@ -1,7 +1,5 @@
 import { App } from 'vue';
 import { compareTo } from '@fox-js/big-decimal';
-import { ComponentInternalInstance } from 'vue';
-import { ComponentPublicInstance } from 'vue';
 import { DefineSetupFnComponent } from 'vue';
 import { divide } from '@fox-js/big-decimal';
 import { ExecuteValidator } from '@fox-js/validator';
@@ -161,9 +159,9 @@ export declare class Broadcast {
      */
     private callbacks;
     /**
-     * vue proxy
+     * vue exposed
      */
-    private proxy;
+    private exposed;
     /**
      * 名称
      */
@@ -175,10 +173,10 @@ export declare class Broadcast {
     /**
      * 构造函数
      * @param parent
-     * @param proxy
+     * @param exposed
      * @param name
      */
-    constructor(parent: Broadcast | null, proxy: FoxComponentPublicInstance, name?: string);
+    constructor(parent: Broadcast | null, exposed: FoxComponentPublicExposed, name?: string);
     /**
      * 加入孩子节点
      * @param child
@@ -293,25 +291,46 @@ export declare function clearNonNumber(value: string, allowDot?: boolean, allowM
 
 export { compareTo }
 
+/**
+ * 组件描述
+ */
+declare interface ComponentDescriptor {
+    componentName: string;
+    readonly?: boolean;
+    disabled?: boolean;
+    props?: Record<string, any>;
+    ignorePropKeys?: string[];
+    context: FoxSetupContext;
+    templateRefProxy?: FoxTemplateRefProxy;
+    fieldName?: string;
+    valueName?: string;
+    valueType?: ValueType;
+    validate?: boolean;
+    pureDataValidate?: boolean;
+    validateHandler?: ValidateHandler;
+    validateCheckEvents?: string[];
+    validateResetEvents?: string[];
+}
+
 /**
  * 创建broadcast
  *
- * @param proxy
+ * @param expose
  * @param parent
  * @param name
  * @param callbacks
  * @returns
  */
-export declare function createBroadcast(proxy: FoxComponentPublicInstance, parent: Broadcast | null, name?: string, callbacks?: Record<string, BroadcastCallback>): Broadcast;
+export declare function createBroadcast(exposed: FoxComponentPublicExposed, parent: Broadcast | null, name?: string, callbacks?: Record<string, BroadcastCallback>): Broadcast;
 
 /**
  * 创建校验schema
- * @param proxy
+ * @param exposed
  * @param parent
  * @param descriptor
  * @returns
  */
-export declare function createValidateSchema(proxy: FoxComponentPublicInstance, parent: ValidateSchema | null, descriptor: Descriptor): ValidateSchema;
+export declare function createValidateSchema(exposed: FoxComponentPublicExposed, parent: ValidateSchema | null, descriptor: ComponentDescriptor): ValidateSchema;
 
 /**
  * data items key
@@ -640,41 +659,44 @@ declare const _default_9: DefineSetupFnComponent<Record<string, any>, {}, {}, Re
 export { _default_9 as FoxRowItem }
 export { _default_9 as RowItem }
 
-/**
- * anyNode
- * @param name
- * @param callbacks
- * @returns
- */
-export declare function defineBroadcast(name?: string, callbacks?: Record<string, BroadcastCallback>, proxy?: FoxComponentPublicInstance): Broadcast | null;
-
 /**
  * 安装config domain
+ * @param descriptor domain组件描述
  * @param name 名称
- * @param props 属性
- * @param ignores 忽略的属性
  * @returns
  */
-export declare function defineConfigDomain(name: string | null, props: Record<string, any>, ignores?: any[]): Domain;
+export declare function defineConfigDomain(descriptor: DomainComponentDescriptor, name: string | null): {
+    domain: Domain;
+    exposeApi: (exposed?: FoxComponentPublicExposed) => void;
+};
 
 /**
- * 定义domain data item
+ * 定义data item
+ * @param domain domain
+ * @param name 名称
+ * @param descriptor 描述
+ * @param parentBroadcast parent broadcast
+ * @param parentValidateSchema parent validateSchema
  * @returns
  */
-export declare function defineDataItem(domain: Domain, name: string, descriptor: Descriptor, parentBroadcast: Broadcast, parentValidateSchema: ValidateSchema): {
+export declare function defineDataItem(domain: Domain, name: string, descriptor: ComponentDescriptor, parentBroadcast: Broadcast, parentValidateSchema: ValidateSchema): {
     broadcast: Broadcast;
     validateSchema: ValidateSchema;
+    componentPublicExposed: FoxComponentPublicExposed;
+    exposeApi: (exposed?: FoxComponentPublicExposed) => void;
 };
 
 /**
  * 安装domain
+ * @param descriptor domain组件描述
  * @param name 名称
- * @param props 属性
- * @param ignores 忽略的属性
- * @param exposes 暴露的方法
+ * @param broadcastCallbacks 消息
  * @returns
  */
-export declare function defineDomain(name: string | null, props: Record<string, any>, ignores?: any[], exposes?: Record<string, BroadcastCallback>): Domain;
+export declare function defineDomain(descriptor: DomainComponentDescriptor, name: string | null, messageListeners?: Record<string, BroadcastCallback>): {
+    domain: Domain;
+    exposeApi: (exposed?: FoxComponentPublicExposed) => void;
+};
 
 /**
  * 定义domain item属性
@@ -684,6 +706,7 @@ export declare function defineDomainItemProperty(props: {
     readonly?: boolean | string;
     browse?: 'off' | 'on';
 }): {
+    itemTemplateRef: Ref<any, any>;
     innerDisabled: Ref<boolean, boolean>;
     disabled: Ref<boolean, boolean>;
     innerReadonly: Ref<boolean, boolean>;
@@ -693,9 +716,20 @@ export declare function defineDomainItemProperty(props: {
 
 /**
  * 定义domain item
+ * @param descriptor 组件描述
+ * @param name 名称
+ * @param broadcastCallbacks 消息
  * @returns
  */
-export declare function defineItem(descriptor: Descriptor, name?: string, exposes?: Record<string, BroadcastCallback>): DomainItem;
+export declare function defineItem(descriptor: ComponentDescriptor, name?: string, broadcastCallbacks?: Record<string, BroadcastCallback>): {
+    broadcast: Broadcast;
+    validateSchema: ValidateSchema;
+    emitEvent: (type: string, ...args: any[]) => void;
+    onEvent: (type: string, listener: EventListener_2) => void;
+    offEvent: (type: string, listener: EventListener_2) => void;
+    componentPublicExposed: FoxComponentPublicExposed;
+    exposeApi: (exposed?: FoxComponentPublicExposed) => void;
+};
 
 /**
  * 创建page state
@@ -707,12 +741,15 @@ export declare function definePageState(domain: Domain, overrideProps?: Record<s
 
 /**
  * 定义simple item
+ * @param descriptor simple组件描述
  * @returns
  */
-export declare function defineSimpleItem(): {
+export declare function defineSimpleItem(descriptor: SimpleComponentDescriptor): {
     emitEvent: (type: string, ...args: any[]) => void;
     onEvent: (type: string, listener: EventListener_2) => void;
     offEvent: (type: string, listener: EventListener_2) => void;
+    componentPublicExposed: FoxComponentPublicExposed;
+    exposeApi: (exposed?: FoxComponentPublicExposed) => void;
 };
 
 /**
@@ -721,23 +758,6 @@ export declare function defineSimpleItem(): {
  */
 export declare function deleteGlobalValidator(type: string): void;
 
-/**
- * 组件描述
- */
-export declare interface Descriptor {
-    componentName: string;
-    fieldName?: string;
-    valueName?: string;
-    valueType?: ValueType;
-    validate?: boolean;
-    readonly?: boolean;
-    disabled?: boolean;
-    pureDataValidate?: boolean;
-    validateHandler?: ValidateHandler;
-    validateCheckEvents?: string[];
-    validateResetEvents?: string[];
-}
-
 declare type Direction = '' | 'vertical' | 'horizontal';
 
 /**
@@ -775,10 +795,18 @@ export declare class Domain {
     private _validateSchema;
     get validateSchema(): ValidateSchema | null;
     set validateSchema(val: ValidateSchema | null);
+    /**
+     * component public expose
+     */
+    componentPublicExposed: FoxComponentPublicExposed;
     /**
      * 属性集合
      */
     private _props;
+    /**
+     * 本地数据集合
+     */
+    private _datas;
     /**
      * 构造函数
      * @param name
@@ -788,11 +816,34 @@ export declare class Domain {
      * 销毁
      */
     destroy(): void;
+    /**
+     * 设置数据
+     * @param key
+     * @param data
+     */
+    setData(key: string | number | symbol, data: any): void;
+    /**
+     * 获取本地数据
+     * @param key
+     */
+    getData(key: string | number | symbol): any;
+    /**
+     * 是否有本地数据
+     * @param key
+     * @returns
+     */
+    hasData(key: string | number | symbol): boolean;
+    /**
+     * 删除本地数据
+     * @param key
+     * @returns
+     */
+    deleteData(key: string | number | symbol): boolean;
     /**
      * 合并属性
      * @param props
      */
-    merge(props: Record<string | number, any>, ignores?: any[]): void;
+    merge(props: Record<string | number, any>, ignores?: string[]): void;
     /**
      * 判断是否有属性
      */
@@ -836,20 +887,15 @@ export declare class Domain {
 }
 
 /**
- * domain item
+ * Domain组件描述
  */
-export declare interface DomainItem {
-    broadcast: Broadcast;
-    validateSchema: ValidateSchema;
-    emitEvent: {
-        (type: string, ...args: any[]): void;
-    };
-    onEvent: {
-        (type: string, listener: EventListener_2): void;
-    };
-    offEvent: {
-        (type: string, listener: EventListener_2): void;
+declare interface DomainComponentDescriptor {
+    props?: Record<string, any> | {
+        (): Record<string, any>;
     };
+    ignorePropKeys?: string[];
+    context: FoxSetupContext;
+    templateRefProxy?: FoxTemplateRefProxy;
 }
 
 /**
@@ -857,6 +903,11 @@ export declare interface DomainItem {
  */
 export declare const DomainKey: unique symbol;
 
+/**
+ * exposed
+ */
+declare type EmitFn = (...args: any) => void;
+
 /**
  * event listener
  */
@@ -872,6 +923,11 @@ declare interface EventListener_2 {
  */
 export declare function excludeProps(src: Record<string, any>, ...excludeTemplates: Record<string, any>[]): Record<string, any>;
 
+/**
+ * expose function
+ */
+declare type ExposeFn = (exposed?: Record<string, any>) => void;
+
 /**
  * 继承（是否深度拷贝,dest,src1,src2,src3...）
  *
@@ -946,7 +1002,20 @@ export { FoxCollapseTransition }
 
 export { FoxColorPicker }
 
-declare type FoxComponentPublicInstance = any;
+/**
+ * component public exposed
+ */
+declare type FoxComponentPublicExposed = Record<string | number | symbol, any>;
+
+/**
+ * component public exposed
+ */
+declare type FoxComponentPublicProxy = {
+    exposed: FoxComponentPublicExposed;
+    $el?: HTMLElement;
+    props: Record<string, any>;
+    attrs: Record<string, any>;
+};
 
 export { FoxConfigProvider }
 
@@ -1048,6 +1117,15 @@ export { FoxSelect }
 
 export { FoxSelectV2 }
 
+/**
+ *  Fox setup context
+ */
+declare type FoxSetupContext = {
+    attrs: Record<string, any>;
+    emit: EmitFn;
+    expose: ExposeFn;
+};
+
 export { FoxSkeleton }
 
 export { FoxSkeletonItem }
@@ -1078,6 +1156,11 @@ export { FoxTabs }
 
 export { FoxTag }
 
+/**
+ *  template ref proxy
+ */
+declare type FoxTemplateRefProxy = any;
+
 export { FoxTimeline }
 
 export { FoxTimelineItem }
@@ -1122,6 +1205,11 @@ declare interface FoxUI {
      * @param getter
      */
     setScopeGetter(getter: ScopeGetter): void;
+    /**
+     * 获取scope getter
+     * @param getter
+     */
+    getScopeGetter(): ScopeGetter | null;
     /**
      * 设置API
      * @param name
@@ -1131,11 +1219,10 @@ declare interface FoxUI {
     setAPI(name: string, func: any, scope?: string): void;
     /**
      * 获取API
-     * @param proxy
      * @param name
      * @param scope
      */
-    getAPI(proxy: ComponentPublicInstance, name: string, scope?: string): any | null;
+    getAPI(name: string, scope?: string): any | null;
     /**
      * 批量增加api
      * @param apis
@@ -1211,6 +1298,10 @@ declare class FoxUIVue implements FoxUI {
      * @param getter
      */
     setScopeGetter(getter: ScopeGetter): void;
+    /**
+     * 获取scope getter
+     */
+    getScopeGetter(): ScopeGetter | null;
     /**
      * 设置API
      * @param name
@@ -1224,7 +1315,7 @@ declare class FoxUIVue implements FoxUI {
      * @param name
      * @param scope
      */
-    getAPI(proxy: ComponentPublicInstance, name: string, scope?: string): any | null;
+    getAPI(name: string, scope?: string): any | null;
     /**
      * 批量增加api
      * @param apis
@@ -1854,9 +1945,10 @@ export declare interface SafeAreaInset {
 
 /**
  * scope getter
+ * 需要保证该函数能够在 InjectionContext 上下文中允许
  */
 declare interface ScopeGetter {
-    (proxy: ComponentPublicInstance): string | null;
+    (): string | null;
 }
 
 /**
@@ -1889,6 +1981,13 @@ export declare function setGlobalValidateResetEvents(events: string[]): void;
  */
 export declare function setGlobalValidator(type: string, validator: ExecuteValidator): void;
 
+/**
+ * simple组件描述
+ */
+declare interface SimpleComponentDescriptor {
+    context: FoxSetupContext;
+}
+
 /**
  * size
  */
@@ -2029,22 +2128,16 @@ export declare function updatePageState(state: PageState, pageLayout: any, overr
 
 /**
  * 使用broadcast
- * @param proxy
+ * @param expose
  * @returns
  */
-export declare function useBroadcast(proxy?: FoxComponentPublicInstance | null): Broadcast | null;
+export declare function useBroadcast(exposed?: FoxComponentPublicExposed): Broadcast | null;
 
 /**
  * 获取当前domain
  * @returns
  */
-export declare function useDomain(proxy?: ComponentPublicInstance | null): Domain | null;
-
-/**
- * use expose
- * @param apis
- */
-export declare function useExpose(apis: Record<string, any>, instance?: ComponentInternalInstance | null): void;
+export declare function useDomain(): Domain | null;
 
 /**
  * 获取内部可用size
@@ -2133,55 +2226,39 @@ export declare function useTouch(): {
     isHorizontal: () => boolean;
 };
 
-/**
- * 校验条件
- */
-export declare interface ValidateCondition {
-    deep?: boolean;
-    include?: string[];
-    exclude?: string[];
-    ignoreHidden?: boolean;
-    ignoreDisabled?: boolean;
-    ignoreReadonly?: boolean;
-}
-
 /**
  * 校验器handler
  */
-export declare interface ValidateHandler {
+declare interface ValidateHandler {
     /**
      * 错误处理
      * @param errorMsg
      * @param proxy
      *
      */
-    error?(errorMsg: string, proxy: FoxComponentPublicInstance): void;
+    error?(errorMsg: string, proxy: FoxComponentPublicProxy): void;
     /**
      * 重置处理
      * @param proxy
-     *
      */
-    reset?(proxy: FoxComponentPublicInstance): void;
+    reset?(proxy: FoxComponentPublicProxy): void;
     /**
      * 成功处理
      * @param proxy
-     *
      */
-    success?(proxy: FoxComponentPublicInstance): void;
+    success?(proxy: FoxComponentPublicProxy): void;
     /**
      * 规则装饰处理
      * @param newRule
      * @param oldRule
      * @param proxy
-     *
      */
-    decorate?(newRule: Rule, oldRule: Rule, proxy: FoxComponentPublicInstance): void;
+    decorate?(newRule: Rule, oldRule: Rule, proxy: FoxComponentPublicProxy): void;
     /**
      * 获取value
      * @param proxy
-     *
      */
-    getValue?(proxy: FoxComponentPublicInstance): any;
+    getValue?(proxy: FoxComponentPublicProxy): any;
 }
 
 /**
@@ -2209,7 +2286,7 @@ export declare class ValidateSchema {
      */
     private descriptor;
     /**
-     * 实例
+     *  组件public proxy
      */
     private proxy;
     /**
@@ -2222,7 +2299,7 @@ export declare class ValidateSchema {
      * @param descriptor
      * @param proxy
      */
-    constructor(parent: ValidateSchema | null, descriptor: Descriptor, proxy: FoxComponentPublicInstance);
+    constructor(parent: ValidateSchema | null, descriptor: ComponentDescriptor, proxy: FoxComponentPublicProxy);
     /**
      * 初始化
      */
@@ -2322,6 +2399,6 @@ export declare function valueLength(val: unknown): number;
 /**
  * value 类型
  */
-export declare type ValueType = 'string' | 'number' | 'date';
+declare type ValueType = 'string' | 'number' | 'date';
 
 export { }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fox-js/foxui-pc",
   "type": "module",
-  "version": "4.1.1-30",
+  "version": "4.1.1-32",
   "description": "FoxUI PC端组件库",
   "author": "jiangcheng",
   "main": "./dist/index.umd.js",