feat: add Photography Guide functionality with scheduling and landscape composite

- Updated TimerScreen to include a new Photography Guide button and corresponding handler.
- Implemented photography guide logic in a new utils file, allowing for shot scheduling and moon geometry calculations.
- Created unit tests for the photography guide schedule and landscape composite layout to ensure correct functionality.
- Enhanced documentation to reflect the current status and implementation details of the Photography Guide feature.

Author: Lalit Sharma

CHANGELOG.md

@@ -5,6 +5,22 @@ 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.33] — 2026-02-26
+
+### Added
+- Added a new timer-linked `Photography Guide` flow with a split `Preview` / `Photo Guide` action row on the Timer screen.
+- Added schedule generation helpers for photo timing distribution across eclipse phases (`3/5/7/9` shots), including phase buckets and preview-progress anchors.
+- Added in-guide shot schedule table rows with UTC/local timestamps, phase labels, and generated eclipse preview thumbnails per shot.
+- Added landscape composite simulation modal with 24mm framing, fixed `MAX` anchor placement, clamped edge indicators, and moon rendering only during occlusion windows.
+- Added regression tests for photography guide schedule logic and composite anchor/clamping behavior.
+
+### Changed
+- Updated navigation wiring to include a dedicated `PhotographyGuide` route with timer circumstance payload (including contact bearings for preview direction).
+- Bumped `apps/mobile` version to `1.1.33`.
+
+### Tests
+- Verified mobile checks pass: `pnpm -C apps/mobile typecheck`, `pnpm -C apps/mobile lint`, and `pnpm -C apps/mobile test`.
+
 ## [1.1.32] — 2026-02-26
 
 ### Added

apps/mobile/package.json

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

apps/mobile/src/navigation/RootNavigator.tsx

@@ -48,6 +48,9 @@ import HelpScreen from "../screens/HelpScreen";
 import LandingScreen from "../screens/LandingScreen";
 import LocationSettingsScreen from "../screens/LocationSettingsScreen";
 import NotificationSettingsScreen from "../screens/NotificationSettingsScreen";
+import PhotographyGuideScreen, {
+  type PhotographyGuidePayload,
+} from "../screens/PhotographyGuideScreen";
 import SettingsScreen from "../screens/SettingsScreen";
 import ThemeSettingsScreen from "../screens/ThemeSettingsScreen";
 import TimerScreen from "../screens/TimerScreen";
@@ -67,6 +70,7 @@ type RootStackParamList = {
   Landing: undefined;
   Timer: undefined;
   Preview: { payload: PreviewPayload };
+  PhotographyGuide: { payload: PhotographyGuidePayload };
   Settings: undefined;
   Help: undefined;
   ThemeSettings: undefined;
@@ -80,6 +84,7 @@ const linking: LinkingOptions<RootStackParamList> = {
     screens: {
       Landing: "landing",
       Timer: "timer",
+      PhotographyGuide: "photography-guide",
       Settings: "settings",
       Help: "settings/help",
       ThemeSettings: "settings/theme",
@@ -105,6 +110,10 @@ type PreviewRouteProps = NativeStackScreenProps<RootStackParamList, "Preview"> &
   onOpenMenu: () => void;
 };
 
+type PhotographyGuideRouteProps = NativeStackScreenProps<RootStackParamList, "PhotographyGuide"> & {
+  onOpenMenu: () => void;
+};
+
 type SettingsRouteProps = NativeStackScreenProps<RootStackParamList, "Settings"> & {
   onOpenMenu: () => void;
 };
@@ -170,7 +179,8 @@ function StartupLoadingScreen({
 }
 
 function toMenuRouteName(route: keyof RootStackParamList): MenuRouteName | null {
-  if (route === "Landing" || route === "Timer") return route;
+  if (route === "Landing") return "Landing";
+  if (route === "Timer" || route === "PhotographyGuide") return "Timer";
   if (
     route === "Settings" ||
     route === "Help" ||
@@ -410,6 +420,30 @@ function TimerRoute({ navigation, catalog, onOpenMenu }: TimerRouteProps) {
     },
     [activeEclipse?.dateYmd, activeEclipse?.id, navigation],
   );
+  const openPhotographyGuide = useCallback(
+    (result: Circumstances, observer: Observer) => {
+      const payload: PhotographyGuidePayload = {
+        eclipseId: activeEclipse?.id ?? result.eclipseId,
+        eclipseDateYmd: activeEclipse?.dateYmd ?? "",
+        visible: result.visible,
+        kindAtLocation: result.kindAtLocation,
+        magnitude: result.magnitude,
+        c1Utc: result.c1Utc,
+        c2Utc: result.c2Utc,
+        maxUtc: result.maxUtc,
+        c3Utc: result.c3Utc,
+        c4Utc: result.c4Utc,
+        c1BearingDeg: result.c1BearingDeg,
+        c2BearingDeg: result.c2BearingDeg,
+        c3BearingDeg: result.c3BearingDeg,
+        c4BearingDeg: result.c4BearingDeg,
+        observer,
+      };
+
+      navigation.navigate("PhotographyGuide", { payload });
+    },
+    [activeEclipse?.dateYmd, activeEclipse?.id, navigation],
+  );
 
   const useFavoriteLocation = useCallback(
     (location: FavoriteLocation) => {
@@ -456,6 +490,7 @@ function TimerRoute({ navigation, catalog, onOpenMenu }: TimerRouteProps) {
       onSelectEclipse={selectEclipse}
       onOpenMenu={onOpenMenu}
       onOpenPreview={openPreview}
+      onOpenPhotographyGuide={openPhotographyGuide}
     />
   );
 }
@@ -470,6 +505,16 @@ function PreviewRoute({ navigation, route, onOpenMenu }: PreviewRouteProps) {
   );
 }
 
+function PhotographyGuideRoute({ navigation, route, onOpenMenu }: PhotographyGuideRouteProps) {
+  return (
+    <PhotographyGuideScreen
+      payload={route.params.payload}
+      onBack={() => navigation.goBack()}
+      onOpenMenu={onOpenMenu}
+    />
+  );
+}
+
 function SettingsRoute({ navigation, onOpenMenu }: SettingsRouteProps) {
   return (
     <SettingsScreen
@@ -803,6 +848,9 @@ export default function RootNavigator() {
           <Stack.Screen name="Preview">
             {(props) => <PreviewRoute {...props} onOpenMenu={openMenu} />}
           </Stack.Screen>
+          <Stack.Screen name="PhotographyGuide">
+            {(props) => <PhotographyGuideRoute {...props} onOpenMenu={openMenu} />}
+          </Stack.Screen>
           <Stack.Screen name="Settings">
             {(props) => <SettingsRoute {...props} onOpenMenu={openMenu} />}
           </Stack.Screen>