| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651 |
- import SwiftUI
- /// Represents the navigation direction in the onboarding flow
- enum OnboardingNavigationDirection {
- case forward
- case backward
- }
- enum OnboardingChapter: Int, CaseIterable {
- case prepareTrio
- case therapySettings
- case deliveryLimits
- case algorithmSettings
- case permissionRequests
- var id: Int { rawValue }
- var title: String {
- switch self {
- case .prepareTrio:
- return String(localized: "Prepare Trio")
- case .therapySettings:
- return String(localized: "Therapy Settings")
- case .deliveryLimits:
- return String(localized: "Delivery Limits")
- case .algorithmSettings:
- return String(localized: "Algorithm Settings")
- case .permissionRequests:
- return String(localized: "Permission Requests")
- }
- }
- var overviewDescription: String {
- switch self {
- case .prepareTrio:
- return String(
- localized: "Configure diagnostics sharing, optionally sync with Nightscout, and enter essentials."
- )
- case .therapySettings:
- return String(
- localized: "Define your glucose targets, basal rates, carb ratios, and insulin sensitivities."
- )
- case .deliveryLimits:
- return String(
- localized: "Set boundaries for insulin delivery and carb entries to help Trio keep you safe."
- )
- case .algorithmSettings:
- return String(
- localized: "Customize Trio’s algorithm features. Most users start with the recommended settings."
- )
- case .permissionRequests:
- return String(
- localized: "Authorize Trio to send notifications and use Bluetooth. You must allow both for Trio to work properly."
- )
- }
- }
- var duration: String {
- switch self {
- case .prepareTrio:
- return "3-5"
- case .therapySettings:
- return "5-10"
- case .deliveryLimits:
- return "3-5"
- case .algorithmSettings:
- return "5-10"
- case .permissionRequests:
- return "1"
- }
- }
- var completedDescription: String {
- switch self {
- case .prepareTrio:
- return String(
- localized: "App diagnostics sharing, Nightscout setup, and unit and pump model selection are all complete."
- )
- case .therapySettings:
- return String(
- localized: "Glucose target, basal rates, carb ratios, and insulin sensitivity match your needs."
- )
- case .deliveryLimits:
- return String(
- localized: "Safety boundaries for insulin delivery and carb entries are set to help Trio keep you safe."
- )
- case .algorithmSettings:
- return String(localized: "Trio’s algorithm features are customized to fit your preferences and needs.")
- case .permissionRequests:
- return String(localized: "Notifications and Bluetooth permissions are handled to your liking.")
- }
- }
- }
- /// Represents the different steps in the onboarding process.
- enum OnboardingStep: Int, CaseIterable, Identifiable, Equatable {
- case welcome
- case startupInfo
- case overview
- case diagnostics
- case nightscout
- case unitSelection
- case glucoseTarget
- case basalRates
- case carbRatio
- case insulinSensitivity
- case deliveryLimits
- case algorithmSettings
- case autosensSettings
- case smbSettings
- case targetBehavior
- case notifications
- case bluetooth
- case completed
- var id: Int { rawValue }
- var hasSubsteps: Bool {
- self == .deliveryLimits
- }
- /// The title to display for this onboarding step.
- var title: String {
- switch self {
- case .welcome:
- return String(localized: "Welcome to Trio")
- case .startupInfo:
- return String(localized: "Startup Guide")
- case .overview:
- return String(localized: "Overview")
- case .diagnostics:
- return String(localized: "Diagnostics")
- case .nightscout:
- return String(localized: "Nightscout")
- case .unitSelection:
- return String(localized: "Units & Pump")
- case .glucoseTarget:
- return String(localized: "Glucose Targets")
- case .basalRates:
- return String(localized: "Basal Rates")
- case .carbRatio:
- return String(localized: "Carb Ratios")
- case .insulinSensitivity:
- return String(localized: "Insulin Sensitivities")
- case .deliveryLimits:
- return String(localized: "Delivery Limits")
- case .algorithmSettings:
- return String(localized: "Algorithm Settings")
- case .autosensSettings:
- return String(localized: "Autosens")
- case .smbSettings:
- return String(localized: "Super Micro Bolus")
- case .targetBehavior:
- return String(localized: "Target Behavior")
- case .notifications:
- return String(localized: "Notifications")
- case .bluetooth:
- return String(localized: "Bluetooth")
- case .completed:
- return String(localized: "All Set!")
- }
- }
- /// A detailed description of what this onboarding step is about.
- var description: String {
- switch self {
- case .welcome:
- return String(
- localized: "Trio is a powerful app that helps you manage your diabetes. Let's get started by setting up a few important parameters that will help Trio work effectively for you."
- )
- case .startupInfo:
- return String(
- localized: "Trio comes with a helpful Startup Guide. We recommend opening it now and following along as you go — side by side."
- )
- case .overview:
- return String(
- localized: "Trio's Onboarding takes about 15-30 minutes to complete. We'll guide you through each step."
- )
- case .diagnostics:
- return String(
- localized: "By default, Trio collects crash reports and other anonymized data related to errors, exceptions, and overall app performance."
- )
- case .nightscout:
- return String(
- localized: "Nightscout is a cloud-based platform that allows you to store your diabetes data. It's often used by caregivers to remotely monitor what Trio is doing."
- )
- case .unitSelection:
- return String(
- localized: "Before you can begin with configuring your therapy settings, Trio needs to know which units you use for your glucose and insulin measurements (based on your pump model)."
- )
- case .glucoseTarget:
- return String(
- localized: "Your glucose target is the blood glucose level you aim to maintain. Trio will use this to calculate insulin doses and provide recommendations."
- )
- case .basalRates:
- return String(
- localized: "Your basal profile represents the amount of background insulin you need throughout the day. This helps Trio calculate your insulin needs."
- )
- case .carbRatio:
- return String(
- localized: "Your carb ratio tells how many grams of carbohydrates one unit of insulin will cover. This is essential for accurate meal bolus calculations."
- )
- case .insulinSensitivity:
- return String(
- localized: "Your insulin sensitivity factor (ISF) indicates how much one unit of insulin will lower your blood glucose. This helps calculate correction boluses."
- )
- case .deliveryLimits:
- return String(
- localized: "Trio includes several safety limits for insulin delivery and carbohydrate entry, helping ensure a safe and effective experience."
- )
- case .algorithmSettings:
- return String(
- localized: "Trio includes several algorithm settings that allow you to customize the oref algorithm behavior to suit your specific needs."
- )
- case .autosensSettings:
- return String(
- localized: "Auto-sensitivity (Autosens) adjusts insulin delivery based on observed sensitivity or resistance."
- )
- case .smbSettings:
- return String(
- localized: "SMB (Super Micro Bolus) is an oref algorithm feature that delivers small frequent boluses instead of temporary basals for faster glucose control."
- )
- case .targetBehavior:
- return String(
- localized: "Target Behavior allows you to adjust how temporary targets influence ISF, basal, and auto-targeting based on sensitivity or resistance."
- )
- case .notifications:
- return String(localized: " Allow Trio to send you Notifications. These may include alerts, sounds, and icon badges.")
- case .bluetooth:
- return String(localized: "Allow Trio to use Bluetooth to communicate with your insulin pump and CGM.")
- case .completed:
- return String(
- localized: "Great job! You've completed the initial setup of Trio. You can always adjust these settings later in the app."
- )
- }
- }
- /// The system icon name associated with this step.
- var iconName: String {
- switch self {
- case .welcome:
- return "hand.wave.fill"
- case .startupInfo:
- return "list.bullet.clipboard.fill"
- case .overview:
- return "checklist.unchecked"
- case .diagnostics:
- return "waveform.badge.magnifyingglass"
- case .nightscout:
- return "owl"
- case .unitSelection:
- return "numbers.rectangle"
- case .glucoseTarget:
- return "target"
- case .basalRates:
- return "chart.xyaxis.line"
- case .carbRatio:
- return "fork.knife"
- case .insulinSensitivity:
- return "drop.fill"
- case .deliveryLimits:
- return "slider.horizontal.3"
- case .algorithmSettings:
- return "gearshape.2.fill"
- case .autosensSettings:
- return "dial.low.fill"
- case .smbSettings:
- return "bolt.fill"
- case .targetBehavior:
- return "gyroscope"
- case .notifications:
- return "bell.badge.fill"
- case .bluetooth:
- return "logo.bluetooth.capsule.portrait.fill"
- case .completed:
- return "checkmark.circle.fill"
- }
- }
- /// Returns the next step in the onboarding process, or nil if this is the last step.
- var next: OnboardingStep? {
- let allCases = OnboardingStep.allCases
- let currentIndex = allCases.firstIndex(of: self) ?? 0
- let nextIndex = currentIndex + 1
- return nextIndex < allCases.count ? allCases[nextIndex] : nil
- }
- /// Returns the previous step in the onboarding process, or nil if this is the first step.
- var previous: OnboardingStep? {
- let allCases = OnboardingStep.allCases
- let currentIndex = allCases.firstIndex(of: self) ?? 0
- let previousIndex = currentIndex - 1
- return previousIndex >= 0 ? allCases[previousIndex] : nil
- }
- /// The accent color to use for this step.
- var accentColor: Color {
- switch self {
- case .algorithmSettings,
- .autosensSettings,
- .bluetooth,
- .completed,
- .deliveryLimits,
- .diagnostics,
- .nightscout,
- .notifications,
- .overview,
- .smbSettings,
- .startupInfo,
- .targetBehavior,
- .unitSelection,
- .welcome:
- return Color.blue
- case .glucoseTarget:
- return Color.green
- case .basalRates:
- return Color.purple
- case .carbRatio:
- return Color.orange
- case .insulinSensitivity:
- return Color.cyan
- }
- }
- var chapterCompletion: OnboardingChapter? {
- switch self {
- case .unitSelection:
- return .prepareTrio
- case .insulinSensitivity:
- return .therapySettings
- case .deliveryLimits:
- // ❗ Delivery Limits depends on the substep, not just the step.
- // Skip here
- return nil
- case .targetBehavior:
- // ❗ Target Behavior depends on the substep, not just the step.
- // Skip here
- return nil
- default:
- return nil
- }
- }
- }
- var nonInfoOnboardingSteps: [OnboardingStep] { OnboardingStep.allCases
- .filter { $0 != .welcome && $0 != .startupInfo && $0 != .overview && $0 != .completed }
- }
- enum StartupSubstep: Int, CaseIterable, Identifiable {
- case startupGuide
- case returningUser
- case forceCloseWarning
- var id: Int { rawValue }
- }
- enum DeliveryLimitSubstep: Int, CaseIterable, Identifiable {
- case maxIOB
- case maxBolus
- case maxBasal
- case maxCOB
- case minimumSafetyThreshold
- var id: Int { rawValue }
- var title: String {
- switch self {
- case .maxIOB: return String(localized: "Maximum Insulin on Board (IOB)", comment: "Max IOB")
- case .maxBolus: return String(localized: "Maximum Bolus")
- case .maxBasal: return String(localized: "Maximum Basal Rate")
- case .maxCOB: return String(localized: "Maximum Carbs on Board (COB)", comment: "Max COB")
- case .minimumSafetyThreshold: return String(localized: "Minimum Safety Threshold")
- }
- }
- var hint: String {
- switch self {
- case .maxIOB: return String(localized: "Maximum units of insulin allowed to be active.")
- case .maxBolus: return String(localized: "Largest bolus of insulin allowed.")
- case .maxBasal: return String(localized: "Largest basal rate allowed.")
- case .maxCOB: return String(localized: "Maximum amount of active carbs considered by the algorithm.")
- case .minimumSafetyThreshold: return String(localized: "Increase the safety threshold used to suspend insulin delivery.")
- }
- }
- func description(units: GlucoseUnits) -> any View {
- switch self {
- case .maxIOB:
- return VStack(alignment: .leading, spacing: 10) {
- Text("Default: 0 units").bold()
- Text(
- "Note: This setting must be greater than 0 for any automatic insulin dosing by Trio (unless you currently have negative IOB)."
- )
- .bold()
- .foregroundStyle(Color.orange)
- Text(
- "Choose a value that covers your highest insulin needs — think about a correction for a very high glucose reading plus your biggest meal bolus. This gives Trio room to work while keeping you safe."
- )
- Text(
- "Max IOB sets a safety limit on how much insulin Trio can automatically deliver above your scheduled basal rates. This prevents the system from giving too much insulin at once."
- )
- VStack(alignment: .leading, spacing: 0) {
- Text("Trio calculates your current Insulin On Board (IOB) from:")
- Text("• Boluses (including SMBs)")
- Text("• Temporary Basal Rates (TBRs)")
- Text(" ◦ A TBR higher than your scheduled rate will increase IOB")
- Text(" ◦ A TBR lower than your scheduled rate will decrease IOB")
- }
- Text(
- "If delivering more insulin would push your IOB above this limit, Trio will reduce or skip the dose to stay within the safety boundary. This applies to SMBs, TBRs, and the recommendation from the bolus calculator."
- )
- VStack(alignment: .leading, spacing: 0) {
- Text("What's NOT limited:")
- Text("• Manual boluses you enter yourself")
- Text("• Manual temporary basal rates you set yourself")
- }
- }
- .fixedSize(horizontal: false, vertical: true)
- case .maxBolus:
- return VStack(alignment: .leading, spacing: 8) {
- Text(
- "This is the maximum bolus allowed to be delivered at one time. This limits manual and automatic bolus."
- )
- Text("Most set this to their largest meal bolus. Then, adjust if needed.")
- Text("If you attempt to request a bolus larger than this, the bolus will not be accepted.")
- }
- case .maxBasal:
- return VStack(alignment: .leading, spacing: 8) {
- Text(
- "This is the maximum basal rate allowed to be set or scheduled. This applies to both automatic and manual basal rates."
- )
- Text(
- "Note to Medtronic Pump Users: You must also manually set the max basal rate on the pump to this value or higher."
- )
- }
- case .maxCOB:
- return VStack(alignment: .leading, spacing: 8) {
- Text(
- "This setting defines the maximum amount of Carbs On Board (COB) at any given time for Trio to use in dosing calculations. If more carbs are entered than allowed by this limit, Trio will cap the current COB in calculations to Max COB and remain at max until all remaining carbs have shown to be absorbed."
- )
- Text(
- "For example, if Max COB is 120 g and you enter a meal containing 150 g of carbs, your COB will remain at 120 g until the remaining 30 g have been absorbed."
- )
- Text("This is an important limit when UAM is ON.")
- }
- case .minimumSafetyThreshold:
- return VStack(alignment: .leading, spacing: 8) {
- Text("Default: Set by Algorithm").bold()
- Text(
- "Minimum Threshold Setting is, by default, determined by your set Glucose Target. This threshold automatically suspends insulin delivery if your glucose levels are forecasted to fall below this value. It’s designed to protect against hypoglycemia, particularly during sleep or other vulnerable times."
- )
- Text(
- "Trio will use the larger of the default setting calculation below and the value entered here."
- )
- VStack(alignment: .leading, spacing: 8) {
- VStack(alignment: .leading, spacing: 5) {
- Text("The default setting is based on this calculation:").bold()
- Text("TargetGlucose - 0.5 × (TargetGlucose - 40)")
- }
- VStack(alignment: .leading, spacing: 5) {
- Text(
- "If your glucose target is \(units == .mgdL ? "110" : 110.formattedAsMmolL) \(units.rawValue), Trio will use a safety threshold of \(units == .mgdL ? "75" : 75.formattedAsMmolL) \(units.rawValue), unless you set Minimum Safety Threshold to something > \(units == .mgdL ? "75" : 75.formattedAsMmolL) \(units.rawValue)."
- )
- Text(
- "\(units == .mgdL ? "110" : 110.formattedAsMmolL) - 0.5 × (\(units == .mgdL ? "110" : 110.formattedAsMmolL) - \(units == .mgdL ? "40" : 40.formattedAsMmolL)) = \(units == .mgdL ? "75" : 75.formattedAsMmolL)"
- )
- }
- Text(
- "This setting is limited to values between \(units == .mgdL ? "60" : 60.formattedAsMmolL) - \(units == .mgdL ? "120" : 120.formattedAsMmolL) \(units.rawValue)"
- )
- Text(
- "Note: Basal may be resumed if there is negative IOB and glucose is rising faster than the forecast."
- )
- }
- }
- }
- }
- }
- /// Three-state diagnostics-sharing consent.
- ///
- /// Maps to a pair of independent `Bool?` flags in `PropertyPersistentFlags`:
- /// `diagnosticsSharingEnabled` (Crashlytics) and `telemetryEnabled` (the
- /// anonymous-usage POST). See `TelemetryClient`.
- enum DiagnosticsSharingOption: String, Equatable, CaseIterable, Identifiable {
- case full
- case crashOnly
- case disabled
- var id: String { rawValue }
- var displayName: String {
- switch self {
- case .full:
- return String(localized: "Enable Full Sharing")
- case .crashOnly:
- return String(localized: "Crash Reports Only")
- case .disabled:
- return String(localized: "Disable Sharing")
- }
- }
- var caption: String {
- switch self {
- case .full:
- return String(localized: "Share anonymous crash reports + usage data.")
- case .crashOnly:
- return String(localized: "Share only crash reports — no usage data.")
- case .disabled:
- return String(localized: "Do not share any diagnostic data.")
- }
- }
- var crashlyticsEnabled: Bool {
- switch self {
- case .crashOnly,
- .full: return true
- case .disabled: return false
- }
- }
- var telemetryEnabled: Bool {
- switch self {
- case .full: return true
- case .crashOnly,
- .disabled: return false
- }
- }
- init(crashlyticsEnabled: Bool, telemetryEnabled: Bool) {
- switch (crashlyticsEnabled, telemetryEnabled) {
- case (true, true): self = .full
- case (true, false): self = .crashOnly
- case (false, true): self = .full // unreachable in normal flow
- case (false, false): self = .disabled
- }
- }
- }
- enum PumpOptionForOnboardingUnits: String, Equatable, CaseIterable, Identifiable {
- case minimed
- case omnipodEros
- case omnipodDash
- case dana
- case medtrum
- var id: String { rawValue }
- var displayName: String {
- switch self {
- case .minimed:
- return "Medtronic"
- case .omnipodEros:
- return "Omnipod Eros"
- case .omnipodDash:
- return "Omnipod DASH"
- case .dana:
- return "Dana (RS/-i)"
- case .medtrum:
- return "Medtrum Nano"
- }
- }
- }
- enum NightscoutSetupOption: String, Equatable, CaseIterable, Identifiable {
- case setupNightscout
- case skipNightscoutSetup
- case noSelection
- var id: String { rawValue }
- var displayName: String {
- switch self {
- case .setupNightscout:
- return String(localized: "Setup Nightscout for Trio")
- case .skipNightscoutSetup:
- return String(localized: "Skip Nightscout Setup")
- case .noSelection:
- return ""
- }
- }
- }
- enum NightscoutImportOption: String, Equatable, CaseIterable, Identifiable {
- case useImport
- case skipImport
- case noSelection
- var id: String { rawValue }
- var displayName: String {
- switch self {
- case .useImport:
- return String(localized: "Import Settings")
- case .skipImport:
- return String(localized: "Configure Yourself")
- case .noSelection:
- return ""
- }
- }
- }
- enum NightscoutSubstep: Int, CaseIterable, Identifiable {
- case setupSelection
- case connectToNightscout
- case uploadToNightscout
- case uploadGlucoseToNightscout
- case importFromNightscout
- var id: Int { rawValue }
- }
- struct BulletPoint: View {
- let text: String
- init(_ text: String) {
- self.text = text
- }
- var body: some View {
- HStack(alignment: .top) {
- Text("•")
- Text(text)
- .fixedSize(horizontal: false, vertical: true)
- .multilineTextAlignment(.leading)
- }
- }
- }
- enum OnboardingInputSectionType: Equatable {
- case decimal
- case boolean
- static func == (lhs: OnboardingInputSectionType, rhs: OnboardingInputSectionType) -> Bool {
- switch (lhs, rhs) {
- case (.boolean, .boolean):
- return true
- case (.decimal, .decimal):
- return true
- default:
- return false
- }
- }
- }
|