+# Project Structure and Naming

+

+This document defines how we name SwiftUI views and how we place files in the project so the codebase matches the product language and the UI hierarchy.

+

+## Core Rules

+

+- Name folders after the feature or navigation surface the user sees.

+  - Example: the Home tab lives in `Views/Meter/Tabs/Home/`, not in `Connection/`.

+- Name the main view in a folder after the feature it owns.

+  - Example: `MeterHomeTabView.swift` is the root view for the meter Home tab.

+- Keep the file name and the Swift type name identical.

+  - Example: `MeterOverviewSectionView.swift` contains `MeterOverviewSectionView`.

+- Prefer product language over implementation history.

+  - If the app says "Home", use `Home` in code instead of older terms like `Connection`.

+- Use `Components/` only for reusable building blocks.

+  - A component is used in multiple views or is clearly meant to be reused.

+  - Example: `MeterInfoCardView` and `MeterInfoRowView`.

+- Use `Subviews/` for views that belong to a single parent feature.

+  - A subview is used once or is tightly coupled to one screen/tab.

+  - Example: `Views/Meter/Tabs/Home/Subviews/MeterOverviewSectionView.swift`.

+- Use `Sheets/` for modal flows presented from another screen.

+  - Example: `Views/Meter/Sheets/AppHistory/AppHistorySheetView.swift`.

+- Keep reusable components close to the narrowest shared owner.

+  - If a component is reused only inside Meter screens, keep it in `Views/Meter/Components/`.

+  - Do not move it to app-wide `Views/Components/` unless it is truly generic.

+- Keep small support types next to their owner.

+  - If a helper type exists for one view only, keep it in the same file or the same feature subfolder.

+- Avoid vague verbs or placeholder names.

+  - Prefer `MeterNameEditorView` over `EditNameView`.

+  - Prefer `MeterConnectionActionView` over `ConnectionPrimaryActionView`.

+- A folder should describe ownership, not implementation detail.

+  - `Home/Subviews/` is better than `Connection/Components/` when the views are single-use parts of the Home tab.

+

+## Naming Checklist

+

+Before adding or renaming a file, check:

+

+- Can someone guess the file location from the screen name?

+- Does the type name say what the view renders?

+- Is this reused enough to deserve `Components/`?

+- If it is single-use, does it live under the parent feature's `Subviews/` folder?

+- Does the code use the same words as the UI?

+

+## Current Meter Tab Pattern

+

+Use this structure for Meter tab work:

+

+```text

+Views/Meter/

+  Components/

+    MeasurementChartView.swift

+    MeterInfoCardView.swift

+    MeterInfoRowView.swift

+  Sheets/

+    AppHistory/

+      AppHistorySheetView.swift

+      Subviews/

+        AppHistorySampleView.swift

+    ChargeRecord/

+      ChargeRecordSheetView.swift

+      Subviews/

+        ChargeRecordMetricsTableView.swift

+    DataGroups/

+      DataGroupsSheetView.swift

+      Subviews/

+        DataGroupRowView.swift

+  Tabs/

+    Home/

+      MeterHomeTabView.swift

+      Subviews/

+        MeterConnectionActionView.swift

+        MeterConnectionStatusBadgeView.swift

+        MeterOverviewSectionView.swift

+    Live/

+      MeterLiveTabView.swift

+      Subviews/

+        LoadResistanceIconView.swift

+        MeterLiveContentView.swift

+        MeterLiveMetricRange.swift

+    Chart/

+      MeterChartTabView.swift

+    Settings/

+      MeterSettingsTabView.swift

+      Subviews/

+        MeterCurrentScreenSummaryView.swift

+        MeterNameEditorView.swift

+        MeterScreenControlButtonView.swift

+        MeterScreenControlsView.swift

+        ScreenBrightnessEditorView.swift

+        ScreenTimeoutEditorView.swift

+```

+

+## Refactor Examples

+

+- `Connection/` -> `Home/`

+- `MeterConnectionTabView` -> `MeterHomeTabView`

+- `ConnectionHomeInfoPreviewView` -> `MeterOverviewSectionView`

+- `ConnectionPrimaryActionView` -> `MeterConnectionActionView`

+- `EditNameView` -> `MeterNameEditorView`

+- `MeasurementsView` -> `AppHistorySheetView`

+- `RecordingView` -> `ChargeRecordSheetView`

+- `ControlView` -> `MeterScreenControlsView`

+

+## Decision Rule

+

+If a new name makes a teammate look in the right folder on the first try, it is probably a good name.

+- `Project Structure and Naming.md`

+  Naming and file-organization rules for views, features, components, and subviews.

+	objectVersion = 70;

