ice-entity-designer 0.0.39 → 0.1.0

package/dist/types/ice-render/layout/ICEOverlayLayout.d.ts

@@ -1,25 +0,0 @@
-/**
- * Copyright (c) 2022 大漠穷秋.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- */
-import type ICEGroup from '../graphic/container/ICEGroup';
-import ICELayoutManager from './ICELayoutManager';
-/**
- * @class ICEOverlayLayout 叠加布局
- *
- * 对齐 Java Swing 的 OverlayLayout：所有子组件叠放在同一位置（左上角）。
- * 可用于做图层叠加效果。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class ICEOverlayLayout extends ICELayoutManager {
-    /**
-     * @overwrite
-     * 所有子组件叠放到容器左上角。
-     */
-    layoutContainer(container: ICEGroup): void;
-}
-export default ICEOverlayLayout;

package/dist/types/ice-render/persistence/Deserializer.d.mts

@@ -1,43 +0,0 @@
-/**
- * 序列化格式迁移表：`to` 为目标版本，按升序执行。
- *
- * 需要变更数据格式时，把 SERIALIZATION_VERSION 加 1 并在此追加一条迁移：
- * `SERIALIZATION_MIGRATIONS.push({ to: 2, run: (json) => { ...改写 json 结构... } });`
- * 当前版本为 1，尚无迁移（仅保留机制与回归用例）。
- */
-export declare const SERIALIZATION_MIGRATIONS: Array<{
-    to: number;
-    run: (jsonObj: any) => void;
-}>;
-/**
- * @class Deserializer
- *
- * 把 JSON 字符串反解析成图形。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class Deserializer {
-    private ice;
-    constructor(ice: any);
-    /** 本次反序列化中遇到的、未注册的组件类型名（去重）。供应用层提示用户 registerType 后重载。 */
-    private _unknownTypes;
-    get unknownTypes(): string[];
-    fromJSONObject(jsonObj: any): void;
-    fromJSONString(jsonStr: string): void;
-    /**
-     * 版本迁移钩子：当序列化格式版本变化时，在此处按版本逐级升级数据结构。
-     * 当前版本为 {@link SERIALIZATION_VERSION}，低于该版本的旧数据在此迁移。
-     */
-    private migrate;
-    /**
-     * 递归反序列化。
-     *
-     * 容错：遇到未注册的类型时**跳过该节点（含其子树）并记录**，而不是抛错终止整图加载
-     * （旧实现直接 `new undefined(...)` 抛 TypeError，一个未知组件会导致整份数据打不开）。
-     * 注意：生产构建会用 rollup-plugin-strip 去掉 console.*，因此告警也可能消失；
-     * 应用层应以 `deserializer.unknownTypes` 为准做提示。
-     *
-     * @returns 创建出的实例；跳过时返回 null
-     */
-    private decodeRecursively;
-}

package/dist/types/ice-render/persistence/Deserializer.d.ts

@@ -1,43 +0,0 @@
-/**
- * 序列化格式迁移表：`to` 为目标版本，按升序执行。
- *
- * 需要变更数据格式时，把 SERIALIZATION_VERSION 加 1 并在此追加一条迁移：
- * `SERIALIZATION_MIGRATIONS.push({ to: 2, run: (json) => { ...改写 json 结构... } });`
- * 当前版本为 1，尚无迁移（仅保留机制与回归用例）。
- */
-export declare const SERIALIZATION_MIGRATIONS: Array<{
-    to: number;
-    run: (jsonObj: any) => void;
-}>;
-/**
- * @class Deserializer
- *
- * 把 JSON 字符串反解析成图形。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class Deserializer {
-    private ice;
-    constructor(ice: any);
-    /** 本次反序列化中遇到的、未注册的组件类型名（去重）。供应用层提示用户 registerType 后重载。 */
-    private _unknownTypes;
-    get unknownTypes(): string[];
-    fromJSONObject(jsonObj: any): void;
-    fromJSONString(jsonStr: string): void;
-    /**
-     * 版本迁移钩子：当序列化格式版本变化时，在此处按版本逐级升级数据结构。
-     * 当前版本为 {@link SERIALIZATION_VERSION}，低于该版本的旧数据在此迁移。
-     */
-    private migrate;
-    /**
-     * 递归反序列化。
-     *
-     * 容错：遇到未注册的类型时**跳过该节点（含其子树）并记录**，而不是抛错终止整图加载
-     * （旧实现直接 `new undefined(...)` 抛 TypeError，一个未知组件会导致整份数据打不开）。
-     * 注意：生产构建会用 rollup-plugin-strip 去掉 console.*，因此告警也可能消失；
-     * 应用层应以 `deserializer.unknownTypes` 为准做提示。
-     *
-     * @returns 创建出的实例；跳过时返回 null
-     */
-    private decodeRecursively;
-}

