@netless/slide 1.4.57 → 1.4.58

package/README.md

@@ -4,6 +4,11 @@
 
 ## changelog
 
+### 1.4.58 (2026-09-07)
+* 修复低版本 WebView 中纯色图形显示为黑块的问题
+* 修复切页或销毁 Stage 后无限循环动画回调仍访问已释放 Pixi 对象导致的异常
+* 完善渲染任务取消、失败后的清理与队列推进
+
 ### 1.4.57 (2026-08-27)
 * 支持在客户端解码并播放本地 GIF 资源，兼容旧版 Safari
 * 修复 WebGL 切页转场被错误关闭的问题

package/lib/RenderingTaskManager.d.ts

@@ -1,4 +1,8 @@
 import EventEmitter from "eventemitter3";
+export declare class RenderTaskCancelledError extends Error {
+    readonly code: string;
+    constructor(message?: string);
+}
 export declare class Task {
     state: "idle" | "start" | "end";
     index: number;
@@ -6,16 +10,20 @@ export declare class Task {
     private fn;
     private eventHub;
     id: string;
+    private cancelled;
     constructor(index: number, slideIndex: number, fn: () => Promise<void>, eventHub: EventEmitter, id: string);
     apply(): Promise<void>;
+    cancel(): void;
 }
 export declare class RenderingTaskManager {
     eventHub: EventEmitter;
     private tasks;
     private index;
+    private destroyed;
     constructor();
+    private cancelTask;
     private replaceIdleTask;
-    addTask(fn: () => Promise<void>, slideIndex: number, id: string): void;
+    addTask(fn: () => Promise<void>, slideIndex: number, id: string): Task | undefined;
     hasStartTask(): boolean;
     destroy(): void;
 }

package/lib/RenderingTaskManager.js

@@ -102,6 +102,14 @@ var Task = /** @class */ (function () {
                         if (this.cancelled) {
                             return [2 /*return*/];
                         }
+                        if (e_1 instanceof RenderTaskCancelledError) {
+                            this.cancel();
+                            this.eventHub.emit("task-cancel", {
+                                task: this,
+                                error: e_1,
+                            });
+                            return [2 /*return*/];
+                        }
                         this.eventHub.emit("task-error", {
                             task: this,
                             error: e_1,
@@ -139,19 +147,29 @@ var RenderingTaskManager = /** @class */ (function () {
             _this.eventHub.emit("task-end-" + task.id);
         });
         this.eventHub.on("task-error", function (_a) {
+            var _b;
             var task = _a.task, error = _a.error;
             var selfIndex = _this.tasks.findIndex(function (t) { return t.index === task.index; });
+            var wasRunning = task.state === "start";
             if (selfIndex >= 0) {
                 _this.tasks.splice(selfIndex, 1);
                 _this.replaceIdleTask();
+                if (wasRunning && !_this.destroyed) {
+                    (_b = _this.tasks[selfIndex]) === null || _b === void 0 ? void 0 : _b.apply();
+                }
             }
             _this.eventHub.emit("task-error-" + task.id, error);
         });
         this.eventHub.on("task-cancel", function (_a) {
+            var _b;
             var task = _a.task, error = _a.error;
             var selfIndex = _this.tasks.findIndex(function (t) { return t.index === task.index; });
+            var wasRunning = task.state === "start";
             if (selfIndex >= 0) {
                 _this.tasks.splice(selfIndex, 1);
+                if (wasRunning && !_this.destroyed) {
+                    (_b = _this.tasks[selfIndex]) === null || _b === void 0 ? void 0 : _b.apply();
+                }
             }
             _this.eventHub.emit("task-cancel-" + task.id, error);
         });

package/lib/Slide.d.ts

@@ -456,6 +456,9 @@ export declare class Slide extends Slide_base {
     private resize;
     private isAnimating;
     private renderingTaskManager;
+    private lifecycle;
+    private lifecycleGeneration;
+    private renderVisibilityTimers;
     private isLoading;
     private isReleasing;
     private interactive;
@@ -503,6 +506,7 @@ export declare class Slide extends Slide_base {
     private handleSyncQueueCompactRenderComplete;
     private handleSyncQueueCatchUpStateChange;
     private updatePlayerInteractive;
+    private observeRenderTask;
     private recoverHandler;
     private reportError;
     initSlideConfig(config: ISlideConfig): ISlideConfig;