gutterpress 0.10.0-beta.1 → 0.10.1-beta.1

package/README.md

@@ -133,10 +133,9 @@ The full configuration cascade is `CLI flags > manifest.yaml > preset defaults`.
 
 ## Commands
 
-Gutterpress has 11 subcommands. `new`, `preview`, `build`, and `publish` are the
+Gutterpress has 10 subcommands. `new`, `preview`, `build`, and `publish` are the
 primary author commands; `lint`, `validate`, `audit`, and `preflight` are
-CI / advanced checks; `repair` is the version-history escape hatch; and
-`doctor` reports system readiness. `plugin` manages project plugins. Every
+CI / advanced checks; and `doctor` reports system readiness. `plugin` manages project plugins. Every
 command also accepts `--help` for the authoritative, always-current flag list
 (`gutterpress <command> --help`) — this section is regenerated from the same
 source.
@@ -315,18 +314,6 @@ gutterpress preflight [dir] --pdf <path> [options]
 
 Exits 1 when the computed status is `NO-GO` (errors, or a required check skipped/failed).
 
-### `gutterpress repair`
-
-Diagnose and repair the project's version history — no git knowledge (and no system git) required. Detects the states that block syncing (an update that didn't finish, a leftover lock from a crash, a damaged or missing history) and applies the same safe repair the desktop app offers: a safety-copy zip is saved first, and nothing changes without your confirmation.
-
-```sh
-gutterpress repair [dir]
-
-  --check     Diagnose only — never change anything (exit 1 when repair is needed)
-  --yes       Approve the repair without prompting
-  --force     Repair even if the Gutterpress app appears to have this project open
-```
-
 ### `gutterpress doctor`
 
 Report the Gutterpress version, platform and config paths, and whether each external tool is available. Missing tools include the features that use them and platform-specific installation guidance.
@@ -369,7 +356,7 @@ Every command follows the same exit-code contract, so CI can branch on the resul
 | `2` | Usage — the invocation itself was wrong: a bad flag, positional argument, preset, or value. |
 | `3` | Pipeline — the build/render/export pipeline itself failed for a reason unrelated to usage or findings (I/O error, missing tool, renderer crash). |
 
-This applies uniformly across `build`, `preview`, `lint`, `validate`, `preflight`, `audit`, `repair`, `publish`, `plugin`, `new`, and `doctor`.
+This applies uniformly across `build`, `preview`, `lint`, `validate`, `preflight`, `audit`, `publish`, `plugin`, `new`, and `doctor`.
 
 ## Plugins
 

package/dist/api/index.d.ts

@@ -43,27 +43,24 @@ export { readManifestFields, setManifestFields, setActiveStyles, } from "../lib/
 export type { ProjectConfigFields } from "../lib/manifest-config.ts";
 export { providerFor, restoreVersionWithBackup, isNoChangesError, AUTO_SNAPSHOT_MESSAGE, RESTORE_BACKUP_MESSAGE, HISTORY_PAGE_LIMIT, } from "../lib/source-provider.ts";
 export type { ListHistoryOptions, HistoryPage, } from "../lib/source-provider.ts";
-export { appHeartbeatPath, heartbeatTtlMs, isAppHeartbeatFresh, readAppHeartbeat, removeAppHeartbeat, writeAppHeartbeat, APP_HEARTBEAT_FRESH_MS, } from "../lib/app-heartbeat.ts";
-export type { AppHeartbeat } from "../lib/app-heartbeat.ts";
-export { autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, } from "../lib/host-policy.ts";
+export { autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, } from "../lib/host-policy.ts";
 export type { AutoSnapshotPolicy, AutoSyncPolicy, } from "../lib/host-policy.ts";
-export { FileTokenStore, defaultConfigDir, redactCredential, extractUrlCredential, migrateUrlCredential, } from "../lib/remote-auth/token-store.ts";
+export { FileTokenStore, defaultConfigDir, extractUrlCredential, } from "../lib/remote-auth/token-store.ts";
 export type { HostCredential, TokenStore, UrlCredentialExtraction, } from "../lib/remote-auth/token-store.ts";
 export { GitHubAuthProvider, resolveGitHubClientId, GITHUB_HOST, } from "../lib/remote-auth/github-auth.ts";
