@embedpdf/core-annotation 3.0.0-next.10 → 3.0.0-next.12

package/dist/index.d.cts

@@ -676,7 +676,12 @@ type Msg = {
 {
   t: 'hover';
   id: Id | null;
-} | {
+} |
+/** Force/clear session visibility for specific annotations (the actions
+ *  plane's Hide sink). Hiding also clears transient engagement (selection,
+ *  editing, hover) for the hidden ids. Unknown ids no-op. Zero effects. */
+/** Drop overrides for truly DELETED annotations (never for reloads). */
+{
   t: 'select';
   ids: Id[];
   add?: boolean;

package/dist/index.d.ts

@@ -676,7 +676,12 @@ type Msg = {
 {
   t: 'hover';
   id: Id | null;
-} | {
+} |
+/** Force/clear session visibility for specific annotations (the actions
+ *  plane's Hide sink). Hiding also clears transient engagement (selection,
+ *  editing, hover) for the hidden ids. Unknown ids no-op. Zero effects. */
+/** Drop overrides for truly DELETED annotations (never for reloads). */
+{
   t: 'select';
   ids: Id[];
   add?: boolean;

package/dist/index.js

@@ -3020,7 +3020,7 @@ const canMove = (m, id) => {
 *  `locked` (and inert `/F` states) suppress them at runtime — a
 *  screen-anchored body keeps its handles: `noZoom`/`noRotate` exempt it from
 *  the display transform, they don't freeze its size or vertices. */
-const hasHandles = (a) => {
+const hasHandles = (m, a) => {
 	if (!annotTransformable(a) || textBound(a)) return false;
 	const c = capsFor(a.subtype);
 	return c.resizable || c.vertexEditable;
@@ -3087,7 +3087,7 @@ function hitTest(m, pon, p, geom, strokeMargin, pageBox, inert, view) {
 					};
 				}
 			}
-			if (hasHandles(a)) {
+			if (hasHandles(m, a)) {
 				for (const h of geomHandles(hitGeomOf(a, view))) if (Math.abs(h.at.x - p.x) <= geom.handleTol && Math.abs(h.at.y - p.y) <= geom.handleTol) return {
 					t: "handle",
 					id: a.id,
@@ -4852,6 +4852,14 @@ function setProps(m, patch) {
 * COMMITTED member; uncommitted drafts just merge (their create draft carries
 * the flags when it commits).
 */
+/**
+* The actions plane's session-visibility write (Hide actions, script
+* `annot.hidden`): merge per-id hidden overrides into the session overlay.
+* Pure session state — ZERO effects, no engine write, no authority. Hiding
+* clears transient engagement so no orphaned selection chrome or text editor
+* survives on an invisible annotation. Identity-preserving no-op when nothing
+* changes (plugin memo caches key on model identity).
+*/
 function setFlags(m, patch, ids) {
 	const targets = ids ?? m.selected;
 	if (!targets.length) return [m, []];