package/dist/types/ice-render/persistence/Serializer.d.mts

@@ -1,35 +0,0 @@
-/**
- * 序列化格式版本号。数据结构发生变化时递增，并在 Deserializer 中做对应迁移。
- */
-export declare const SERIALIZATION_VERSION = 1;
-/**
- * @class Serializer
- *
- * 把图形序列化成 JSON 字符串。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class Serializer {
-    private ice;
-    constructor(ice: any);
-    /**
-     * 把对象序列化成 JSON 字符串：
-     * - 容器型组件需要负责子节点的序列化操作
-     * - 如果组件不需要序列化，需要返回 null
-     * @returns Object
-     */
-    toJSONString(): string;
-    /**
-     * 把对象序列化成 JSON 对象：
-     * - 容器型组件需要负责子节点的序列化操作
-     * - 如果组件不需要序列化，需要返回 null
-     * @returns Object
-     */
-    toJSONObject(): object;
-    private encodeRecursively;
-    /**
-     * 只序列化用户数据，排除运行时缓存/计算值（linearMatrix/composedMatrix/localOrigin/
-     * absoluteOrigin/dots/textHeight 等）。
-     */
-    private pickSerializableState;
-}

package/dist/types/ice-render/persistence/Serializer.d.ts

@@ -1,35 +0,0 @@
-/**
- * 序列化格式版本号。数据结构发生变化时递增，并在 Deserializer 中做对应迁移。
- */
-export declare const SERIALIZATION_VERSION = 1;
-/**
- * @class Serializer
- *
- * 把图形序列化成 JSON 字符串。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export default class Serializer {
-    private ice;
-    constructor(ice: any);
-    /**
-     * 把对象序列化成 JSON 字符串：
-     * - 容器型组件需要负责子节点的序列化操作
-     * - 如果组件不需要序列化，需要返回 null
-     * @returns Object
-     */
-    toJSONString(): string;
-    /**
-     * 把对象序列化成 JSON 对象：
-     * - 容器型组件需要负责子节点的序列化操作
-     * - 如果组件不需要序列化，需要返回 null
-     * @returns Object
-     */
-    toJSONObject(): object;
-    private encodeRecursively;
-    /**
-     * 只序列化用户数据，排除运行时缓存/计算值（linearMatrix/composedMatrix/localOrigin/
-     * absoluteOrigin/dots/textHeight 等）。
-     */
-    private pickSerializableState;
-}

package/dist/types/ice-render/plugin/PluginHost.d.mts

