npm - @vectojs/core - Versions diffs - 1.28.1 → 1.30.0 - Mend

@vectojs/core 1.28.1 → 1.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/dist/{chunk-MVFPN4Y5.mjs → chunk-2WXZCPYQ.mjs} +47 -1
package/dist/{chunk-Z3HFY75R.js → chunk-7PI7LVWW.js} +124 -78
package/dist/{chunk-TI5EMJGL.mjs → chunk-IFSFHYF7.mjs} +44 -1
package/dist/{chunk-K2UGEIT6.js → chunk-M73XB4ZK.js} +98 -55
package/dist/index.js +432 -223
package/dist/index.mjs +225 -16
package/dist/renderer/CanvasRenderer.d.ts +23 -0
package/dist/renderer/GlyphRasterAtlas.d.ts +12 -0
package/dist/renderer/IRenderer.d.ts +17 -0
package/dist/renderer.js +2 -2
package/dist/renderer.mjs +1 -1
package/dist/text.js +2 -2
package/dist/text.mjs +1 -1
package/dist/tree/Entity.d.ts +78 -1
package/dist/tree/Scene.d.ts +88 -0
package/package.json +1 -1

package/dist/tree/Scene.d.ts CHANGED Viewed

@@ -555,6 +555,14 @@ export declare class Scene {
      *  mid-hover synthesize the `pointerleave` the browser never sends for a
      *  detached element, so the entity doesn't keep its hover state. */
     private readonly hoveredA11yElements;
+    /**
+     * Entity ids the application has pinned via {@link requestA11yProjection}.
+     *
+     * Ids rather than entities so a removed entity cannot be retained by this set;
+     * a stale id simply never matches. Cleared per-entity by
+     * {@link releaseA11yProjection}.
+     */
+    private readonly a11yProjectionRequests;
     /** Persistent tabindex=-1 element in a11yRoot. When the focused a11y mirror is
      *  pruned (virtualization/streaming/removal) while it holds focus, we move
      *  focus here instead of letting the browser drop it to <body> — keeping the
@@ -1324,6 +1332,58 @@ export declare class Scene {
      * predicate, which is only tractable while it has one home.
      */
     private shouldProjectA11y;
+    /**
+     * Whether an `a11yProjection: 'onDemand'` entity is currently engaged enough to
+     * deserve a shadow node.
+     *
+     * Deliberately **not** hover alone. A keyboard or assistive-technology user
+     * generates no pointer events, so a hover-only trigger would withhold the
+     * semantic node from precisely the users it exists for. Three signals, any of
+     * which counts:
+     *
+     * - **Focus.** Covers keyboard traversal and AT-driven focus. Checked against
+     *   the live element so a node keeps its own focus rather than being pruned out
+     *   from under the user mid-interaction.
+     * - **Pointer target.** The entity under the pointer, so a mouse user gets the
+     *   same node a hover-gated design would have given them.
+     * - **Explicit request.** {@link Scene.requestA11yProjection}, for anything the
+     *   app knows is significant — the selected item, a search hit, a
+     *   just-announced element. This is the escape hatch that keeps the mode usable
+     *   when neither focus nor pointer applies.
+     *
+     * The entity stays hit-testable on canvas regardless, so a click always reaches
+     * it and promotes it on the next sync.
+     */
+    private a11yEngaged;
+    /**
+     * Whether `node` mirrors selectable text of its own.
+     *
+     * Such an entity must not be promoted by the pointer: its interactive a11y node
+     * would sit above the text mirror and eat the mousedown that starts a native
+     * selection.
+     */
+    private projectsSelectableText;
+    /**
+     * Keep `entity`'s a11y shadow node projected while it has
+     * `a11yProjection: 'onDemand'`.
+     *
+     * For anything the application knows matters but the engine cannot infer — the
+     * selected danmaku, a search hit, a node just announced in a live region.
+     * Without this, `'onDemand'` would be reachable only by focus or pointer, and
+     * an app-driven selection change would leave the selected entity semantically
+     * invisible.
+     *
+     * Idempotent. Has no effect on an `'eager'` entity, which is always projected.
+     */
+    requestA11yProjection(entity: Entity | string): void;
+    /**
+     * Drop a projection request made by {@link requestA11yProjection}.
+     *
+     * The node is not removed immediately: it survives while it is focused or under
+     * the pointer, and is pruned on the next sync that finds it unengaged. Releasing
+     * a request the scene does not hold is a no-op.
+     */
+    releaseA11yProjection(entity: Entity | string): void;
     private syncA11y;
     /**
      * Mirror one entity's static text ({@link Entity.getContentProjection}) as a
@@ -1341,6 +1401,34 @@ export declare class Scene {
      * culling and always count as visible, matching the legacy behavior.
      */
     private projectionBoxVisible;
+    /**
+     * The band of an entity's own y coordinates that is worth projecting, or
+     * `null` to project everything.
+     *
+     * {@link projectionBoxVisible} answers "is this entity near the viewport",
+     * which frees whole blocks that scroll away. It cannot help a single entity
+     * *taller* than the viewport: that entity's box always intersects, so every
+     * one of its visual lines was materialized — a `<span>` per line and, on the
+     * grid path, a `<span>` per glyph cluster. That is where "14.8k elements for a
+     * 346KB Markdown doc" comes from, and it is O(document) rather than
+     * O(viewport) in both element count and per-frame walk cost.
+     *
+     * Measured on one entity scrolled to its middle, real headed browsers
+     * (`benchmarks/projection-per-line/`): at 4000 lines, materializing every line
+     * costs 6.28 ms/frame on Chrome and 6.51 ms on Firefox with 36,000 child
+     * elements, against 0.28/0.16 ms and 963 elements when only the visible band
+     * is emitted. The gated cost is *flat* across a 20x document-size range, so
+     * this converts an asymptote rather than shaving a constant.
+     *
+     * Returns local-y bounds in the entity's own coordinate space, already
+     * expanded by `margin` and intersected with every `clipChildren` ancestor, so
+     * a line inside a scrolled container is measured against the container rather
+     * than the window. `null` means "no useful bound" — a degenerate transform, a
+     * rotation/skew that makes a y-band meaningless, or a boundless entity — and
+     * the caller must then project every line, because emitting nothing would
+     * silently drop text from selection, find-in-page and screen readers.
+     */
+    private projectionVisibleLocalYBand;
     private syncContentProjection;
     /**
      * Materialize a prepared grid in logical source order while positioning each

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@vectojs/core",
-  "version": "1.28.1",
+  "version": "1.30.0",
   "publishConfig": {
     "access": "public"
   },