+		3407A133FADB8858DC2A1FED /* MeterNameStore.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7396C8BB36F4E7F8E0CD8FF8 /* MeterNameStore.swift */; };

+		4308CF882417770D0002E80B /* DataGroupsSheetView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 4308CF872417770D0002E80B /* DataGroupsSheetView.swift */; };

+		43554B2F24443939004E66F5 /* MeasurementSeriesSheetView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 43554B2E24443939004E66F5 /* MeasurementSeriesSheetView.swift */; };

+		43554B32244449B5004E66F5 /* MeasurementSeriesSampleView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 43554B31244449B5004E66F5 /* MeasurementSeriesSampleView.swift */; };

+		437D47D12415F91B00B7768E /* MeterLiveContentView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 437D47D02415F91B00B7768E /* MeterLiveContentView.swift */; };

+		437D47D52415FD8C00B7768E /* ChargeRecordSheetView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 437D47D42415FD8C00B7768E /* ChargeRecordSheetView.swift */; };

+		437D47D72415FDF300B7768E /* MeterScreenControlsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 437D47D62415FDF300B7768E /* MeterScreenControlsView.swift */; };

+		AAD5F9A72B1CAC0700F8E4F9 /* MeterDetailView.swift in Sources */ = {isa = PBXBuildFile; fileRef = AAD5F9A32B1CAC0700F8E4F9 /* MeterDetailView.swift */; };

+		AAD5F9B12B1CAC7A00F8E4F9 /* SidebarView.swift in Sources */ = {isa = PBXBuildFile; fileRef = AAD5F9B22B1CAC7A00F8E4F9 /* SidebarView.swift */; };

+		D28F11013C8E4A7A00A10011 /* MeterHomeTabView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11023C8E4A7A00A10012 /* MeterHomeTabView.swift */; };

+		D28F11033C8E4A7A00A10013 /* MeterLiveTabView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11043C8E4A7A00A10014 /* MeterLiveTabView.swift */; };

+		D28F11053C8E4A7A00A10015 /* MeterChartTabView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11063C8E4A7A00A10016 /* MeterChartTabView.swift */; };

+		D28F11073C8E4A7A00A10017 /* MeterSettingsTabView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11083C8E4A7A00A10018 /* MeterSettingsTabView.swift */; };

+		D28F11113C8E4A7A00A10021 /* MeterInfoCardView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11123C8E4A7A00A10022 /* MeterInfoCardView.swift */; };

+		D28F11133C8E4A7A00A10023 /* MeterInfoRowView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11143C8E4A7A00A10024 /* MeterInfoRowView.swift */; };

+		D28F11153C8E4A7A00A10025 /* MeterNameEditorView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11163C8E4A7A00A10026 /* MeterNameEditorView.swift */; };

+		D28F11173C8E4A7A00A10027 /* ScreenTimeoutEditorView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11183C8E4A7A00A10028 /* ScreenTimeoutEditorView.swift */; };

+		D28F11193C8E4A7A00A10029 /* ScreenBrightnessEditorView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F111A3C8E4A7A00A1002A /* ScreenBrightnessEditorView.swift */; };

+		D28F11213C8E4A7A00A10031 /* MeterLiveMetricRange.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11223C8E4A7A00A10032 /* MeterLiveMetricRange.swift */; };

+		D28F11233C8E4A7A00A10033 /* LoadResistanceIconView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11243C8E4A7A00A10034 /* LoadResistanceIconView.swift */; };

+		D28F11313C8E4A7A00A10041 /* MeterScreenControlButtonView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11323C8E4A7A00A10042 /* MeterScreenControlButtonView.swift */; };

+		D28F11333C8E4A7A00A10043 /* MeterCurrentScreenSummaryView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11343C8E4A7A00A10044 /* MeterCurrentScreenSummaryView.swift */; };

+		D28F11353C8E4A7A00A10045 /* ChargeRecordMetricsTableView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F11363C8E4A7A00A10046 /* ChargeRecordMetricsTableView.swift */; };

+		D28F11393C8E4A7A00A10049 /* MeterConnectionStatusBadgeView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F113A3C8E4A7A00A1004A /* MeterConnectionStatusBadgeView.swift */; };

+		D28F113B3C8E4A7A00A1004B /* MeterConnectionActionView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F113C3C8E4A7A00A1004C /* MeterConnectionActionView.swift */; };

+		D28F113D3C8E4A7A00A1004D /* MeterOverviewSectionView.swift in Sources */ = {isa = PBXBuildFile; fileRef = D28F113E3C8E4A7A00A1004E /* MeterOverviewSectionView.swift */; };

