dsh-figmark 1.1.2 → 1.2.0

package/lib/client.pdf.js

@@ -26166,6 +26166,91 @@ while (prev === _win[++scan] && prev === _win[++scan] && prev === _win[++scan] &
 			page.node.set(import_cjs.PDFName.of("Annots"), created);
 			return created;
 		}
+		/**
+		* A page number pulled into the document.
+		* @param page - the page asked for.
+		* @param pageCount - how many pages the document has.
+		* @returns the nearest page that exists.
+		*/
+		function clampPage(page, pageCount) {
+			const last = Math.max(pageCount, 1);
+			if (Number.isNaN(page)) return 1;
+			return Math.min(Math.max(Math.round(page), 1), last);
+		}
+		/**
+		* The page one step away, clamped at both ends.
+		* @param page - the page on screen.
+		* @param delta - how many pages to move; negative moves back.
+		* @param pageCount - how many pages the document has.
+		* @returns the page to show.
+		*/
+		function stepPage(page, delta, pageCount) {
+			return clampPage(page + delta, pageCount);
+		}
+		/**
+		* A page number typed into the box.
+		*
+		* Digits only: a reader typing "12" means page 12, and anything else is a typo
+		* that must leave them where they are rather than jump them somewhere arbitrary.
+		* A number past the end lands on the last page, which is what a reader typing it
+		* was reaching for anyway.
+		* @param raw - what the box holds.
+		* @param pageCount - how many pages the document has.
+		* @returns the page to show, or null when the text is not a page number.
+		*/
+		function parsePageInput(raw, pageCount) {
+			const digits = raw.trim();
+			if (!/^\d+$/u.test(digits)) return null;
+			return clampPage(Number.parseInt(digits, 10), pageCount);
+		}
+		/**
+		* The page turn a keystroke asks for.
+		*
+		* Only the keys a PDF reader answers to, and none of them while a modifier is
+		* held: Cmd+Arrow belongs to the shell, and swallowing it here would turn a text
+		* selection or a tab switch into a page turn.
+		* @param key - the event's key.
+		* @param modifiers - which modifiers were held.
+		* @returns the turn, or null when this key is not one.
+		*/
+		function keyedTurn(key, modifiers) {
+			if (modifiers.metaKey || modifiers.ctrlKey || modifiers.altKey) return null;
+			switch (key) {
+				case "ArrowRight":
+				case "ArrowDown":
+				case "PageDown":
+				case " ": return {
+					delta: 1,
+					absolute: false
+				};
+				case "ArrowLeft":
+				case "ArrowUp":
+				case "PageUp": return {
+					delta: -1,
+					absolute: false
+				};
+				case "Home": return {
+					delta: 1,
+					absolute: true
+				};
+				case "End": return {
+					delta: Number.POSITIVE_INFINITY,
+					absolute: true
+				};
+				default: return null;
+			}
+		}
+		/**
+		* The page a key turn lands on.
+		* @param turn - what the key asked for.
+		* @param page - the page on screen.
+		* @param pageCount - how many pages the document has.
+		* @returns the page to show.
+		*/
+		function keyedPage(turn, page, pageCount) {
+			if (!turn.absolute) return stepPage(page, turn.delta, pageCount);
+			return clampPage(turn.delta, pageCount);
+		}
 		//#endregion
 		//#region node_modules/.pnpm/pdfjs-dist@6.3.289/node_modules/pdfjs-dist/build/pdf.mjs
 		const isNodeJS = typeof process === "object" && process + "" === "[object process]" && !process.versions.nw && !(process.versions.electron && process.type && process.type !== "browser");
@@ -49919,11 +50004,48 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		* drawing surface and the marks of that page.
 		* @module dsh-figmark/client/pdf/PdfBody
 		*/
-		/** Gap kept around a page inside the pane, matching the annotator's own inset. */
+		/**
+		* Gap kept around a page inside the pane.
+		*
+		* The same number `AnnotatorBody` subtracts from its own stage width to decide how
+		* wide the page is drawn: a raster made for a box of a different width is a raster
+		* resampled to fit, and that is softness the reader sees on every glyph.
+		*/
 		const PANE_INSET = 24;
