Skip to content

Colota - Android GPS Location tracker

5.6 KB
Raw Blame
/**
 * Copyright (C) 2026 Max Dietrich
 * Licensed under the GNU AGPLv3. See LICENSE in the project root for details.
 */

import type { ProfileConditionType } from "../types/global"
import type { TranslationKey } from "../i18n/options"
import { Zap, Car, ArrowUp, ArrowDown, Pause, Wifi, Bluetooth } from "lucide-react-native"

// Timing
export const AUTOSAVE_DEBOUNCE_MS = 1500
export const SAVE_SUCCESS_DISPLAY_MS = 2000
/** manualFlush is fire and forget, so the screen gives up on progress events after this. */
export const MANUAL_FLUSH_TIMEOUT_MS = 30_000
/** A retention preview runs a COUNT per keystroke, so it waits for the typing to settle. */
export const RETENTION_PREVIEW_DEBOUNCE_MS = 300

/** The log file grows off-thread, so the size is read once after the toggle settles. */
export const LOG_SIZE_SETTLE_MS = 2000
/** Quick Settings often closes before Bluetooth has turned on, so the paired list is read again after this. */
export const BLUETOOTH_REREAD_MS = 2000

export const LOG_FILTER_DEBOUNCE_MS = 200
export const RETENTION_PRESET_DAYS = [30, 90, 365]
/** A certificate this close to its notAfter reads as expiring: a CA round trip takes weeks. */
export const CERT_EXPIRY_WARNING_DAYS = 30
export const SERVICE_RESTART_DELAY_MS = 500
export const RESTART_DEBOUNCE_MS = 100
export const SETTINGS_READ_ATTEMPTS = 3
export const SETTINGS_READ_RETRY_DELAY_MS = 150

// Spacing scale. Every padding, margin and gap reads from here; designSystemGuard fails a literal.
// The grid is 4dp from xs up. xxs is the one sub-grid step and has one job: the gap between a
// label and its own caption, which is type pairing rather than layout.
export const space = { xxs: 2, xs: 4, sm: 8, md: 12, lg: 16, xl: 24, xxl: 32 } as const

// Sizes are not spacing: these are the painted or touchable extents of a control.
export const size = {
  touch: 48,
  row: 56,
  chip: 32,
  iconButton: 32,
  iconColumn: 40,
  numericField: 88,
  /** The disc behind an empty screen's glyph. */
  emptyIcon: 64,
  icon: { sm: 16, md: 20, lg: 24 }
} as const

/**
 * Material's pressed state layer: 10 percent of the element's own content colour, concatenated
 * onto a hex token. Android draws it as a ripple from the touch point, which an opacity fade
 * of the whole element is not.
 */
export const STATE_LAYER_ALPHA = "1A"

/** The off switch track is `border` at half, which keeps the thumb 3:1 on it in every theme. */
export const SWITCH_TRACK_ALPHA = "80"

export const HIT_SLOP_SM = { top: 6, right: 6, bottom: 6, left: 6 } as const
export const HIT_SLOP_MD = { top: 8, right: 8, bottom: 8, left: 8 } as const
export const HIT_SLOP_LG = { top: 12, right: 12, bottom: 12, left: 12 } as const

// Map
/**
 * Material's elevation levels, named for the job rather than the number: 0, 1, 3 and 6 are levels
 * 0 to 3. The app had 0, 1, 4, 5, 6 and 8, and 4 and 5 are not levels at all.
 */
export const elevation = {
  /** Sits on the ground: the tab bar. */
  flat: 0,
  /** An elevated card, lifted off the ground but not over anything. */
  raised: 1,
  /** A control or badge floating over content, usually the map. */
  floating: 3,
  /** A dialog, a popup or a toast, over everything. */
  overlay: 6
} as const

export const DEFAULT_MAP_ZOOM = 15
export const WORLD_MAP_ZOOM = 2
export const MAX_MAP_ZOOM = 22
export const GEOFENCE_ZOOM_PADDING = [80, 80, 80, 80] as const
export const MAP_ANIMATION_DURATION_MS = 400
export const LOADING_INDICATOR_DELAY_MS = 200

export const PROFILE_CONDITIONS: {
  type: ProfileConditionType
  labelKey: TranslationKey
  /** Opens a row or the rule sentence: "When charging". */
  listKey: TranslationKey
  /** The same clause inside a sentence, where the case may differ: "when charging". */
  clauseKey: TranslationKey
  icon: typeof Zap
  descriptionKey: TranslationKey
}[] = (
  [
    ["charging", Zap],
    ["android_auto", Car],
    ["bluetooth_device", Bluetooth],
    ["wifi_any", Wifi],
    ["wifi_ssid", Wifi],
    ["speed_above", ArrowUp],
    ["speed_below", ArrowDown],
    ["stationary", Pause]
  ] as const
).map(([type, icon]) => ({
  type,
  labelKey: `condition.${type}`,
  listKey: `condition.${type}.list`,
  clauseKey: `condition.${type}.clause`,
  icon,
  descriptionKey: `condition.${type}.description`
}))

export function defaultProfileDelays(conditionType: ProfileConditionType): {
  activationDelay: number
  deactivationDelay: number
} {
  return conditionType === "stationary"
    ? { activationDelay: 60, deactivationDelay: 0 }
    : { activationDelay: 0, deactivationDelay: 60 }
}

// Sync Interval
export const SYNC_INTERVAL_PRESETS: readonly number[] = [0, 60, 300, 900]

export const SYNC_INTERVAL_SUB_KEYS: Record<number, TranslationKey> = {
  0: "syncInterval.sub.0",
  60: "syncInterval.sub.60",
  300: "syncInterval.sub.300",
  900: "syncInterval.sub.900"
}

// Overland batch envelope (Dawarich + batch mode, Overland template)
export const OVERLAND_BATCH_MIN = 1
export const OVERLAND_BATCH_MAX = 500

// Map style
export const MAP_STYLE_URL_LIGHT = "https://maps.mxd.codes/styles/bright/style.json"
export const MAP_STYLE_URL_DARK = "https://maps.mxd.codes/styles/dark/style.json"

// URLs
export const REPO_URL = "https://github.com/dietrichmax/colota"
export const ISSUES_URL = `${REPO_URL}/issues`
export const PRIVACY_POLICY_URL = "https://colota.app/privacy-policy"
export const RELEASES_URL = "https://colota.app/releases"
export const SUPPORT_URL = "https://mxd.codes/support"
/** market:// opens the Play app straight on the listing; the https form is the fallback. */
export const PLAY_STORE_MARKET_URL = "market://details?id=com.Colota"
export const PLAY_STORE_WEB_URL = "https://play.google.com/store/apps/details?id=com.Colota"