@vectojs/core 1.7.0 → 1.8.0

package/dist/layout.js

@@ -3,14 +3,14 @@
 
 
 
-var _chunkZBKKRYDHjs = require('./chunk-ZBKKRYDH.js');
+var _chunkBA5HUUDFjs = require('./chunk-BA5HUUDF.js');
 
 
-var _chunkCTZQOM5Zjs = require('./chunk-CTZQOM5Z.js');
+var _chunk4AR425ARjs = require('./chunk-4AR425AR.js');
 
 
 
 
 
 
-exports.LayoutEngine = _chunkZBKKRYDHjs.LayoutEngine; exports.LayoutResultBuffer = _chunkZBKKRYDHjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunkCTZQOM5Zjs.LayoutWorkerManager; exports.computeLineSegments = _chunkZBKKRYDHjs.computeLineSegments; exports.createCanvasMeasurer = _chunkZBKKRYDHjs.createCanvasMeasurer;
+exports.LayoutEngine = _chunkBA5HUUDFjs.LayoutEngine; exports.LayoutResultBuffer = _chunkBA5HUUDFjs.LayoutResultBuffer; exports.LayoutWorkerManager = _chunk4AR425ARjs.LayoutWorkerManager; exports.computeLineSegments = _chunkBA5HUUDFjs.computeLineSegments; exports.createCanvasMeasurer = _chunkBA5HUUDFjs.createCanvasMeasurer;

package/dist/layout.mjs