-		/** Highest device-pixel ratio one page bitmap is rendered at. */
+		/**
+		* Highest device-pixel ratio one page bitmap is rendered at.
+		*
+		* Three rather than two: a Retina display reports 2, but a *scaled* Retina mode (a
+		* "more space" resolution, a zoomed window) reports 3, and capping at 2 there leaves
+		* the page short of the pixels the screen actually has.
+		*/
 		const MAX_DENSITY = 2;
 		/**
+		* Bitmap pixels a page gets per screen pixel.
+		*
+		* A page is laid out in its own units and then scaled to the pane, so the browser
+		* resamples its bitmap whatever it wants. Measured in Chromium at a Retina ratio,
+		* how sharp the result reads depends on how many source pixels each screen pixel
+		* gets, and a bitmap that misses the screen's count by a few percent is the *worst*
+		* case, not the best — the resampler has no whole-pixel neighbours to average, so
+		* every glyph edge is blended with the background beside it.
+		*
+		* Measured, as the 99th percentile of the lateral gradient across a text line:
+		* 1.04× gives 129, 1.25× gives 157, 1.5× gives 168, 2× gives 178 (3× gives 181).
+		* The plateau is reached early: 1.5× already reads as sharp and costs a third of
+		* the memory 2× does, so this is the spare kept.
+		*/
+		const SUPERSAMPLE = 1.5;
+		/**
+		* The largest factor "fit width" draws a page at.
+		*
+		* The same ceiling `AnnotatorBody` applies when it decides how big to draw a figure;
+		* it is repeated here because a lazily loaded chunk may not import the client bundle
+		* at run time. Past this factor a wider pane buys no more drawn pixels, so the two
+		* numbers have to agree or this one pays for pixels the page never occupies.
+		*/
+		const FIT_CEILING = 1.5;
+		/**
 		* Narrowest width a page is rendered for; below it the pane is still settling.
 		* Compared against the stepped width, so the guard itself is a whole step wide.
 		*/
@@ -49939,6 +50061,65 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		*/
 		const RENDER_WIDTH_STEP = 64;
 		/**
+		* Whether a keystroke landed in a field the reader is typing into.
+		*
+		* An editable region is recognised by its attribute rather than by the
+		* `isContentEditable` property, which a rendered frame's own document does not
+		* answer for. Any element inside one counts, so a caret nested in a paragraph is
+		* as safe as the region itself.
+		* @param target - the event's target.
+		* @returns whether the keystroke belongs to the field.
+		*/
+		function typingIn(target) {
+			if (!(target instanceof HTMLElement)) return false;
+			if (target.closest("[contenteditable]:not([contenteditable=\"false\"])") !== null) return true;
+			return target.tagName === "INPUT" || target.tagName === "TEXTAREA" || target.tagName === "SELECT";
+		}
+		/**
+		* The document's own icons.
+		*
+		* Drawn here rather than imported from the annotator body: this is the lazy chunk,
+		* and the body reaches it as a prop precisely because the two halves cannot import
+		* each other. The paths follow the body's own icon grid so a strip of these and a
+		* strip of those read as one set.
+		*/
+		function ChevronLeftIcon() {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				className: "da-ico",
+				viewBox: "0 0 24 24",
+				"aria-hidden": "true",
+				focusable: "false",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M 14.5 5.5 L 8 12 L 14.5 18.5" })
+			});
+		}
+		function ChevronRightIcon() {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				className: "da-ico",
+				viewBox: "0 0 24 24",
+				"aria-hidden": "true",
+				focusable: "false",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M 9.5 5.5 L 16 12 L 9.5 18.5" })
+			});
+		}
+		function SendIcon() {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				className: "da-ico",
+				viewBox: "0 0 24 24",
+				"aria-hidden": "true",
+				focusable: "false",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M 3 12 L 21 3.9 L 15.9 21 L 12 14.1 Z" }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M 12 14.1 L 21 3.9" })]
+			});
+		}
+		function ChatIcon() {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				className: "da-ico",
+				viewBox: "0 0 24 24",
+				"aria-hidden": "true",
+				focusable: "false",
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M 3.75 9.75 a 3 3 0 0 1 3 -3 h 10.5 a 3 3 0 0 1 3 3 v 4.5 a 3 3 0 0 1 -3 3 h -6 l -4.5 3.3 v -3.3 a 3 3 0 0 1 -3 -3 z" })
+			});
+		}
+		/**
 		* Group one document's marks by the page they belong to.
 		* @param marks - every mark of the document.
 		* @returns the marks of each page; a mark without a page is on page 1.
@@ -49980,6 +50161,17 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 			const { createAutosave, annotationSignature, autosaveDelayMs } = props;
 			const bytes = props.content?.kind === "bytes" ? props.content.data : void 0;
 			const observerRef = (0, react.useRef)(null);
+			/** The panel itself, so the wheel can be followed where it lands. */
+			const hostRef = (0, react.useRef)(null);
+			/**
+			* The node the page bodies draw their floating chrome into.
+			*
+			* The pane, not the page: a bar mounted inside a page scrolls with that page, and
+			* and it must not move with a page: a bar mounted inside one would scroll away.
+			* as state because it has to be a node React has committed before a body can
+			* portal into it.
+			*/
+			const [chromeHost, setChromeHost] = (0, react.useState)(null);
 			const [pdf, setPdf] = (0, react.useState)(null);
 			/** The page the reader asked for: the number in the toolbar follows this one. */
 			const [requested, setRequested] = (0, react.useState)(1);