@@ -1,86 +0,0 @@
-/**
- * 插件宿主：为引擎提供「组件 / 渲染 / 交互工具」三层注册点。
- *
- * 设计取向与 09-roadmap 的边界一致——**只提供原语，不做应用层 UX**：
- * - 组件层：插件声明自定义图元类型，宿主代为 `registerType`（因此自动获得
- *   序列化 typeId 反查能力，见 `ICE.getTypeId`）。
- * - 渲染层：插件拿到每帧的绘制回调，在与组件相同的坐标系（世界坐标）下叠加绘制。
- *   局部重绘帧里回调在 clip 之内执行，语义与组件一致（超出脏区域的旧内容不会被擦除也不会被重画；
- *   若插件内容会随时间变化而没有任何组件变脏，引擎本身会因「无脏组件」回退全量，仍然正确）。
- * - 交互工具层：插件按 `match(component)` 声明自己的工具组件；宿主复用既有 `toolNodes`
- *   机制做 add/remove，`exclusive` 为真时禁用内置变换/连线面板。
- *
- * 生命周期：`ICE.use(plugin)` 幂等（按 `name` 去重）→ 调用 `setup(ice)`；
- * `ICE.unuse(name)` → 调用 `teardown(ice)` 并撤销该插件注册的工具与渲染回调。
- * 类型注册（`components`）在 unuse 后**保留**——反序列化仍可能依赖它，且撤销类型会让已存数据失效。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export interface ICERenderFrame {
-    ctx: any;
-    /** 当前渲染模式 */
-    mode: 'full' | 'dirty-rect';
-    /** 局部重绘时的脏区域（世界坐标 [minX,minY,maxX,maxY]）；全量帧为 null */
-    region: number[] | null;
-    /** 画布尺寸（设备像素） */
-    width: number;
-    height: number;
-}
-export type ICERenderHook = (frame: ICERenderFrame) => void;
-export interface ICEPluginTool {
-    /** 插件内唯一 id（用于幂等注册与撤销） */
-    id: string;
-    /** 该工具是否应作用于当前选中的组件 */
-    match: (component: any, ice: any) => boolean;
-    /** 创建工具组件（会被加到 ICE.toolNodes，不参与序列化） */
-    create: () => any;
-    /**
-     * 命中时是否屏蔽内置变换/连线面板。
-     * 默认 false（叠加在内置面板之上）；为 true 时内置面板会被禁用，避免与插件工具重叠。
-     */
-    exclusive?: boolean;
-    /** 可选：目标组件变化时回调（同一工具实例被复用，避免每次选中都重建） */
-    onTargetChange?: (tool: any, component: any) => void;
-}
-export interface ICEPlugin {
-    /** 插件唯一名（幂等注册键） */
-    name: string;
-    /** 组件层：typeId → 构造函数 */
-    components?: Record<string, new (...args: any[]) => any>;
-    /** 渲染层：每帧绘制回调（世界坐标） */
-    render?: ICERenderHook;
-    /** 交互工具层 */
-    tools?: ICEPluginTool[];
-    /** 注册时调用（可在此绑定事件、注册主题等） */
-    setup?: (ice: any) => void;
-    /** 注销时调用（应释放自己申请的资源） */
-    teardown?: (ice: any) => void;
-}
-export default class PluginHost {
-    private ice;
-    private plugins;
-    /** 渲染回调，按注册顺序调用 */
-    private renderHooks;
-    private tools;
-    constructor(ice: any);
-    /** 已注册插件名（只读快照） */
-    get names(): string[];
-    has(name: string): boolean;
-    hasRenderHooks(): boolean;
-    /** 幂等注册：同名插件重复 use 直接返回 false（不重复 setup） */
-    use(plugin: ICEPlugin): boolean;
-    /** 注销插件：撤销其渲染回调与工具，并调用 teardown（类型注册保留） */
-    unuse(name: string): boolean;
-    /** 渲染钩子：由 CanvasRenderer 在绘制完组件与工具后调用（世界坐标、clip 之内） */
-    invokeRenderHooks(frame: ICERenderFrame): void;
-    /**
-     * 选中变化时同步插件工具：命中的挂上、失配的摘下。
-     * @returns 是否存在「排他」工具命中（命中时调用方应禁用内置面板）
-     */
-    syncTools(component: any): boolean;
-    /** 全部摘下（如 clearAll 时） */
-    detachAllTools(): void;
-    private detachTool;
-    /** destroy 时清空（不调用 teardown，交由 ICE.destroy 统一处理） */
-    clear(): void;
-}

package/dist/types/ice-render/plugin/PluginHost.d.ts

