super-time-tracker-ui 0.1.2

package/lib/theme_init_script.ts

@@ -0,0 +1,11 @@
+import { THEME_STORAGE_KEY } from "@/lib/types/theme";
+import { THEME_MODE_STORAGE_KEY } from "@/lib/types/ui_preferences";
+
+/**
+ * Inline script that sets the theme before first paint to avoid flashing.
+ */
+export const theme_init_script = `(function(){try{var mk=${JSON.stringify(
+  THEME_MODE_STORAGE_KEY,
+)};var tk=${JSON.stringify(
+  THEME_STORAGE_KEY,
+)};var m=localStorage.getItem(mk);if(m!=='light'&&m!=='dark'&&m!=='system'){var legacy=localStorage.getItem(tk);m=legacy==='light'||legacy==='dark'?legacy:'system';localStorage.setItem(mk,m)}var resolve=function(mode){if(mode==='light'||mode==='dark')return mode;return window.matchMedia('(prefers-color-scheme: light)').matches?'light':'dark'};var t=resolve(m);document.documentElement.setAttribute('data-theme',t);localStorage.setItem(tk,t)}catch(e){document.documentElement.setAttribute('data-theme','dark')}})();`;

package/lib/toggle_sheet_tag_filter.ts

@@ -0,0 +1,28 @@
+import { normalize_stored_tag } from '@/lib/normalize_stored_tag'
+import { read_sheet_tag_filter } from '@/lib/read_sheet_tag_filter'
+import { set_sheet_tag_filter } from '@/lib/set_sheet_tag_filter'
+import { tags_are_equal } from '@/lib/tags_are_equal'
+
+/**
+ * Toggles a tag in the active sheet's filter list.
+ */
+export function toggle_sheet_tag_filter(
+  sheet_name: string,
+  tag: string,
+): void {
+  const normalized = normalize_stored_tag(tag)
+  const current = read_sheet_tag_filter(sheet_name)
+  const is_selected = current.some((filter_tag) =>
+    tags_are_equal(filter_tag, normalized),
+  )
+
+  if (is_selected) {
+    set_sheet_tag_filter(
+      sheet_name,
+      current.filter((filter_tag) => !tags_are_equal(filter_tag, normalized)),
+    )
+    return
+  }
+
+  set_sheet_tag_filter(sheet_name, [...current, normalized])
+}

package/lib/toggle_theme.ts

@@ -0,0 +1,20 @@
+import { apply_theme } from "@/lib/apply_theme";
+import { notify_theme_subscribers } from "@/lib/subscribe_theme";
+import { read_document_theme } from "@/lib/read_document_theme";
+import { theme_mode_preference } from "@/lib/preferences/theme_mode_preference";
+import { type Theme } from "@/lib/types/theme";
+import { write_stored_theme } from "@/lib/write_stored_theme";
+
+/**
+ * Toggles the applied theme and sets the corresponding theme mode preference.
+ */
+export function toggle_theme(): void {
+  const current_theme = read_document_theme();
+  const next_theme: Theme = current_theme === "dark" ? "light" : "dark";
+
+  apply_theme(next_theme);
+  write_stored_theme(next_theme);
+  theme_mode_preference.write(next_theme);
+  theme_mode_preference.notify();
+  notify_theme_subscribers();
+}

package/lib/types/confirm_dialog.ts

@@ -0,0 +1,9 @@
+export type ConfirmDialogVariant = 'default' | 'danger'
+
+export interface ConfirmDialogOptions {
+  title: string
+  message: string
+  confirmLabel?: string
+  cancelLabel?: string
+  variant?: ConfirmDialogVariant
+}

package/lib/types/data.ts

@@ -0,0 +1,16 @@
+import {
+  type ITimeSheet,
+  type ITimeSheetEntry,
+  type ITimeSheetEntryNote,
+  type ITimeTrackerDB,
+} from "./generic_data";
+
+export type TimeTrackerDB = ITimeTrackerDB<Date>;
+export type TimeSheetEntry = ITimeSheetEntry<Date>;
+export type TimeSheetEntryNote = ITimeSheetEntryNote<Date>;
+export type TimeSheet = ITimeSheet<Date>;
+
+export type JSONTimeTrackerDB = ITimeTrackerDB<number>;
+export type JSONTimeSheetEntry = ITimeSheetEntry<number>;
+export type JSONTimeSheetEntryNote = ITimeSheetEntryNote<number>;
+export type JSONTimeSheet = ITimeSheet<number>;