@@ -49994,6 +50186,36 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 			const [createdAt, setCreatedAt] = (0, react.useState)(null);
 			const [stale, setStale] = (0, react.useState)(false);
 			/**
+			* How many times the document has been cleared.
+			*
+			* A page body seeds its marks once, when it mounts, so clearing the document has
+			* to remount the page it is still showing — otherwise the body keeps listing the
+			* marks that were just delivered and deleted.
+			*/
+			const [generation, setGeneration] = (0, react.useState)(0);
+			/**
+			* The card open under the bar, and the mark it was opened about.
+			*
+			* Both live here rather than in a page body: paging away and back mounts a fresh
+			* body, and state that travelled with it would shut the list and put the comment
+			* pill away at every page boundary. One document, one list.
+			*/
+			const [openPanel, setOpenPanel] = (0, react.useState)(null);
+			const [selectedId, setSelectedId] = (0, react.useState)(null);
+			/**
+			* How much the whole document is magnified.
+			*
+			* The document is one picture in several sheets, so the factor belongs here and
+			* not in a page: a page body that kept its own would drop the magnification the
+			* moment the reader turned to the next page, and every page would have to be
+			* zoomed again. Held at this level, a pinch on page 3 is a pinch on the document.
+			*/
+			const [zoom, setZoom] = (0, react.useState)("fit");
+			/** What the page box holds while the reader is typing in it. */
+			const [pageText, setPageText] = (0, react.useState)("1");
+			/** Whether the page number is a box right now rather than a label. */
+			const [editingPage, setEditingPage] = (0, react.useState)(false);
+			/**
 			* How large the numbers are drawn across the whole document.
 			*
 			* One style for every page, because the numbers have to read as one set: a page
@@ -50003,8 +50225,14 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 			const [busy, setBusy] = (0, react.useState)(null);
 			const [status, setStatus] = (0, react.useState)(null);
 			const pageCount = pdf === null ? 0 : pdf.pageCount;
-			/** The pane width a raster is asked for: one step, whatever the drag did inside it. */
-			const renderWidth = Math.ceil(paneWidth / RENDER_WIDTH_STEP) * RENDER_WIDTH_STEP;
+			/**
+			* The width a raster is asked for: the pane's, stepped, times the magnification.
+			*
+			* The factor goes in here rather than into the slot, because a slot widened around
+			* an unzoomed bitmap is a blurred page: the pixels have to be there for the size
+			* the reader asked for.
+			*/
+			const renderWidth = Math.ceil(paneWidth * (zoom === "fit" ? 1 : zoom) / RENDER_WIDTH_STEP) * RENDER_WIDTH_STEP;
 			/**
 			* The seats this document acts through.
 			*
@@ -50074,6 +50302,8 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 			* unmount, which is where the observer goes.
 			*/
 			const attachHost = (0, react.useCallback)((element) => {
+				hostRef.current = element;
+				setChromeHost(element);
 				observerRef.current?.disconnect();
 				observerRef.current = null;
 				if (element === null) return;
@@ -50084,6 +50314,67 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				observer.observe(element);
 				observerRef.current = observer;
 			}, []);
