@galacean/engine-core 2.0.0-alpha.38 → 2.0.0-alpha.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-core",
-  "version": "2.0.0-alpha.38",
+  "version": "2.0.0-alpha.39",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -18,10 +18,10 @@
     "types/**/*"
   ],
   "dependencies": {
-    "@galacean/engine-math": "2.0.0-alpha.38"
+    "@galacean/engine-math": "2.0.0-alpha.39"
   },
   "devDependencies": {
-    "@galacean/engine-design": "2.0.0-alpha.38"
+    "@galacean/engine-design": "2.0.0-alpha.39"
   },
   "scripts": {
     "b:types": "tsc"

package/types/Canvas.d.ts

@@ -1,19 +1,35 @@
 /**
- * Canvas.
+ * The canvas the engine renders to; owns the render-buffer resolution.
  */
 export declare abstract class Canvas {
     private _width;
     private _height;
     /**
-     * The width of the canvas.
+     * The width component of the canvas resolution, in pixels.
      */
     get width(): number;
-    set width(value: number);
     /**
-     *The height of the canvas.
+     * The height component of the canvas resolution, in pixels.
      */
     get height(): number;
-    set height(value: number);
-    protected abstract _onWidthChanged(value: number): void;
-    protected abstract _onHeightChange(value: number): void;
+    /**
+     * Lock the render buffer to an explicit resolution and stop following the display size.
+     * @param width - Render buffer width in pixels
+     * @param height - Render buffer height in pixels
+     *
+     * @throws
+     * Throw an error if width or height is not a positive finite number.
+     */
+    setResolution(width: number, height: number): void;
+    /**
+     * Make the render buffer automatically follow the canvas display size.
+     * @param scale - Multiplier applied to the device pixel ratio (1 = native sharpness, 0.7 = save GPU, 2 = supersample), defaults to `1`
+     *
+     * @throws
+     * Throw an error if scale is not a positive finite number.
+     */
+    abstract setAutoResolution(scale?: number): void;
+    protected _setResolution(width: number, height: number): void;
+    protected _exitAutoResolution(): void;
+    protected abstract _onResolutionChanged(width: number, height: number): void;
 }

package/types/asset/ResourceManager.d.ts

@@ -110,6 +110,12 @@ export declare class ResourceManager {
     private _parseURL;
     private _parseQueryPath;
     private _releaseSubAssetPromiseCallback;
+    /**
+     * Register virtual asset paths and their load descriptors.
+     * @remarks References inside runtime scenes and Prefabs can keep stable virtual paths while the backing URLs
+     * are generated dynamically, such as object URLs created from a resource package.
+     */
+    registerVirtualResources(resources: readonly VirtualResource[]): void;
 }
 /**
  * Declare ResourceLoader's decorator.
@@ -119,3 +125,13 @@ export declare class ResourceManager {
 export declare function resourceLoader(assetType: string, extNames: string[], useCache?: boolean): <T extends Loader<any>>(Target: {
     new (useCache: boolean): T;
 }) => void;
+export interface VirtualResource {
+    virtualPath: string;
+    path: string;
+    type: string;
+    dependentAssetMap?: {
+        [key: string]: string;
+    };
+    subpackageName?: string;
+    params?: Record<string, any>;
+}

package/types/index.d.ts

@@ -23,7 +23,7 @@ export type { RequestConfig } from "./asset/request";
 export { Loader } from "./asset/Loader";
 export { ContentRestorer } from "./asset/ContentRestorer";
 export { RenderingStatistics } from "./asset/RenderingStatistics";
-export { ResourceManager, resourceLoader } from "./asset/ResourceManager";
+export { ResourceManager, resourceLoader, type VirtualResource } from "./asset/ResourceManager";
 export { AssetPromise } from "./asset/AssetPromise";
 export type { LoadItem } from "./asset/LoadItem";
 export { AssetType } from "./asset/AssetType";