-export type { RemoteAuthProvider, HostCallbacks, DeviceCodeInfo, GitHubAuthProviderOptions, } from "../lib/remote-auth/github-auth.ts";
+export type { HostCallbacks, DeviceCodeInfo, GitHubAuthProviderOptions, } from "../lib/remote-auth/github-auth.ts";
 export { listGitHubRepositories, listGitHubBranches, listRepoBooks, } from "../lib/remote-auth/github-repos.ts";
 export type { RemoteRepository, RemoteBranch, RepoBook, } from "../lib/remote-auth/github-repos.ts";
-export { cloneRepository, readProjectProvenance, provenancePath, sanitizeCloneFolderName, } from "../lib/remote-auth/clone.ts";
-export type { CloneRepositoryOptions, CloneRepositoryResult, CloneProgressEvent, ProjectProvenance, } from "../lib/remote-auth/clone.ts";
+export { cloneRepository, sanitizeCloneFolderName, } from "../lib/remote-auth/clone.ts";
+export type { CloneRepositoryOptions, CloneRepositoryResult, CloneProgressEvent, } from "../lib/remote-auth/clone.ts";
 export { testRemoteAccess, isSshRemoteUrl, } from "../lib/remote-auth/test-access.ts";
 export type { RemoteAccessResult, RemoteAccessFailureReason, TestRemoteAccessOptions, } from "../lib/remote-auth/test-access.ts";
-export { GenericTokenAuthProvider, connectGenericHost, knownForgeTokenUrl, normalizeForgeHost, } from "../lib/remote-auth/generic-auth.ts";
-export type { GenericTokenConnectInput, GenericHostCallbacks, GenericAuthOptions, } from "../lib/remote-auth/generic-auth.ts";
+export { connectGenericHost, knownForgeTokenUrl, } from "../lib/remote-auth/generic-auth.ts";
+export type { GenericTokenConnectInput, GenericAuthOptions, } from "../lib/remote-auth/generic-auth.ts";
 export { diagnoseProjectRemote, parseRemoteOrigin, forgeKindForHost, } from "../lib/remote-auth/diagnose.ts";
 export type { ProjectRemoteDiagnosis, DiagnoseProjectRemoteOptions, RemoteProtocol, RemoteGuidanceId, ForgeKind, } from "../lib/remote-auth/diagnose.ts";
-export { syncProject, pullChanges, pushChanges, SYNC_SNAPSHOT_MESSAGE, } from "../lib/remote-auth/sync.ts";
-export type { SyncOutcome, PullOutcome, PushOutcome, SyncProjectOptions, ImageClash, } from "../lib/remote-auth/sync.ts";
-export { keepImageVersion, readImageVersion } from "../lib/remote-auth/image-clash.ts";
+export { syncProject, SYNC_SNAPSHOT_MESSAGE, } from "../lib/remote-auth/sync.ts";
+export type { SyncOutcome, SyncProjectOptions, KeptBothFile, } from "../lib/remote-auth/sync.ts";
 export type { SnapshotEntry, InitVersionHistoryOptions, SnapshotOptions, RestoreSnapshotOptions, RestoreVersionOptions, RestoreVersionResult, SourceProvider, } from "../lib/source-provider.ts";
 export { runPublish, resolvePublishRequest, } from "../lib/publish/run-publish.ts";
 export type { RunPublishOptions, RunPublishResult, } from "../lib/publish/run-publish.ts";
@@ -76,11 +73,5 @@ export { PublishSelectionsStore } from "../lib/publish/selections.ts";
 export type { PublishAccountSelection } from "../lib/publish/selections.ts";
 export { readPublishSettings, setPublishProviderConfig, } from "../lib/publish/manifest-publish.ts";
 export type { PublishProvider, PublishProviderId, PublishProviderInfo, PublishProviderKind, PublishConfigField, PublishArtifact, PublishArtifactFormat, PublishAuthStatus, PublishDeps, PublishListingMetadata, PublishOutcome, PublishProduct, PublishProject, PublishRequest, PreflightIssue, CommandRunner, CommandResult, } from "../lib/publish/types.ts";