package/lib/types/generic_data.ts

@@ -0,0 +1,25 @@
+export interface ITimeSheetEntryNote<T> {
+  timestamp: T;
+  text: string;
+}
+
+export interface ITimeSheetEntry<T> {
+  id: number;
+  start: T;
+  end: T | null;
+  description: string;
+  tags: string[];
+  notes: ITimeSheetEntryNote<T>[];
+}
+
+export interface ITimeSheet<T> {
+  name: string;
+  entries: ITimeSheetEntry<T>[];
+  activeEntryID: number | null;
+}
+
+export interface ITimeTrackerDB<T> {
+  sheets: ITimeSheet<T>[];
+  activeSheetName: string | null;
+  version: number;
+}

package/lib/types/index.ts

@@ -0,0 +1,2 @@
+export * from "./data";
+export * from "./generic_data";

package/lib/types/reporting.ts

@@ -0,0 +1,59 @@
+export type SheetReportSort = 'duration' | 'name' | 'entry_count' | 'active_first'
+
+export interface ReportingDateRangeInputs {
+  from_date: string
+  to_date: string
+}
+
+export type ReportingDateRangeShortcut =
+  | 'today'
+  | 'yesterday'
+  | 'week'
+  | 'month'
+  | 'last_month'
+  | 'year'
+  | 'last_year'
+
+export interface ReportingSourceEntry {
+  id: number
+  start: string
+  end: string | null
+}
+
+export interface ReportingSourceSheet {
+  name: string
+  activeEntryID: number | null
+  entries: ReportingSourceEntry[]
+}
+
+/**
+ * Time-tracking aggregates for a single sheet.
+ */
+export interface SheetReportStats {
+  sheetName: string
+  totalMs: number
+  entryCount: number
+  averageEntryMs: number
+  hasActiveEntry: boolean
+}
+
+/**
+ * Time tracked within calendar periods, clipped to period boundaries.
+ */
+export interface ReportingPeriodTotals {
+  todayMs: number
+  weekMs: number
+  monthMs: number
+}
+
+/**
+ * Cross-sheet reporting snapshot for the reporting view.
+ */
+export interface ReportingStats {
+  activeSheets: SheetReportStats[]
+  idleSheets: SheetReportStats[]
+  grandTotalMs: number
+  totalEntryCount: number
+  grandAverageEntryMs: number
+  periodTotals: ReportingPeriodTotals
+}

package/lib/types/tag_management.ts

@@ -0,0 +1,7 @@
+/**
+ * Aggregated usage for a tag across the database.
+ */
+export interface TagStat {
+  name: string
+  entryCount: number
+}

package/lib/types/theme.ts

@@ -0,0 +1,3 @@
+export type Theme = "light" | "dark";
+
+export const THEME_STORAGE_KEY = "super-time-tracker-theme";

package/lib/types/tracker_state.ts

@@ -0,0 +1,39 @@
+export interface SerializedNote {
+  timestamp: string
+  text: string
+}
+
+export interface SerializedEntry {
+  id: number
+  description: string
+  start: string
+  end: string | null
+  tags: string[]
+  notes: SerializedNote[]
+  sheetName: string
+  durationMs: number
+  isActive: boolean
+}
+
+export interface SerializedSheet {
+  name: string
+  activeEntryID: number | null
+  entryCount: number
+  isActive: boolean
+  hasActiveEntry: boolean
+}
+
+export interface TrackerState {
+  dbPath: string
+  activeSheetName: string | null
+  sheets: SerializedSheet[]
+  knownTags: string[]
+  /** Running entry on the viewed sheet, if any. */
+  activeEntry: SerializedEntry | null
+  /** Any running entry (for the header bar and tab title). */
+  runningEntry: SerializedEntry | null
+  /** All running entries across sheets, in sheet order. */
+  runningEntries: SerializedEntry[]
+  activeSheetEntries: SerializedEntry[]
+  activeSheetTotalMs: number
+}