+			/** The only place a page number is decided: requests are clamped, not trusted. */
+			const goTo = (0, react.useCallback)((next) => {
+				setRequested(() => clampPage(next, pageCount));
+			}, [pageCount]);
+			/** Take the page number the box holds, if it holds one. */
+			const commitPage = (0, react.useCallback)(() => {
+				const next = parsePageInput(pageText, pageCount);
+				if (next === null) {
+					setPageText(String(requested));
+					return;
+				}
+				goTo(next);
+				setPageText(String(next));
+			}, [
+				goTo,
+				pageCount,
+				pageText,
+				requested
+			]);
+			/** Enter commits the box; Escape puts the box back to the page on screen. */
+			const submitPage = (0, react.useCallback)((event) => {
+				if (event.key === "Enter") {
+					event.preventDefault();
+					commitPage();
+					setEditingPage(false);
+					return;
+				}
+				if (event.key === "Escape") {
+					event.preventDefault();
+					setPageText(String(requested));
+					setEditingPage(false);
+				}
+			}, [commitPage, requested]);
+			/** The page number the toolbar states: the requested one, clamped to the document. */
+			const stated = clampPage(requested, pageCount);
+			/**
+			* Turn to whatever page a keystroke asks for.
+			*
+			* The keys are read here rather than on the page body because paging belongs to
+			* the document: the body annotates one page and has no idea there are others, and
+			* a keystroke it swallowed would never reach the document at all.
+			*/
+			(0, react.useEffect)(() => {
+				if (pdf === null) return;
+				const onKeyDown = (event) => {
+					if (typingIn(event.target)) return;
+					const turn = keyedTurn(event.key, event);
+					if (turn === null) return;
+					event.preventDefault();
+					goTo(keyedPage(turn, stated, pageCount));
+				};
+				window.addEventListener("keydown", onKeyDown);
+				return () => {
+					window.removeEventListener("keydown", onKeyDown);
+				};
+			}, [
+				goTo,
+				pageCount,
+				pdf,
+				stated
+			]);
 			(0, react.useEffect)(() => {
 				if (pdf === null || renderWidth < MIN_PANE_WIDTH) return;
 				let live = true;
@@ -50107,10 +50398,27 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				requested,
 				renderWidth
 			]);
-			/** The only place a page number is decided: requests are clamped, not trusted. */
-			const goTo = (0, react.useCallback)((next) => {
-				setRequested(() => Math.min(Math.max(next, 1), Math.max(pageCount, 1)));
-			}, [pageCount]);
+			/**
+			* Drop one mark from wherever in the document it was drawn.
+			*
+			* The list shows the whole file, so its delete button can name a mark on a page
+			* this surface is not holding: the owner is the only one that knows every page.
+			* @param id - the mark to remove.
+			*/
+			const removeAnyMark = (0, react.useCallback)((id) => {
+				setMarks((current) => {
+					let changed = false;
+					const next = new Map(current);
+					for (const [page, pageMarks] of current) {
+						const kept = pageMarks.filter((mark) => mark.id !== id);
+						if (kept.length !== pageMarks.length) {
+							changed = true;
+							next.set(page, kept);
+						}
+					}
+					return changed ? next : current;
+				});
+			}, []);
 			/** Keep one page's unsaved edits while another page is on screen. */
 			const remember = (0, react.useCallback)((edited, draft) => {
 				setMarks((current) => current.get(edited) === draft.marks ? current : new Map(current).set(edited, draft.marks));
@@ -50250,6 +50558,7 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				setSummary("");
 				setCreatedAt(null);
 				setStale(false);
+				setGeneration((current) => current + 1);
 			}, [address]);
 			/**
 			* Save the document's annotation and hand it to the agent, or into the draft.
@@ -50319,44 +50628,143 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 				pdf,
 				signature
 			]);
-			const total = allMarks(marks).length;
+			/**
+			* Show a mark the reader pressed in the list, wherever in the document it is.
+			*
+			* The list is the document's, so a row can name a mark on a page that is not on
+			* screen. Turning to it is this component's job because the page number is its
+			* state — and the selection is set at the same moment, so the page that arrives
+			* already has the mark selected and its comment pill beside it. Selecting first
+			* and turning second is deliberate: the turn remounts the page body, and a mark
+			* that became selected after the remount would show the pill only on a second
+			* render.
+			*/
+			const revealMark = (0, react.useCallback)((mark) => {
+				setSelectedId(mark.id);
+				if (mark.page !== void 0) goTo(mark.page);
+			}, [goTo]);
 			const numbering = new Map(allMarks(marks).map((mark, index) => [mark.id, index + 1]));
