getobsrv 0.5.0 → 0.7.0

package/out/renderer/assets/{index-DyCD4ih_.js → index-BP1S2N6S.js}

@@ -12688,7 +12688,13 @@ const createImpl = (createState) => {
 };
 const create = ((createState) => createImpl);
 const MAX_VIEWPORT = 4096;
-const DEFAULT_SETTINGS = { hostDiagonalInches: 27, hostNits: 500, agentControl: false };
+const DEFAULT_SETTINGS = {
+  hostDiagonalInches: 27,
+  hostNits: 500,
+  agentControl: false,
+  updateCheck: true,
+  lastUpdateCheck: 0
+};
 const SCREEN_PRESETS = [
   // Laptops — ordered largest to smallest panel, then the denser 1080p outlier.
   { id: "laptop-768", label: '1366×768 15.6"', width: 1366, height: 768, diagonalInches: 15.6, deviceScaleFactor: 1, group: "laptop" },
@@ -12773,6 +12779,7 @@ const useStore = create()((set) => ({
   targetLoading: false,
   error: null,
   toast: null,
+  update: null,
   image: null,
   surround: "graphite",
   viewMode: "1:1",
@@ -12798,6 +12805,7 @@ const useStore = create()((set) => ({
   // Both panes report the same `loadError` for one failed navigation; the
   // duplicate must not replace the object and re-render everything twice.
   setError: (error) => set((s) => sameError(s.error, error) ? {} : { error }),
+  setUpdate: (update) => set({ update }),
   setToast: (toast) => set({ toast }),
   setImage: (image) => set({ image }),
   setSurround: (surround) => set({ surround }),
@@ -13228,6 +13236,18 @@ function PanelControls() {
     /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "muted", children: "Choosing a profile in the toolbar resets these." })
   ] });
 }
+const MINUTE = 6e4;
+const HOUR = 60 * MINUTE;
+const DAY = 24 * HOUR;
+const plural = (n, unit) => `${n} ${unit}${n === 1 ? "" : "s"} ago`;
+function formatAge(checkedAt, now) {
+  if (!Number.isFinite(checkedAt) || checkedAt <= 0) return "never";
+  const age = now - checkedAt;
+  if (age < MINUTE) return "just now";
+  if (age < HOUR) return plural(Math.floor(age / MINUTE), "minute");
+  if (age < DAY) return plural(Math.floor(age / HOUR), "hour");
+  return plural(Math.floor(age / DAY), "day");
+}
 function NumberField({ className, label, unit, value, min, step, onCommit, onInvalid }) {
   const ref = reactExports.useRef(null);
   const [draft, setDraft] = reactExports.useState(String(value));
@@ -13278,6 +13298,7 @@ function NumberField({ className, label, unit, value, min, step, onCommit, onInv
 function SettingsPanel() {
   const host = useStore(useShallow((s) => s.host));
   const settings = useStore(useShallow((s) => s.settings));
+  const update = useStore((s) => s.update);
   const custom = useStore(useShallow((s) => s.custom));
   const viewport = useStore(useShallow(selectViewport));
   const scale = useStore(selectScale);
@@ -13396,7 +13417,45 @@ function SettingsPanel() {
       viewport.height,
       "."
     ] }),
-    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "readout", children: custom.diagonalInches > 0 ? `${ppi(custom.width, custom.height, custom.diagonalInches).toFixed(0)} PPI` : "Enter a diagonal to compute PPI" })
+    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "readout", children: custom.diagonalInches > 0 ? `${ppi(custom.width, custom.height, custom.diagonalInches).toFixed(0)} PPI` : "Enter a diagonal to compute PPI" }),
+    /* @__PURE__ */ jsxRuntimeExports.jsx("h2", { children: "Updates" }),
+    /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "version-block", children: [
+      /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "version-row", children: [
+        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { children: "Version" }),
+        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "version-current num", children: update?.current ?? "—" })
+      ] }),
+      /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "version-row", children: [
+        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { children: "Latest" }),
+        /* @__PURE__ */ jsxRuntimeExports.jsxs("span", { className: "version-latest", children: [
+          update === null && "Not checked yet",
+          update?.status === "current" && update.checkedAt === 0 && "Not checked yet",
+          update?.status === "current" && update.checkedAt > 0 && "Up to date",
+          update?.status === "error" && "Couldn’t check",
+          update?.status === "available" && update.latest !== void 0 && /* @__PURE__ */ jsxRuntimeExports.jsxs(jsxRuntimeExports.Fragment, { children: [
+            /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "num", children: update.latest }),
+            " · ",
+            /* @__PURE__ */ jsxRuntimeExports.jsx("button", { type: "button", className: "link", onClick: () => void window.obsrv.openRelease(), children: "Download" })
+          ] })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "version-row", children: [
+        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { children: "Last checked" }),
+        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "version-checked num", children: update === null ? "never" : formatAge(update.checkedAt, Date.now()) })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxRuntimeExports.jsxs("label", { className: "control inline update-check-toggle", children: [
+      /* @__PURE__ */ jsxRuntimeExports.jsx(
+        "input",
+        {
+          type: "checkbox",
+          checked: settings.updateCheck,
+          onChange: (e) => commit({ ...settings, updateCheck: e.target.checked })
+        }
+      ),
+      /* @__PURE__ */ jsxRuntimeExports.jsx("span", { children: "Check for updates automatically" })
+    ] }),
+    /* @__PURE__ */ jsxRuntimeExports.jsx("button", { type: "button", className: "check-now", onClick: () => void window.obsrv.checkUpdate(), children: "Check now" }),
+    /* @__PURE__ */ jsxRuntimeExports.jsx("p", { className: "muted", children: "One unauthenticated request to GitHub, at most once a day. No identifiers are sent." })
   ] });
 }
 const VERT_SRC = `#version 300 es
@@ -14237,6 +14296,7 @@ function Toolbar({ drawer, onTogglePanel, onToggleSettings }) {
   const setPixelExact = useStore((s) => s.setPixelExact);
   const setError = useStore((s) => s.setError);
   const surround = useStore((s) => s.surround);
+  const update = useStore((s) => s.update);
   const setSurround = useStore((s) => s.setSurround);
   const viewMode = useStore((s) => s.viewMode);
   const setViewMode = useStore((s) => s.setViewMode);
@@ -14367,6 +14427,20 @@ function Toolbar({ drawer, onTogglePanel, onToggleSettings }) {
       ),
       "Pixel-exact"
     ] }),
+    update?.status === "available" && update.latest !== void 0 && /* @__PURE__ */ jsxRuntimeExports.jsxs(
+      "button",
+      {
+        className: "update-button",
+        type: "button",
+        title: `Obsrv ${update.latest} is available — opens the download page`,
+        onClick: () => void window.obsrv.openRelease(),
+        children: [
+          "v",
+          update.latest,
+          " ↓"
+        ]
+      }
+    ),
     /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "surround-control", role: "group", "aria-label": "Pane surround", children: SURROUNDS.map((s) => /* @__PURE__ */ jsxRuntimeExports.jsx(
       "button",
       {
@@ -14431,6 +14505,7 @@ function App() {
   const setUrl = useStore((s) => s.setUrl);
   const setError = useStore((s) => s.setError);
   const setTargetLoading = useStore((s) => s.setTargetLoading);
+  const setUpdate = useStore((s) => s.setUpdate);
   const setImageMeta = useStore((s) => s.setImage);
   const setMode = useStore((s) => s.setMode);
   const setToast = useStore((s) => s.setToast);
@@ -14444,6 +14519,7 @@ function App() {
   reactExports.useEffect(() => {
     window.obsrv.getHostInfo().then(setHost, (e) => console.warn("obsrv: getHostInfo failed", e));
     window.obsrv.getSettings().then(setSettings, (e) => console.warn("obsrv: getSettings failed", e));
+    window.obsrv.getUpdate().then(setUpdate, (e) => console.warn("obsrv: getUpdate failed", e));
     const offs = [
       window.obsrv.onHostChanged(setHost),
       // A committed navigation — back, forward, reload, a link — supersedes
@@ -14454,12 +14530,13 @@ function App() {
         setUrl(url);
       }),
       window.obsrv.onLoadError(setError),
-      window.obsrv.onTargetLoading(setTargetLoading)
+      window.obsrv.onTargetLoading(setTargetLoading),
+      window.obsrv.onUpdateStatus(setUpdate)
     ];
     return () => {
       for (const off of offs) off();
     };
-  }, [setHost, setSettings, setUrl, setError, setTargetLoading]);
+  }, [setHost, setSettings, setUrl, setError, setTargetLoading, setUpdate]);
   reactExports.useEffect(() => {
     void window.obsrv.setViewport(viewport.width, viewport.height, deviceScaleFactor);
   }, [viewport.width, viewport.height, deviceScaleFactor]);

package/out/renderer/assets/{index-CHF-G97L.css → index-BeroS4wv.css}

@@ -477,3 +477,49 @@ html, body, #root { margin: 0; height: 100%; background: var(--chrome-0); color:
 }
 .browser-notice p { margin: 0.75rem 0 0; color: var(--text-1); }
 .browser-notice code { font-family: var(--mono); }
+
+/* An update is neither a warning nor an error, so it carries no colour: the
+   only chromatic pixels in this chrome stay reserved for real attention. */
+/* `.toolbar button` is (0,1,1) and pins every button to a 26px square, so this
+   needs two classes to outrank it — a bare `.update-button` renders as "v0.". */
+.toolbar .update-button {
+  font-family: var(--mono);
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+  width: auto;
+  flex: 0 0 auto;
+  padding: 0 8px;
+}
+.version-block { margin: 8px 0; }
+.version-row {
+  display: flex;
+  justify-content: space-between;
+  gap: 10px;
+  padding: 3px 0;
+  color: var(--text-1);
+}
+.version-row .version-current,
+.version-row .version-latest,
+.version-row .version-checked {
+  color: var(--text-0);
+  text-align: right;
+}
+.link {
+  background: none;
+  border: 0;
+  padding: 0;
+  color: var(--text-0);
+  text-decoration: underline;
+  cursor: pointer;
+  font: inherit;
+}
+.check-now {
+  width: 100%;
+  height: 24px;
+  margin-top: 8px;
+  background: var(--chrome-2);
+  color: var(--text-0);
+  border: 1px solid var(--line);
+  border-radius: 4px;
+  cursor: pointer;
+}

package/out/renderer/index.html

@@ -4,8 +4,8 @@
     <meta charset="UTF-8" />
     <meta http-equiv="Content-Security-Policy" content="default-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' blob: data:" />
     <title>Obsrv</title>
-    <script type="module" crossorigin src="./assets/index-DyCD4ih_.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-CHF-G97L.css">
+    <script type="module" crossorigin src="./assets/index-BP1S2N6S.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-BeroS4wv.css">
   </head>
   <body>
     <div id="root"></div>

package/out/shared/ipcPayloads.js

@@ -8,6 +8,9 @@ exports.parseSettings = parseSettings;
 exports.parseMode = parseMode;
 exports.parseUiState = parseUiState;
 exports.parseScrollPos = parseScrollPos;
+exports.parseScrollRequest = parseScrollRequest;
+exports.parseScrollReport = parseScrollReport;
+const types_1 = require("./types");
 /**
  * Parsers for everything the renderer sends main over IPC. Each returns a
  * fresh, fully-typed value or `null`; nothing from the wire is passed through
@@ -17,6 +20,8 @@ exports.parseScrollPos = parseScrollPos;
  */
 /** Largest coordinate or size a pane rect may carry; far beyond any real window. */
 exports.MAX_RECT = 16384;
+/** Most warnings a pane's scroll reply may carry; the preload sends at most one. */
+const MAX_SCROLL_WARNINGS = 4;
 const isFiniteNumber = (v) => typeof v === 'number' && Number.isFinite(v);
 const isRecord = (v) => typeof v === 'object' && v !== null;
 function parseRect(raw) {
@@ -94,9 +99,10 @@ function parseDeviceScaleFactor(raw) {
     return raw;
 }
 /**
- * Copies exactly the three known keys; the numbers must be finite and
- * positive. A missing `agentControl` means false (the pre-live-drive wire
- * shape); any non-boolean value is refused, never coerced.
+ * Copies exactly the five known keys; the numbers must be finite and
+ * positive. A missing `agentControl` means false and a missing `updateCheck`
+ * means true (the pre-feature wire shapes); any non-boolean value is refused,
+ * never coerced.
  */
 function parseSettings(raw) {
     if (!isRecord(raw))
@@ -109,7 +115,13 @@ function parseSettings(raw) {
     const agentControl = raw.agentControl ?? false;
     if (typeof agentControl !== 'boolean')
         return null;
-    return { hostDiagonalInches, hostNits, agentControl };
+    const updateCheck = raw.updateCheck ?? true;
+    if (typeof updateCheck !== 'boolean')
+        return null;
+    const lastUpdateCheck = raw.lastUpdateCheck ?? 0;
+    if (!isFiniteNumber(lastUpdateCheck) || lastUpdateCheck < 0)
+        return null;
+    return { hostDiagonalInches, hostNits, agentControl, updateCheck, lastUpdateCheck };
 }
 function parseMode(raw) {
     return raw === 'url' || raw === 'image' ? raw : null;
@@ -156,3 +168,48 @@ function parseScrollPos(raw) {
         return null;
     return { x, y };
 }
+/**
+ * A `scroll` command payload: an offset plus the optional `scrollSelector`
+ * escape hatch. The selector is only ever handed to `document.querySelector`
+ * in the preload's isolated world — never evaluated — but it is still bounded
+ * and type-checked here so a malformed one is refused with an explanation
+ * rather than silently ignored by the page. Returns the parsed request, or the
+ * error message.
+ */
+function parseScrollRequest(raw) {
+    const pos = parseScrollPos(raw);
+    if (!pos)
+        return 'scroll payload must be { x, y } with finite, non-negative CSS-pixel offsets';
+    const selector = raw.scrollSelector;
+    if (selector === undefined || selector === null)
+        return pos;
+    if (typeof selector !== 'string')
+        return 'scrollSelector must be a CSS selector string';
+    const trimmed = selector.trim();
+    if (trimmed === '')
+        return 'scrollSelector must not be empty';
+    if (trimmed.length > types_1.MAX_SCROLL_SELECTOR)
+        return `scrollSelector must be at most ${types_1.MAX_SCROLL_SELECTOR} characters`;
+    return { ...pos, selector: trimmed };
+}
+/**
+ * A pane's `IPC.scrollResult` reply. Sent by the sync preload, which runs
+ * beside a third-party page, so it is parsed exactly like any renderer
+ * message; anything malformed is dropped and the caller times out rather than
+ * reporting an offset it cannot trust.
+ */
+function parseScrollReport(raw) {
+    if (!isRecord(raw))
+        return null;
+    const { id, x, y, scroller } = raw;
+    if (!isFiniteNumber(id))
+        return null;
+    if (!isFiniteNumber(x) || !isFiniteNumber(y))
+        return null;
+    if (scroller !== 'root' && scroller !== 'element')
+        return null;
+    const warnings = Array.isArray(raw.warnings)
+        ? raw.warnings.filter((w) => typeof w === 'string').slice(0, MAX_SCROLL_WARNINGS)
+        : [];
+    return { id, x, y, scroller, warnings };
+}

package/out/shared/presets.js

@@ -4,7 +4,13 @@ exports.PANEL_PROFILES = exports.SCREEN_PRESETS = exports.DEFAULT_SETTINGS = exp
 exports.findPreset = findPreset;
 exports.findProfile = findProfile;
 exports.MAX_VIEWPORT = 4096;
-exports.DEFAULT_SETTINGS = { hostDiagonalInches: 27, hostNits: 500, agentControl: false };
+exports.DEFAULT_SETTINGS = {
+    hostDiagonalInches: 27,
+    hostNits: 500,
+    agentControl: false,
+    updateCheck: true,
+    lastUpdateCheck: 0,
+};
 exports.SCREEN_PRESETS = [
     // Laptops — ordered largest to smallest panel, then the denser 1080p outlier.
     { id: 'laptop-768', label: '1366×768 15.6"', width: 1366, height: 768, diagonalInches: 15.6, deviceScaleFactor: 1, group: 'laptop' },

package/out/shared/types.js

@@ -1,2 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_SCROLL_SELECTOR = void 0;
+/** Longest `scrollSelector` accepted; a CSS selector far beyond any real one. */
+exports.MAX_SCROLL_SELECTOR = 512;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "getobsrv",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "See your site the way 1x screens see it",
   "main": "./out/main/index.js",
   "bin": {

package/skills/obsrv-screens/SKILL.md

@@ -54,6 +54,13 @@ comes back inline. If the Obsrv desktop app is open with "Agent control" on
 click, pan and highlight to walk the user through what it found; no app
 means the usual headless render.
 
+To see anything below the fold, scroll and capture in the **same**
+`obsrv_drive` call — `{ scroll: { x: 0, y: 1500 }, capture: 'pane' }`. That
+tool never navigates unless you pass `url`, so the scroll is still in place
+when the PNG is taken. Reaching for `obsrv_snap` after a scroll works only
+when the app is already on that exact URL (it answers `navigated: false`);
+snapping a different URL is a fresh load and lands back at the top.
+
 ## The loop that catches real regressions
 
 1. Snap the dev URL across `--matrix laptop-768,android-65,1080p-24`, plus a
@@ -80,6 +87,9 @@ happened on the matrix snaps.
   not colorimetry of one specific panel.
 - `diff` is 1x-only in v1: dsf>1 presets and CSS viewports over 2048px exit
   with an error. Its findings are informational — apply your own thresholds.
+- `diff` on an animating page compares two different frames. Check `settled`
+  in its output: when false the band deltas are frame-to-frame noise and
+  `findings` says so rather than interpreting them. Snap that page instead.
 - `diff` cannot say "the hairline vanished": a 0.5px hairline renders one
   device row at 1x *and* 2x. It reports ink deltas and row ratios; vanishing
   is judged by reading the PNG.