@@ -3,10 +3,10 @@ import {
   LayoutResultBuffer,
   computeLineSegments,
   createCanvasMeasurer
-} from "./chunk-V7GUWG5C.mjs";
+} from "./chunk-X7I465AQ.mjs";
 import {
   LayoutWorkerManager
-} from "./chunk-STWPTWO4.mjs";
+} from "./chunk-IESDTEJ4.mjs";
 export {
   LayoutEngine,
   LayoutResultBuffer,

package/dist/text/BidiResolver.d.ts

@@ -1,5 +1,4 @@
 export declare class BidiResolver {
-    private static getDirectionClass;
     static getBaseLevel(text: string): number;
     static resolveLevels(text: string): Uint8Array;
     static reorderVisual(nodes: any[], baseLevel: number): void;

package/dist/text/PreparedContentGrid.d.ts

@@ -0,0 +1,60 @@
+export interface PreparedContentGridCell {
+    /** UTF-16 source start, matching DOM Range offsets. */
+    readonly sourceStart: number;
+    /** UTF-16 source end, matching DOM Range offsets. */
+    readonly sourceEnd: number;
+    /** Legal UTF-16 caret offsets relative to `sourceStart`. */
+    readonly sourceCaretOffsets: readonly number[];
+    /** Contextually shaped glyph text used by the canvas painter. */
+    readonly glyph: string;
+    /** Visual x coordinate inside the line. */
+    readonly x: number;
+    /** Grid advance in local CSS pixels. */
+    readonly advance: number;
+    /** Resolved bidi embedding level. */
+    readonly level: number;
+}
+export interface PreparedContentGridLine {
+    /** Start of this logical line in {@link PreparedContentGrid.source}. */
+    readonly sourceStart: number;
+    /** End of visible line content, excluding the hard break. */
+    readonly sourceEnd: number;
+    /** Start of the next line, thereby owning the intervening hard break. */
+    readonly nextSourceStart: number;
+    /** Total visual grid width in local CSS pixels. */
+    readonly width: number;
+    /** Cells stay in logical source order; their x coordinates encode visual order. */
+    readonly cells: readonly PreparedContentGridCell[];
+}
+/**
+ * Immutable source-aware geometry shared by canvas grid text and its semantic
+ * DOM projection. It deliberately remains independent of syntax highlighting.
+ */
+export interface PreparedContentGrid {
+    readonly kind: 'content-grid';
+    readonly revision: number;
+    readonly source: string;
+    readonly font: string;
+    readonly cellWidth: number;
+    readonly lineHeight: number;
+    readonly baseline: number;
+    readonly tabSize: number;
+    readonly lines: readonly PreparedContentGridLine[];
+}
+export interface PrepareContentGridOptions {
+    /** CSS font shorthand shared by canvas and the projected DOM. */
+    font: string;
+    /** Width of one grid column in local CSS pixels. */
+    cellWidth: number;
+    /** Visual line advance in local CSS pixels. */
+    lineHeight: number;
+    /** Canvas baseline relative to each line's top. */
+    baseline: number;
+    /** Number of columns between tab stops. Defaults to 4. */
+    tabSize?: number;
+}
+/**
+ * Compile logical source into one retained grid plan. Canvas paint and native
+ * text projection must consume this same object rather than re-segmenting it.
+ */
+export declare function prepareContentGrid(source: string, options: PrepareContentGridOptions): PreparedContentGrid;

package/dist/text/index.d.ts

@@ -1,5 +1,6 @@
 export * from './ArabicShaper';
 export * from './BidiResolver';
+export * from './PreparedContentGrid';
 export * from './MSDFFont';
 export * from './MSDFTextEntity';
 export * from './SVGEntity';

package/dist/text.js

@@ -4,12 +4,12 @@
 
 
 
-var _chunkDFNK6OV6js = require('./chunk-DFNK6OV6.js');
 
+var _chunkFIQAIF55js = require('./chunk-FIQAIF55.js');
 
 
-var _chunkCTZQOM5Zjs = require('./chunk-CTZQOM5Z.js');
 
+var _chunk4AR425ARjs = require('./chunk-4AR425AR.js');
 
 
 
@@ -17,4 +17,6 @@ var _chunkCTZQOM5Zjs = require('./chunk-CTZQOM5Z.js');
 
 
 
-exports.ArabicShaper = _chunkCTZQOM5Zjs.ArabicShaper; exports.BidiResolver = _chunkCTZQOM5Zjs.BidiResolver; exports.MSDFFont = _chunkDFNK6OV6js.MSDFFont; exports.MSDFTextEntity = _chunkDFNK6OV6js.MSDFTextEntity; exports.SVGEntity = _chunkDFNK6OV6js.SVGEntity; exports.clearCssLineBoxMetrics = _chunkDFNK6OV6js.clearCssLineBoxMetrics; exports.cssLineBoxBaseline = _chunkDFNK6OV6js.cssLineBoxBaseline;
+
+
+exports.ArabicShaper = _chunk4AR425ARjs.ArabicShaper; exports.BidiResolver = _chunk4AR425ARjs.BidiResolver; exports.MSDFFont = _chunkFIQAIF55js.MSDFFont; exports.MSDFTextEntity = _chunkFIQAIF55js.MSDFTextEntity; exports.SVGEntity = _chunkFIQAIF55js.SVGEntity; exports.clearCssLineBoxMetrics = _chunkFIQAIF55js.clearCssLineBoxMetrics; exports.cssLineBoxBaseline = _chunkFIQAIF55js.cssLineBoxBaseline; exports.prepareContentGrid = _chunkFIQAIF55js.prepareContentGrid;

package/dist/text.mjs

@@ -3,12 +3,13 @@ import {
   MSDFTextEntity,
   SVGEntity,
   clearCssLineBoxMetrics,
-  cssLineBoxBaseline
-} from "./chunk-3CODWSF3.mjs";
+  cssLineBoxBaseline,
+  prepareContentGrid
+} from "./chunk-RQ2ETTBN.mjs";
 import {
   ArabicShaper,
   BidiResolver
-} from "./chunk-STWPTWO4.mjs";
+} from "./chunk-IESDTEJ4.mjs";
 export {
   ArabicShaper,
   BidiResolver,
@@ -16,5 +17,6 @@ export {
   MSDFTextEntity,
   SVGEntity,
   clearCssLineBoxMetrics,
-  cssLineBoxBaseline
+  cssLineBoxBaseline,
+  prepareContentGrid
 };

package/dist/tree/Entity.d.ts

@@ -1,4 +1,5 @@
 import { type MotionConfig, type TweenConfig, type SpringConfig } from '../animation/drivers';
+import type { PreparedContentGrid } from '../text/PreparedContentGrid';
 /** A numeric transform/visual property that participates in the animation system. */
 export type AnimatableProp = 'x' | 'y' | 'scaleX' | 'scaleY' | 'rotation' | 'opacity';
 /**
@@ -111,6 +112,20 @@ export interface ContentProjection {
     baseline?: number;
     /** Explicit visual lines for mixed-style or internally inset text. */
     lines?: ContentProjectionLine[];
+    /**
+     * Set to `'none'` for grid-drawn monospace content (code blocks, editors):
+     * the Scene disables OpenType ligatures and kerning on the projected DOM
+     * text so its selection geometry matches canvas text drawn cell-by-cell.
+     * Firefox otherwise ligates sequences like `ffi` in the DOM copy and the
+     * highlight drifts off the drawn glyphs.
+     */
+    ligatures?: 'normal' | 'none';
+    /**
+     * Retained source-aware grid geometry for code-like content. Canvas paint
+     * and semantic projection share this plan so grapheme, tab, wide-character,
+     * shaping, and bidi boundaries cannot drift between the two surfaces.
+     */
+    grid?: PreparedContentGrid;
 }
 /** Typography for a native input projected by the accessibility layer. */
 export interface TextInputStyle {
@@ -138,6 +153,12 @@ export interface A11yAttributes {
     label?: string;
     /** Explicit keyboard tab order for projected non-native interaction regions. */
     tabIndex?: number;
+    /**
+     * Whether the semantic shadow element participates in pointer hit testing.
+     * Use `'none'` for structural containers whose selectable or interactive
+     * descendants own the pointer surface. Defaults to `'auto'`.
+     */
+    pointerEvents?: 'auto' | 'none';
     /** Destination URL; only meaningful for `tag: 'a'`. */
     href?: string;
     /** Link target; only meaningful for `tag: 'a'`. Defaults to current window. */

package/dist/tree/Scene.d.ts

@@ -157,7 +157,25 @@ export declare class Scene {
     private a11yElements;
     /** DOM nodes mirroring static text content, keyed by entity id. */
     private contentElements;
+    /** Pending cold font-calibration frame per projected grid entity. */
+    private contentGridCalibrationFrames;
+    /** Detached, untransformed font probes used by the cold calibration pass. */
+    private contentGridCalibrationProbes;
+    /** Invalidates grid font calibration after browser font availability changes. */
+    private contentFontEpoch;
+    /** Cached Canvas-to-client scale for the current font/viewport epoch. */
+    private contentMetricScaleEpoch;
+    private contentMetricScaleX;
     private contentProjectionEnabled;
+    /**
+     * True while a text-selection drag that started on a projection's blank
+     * region (no text node under the press) is being driven manually — the
+     * browser has no native anchor for it, so mousemove extends the Selection
+     * from the position we resolved ourselves.
+     */
+    private blankRegionSelectionDrag;
+    private contentSelectionAnchor;
+    private contentSelectionEndListener;
     private frameHadAnimation;
     private frameHadInteractive;
     private resizeHandler;
@@ -199,6 +217,8 @@ export declare class Scene {
     private hasWarnedZeroSize;
     private fontLoadHandler;
     constructor(canvas: HTMLCanvasElement, options?: SceneOptions);
+    private endContentSelectionDrag;
+    private releaseContentSelectionForRebuild;
     /**
      * Expose the underlying {@link IRenderer} for advanced direct-draw operations.
      *
@@ -218,6 +238,7 @@ export declare class Scene {
      * @example scene.add(new CircleEntity());
      */
     add(entity: Entity): this;
+    private clearContentGridState;
     private removeA11yRecursively;
     /**
      * Remove a top-level entity from the scene graph and clean up its
@@ -297,6 +318,14 @@ export declare class Scene {
      * visible to the browser's text machinery anyway.
      */
     private syncContentProjection;
+    /**
+     * Materialize a prepared grid in logical source order while positioning each
+     * carrier from the shared canvas geometry. Browser font measurement happens
+     * later in one cold read/write batch, never inside projection synchronization.
+     */
+    private syncContentGridProjection;
+    private getContentMetricScaleX;
+    private scheduleContentGridCalibration;
     private enforceA11yDomOrder;
     /** Keep DOM/WebGL overlay layers aligned with the canvas's CSS box. */
     private syncOverlayGeometry;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/core",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "publishConfig": {
     "access": "public"
   },
@@ -49,9 +49,11 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "scripts": {
+    "benchmark:grid": "vitest bench benchmark/PreparedContentGrid.bench.ts --run",
     "build": "node scripts/build-worker.js && tsup && tsc -p tsconfig.build.json",
     "test": "vitest run",
     "test:e2e": "bun e2e/hidpi.e2e.ts && bun e2e/text-projection.e2e.ts"
@@ -59,6 +61,7 @@
   "dependencies": {},
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.10",
+    "bidi-js": "^1.0.3",
     "esbuild": "^0.28.1",
     "jsdom": "^29.1.1",
     "tsup": "^8.3.5",