@ives_xxz/framework 2.1.29 → 2.1.31

package/define/FWSystemDefine.ts

@@ -44,10 +44,10 @@ export class FWLayerType {
 }
 
 export class FWTaskStatus {
-  IDLE = 'IDLE';
-  RUNNING = 'RUNNING';
-  PAUSED = 'PAUSED';
-  COMPLETED = 'COMPLETED';
+  IDLE = "IDLE";
+  RUNNING = "RUNNING";
+  PAUSED = "PAUSED";
+  COMPLETED = "COMPLETED";
 }
 
 export class FWPriorityOrder {
@@ -91,17 +91,22 @@ export class FWLogType {
  * HTTP请求类型
  */
 export class FWHttpRequestType {
-  GET = 'GET';
-  POST = 'POST';
+  GET = "GET";
+  POST = "POST";
 }
 
 /**
  * 动画机类型
  */
 export class FWAnimationMachineType {
-  TWEEN = 'TWEEN';
-  SKELETON = 'SKELETON';
-  ANIMATION = 'ANIMATION';
+  TWEEN = "TWEEN";
+  SKELETON = "SKELETON";
+  ANIMATION = "ANIMATION";
+}
+
+export class FWVirtualScrollViewDirection {
+  VERTICAL = 0;
+  HORIZONTAL = 1;
 }
 
 export class FWScrollViewTemplateType {
@@ -122,23 +127,23 @@ export class FWScrollViewSelectedType {
 }
 
 export class FWLanguageAssetType {
-  LABEL = 'label';
-  SPRITE = 'sprite';
-  SKELETON = 'skeleton';
+  LABEL = "label";
+  SPRITE = "sprite";
+  SKELETON = "skeleton";
 }
 
 export class FWPromiseStatus {
-  PENDING = 'pending';
-  FULFILLED = 'fulfilled';
-  REJECTED = 'rejected';
-  CANCELLED = 'cancelled';
+  PENDING = "pending";
+  FULFILLED = "fulfilled";
+  REJECTED = "rejected";
+  CANCELLED = "cancelled";
 }
 
 export class FWLayerState {
-  CLOSED = 'closed';
-  OPENING = 'opening';
-  OPENED = 'opened';
-  CLOSING = 'closing';
+  CLOSED = "closed";
+  OPENING = "opening";
+  OPENED = "opened";
+  CLOSING = "closing";
 }
 
 export class FWAudioType {

package/entry/FWEntry.ts

@@ -16,6 +16,7 @@ import FWEngineManager from '../manager/FWEngineManager';
 import FWHotUpdateManager from '../manager/FWHotUpdateManager';
 import FWPromiseManager from '../manager/FWPromiseManager';
 import { FWPerformanceManager } from '../manager/FWPerformanceManager';
+import FWUtils from '../utils/FWUtils';
 
 /**
  * 入口脚本
@@ -90,6 +91,8 @@ export class FWEntry implements FW.Entry {
    * 性能管理器
    */
   performanceMgr: FW.PerformanceManager;
+
+  utils: FW.Utils;
   /**
    * 当前Scene
    */
@@ -119,6 +122,7 @@ export class FWEntry implements FW.Entry {
     this.hotUpdateMgr = new FWHotUpdateManager();
     this.promiseMgr = new FWPromiseManager();
     this.performanceMgr = new FWPerformanceManager();
+    this.utils = new FWUtils();
   }
 
   /**

package/manager/FWAssetManager.ts

@@ -53,12 +53,17 @@ export class FWAssetManager extends FWManager implements FW.AssetManager {
               { url: ske, ext: type },
             ],
             async (error, assets) => {
-              const texture: cc.Texture2D = await this.loadRemote();
+              if (error != null) {
+                reject(error);
+                return;
+              }
+              const fileName = FW.Entry.utils.getFileName(img);
+              const texture: cc.Texture2D = await this.loadRemote(img);
               var asset = new sp.SkeletonData();
-              asset.skeletonJson = assets[1];
               asset.atlasText = assets[0];
+              asset.skeletonJson = assets[1];
               asset.textures.push(texture);
-              asset['textureNames'] = [`${img}.png`];
+              asset['textureNames'] = [`${fileName}`];
               asset['_uuid'] = ske;
               resolve(asset);
             },

package/manager/FWLayerManager.ts

@@ -1,9 +1,9 @@
-import { FWManager } from './FWManager';
-import { FWQueue } from '../utils/FWQueue';
-import { FrameworkBase } from '../FrameworkBase';
-import { PerformanceMonitor } from '../expand/FWDecorator';
+import { FWManager } from "./FWManager";
+import { FWQueue } from "../utils/FWQueue";
+import { FrameworkBase } from "../FrameworkBase";
+import { PerformanceMonitor } from "../expand/FWDecorator";
 
-const ADD_EXTERNAL_REFERENCE: string = 'addExternalReference';
+const ADD_EXTERNAL_REFERENCE: string = "addExternalReference";
 
 export class FWLayerManager extends FWManager implements FW.LayerManager {
   private resourceManager: FWLayerResourceManager;
@@ -34,7 +34,7 @@ export class FWLayerManager extends FWManager implements FW.LayerManager {
   /**
    * 异步打开Layer
    */
-  @PerformanceMonitor('openAsync')
+  @PerformanceMonitor("openAsync")
   async openAsync<Ctr extends FW.LayerController = FW.LayerController>(
     data: FW.LayerOpenArgs,
   ): Promise<Ctr> {
@@ -44,17 +44,23 @@ export class FWLayerManager extends FWManager implements FW.LayerManager {
   /**
    * 同步打开
    */
-  openSync<Ctr extends FW.LayerController = FW.LayerController>(data: FW.LayerOpenArgs): Ctr {
+  openSync<Ctr extends FW.LayerController = FW.LayerController>(
+    data: FW.LayerOpenArgs,
+  ): Ctr {
     return this.openManager.openLayerSync(data) as Ctr;
   }
 
   /**
    * 显示layer并恢复所有节点事件
    */
-  displayLayer<Ctr extends FW.LayerController = FW.LayerController>(ctr: Ctr): Ctr {
+  displayLayer<Ctr extends FW.LayerController = FW.LayerController>(
+    ctr: Ctr,
+  ): Ctr {
     const layerData = ctr.layerData;
 
-    if (!this.dataManager.getLayerMap().has(ctr.layerData.controllerConstructor)) {
+    if (
+      !this.dataManager.getLayerMap().has(ctr.layerData.controllerConstructor)
+    ) {
       FW.Log.warn(`display layer failed,layer name : ${layerData.layerName}`);
       return;
     }
@@ -74,9 +80,13 @@ export class FWLayerManager extends FWManager implements FW.LayerManager {
   /**
    * 隐藏layer并隐藏所有节点事件
    */
-  hideLayer<Ctr extends FW.LayerController = FW.LayerController>(ctr: Ctr): Ctr {
+  hideLayer<Ctr extends FW.LayerController = FW.LayerController>(
+    ctr: Ctr,
+  ): Ctr {
     const layerData = ctr.layerData;
-    if (!this.dataManager.getLayerMap().has(ctr.layerData.controllerConstructor)) {
+    if (
+      !this.dataManager.getLayerMap().has(ctr.layerData.controllerConstructor)
+    ) {
       FW.Log.warn(`hide layer failed,layer name : ${layerData.layerName}`);
       return;
     }
@@ -120,7 +130,9 @@ export class FWLayerManager extends FWManager implements FW.LayerManager {
     for (let i = 0; i < count; i++) {
       let layerData = this.stackManager.pop();
       let ctr = layerData.controller;
-      if (!this.dataManager.getLayerMap().has(layerData.controllerConstructor)) {
+      if (
+        !this.dataManager.getLayerMap().has(layerData.controllerConstructor)
+      ) {
         return;
       }
       if (cc.isValid(ctr.layer?.node)) {
@@ -151,7 +163,9 @@ export class FWLayerManager extends FWManager implements FW.LayerManager {
   /**
    * 关闭layer
    */
-  async close<Ctr extends FW.LayerController = FW.LayerController>(ctr: Ctr): Promise<Ctr> {
+  async close<Ctr extends FW.LayerController = FW.LayerController>(
+    ctr: Ctr,
+  ): Promise<Ctr> {
     if (!ctr) return;
 
     return FW.Entry.promiseMgr.execute(async (resolve, reject) => {
@@ -242,7 +256,8 @@ export class FWLayerData<T extends FW.LayerController = FW.LayerController>
 class FWLayerDataManager {
   private layerMap: Map<new () => FW.LayerController, FWLayerData> = new Map();
   private layerRegistry: Set<new () => FW.LayerController> = new Set();
-  private layerControllerFactory: FWLayerControllerFactory = new FWLayerControllerFactory();
+  private layerControllerFactory: FWLayerControllerFactory =
+    new FWLayerControllerFactory();
   /**
    * 获取已存在的Layer
    */
@@ -370,7 +385,7 @@ class FWLayerDataManager {
       try {
         cb?.(null);
       } catch (e) {
-        FW.Log.error('External ref update callback error:', e);
+        FW.Log.error("External ref update callback error:", e);
       }
     });
     layerData.externalReference.clear();
@@ -395,7 +410,8 @@ class FWLayerDataManager {
 }
 
 class FWLayerCreateManager {
-  private lifecycleManager: FWLayerLifecycleManager = new FWLayerLifecycleManager();
+  private lifecycleManager: FWLayerLifecycleManager =
+    new FWLayerLifecycleManager();
 
   /**
    * 创建Layer节点
@@ -476,7 +492,12 @@ class FWLayerOpenManager {
       return proxy as Ctr;
     }
 
-    if (this.queueManager.handlePopupQueue(layerData, this.dataManager.getLayerMap())) {
+    if (
+      this.queueManager.handlePopupQueue(
+        layerData,
+        this.dataManager.getLayerMap(),
+      )
+    ) {
       return undefined;
     }
 
@@ -485,7 +506,9 @@ class FWLayerOpenManager {
     return this.asyncGenerationLayer(layerData, data);
   }
 
-  openLayerSync<Ctr extends FW.LayerController = FW.LayerController>(data: FW.LayerOpenArgs): Ctr {
+  openLayerSync<Ctr extends FW.LayerController = FW.LayerController>(
+    data: FW.LayerOpenArgs,
+  ): Ctr {
     if (!this.validateOpenData(data)) {
       return undefined;
     }
@@ -506,7 +529,12 @@ class FWLayerOpenManager {
       return proxy as Ctr;
     }
 
-    if (this.queueManager.handlePopupQueue(layerData, this.dataManager.getLayerMap())) {
+    if (
+      this.queueManager.handlePopupQueue(
+        layerData,
+        this.dataManager.getLayerMap(),
+      )
+    ) {
       return undefined;
     }
 
@@ -529,10 +557,9 @@ class FWLayerOpenManager {
   /**
    * 异步生成Layer
    */
-  private async asyncGenerationLayer<Ctr extends FW.LayerController = FW.LayerController>(
-    layerData: FWLayerData,
-    data: FW.LayerOpenArgs,
-  ): Promise<Ctr> {
+  private async asyncGenerationLayer<
+    Ctr extends FW.LayerController = FW.LayerController,
+  >(layerData: FWLayerData, data: FW.LayerOpenArgs): Promise<Ctr> {
     try {
       const res = await this.resourceManager.loadLayerAsync(layerData);
       const ctr = this.createLayer(layerData, res, data) as Ctr;
@@ -548,10 +575,9 @@ class FWLayerOpenManager {
   /**
    * 同步创建Layer
    */
-  private syncGenerationLayer<Ctr extends FW.LayerController = FW.LayerController>(
-    layerData: FWLayerData,
-    data: FW.LayerOpenArgs,
-  ): Ctr {
+  private syncGenerationLayer<
+    Ctr extends FW.LayerController = FW.LayerController,
+  >(layerData: FWLayerData, data: FW.LayerOpenArgs): Ctr {
     try {
       const res = this.resourceManager.loadLayerSync(layerData);
       const ctr = this.createLayer(layerData, res, data) as Ctr;
@@ -587,22 +613,30 @@ class FWLayerOpenManager {
 
     this.createManager.setupLayerLifecycle(layer, layerData.controller);
 
-    if (layerData.controller.layerType !== FW.SystemDefine.FWLayerType.PERMANENT) {
+    if (
+      layerData.controller.layerType !== FW.SystemDefine.FWLayerType.PERMANENT
+    ) {
       this.stackManager.push(layerData);
     }
 
     this.dataManager.removeFromRegistry(layerData.controllerConstructor);
 
-    layerData.controllerProxy = this.dataManager.createControllerProxy(layerData);
+    layerData.controllerProxy =
+      this.dataManager.createControllerProxy(layerData);
 
     return layerData.controllerProxy as Ctr;
   }
 }
 
 class FWLayerResourceManager {
-  async loadLayerAsync(layerData: FWLayerData): Promise<{ asset: cc.Prefab; uuid: string }> {
+  async loadLayerAsync(
+    layerData: FWLayerData,
+  ): Promise<{ asset: cc.Prefab; uuid: string }> {
     try {
-      const res = await FW.Entry.resMgr.loadAssetData<cc.Prefab>(layerData.layerAssetProperty);
+      const res = await FW.Entry.resMgr.loadAssetData<cc.Prefab>(
+        layerData.layerAssetProperty,
+      );
+      if (!res) return undefined;
       res.user = layerData.layerName;
       res.autoRelease = layerData.controller.autoRelease;
       res.dependentBundle = layerData.controller.layerAssetProperty.bundle;
@@ -616,7 +650,9 @@ class FWLayerResourceManager {
   loadLayerSync(layerData: FWLayerData): { asset: cc.Prefab; uuid: string } {
     layerData.layerAssetProperty.bundle =
       layerData.layerAssetProperty.bundle || FW.Entry.bundleName;
-    const res = FW.Entry.resMgr.getAssetData<cc.Prefab>(layerData.layerAssetProperty);
+    const res = FW.Entry.resMgr.getAssetData<cc.Prefab>(
+      layerData.layerAssetProperty,
+    );
     res.user = layerData.layerName;
     res.autoRelease = layerData.controller.autoRelease;
     res.dependentBundle = layerData.controller.layerAssetProperty.bundle;
@@ -628,7 +664,9 @@ class FWLayerStackManager {
   private layerStack: FWLayerData[] = [];
 
   push(layerData: FWLayerData): void {
-    if (layerData.controller.layerType !== FW.SystemDefine.FWLayerType.PERMANENT) {
+    if (
+      layerData.controller.layerType !== FW.SystemDefine.FWLayerType.PERMANENT
+    ) {
       this.layerStack.push(layerData);
     }
   }
@@ -638,7 +676,9 @@ class FWLayerStackManager {
   }
 
   remove(layerData: FWLayerData): void {
-    const index = this.layerStack.findIndex((v) => v.controller === layerData.controller);
+    const index = this.layerStack.findIndex(
+      (v) => v.controller === layerData.controller,
+    );
     if (index > -1) {
       this.layerStack.splice(index, 1);
     }
@@ -654,13 +694,21 @@ class FWLayerStackManager {
 }
 
 class FWLayerStateManager {
-  private layerStates = new Map<new () => FW.LayerController, FW.SystemDefine.FWLayerState>();
-
-  setState(ctrType: new () => FW.LayerController, state: FW.SystemDefine.FWLayerState): void {
+  private layerStates = new Map<
+    new () => FW.LayerController,
+    FW.SystemDefine.FWLayerState
+  >();
+
+  setState(
+    ctrType: new () => FW.LayerController,
+    state: FW.SystemDefine.FWLayerState,
+  ): void {
     this.layerStates.set(ctrType, state);
   }
 
-  getState(ctrType: new () => FW.LayerController): FW.SystemDefine.FWLayerState {
+  getState(
+    ctrType: new () => FW.LayerController,
+  ): FW.SystemDefine.FWLayerState {
     return this.layerStates.get(ctrType) || FW.SystemDefine.FWLayerState.CLOSED;
   }
 
@@ -692,7 +740,9 @@ class FWLayerQueueManager {
     layerData: FWLayerData,
     layerMap: Map<new () => FW.LayerController, FWLayerData>,
   ): boolean {
-    if (layerData.controller.layerType === FW.SystemDefine.FWLayerType.POPUP_QUEUE) {
+    if (
+      layerData.controller.layerType === FW.SystemDefine.FWLayerType.POPUP_QUEUE
+    ) {
       const hasNonPermanentLayers = Array.from(layerMap.values()).some(
         (value) => value.layerType === FW.SystemDefine.FWLayerType.POPUP_QUEUE,
       );
@@ -732,44 +782,44 @@ class FWLayerQueueManager {
 
 class FWLayerLifecycleManager {
   setupLifecycleHooks(layer: FW.Layer, ctr: FW.LayerController): void {
-    const originalOnLoad = layer['onLoad'];
-    layer['onLoad'] = function () {
+    const originalOnLoad = layer["onLoad"];
+    layer["onLoad"] = function () {
       originalOnLoad?.call(this);
       ctr.onLoad?.();
     };
 
-    const originalStart = layer['start'];
-    layer['start'] = function () {
+    const originalStart = layer["start"];
+    layer["start"] = function () {
       originalStart?.call(this);
       ctr.onStart?.();
     };
 
-    const originalOnEnable = layer['onEnable'];
-    layer['onEnable'] = function () {
+    const originalOnEnable = layer["onEnable"];
+    layer["onEnable"] = function () {
       originalOnEnable?.call(this);
       ctr.onEnable?.();
     };
 
-    const originalOnDisable = layer['onDisable'];
-    layer['onDisable'] = function () {
+    const originalOnDisable = layer["onDisable"];
+    layer["onDisable"] = function () {
       originalOnDisable?.call(this);
       ctr.onDisable?.();
     };
 
-    const originalOnDestroy = layer['onDestroy'];
-    layer['onDestroy'] = function () {
+    const originalOnDestroy = layer["onDestroy"];
+    layer["onDestroy"] = function () {
       originalOnDestroy?.call(this);
       ctr.onDestroy?.();
     };
 
-    const originalUpdate = layer['update'];
-    layer['update'] = function (dt: number) {
+    const originalUpdate = layer["update"];
+    layer["update"] = function (dt: number) {
       originalUpdate?.call(this, dt);
       ctr.onUpdate?.(dt);
     };
 
-    const originalLateUpdate = layer['lateUpdate'];
-    layer['lateUpdate'] = function () {
+    const originalLateUpdate = layer["lateUpdate"];
+    layer["lateUpdate"] = function () {
       originalLateUpdate?.call(this);
       ctr.onLateUpdate?.();
     };
@@ -780,12 +830,12 @@ class FWLayerControllerFactory {
   /**
    * 创建并初始化 LayerController
    */
-  createController<Ctr extends FW.LayerController = FW.LayerController>(type: new () => Ctr): Ctr {
+  createController<Ctr extends FW.LayerController = FW.LayerController>(
+    type: new () => Ctr,
+  ): Ctr {
     const ctr = new type();
 
-    if (ctr instanceof FrameworkBase) {
-      ctr.initializeDependencies?.();
-    }
+    ctr.initializeDependencies?.();
 
     return ctr;
   }

package/manager/FWObjectManager.ts

@@ -1,8 +1,10 @@
-import FWObject from '../utils/FWObject';
-import { FWObjectPool } from '../utils/FWObjectPool';
-import { FWManager } from './FWManager';
+import { FWObjectPool } from "../utils/FWObjectPool";
+import { FWManager } from "./FWManager";
 
-export default class FWObjectManager extends FWManager implements FW.ObjectManager {
+export default class FWObjectManager
+  extends FWManager
+  implements FW.ObjectManager
+{
   public initialize(): void {
     this.poolMap = new Map<string, FWObjectPool>();
     this.poolIdCounter = 0;
@@ -22,40 +24,42 @@ export default class FWObjectManager extends FWManager implements FW.ObjectManag
   private poolMap: Map<string, FWObjectPool>;
   private poolIdCounter: number = 0;
 
-  async createObjectPool<T extends FWObject = FWObject>(
+  async createObjectPool<T extends FW.Object = FW.Object>(
     node: cc.Node,
     parent: cc.Node,
     tag?: string,
   ): Promise<FWObjectPool>;
-  async createObjectPool<T extends FWObject = FWObject>(
+  async createObjectPool<T extends FW.Object = FW.Object>(
     prefab: cc.Prefab,
     parent: cc.Node,
     tag?: string,
   ): Promise<FWObjectPool>;
-  async createObjectPool<T extends FWObject = FWObject>(
+  async createObjectPool<T extends FW.Object = FW.Object>(
     assetProperty: FW.AssetProperty,
     parent: cc.Node,
     tag?: string,
   ): Promise<FWObjectPool>;
-  async createObjectPool<T extends FWObject = FWObject>(
+  async createObjectPool<T extends FW.Object = FW.Object>(
     node: cc.Node,
     parent: cc.Node,
     type?: number,
   ): Promise<FWObjectPool>;
-  async createObjectPool<T extends FWObject = FWObject>(
+  async createObjectPool<T extends FW.Object = FW.Object>(
     prefab: cc.Prefab,
     parent: cc.Node,
     type?: number,
   ): Promise<FWObjectPool>;
-  async createObjectPool<T extends FWObject = FWObject>(
+  async createObjectPool<T extends FW.Object = FW.Object>(
     assetProperty: FW.AssetProperty,
     parent: cc.Node,
     type?: number,
   ): Promise<FWObjectPool>;
-  async createObjectPool<T extends FWObject = FWObject>(): Promise<FWObjectPool> {
+  async createObjectPool<
+    T extends FW.Object = FW.Object,
+  >(): Promise<FWObjectPool> {
     if (arguments.length < 2 || arguments.length > 3) {
-      FW.Log.error('createObjectPool 参数数量错误,需要2-3个参数');
-      throw new Error('Invalid arguments count');
+      FW.Log.error("createObjectPool 参数数量错误,需要2-3个参数");
+      throw new Error("Invalid arguments count");
     }
 
     let objectNode: cc.Node = null;
@@ -74,7 +78,8 @@ export default class FWObjectManager extends FWManager implements FW.ObjectManag
         objectNode = cc.instantiate(objectPrefab);
       } else {
         objectAssetProperty = resources;
-        objectPrefab = await FW.Entry.resMgr.loadAsset<cc.Prefab>(objectAssetProperty);
+        objectPrefab =
+          await FW.Entry.resMgr.loadAsset<cc.Prefab>(objectAssetProperty);
         if (!objectPrefab) {
           throw new Error(`加载预制体失败: ${objectAssetProperty.path}`);
         }
@@ -83,14 +88,14 @@ export default class FWObjectManager extends FWManager implements FW.ObjectManag
 
       objectParent = arguments[1];
       if (!(objectParent instanceof cc.Node)) {
-        throw new Error('第二个参数必须是 cc.Node 类型');
+        throw new Error("第二个参数必须是 cc.Node 类型");
       }
 
       const arg = arguments[2];
-      if (typeof arg === 'string') {
+      if (typeof arg === "string") {
         objectTag = arg;
         objectType = FW.SystemDefine.FWObjectType.OPACITY;
-      } else if (typeof arg === 'number') {
+      } else if (typeof arg === "number") {
         objectTag = `pool_${this.poolIdCounter++}`;
         objectType = arg;
       } else {
@@ -107,7 +112,7 @@ export default class FWObjectManager extends FWManager implements FW.ObjectManag
 
       return pool;
     } catch (error) {
-      FW.Log.error('创建对象池失败:', error);
+      FW.Log.error("创建对象池失败:", error);
 
       if (objectNode && objectNode.isValid) {
         objectNode.destroy();

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@ives_xxz/framework",
-  "version": "2.1.29",
+  "version": "2.1.31",
   "description": "cocoscreator 2.x mvc framework",
   "main": "index.js",
-  "keywords": ["123456"],
+  "keywords": [
+    "123456"
+  ],
   "author": "ives",
   "license": "ISC"
 }

package/types/FW.d.ts

@@ -68,6 +68,8 @@ declare namespace FW {
     promiseMgr: PromiseManager;
     /** 性能管理器 */
     performanceMgr: PerformanceManager;
+    /** 通用工具类 */
+    utils: Utils;
     /** 场景组件 */
     scene: Scene;
     /** 当前bundle名称 */
@@ -311,6 +313,7 @@ declare namespace FW {
     getEnableObjectMap();
     getDisableObjectMap();
     getAllObjectMap();
+    isEmpty():boolean;
     findObjectProperty(node: cc.Node);
     findObjectProperty(component: FW.Object);
     findObjectProperty(uniqueId: number);
@@ -2040,6 +2043,30 @@ declare namespace FW {
     y?: number;
   };
 
+
+  type VirtualScrollViewListener = 
+  {
+    onRender(element:ObjectProperty,index: number,...args:any);
+    onTouchElement(element:ObjectProperty,index: number,...args:any);
+  }
+
+  type VirtualScrollViewConfig = {
+    /**
+     * 列表个数
+     */
+    count: number;
+    rollingDirection: cc.Enum<FW.SystemDefine.FWVirtualScrollViewDirection>;
+    /**
+     * 预制体
+     */
+    prefab: cc.Prefab;
+    /**
+     * 列表容器
+     */
+    container:cc.Node;
+  }
+
+
   type VirtualViewListener = (item: cc.Node, id: number, ...data: any) => void;
   type VirtualViewComponentArgs = {
     /**
@@ -2346,6 +2373,10 @@ declare namespace FW {
     $descriptorOrInitializer?: any,
   ) => void;
 
+  type Utils = {
+    getFileName(url: string): string;
+  }
+
   declare function timeScale(scale: number);
   declare let Entry: Entry;
 }
@@ -2444,6 +2475,11 @@ declare namespace FW {
       static SUB_LOGIC = 5;
     }
 
+    export class FWVirtualScrollViewDirection{
+      static VERTICAL = 0;
+      static HORIZONTAL = 1;
+    }
+
     /**
      * 对象类型
      */