+		E430FB6B7CB3E0D4189F6D7D /* MeterMappingDebugView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 56BA4CE53B6B2C4EBA42C81A /* MeterMappingDebugView.swift */; };

+		4308CF872417770D0002E80B /* DataGroupsSheetView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = DataGroupsSheetView.swift; sourceTree = "<group>"; };

+		43554B2E24443939004E66F5 /* MeasurementSeriesSheetView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeasurementSeriesSheetView.swift; sourceTree = "<group>"; };

+		43554B31244449B5004E66F5 /* MeasurementSeriesSampleView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeasurementSeriesSampleView.swift; sourceTree = "<group>"; };

+		437D47D02415F91B00B7768E /* MeterLiveContentView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterLiveContentView.swift; sourceTree = "<group>"; };

+		437D47D42415FD8C00B7768E /* ChargeRecordSheetView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChargeRecordSheetView.swift; sourceTree = "<group>"; };

+		437D47D62415FDF300B7768E /* MeterScreenControlsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterScreenControlsView.swift; sourceTree = "<group>"; };

+		56BA4CE53B6B2C4EBA42C81A /* MeterMappingDebugView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterMappingDebugView.swift; sourceTree = "<group>"; };

+		7396C8BB36F4E7F8E0CD8FF8 /* MeterNameStore.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterNameStore.swift; sourceTree = "<group>"; };

+		AAD5F9A32B1CAC0700F8E4F9 /* MeterDetailView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterDetailView.swift; sourceTree = "<group>"; };

+		AAD5F9B22B1CAC7A00F8E4F9 /* SidebarView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SidebarView.swift; sourceTree = "<group>"; };

+		D28F11023C8E4A7A00A10012 /* MeterHomeTabView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterHomeTabView.swift; sourceTree = "<group>"; };

+		D28F11043C8E4A7A00A10014 /* MeterLiveTabView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterLiveTabView.swift; sourceTree = "<group>"; };

+		D28F11063C8E4A7A00A10016 /* MeterChartTabView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterChartTabView.swift; sourceTree = "<group>"; };

+		D28F11083C8E4A7A00A10018 /* MeterSettingsTabView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterSettingsTabView.swift; sourceTree = "<group>"; };

+		D28F11123C8E4A7A00A10022 /* MeterInfoCardView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterInfoCardView.swift; sourceTree = "<group>"; };

+		D28F11143C8E4A7A00A10024 /* MeterInfoRowView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterInfoRowView.swift; sourceTree = "<group>"; };

+		D28F11163C8E4A7A00A10026 /* MeterNameEditorView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterNameEditorView.swift; sourceTree = "<group>"; };

+		D28F11183C8E4A7A00A10028 /* ScreenTimeoutEditorView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ScreenTimeoutEditorView.swift; sourceTree = "<group>"; };

+		D28F111A3C8E4A7A00A1002A /* ScreenBrightnessEditorView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ScreenBrightnessEditorView.swift; sourceTree = "<group>"; };

+		D28F11223C8E4A7A00A10032 /* MeterLiveMetricRange.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterLiveMetricRange.swift; sourceTree = "<group>"; };

+		D28F11243C8E4A7A00A10034 /* LoadResistanceIconView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = LoadResistanceIconView.swift; sourceTree = "<group>"; };

+		D28F11323C8E4A7A00A10042 /* MeterScreenControlButtonView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterScreenControlButtonView.swift; sourceTree = "<group>"; };

+		D28F11343C8E4A7A00A10044 /* MeterCurrentScreenSummaryView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterCurrentScreenSummaryView.swift; sourceTree = "<group>"; };

+		D28F11363C8E4A7A00A10046 /* ChargeRecordMetricsTableView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ChargeRecordMetricsTableView.swift; sourceTree = "<group>"; };

+		D28F113A3C8E4A7A00A1004A /* MeterConnectionStatusBadgeView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterConnectionStatusBadgeView.swift; sourceTree = "<group>"; };

+		D28F113C3C8E4A7A00A1004C /* MeterConnectionActionView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterConnectionActionView.swift; sourceTree = "<group>"; };

+		D28F113E3C8E4A7A00A1004E /* MeterOverviewSectionView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MeterOverviewSectionView.swift; sourceTree = "<group>"; };

+/* Begin PBXFileSystemSynchronizedRootGroup section */

+		43BE08E12F78F49500250EEC /* SidebarList */ = {isa = PBXFileSystemSynchronizedRootGroup; explicitFileTypes = {}; explicitFolders = (); path = SidebarList; sourceTree = "<group>"; };

+/* End PBXFileSystemSynchronizedRootGroup section */

+

