modern-canvas 0.23.13 → 0.24.0

package/dist/scene/2d/element/Element2D.d.ts

@@ -1,4 +1,4 @@
-import type { Background, Chart, Connection, Display, Fill, Foreground, NormalizedFilter, Outline, Shadow, Shape, Table, Text } from 'modern-idoc';
+import type { Background, Chart, CommentThread, Connection, Display, Fill, Foreground, NormalizedFilter, Outline, Shadow, Shape, Table, Text } from 'modern-idoc';
 import type { Path2D, Vector2Like } from 'modern-path2d';
 import type { InputEvent, InputEventKey } from '../../../core';
 import type { Node, Rectangulable, RectangulableEvents, SceneTree, Viewport } from '../../main';
@@ -10,6 +10,7 @@ import { ColorFilterEffect, MaskEffect } from '../../effects';
 import { Node2D } from '../Node2D';
 import { Element2DBackground } from './Element2DBackground';
 import { Element2DChart } from './Element2DChart';
+import { Element2DComments } from './Element2DComments';
 import { Element2DConnection } from './Element2DConnection';
 import { Element2DFill } from './Element2DFill';
 import { Element2DForeground } from './Element2DForeground';
@@ -41,6 +42,7 @@ export interface Element2DProperties extends Node2DProperties {
     connection: Connection;
     table: Table;
     chart: Chart;
+    comments: CommentThread[];
     /** 元素级结构化滤镜（Effect.filter），转成 CSS filter 后与 style.filter 合并 */
     filter: NormalizedFilter;
 }
@@ -87,6 +89,9 @@ export declare class Element2D extends Node2D implements Rectangulable {
     protected _chart: Element2DChart;
     get chart(): Element2DChart;
     set chart(value: Element2DProperties['chart'] | undefined);
+    protected _comments: Element2DComments;
+    get comments(): Element2DComments;
+    set comments(value: Element2DProperties['comments'] | undefined);
     /** Last routed connection path; identity-compared to skip re-layout when unchanged. */
     protected _lastRoutePath?: Path2D;
     protected _batchDepth: number;

package/dist/scene/2d/element/Element2DComments.d.ts

@@ -0,0 +1,20 @@
+import type { CommentThread, NormalizedCommentThread, PropertyDeclaration } from 'modern-idoc';
+import type { Element2D } from './Element2D';
+import { CoreObject } from '../../../core';
+/**
+ * 元素上的评论线程集合。内部按 `threadId` 作动态键存储（仿 {@link Meta}），
+ * 从而能像其它子属性一样被 CRDT 逐线程映射为 Y.Map 项（并发新增不同线程天然合并）。
+ * 对外 `toJSON` 输出 idoc 规范的 `CommentThread[]` 数组形态。
+ */
+export declare class Element2DComments extends CoreObject {
+    parent: Element2D;
+    [key: string]: any;
+    constructor(parent: Element2D);
+    getPropertyDeclarations(): Record<string, PropertyDeclaration>;
+    getPropertyDeclaration(key: string): PropertyDeclaration | undefined;
+    /** 接受 CommentThread[]（按 thread.id 归键）或已归键的对象。 */
+    setProperties(value?: CommentThread[] | Record<string, CommentThread>): this;
+    /** 序列化为 idoc 规范的线程数组。 */
+    toJSON(): NormalizedCommentThread[];
+    isValid(): boolean;
+}

package/dist/scene/2d/element/index.d.ts

@@ -2,6 +2,7 @@ export * from './connectionRouter';
 export * from './Element2D';
 export * from './Element2DBackground';
 export * from './Element2DChart';
+export * from './Element2DComments';
 export * from './Element2DConnection';
 export * from './Element2DFill';
 export * from './Element2DForeground';

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.24.0",
   "packageManager": "pnpm@10.19.0",
   "description": "A JavaScript WebGL rendering engine. only the ESM.",
   "author": "wxm",
@@ -63,7 +63,7 @@
     "colord": "^2.9.3",
     "earcut": "^3.0.2",
     "modern-font": "^0.6.1",
-    "modern-idoc": "^0.11.9",
+    "modern-idoc": "^0.12.0",
     "modern-path2d": "^1.8.5",
     "modern-text": "^2.0.6"
   },