@vectojs/core 1.30.0 → 1.31.0

package/dist/{chunk-2WXZCPYQ.mjs → chunk-RWN3ITBD.mjs}

@@ -1095,6 +1095,34 @@ var Entity = class {
     void hint;
     return null;
   }
+  /**
+   * A cheap, monotonically-increasing stamp of this entity's projected content.
+   *
+   * Purely an optimization, and opt-in: returning `null` (the default) means
+   * "I cannot cheaply tell whether my content changed", and the {@link Scene}
+   * then rebuilds the projection every synced frame exactly as before. An
+   * implementation must bump the value whenever anything
+   * {@link getContentProjection} would report changes — text, fonts, line
+   * geometry, `selectable`, grid revision.
+   *
+   * When two consecutive syncs report the same epoch AND the entity's geometry
+   * is unchanged, `Scene` skips the block *before* calling
+   * {@link getContentProjection}. That matters because the projection call is
+   * O(glyphs-in-block) and the DOM diff around it costs about the same again:
+   * measured on a 1500-resident-block document, a sync in which the projected
+   * text was byte-identical before and after still cost 17.875 ms, and skipping
+   * unchanged blocks took that to 0.475 ms (carryctx CTX-0199, vectojs#343).
+   *
+   * Correctness is entirely on the implementer: a stale epoch means stale DOM,
+   * so bump it in the same place the content is invalidated rather than trying
+   * to enumerate mutation sites afterwards. Any monotonic counter works; the
+   * value is only ever compared for equality with the previous sync's.
+   *
+   * @returns The current content epoch, or `null` to disable skipping.
+   */
+  getContentEpoch() {
+    return null;
+  }
   /**
    * Whether this entity still has a queued/running tween animation, or an
    * active {@link setTransition}/{@link animateTo}/{@link springTo} property
@@ -1138,6 +1166,8 @@ var MSDFTextEntity = class extends Entity {
   layoutText = "";
   text = "";
   lastRenderedSeqId = 0;
+  /** Bumped by {@link queueLayout}; read by `Scene` to skip an unchanged sync. */
+  contentEpoch = 0;
   // Atlas-decode subscription (see watchAtlasDecode). Held so `destroy()` can
   // release it: the handler closes over `this`, so leaving it attached to a
   // long-lived shared atlas image would retain the whole entity.
