feat: implement shared map-link intake to timer and update changelog to version 1.1.40

Author: Lalit Sharma

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.40] — 2026-02-27
+
+### Fixed
+- Tightened `Photography Guide` landscape composite corona rendering so the ring appears only when `MAX` is during true totality (`C2 < MAX < C3`) and never for non-total scenarios.
+
+### Changed
+- Bumped `apps/mobile` version to `1.1.40`.
+
 ## [1.1.39] — 2026-02-27
 
 ### Fixed

apps/mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eclipse-timer/mobile",
-  "version": "1.1.39",
+  "version": "1.1.40",
   "private": true,
   "main": "index.js",
   "scripts": {

apps/mobile/src/screens/PhotographyGuideScreen.tsx

@@ -17,6 +17,7 @@ import { fmtLocalHuman, fmtUtcHuman } from "../utils/date";
 import {
   buildLandscapeCompositeLayout,
   buildPhotographyGuideSchedule,
+  isMaxDuringTotality,
   type PhotographyGuidePictureCount,
   type PhotographyGuideRow,
 } from "../utils/photographyGuide";
@@ -124,6 +125,16 @@ export default function PhotographyGuideScreen({
     ? TOTALITY_SKY_COLOR
     : DEFAULT_COMPOSITE_SKY_COLOR;
   const isWithinEclipseArea = payload.visible && payload.kindAtLocation !== "none";
+  const isMaxDuringTotalityWindow = useMemo(
+    () =>
+      isMaxDuringTotality({
+        kindAtLocation: payload.kindAtLocation,
+        c2Utc: payload.c2Utc,
+        maxUtc: payload.maxUtc,
+        c3Utc: payload.c3Utc,
+      }),
+    [payload.c2Utc, payload.c3Utc, payload.kindAtLocation, payload.maxUtc],
+  );
   const scheduleResult = useMemo(
     () =>
       buildPhotographyGuideSchedule({
@@ -485,7 +496,7 @@ export default function PhotographyGuideScreen({
                   />
                   {compositeLayout.placements.map((placement) => {
                     const showTotalityCorona =
-                      payload.kindAtLocation === "total" &&
+                      isMaxDuringTotalityWindow &&
                       placement.phaseBucket === "MAX" &&
                       placement.showMoon &&
                       Boolean(placement.moon);

apps/mobile/src/utils/photographyGuide.ts

@@ -107,6 +107,24 @@ function parseUtcMs(iso?: string): number | undefined {
   return parsed;
 }
 
+export function isMaxDuringTotality(params: {
+  kindAtLocation: EclipseKindAtLocation;
+  c2Utc?: string;
+  maxUtc?: string;
+  c3Utc?: string;
+}) {
+  if (params.kindAtLocation !== "total") return false;
+
+  const c2Ms = parseUtcMs(params.c2Utc);
+  const maxMs = parseUtcMs(params.maxUtc);
+  const c3Ms = parseUtcMs(params.c3Utc);
+  if (typeof c2Ms !== "number" || typeof maxMs !== "number" || typeof c3Ms !== "number") {
+    return false;
+  }
+
+  return c2Ms < maxMs && maxMs < c3Ms;
+}
+
 function clamp01(value: number) {
   return Math.max(0, Math.min(1, value));
 }

apps/mobile/tests/photography-guide.test.ts

@@ -3,6 +3,7 @@ import { describe, expect, it } from "vitest";
 import {
   buildLandscapeCompositeLayout,
   buildPhotographyGuideSchedule,
+  isMaxDuringTotality,
 } from "../src/utils/photographyGuide";
 
 function isoUtc(hour: number, minute: number) {
@@ -86,6 +87,46 @@ describe("photography guide schedule", () => {
     expect(result.schedule.rows[2]?.phaseBucket).toBe("MAX");
   });
 
+  it("detects when MAX occurs during totality", () => {
+    expect(
+      isMaxDuringTotality({
+        kindAtLocation: "total",
+        c2Utc: isoUtc(10, 30),
+        maxUtc: isoUtc(11, 0),
+        c3Utc: isoUtc(11, 30),
+      }),
+    ).toBe(true);
+  });
+
+  it("does not mark MAX as totality outside total eclipses or without valid C2/C3 bounds", () => {
+    expect(
+      isMaxDuringTotality({
+        kindAtLocation: "partial",
+        c2Utc: isoUtc(10, 30),
+        maxUtc: isoUtc(11, 0),
+        c3Utc: isoUtc(11, 30),
+      }),
+    ).toBe(false);
+
+    expect(
+      isMaxDuringTotality({
+        kindAtLocation: "annular",
+        c2Utc: isoUtc(10, 30),
+        maxUtc: isoUtc(11, 0),
+        c3Utc: isoUtc(11, 30),
+      }),
+    ).toBe(false);
+
+    expect(
+      isMaxDuringTotality({
+        kindAtLocation: "total",
+        c2Utc: isoUtc(11, 30),
+        maxUtc: isoUtc(11, 0),
+        c3Utc: isoUtc(10, 30),
+      }),
+    ).toBe(false);
+  });
+
   it("builds a stable 3-shot schedule around MAX", () => {
     const result = buildPhotographyGuideSchedule({
       visible: true,