+		4308CF89241777130002E80B /* DataGroups */ = {

+				4308CF872417770D0002E80B /* DataGroupsSheetView.swift */,

+				D28F11263C8E4A7A00A10036 /* Subviews */,

+			path = DataGroups;

+		432F6ED8246684060043912E /* Subviews */ = {

+				43554B31244449B5004E66F5 /* MeasurementSeriesSampleView.swift */,

+			path = Subviews;

+		43554B3024444983004E66F5 /* MeasurementSeries */ = {

+				43554B2E24443939004E66F5 /* MeasurementSeriesSheetView.swift */,

+				432F6ED8246684060043912E /* Subviews */,

+			path = MeasurementSeries;

+				D28F113F3C8E4A7A00A1004F /* Components */,

+				D28F11093C8E4A7A00A10019 /* Tabs */,

+				D28F10013C8E4A7A00A10001 /* Sheets */,

+				7396C8BB36F4E7F8E0CD8FF8 /* MeterNameStore.swift */,

+				AAD5F9BB2B1CC10000F8E4F9 /* Sidebar */,

+				56BA4CE53B6B2C4EBA42C81A /* MeterMappingDebugView.swift */,

+				D28F10023C8E4A7A00A10002 /* Components */,

+				AAD5F9A32B1CAC0700F8E4F9 /* MeterDetailView.swift */,

+		AAD5F9BB2B1CC10000F8E4F9 /* Sidebar */ = {

+			isa = PBXGroup;

+			children = (

+				AAD5F9B22B1CAC7A00F8E4F9 /* SidebarView.swift */,

+				43BE08E12F78F49500250EEC /* SidebarList */,

+			);

+			path = Sidebar;

+			sourceTree = "<group>";

+		};

+		D28F10013C8E4A7A00A10001 /* Sheets */ = {

+			isa = PBXGroup;

+			children = (

+				4308CF89241777130002E80B /* DataGroups */,

+				43554B3024444983004E66F5 /* MeasurementSeries */,

+				D28F11273C8E4A7A00A10037 /* ChargeRecord */,

+			);

+			path = Sheets;

+			sourceTree = "<group>";

+		};

+		D28F10023C8E4A7A00A10002 /* Components */ = {

+			isa = PBXGroup;

+			children = (

+				D28F10033C8E4A7A00A10003 /* Generic */,

+			);

+			path = Components;

+			sourceTree = "<group>";

+		};

+		D28F10033C8E4A7A00A10003 /* Generic */ = {

+			isa = PBXGroup;

+			children = (

+				4360A34C241CBB3800B464F9 /* RSSIView.swift */,

+				430CB4FB245E07EB006525C2 /* ChevronView.swift */,

+			);

+			path = Generic;

+			sourceTree = "<group>";

+		};

+		D28F11093C8E4A7A00A10019 /* Tabs */ = {

+			isa = PBXGroup;

+			children = (

+				D28F110A3C8E4A7A00A1001A /* Home */,

+				D28F110B3C8E4A7A00A1001B /* Live */,

+				D28F110C3C8E4A7A00A1001C /* Chart */,

+				D28F110D3C8E4A7A00A1001D /* Settings */,

+			);

+			path = Tabs;

+			sourceTree = "<group>";

+		};

+		D28F110A3C8E4A7A00A1001A /* Home */ = {

+			isa = PBXGroup;

+			children = (

+				D28F11023C8E4A7A00A10012 /* MeterHomeTabView.swift */,

+				D28F111B3C8E4A7A00A1002B /* Subviews */,

+			);

+			path = Home;

+			sourceTree = "<group>";

+		};

+		D28F110B3C8E4A7A00A1001B /* Live */ = {

+			isa = PBXGroup;

+			children = (

+				D28F11043C8E4A7A00A10014 /* MeterLiveTabView.swift */,

+				D28F11253C8E4A7A00A10035 /* Subviews */,

+			);

+			path = Live;

+			sourceTree = "<group>";

+		};

+		D28F110C3C8E4A7A00A1001C /* Chart */ = {

+			isa = PBXGroup;

+			children = (

+				D28F11063C8E4A7A00A10016 /* MeterChartTabView.swift */,

+			);

+			path = Chart;

+			sourceTree = "<group>";

+		};

+		D28F110D3C8E4A7A00A1001D /* Settings */ = {

+			isa = PBXGroup;

+			children = (

+				D28F11083C8E4A7A00A10018 /* MeterSettingsTabView.swift */,

+				D28F111C3C8E4A7A00A1002C /* Subviews */,

+			);

+			path = Settings;

+			sourceTree = "<group>";

+		};

+		D28F111B3C8E4A7A00A1002B /* Subviews */ = {

+			isa = PBXGroup;

+			children = (

+				D28F113A3C8E4A7A00A1004A /* MeterConnectionStatusBadgeView.swift */,

+				D28F113C3C8E4A7A00A1004C /* MeterConnectionActionView.swift */,

+				D28F113E3C8E4A7A00A1004E /* MeterOverviewSectionView.swift */,

+			);

+			path = Subviews;

+			sourceTree = "<group>";

+		};

+		D28F111C3C8E4A7A00A1002C /* Subviews */ = {

+			isa = PBXGroup;

+			children = (

+				D28F11163C8E4A7A00A10026 /* MeterNameEditorView.swift */,

+				D28F11183C8E4A7A00A10028 /* ScreenTimeoutEditorView.swift */,

+				D28F111A3C8E4A7A00A1002A /* ScreenBrightnessEditorView.swift */,

+				437D47D62415FDF300B7768E /* MeterScreenControlsView.swift */,

+				D28F11323C8E4A7A00A10042 /* MeterScreenControlButtonView.swift */,

+				D28F11343C8E4A7A00A10044 /* MeterCurrentScreenSummaryView.swift */,

+			);

+			path = Subviews;

+			sourceTree = "<group>";

+		};

+		D28F11253C8E4A7A00A10035 /* Subviews */ = {

+			isa = PBXGroup;

+			children = (

+				437D47D02415F91B00B7768E /* MeterLiveContentView.swift */,

+				D28F11223C8E4A7A00A10032 /* MeterLiveMetricRange.swift */,

+				D28F11243C8E4A7A00A10034 /* LoadResistanceIconView.swift */,

+			);

+			path = Subviews;

+			sourceTree = "<group>";

+		};

+		D28F11263C8E4A7A00A10036 /* Subviews */ = {

+			isa = PBXGroup;

+			children = (

+				4308CF8524176CAB0002E80B /* DataGroupRowView.swift */,

+			);

+			path = Subviews;

+			sourceTree = "<group>";

+		};

+		D28F11273C8E4A7A00A10037 /* ChargeRecord */ = {

+			isa = PBXGroup;

+			children = (

+				437D47D42415FD8C00B7768E /* ChargeRecordSheetView.swift */,

+				D28F11383C8E4A7A00A10048 /* Subviews */,

+			);

+			path = ChargeRecord;

+			sourceTree = "<group>";

+		};

+		D28F11383C8E4A7A00A10048 /* Subviews */ = {

+			isa = PBXGroup;

+			children = (

+				D28F11363C8E4A7A00A10046 /* ChargeRecordMetricsTableView.swift */,

+			);

+			path = Subviews;

+			sourceTree = "<group>";

+		};

+		D28F113F3C8E4A7A00A1004F /* Components */ = {

+			isa = PBXGroup;

+			children = (

+				D28F11123C8E4A7A00A10022 /* MeterInfoCardView.swift */,

+				D28F11143C8E4A7A00A10024 /* MeterInfoRowView.swift */,

+				437F0AB62463108F005DEBEC /* MeasurementChartView.swift */,

+			);

+			path = Components;

+			sourceTree = "<group>";

+		};

+			fileSystemSynchronizedGroups = (

+				43BE08E12F78F49500250EEC /* SidebarList */,

+			);

+						SystemCapabilities = {

+							com.apple.iCloud = {

+								enabled = 1;

+							};

+						};

+				437D47D72415FDF300B7768E /* MeterScreenControlsView.swift in Sources */,

+				4308CF882417770D0002E80B /* DataGroupsSheetView.swift in Sources */,

+				D28F11013C8E4A7A00A10011 /* MeterHomeTabView.swift in Sources */,

+				D28F11033C8E4A7A00A10013 /* MeterLiveTabView.swift in Sources */,

+				D28F11053C8E4A7A00A10015 /* MeterChartTabView.swift in Sources */,

+				D28F11073C8E4A7A00A10017 /* MeterSettingsTabView.swift in Sources */,

+				D28F11113C8E4A7A00A10021 /* MeterInfoCardView.swift in Sources */,

+				D28F11133C8E4A7A00A10023 /* MeterInfoRowView.swift in Sources */,

+				D28F11153C8E4A7A00A10025 /* MeterNameEditorView.swift in Sources */,

+				D28F11173C8E4A7A00A10027 /* ScreenTimeoutEditorView.swift in Sources */,

+				D28F11193C8E4A7A00A10029 /* ScreenBrightnessEditorView.swift in Sources */,

+				D28F11213C8E4A7A00A10031 /* MeterLiveMetricRange.swift in Sources */,

+				D28F11233C8E4A7A00A10033 /* LoadResistanceIconView.swift in Sources */,

+				D28F11313C8E4A7A00A10041 /* MeterScreenControlButtonView.swift in Sources */,

+				D28F11333C8E4A7A00A10043 /* MeterCurrentScreenSummaryView.swift in Sources */,

+				D28F11353C8E4A7A00A10045 /* ChargeRecordMetricsTableView.swift in Sources */,

+				D28F11393C8E4A7A00A10049 /* MeterConnectionStatusBadgeView.swift in Sources */,

+				D28F113B3C8E4A7A00A1004B /* MeterConnectionActionView.swift in Sources */,

+				D28F113D3C8E4A7A00A1004D /* MeterOverviewSectionView.swift in Sources */,

+				437D47D12415F91B00B7768E /* MeterLiveContentView.swift in Sources */,

+				3407A133FADB8858DC2A1FED /* MeterNameStore.swift in Sources */,

+				AAD5F9B12B1CAC7A00F8E4F9 /* SidebarView.swift in Sources */,

+				437D47D52415FD8C00B7768E /* ChargeRecordSheetView.swift in Sources */,

+				43554B32244449B5004E66F5 /* MeasurementSeriesSampleView.swift in Sources */,

+				43554B2F24443939004E66F5 /* MeasurementSeriesSheetView.swift in Sources */,

+				AAD5F9A72B1CAC0700F8E4F9 /* MeterDetailView.swift in Sources */,

+				E430FB6B7CB3E0D4189F6D7D /* MeterMappingDebugView.swift in Sources */,

+				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator";

+				SUPPORTS_MAC_DESIGNED_FOR_IPHONE_IPAD = NO;

+				SUPPORTS_XR_DESIGNED_FOR_IPHONE_IPAD = NO;

+				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator";

+				SUPPORTS_MAC_DESIGNED_FOR_IPHONE_IPAD = NO;

+				SUPPORTS_XR_DESIGNED_FOR_IPHONE_IPAD = NO;

+    guard shouldEmitTrackMessage(message, file: file, function: function) else {

+        return

+    }

+private func shouldEmitTrackMessage(_ message: String, file: String, function: String) -> Bool {

+    #if DEBUG

+    if ProcessInfo.processInfo.environment["USB_METER_VERBOSE_LOGS"] == "1" {

+        return true

+    }

+

+    #if targetEnvironment(macCatalyst)

+    let importantMarkers = [

+        "Error",

+        "error",

+        "Failed",

+        "failed",

+        "timeout",

+        "Timeout",

+        "Missing",

+        "missing",

+        "overflow",

+        "Disconnect",

+        "disconnect",

+        "Disconnected",

+        "unauthorized",

+        "not authorized",

+        "not supported",

+        "Unexpected",

+        "Invalid Context",

+        "ignored",

+        "Guard:",

+        "Skip data request",

+        "Dropping unsolicited data",

+        "This is not possible!",

+        "Inferred",

+        "Clearing",

+        "Reconnecting"

+    ]

+

+    if importantMarkers.contains(where: { message.contains($0) }) {

+        return true

+    }

+

+    let noisyFunctions: Set<String> = [

+        "logRuntimeICloudDiagnostics()",

+        "refreshCloudAvailability(reason:)",

+        "start()",

+        "centralManagerDidUpdateState(_:)",

+        "discoveredMeter(peripheral:advertising:rssi:)",

+        "connect()",

+        "connectionEstablished()",

+        "peripheral(_:didDiscoverServices:)",

+        "peripheral(_:didDiscoverCharacteristicsFor:error:)",

+        "refreshOperationalStateIfReady()",

+        "peripheral(_:didUpdateNotificationStateFor:error:)",

+        "scheduleDataDumpRequest(after:reason:)"

+    ]

+

+    if noisyFunctions.contains(function) {

+        return false

+    }

+

+    let noisyMarkers = [

+        "Runtime iCloud diagnostics",

+        "iCloud availability",

+        "Starting Bluetooth manager",

+        "Bluetooth is On... Start scanning...",

+        "adding new USB Meter",

+        "Connect called for",

+        "Connection established for",

+        "Optional([<CBService:",

+        "Optional([<CBCharacteristic:",

+        "Waiting for notifications on",

+        "Notification state updated for",

+        "Peripheral ready with notify",

+        "Schedule data request in",

+        "Operational state changed"

+    ]

+

+    if noisyMarkers.contains(where: { message.contains($0) }) {

+        return false

+    }

+    #endif

+

+    return true

+    #else

+    _ = file

+    _ = function

+    return false

+    #endif

+}

+

+        logRuntimeICloudDiagnostics()

+    private func logRuntimeICloudDiagnostics() {

+        #if DEBUG

+        let hasUbiquityIdentityToken = FileManager.default.ubiquityIdentityToken != nil

+        track("Runtime iCloud diagnostics: ubiquityIdentityTokenAvailable=\(hasUbiquityIdentityToken)")

+        #endif

+    }

+

+    struct MeterSummary: Identifiable {

+        let macAddress: String

+        let displayName: String

+        let modelSummary: String

+        let advertisedName: String?

+        let lastSeen: Date?

+        let lastConnected: Date?

+        let meter: Meter?

+

+        var id: String {

+            macAddress

+        }

+    }

+

+    private var meterStoreObserver: AnyCancellable?

+    private var meterStoreCloudObserver: AnyCancellable?

+    private let meterStore = MeterNameStore.shared

+        meterStoreObserver = NotificationCenter.default.publisher(for: .meterNameStoreDidChange)

+            .receive(on: DispatchQueue.main)

+            .sink { [weak self] _ in

+                self?.refreshMeterMetadata()

+            }

+        meterStoreCloudObserver = NotificationCenter.default.publisher(for: .meterNameStoreCloudStatusDidChange)

+            .receive(on: DispatchQueue.main)

+            .sink { [weak self] _ in

+                self?.scheduleObjectWillChange()

+            }

+

+

+

+

+    var cloudAvailability: MeterNameStore.CloudAvailability {

+        meterStore.currentCloudAvailability

+    }

+

+    func meterName(for macAddress: String) -> String? {

+        meterStore.name(for: macAddress)

+    }

+

+    func setMeterName(_ name: String, for macAddress: String) {

+        meterStore.upsert(macAddress: macAddress, name: name, temperatureUnitRawValue: nil)

+    }

+

+    func temperatureUnitPreference(for macAddress: String) -> TemperatureUnitPreference {

+        let rawValue = meterStore.temperatureUnitRawValue(for: macAddress) ?? TemperatureUnitPreference.celsius.rawValue

+        return TemperatureUnitPreference(rawValue: rawValue) ?? .celsius

+    }

+

+    func setTemperatureUnitPreference(_ preference: TemperatureUnitPreference, for macAddress: String) {

+        meterStore.upsert(macAddress: macAddress, name: nil, temperatureUnitRawValue: preference.rawValue)

+    }

+

+    func registerMeter(macAddress: String, modelName: String?, advertisedName: String?) {

+        meterStore.registerMeter(macAddress: macAddress, modelName: modelName, advertisedName: advertisedName)

+    }

+

+    func noteMeterSeen(at date: Date, macAddress: String) {

+        meterStore.noteLastSeen(date, for: macAddress)

+    }

+

+    func noteMeterConnected(at date: Date, macAddress: String) {

+        meterStore.noteLastConnected(date, for: macAddress)

+    }

+

+    func lastSeen(for macAddress: String) -> Date? {

+        meterStore.lastSeen(for: macAddress)

+    }

+

+    func lastConnected(for macAddress: String) -> Date? {

+        meterStore.lastConnected(for: macAddress)

+    }

+

+    var meterSummaries: [MeterSummary] {

+        let liveMetersByMAC = Dictionary(uniqueKeysWithValues: meters.values.map { ($0.btSerial.macAddress.description, $0) })

+        let recordsByMAC = Dictionary(uniqueKeysWithValues: meterStore.allRecords().map { ($0.macAddress, $0) })

+        let macAddresses = Set(recordsByMAC.keys).union(liveMetersByMAC.keys)

+

+        return macAddresses.map { macAddress in

+            let liveMeter = liveMetersByMAC[macAddress]

+            let record = recordsByMAC[macAddress]

+

+            return MeterSummary(

+                macAddress: macAddress,

+                displayName: Self.friendlyDisplayName(liveMeter: liveMeter, record: record),

+                modelSummary: liveMeter?.deviceModelSummary ?? record?.modelName ?? "Meter",

+                advertisedName: liveMeter?.modelString ?? record?.advertisedName,

+                lastSeen: liveMeter?.lastSeen ?? record?.lastSeen,

+                lastConnected: liveMeter?.lastConnectedAt ?? record?.lastConnected,

+                meter: liveMeter

+            )

+        }

+        .sorted { lhs, rhs in

+            if lhs.meter != nil && rhs.meter == nil {

+                return true

+            if lhs.meter == nil && rhs.meter != nil {

+                return false

+            let byName = lhs.displayName.localizedCaseInsensitiveCompare(rhs.displayName)

+            if byName != .orderedSame {

+                return byName == .orderedAscending

+            }

+            return lhs.macAddress < rhs.macAddress

+

+    private func refreshMeterMetadata() {

+        DispatchQueue.main.async { [weak self] in

+            guard let self else { return }

+            var didUpdateAnyMeter = false

+            for meter in self.meters.values {

+                let mac = meter.btSerial.macAddress.description

+                let displayName = self.meterName(for: mac) ?? mac

+                if meter.name != displayName {

+                    meter.updateNameFromStore(displayName)

+                    didUpdateAnyMeter = true

+                }

+

+                let previousTemperaturePreference = meter.tc66TemperatureUnitPreference

+                meter.reloadTemperatureUnitPreference()

+                if meter.tc66TemperatureUnitPreference != previousTemperaturePreference {

+                    didUpdateAnyMeter = true

+                }

+            }

+

+            if didUpdateAnyMeter {

+                self.scheduleObjectWillChange()

+            }

+        }

+    }

+}

+

+extension AppData.MeterSummary {

+    var tint: Color {

+        switch modelSummary {

+        case "UM25C":

+            return .blue

+        case "UM34C":

+            return .yellow

+        case "TC66C":

+            return Model.TC66C.color

+        default:

+            return .secondary

+        }

+    }

+}

+

+private extension AppData {

+    static func friendlyDisplayName(liveMeter: Meter?, record: MeterNameStore.Record?) -> String {

+        if let liveName = liveMeter?.name.trimmingCharacters(in: .whitespacesAndNewlines), !liveName.isEmpty {

+            return liveName

+        }

+        if let customName = record?.customName {

+            return customName

+        }

+        if let advertisedName = record?.advertisedName {

+            return advertisedName

+        }

+        if let recordModel = record?.modelName {

+            return recordModel

+        }

+        if let liveModel = liveMeter?.deviceModelSummary {

+            return liveModel

+        }

+        return "Meter"

+    }

+        let macAddressString = macAddress.description

+        appData.registerMeter(macAddress: macAddressString, modelName: model.canonicalName, advertisedName: peripheralName)

+        appData.noteMeterSeen(at: Date(), macAddress: macAddressString)

+            let macAddress = meter.btSerial.macAddress.description

+            if meter.name == macAddress, let syncedName = appData.meterName(for: macAddress), syncedName != macAddress {

+                meter.updateNameFromStore(syncedName)

+            }

+        for meter in appData.meters.values {

+            meter.btSerial.centralStateChanged(to: central.state)

+        }

+            advertisementDataCache.clear()

+            advertisementDataCache.clear()

+            advertisementDataCache.clear()

+            advertisementDataCache.clear()

+            advertisementDataCache.clear()

+            advertisementDataCache.clear()

+            track("Connected to meter with UUID: '\(peripheral.identifier)'")

+            track("Disconnected from meter with UUID: '\(peripheral.identifier)'")

+            track("Failed to connect to meter with UUID: '\(peripheral.identifier)'")

+

+    private func forceNotConnected(reason: String, clearCharacteristics: Bool = true) {

+        resetCommunicationState(reason: reason, clearCharacteristics: clearCharacteristics)

+        guard operationalState != .peripheralNotConnected else {

+            return

+        }

+        operationalState = .peripheralNotConnected

+    }

+        guard manager.state == .poweredOn else {

+            track("Connect requested for '\(peripheral.identifier)' but central state is \(manager.state)")

+            forceNotConnected(reason: "connect() while central is \(manager.state)")

+            return

+        }

+            guard manager.state == .poweredOn else {

+                track("Skipping central cancel for '\(peripheral.identifier)' because central state is \(manager.state)")

+                forceNotConnected(reason: "disconnect() while central is \(manager.state)", clearCharacteristics: false)

+                return

+            }

+    func centralStateChanged(to newState: CBManagerState) {

+        switch newState {

+        case .poweredOn:

+            if administrativeState == .up,

+               operationalState == .peripheralNotConnected,

+               peripheral.state == .disconnected {

+                track("Central returned to poweredOn. Restoring connection to '\(peripheral.identifier)'")

+                connect()

+            }

+        case .poweredOff, .resetting, .unauthorized, .unknown, .unsupported:

+            if operationalState != .peripheralNotConnected || expectedResponseLength != 0 || !buffer.isEmpty {

+                track("Central changed to \(newState). Forcing '\(peripheral.identifier)' to not connected.")

+            }

+            forceNotConnected(reason: "centralStateChanged(\(newState))")

+        @unknown default:

+            track("Central changed to an unknown state. Forcing '\(peripheral.identifier)' to not connected.")

+            forceNotConnected(reason: "centralStateChanged(@unknown default)")

+        }

+    }

+