@one2x/medeo-rte 0.2.0 → 0.3.0

package/dist/types/paint/canvasPainter.d.ts

@@ -1,5 +1,11 @@
 import { CaretPos, DocLayout, SelRect } from '../layout/types';
 import { PaintBackend } from './types';
+/**
+ * 画布左右各比文档宽出这么多：mark 等块的 paddingX 外扩在行首行尾会画到内容区外，
+ * 画布若恰好等宽就会被裁掉。画布整体左移 GUTTER 并平移绘制坐标，文字位置不变；
+ * 配套的 style.css 给 .mini-page-wrap 左右各留同样宽度的可视区（负 margin 抵消）。
+ */
+export declare const CANVAS_GUTTER = 5;
 export declare class CanvasPainter implements PaintBackend {
     private host;
     private surface;
@@ -16,14 +22,34 @@ export declare class CanvasPainter implements PaintBackend {
     private embeds;
     private embedCache;
     private hasContent;
+    private hoverId;
+    /** 画布窗口在文档坐标里的顶部与高度（CSS px） */
+    private winTop;
+    private winH;
+    private onScroll;
+    /** 上次重画用的像素密度（dpr × 缩放），变了就得整窗重画 */
+    private lastScale;
+    private zoomRaf;
+    private zoomTimer;
+    private lastZoomPaint;
+    /** 缩放手势事件很密：节流到约 100ms 一次，手势停下后再精确补一次 */
+    private onVisualViewport;
     mount(host: HTMLElement): void;
+    /** 画布像素密度：dpr × 双指缩放倍数（封顶） */
+    private pixelScale;
     getSurface(): HTMLElement;
     paintDoc(layout: DocLayout): void;
+    setHoverBlock(id: string | null): void;
     paintSelection(rects: SelRect[]): void;
     paintCaret(caret: CaretPos | null, visible: boolean, trails?: CaretPos[]): void;
     destroy(): void;
+    /** 可视区在文档坐标里的 [top, bottom]。找不到容器时就当整篇可见。 */
+    private visibleRange;
+    /** 按当前可视区决定画布窗口位置。返回是否挪了窗口。 */
+    private placeWindow;
+    /** 滚动/窗口尺寸变化：可视区离开画布窗口时挪窗口并整体重画 */
+    private followViewport;
     private resize;
-    /** 只重画脏区带：clip 到那一条，擦白，再画与之相交的内容。 */
     private redrawContent;
     private redrawChrome;
     private fillSelectionRect;

package/dist/types/paint/canvasPainter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvasPainter.d.ts","sourceRoot":"","sources":["../../../src/paint/canvasPainter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAY,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,GAAG,CAAyC;IACpD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAAS;IAE3B,KAAK,CAAC,IAAI,EAAE,WAAW;IAiBvB,UAAU,IAAI,WAAW;IAKzB,QAAQ,CAAC,MAAM,EAAE,SAAS;IAc1B,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;IAK/B,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,QAAQ,EAAO;IAO5E,OAAO;IAgBP,OAAO,CAAC,MAAM;IAqBd,qCAAqC;IACrC,OAAO,CAAC,aAAa;IA8DrB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,SAAS;IAmCjB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,OAAO;CAYhB"}
+{"version":3,"file":"canvasPainter.d.ts","sourceRoot":"","sources":["../../../src/paint/canvasPainter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAY,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAc/B,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,GAAG,CAAyC;IACpD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,+BAA+B;IAC/B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAA+B;IAC/C,oCAAoC;IACpC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAK;IAC1B,yCAAyC;IACzC,OAAO,CAAC,gBAAgB,CAYtB;IAEF,KAAK,CAAC,IAAI,EAAE,WAAW;IAuBvB,8BAA8B;IAC9B,OAAO,CAAC,UAAU;IAMlB,UAAU,IAAI,WAAW;IAKzB,QAAQ,CAAC,MAAM,EAAE,SAAS;IAc1B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAqB/B,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;IAK/B,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,QAAQ,EAAO;IAO5E,OAAO;IAuBP,6CAA6C;IAC7C,OAAO,CAAC,YAAY;IAcpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAanB,mCAAmC;IACnC,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,MAAM;IAgCd,OAAO,CAAC,aAAa;IA2DrB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,SAAS;IAmCjB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,OAAO;CAYhB"}

package/dist/types/paint/htmlPainter.d.ts

@@ -9,9 +9,12 @@ export declare class HtmlPainter implements PaintBackend {
     private trails;
     private embeds;
     private embedCache;
+    private hoverId;
     mount(host: HTMLElement): void;
     getSurface(): HTMLElement;
     paintDoc(layout: DocLayout): void;
+    setHoverBlock(id: string | null): void;
+    private applyHover;
     paintSelection(rects: SelRect[]): void;
     paintCaret(caret: CaretPos | null, visible: boolean, trails?: CaretPos[]): void;
     destroy(): void;

package/dist/types/paint/htmlPainter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"htmlPainter.d.ts","sourceRoot":"","sources":["../../../src/paint/htmlPainter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAW,OAAO,EAA+B,MAAM,iBAAiB,CAAC;AAErG,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAWvC,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAkC;IAEpD,KAAK,CAAC,IAAI,EAAE,WAAW;IAuBvB,UAAU,IAAI,WAAW;IAKzB,QAAQ,CAAC,MAAM,EAAE,SAAS;IAiC1B,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;IAY/B,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,QAAQ,EAAO;IAM5E,OAAO;CAWR"}
+{"version":3,"file":"htmlPainter.d.ts","sourceRoot":"","sources":["../../../src/paint/htmlPainter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAW,OAAO,EAA+B,MAAM,iBAAiB,CAAC;AAErG,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAWvC,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,OAAO,CAAuB;IAEtC,KAAK,CAAC,IAAI,EAAE,WAAW;IAuBvB,UAAU,IAAI,WAAW;IAKzB,QAAQ,CAAC,MAAM,EAAE,SAAS;IAkC1B,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAM/B,OAAO,CAAC,UAAU;IAQlB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;IAY/B,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,QAAQ,EAAO;IAM5E,OAAO;CAWR"}

package/dist/types/paint/types.d.ts

@@ -24,6 +24,8 @@ export interface PaintBackend {
     paintDoc(layout: DocLayout): void;
     paintSelection(rects: SelRect[]): void;
     paintCaret(caret: CaretPos | null, visible: boolean, trails?: CaretPos[]): void;
+    /** 悬停中的 mark 块 id（null 取消）；只重画受影响的块。可选实现。 */
+    setHoverBlock?(id: string | null): void;
     getSurface(): HTMLElement;
     destroy(): void;
 }

package/dist/types/paint/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/paint/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAChF,UAAU,IAAI,WAAW,CAAC;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/paint/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAChF,6CAA6C;IAC7C,aAAa,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,UAAU,IAAI,WAAW,CAAC;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;CACpB"}

package/dist/types/perf.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 开发用性能探针。默认不开，开了之后才给 Editor 实例打补丁，不开时零开销。
+ *
+ *   editor.perf.start()   // 开始采样，同时开始监测帧间隔
+ *   ...连续打字 / 按住方向键 / 中文输入法连续上屏...
+ *   editor.perf.report()  // console.table 输出并返回数据；editor.perf.stop() 停止并还原
+ *
+ * 口径：
+ * - 各阶段耗时是 JS 同步耗时（ms），不含浏览器合成、光栅化。
+ * - `→下一帧` 是从处理函数开始到下一次 requestAnimationFrame 回调开始的时间，
+ *   近似“输入到上屏”的延迟；真正画完还要再加一帧里的合成时间。
+ * - 表格里的 fps 列 = 1000 / 该项耗时，表示“如果每一帧都只做这件事，最高能跑多少帧”，上限显示 999；
+ *   只有 `→下一帧` 行和底部的“帧”行接近真实体感帧率。
+ * - 帧间隔取 requestAnimationFrame 相邻回调的间隔。注意光标闪烁本身每帧都在跑 rAF，
+ *   所以空闲时也会有帧；有意义的是“操作期间”掉不掉帧。
+ */
+export interface PerfStat {
+    count: number;
+    avg: number;
+    p95: number;
+    max: number;
+}
+export declare class PerfProbe {
+    private target;
+    private getPainter;
+    private painter;
+    private originals;
+    private painterOriginal;
+    private samples;
+    private frames;
+    private raf;
+    private lastFrame;
+    private running;
+    constructor(editor: object, getPainter: () => object);
+    get active(): boolean;
+    start(): void;
+    stop(): void;
+    reset(): void;
+    /** 汇总并输出到控制台，返回原始统计。 */
+    report(): {
+        rows: Record<string, PerfStat>;
+        frames: {
+            样本帧数: number;
+            平均帧率: number;
+            帧间隔p95_ms: number;
+            最长帧_ms: number;
+            '\u8D85\u8FC716.7ms\u7684\u5E27': number;
+            超过33ms的帧: number;
+        };
+    };
+    private record;
+    private time;
+    private patch;
+}
+//# sourceMappingURL=perf.d.ts.map

package/dist/types/perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../../src/perf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAqBD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM;IAKpD,IAAI,MAAM,YAET;IAED,KAAK;IAsBL,IAAI;IAkBJ,KAAK;IAKL,wBAAwB;IACxB,MAAM;;;;;;;;;;;IAuCN,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,KAAK;CAkBd"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@one2x/medeo-rte",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "自绘文档渲染引擎：字符流模型，排版输出纯几何，绘制后端可替换（HTML / Canvas）",
   "repository": {
@@ -39,7 +39,7 @@
     "build": "tsc --noEmit && vite build",
     "build:lib": "vite build --config vite.lib.config.ts && tsc -p tsconfig.build.json",
     "preview": "vite preview",
-    "selfcheck": "npx --yes tsx src/operations/selfcheck.ts && npx --yes tsx src/mutations/selfcheck.ts && npx --yes tsx src/edits/selfcheck.ts && npx --yes tsx src/commands/selfcheck.ts && npx --yes tsx src/layout/selfcheck.ts",
+    "selfcheck": "npx --yes tsx src/operations/selfcheck.ts && npx --yes tsx src/mutations/selfcheck.ts && npx --yes tsx src/edits/selfcheck.ts && npx --yes tsx src/commands/selfcheck.ts && npx --yes tsx src/input/caretMotion.selfcheck.ts && npx --yes tsx src/layout/selfcheck.ts",
     "prepare": "npm run build:lib"
   },
   "peerDependencies": {