@@ -1257,6 +1287,7 @@ var MSDFTextEntity = class extends Entity {
     });
   }
   queueLayout() {
+    this.contentEpoch++;
     LayoutWorkerManager.getInstance().queueLayout(this.id, this.layoutText, {
       fontId: this.font.id,
       fontSize: this.fontSize,
@@ -1286,6 +1317,9 @@ var MSDFTextEntity = class extends Entity {
       lineHeight: this.lineHeight
     };
   }
+  getContentEpoch() {
+    return this.contentEpoch;
+  }
   isPointInside(globalX, globalY) {
     if (!this.layoutResult) return false;
     const local = this.worldToLocal(globalX, globalY);

package/dist/{chunk-7PI7LVWW.js → chunk-TRT2TRCW.js}

@@ -1097,6 +1097,34 @@ var Entity = (_class2 = class {
     void hint;
     return null;
   }
+  /**
+   * A cheap, monotonically-increasing stamp of this entity's projected content.
+   *
+   * Purely an optimization, and opt-in: returning `null` (the default) means
+   * "I cannot cheaply tell whether my content changed", and the {@link Scene}
+   * then rebuilds the projection every synced frame exactly as before. An
+   * implementation must bump the value whenever anything
+   * {@link getContentProjection} would report changes — text, fonts, line
+   * geometry, `selectable`, grid revision.
+   *
+   * When two consecutive syncs report the same epoch AND the entity's geometry
+   * is unchanged, `Scene` skips the block *before* calling
+   * {@link getContentProjection}. That matters because the projection call is
+   * O(glyphs-in-block) and the DOM diff around it costs about the same again:
+   * measured on a 1500-resident-block document, a sync in which the projected
+   * text was byte-identical before and after still cost 17.875 ms, and skipping
+   * unchanged blocks took that to 0.475 ms (carryctx CTX-0199, vectojs#343).
+   *
+   * Correctness is entirely on the implementer: a stale epoch means stale DOM,
+   * so bump it in the same place the content is invalidated rather than trying
+   * to enumerate mutation sites afterwards. Any monotonic counter works; the
+   * value is only ever compared for equality with the previous sync's.
+   *
+   * @returns The current content epoch, or `null` to disable skipping.
+   */
+  getContentEpoch() {
+    return null;
+  }
   /**
    * Whether this entity still has a queued/running tween animation, or an
    * active {@link setTransition}/{@link animateTo}/{@link springTo} property
@@ -1140,16 +1168,18 @@ var MSDFTextEntity = (_class3 = class extends Entity {
   __init41() {this.layoutText = ""}
   __init42() {this.text = ""}
   __init43() {this.lastRenderedSeqId = 0}
+  /** Bumped by {@link queueLayout}; read by `Scene` to skip an unchanged sync. */
+  __init44() {this.contentEpoch = 0}
   // Atlas-decode subscription (see watchAtlasDecode). Held so `destroy()` can
   // release it: the handler closes over `this`, so leaving it attached to a
   // long-lived shared atlas image would retain the whole entity.
-  __init44() {this.atlasDecodeTarget = null}
-  __init45() {this.atlasDecodeHandler = null}
-  __init46() {this.rgbColorCache = /* @__PURE__ */ new Map()}
-  __init47() {this.fontStringCache = []}
-  __init48() {this.layoutResult = null}
+  __init45() {this.atlasDecodeTarget = null}
+  __init46() {this.atlasDecodeHandler = null}
+  __init47() {this.rgbColorCache = /* @__PURE__ */ new Map()}
+  __init48() {this.fontStringCache = []}
+  __init49() {this.layoutResult = null}
   constructor(text, options) {
-    super();_class3.prototype.__init40.call(this);_class3.prototype.__init41.call(this);_class3.prototype.__init42.call(this);_class3.prototype.__init43.call(this);_class3.prototype.__init44.call(this);_class3.prototype.__init45.call(this);_class3.prototype.__init46.call(this);_class3.prototype.__init47.call(this);_class3.prototype.__init48.call(this);;
+    super();_class3.prototype.__init40.call(this);_class3.prototype.__init41.call(this);_class3.prototype.__init42.call(this);_class3.prototype.__init43.call(this);_class3.prototype.__init44.call(this);_class3.prototype.__init45.call(this);_class3.prototype.__init46.call(this);_class3.prototype.__init47.call(this);_class3.prototype.__init48.call(this);_class3.prototype.__init49.call(this);;
     this.font = options.font;
     this.texture = options.texture;
     this.fallbackFont = _nullishCoalesce(options.fallbackFont, () => ( "sans-serif"));
@@ -1259,6 +1289,7 @@ var MSDFTextEntity = (_class3 = class extends Entity {
     });
   }
   queueLayout() {
+    this.contentEpoch++;
     _layout.LayoutWorkerManager.getInstance().queueLayout(this.id, this.layoutText, {
       fontId: this.font.id,
       fontSize: this.fontSize,
@@ -1288,6 +1319,9 @@ var MSDFTextEntity = (_class3 = class extends Entity {
       lineHeight: this.lineHeight
     };
   }
+  getContentEpoch() {
+    return this.contentEpoch;
+  }
   isPointInside(globalX, globalY) {
     if (!this.layoutResult) return false;
     const local = this.worldToLocal(globalX, globalY);
@@ -1421,23 +1455,23 @@ var SVGEntity = (_class4 = class extends Entity {
    * rasterized. Set to `'transparent'` to opt out and keep the box empty.
    * Default `'rgba(248,113,113,0.9)'`.
    */
-  __init49() {this.fallbackStroke = "rgba(248,113,113,0.9)"}
+  __init50() {this.fallbackStroke = "rgba(248,113,113,0.9)"}
   /** Fill behind the fallback marker. Default `'rgba(248,113,113,0.12)'`. */
-  __init50() {this.fallbackFill = "rgba(248,113,113,0.12)"}
-  __init51() {this.svgSource = ""}
-  __init52() {this.imageBitmap = null}
-  __init53() {this.imageElement = null}
-  __init54() {this.blobURL = null}
-  __init55() {this.currentImg = null}
-  __init56() {this.lodTimeout = null}
-  __init57() {this.rasterFailed = false}
-  __init58() {this.cachedDoc = null}
-  __init59() {this.baseWidth = 100}
-  __init60() {this.baseHeight = 100}
-  __init61() {this.lastRasterizedScale = 1}
-  __init62() {this.targetScale = 1}
+  __init51() {this.fallbackFill = "rgba(248,113,113,0.12)"}
+  __init52() {this.svgSource = ""}
+  __init53() {this.imageBitmap = null}
+  __init54() {this.imageElement = null}
+  __init55() {this.blobURL = null}
+  __init56() {this.currentImg = null}
+  __init57() {this.lodTimeout = null}
+  __init58() {this.rasterFailed = false}
+  __init59() {this.cachedDoc = null}
+  __init60() {this.baseWidth = 100}
+  __init61() {this.baseHeight = 100}
+  __init62() {this.lastRasterizedScale = 1}
+  __init63() {this.targetScale = 1}
   constructor(svgSource, id) {
-    super(id);_class4.prototype.__init49.call(this);_class4.prototype.__init50.call(this);_class4.prototype.__init51.call(this);_class4.prototype.__init52.call(this);_class4.prototype.__init53.call(this);_class4.prototype.__init54.call(this);_class4.prototype.__init55.call(this);_class4.prototype.__init56.call(this);_class4.prototype.__init57.call(this);_class4.prototype.__init58.call(this);_class4.prototype.__init59.call(this);_class4.prototype.__init60.call(this);_class4.prototype.__init61.call(this);_class4.prototype.__init62.call(this);;
+    super(id);_class4.prototype.__init50.call(this);_class4.prototype.__init51.call(this);_class4.prototype.__init52.call(this);_class4.prototype.__init53.call(this);_class4.prototype.__init54.call(this);_class4.prototype.__init55.call(this);_class4.prototype.__init56.call(this);_class4.prototype.__init57.call(this);_class4.prototype.__init58.call(this);_class4.prototype.__init59.call(this);_class4.prototype.__init60.call(this);_class4.prototype.__init61.call(this);_class4.prototype.__init62.call(this);_class4.prototype.__init63.call(this);;
     this.setSVGSource(svgSource);
   }
   setSVGSource(svgSource) {

package/dist/components/TextEntity.d.ts

@@ -12,12 +12,15 @@ export declare class TextEntity extends Entity {
     hoveredFillStyle: string | any;
     lineWidth: number;
     private isHovered;
+    /** Bumped by {@link applyLayout}; read by `Scene` to skip an unchanged sync. */
+    private contentEpoch;
     constructor(text: string, atlas: any, maxWidth: number, fontSize?: number);
     /**
      * Mirror the rendered text into the DOM content layer: find-in-page, screen
      * readers, crawlers, and translation see the same string the canvas draws.
      */
     getContentProjection(): ContentProjection | null;
+    getContentEpoch(): number;
     /**
      * Replace the text content. Runs the **cold** measurement pass (re-segment +
      * re-measure) since the glyphs changed, then re-lays out.