Skip to content

Commit 9f29293

Browse files
committed
docs(apple): keep why the surface and off-route fallback plans settle as they do
The merged settlement path dropped the comments of runSurfaceFallback and captureOffRoute. The FallbackPlan members now carry them: the surface plan decides only the reason, and an off-route capture that serves a surface still gets a surface identity (#2438).
1 parent 55bf069 commit 9f29293

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

‎packages/platform-apple/src/snapshot-route.ts‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -564,8 +564,22 @@ async function fallbackAfterFailure(
564564
}
565565

566566
type FallbackPlan =
567+
/** An observe-only capture on a source that cannot serve one: the runner result is returned as is. */
567568
| Readonly<{ kind: 'direct' }>
569+
/**
570+
* A capture the route cannot plan (a pinned backend or a custom-actions read). The runner serves a
571+
* presented system surface on this path too, so a surface capture still gets a surface identity:
572+
* without it, legacy presentation matching reads the sheet and the app as one presentation and can
573+
* corroborate a tap across the two (#2438). An app capture off the route carries no identity.
574+
*/
568575
| Readonly<{ kind: 'off-route' }>
576+
/**
577+
* A capture taken while the probe saw a surface host. The probe answers about a host process and
578+
* stays positive while a dismissed host lingers, but the runner answers about the screen, so this
579+
* plan decides only the reason, from what the runner served. The identity comes from the shared
580+
* stamp: an app capture in the lingering window must not compare equal to the sheet capture before
581+
* the dismissal (#2438). `detectedHost` is evidence for the daemon log, not identity.
582+
*/
569583
| Readonly<{ kind: 'surface'; detectedHost: string }>
570584
| Readonly<{
571585
kind: 'reason';

0 commit comments

Comments
 (0)