package/lib/types/ui_preferences.ts

@@ -0,0 +1,104 @@
+export type ThemeMode = 'light' | 'dark' | 'system'
+export const THEME_MODE_STORAGE_KEY = 'super-time-tracker-theme-mode'
+export const THEME_MODE_DEFAULT: ThemeMode = 'system'
+
+export type ColorPalette =
+  | 'default'
+  | 'midnight'
+  | 'warm'
+  | 'ocean'
+  | 'forest'
+  | 'contrast'
+export const COLOR_PALETTE_STORAGE_KEY = 'super-time-tracker-color-palette'
+export const COLOR_PALETTE_DEFAULT: ColorPalette = 'default'
+export const COLOR_PALETTE_VALUES: ColorPalette[] = [
+  'default',
+  'midnight',
+  'warm',
+  'ocean',
+  'forest',
+  'contrast',
+]
+
+export type TimeFormat = '12h' | '24h'
+export const TIME_FORMAT_STORAGE_KEY = 'super-time-tracker-time-format'
+export const TIME_FORMAT_DEFAULT: TimeFormat = '12h'
+
+export type DurationFormat = 'humanized' | 'clock' | 'decimal'
+export const DURATION_FORMAT_STORAGE_KEY = 'super-time-tracker-duration-format'
+export const DURATION_FORMAT_DEFAULT: DurationFormat = 'humanized'
+
+export type WeekStartsOn = 'monday' | 'sunday'
+export const WEEK_STARTS_ON_STORAGE_KEY = 'super-time-tracker-week-starts-on'
+export const WEEK_STARTS_ON_DEFAULT: WeekStartsOn = 'monday'
+
+export type DefaultReportingSort =
+  | 'duration'
+  | 'name'
+  | 'entry_count'
+  | 'active_first'
+export const DEFAULT_REPORTING_SORT_STORAGE_KEY =
+  'super-time-tracker-default-reporting-sort'
+export const DEFAULT_REPORTING_SORT_DEFAULT: DefaultReportingSort = 'duration'
+
+export type CheckInFormCollapsed = 'true' | 'false'
+export const CHECK_IN_FORM_COLLAPSED_STORAGE_KEY =
+  'super-time-tracker-check-in-form-collapsed'
+export const CHECK_IN_FORM_COLLAPSED_DEFAULT: CheckInFormCollapsed = 'false'
+
+export type ConfirmBeforeCheckout = 'true' | 'false'
+export const CONFIRM_BEFORE_CHECKOUT_STORAGE_KEY =
+  'super-time-tracker-confirm-before-checkout'
+export const CONFIRM_BEFORE_CHECKOUT_DEFAULT: ConfirmBeforeCheckout = 'false'
+
+export type ConfirmDestructiveActions = 'true' | 'false'
+export const CONFIRM_DESTRUCTIVE_ACTIONS_STORAGE_KEY =
+  'super-time-tracker-confirm-destructive-actions'
+export const CONFIRM_DESTRUCTIVE_ACTIONS_DEFAULT: ConfirmDestructiveActions =
+  'true'
+
+export type AccentColor =
+  | 'teal'
+  | 'blue'
+  | 'violet'
+  | 'rose'
+  | 'amber'
+  | 'emerald'
+export const ACCENT_COLOR_STORAGE_KEY = 'super-time-tracker-accent-color'
+export const ACCENT_COLOR_DEFAULT: AccentColor = 'teal'
+export const ACCENT_COLOR_VALUES: AccentColor[] = [
+  'teal',
+  'blue',
+  'violet',
+  'rose',
+  'amber',
+  'emerald',
+]
+
+export type TimerShowSeconds = 'true' | 'false'
+export const TIMER_SHOW_SECONDS_STORAGE_KEY =
+  'super-time-tracker-timer-show-seconds'
+export const TIMER_SHOW_SECONDS_DEFAULT: TimerShowSeconds = 'false'
+
+export type TimerInTitle = 'true' | 'false'
+export const TIMER_IN_TITLE_STORAGE_KEY = 'super-time-tracker-timer-in-title'
+export const TIMER_IN_TITLE_DEFAULT: TimerInTitle = 'true'
+
+export type TagFilterMode = 'all' | 'any'
+export const TAG_FILTER_MODE_STORAGE_KEY = 'super-time-tracker-tag-filter-mode'
+export const TAG_FILTER_MODE_DEFAULT: TagFilterMode = 'all'
+
+export type EntryListSort = 'newest' | 'oldest' | 'duration' | 'description'
+export const ENTRY_LIST_SORT_STORAGE_KEY = 'super-time-tracker-entry-list-sort'
+export const ENTRY_LIST_SORT_DEFAULT: EntryListSort = 'newest'
+
+export type DefaultReportingRange = 'none' | 'today' | 'week'
+export const DEFAULT_REPORTING_RANGE_STORAGE_KEY =
+  'super-time-tracker-default-reporting-range'
+export const DEFAULT_REPORTING_RANGE_DEFAULT: DefaultReportingRange = 'none'
+
+export type ClearTagFiltersOnSheetChange = 'true' | 'false'
+export const CLEAR_TAG_FILTERS_ON_SHEET_CHANGE_STORAGE_KEY =
+  'super-time-tracker-clear-tag-filters-on-sheet-change'
+export const CLEAR_TAG_FILTERS_ON_SHEET_CHANGE_DEFAULT: ClearTagFiltersOnSheetChange =
+  'false'