@@ -1,86 +0,0 @@
-/**
- * 插件宿主：为引擎提供「组件 / 渲染 / 交互工具」三层注册点。
- *
- * 设计取向与 09-roadmap 的边界一致——**只提供原语，不做应用层 UX**：
- * - 组件层：插件声明自定义图元类型，宿主代为 `registerType`（因此自动获得
- *   序列化 typeId 反查能力，见 `ICE.getTypeId`）。
- * - 渲染层：插件拿到每帧的绘制回调，在与组件相同的坐标系（世界坐标）下叠加绘制。
- *   局部重绘帧里回调在 clip 之内执行，语义与组件一致（超出脏区域的旧内容不会被擦除也不会被重画；
- *   若插件内容会随时间变化而没有任何组件变脏，引擎本身会因「无脏组件」回退全量，仍然正确）。
- * - 交互工具层：插件按 `match(component)` 声明自己的工具组件；宿主复用既有 `toolNodes`
- *   机制做 add/remove，`exclusive` 为真时禁用内置变换/连线面板。
- *
- * 生命周期：`ICE.use(plugin)` 幂等（按 `name` 去重）→ 调用 `setup(ice)`；
- * `ICE.unuse(name)` → 调用 `teardown(ice)` 并撤销该插件注册的工具与渲染回调。
- * 类型注册（`components`）在 unuse 后**保留**——反序列化仍可能依赖它，且撤销类型会让已存数据失效。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-export interface ICERenderFrame {
-    ctx: any;
-    /** 当前渲染模式 */
-    mode: 'full' | 'dirty-rect';
-    /** 局部重绘时的脏区域（世界坐标 [minX,minY,maxX,maxY]）；全量帧为 null */
-    region: number[] | null;
-    /** 画布尺寸（设备像素） */
-    width: number;
-    height: number;
-}
-export type ICERenderHook = (frame: ICERenderFrame) => void;
-export interface ICEPluginTool {
-    /** 插件内唯一 id（用于幂等注册与撤销） */
-    id: string;
-    /** 该工具是否应作用于当前选中的组件 */
-    match: (component: any, ice: any) => boolean;
-    /** 创建工具组件（会被加到 ICE.toolNodes，不参与序列化） */
-    create: () => any;
-    /**
-     * 命中时是否屏蔽内置变换/连线面板。
-     * 默认 false（叠加在内置面板之上）；为 true 时内置面板会被禁用，避免与插件工具重叠。
-     */
-    exclusive?: boolean;
-    /** 可选：目标组件变化时回调（同一工具实例被复用，避免每次选中都重建） */
-    onTargetChange?: (tool: any, component: any) => void;
-}
-export interface ICEPlugin {
-    /** 插件唯一名（幂等注册键） */
-    name: string;
-    /** 组件层：typeId → 构造函数 */
-    components?: Record<string, new (...args: any[]) => any>;
-    /** 渲染层：每帧绘制回调（世界坐标） */
-    render?: ICERenderHook;
-    /** 交互工具层 */
-    tools?: ICEPluginTool[];
-    /** 注册时调用（可在此绑定事件、注册主题等） */
-    setup?: (ice: any) => void;
-    /** 注销时调用（应释放自己申请的资源） */
-    teardown?: (ice: any) => void;
-}
-export default class PluginHost {
-    private ice;
-    private plugins;
-    /** 渲染回调，按注册顺序调用 */
-    private renderHooks;
-    private tools;
-    constructor(ice: any);
-    /** 已注册插件名（只读快照） */
-    get names(): string[];
-    has(name: string): boolean;
-    hasRenderHooks(): boolean;
-    /** 幂等注册：同名插件重复 use 直接返回 false（不重复 setup） */
-    use(plugin: ICEPlugin): boolean;
-    /** 注销插件：撤销其渲染回调与工具，并调用 teardown（类型注册保留） */
-    unuse(name: string): boolean;
-    /** 渲染钩子：由 CanvasRenderer 在绘制完组件与工具后调用（世界坐标、clip 之内） */
-    invokeRenderHooks(frame: ICERenderFrame): void;
-    /**
-     * 选中变化时同步插件工具：命中的挂上、失配的摘下。
-     * @returns 是否存在「排他」工具命中（命中时调用方应禁用内置面板）
-     */
-    syncTools(component: any): boolean;
-    /** 全部摘下（如 clearAll 时） */
-    detachAllTools(): void;
-    private detachTool;
-    /** destroy 时清空（不调用 teardown，交由 ICE.destroy 统一处理） */
-    clear(): void;
-}

package/dist/types/ice-render/renderer/CanvasRenderer.d.mts