-export { repairRepo } from "../lib/remote-auth/recovery/repair.ts";
-export type { RepairOptions, RepairResult } from "../lib/remote-auth/recovery/repair.ts";
-export { classifyFromHealth, isLikelyRepoCorruption, RepoNeedsRecoveryError, isRepoNeedsRecoveryError, STALE_LOCK_MIN_AGE_MS, } from "../lib/remote-auth/recovery/classify.ts";
-export type { RepairNeed } from "../lib/remote-auth/recovery/classify.ts";
-export { inspectRepo, preflightStructuralReason, buildPreflightDiagnostics, verifyRepoReadable, isUnbornRepo, } from "../lib/remote-auth/recovery/inspect.ts";
-export type { RepoHealth } from "../lib/remote-auth/recovery/types.ts";
-export { resolveLogger, shortOid } from "../lib/remote-auth/operation-log.ts";
+export { resolveLogger } from "../lib/remote-auth/operation-log.ts";
 export type { OperationLogger, LogData } from "../lib/remote-auth/operation-log.ts";

package/dist/api/index.js

@@ -1,16 +1,15 @@
 import {
-  APP_HEARTBEAT_FRESH_MS,
   AUTO_SNAPSHOT_DEFAULT_MINUTES,
   AUTO_SNAPSHOT_MAX_MINUTES,
   AUTO_SNAPSHOT_MIN_MINUTES,
   AUTO_SYNC_DEFAULT_MINUTES,
   AUTO_SYNC_MAX_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
+  AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   BUILT_IN_TEMPLATE_IDS,
   BUILT_IN_THEME_IDS,
   FileTokenStore,
   GITHUB_HOST,
-  GenericTokenAuthProvider,
   GitHubAuthProvider,
   MANIFEST_FILENAMES,
   PLUGINS_DIR,
@@ -18,9 +17,7 @@ import {
   PRESET_IDS,
   PublishSelectionsStore,
   RECOMMENDED_PLUGINS,
-  RepoNeedsRecoveryError,
   SNIPPETS_DIR,
-  STALE_LOCK_MIN_AGE_MS,
   SYNC_SNAPSHOT_MESSAGE,
   TARGETS,
   TARGET_IDS,
@@ -28,12 +25,9 @@ import {
   addLocalPlugin,
   addNpmPlugin,
   adoptFolder,
-  appHeartbeatPath,
   applyTheme,
   autoSnapshotDelayMs,
   autoSyncDelayMs,
-  buildPreflightDiagnostics,
-  classifyFromHealth,
   cloneRepository,
   connectGenericHost,
   connectPublishProvider,
@@ -48,19 +42,12 @@ import {
   getPreviousTheme,
   getSystemDiagnostics,
   hasProjectManifest,
-  heartbeatTtlMs,
   importTemplateFromFolder,
   importThemeFromFile,
   importThemeFromFolder,
   importThemeFromUrl,
-  inspectRepo,
-  isAppHeartbeatFresh,
   isGitInternalPath,
-  isLikelyRepoCorruption,
-  isRepoNeedsRecoveryError,
   isSshRemoteUrl,
-  isUnbornRepo,
-  keepImageVersion,
   knownForgeTokenUrl,
   listBuiltInTemplates,
   listBuiltInThemes,
@@ -75,28 +62,16 @@ import {
   listRepoBooks,
   listSnippets,
   loadManifestWithPath,
-  migrateUrlCredential,
-  normalizeForgeHost,
   parseRemoteOrigin,
-  preflightStructuralReason,
-  provenancePath,
   publishConnectionStatus,
   publishCredentialKey,
   publishProviderFor,
   publishTargetFor,
-  pullChanges,
-  pushChanges,
-  readAppHeartbeat,
-  readImageVersion,
   readManifestFields,
-  readProjectProvenance,
   readPublishSettings,
   readSnippet,
   readThemeCss,
-  redactCredential,
-  removeAppHeartbeat,
   removeProjectTheme,
-  repairRepo,
   resolveActiveStyles,
   resolveBuiltInTheme,
   resolveConfig,
@@ -119,15 +94,13 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess,
-  validateProjectPlugins,
-  verifyRepoReadable,
-  writeAppHeartbeat
-} from "../index-052x5fef.js";
+  validateProjectPlugins
+} from "../index-6g72h2n1.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-c2b6gyeg.js";
+} from "../index-b2rqw41a.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -135,9 +108,8 @@ import {
   isNoChangesError,
   providerFor,
   resolveLogger,
-  restoreVersionWithBackup,
-  shortOid
-} from "../index-mdefp0y5.js";
+  restoreVersionWithBackup
+} from "../index-dtrftayr.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -147,8 +119,6 @@ import {
 } from "../index-v5mp7a6q.js";
 import"../index-37x76zdn.js";
 export {
-  writeAppHeartbeat,
-  verifyRepoReadable,
   validateProjectPlugins,
   testRemoteAccess,
   syncProject,
@@ -156,7 +126,6 @@ export {
   startPreviewServer,
   splitOutPath,
   slugifyProjectName,
-  shortOid,
   setPublishProviderConfig,
   setPluginEnabled,
   setManifestFields,
@@ -177,30 +146,18 @@ export {
   resolveActiveStyles,
   repoSubPath,
   repoRootForSource,
-  repairRepo,
   removeProjectTheme,
-  removeAppHeartbeat,
-  redactCredential,
   readyProbeExpr,
   readThemeCss,
   readSnippet,
   readPublishSettings,
-  readProjectProvenance,
   readManifestFields,
-  readImageVersion,
-  readAppHeartbeat,
-  pushChanges,
-  pullChanges,
   publishTargetFor,
   publishProviderFor,
   publishCredentialKey,
   publishConnectionStatus,
   providerFor,
-  provenancePath,
-  preflightStructuralReason,
   parseRemoteOrigin,
-  normalizeForgeHost,
-  migrateUrlCredential,
   loadManifestWithPath,
   listSnippets,
   listRepoBooks,
@@ -215,20 +172,13 @@ export {
   listBuiltInThemes,
   listBuiltInTemplates,
   knownForgeTokenUrl,
-  keepImageVersion,
-  isUnbornRepo,
   isSshRemoteUrl,
-  isRepoNeedsRecoveryError,
   isNoChangesError,
-  isLikelyRepoCorruption,
   isGitInternalPath,
-  isAppHeartbeatFresh,
-  inspectRepo,
   importThemeFromUrl,
   importThemeFromFolder,
   importThemeFromFile,
   importTemplateFromFolder,
-  heartbeatTtlMs,
   hasProjectManifest,
   getSystemDiagnostics,
   getPreviousTheme,
@@ -245,13 +195,10 @@ export {
   connectPublishProvider,
   connectGenericHost,
   cloneRepository,
-  classifyFromHealth,
   capabilitiesFor,
-  buildPreflightDiagnostics,
   autoSyncDelayMs,
   autoSnapshotDelayMs,
   applyTheme,
-  appHeartbeatPath,
   adoptFolder,
   addNpmPlugin,
   addLocalPlugin,
@@ -259,9 +206,7 @@ export {
   TARGET_IDS,
   TARGETS,
   SYNC_SNAPSHOT_MESSAGE,
-  STALE_LOCK_MIN_AGE_MS,
   SNIPPETS_DIR,
-  RepoNeedsRecoveryError,
   RESTORE_BACKUP_MESSAGE,
   RECOMMENDED_PLUGINS,
   PublishSelectionsStore,
@@ -271,19 +216,18 @@ export {
   MANIFEST_FILENAMES,
   HISTORY_PAGE_LIMIT,
   GitHubAuthProvider,
-  GenericTokenAuthProvider,
   GITHUB_HOST,
   FileTokenStore,
   DEFAULT_PRINT_OPTS,
   BuildError,
   BUILT_IN_THEME_IDS,
   BUILT_IN_TEMPLATE_IDS,
+  AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_MAX_MINUTES,
   AUTO_SYNC_DEFAULT_MINUTES,
   AUTO_SNAPSHOT_MIN_MINUTES,
   AUTO_SNAPSHOT_MESSAGE,
   AUTO_SNAPSHOT_MAX_MINUTES,
-  AUTO_SNAPSHOT_DEFAULT_MINUTES,
-  APP_HEARTBEAT_FRESH_MS
+  AUTO_SNAPSHOT_DEFAULT_MINUTES
 };

package/dist/{audit-85zn35v8.js → audit-7a37g51p.js}

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-5tffrg48.js";
+} from "./cli-df7gcyns.js";
 import {
   log
-} from "./cli-v935c2ws.js";
+} from "./cli-mcb484g3.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7e79d7se.js";
-import"./cli-afm8pa0h.js";
+} from "./cli-dx6sxj2t.js";
+import"./cli-ak1tagkr.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-k1065rkg.js";
+import"./cli-w692g6dx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{build-1faqmp0y.js → build-kdaet3pd.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-5tffrg48.js";
+} from "./cli-df7gcyns.js";
 import {
   log
-} from "./cli-v935c2ws.js";
+} from "./cli-mcb484g3.js";
 import {
   UsageError,
   parseEngine,
@@ -12,13 +12,13 @@ import {
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-7e79d7se.js";
-import"./cli-afm8pa0h.js";
+} from "./cli-dx6sxj2t.js";
+import"./cli-ak1tagkr.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-k1065rkg.js";
+import"./cli-w692g6dx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/checks/source/index.d.ts

@@ -5,3 +5,4 @@ import "./local-refs";
 import "./accessibility-alt-text";
 import "./accessibility-heading-order";
 import "./layout-markers";
+import "./merge-markers";

package/dist/checks/source/merge-markers.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/{cli-afm8pa0h.js → cli-ak1tagkr.js}

@@ -1422,7 +1422,7 @@ var favicon_default = "./favicon-wkbm9cjn.ico";
 var manifest_schema_default = "./manifest.schema-zxgxnbg7.json";
 
 // src/assets/preview/scripts/preview-interface.js
-var preview_interface_default = "./preview-interface-hg5eqv88.js";
+var preview_interface_default = "./preview-interface-0ssk8bmm.js";
 
 // src/assets/preview/scripts/preview-bridge.js
 var preview_bridge_default = "./preview-bridge-fz7vpk8m.js";
@@ -1434,7 +1434,7 @@ var preview_shell_default = "./preview-shell-c5mfa3q0.js";
 var CGATS21_CRPC1_default = "./CGATS21_CRPC1-g0e3k7kr.icc";
 
 // src/assets/engine/gutterpress-viewer.js
-var gutterpress_viewer_default = "./gutterpress-viewer-fb6fhwsy.js";
+var gutterpress_viewer_default = "./gutterpress-viewer-tma1qwz2.js";
 
 // src/assets/engine/gutterpress-agent.js
 var gutterpress_agent_default = "./gutterpress-agent-cazqstr1.js";
@@ -1768,6 +1768,62 @@ var DESC_JS = `(el) => {
     const src = el.tagName === "IMG" ? " src=" + (el.getAttribute("src") || "").slice(-40) : "";
     return el.tagName.toLowerCase() + cls + src;
   }`;
+var ABS_CONTAINING_BLOCK_JS = `(cs) => {
+    if (cs.position !== "static") return true;
+    for (const prop of [
+      "transform", "translate", "rotate", "scale", "perspective",
+      "filter", "backdropFilter",
+    ]) {
+      const value = cs[prop];
+      if (value && value !== "none") return true;
+    }
+    if (/\\b(layout|paint|strict|content)\\b/.test(cs.contain)) return true;
+    if (cs.containerType && cs.containerType !== "normal") return true;
+    return /\\b(transform|translate|rotate|scale|perspective|filter)\\b/.test(cs.willChange);
+  }`;
+var CLIP_EDGES_JS = `((establishesAbsContainingBlock) => {
+    const open = () => ({ left: -Infinity, right: Infinity, top: -Infinity, bottom: Infinity });
+    const rootStyle = getComputedStyle(document.documentElement);
+    const propagates = (a, rootOverflow) =>
+      a === document.documentElement ||
+      (a === document.body && rootOverflow === "visible");
+    return (el) => {
+      const edges = open();
+      const chain = [];
+      const elStyle = getComputedStyle(el);
+      const fixed = elStyle.position === "fixed";
+      let binds = !fixed && elStyle.position !== "absolute";
+      for (let a = el.parentElement; a; a = a.parentElement) {
+        const cs = getComputedStyle(a);
+        if (!fixed && !binds && establishesAbsContainingBlock(cs)) binds = true;
+        const own = open();
+        const clipsX =
+          binds && cs.overflowX !== "visible" && !propagates(a, rootStyle.overflowX);
+        const clipsY =
+          binds && cs.overflowY !== "visible" && !propagates(a, rootStyle.overflowY);
+        if (clipsX || clipsY) {
+          const r = a.getBoundingClientRect();
+          const clipMargin = parseFloat(cs.overflowClipMargin) || 0;
+          if (clipsX) {
+            const grow = cs.overflowX === "clip" ? clipMargin : 0;
+            own.left = r.left + parseFloat(cs.borderLeftWidth) - grow;
+            own.right = r.right - parseFloat(cs.borderRightWidth) + grow;
+            edges.left = Math.max(edges.left, own.left);
+            edges.right = Math.min(edges.right, own.right);
+          }
+          if (clipsY) {
+            const grow = cs.overflowY === "clip" ? clipMargin : 0;
+            own.top = r.top + parseFloat(cs.borderTopWidth) - grow;
+            own.bottom = r.bottom - parseFloat(cs.borderBottomWidth) + grow;
+            edges.top = Math.max(edges.top, own.top);
+            edges.bottom = Math.min(edges.bottom, own.bottom);
+          }
+        }
+        chain.push({ ancestor: a, style: cs, edges: own });
+      }
+      return { edges, chain };
+    };
+  })(${ABS_CONTAINING_BLOCK_JS})`;
 function pagePseudoContexts(model) {
   const used = new Set(pseudoVariants(model));
   const standard = new Set(["left", "right", "recto", "verso", "first", "blank"]);
@@ -2237,25 +2293,11 @@ ${mapCss}`;
             return reasons;
           };
 
-          // Does this box establish the containing block for an absolutely
-          // positioned descendant? Overflow clipping binds an abspos
-          // .gp-pin only from its containing block outward — MEASURED: a
-          // pin whose box lay entirely outside a STATIC overflow:hidden
-          // (and overflow:clip) wrapper printed complete and still behind
-          // the page text; the wrapper's clip never touched it.
-          const establishesAbsContainingBlock = (cs) => {
-            if (cs.position !== "static") return true;
-            for (const prop of [
-              "transform", "translate", "rotate", "scale", "perspective",
-              "filter", "backdropFilter",
-            ]) {
-              const value = cs[prop];
-              if (value && value !== "none") return true;
-            }
-            if (/\\b(layout|paint|strict|content)\\b/.test(cs.contain)) return true;
-            if (cs.containerType && cs.containerType !== "normal") return true;
-            return /\\b(transform|translate|rotate|scale|perspective|filter)\\b/.test(cs.willChange);
-          };
+          // Which ancestors clip a .gp-behind, and where their edges fall —
+          // the same measured rule the pre-print width check clamps against
+          // (see CLIP_EDGES_JS). This pass walks its \`chain\` so it can name
+          // the ancestor doing the cutting.
+          const clipEdges = ${CLIP_EDGES_JS};
 
           for (const el of document.querySelectorAll("*")) {
             const cs = getComputedStyle(el);
@@ -2298,47 +2340,25 @@ ${mapCss}`;
               const boundary = el.closest(".page, .spread");
               if (boundary) {
                 const elRect = el.getBoundingClientRect();
-                // Clip binding: an in-flow .gp-behind is bound by every
-                // ancestor's overflow, but an abspos one only from its
-                // containing block outward — static wrappers in between
-                // never clip it (measured; see the pass comment above).
-                let clipBinds = cs.position !== "absolute" && cs.position !== "fixed";
-                for (let ancestor = el.parentElement; ancestor; ancestor = ancestor.parentElement) {
-                  const ancestorStyle = getComputedStyle(ancestor);
-                  if (!clipBinds && establishesAbsContainingBlock(ancestorStyle)) clipBinds = true;
+                for (const link of clipEdges(el).chain) {
+                  const ancestor = link.ancestor;
+                  const ancestorStyle = link.style;
                   const reasons = stackingReasons(ancestor, ancestorStyle);
                   // Clipping never reorders layers — it can only CUT the
                   // art (measured, pass comment above): warn only where the
-                  // border box crosses a binding ancestor's clip edge on an
-                  // axis whose overflow is not \`visible\`. The clip edge is
-                  // the padding box, grown by overflow-clip-margin where
-                  // that axis's value is \`clip\` (px values only; keyword
-                  // forms parse NaN -> 0, i.e. the ungrown padding box).
-                  // 1px epsilon: the measured cut lands exactly at the
-                  // edge, and sub-pixel layout rounding is not an overhang.
+                  // border box crosses THIS ancestor's own clip edges, which
+                  // are ±Infinity on any axis it does not bind. 1px epsilon:
+                  // the measured cut lands exactly at the edge, and sub-pixel
+                  // layout rounding is not an overhang.
                   const cuts = [];
-                  if (clipBinds && (ancestorStyle.overflowX !== "visible" || ancestorStyle.overflowY !== "visible")) {
-                    const r = ancestor.getBoundingClientRect();
-                    const clipMargin = parseFloat(ancestorStyle.overflowClipMargin) || 0;
-                    if (ancestorStyle.overflowX !== "visible") {
-                      const grow = ancestorStyle.overflowX === "clip" ? clipMargin : 0;
-                      const left = r.left + parseFloat(ancestorStyle.borderLeftWidth) - grow;
-                      const right = r.right - parseFloat(ancestorStyle.borderRightWidth) + grow;
-                      if (elRect.left < left - 1)
-                        cuts.push(Math.round(left - elRect.left) + "px past its left clip edge");
-                      if (elRect.right > right + 1)
-                        cuts.push(Math.round(elRect.right - right) + "px past its right clip edge");
-                    }
-                    if (ancestorStyle.overflowY !== "visible") {
-                      const grow = ancestorStyle.overflowY === "clip" ? clipMargin : 0;
-                      const top = r.top + parseFloat(ancestorStyle.borderTopWidth) - grow;
-                      const bottom = r.bottom - parseFloat(ancestorStyle.borderBottomWidth) + grow;
-                      if (elRect.top < top - 1)
-                        cuts.push(Math.round(top - elRect.top) + "px past its top clip edge");
-                      if (elRect.bottom > bottom + 1)
-                        cuts.push(Math.round(elRect.bottom - bottom) + "px past its bottom clip edge");
-                    }
-                  }
+                  if (elRect.left < link.edges.left - 1)
+                    cuts.push(Math.round(link.edges.left - elRect.left) + "px past its left clip edge");
+                  if (elRect.right > link.edges.right + 1)
+                    cuts.push(Math.round(elRect.right - link.edges.right) + "px past its right clip edge");
+                  if (elRect.top < link.edges.top - 1)
+                    cuts.push(Math.round(link.edges.top - elRect.top) + "px past its top clip edge");
+                  if (elRect.bottom > link.edges.bottom + 1)
+                    cuts.push(Math.round(elRect.bottom - link.edges.bottom) + "px past its bottom clip edge");
                   if ((reasons.length || cuts.length) && !seenLayerTraps.has(ancestor)) {
                     seenLayerTraps.add(ancestor);
                     const effects = [];
@@ -2443,6 +2463,20 @@ async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreView
     const boxes = JSON.parse(await page.evaluate(`(() => {
         const LIMIT = ${limitPx} + 1;
         const desc = ${DESC_JS};
+        // Shrink-to-fit only reacts to overflow that ESCAPES: a clipping or
+        // scrolling ancestor contains its subtree's overflow, so the
+        // document's own width never grows and the book prints at 1.0x.
+        // MEASURED (Chrome 151, a marker word read off \`pdftotext -bbox\`
+        // against an unshrunk control): a 900px box inside a 300px
+        // \`overflow: hidden\` shell printed unshrunk, as did the same box
+        // under clip/auto/scroll — and a real 208-page book whose two
+        // "offenders" both sat under \`overflow-x: clip\` printed
+        // coordinate-identical with them restored. WHICH ancestors clip, and
+        // where their edges fall, is CLIP_EDGES_JS's measured rule — shared
+        // with the layer-containment audit, which measures overhang past the
+        // same edges. Only the x edges matter here: shrink-to-fit is a width
+        // response.
+        const clipEdges = ${CLIP_EDGES_JS};
         const out = [];
         for (const el of document.querySelectorAll("*")) {
           const r = el.getBoundingClientRect();
@@ -2452,6 +2486,9 @@ async function findWidthOffenders(page, model, bleedSlugExtensionPt, restoreView
           // width) — both trigger the same whole-document shrink-to-fit,
           // measured: a left bleed alone cost 16%.
           if (right <= LIMIT && r.width <= LIMIT && r.left >= -1) continue;
+          // ...but only where it actually escapes its clipping ancestors.
+          const clip = clipEdges(el).edges;
+          if (Math.min(right, clip.right) <= LIMIT && Math.max(r.left, clip.left) >= -1) continue;
           let deepest = true;
           for (const c of el.children) {
             if (c.getBoundingClientRect().width >= r.width - 1) { deepest = false; break; }