package/lib/types/ui_settings.ts

@@ -0,0 +1,17 @@
+export const COMPACT_LISTS_STORAGE_KEY = 'super-time-tracker-compact-lists'
+export const SHEET_TAG_FILTERS_STORAGE_KEY = 'super-time-tracker-sheet-tag-filters'
+export const ACTIVE_SHEET_STORAGE_KEY = 'super-time-tracker-active-sheet'
+export const ACTIVE_SHEET_COOKIE_NAME = 'stt-active-sheet'
+
+export type DefaultSheetSessionMode = 'last_viewed' | 'active_timer' | 'fixed'
+
+export const DEFAULT_SHEET_SESSION_MODE_STORAGE_KEY =
+  'super-time-tracker-default-sheet-session-mode'
+export const DEFAULT_SHEET_SESSION_MODE_COOKIE_NAME = 'stt-default-sheet-session-mode'
+
+export const DEFAULT_SHEET_FIXED_NAME_STORAGE_KEY =
+  'super-time-tracker-default-sheet-fixed-name'
+export const DEFAULT_SHEET_FIXED_NAME_COOKIE_NAME = 'stt-default-sheet-fixed-name'
+
+export const DEFAULT_SHEET_SESSION_MODE_DEFAULT: DefaultSheetSessionMode =
+  'last_viewed'

package/lib/ui_preference_store.ts

@@ -0,0 +1,80 @@
+type PreferenceListener = () => void
+
+export interface UiPreferenceStore<T extends string> {
+  storage_key: string
+  default_value: T
+  is_valid: (value: string) => value is T
+  read: () => T
+  write: (value: T) => void
+  subscribe: (listener: PreferenceListener) => () => void
+  notify: () => void
+  get_snapshot: () => T
+  get_server_snapshot: () => T
+}
+
+export interface CreateUiPreferenceStoreArgs<T extends string> {
+  storage_key: string
+  default_value: T
+  is_valid: (value: string) => value is T
+}
+
+/**
+ * Creates a localStorage-backed preference store with subscribe/snapshot helpers.
+ */
+export function create_ui_preference_store<T extends string>(
+  args: CreateUiPreferenceStoreArgs<T>,
+): UiPreferenceStore<T> {
+  const { default_value, is_valid, storage_key } = args
+  const listeners = new Set<PreferenceListener>()
+
+  const read = (): T => {
+    if (typeof window === 'undefined') {
+      return default_value
+    }
+
+    try {
+      const raw = window.localStorage.getItem(storage_key)
+
+      if (raw !== null && is_valid(raw)) {
+        return raw
+      }
+    } catch {
+      // Ignore storage failures.
+    }
+
+    return default_value
+  }
+
+  const write = (value: T): void => {
+    try {
+      window.localStorage.setItem(storage_key, value)
+    } catch {
+      // Ignore storage failures.
+    }
+  }
+
+  const subscribe = (listener: PreferenceListener): (() => void) => {
+    listeners.add(listener)
+    return () => {
+      listeners.delete(listener)
+    }
+  }
+
+  const notify = (): void => {
+    listeners.forEach((listener) => {
+      listener()
+    })
+  }
+
+  return {
+    storage_key,
+    default_value,
+    is_valid,
+    read,
+    write,
+    subscribe,
+    notify,
+    get_snapshot: read,
+    get_server_snapshot: () => default_value,
+  }
+}