+			/**
+			* What every page body is told, assembled once.
+			*
+			* One pane shows one page at a time, so there is a single body to hand these to —
+			* but it is assembled here rather than inline so the props a page needs are one
+			* list, not a list that has to be kept in step with a second mount site.
+			*/
+			const pageProps = {
+				resourceAddress: props.resourceAddress,
+				scrollportRef: props.scrollportRef,
+				t,
+				content: void 0,
+				draft: { marks: marks.get(stated) ?? [] },
+				onDraftChange: reportDraft,
+				numbering,
+				summary,
+				onSummaryChange: setSummary,
+				mode,
+				onModeChange: setMode,
+				openPanel,
+				onOpenPanelChange: setOpenPanel,
+				selectedId,
+				onSelectedIdChange: setSelectedId,
+				onRevealMark: revealMark
+			};
+			/**
+			* The paging controls, for the page body's bar to place.
+			*
+			* Drawn here because the page number is this document's state, and placed there
+			* because the bar belongs to the page body: one card holds every control the pane
+			* offers, and none of them move when the page scrolls.
+			*/
+			const pagingSlot = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "da-docbar-group",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "da-dock-btn",
+						"aria-label": t("previousPage"),
+						title: t("previousPage"),
+						disabled: stated <= 1,
+						onClick: () => {
+							goTo(stated - 1);
+						},
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ChevronLeftIcon, {})
+					}),
+					editingPage ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+						className: "da-page-input",
+						autoFocus: true,
+						inputMode: "numeric",
+						"aria-label": t("pageJump"),
+						value: pageText,
+						onChange: (event) => {
+							setPageText(event.target.value);
+						},
+						onBlur: () => {
+							commitPage();
+							setEditingPage(false);
+						},
+						onKeyDown: submitPage
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "da-page da-page-btn",
+						title: t("pageJump"),
+						"aria-label": t("pageJump"),
+						onClick: () => {
+							setPageText(String(stated));
+							setEditingPage(true);
+						},
+						children: pdf === null ? `${stated}` : `${stated} / ${pageCount}`
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: "da-dock-btn",
+						"aria-label": t("nextPage"),
+						title: t("nextPage"),
+						disabled: pdf !== null && stated >= pageCount,
+						onClick: () => {
+							goTo(stated + 1);
+						},
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ChevronRightIcon, {})
+					})
+				]
+			}) });
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "da-pdf",
 				ref: attachHost,
 				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "da-toolbar",
+					shown !== null ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "da-bar",
+						"data-static": "true",
+						role: "toolbar",
+						"aria-label": t("pagerLabel"),
 						children: [
+							pagingSlot,
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "da-spacer" }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: "da-dock-sep",
+								"aria-hidden": true
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
-								className: "da-btn",
-								disabled: requested <= 1,
+								className: "da-dock-btn",
+								disabled: busy !== null,
+								"aria-label": t("sendToAgent"),
+								title: t("sendToAgent"),
 								onClick: () => {
-									goTo(requested - 1);
+									run("agent");
 								},