@@ -1,150 +0,0 @@
-import ICEEventTarget from '../event/ICEEventTarget.mjs';
-import ICE from '../ICE.mjs';
-/**
- * @class CanvasRenderer Canvas 渲染器
- *
- * - 一个 ICE 实例上，只能有一个渲染器实例。
- * - 默认渲染策略为「脏矩形局部重绘」（renderMode: 'dirty-rect'）：
- *   只 clear 脏区域、按 z 序重画与区域相交的组件；不满足局部条件时自动回退全量重绘
- *   （结构变更 / 未 prime / 脏占比过高 / 区域过大 / 折线或文本等特殊类别 / 能力缺失）。
- *   两种模式像素一致（组件 render 已做 ctx 泄漏属性归位，见 ICEComponent.__resetLeakyCtxState）。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class CanvasRenderer extends ICEEventTarget {
-    private ice;
-    private stopped;
-    private renderMode;
-    /** @internal 内部测试钩子：强制走全量路径（对比/调试用，非公开 API）。 */
-    __forceFullRender: boolean;
-    private componentQueue;
-    private toolsQueue;
-    private __queueDirty;
-    private __zSnap;
-    /**
-     * 每个「曾上屏」组件的世界轴对齐包围盒快照（[minX,minY,maxX,maxY]，已含 paint pad）。
-     * WeakMap：不污染组件 state/props（序列化安全）、对 zIndex 重排免疫、组件 GC 自动回收。
-     * 用于：部分重绘帧的旧区域擦除 + 未变组件的「是否与本帧区域相交」判断。
-     */
-    private __snap;
-    /** 距离最近一次队列重建后，是否已完成过至少一次「全量/prime」渲染（快照就绪）。 */
-    private __primed;
-    /** 组件级离屏缓存（v1 缓存 ICEText），与快照一样不污染组件 state/props。 */
-    private cache;
-    /** @internal 上一帧被视口裁剪掉的组件数（仅供性能观测与测试断言）。 */
-    __lastFrameCulled: number;
-    constructor(ice: ICE, options?: {
-        renderMode?: 'full' | 'dirty-rect';
-    });
-    /**
-     * @method markQueueDirty 标记组件树结构已变化，下一次渲染需重建渲染队列。
-     * 由 ICE / ICEGroup 在 addChild / removeChild 等结构性变更时调用。
-     * 结构变更必然回退全量重绘（并重新 prime 快照）。
-     */
-    markQueueDirty(): void;
-    setRenderMode(mode: 'full' | 'dirty-rect'): void;
-    getRenderMode(): 'full' | 'dirty-rect';
-    start(): this;
-    stop(): this;
-    private frameEvtHandler;
-    private refreshQueue;
-    private __rebuildQueue;
-    /**
-     * 把当前 componentQueue + toolsQueue 的 zIndex 顺序快照到复用的 __zSnap 数组，
-     * 供下一帧做稳定性比对，避免每帧分配新数组。
-     */
-    private __snapshotZ;
-    /**
-     * 对比当前队列的 zIndex 与上次快照，任一不同（或长度变化）即认为顺序已变。
-     */
-    private __zOrderChanged;
-    private doRenderFull;
-    /**
-     * 收集脏区域并做局部重绘可行性判定。
-     * 返回 null = 不满足局部条件（由调用方回退全量）；否则返回本帧脏区域 [minX,minY,maxX,maxY]。
-     *
-     * 区域来源：
-     * - 可见且 dirty 的组件/工具：旧快照盒 ∪ 新几何盒（可能移动/变形）。
-     * - display:false 且 dirty 且曾上屏的组件/工具：旧快照盒（仅擦除）。
-     *
-     * 判定顺序（性能关键）：先做**零开销预检**（只读 display/dirty 标志），
-     * 能确定要回退全量的情况（无可见脏组件 / 脏占比超阈）绝不进入
-     * 「场景门控 + 逐组件算包围盒」的昂贵路径——否则动画全量帧会被重复 compose 翻倍。
-     */
-    private __collect;
-    /** 渲染视口（dpr·viewport）。ICE 侧有缓存，dpr===1 时直接返回 viewport 本身。 */
-    private __renderViewport;
-    /**
-     * 预检：只读组件标志（display/dirty/快照存在），不触发矩阵/样式计算。
-     * @returns { visible: 可见数量, dirty: 可见且脏数量, hiddenErase: 是否有曾上屏的隐藏脏组件 }
-     */
-    private __preCount;
-    /**
-     * 区域收集 pass：仅当预检通过、即将走局部时才调用。
-     * 把「可见且脏」组件的旧快照盒 ∪ 新几何盒、以及「隐藏且曾上屏」组件的旧快照盒
-     * 逐条推进 `boxes`（聚合交给 `coalesceRegions`，这里不做并集）。
-     * 返回 false = 有组件盒非法（回退全量）。
-     */
-    private __collectDirtyBoxes;
-    /**
-     * 相交级门控：判断「对本帧脏区域有 AA 风险的组件」是否真的与区域相交。
-     *
-     * 有风险的类别（与整场景门控时代一致）：
-     * - 点集路径（星形/正N边形/玫瑰/折线）：clip 会切断折线抗锯齿边缘
-     * - 文本：clip 会改变字形 AA
-     * - 非不透明落墨（rgba/hsla 色、阴影、globalAlpha≠1、非 source-over）
-     *
-     * 例外：已离屏缓存的组件在主画布上只是 drawImage（不透明位图整像素采样），
-     * 不再受 clip 影响，因此不阻塞。
-     *
-     * **刚变脏的 risky 组件一律回退**：它本轮要重建位图/重算参数，而实际墨迹范围可能超出
-     * 几何盒（文本的字形与描边尤甚，实测「文本内容变更」时墨迹会超出盒若干像素），
-     * 在 clip 下重绘无法保证与全量逐像素一致。dirty-rect 像素回归正是靠这条兜住的。
-     *
-     * 干净的 risky 组件才做相交判定，盒取上屏快照（世界轴对齐盒，含 paint pad）；
-     * 快照缺失（从未上屏）时无法判定 → 保守回退。
-     */
-    private __riskyIntersectsRegions;
-    private __renderDirtyRect;
-    /**
-     * 调用插件渲染钩子。要求：
-     * - 与世界坐标一致：先把 CTM 设为「渲染视口」（dpr · viewport），插件即可按世界坐标绘制
-     * - 在两条渲染路径中都调用；局部重绘时处于 clip 之内，语义与组件一致
-     * - 未注册任何钩子时零开销（不构造 frame 对象）
-     */
-    private __invokePluginRender;
-    private __ensureContext;
-    /**
-     * @internal 取组件上一次上屏的世界包围盒（含 paint pad，格式 [minX,minY,maxX,maxY]）。
-     * 供命中检测做「廉价包围盒预筛」，避免对屏外组件做矩阵反变换 + 形状判定。无快照返回 null。
-     */
-    getWorldBox(component: any): Float64Array | null;
-    /**
-     * 当前视口对应的可见世界矩形 [minX,minY,maxX,maxY]。画布尺寸缺失时返回 null（不裁剪）。
-     */
-    private __visibleWorldRect;
-    /**
-     * 组件渲染入口：可缓存组件走离屏位图（命中贴图 / 纯平移复用 / 重建），
-     * 否则回退到普通 render()。
-     */
-    private __renderComponent;
-    private __isDotPath;
-    private __isText;
-    /**
-     * 计算 dirty 组件的「新盒」（含 paint pad，世界坐标）。
-     * 需要先刷新组件参数（文本 measure / dot-path calcDots），再 refresh 合成矩阵。
-     * 返回 null = 盒非法或计算失败（回退全量）。
-     */
-    private __freshBox;
-    /**
-     * 渲染后捕获组件的世界包围盒（含 pad）到快照，供后续帧做旧区域擦除与相交判断。
-     */
-    private __capture;
-    /**
-     * 隐藏组件（display:false）曾上屏过、且仍挂着脏标记（render 提前返回不会自清）：
-     * 本帧它的旧区域已被擦除（全量 clear 或局部 erase 区域），因此清除脏位并移除快照，
-     * 避免「永久脏组件把后续局部帧反复顶成全量」。display 重新打开时 setState 会重新置脏。
-     */
-    private __finalizeHidden;
-}
-export default CanvasRenderer;

