@autono/pinbox-toolbar 0.19.0 → 0.21.0

package/dist/svelte.d.ts

@@ -1,4 +1,4 @@
-import { _ as applyHubEvent, a as HubEvent, b as upsertPin, c as WebSocketLike, d as PinboxToolbarElement, f as Draft, g as appendThreadMessage, h as UiStatus, i as ConnectionState, l as HubError, m as ToolbarState, n as PinboxConfig, o as HubTransport, p as Store, r as defineToolbarElement, s as TransportOptions, t as Pinbox, u as StorageLike, v as createStore, x as CaptureResult, y as deriveUiStatus } from "./index-DENhglDF.js";
+import { S as CaptureResult, _ as appendThreadMessage, a as HubEvent, b as deriveUiStatus, c as WebSocketLike, d as mountPreviewSwitcher, f as PinboxToolbarElement, g as UiStatus, h as ToolbarState, i as ConnectionState, l as HubError, m as Store, n as PinboxConfig, o as HubTransport, p as Draft, r as defineToolbarElement, s as TransportOptions, t as Pinbox, u as StorageLike, v as applyHubEvent, x as upsertPin, y as createStore } from "./index-CMSOhoVs.js";
 import { Action } from "svelte/action";
 //#region src/svelte.d.ts
 /**
@@ -8,4 +8,4 @@ import { Action } from "svelte/action";
  */
 declare const pinbox: Action<HTMLElement, PinboxConfig>;
 //#endregion
-export { type CaptureResult, type ConnectionState, type Draft, HubError, type HubEvent, HubTransport, Pinbox, PinboxConfig, PinboxToolbarElement, type StorageLike, type Store, type ToolbarState, type TransportOptions, type UiStatus, type WebSocketLike, appendThreadMessage, applyHubEvent, createStore, defineToolbarElement, deriveUiStatus, pinbox, upsertPin };
+export { type CaptureResult, type ConnectionState, type Draft, HubError, type HubEvent, HubTransport, Pinbox, PinboxConfig, PinboxToolbarElement, type StorageLike, type Store, type ToolbarState, type TransportOptions, type UiStatus, type WebSocketLike, appendThreadMessage, applyHubEvent, createStore, defineToolbarElement, deriveUiStatus, mountPreviewSwitcher, pinbox, upsertPin };

package/dist/svelte.js