-								children: t("previousPage")
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "da-page",
-								children: pdf === null ? `${requested}` : `${requested} / ${pageCount}`
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SendIcon, {})
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
-								className: "da-btn",
-								disabled: requested >= pageCount,
+								className: "da-dock-btn",
+								disabled: busy !== null,
+								"aria-label": t("sendToComposer"),
+								title: t("sendToComposer"),
 								onClick: () => {
-									goTo(requested + 1);
+									run("composer");
 								},
-								children: t("nextPage")
-							}),
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "da-spacer" }),
-							pdf === null ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-								className: "da-page",
-								children: t("documentScope", {
-									pages: pageCount,
-									marks: total
-								})
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ChatIcon, {})
 							})
 						]
 					}),
@@ -50381,39 +50789,17 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 							children: t("pdfRendering")
 						})
 					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AnnotatorBody, {
-						resourceAddress: props.resourceAddress,
-						scrollportRef: props.scrollportRef,
-						t,
-						content: void 0,
+						...pageProps,
 						page: shown.bitmap,
 						draft: { marks: marks.get(shown.page) ?? [] },
-						onDraftChange: reportDraft,
-						numbering,
-						summary,
-						onSummaryChange: setSummary,
-						mode,
-						onModeChange: setMode
-					}, shown.page),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-						className: "da-send",
-						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							className: "da-btn",
-							disabled: busy !== null,
-							onClick: () => {
-								run("agent");
-							},
-							children: t("sendToAgent")
-						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							className: "da-btn",
-							disabled: busy !== null,
-							onClick: () => {
-								run("composer");
-							},
-							children: t("sendToComposer")
-						})]
-					})
+						chromeHost,
+						pagingSlot,
+						onSend: run,
+						zoom,
+						onZoom: setZoom,
+						documentMarks: allMarks(marks),
+						onDocumentRemove: removeAnyMark
+					}, `${generation}:${shown.page}`)
 				]
 			});
 		}