package/lib/ui_settings_init_script.ts

@@ -0,0 +1,33 @@
+import { COMPACT_LISTS_STORAGE_KEY } from '@/lib/types/ui_settings'
+import {
+  ACCENT_COLOR_STORAGE_KEY,
+  COLOR_PALETTE_DEFAULT,
+  COLOR_PALETTE_STORAGE_KEY,
+  COLOR_PALETTE_VALUES,
+} from '@/lib/types/ui_preferences'
+
+const accent_to_palette_migration: Record<string, string> = {
+  teal: 'default',
+  blue: 'ocean',
+  violet: 'midnight',
+  rose: 'warm',
+  amber: 'warm',
+  emerald: 'forest',
+}
+
+/**
+ * Inline script that applies UI settings before first paint.
+ */
+export const ui_settings_init_script = `(function(){try{var k=${JSON.stringify(
+  COMPACT_LISTS_STORAGE_KEY,
+)};var s=localStorage.getItem(k);var c=s==='true';document.documentElement.setAttribute('data-compact-lists',c?'true':'false');var pk=${JSON.stringify(
+  COLOR_PALETTE_STORAGE_KEY,
+)};var pv=localStorage.getItem(pk);var palettes=${JSON.stringify(
+  COLOR_PALETTE_VALUES,
+)};var migrate=${JSON.stringify(accent_to_palette_migration)};var ak=${JSON.stringify(
+  ACCENT_COLOR_STORAGE_KEY,
+)};var p=palettes.indexOf(pv)>=0?pv:(migrate[localStorage.getItem(ak)]||${JSON.stringify(
+  COLOR_PALETTE_DEFAULT,
+)});document.documentElement.setAttribute('data-palette',p);if(palettes.indexOf(pv)<0){localStorage.setItem(pk,p)}}catch(e){document.documentElement.setAttribute('data-compact-lists','false');document.documentElement.setAttribute('data-palette',${JSON.stringify(
+  COLOR_PALETTE_DEFAULT,
+)})}})();`

package/lib/use_check_in_form_collapsed.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { check_in_form_collapsed_preference } from '@/lib/preferences/check_in_form_collapsed_preference'
+
+/**
+ * Subscribes to the "collapse check-in form" preference (boolean).
+ */
+export function use_check_in_form_collapsed(): boolean {
+  const value = useSyncExternalStore(
+    check_in_form_collapsed_preference.subscribe,
+    check_in_form_collapsed_preference.get_snapshot,
+    check_in_form_collapsed_preference.get_server_snapshot,
+  )
+
+  return value === 'true'
+}

package/lib/use_clear_tag_filters_on_sheet_change.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { clear_tag_filters_on_sheet_change_preference } from '@/lib/preferences/clear_tag_filters_on_sheet_change_preference'
+
+/**
+ * Subscribes to the clear-tag-filters-on-sheet-change preference.
+ */
+export function use_clear_tag_filters_on_sheet_change(): boolean {
+  const value = useSyncExternalStore(
+    clear_tag_filters_on_sheet_change_preference.subscribe,
+    clear_tag_filters_on_sheet_change_preference.get_snapshot,
+    clear_tag_filters_on_sheet_change_preference.get_server_snapshot,
+  )
+
+  return value === 'true'
+}

package/lib/use_confirm_before_checkout.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { confirm_before_checkout_preference } from '@/lib/preferences/confirm_before_checkout_preference'
+
+/**
+ * Subscribes to the confirm-before-checkout preference (boolean).
+ */
+export function use_confirm_before_checkout(): boolean {
+  const value = useSyncExternalStore(
+    confirm_before_checkout_preference.subscribe,
+    confirm_before_checkout_preference.get_snapshot,
+    confirm_before_checkout_preference.get_server_snapshot,
+  )
+
+  return value === 'true'
+}

