getobsrv 0.12.0 → 0.14.0

package/out/cli/args.js

@@ -30,6 +30,18 @@ Shared flags:
 ${presets}
   --width <px> --height <px> [--dsf <factor>] [--diagonal <inches>]
                        Custom CSS viewport instead of --preset (dsf defaults to 1).
+  --orientation <o>    portrait | landscape (default ${presets_1.DEFAULT_ORIENTATION}). This names the
+                       preset's *stored* orientation, not the shape you get:
+                         portrait  = the preset exactly as the table above lists it
+                         landscape = that rotated a quarter turn (width and height swap)
+                       Every mobile preset is stored portrait, so for those the two
+                       readings agree. The laptop and desktop presets are stored
+                       landscape-natural, so --orientation landscape turns them into a
+                       portrait screen — which is how you render a 1080p monitor stood on
+                       end (1080p-24 becomes 1080x1920). Applies to custom --width/--height
+                       dims too. The diagonal, raster density and physical size never
+                       change: it is the same panel turned sideways. Each render's JSON
+                       and log line name the resulting shape.
   --profile <id>       Panel profile: ${profiles} (default reference).
   --wait <ms>          Extra settle time after load (default 0).
   --timeout <ms>       Per-render budget for load + paint quiescence (default ${exports.DEFAULT_TIMEOUT_MS}).
@@ -55,7 +67,7 @@ warning naming what was missing. Only a render that painted nothing errors.`;
 /** Flags that take no value. */
 const BOOLEAN_FLAGS = new Set(['full-page', 'json']);
 /** Flags that consume the next token. */
-const VALUE_FLAGS = new Set(['preset', 'profile', 'out', 'out-dir', 'wait', 'timeout', 'matrix', 'width', 'height', 'dsf', 'diagonal']);
+const VALUE_FLAGS = new Set(['preset', 'profile', 'orientation', 'out', 'out-dir', 'wait', 'timeout', 'matrix', 'width', 'height', 'dsf', 'diagonal']);
 const SNAP_ONLY = new Set(['out', 'full-page', 'matrix']);
 const DIFF_ONLY = new Set(['out-dir', 'json']);
 function collect(command, argv) {
@@ -131,9 +143,30 @@ function presetSpec(id) {
         cssHeight: preset.height,
         deviceScaleFactor: preset.deviceScaleFactor,
         diagonalInches: preset.diagonalInches,
+        orientation: presets_1.DEFAULT_ORIENTATION,
     };
 }
+function resolveOrientation(flags) {
+    const raw = flags.get('orientation');
+    if (raw === undefined)
+        return presets_1.DEFAULT_ORIENTATION;
+    if (!(0, presets_1.isOrientation)(raw))
+        throw new ArgError(`--orientation: expected portrait or landscape, got "${String(raw)}"`);
+    return raw;
+}
+/**
+ * Rotation swaps the CSS axes and nothing else — the diagonal and the raster
+ * density are orientation-independent, so the render is the same screen turned
+ * sideways rather than a different one. Applied here, before the diff bounds
+ * are checked, so those check the viewport that will actually be rendered.
+ */
+function orientSpec(spec, orientation) {
+    if (orientation !== 'landscape')
+        return { ...spec, orientation };
+    return { ...spec, orientation, cssWidth: spec.cssHeight, cssHeight: spec.cssWidth };
+}
 function resolveSpecs(flags) {
+    const orientation = resolveOrientation(flags);
     const custom = ['width', 'height', 'dsf', 'diagonal'].some(f => flags.has(f));
     if (custom && flags.has('preset'))
         throw new ArgError('--preset and --width/--height are mutually exclusive');
@@ -153,17 +186,25 @@ function resolveSpecs(flags) {
             throw new ArgError(`viewport exceeds the 4096-device-pixel budget: at dsf ${deviceScaleFactor} the CSS limit is ${max}`);
         }
         const diagonal = flags.has('diagonal') ? float(flags, 'diagonal', 0, 0.1) : null;
-        return { specs: [{ presetId: 'custom', cssWidth, cssHeight, deviceScaleFactor, diagonalInches: diagonal }], matrix: false };
+        const spec = {
+            presetId: 'custom',
+            cssWidth,
+            cssHeight,
+            deviceScaleFactor,
+            diagonalInches: diagonal,
+            orientation: presets_1.DEFAULT_ORIENTATION,
+        };
+        return { specs: [orientSpec(spec, orientation)], matrix: false };
     }
     const matrixRaw = flags.get('matrix');
     if (typeof matrixRaw === 'string') {
         const ids = matrixRaw.split(',').map(s => s.trim()).filter(s => s.length > 0);
         if (ids.length === 0)
             throw new ArgError('--matrix: expected a comma-separated list of preset ids');
-        return { specs: ids.map(presetSpec), matrix: true };
+        return { specs: ids.map(id => orientSpec(presetSpec(id), orientation)), matrix: true };
     }
     const id = typeof flags.get('preset') === 'string' ? flags.get('preset') : exports.DEFAULT_PRESET;
-    return { specs: [presetSpec(id)], matrix: false };
+    return { specs: [orientSpec(presetSpec(id), orientation)], matrix: false };
 }
 function resolveProfile(flags) {
     const raw = flags.get('profile');
@@ -201,8 +242,14 @@ function parseArgs(argv) {
     }
     const referenceMax = (0, calibration_1.maxCssViewport)(2);
     if (spec.cssWidth > referenceMax || spec.cssHeight > referenceMax) {
+        // Named as rendered, not as stored: the dims here are post-rotation, and
+        // attributing them to the bare preset id would print "1440p-27 is
+        // 1440×2560" — a shape that id never has. The bound itself is per-axis
+        // symmetric, so rotation can never sneak a too-large viewport past it;
+        // this is the message telling the truth about which one it measured.
+        const as = spec.orientation === 'landscape' ? ' rotated a quarter turn' : '';
         throw new ArgError(`diff renders a 2x reference, so the CSS viewport must fit ${referenceMax}px per axis ` +
-            `(4096 device px at 2x) — "${spec.presetId}" is ${spec.cssWidth}×${spec.cssHeight}. ` +
+            `(4096 device px at 2x) — "${spec.presetId}"${as} is ${spec.cssWidth}×${spec.cssHeight}. ` +
             `Use \`obsrv snap\` for this preset instead.`);
     }
     const outDir = typeof flags.get('out-dir') === 'string' ? flags.get('out-dir') : null;

