Function appearsBy

packages/cli/src/utils/motionAudit.ts:80–98

(frames: MotionFrame[], selector: string, bySec: number)

}

function appearsBy(frames: MotionFrame[], selector: string, bySec: number): LayoutIssue[] {
  if (!everMatched(frames, selector)) return [missingIssue(selector, 0)];
  const appear = firstAppear(frames, selector);
  if (appear && appear.time <= bySec) return [];
  return [
    {
      code: "motion_appears_late",
      severity: "error",
      time: appear ? appear.time : bySec,
      selector,
      message: appear
        ? `appears at ${round(appear.time)}s but should be visible by ${round(bySec)}s (check its entrance reveal fires under seek)`
        : `never reaches visible opacity but should be visible by ${round(bySec)}s (check its entrance reveal fires under seek)`,
      rect: appear ? appear.rect : ZERO_RECT,
      fixHint:
        "The renderer seeks a paused timeline; a forward-only reveal can be skipped. Ensure the entrance is applied at this time, not only played through.",
    },
  ];
}

function before(frames: MotionFrame[], a: string, b: string): LayoutIssue[] {
  const issues: LayoutIssue[] = [];