modern-canvas 0.23.13 → 0.23.14

package/dist/index.js

@@ -4412,6 +4412,11 @@ var V = class extends B {
 	_currentTime = 0;
 	_globalStartTime = 0;
 	_globalDuration = 0;
+	_standalone = !1;
+	_localCurrentTime = 0;
+	get standalone() {
+		return this._standalone;
+	}
 	get parentGlobalStartTime() {
 		return this._parent?.globalStartTime ?? 0;
 	}
@@ -4456,12 +4461,18 @@ var V = class extends B {
 	_updateInsideTimeRange() {
 		this.insideTimeRange = this.isInsideTimeRange();
 	}
+	setStandalone(e) {
+		return this._standalone !== e && (this._standalone = e, this._updateCurrentTime(!0)), this;
+	}
+	setLocalTime(e) {
+		return this._localCurrentTime = e, this._updateCurrentTime(!0), this;
+	}
 	_updateCurrentTime(e = !1) {
 		if (e || !this._paused) {
 			let e = this._parent, t = this.parentGlobalStartTime + this._delay, n = e?.globalDuration ? Math.min(t + this._duration, e.globalEndTime) - t : this._duration;
 			this._globalStartTime = t, this._globalDuration = n;
-			let r = this._globalCurrentTime - this.globalStartTime;
-			this._loop && (r %= this.globalDuration), this._currentTime = r, this.emit("updateCurrentTime", this._currentTime), this._updateInsideTimeRange();
+			let r = this._standalone ? this._localCurrentTime : this._globalCurrentTime - this.globalStartTime;
+			this._loop && this.globalDuration && (r %= this.globalDuration), this._currentTime = r, this.emit("updateCurrentTime", this._currentTime), this._updateInsideTimeRange();
 		}
 	}
 	_process(e) {

package/dist/scene/main/TimelineNode.d.ts

@@ -32,6 +32,9 @@ export declare class TimelineNode extends Node {
     protected _currentTime: number;
     protected _globalStartTime: number;
     protected _globalDuration: number;
+    protected _standalone: boolean;
+    protected _localCurrentTime: number;
+    get standalone(): boolean;
     get parentGlobalStartTime(): number;
     get currentTime(): number;
     get globalStartTime(): number;
@@ -42,6 +45,16 @@ export declare class TimelineNode extends Node {
     constructor(properties?: Partial<TimelineNodeProperties>, nodes?: Node[]);
     protected _updateProperty(key: string, newValue: any, oldValue: any): void;
     protected _updateInsideTimeRange(): void;
+    /**
+     * 开启/关闭独立播放。开启后本节点的 currentTime 取自 {@link setLocalTime}
+     * 设置的本地时钟，完全脱离全局时间轴；关闭后恢复跟随全局时间轴。
+     */
+    setStandalone(on: boolean): this;
+    /**
+     * 独立播放下设置本地时间（毫秒，相对本节点自身 0 起点）并立即刷新。
+     * 由外部循环（如交互运行器）逐帧驱动。
+     */
+    setLocalTime(ms: number): this;
     protected _updateCurrentTime(force?: boolean): void;
     protected _process(delta: number): void;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-canvas",
   "type": "module",
-  "version": "0.23.13",
+  "version": "0.23.14",
   "packageManager": "pnpm@10.19.0",
   "description": "A JavaScript WebGL rendering engine. only the ESM.",
   "author": "wxm",