modern-canvas 0.27.5 → 0.27.7

package/dist/Engine.d.ts

@@ -1,3 +1,4 @@
+import type { Batch2DEffect } from './core';
 import type { Node, SceneTreeEvents, SceneTreeProperties } from './scene';
 import { WebGLRenderer } from './core';
 import { SceneTree } from './scene';
@@ -43,6 +44,14 @@ export declare class Engine extends SceneTree {
     get height(): number;
     get pixelRatio(): number;
     set pixelRatio(val: number);
+    protected _flowEffect?: Batch2DEffect;
+    get flowEffect(): Batch2DEffect | undefined;
+    /**
+     * 切换描边/连线的「流动」预设：引擎只内置 flowStreak，其余样式（箭头/生长线/虚线等）
+     * 由宿主传自定义 Batch2DEffect。占用同一 flow 槽（按名替换 + 重编译），传 undefined 恢复默认。
+     * 颜色/周期仍走 flowColor / flowPeriod（effectUniforms）。
+     */
+    set flowEffect(effect: Batch2DEffect | undefined);
     protected _resizeObserver: ResizeObserver | undefined;
     constructor(properties?: Partial<EngineProperties>);
     protected _updateProperty(key: string, value: any, oldValue: any): void;

package/dist/core/renderers/gl/Batch2DEffect.d.ts

@@ -27,6 +27,13 @@ export interface Batch2DEffect {
     uniformDecls?: string;
     /** uniform 默认值；宿主可经 `batch2D.effectUniforms` 逐帧覆盖。 */
     uniformDefaults?: Record<string, any>;
+    /**
+     * flow 描边的 vUv.x 归一化到「每条线 0..1」（除以整条线总弧长）而非默认的
+     * 路径像素弧长。归一化在批打包阶段按当前激活效果动态处理，顶点布局不变。
+     * - true（箭头 / 生长线）：效果在「每条线」空间里工作 —— 严格一个 / 走满整条。
+     * - false/缺省（流光 / 虚线）：像素弧长 —— 段长固定物理尺寸，与线长无关。
+     */
+    uvNormalized?: boolean;
 }
 /** aTextureParams.y bit0：UV 越界裁剪（核心语义，效果位从 bit1 起）。 */
 export declare const FLAG_CLIP_OUTSIDE_UV = 1;

package/dist/core/renderers/gl/GlBatch2DSystem.d.ts

@@ -59,6 +59,8 @@ interface BatchSlot {
     indexData?: Uint32Array<ArrayBuffer>;
     refs: any[];
     drawCalls: DrawCall[];
+    /** 上次重建时的效果修订号；效果注册变更（含 flow uv 归一化模式）后强制失效。 */
+    effectsRevision?: number;
 }
 export declare class GlBatch2DSystem extends GlSystem {
     install(renderer: WebGLRenderer): void;