@@ -50426,9 +50812,10 @@ fn fs_main(in : VertexOutput) -> @location(0) vec4<f32> {
 		*/
 		async function renderPage(pdf, page, paneWidth) {
 			const size = await pdf.size(page);
-			const fit = Math.max(.1, (paneWidth - PANE_INSET) / size.width);
-			const density = Math.min(MAX_DENSITY, globalThis.devicePixelRatio || 1);
-			const rendered = await pdf.render(page, fit * density);
+			const room = Math.max(1, paneWidth - PANE_INSET);
+			const shown = Math.min(room, size.width * FIT_CEILING);
+			const density = Math.min(MAX_DENSITY, Math.max(1, globalThis.devicePixelRatio || 1));
+			const rendered = await pdf.render(page, shown * density * SUPERSAMPLE / size.width);
 			return {
 				dataUrl: rendered.dataUrl,
 				width: rendered.width,

package/lib/index.js

@@ -21,9 +21,9 @@ const GUIDANCE = [
 	"",
 	"用户可能在文档预览里直接标注（箭头/框选/椭圆/手绘/单点），发送给你的消息以【附图标注】开头，正文就是**逐条标注清单**，不需要再去读任何附加文件（标注文件是投递用的临时件，发出即删）。收到时按下列纪律处理：",
 	"",
-	"1. 逐条读消息正文的清单：每条形如 `① 箭头 (10,10) → (40,30)，要改：标号指错了`，括号里是图面像素坐标（原点在左上角），`要改：` 之后是用户写的**详细说明**——那是这条标注唯一的内容，按它判断意图。有的条目还带 `锚定:` 后缀，说明该处落在一个具体元素上（SVG 给 `title`/`id`/元素文字，HTML 给 `selector`/元素文字），定位时优先用它。",
+	"1. 逐条读消息正文的清单：每条形如 `① 箭头 (10,10) → (40,30)，批注：标号指错了`。括号里是图面像素坐标，原点在左上角；框选与圈选给的是**左上角-右下角**，手绘线给的是它画在哪个框里。`批注：` 之后是用户写的**详细说明**——那是这条标注唯一的内容，按它判断意图。有的条目在形状后面紧跟一个圆括号，写着该处落在哪个元素上（SVG 给元素标题/`id`/元素文字，HTML 给 `selector`/元素文字），定位时优先用它。",
 	"2. **PDF 是整份文档一份标注**：每条标注都带 `第 N 页`，坐标是那一页自己的（原点在该页左上角）。看每条标注前先确认它的页码。",
-	"3. 有形状的标注（箭头/框选/椭圆/手绘）会附一张标注图（`<图名>.annotated.png`，PDF 则是一份**带批注的 PDF**，其批注是原生 PDF 注释对象：`/Ink` 手绘、`/Square` 框选、`/Circle` 圈选、`/Line` 箭头），可直接打开核对图面位置。**若消息说「本条标注只有位置点，没有标注图」，那就是全部内容：只有坐标加一句说明，直接按原图定位处理，不要去找不存在的附件。**",
+	"3. 若标注超出原图边界，标注图会把越界的那圈纸也画出来，并用**灰色虚线**框住原图真正的边缘：虚线**里面**是原图，**外面**是你画的标注伸出去的部分——那块不属于图，不要把它当成新增的画布内容。有形状的标注（箭头/框选/椭圆/手绘）会附一张标注图（`<图名>.annotated.png`，PDF 则是一份**带批注的 PDF**，其批注是原生 PDF 注释对象：`/Ink` 手绘、`/Square` 框选、`/Circle` 圈选、`/Line` 箭头），可直接打开核对图面位置。**若消息说「本条标注只有位置点，没有标注图」，那就是全部内容：只有坐标加一句说明，直接按原图定位处理，不要去找不存在的附件。**",
 	"4. 逐条处理标注：每条标注都要落到具体的图面改动，并在答复里逐条回应（编号与标注一致）。无法实现的标注要说明原因，不要静默跳过。",
 	"5. 修改附图以**标注所指的生成源**为准（绘制脚本、SVG 源或 `generate_patent_figure` 的入参），不要直接涂改导出的位图；PDF 同理，改的是生成该 PDF 的源头，不是那份带批注的副本。未标注的部分保持不动。",
 	"6. 改完图后重新渲染并核对：图面尺寸/坐标若变化，旧标注的坐标会失准，此时以 `anchor` 与标注文字为准复核一遍，再回报结果。",
@@ -270,7 +270,7 @@ const WEIGHT_MIN = .5;
 * @returns the value, pulled to the nearest end of the range.
 */
 function clampWeight(value) {
-	return Math.min(4, Math.max(WEIGHT_MIN, value));
+	return Math.min(8, Math.max(WEIGHT_MIN, value));
 }
 //#endregion
 //#region src/host/store.ts
@@ -693,11 +693,11 @@ async function resolveTarget(address, deps) {
 		ok: false,
 		message: `not a file address: ${address}`
 	};
+	const sessionId = parsed.sessionId;
+	const cwd = sessionId === void 0 ? void 0 : await deps.sessionCwd(sessionId);
 	let absolute;
 	if (isAbsolute(parsed.path)) absolute = parsed.path;
 	else {
-		const sessionId = parsed.sessionId;
-		const cwd = sessionId === void 0 ? void 0 : await deps.sessionCwd(sessionId);
 		if (cwd === void 0) return {
 			ok: false,
 			message: `cannot resolve this Session's directory for a relative path: ${address}`
@@ -730,7 +730,8 @@ async function resolveTarget(address, deps) {
 		target: {
 			address,
 			path: absolute,
-			mediaType
+			mediaType,
+			workspace: cwd ?? null
 		}
 	};
 }

package/market/index.json

@@ -93,8 +93,8 @@
       },
       "versions": [
         {
-          "version": "1.1.2",
-          "publishTimestamp": 1792731605,
+          "version": "1.2.0",
+          "publishTimestamp": 1793167602,
           "source": {
             "type": "npm",
             "registry": "https://registry.npmjs.org"