modern-canvas 0.26.2 → 0.27.0

package/dist/scene/2d/Node2D.d.ts

@@ -16,6 +16,13 @@ export interface Node2D {
 export declare class Node2D extends CanvasItem {
     rotation: number;
     readonly position: Vector2;
+    /**
+     * Scroll/content offset (in this node's local space) applied only to its
+     * children's global transform — the node's own transform, globalAabb and
+     * overflow-clip box are unaffected. Runtime UI state, not serialized: lets a
+     * frame scroll its overflowing content while its clip box stays put.
+     */
+    readonly contentOffset: Vector2;
     readonly scale: Vector2;
     readonly skew: Vector2;
     readonly pivot: Vector2;

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

@@ -1,6 +1,6 @@
 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 { InputEvent, InputEventKey, WebGLRenderer } from '../../../core';
 import type { Node, Rectangulable, RectangulableEvents, SceneTree, Viewport } from '../../main';
 import type { Node2DEvents, Node2DProperties } from '../Node2D';
 import type { Element2DStyleProperties } from './Element2DStyle';
@@ -46,6 +46,29 @@ export interface Element2DProperties extends Node2DProperties {
     /** 元素级结构化滤镜（Effect.filter），转成 CSS filter 后与 style.filter 合并 */
     filter: NormalizedFilter;
 }
+interface ScrollThumb {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    travel: number;
+    span: number;
+    min: number;
+}
+export interface ScrollRange {
+    x: {
+        min: number;
+        max: number;
+    };
+    y: {
+        min: number;
+        max: number;
+    };
+    content: {
+        w: number;
+        h: number;
+    };
+}
 export declare class Element2D extends Node2D implements Rectangulable {
     readonly flexbox: Flexbox;
     readonly aabb: Aabb2D;
@@ -56,6 +79,21 @@ export declare class Element2D extends Node2D implements Rectangulable {
     readonly size: Vector2;
     protected _allowPointerEvents: boolean;
     protected _overflowHidden: boolean;
+    protected _scrollbarMode?: 'scroll' | 'auto';
+    protected _pointerInside: boolean;
+    protected _scrollbarHoverAxis?: 'x' | 'y';
+    protected _scrollbarDrag?: {
+        axis: 'x' | 'y';
+        startScreen: number;
+        startOffset: number;
+        travel: number;
+        span: number;
+        min: number;
+    };
+    protected _scrollThumbCache: Record<'v' | 'h', {
+        key: string;
+        batchable: any;
+    } | undefined>;
     protected _style: Element2DStyle;
     get style(): Element2DStyle;
     set style(value: Element2DProperties['style'] | undefined);
@@ -142,9 +180,32 @@ export declare class Element2D extends Node2D implements Rectangulable {
     getGlobalObb(): Obb2D;
     protected _draw(): void;
     protected _drawContent(): void;
+    protected _scrollRangeCache?: {
+        rev: number;
+        value: ScrollRange | undefined;
+    };
+    /**
+     * 内容（子节点本地 AABB 并集）相对自身 box 的可滚动区间。用于滚动条与滚轮：
+     * offset>0 表示内容上/左移、露出下/右侧内容。无子节点返回 undefined。
+     *
+     * 按全局 geometryRevision 缓存（与连线 route 缓存同款）：同一帧内滚轮 handler /
+     * render / thumb 命中检测会多次调用，宿主（如 mce）还经 reactive proxy 访问——
+     * 子节点上千时每次遍历是数千次 proxy 读，缓存命中则一次都不发生。
+     */
+    getScrollRange(): ScrollRange | undefined;
+    protected _computeScrollRange(): ScrollRange | undefined;
+    protected _scrollThumbs(zx: number, zy: number): {
+        v?: ScrollThumb;
+        h?: ScrollThumb;
+    } | undefined;
+    protected _scrollViewport(): Viewport | undefined;
+    render(renderer: WebGLRenderer, next?: () => void): void;
+    protected _drawScrollThumb(renderer: WebGLRenderer, slot: 'v' | 'h', r: ScrollThumb, active: boolean): void;
+    protected _scrollbarInput(event: InputEvent, key: InputEventKey): boolean;
     input(event: InputEvent, key: InputEventKey): void;
     protected _positionInput(localPos: Vector2Like, key: InputEventKey): boolean;
     protected _input(event: InputEvent, key: InputEventKey): void;
     toJSON(): Record<string, any>;
     protected _destroy(): void;
 }
+export {};

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

@@ -14,10 +14,57 @@ export declare class Element2DConnection extends CoreObject implements Normalize
     labelPosition: number;
     protected _routeSig?: string;
     protected _routePath?: Path2D;
+    protected _keyTargets: (Element2D | undefined)[];
+    protected _routeKey: number[];
+    protected _keyMode?: ConnectionMode;
+    protected _keyAnchors: (string | number | undefined)[];
+    protected _keyRevision: number;
+    protected _keyValid: boolean;
+    protected _anchorsSet: boolean;
+    protected _startTarget?: Element2D;
+    protected _endTarget?: Element2D;
+    protected _targetsRevision: number;
+    protected _targetsStartId?: string;
+    protected _targetsEndId?: string;
     constructor(_parent: Element2D);
     setProperties(properties?: Record<string, any>): this;
+    /**
+     * Whether this element *is* a connection — i.e. it declares at least one anchor.
+     * Says nothing about whether those anchors still resolve; callers use this to tell
+     * connection elements apart from ordinary ones (hit-testing, marquee selection,
+     * cascade-deleting dangling lines), and a dangling connection is still a connection.
+     *
+     * For "can this actually be routed right now", see {@link isRoutable}.
+     */
     isValid(): boolean;
+    /**
+     * Whether at least one anchor resolves to a node currently in the tree. A connection
+     * whose targets were removed is valid but not routable: it must stop consuming a
+     * per-frame route and stop opting out of viewport culling.
+     */
+    isRoutable(): boolean;
     protected _updateProperty(key: string, value: any, oldValue: any): void;
+    protected _resolveTarget(anchor: NormalizedConnection['start']): Element2D | undefined;
+    /**
+     * Re-resolve both anchors, at most once per (revision, anchor ids) pair. Nodes enter
+     * and leave the tree through `SceneTree`, which bumps the revision, so a cached target
+     * can never outlive its membership.
+     */
+    protected _refreshTargets(): void;
+    /**
+     * The anchors are compared by value rather than relying on `_updateProperty`, because
+     * `connection.start.idx = 2` mutates in place without going through the setter.
+     */
+    protected _anchorsMatch(): boolean;
+    /**
+     * Everything an endpoint's world point + direction is derived from, compared in place.
+     * `getNodeById<Element2D>` is an unchecked cast — a connection may well point at a
+     * plain Node2D — so every field is read defensively.
+     */
+    protected _keyMatches(target: Element2D | undefined, offset: number): boolean;
+    protected _writeKey(target: Element2D | undefined, offset: number): void;
+    /** Snapshot what the current route was computed from. Only on a cache miss. */
+    protected _storeKey(s: Element2D | undefined, e: Element2D | undefined): void;
     /**
      * Resolve an anchor to a world-space point.
      * If idx is specified, uses the target shape's connectionPoints;
@@ -29,7 +76,7 @@ export declare class Element2DConnection extends CoreObject implements Normalize
      * Direction comes from the connection point's `ang` if present, otherwise it is
      * inferred from which edge the point sits on; a centre fallback has no direction.
      */
-    resolveEndpoint(anchor: NormalizedConnection['start']): ConnectionEndpoint | undefined;
+    resolveEndpoint(anchor: NormalizedConnection['start'], target?: Element2D | undefined): ConnectionEndpoint | undefined;
     /**
      * World-space point at the configured {@link labelPosition} along the current
      * route — handy for anchoring an external label / badge to the line. Returns

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

@@ -9,6 +9,17 @@ export declare class Element2DOutline extends Element2DFill implements Normalize
     lineJoin: NormalizedOutline['lineJoin'];
     headEnd?: HeadEnd;
     tailEnd?: TailEnd;
+    /**
+     * 描边流动效果速度（周期/秒，符号=方向，0/undefined=关闭）。运行时 UI 态
+     * （internal：不进 toJSON / setProperties，不会被序列化或协同同步），供
+     * hover/激活时给连线加「能量流动」效果。
+     */
+    flow?: number;
+    /**
+     * 描边宽度的运行时倍率（internal，不序列化）。hover 加粗等纯 UI 反馈用，
+     * 不改动文档里的 width；1/undefined = 不加粗。
+     */
+    widthBoost?: number;
     setProperties(properties?: Outline): this;
     protected _updateProperty(key: string, value: any, oldValue: any): void;
     isValid(): boolean;

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

@@ -11,6 +11,12 @@ export declare class Element2DShape extends CoreObject implements NormalizedShap
     viewBox: NormalizedShape['viewBox'];
     paths: NormalizedShape['paths'];
     connectionPoints: NormalizedShape['connectionPoints'];
+    /**
+     * Bumped whenever `connectionPoints` is replaced. Connections use it to tell
+     * whether their anchors moved without re-resolving them every frame.
+     * Mutating the array in place doesn't bump it — same as every other property.
+     */
+    connectionPointsDirtyId: number;
     protected _path2DSet: Path2DSet;
     /**
      * A derived path in the element's local pixel space (NOT normalized to the unit

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

@@ -20,6 +20,8 @@ export interface StrokeDraw extends Partial<CanvasBatchable> {
     type: 'stroke';
     path: Path2D;
     lineStyle: LineStyle;
+    /** 流动速度（周期/秒，符号=方向）；发射 batchable 时经 encodeFlowSpeed 编成 effectParam。 */
+    flow?: number;
 }
 export interface FillDraw extends Partial<CanvasBatchable> {
     type: 'fill';
@@ -41,6 +43,8 @@ export declare class CanvasContext extends Path2D {
     lineJoin?: LineJoin;
     lineWidth?: number;
     miterLimit?: number;
+    /** 描边流动效果速度（周期/秒，符号=方向；0/undefined=关闭）。见 flowStreakEffect。 */
+    lineFlow?: number;
     transformUv?: TransformUv;
     transformVertex?: TransformVertex;
     protected _draws: (StrokeDraw | FillDraw | MeshDraw)[];
@@ -48,6 +52,7 @@ export declare class CanvasContext extends Path2D {
         sig: string;
         vertices: Float32Array;
         indices: Uint32Array;
+        uvs?: Float32Array;
     }[];
     protected _parseDrawStyle(source?: ColorValue | Texture2D): {
         texture?: Texture2D;

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

@@ -26,6 +26,7 @@ export interface SceneTree {
 }
 export interface SceneTreeProperties extends MainLoopProperties {
     msaa: boolean;
+    fxaa: boolean;
     pixelate: boolean;
     roundPixels: boolean;
     backgroundColor: Hex8Color;
@@ -36,6 +37,12 @@ export interface SceneTreeProperties extends MainLoopProperties {
 }
 export declare class SceneTree extends MainLoop {
     msaa: boolean;
+    /** 最终合成时做 FXAA 后处理（零额外 pass / 显存，MSAA 之外的轻量抗锯齿路线）。 */
+    fxaa: boolean;
+    /** 描边流动效果的高亮色（如主题主色）；见 Element2DOutline.flow。 */
+    flowColor?: Hex8Color;
+    /** 流动亮段的间距（路径像素，亮段约占其 30%）；固定物理尺度，长短线亮段一致。 */
+    flowPeriod?: number;
     pixelate: boolean;
     roundPixels: boolean;
     backgroundColor?: Hex8Color;
@@ -58,6 +65,8 @@ export declare class SceneTree extends MainLoop {
     protected _textRemeasureScheduled: boolean;
     protected _onFontLoad: () => void;
     protected _backgroundColor: Color;
+    protected _flowColor: Color;
+    protected _flowColorArray?: Float32Array;
     protected _previousViewport?: Viewport;
     protected _currentViewport?: Viewport;
     getPreviousViewport(): Viewport | undefined;

package/dist/scene/resources/materials/FxaaMaterial.d.ts

@@ -0,0 +1,16 @@
+import { Material } from './Material';
+/**
+ * FXAA 后处理材质：在「root FBO → 画布」的最终合成 draw 里顺带完成抗锯齿，
+ * 不新增渲染 pass、不占额外显存（对比 MSAA 的 4x multisample renderbuffer）。
+ *
+ * 实现为紧凑版 FXAA 3.11（5 次亮度探测 + 沿边缘方向 4 次采样混合）：
+ * - 颜色在预乘 alpha 空间整体（rgba 一起）混合，保持预乘一致性；
+ * - 亮度加入小比例 alpha 项，暗色内容叠在透明背景上时边缘仍可被检出
+ *   （纯预乘 rgb 的黑色与透明像素亮度同为 0，会漏检）；
+ * - 平坦区域按对比度阈值早退、原样输出，避免文字/纹理内部被无谓软化。
+ */
+export declare class FxaaMaterial extends Material {
+    protected static _instance: FxaaMaterial;
+    static get instance(): FxaaMaterial;
+    constructor();
+}

package/dist/scene/resources/materials/index.d.ts

@@ -1,3 +1,4 @@
 export * from './EffectMaterial';
+export * from './FxaaMaterial';
 export * from './Material';
 export * from './UvMaterial';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "modern-canvas",
   "type": "module",
-  "version": "0.26.2",
+  "version": "0.27.0",
   "packageManager": "pnpm@10.19.0",
   "description": "A JavaScript WebGL rendering engine. only the ESM.",
   "author": "wxm",
@@ -63,8 +63,8 @@
     "colord": "^2.9.3",
     "earcut": "^3.2.0",
     "modern-font": "^0.6.2",
-    "modern-idoc": "^0.12.3",
-    "modern-path2d": "^1.8.7",
+    "modern-idoc": "^0.12.4",
+    "modern-path2d": "^1.8.8",
     "modern-text": "^2.1.3"
   },
   "peerDependencies": {