package/lib/use_confirm_destructive_actions.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { confirm_destructive_actions_preference } from '@/lib/preferences/confirm_destructive_actions_preference'
+
+/**
+ * Subscribes to the confirm-destructive-actions preference (boolean).
+ */
+export function use_confirm_destructive_actions(): boolean {
+  const value = useSyncExternalStore(
+    confirm_destructive_actions_preference.subscribe,
+    confirm_destructive_actions_preference.get_snapshot,
+    confirm_destructive_actions_preference.get_server_snapshot,
+  )
+
+  return value === 'true'
+}

package/lib/use_duration_format.ts

@@ -0,0 +1,17 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { duration_format_preference } from '@/lib/preferences/duration_format_preference'
+import { type DurationFormat } from '@/lib/types/ui_preferences'
+
+/**
+ * Subscribes to the duration format preference for live updates in client components.
+ */
+export function use_duration_format(): DurationFormat {
+  return useSyncExternalStore(
+    duration_format_preference.subscribe,
+    duration_format_preference.get_snapshot,
+    duration_format_preference.get_server_snapshot,
+  )
+}

package/lib/use_entry_list_sort.ts

@@ -0,0 +1,17 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { entry_list_sort_preference } from '@/lib/preferences/entry_list_sort_preference'
+import { type EntryListSort } from '@/lib/types/ui_preferences'
+
+/**
+ * Subscribes to the entry list sort preference.
+ */
+export function use_entry_list_sort(): EntryListSort {
+  return useSyncExternalStore(
+    entry_list_sort_preference.subscribe,
+    entry_list_sort_preference.get_snapshot,
+    entry_list_sort_preference.get_server_snapshot,
+  )
+}

package/lib/use_tag_filter_mode.ts

@@ -0,0 +1,17 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { tag_filter_mode_preference } from '@/lib/preferences/tag_filter_mode_preference'
+import { type TagFilterMode } from '@/lib/types/ui_preferences'
+
+/**
+ * Subscribes to the tag filter match mode preference.
+ */
+export function use_tag_filter_mode(): TagFilterMode {
+  return useSyncExternalStore(
+    tag_filter_mode_preference.subscribe,
+    tag_filter_mode_preference.get_snapshot,
+    tag_filter_mode_preference.get_server_snapshot,
+  )
+}

package/lib/use_time_format.ts

@@ -0,0 +1,17 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { time_format_preference } from '@/lib/preferences/time_format_preference'
+import { type TimeFormat } from '@/lib/types/ui_preferences'
+
+/**
+ * Subscribes to the time format preference for live updates in client components.
+ */
+export function use_time_format(): TimeFormat {
+  return useSyncExternalStore(
+    time_format_preference.subscribe,
+    time_format_preference.get_snapshot,
+    time_format_preference.get_server_snapshot,
+  )
+}

package/lib/use_timer_in_title.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { timer_in_title_preference } from '@/lib/preferences/timer_in_title_preference'
+
+/**
+ * Subscribes to the timer-in-document-title preference.
+ */
+export function use_timer_in_title(): boolean {
+  const value = useSyncExternalStore(
+    timer_in_title_preference.subscribe,
+    timer_in_title_preference.get_snapshot,
+    timer_in_title_preference.get_server_snapshot,
+  )
+
+  return value === 'true'
+}

package/lib/use_timer_show_seconds.ts

@@ -0,0 +1,18 @@
+'use client'
+
+import { useSyncExternalStore } from 'react'
+
+import { timer_show_seconds_preference } from '@/lib/preferences/timer_show_seconds_preference'
+
+/**
+ * Subscribes to the show-seconds-on-timer preference.
+ */
+export function use_timer_show_seconds(): boolean {
+  const value = useSyncExternalStore(
+    timer_show_seconds_preference.subscribe,
+    timer_show_seconds_preference.get_snapshot,
+    timer_show_seconds_preference.get_server_snapshot,
+  )
+
+  return value === 'true'
+}