package/dist/types/ice-render/renderer/CanvasRenderer.d.ts

@@ -1,150 +0,0 @@
-import ICEEventTarget from '../event/ICEEventTarget';
-import ICE from '../ICE';
-/**
- * @class CanvasRenderer Canvas 渲染器
- *
- * - 一个 ICE 实例上，只能有一个渲染器实例。
- * - 默认渲染策略为「脏矩形局部重绘」（renderMode: 'dirty-rect'）：
- *   只 clear 脏区域、按 z 序重画与区域相交的组件；不满足局部条件时自动回退全量重绘
- *   （结构变更 / 未 prime / 脏占比过高 / 区域过大 / 折线或文本等特殊类别 / 能力缺失）。
- *   两种模式像素一致（组件 render 已做 ctx 泄漏属性归位，见 ICEComponent.__resetLeakyCtxState）。
- *
- * @author 大漠穷秋<damoqiongqiu@126.com>
- */
-declare class CanvasRenderer extends ICEEventTarget {
-    private ice;
-    private stopped;
-    private renderMode;
-    /** @internal 内部测试钩子：强制走全量路径（对比/调试用，非公开 API）。 */
-    __forceFullRender: boolean;
-    private componentQueue;
-    private toolsQueue;
-    private __queueDirty;
-    private __zSnap;
-    /**
-     * 每个「曾上屏」组件的世界轴对齐包围盒快照（[minX,minY,maxX,maxY]，已含 paint pad）。
-     * WeakMap：不污染组件 state/props（序列化安全）、对 zIndex 重排免疫、组件 GC 自动回收。
-     * 用于：部分重绘帧的旧区域擦除 + 未变组件的「是否与本帧区域相交」判断。
-     */
-    private __snap;
-    /** 距离最近一次队列重建后，是否已完成过至少一次「全量/prime」渲染（快照就绪）。 */
-    private __primed;
-    /** 组件级离屏缓存（v1 缓存 ICEText），与快照一样不污染组件 state/props。 */
-    private cache;
-    /** @internal 上一帧被视口裁剪掉的组件数（仅供性能观测与测试断言）。 */
-    __lastFrameCulled: number;
-    constructor(ice: ICE, options?: {
-        renderMode?: 'full' | 'dirty-rect';
-    });
-    /**
-     * @method markQueueDirty 标记组件树结构已变化，下一次渲染需重建渲染队列。
-     * 由 ICE / ICEGroup 在 addChild / removeChild 等结构性变更时调用。
-     * 结构变更必然回退全量重绘（并重新 prime 快照）。
-     */
-    markQueueDirty(): void;
-    setRenderMode(mode: 'full' | 'dirty-rect'): void;
-    getRenderMode(): 'full' | 'dirty-rect';
-    start(): this;
-    stop(): this;
-    private frameEvtHandler;
-    private refreshQueue;
-    private __rebuildQueue;
-    /**
-     * 把当前 componentQueue + toolsQueue 的 zIndex 顺序快照到复用的 __zSnap 数组，
-     * 供下一帧做稳定性比对，避免每帧分配新数组。
-     */
-    private __snapshotZ;
-    /**
-     * 对比当前队列的 zIndex 与上次快照，任一不同（或长度变化）即认为顺序已变。
-     */
-    private __zOrderChanged;
-    private doRenderFull;
-    /**
-     * 收集脏区域并做局部重绘可行性判定。
-     * 返回 null = 不满足局部条件（由调用方回退全量）；否则返回本帧脏区域 [minX,minY,maxX,maxY]。
-     *
-     * 区域来源：
-     * - 可见且 dirty 的组件/工具：旧快照盒 ∪ 新几何盒（可能移动/变形）。
-     * - display:false 且 dirty 且曾上屏的组件/工具：旧快照盒（仅擦除）。
-     *
-     * 判定顺序（性能关键）：先做**零开销预检**（只读 display/dirty 标志），
-     * 能确定要回退全量的情况（无可见脏组件 / 脏占比超阈）绝不进入
-     * 「场景门控 + 逐组件算包围盒」的昂贵路径——否则动画全量帧会被重复 compose 翻倍。
-     */
-    private __collect;
-    /** 渲染视口（dpr·viewport）。ICE 侧有缓存，dpr===1 时直接返回 viewport 本身。 */
-    private __renderViewport;
-    /**
-     * 预检：只读组件标志（display/dirty/快照存在），不触发矩阵/样式计算。
-     * @returns { visible: 可见数量, dirty: 可见且脏数量, hiddenErase: 是否有曾上屏的隐藏脏组件 }
-     */
-    private __preCount;
-    /**
-     * 区域收集 pass：仅当预检通过、即将走局部时才调用。
-     * 把「可见且脏」组件的旧快照盒 ∪ 新几何盒、以及「隐藏且曾上屏」组件的旧快照盒
-     * 逐条推进 `boxes`（聚合交给 `coalesceRegions`，这里不做并集）。
-     * 返回 false = 有组件盒非法（回退全量）。
-     */
-    private __collectDirtyBoxes;
-    /**
-     * 相交级门控：判断「对本帧脏区域有 AA 风险的组件」是否真的与区域相交。
-     *
-     * 有风险的类别（与整场景门控时代一致）：
-     * - 点集路径（星形/正N边形/玫瑰/折线）：clip 会切断折线抗锯齿边缘
-     * - 文本：clip 会改变字形 AA
-     * - 非不透明落墨（rgba/hsla 色、阴影、globalAlpha≠1、非 source-over）
-     *
-     * 例外：已离屏缓存的组件在主画布上只是 drawImage（不透明位图整像素采样），
-     * 不再受 clip 影响，因此不阻塞。
-     *
-     * **刚变脏的 risky 组件一律回退**：它本轮要重建位图/重算参数，而实际墨迹范围可能超出
-     * 几何盒（文本的字形与描边尤甚，实测「文本内容变更」时墨迹会超出盒若干像素），
-     * 在 clip 下重绘无法保证与全量逐像素一致。dirty-rect 像素回归正是靠这条兜住的。
-     *
-     * 干净的 risky 组件才做相交判定，盒取上屏快照（世界轴对齐盒，含 paint pad）；
-     * 快照缺失（从未上屏）时无法判定 → 保守回退。
-     */
-    private __riskyIntersectsRegions;
-    private __renderDirtyRect;
-    /**
-     * 调用插件渲染钩子。要求：
-     * - 与世界坐标一致：先把 CTM 设为「渲染视口」（dpr · viewport），插件即可按世界坐标绘制
-     * - 在两条渲染路径中都调用；局部重绘时处于 clip 之内，语义与组件一致
-     * - 未注册任何钩子时零开销（不构造 frame 对象）
-     */
-    private __invokePluginRender;
-    private __ensureContext;
-    /**
-     * @internal 取组件上一次上屏的世界包围盒（含 paint pad，格式 [minX,minY,maxX,maxY]）。
-     * 供命中检测做「廉价包围盒预筛」，避免对屏外组件做矩阵反变换 + 形状判定。无快照返回 null。
-     */
-    getWorldBox(component: any): Float64Array | null;
-    /**
-     * 当前视口对应的可见世界矩形 [minX,minY,maxX,maxY]。画布尺寸缺失时返回 null（不裁剪）。
-     */
-    private __visibleWorldRect;
-    /**
-     * 组件渲染入口：可缓存组件走离屏位图（命中贴图 / 纯平移复用 / 重建），
-     * 否则回退到普通 render()。
-     */
-    private __renderComponent;
-    private __isDotPath;
-    private __isText;
-    /**
-     * 计算 dirty 组件的「新盒」（含 paint pad，世界坐标）。
-     * 需要先刷新组件参数（文本 measure / dot-path calcDots），再 refresh 合成矩阵。
-     * 返回 null = 盒非法或计算失败（回退全量）。
-     */
-    private __freshBox;
-    /**
-     * 渲染后捕获组件的世界包围盒（含 pad）到快照，供后续帧做旧区域擦除与相交判断。
-     */
-    private __capture;
-    /**
-     * 隐藏组件（display:false）曾上屏过、且仍挂着脏标记（render 提前返回不会自清）：
-     * 本帧它的旧区域已被擦除（全量 clear 或局部 erase 区域），因此清除脏位并移除快照，
-     * 避免「永久脏组件把后续局部帧反复顶成全量」。display 重新打开时 setState 会重新置脏。
-     */
-    private __finalizeHidden;
-}
-export default CanvasRenderer;