@@ -1,4 +1,4 @@
-import { a as HubError, c as createStore, i as HubTransport, l as deriveUiStatus, n as defineToolbarElement, o as appendThreadMessage, r as PinboxToolbarElement, s as applyHubEvent, t as Pinbox, u as upsertPin } from "./src-BsWnyGwB.js";
+import { a as HubTransport, c as applyHubEvent, d as upsertPin, i as PinboxToolbarElement, l as createStore, n as defineToolbarElement, o as HubError, r as mountPreviewSwitcher, s as appendThreadMessage, t as Pinbox, u as deriveUiStatus } from "./src-B134WXZ8.js";
 //#region src/svelte.ts
 /**
 * `<div use:pinbox={{ endpoint }} />` — creates + configures the element BEFORE insertion
@@ -15,4 +15,4 @@ const pinbox = (_node, config) => {
 	} };
 };
 //#endregion
-export { HubError, HubTransport, Pinbox, PinboxToolbarElement, appendThreadMessage, applyHubEvent, createStore, defineToolbarElement, deriveUiStatus, pinbox, upsertPin };
+export { HubError, HubTransport, Pinbox, PinboxToolbarElement, appendThreadMessage, applyHubEvent, createStore, defineToolbarElement, deriveUiStatus, mountPreviewSwitcher, pinbox, upsertPin };

package/dist/toolbar.iife.js

@@ -210,10 +210,11 @@ var Pinbox = (function(exports) {
 		];
 	}
 	function block(pin, thread) {
-		const { selector, url, source } = pin.target ?? {};
+		const { selector, url, source, model } = pin.target ?? {};
 		return [
 			`## Pin ${pin.n === void 0 ? pin.id : `#${pin.n} (${pin.id})`} — ${pin.status.toUpperCase()}`,
 			`- label: ${line(label(pin))}`,
+			...model ? [`- model: ${line(model.modelId)} / ${line(model.partId)} @ ${line(model.revision)}`, `- position: ${model.position.join(", ")} ${model.units}`] : [],
 			...selector === void 0 ? [] : [`- selector: \`${line(selector)}\``],
 			...(pin.target?.targets ?? []).map((t) => t.selector ?? t.anchor ?? t.tag).filter((locus) => locus !== void 0).map((locus) => `- also: \`${line(locus)}\``),
 			...source === void 0 ? [] : [`- source: ${line(source.line === void 0 ? source.file : `${source.file}:${source.line}`)}`],
@@ -810,6 +811,153 @@ var Pinbox = (function(exports) {
 		};
 	}
 	//#endregion
+	//#region src/model-capture.ts
+	const handlers = /* @__PURE__ */ new WeakMap();
+	function runModelCapture(owner) {
+		const entries = handlers.get(owner);
+		const entry = entries?.[0];
+		if (!entries || !entry) return false;
+		if (entries.some((candidate) => candidate.busy)) return true;
+		entry.busy = true;
+		try {
+			Promise.resolve(entry.run()).catch(entry.error).finally(() => {
+				entry.busy = false;
+			});
+		} catch (error) {
+			entry.busy = false;
+			entry.error(error);
+		}
+		return true;
+	}
+	/** Shared by the camera button, puck and S shortcut; preserve the 2D fallback. */
+	function toggleToolbarCapture(owner, endpoint, release) {
+		if (runModelCapture(owner)) return true;
+		const next = owner.store.get().captureMode === "tab" ? "dom" : "tab";
+		owner.store.update({ captureMode: next });
+		if (next === "dom") release();
+		saveCaptureMode(globalThis.localStorage, captureKey(`pinbox:${endpoint}`), next);
+		return true;
+	}
+	//#endregion
+	//#region src/reveal-settle.ts
+	const pending = /* @__PURE__ */ new WeakMap();
+	function cancelRevealSettle(doc) {
+		pending.get(doc)?.();
+	}
+	function settlePinReveal(doc, reveal) {
+		cancelRevealSettle(doc);
+		const win = doc.defaultView;
+		if (!win) return;
+		let attempts = 0;
+		let timer = 0;
+		const events = [
+			"wheel",
+			"touchstart",
+			"pointerdown",
+			"keydown"
+		];
+		const stop = () => {
+			win.clearTimeout(timer);
+			for (const event of events) doc.removeEventListener(event, stop, true);
+			pending.delete(doc);
+		};
+		for (const event of events) doc.addEventListener(event, stop, {
+			capture: true,
+			passive: true
+		});
+		const tick = () => {
+			reveal();
+			if (++attempts >= 10) stop();
+			else timer = win.setTimeout(tick, 150);
+		};
+		pending.set(doc, stop);
+		timer = win.setTimeout(tick, 150);
+	}
+	//#endregion
+	//#region src/pin-reveal.ts
+	/** Query ordering is not a view change; repeated parameter ordering remains intact. */
+	function samePinView(win, value) {
+		if (!value) return true;
+		try {
+			const target = new URL(value, win.location.href);
+			const current = new URL(win.location.href);
+			target.searchParams.sort();
+			current.searchParams.sort();
+			return target.pathname === current.pathname && target.search === current.search;
+		} catch {
+			return true;
+		}
+	}
+	function pagePin(pin) {
+		return pin.target?.selector === "html" || pin.target?.selector === "body";
+	}
+	/** Resolve before clipping: an offscreen row is precisely the target we need to scroll. */
+	function scrollToPin(doc, pin) {
+		if (pin.target?.model || pagePin(pin)) return false;
+		const win = doc.defaultView;
+		if (!win || !samePinView(win, pin.target?.url) || !pin.target?.selector) return false;
+		try {
+			const element = doc.querySelector(pin.target.selector);
+			if (!element?.getClientRects().length) return false;
+			element.scrollIntoView({
+				behavior: "instant",
+				block: "center",
+				inline: "center"
+			});
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	const key = (endpoint) => `pinbox:${endpoint}:reveal`;
+	/** Returns true when leaving this document. Never navigates to a different origin. */
+	function revealPin(doc, pin, endpoint) {
+		cancelRevealSettle(doc);
+		const win = doc.defaultView;
+		if (!win) return false;
+		try {
+			win.sessionStorage.removeItem(key(endpoint));
+		} catch {}
+		if (pagePin(pin) || pin.target?.model) return false;
+		if (pin.target?.url && !samePinView(win, pin.target.url)) try {
+			const target = new URL(pin.target.url, win.location.href);
+			if (target.origin !== win.location.origin || !["http:", "https:"].includes(target.protocol)) return false;
+			win.sessionStorage.setItem(key(endpoint), JSON.stringify({
+				id: pin.id,
+				expires: Date.now() + 3e4
+			}));
+			win.location.assign(target.href);
+			return true;
+		} catch {
+			return false;
+		}
+		scrollToPin(doc, pin);
+		return false;
+	}
+	/** Called on pin updates and DOM changes: SPA content may arrive after the toolbar. */
+	function pendingPinReveal(doc, pins, endpoint) {
+		const win = doc.defaultView;
+		if (!win) return null;
+		try {
+			const raw = win.sessionStorage.getItem(key(endpoint));
+			if (!raw) return null;
+			const pending = JSON.parse(raw);
+			if (typeof pending.id !== "string" || !Number.isFinite(pending.expires) || pending.expires < Date.now()) {
+				win.sessionStorage.removeItem(key(endpoint));
+				return null;
+			}
+			const pin = pins.find((p) => p.id === pending.id);
+			if (!pin || !scrollToPin(doc, pin)) return null;
+			win.sessionStorage.removeItem(key(endpoint));
+			settlePinReveal(doc, () => {
+				scrollToPin(doc, pin);
+			});
+			return pin.id;
+		} catch {
+			return null;
+		}
+	}
+	//#endregion
 	//#region src/targeting/dom.ts
 	/**
 	* Deepest element under (clientX, clientY) that the caller does not ignore, or null when there is
@@ -2370,8 +2518,8 @@ var Pinbox = (function(exports) {
 				inboxBtn.classList.toggle("lit", state.inboxOpen);
 				const open = String(openTaskCount(state.pins));
 				if (count.textContent !== open) count.textContent = open;
-				captureBtn.classList.toggle("lit", state.captureMode === "tab");
-				captureBtn.title = state.captureMode === "tab" ? "Tab capture on — real pixels, Chrome asks once per page load (S)" : "Screenshots: DOM snapshot, no prompt — press for tab capture (S)";
+				captureBtn.classList.toggle("lit", !state.captureLabel && state.captureMode === "tab");
+				captureBtn.title = state.captureLabel ?? (state.captureMode === "tab" ? "Tab capture on — real pixels, Chrome asks once per page load (S)" : "Screenshots: DOM snapshot, no prompt — press for tab capture (S)");
 				if (hideShown !== state.pinsHidden) {
 					hideShown = state.pinsHidden;
 					hideBtn.innerHTML = icon(state.pinsHidden ? EYE_GLYPH : EYE_OFF_GLYPH, 14);
@@ -2644,6 +2792,21 @@ var Pinbox = (function(exports) {
 		return `${isDraft ? `<div class="pb-seg" role="radiogroup" aria-label="Pin kind"><button type="button" role="radio" aria-checked="${kind === "note"}" class="${kind === "note" ? "on" : ""}" data-kind="note" title="An agent picks this up">Ask agent</button><button type="button" role="radio" aria-checked="${kind === "comment"}" class="${kind === "comment" ? "on" : ""}" data-kind="comment" title="A remark for people; no agent acts on it">Note</button></div>` : ""}<div class="pb-kbd">⌘ ↵</div><button type="button" class="pb-bt-solid" data-action="send">${hasThread ? "Reply" : kind === "comment" ? "Leave note" : "Comment"}</button>`;
 	}
 	//#endregion
+	//#region src/model-target.ts
+	const projectors = /* @__PURE__ */ new WeakMap();
+	function projectModelTarget(doc, anchor) {
+		for (const project of projectors.get(doc) ?? []) {
+			const p = project(anchor);
+			if (p && Number.isFinite(p.x) && Number.isFinite(p.y)) return {
+				x: p.x,
+				y: p.y,
+				width: 0,
+				height: 0
+			};
+		}
+		return null;
+	}
+	//#endregion
 	//#region src/ui/pins.ts
 	/** The prototype's `_h` innerHTML memo, kept off the DOM node. */
 	const chipMemo = /* @__PURE__ */ new WeakMap();
@@ -2651,20 +2814,6 @@ var Pinbox = (function(exports) {
 	function nextOrdinal(pins) {
 		return Math.max(pins.length, ...pins.map((p) => p.n ?? 0)) + 1;
 	}
-	/**
-	* Does the pin's captured URL still describe the view on screen? Path + search
-	* only — hashes are anchors, not views. An absent or unparseable URL never
-	* gates: old pins (and CLI pins) keep rendering exactly as before.
-	*/
-	function sameView(win, url) {
-		if (url === void 0) return true;
-		try {
-			const target = new URL(url, win.location.href);
-			return target.pathname === win.location.pathname && target.search === win.location.search;
-		} catch {
-			return true;
-		}
-	}
 	/** A stored (document-space) rect or point, in today's viewport. */
 	function toViewport(win, p) {
 		return {
@@ -2689,22 +2838,23 @@ var Pinbox = (function(exports) {
 	}
 	/** The same resolution for any captured target — a pin's, or the draft's before it commits. */
 	function targetRect(doc, target) {
+		if (target?.model) return projectModelTarget(doc, target.model);
 		const stored = target?.rect;
-		if (stored === void 0) return null;
 		const win = doc.defaultView;
-		if (win === null) return stored;
-		if (!sameView(win, target?.url)) return null;
+		if (win === null) return stored ?? null;
+		if (!samePinView(win, target?.url)) return null;
 		const selector = target?.selector;
-		if (selector === void 0) return toViewport(win, stored);
+		if (selector === void 0) return stored ? toViewport(win, stored) : null;
+		if (!stored && (selector === "html" || selector === "body")) return null;
 		let el;
 		try {
 			el = doc.querySelector(selector);
 		} catch {
-			return toViewport(win, stored);
+			return stored ? toViewport(win, stored) : null;
 		}
 		if (el === null) return null;
 		const r = el.getBoundingClientRect();
-		if (r.width <= 0 && r.height <= 0) return toViewport(win, stored);
+		if (r.width <= 0 && r.height <= 0) return stored ? toViewport(win, stored) : null;
 		return clipToScrollAncestors(win, el, {
 			x: r.left,
 			y: r.top,
@@ -3018,6 +3168,8 @@ var Pinbox = (function(exports) {
 	* labels the card without claiming an element that was never captured.
 	*/
 	function labelOf(target) {
+		if (target?.selector === "html" || target?.selector === "body") return "PAGE";
+		if (target?.model) return `3D · ${target.model.partId}`;
 		return target?.anchor ?? target?.tag?.toUpperCase() ?? "PIN";
 	}
 	function viewOf(root, state) {
@@ -3755,11 +3907,7 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
 			return loadCaptureMode(globalThis.localStorage, key, this.config?.capture ?? "dom");
 		}
 		#toggleCapture() {
-			const next = this.store.get().captureMode === "tab" ? "dom" : "tab";
-			this.store.update({ captureMode: next });
-			if (next === "dom") releaseCapture();
-			saveCaptureMode(globalThis.localStorage, captureKey(`pinbox:${this.config?.endpoint ?? ""}`), next);
-			return true;
+			return toggleToolbarCapture(this, this.config?.endpoint ?? "", releaseCapture);
 		}
 		/** Theme from the OS when the host set none; the page-level CSS (placing cursor) into <head>. */
 		#applyPageDefaults() {
@@ -4030,16 +4178,15 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
 		/** Inbox item click: activate the pin and scroll it into view (prototype line 700). */
 		#activateFromInbox(pinId) {
 			const pin = this.store.get().pins.find((p) => p.id === pinId);
+			if (!pin) return;
+			this.store.update({
+				inboxOpen: false,
+				activePinId: null,
+				pinsHidden: false
+			});
+			if (revealPin(document, pin, this.config?.endpoint ?? "")) return;
 			this.#ensureThread(pinId);
 			this.store.update({ activePinId: pinId });
-			const rect = pin === void 0 ? null : anchorRect(document, pin);
-			if (rect) {
-				const y = window.scrollY + rect.y + rect.height / 2;
-				window.scrollTo({
-					top: Math.max(0, y - window.innerHeight / 2),
-					behavior: "smooth"
-				});
-			}
 		}
 		/**
 		* Nudge a stale pin: re-post the last human message as a new thread message. A watcher that
@@ -4188,6 +4335,16 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
 			});
 		};
 		#render(state) {
+			const restored = pendingPinReveal(document, state.pins, this.config?.endpoint ?? "");
+			if (restored) {
+				this.#ensureThread(restored);
+				this.store.update({
+					activePinId: restored,
+					inboxOpen: false,
+					pinsHidden: false
+				});
+				return;
+			}
 			const placing = state.mode === "placing";
 			this.toggleAttribute("data-placing", placing);
 			document.body.classList.toggle(PAGE_PLACING_CLASS, placing);

package/dist/vue.d.ts

@@ -1,4 +1,4 @@
-import { d as PinboxToolbarElement, n as PinboxConfig } from "./index-DENhglDF.js";
+import { f as PinboxToolbarElement, n as PinboxConfig } from "./index-CMSOhoVs.js";
 import { VNode } from "vue";
 //#region src/vue.d.ts
 /** The slice of the Vue component instance this wrapper touches. */

package/dist/vue.js

@@ -1,4 +1,4 @@
-import { n as defineToolbarElement, r as PinboxToolbarElement } from "./src-BsWnyGwB.js";
+import { i as PinboxToolbarElement, n as defineToolbarElement } from "./src-B134WXZ8.js";
 import { h } from "vue";
 //#region src/vue.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autono/pinbox-toolbar",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -42,7 +42,11 @@
       "types": "./dist/plugins/next.d.ts",
       "default": "./dist/plugins/next.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./model": {
+      "types": "./dist/model.d.ts",
+      "default": "./dist/model.js"
+    }
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -71,7 +75,7 @@
     }
   },
   "devDependencies": {
-    "@autono/pinbox-core": "0.19.0",
+    "@autono/pinbox-core": "0.21.0",
     "@types/react": "^19.2.0",
     "typescript": "^7.0.0",
     "tsdown": "^0.22.0",