package/out/main/cli.js

@@ -3,7 +3,7 @@ const electron = require("electron");
 const node_fs = require("node:fs");
 const node_os = require("node:os");
 const node_path = require("node:path");
-const targetSource = require("./targetSource-DlsHc-Ri.js");
+const targetSource = require("./targetSource-W6YddYef.js");
 function boxDownsample(src, factor) {
   if (!Number.isInteger(factor) || factor < 1) throw new RangeError("factor must be an integer >= 1");
   const width = Math.floor(src.width / factor);
@@ -61,6 +61,18 @@ Shared flags:
 ${presets}
   --width <px> --height <px> [--dsf <factor>] [--diagonal <inches>]
                        Custom CSS viewport instead of --preset (dsf defaults to 1).
+  --orientation <o>    portrait | landscape (default ${targetSource.DEFAULT_ORIENTATION}). This names the
+                       preset's *stored* orientation, not the shape you get:
+                         portrait  = the preset exactly as the table above lists it
+                         landscape = that rotated a quarter turn (width and height swap)
+                       Every mobile preset is stored portrait, so for those the two
+                       readings agree. The laptop and desktop presets are stored
+                       landscape-natural, so --orientation landscape turns them into a
+                       portrait screen — which is how you render a 1080p monitor stood on
+                       end (1080p-24 becomes 1080x1920). Applies to custom --width/--height
+                       dims too. The diagonal, raster density and physical size never
+                       change: it is the same panel turned sideways. Each render's JSON
+                       and log line name the resulting shape.
   --profile <id>       Panel profile: ${profiles} (default reference).
   --wait <ms>          Extra settle time after load (default 0).
   --timeout <ms>       Per-render budget for load + paint quiescence (default ${DEFAULT_TIMEOUT_MS}).
@@ -84,7 +96,7 @@ painted. False is a rescued capture, not a failure: a page that kept animating
 warning naming what was missing. Only a render that painted nothing errors.`;
 }
 const BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["full-page", "json"]);
-const VALUE_FLAGS = /* @__PURE__ */ new Set(["preset", "profile", "out", "out-dir", "wait", "timeout", "matrix", "width", "height", "dsf", "diagonal"]);
+const VALUE_FLAGS = /* @__PURE__ */ new Set(["preset", "profile", "orientation", "out", "out-dir", "wait", "timeout", "matrix", "width", "height", "dsf", "diagonal"]);
 const SNAP_ONLY = /* @__PURE__ */ new Set(["out", "full-page", "matrix"]);
 const DIFF_ONLY = /* @__PURE__ */ new Set(["out-dir", "json"]);
 function collect(command, argv) {
@@ -148,10 +160,22 @@ function presetSpec(id) {
     cssWidth: preset.width,
     cssHeight: preset.height,
     deviceScaleFactor: preset.deviceScaleFactor,
-    diagonalInches: preset.diagonalInches
+    diagonalInches: preset.diagonalInches,
+    orientation: targetSource.DEFAULT_ORIENTATION
   };
 }
+function resolveOrientation(flags) {
+  const raw = flags.get("orientation");
+  if (raw === void 0) return targetSource.DEFAULT_ORIENTATION;
+  if (!targetSource.isOrientation(raw)) throw new ArgError(`--orientation: expected portrait or landscape, got "${String(raw)}"`);
+  return raw;
+}
+function orientSpec(spec, orientation) {
+  if (orientation !== "landscape") return { ...spec, orientation };
+  return { ...spec, orientation, cssWidth: spec.cssHeight, cssHeight: spec.cssWidth };
+}
 function resolveSpecs(flags) {
+  const orientation = resolveOrientation(flags);
   const custom = ["width", "height", "dsf", "diagonal"].some((f) => flags.has(f));
   if (custom && flags.has("preset")) throw new ArgError("--preset and --width/--height are mutually exclusive");
   if (custom && flags.has("matrix")) throw new ArgError("--matrix lists presets; it cannot be combined with custom --width/--height dims");
@@ -168,16 +192,24 @@ function resolveSpecs(flags) {
       throw new ArgError(`viewport exceeds the 4096-device-pixel budget: at dsf ${deviceScaleFactor} the CSS limit is ${max}`);
     }
     const diagonal = flags.has("diagonal") ? float(flags, "diagonal", 0, 0.1) : null;
-    return { specs: [{ presetId: "custom", cssWidth, cssHeight, deviceScaleFactor, diagonalInches: diagonal }], matrix: false };
+    const spec = {
+      presetId: "custom",
+      cssWidth,
+      cssHeight,
+      deviceScaleFactor,
+      diagonalInches: diagonal,
+      orientation: targetSource.DEFAULT_ORIENTATION
+    };
+    return { specs: [orientSpec(spec, orientation)], matrix: false };
   }
   const matrixRaw = flags.get("matrix");
   if (typeof matrixRaw === "string") {
     const ids = matrixRaw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
     if (ids.length === 0) throw new ArgError("--matrix: expected a comma-separated list of preset ids");
-    return { specs: ids.map(presetSpec), matrix: true };
+    return { specs: ids.map((id2) => orientSpec(presetSpec(id2), orientation)), matrix: true };
   }
   const id = typeof flags.get("preset") === "string" ? flags.get("preset") : DEFAULT_PRESET;
-  return { specs: [presetSpec(id)], matrix: false };
+  return { specs: [orientSpec(presetSpec(id), orientation)], matrix: false };
 }
 function resolveProfile(flags) {
   const raw = flags.get("profile");
@@ -215,8 +247,9 @@ ${usage()}`);
   }
   const referenceMax = targetSource.maxCssViewport(2);
   if (spec.cssWidth > referenceMax || spec.cssHeight > referenceMax) {
+    const as = spec.orientation === "landscape" ? " rotated a quarter turn" : "";
     throw new ArgError(
-      `diff renders a 2x reference, so the CSS viewport must fit ${referenceMax}px per axis (4096 device px at 2x) — "${spec.presetId}" is ${spec.cssWidth}×${spec.cssHeight}. Use \`obsrv snap\` for this preset instead.`
+      `diff renders a 2x reference, so the CSS viewport must fit ${referenceMax}px per axis (4096 device px at 2x) — "${spec.presetId}"${as} is ${spec.cssWidth}×${spec.cssHeight}. Use \`obsrv snap\` for this preset instead.`
     );
   }
   const outDir = typeof flags.get("out-dir") === "string" ? flags.get("out-dir") : null;
@@ -559,8 +592,9 @@ async function runSnap(cmd) {
     const img = applyPanelProfile(bgraToRgba(r.frame.bgra, r.frame.width, r.frame.height), profile);
     node_fs.mkdirSync(node_path.dirname(out), { recursive: true });
     node_fs.writeFileSync(out, encodePng(img));
+    const shape = targetSource.screenShape(r.cssWidth, r.cssHeight);
     human(
-      `snap ${cmd.url} → ${out} (${r.frame.width}×${r.frame.height} device px, preset ${spec.presetId}, profile ${profile.id})`
+      `snap ${cmd.url} → ${out} (${r.frame.width}×${r.frame.height} device px, ${r.cssWidth}×${r.cssHeight} CSS ${shape}, preset ${spec.presetId}, profile ${profile.id})`
     );
     results.push({
       out,
@@ -607,7 +641,7 @@ async function runDiff(cmd) {
   }
   const pct2 = (v) => `${(v * 100).toFixed(2)}%`;
   human(
-    `diff ${cmd.url} @ ${cmd.spec.presetId} (profile ${profile.id}): ink ${pct2(metrics.inkCoverage.target)} vs ${pct2(metrics.inkCoverage.reference)} reference, rows ${metrics.rows.target}/${metrics.rows.reference} (ratio ${metrics.rows.ratio?.toFixed(2) ?? "n/a"}), ${metrics.findings.length} finding(s)${settled ? "" : " — UNSETTLED, deltas are not rendering evidence"}`
+    `diff ${cmd.url} @ ${cmd.spec.presetId} (${cmd.spec.cssWidth}×${cmd.spec.cssHeight} CSS ${targetSource.screenShape(cmd.spec.cssWidth, cmd.spec.cssHeight)}, profile ${profile.id}): ink ${pct2(metrics.inkCoverage.target)} vs ${pct2(metrics.inkCoverage.reference)} reference, rows ${metrics.rows.target}/${metrics.rows.reference} (ratio ${metrics.rows.ratio?.toFixed(2) ?? "n/a"}), ${metrics.findings.length} finding(s)${settled ? "" : " — UNSETTLED, deltas are not rendering evidence"}`
   );
   await machine({
     url: cmd.url,

package/out/main/index.js

@@ -4,7 +4,7 @@ const node_fs = require("node:fs");
 const promises = require("node:fs/promises");
 const node_path = require("node:path");
 const node_crypto = require("node:crypto");
-const targetSource = require("./targetSource-DlsHc-Ri.js");
+const targetSource = require("./targetSource-W6YddYef.js");
 const node_http = require("node:http");
 const node_url = require("node:url");
 const MAX_SCROLL_SELECTOR = 512;
@@ -106,12 +106,15 @@ function parseUiState(raw) {
   if (mode !== "url" && mode !== "image") return null;
   const panes = raw.panes ?? "both";
   if (panes !== "both" && panes !== "target") return null;
+  const orientation = raw.orientation ?? targetSource.DEFAULT_ORIENTATION;
+  if (!targetSource.isOrientation(orientation)) return null;
   return {
     tabId,
     presetId,
     profileId,
     viewMode,
     panes,
+    orientation,
     mode,
     targetBounds: parseRect(raw.targetBounds),
     canvasBounds: parseRect(raw.canvasBounds)
@@ -152,6 +155,7 @@ const CONTROL_COMMANDS = [
   "setProfile",
   "setViewMode",
   "setPanes",
+  "setOrientation",
   "captureVisible",
   // v0.5 drive controls (spec §14 "Drive controls").
   "scroll",
@@ -196,6 +200,9 @@ function profileApplyError(id) {
 function viewModeApplyError(v) {
   return v === "1:1" || v === "fit" ? null : `setViewMode payload must be { mode: '1:1' | 'fit' }`;
 }
+function orientationApplyError(v) {
+  return targetSource.isOrientation(v) ? null : `setOrientation payload must be { orientation: 'portrait' | 'landscape' }`;
+}
 function panesApplyError(v) {
   return v === "both" || v === "target" ? null : `setPanes payload must be { panes: 'both' | 'target' }`;
 }
@@ -400,7 +407,8 @@ function loadTabs(file, max = Infinity) {
       tabs.push({
         url: entry.url,
         presetId: targetSource.SCREEN_PRESETS.some((p) => p.id === entry.presetId) ? entry.presetId : DEFAULT_PRESET,
-        profileId: targetSource.PANEL_PROFILES.some((p) => p.id === entry.profileId) ? entry.profileId : DEFAULT_PROFILE
+        profileId: targetSource.PANEL_PROFILES.some((p) => p.id === entry.profileId) ? entry.profileId : DEFAULT_PROFILE,
+        orientation: targetSource.isOrientation(entry.orientation) ? entry.orientation : targetSource.DEFAULT_ORIENTATION
       });
     }
     const kept = tabs.slice(0, Math.max(0, max));
@@ -587,6 +595,12 @@ class ControlServer {
         const panes = payload.panes;
         return this.applyAndConfirm({ panes }, (s) => s.panes === panes);
       }
+      case "setOrientation": {
+        const err = orientationApplyError(payload.orientation);
+        if (err) return reply(400, { error: err });
+        const orientation = payload.orientation;
+        return this.applyAndConfirm({ orientation }, (s) => s.orientation === orientation);
+      }
       case "captureVisible": {
         const capture = await this.deps.captureVisible();
         return reply(200, { ok: true, ...capture });
@@ -810,7 +824,7 @@ function registerIpc(ctx) {
     }
   });
   let panesShowNative = true;
-  tabs.nativeVisible = (s) => s.modeIsLive && panesShowNative;
+  tabs.nativeVisible = (s) => s.modeIsLive && panesShowNative && !targetSource.isBlankUrl(s.url);
   tabs.busEnabled = (s) => s.modeIsLive;
   const applyNativeVisibility = () => {
     const s = tab();
@@ -934,6 +948,12 @@ function registerIpc(ctx) {
     set viewMode(v) {
       tab().viewMode = v;
     },
+    get orientation() {
+      return tab().orientation;
+    },
+    set orientation(v) {
+      tab().orientation = v;
+    },
     get mode() {
       return tab().reportedMode;
     },
@@ -1115,7 +1135,12 @@ function registerIpc(ctx) {
   const persistTabs = () => {
     if (!persistReady) return;
     const stored = {
-      tabs: tabs.tabs.map((t) => ({ url: t.url, presetId: t.presetId, profileId: t.profileId })),
+      tabs: tabs.tabs.map((t) => ({
+        url: t.url,
+        presetId: t.presetId,
+        profileId: t.profileId,
+        orientation: t.orientation
+      })),
       activeIndex: tabs.activeIndex
     };
     const json = JSON.stringify(stored);
@@ -1127,7 +1152,10 @@ function registerIpc(ctx) {
       console.warn("obsrv: could not save tabs", e);
     }
   };
-  tabs.onTabUrlChanged = persistTabs;
+  tabs.onTabUrlChanged = () => {
+    persistTabs();
+    applyNativeVisibility();
+  };
   const restoreTabs = async () => {
     const stored = loadTabs(tabsFile, settings.maxTabs);
     if (stored.tabs.length === 0) return;
@@ -1137,6 +1165,7 @@ function registerIpc(ctx) {
       if (!s) break;
       s.presetId = entry.presetId;
       s.profileId = entry.profileId;
+      s.orientation = entry.orientation;
       sessions.push(s);
     }
     tabs.activate(sessions[Math.min(stored.activeIndex, sessions.length - 1)].id);
@@ -1176,14 +1205,30 @@ function registerIpc(ctx) {
         url = tab().target.webContents.getURL();
       } catch {
       }
-      return { version: appVersion, url, tabId: tabs.activeId, tabIndex: tabs.activeIndex, ...uiState };
+      let css = { width: 0, height: 0 };
+      try {
+        css = tab().target.getViewport();
+      } catch {
+      }
+      return {
+        version: appVersion,
+        url,
+        tabId: tabs.activeId,
+        tabIndex: tabs.activeIndex,
+        cssWidth: css.width,
+        cssHeight: css.height,
+        screenShape: targetSource.screenShape(css.width, css.height),
+        ...uiState
+      };
     },
     navigate: navigateBoth,
     apply: (patch) => {
       if (win.isDestroyed()) return;
-      if (patch.presetId !== void 0) {
-        tab().viewportPending = true;
-        tab().viewportArrived = false;
+      const s = tab();
+      const resizes = patch.presetId !== void 0 && patch.presetId !== s.presetId || patch.orientation !== void 0 && patch.orientation !== s.orientation;
+      if (resizes) {
+        s.viewportPending = true;
+        s.viewportArrived = false;
       }
       if (!rendererReported) {
         if (pendingApplies.length >= MAX_PENDING_APPLIES) {
@@ -1605,6 +1650,13 @@ class TabSession {
   viewportArrived = false;
   presetId = "1080p-24";
   profileId = "reference";
+  /**
+   * Which way round this tab's screen is held. Per tab like the preset it
+   * rotates, and mirrored here from the renderer's `uiState` for the same
+   * reason: a restored tab has to come back the way it was left, and no
+   * renderer existed to report that when the list came off disk.
+   */
+  orientation = targetSource.DEFAULT_ORIENTATION;
   viewMode = "fit";
   /**
    * Resolves once both panes have settled on their initial `about:blank`.
@@ -1824,7 +1876,8 @@ class TabManager {
         url: t.url,
         title: t.title,
         presetId: t.presetId,
-        profileId: t.profileId
+        profileId: t.profileId,
+        orientation: t.orientation
       })),
       activeId: this.id
     };
@@ -1842,7 +1895,12 @@ class TabManager {
    * writes the tab that is named, not the tab that is showing.
    */
   create() {
+    let booted = false;
     const s = new TabSession(this.win, (url) => {
+      if (!booted) {
+        booted = true;
+        if (url === "about:blank") return;
+      }
       s.url = url;
       s.title = "";
       this.toRenderer(IPC.urlChanged, { tabId: s.id, url });

package/out/main/{targetSource-DlsHc-Ri.js → targetSource-W6YddYef.js}

@@ -17,6 +17,10 @@ const DEFAULT_SETTINGS = {
   split: 0.5,
   maxTabs: 12
 };
+const DEFAULT_ORIENTATION = "portrait";
+function isOrientation(v) {
+  return v === "portrait" || v === "landscape";
+}
 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" },
@@ -55,6 +59,9 @@ function findProfile(id) {
   if (!p) throw new Error(`unknown profile: ${id}`);
   return p;
 }
+function screenShape(width, height) {
+  return width > height ? "landscape" : "portrait";
+}
 function maxCssViewport(deviceScaleFactor) {
   const dsf = Number.isFinite(deviceScaleFactor) && deviceScaleFactor > 1 ? deviceScaleFactor : 1;
   return Math.max(1, Math.floor(MAX_VIEWPORT / dsf));
@@ -102,6 +109,9 @@ function urlSchemeError(url) {
   if (/^[a-z0-9.-]+:\d+(\/|$)/i.test(trimmed)) return null;
   return `unsupported URL scheme "${scheme}" — obsrv renders ${ALLOWED_URL_SCHEMES.map((s) => `${s}//`).join(", ")} URLs only (bare hosts like example.com also work; they normalise to http(s)).`;
 }
+function isBlankUrl(url) {
+  return url === "";
+}
 const ERR_ABORTED = -3;
 const DEFAULT_FPS = 30;
 const DEFAULT_VIEWPORT = { width: 1920, height: 1080 };
@@ -410,6 +420,7 @@ class TargetSource extends node_events.EventEmitter {
   }
 }
 exports.ALLOWED_URL_SCHEMES = ALLOWED_URL_SCHEMES;
+exports.DEFAULT_ORIENTATION = DEFAULT_ORIENTATION;
 exports.DEFAULT_SETTINGS = DEFAULT_SETTINGS;
 exports.IMAGE_EXTENSIONS = IMAGE_EXTENSIONS;
 exports.MAX_TABS_MAX = MAX_TABS_MAX;
@@ -422,6 +433,9 @@ exports.TargetSource = TargetSource;
 exports.classifyFileNavigation = classifyFileNavigation;
 exports.findPreset = findPreset;
 exports.findProfile = findProfile;
+exports.isBlankUrl = isBlankUrl;
+exports.isOrientation = isOrientation;
 exports.maxCssViewport = maxCssViewport;
 exports.normalizeUrl = normalizeUrl;
+exports.screenShape = screenShape;
 exports.urlSchemeError = urlSchemeError;

package/out/mcp/lib.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PANE_CAPTURE_HEADLESS_NOTE = exports.APP_NOT_REACHABLE = exports.urlSchemeError = exports.ALLOWED_URL_SCHEMES = exports.STDERR_TAIL_CHARS = exports.MAX_INLINE_IMAGE_BYTES = exports.UsageError = void 0;
+exports.ORIENTATION_NOTE = exports.PANE_CAPTURE_HEADLESS_NOTE = exports.APP_NOT_REACHABLE = exports.urlSchemeError = exports.ALLOWED_URL_SCHEMES = exports.STDERR_TAIL_CHARS = exports.MAX_INLINE_IMAGE_BYTES = exports.UsageError = void 0;
 exports.buildSnapArgs = buildSnapArgs;
 exports.buildDiffArgs = buildDiffArgs;
 exports.shouldInlineImage = shouldInlineImage;
@@ -46,6 +46,8 @@ function buildSnapArgs(input, outPath) {
     const args = ['snap', input.url];
     if (input.preset !== undefined)
         args.push('--preset', input.preset);
+    if (input.orientation !== undefined)
+        args.push('--orientation', input.orientation);
     if (custom) {
         args.push('--width', String(input.width), '--height', String(input.height));
         if (input.deviceScaleFactor !== undefined)
@@ -170,9 +172,20 @@ function extractTrailingJson(stdout) {
     }
     return null;
 }
+/**
+ * What `obsrv_presets` says about rotation. Stated once here rather than
+ * repeated per entry: it is true of every preset in the table, and a field
+ * saying "rotatable: true" fourteen times would carry less than one sentence.
+ */
+exports.ORIENTATION_NOTE = 'cssWidth/cssHeight are each preset\'s natural orientation — portrait for every mobile preset, ' +
+    'landscape for the monitor and laptop ones. Every preset rotates: pass orientation: "landscape" ' +
+    'to obsrv_snap or obsrv_drive to swap the two axes a quarter turn. Rotation changes nothing else — ' +
+    'the diagonal, deviceScaleFactor, ppi and physical size are all orientation-independent, so a ' +
+    'rotated screen is the same panel turned sideways rather than a different one.';
 /** The `obsrv_presets` payload, straight from src/shared/presets.ts — no spawn. */
 function listCatalog() {
     return {
+        orientation: exports.ORIENTATION_NOTE,
         presets: presets_1.SCREEN_PRESETS.map(p => ({
             id: p.id,
             label: p.label,