@focus8/settings-registry 0.8.3 → 0.8.5

package/src/index.ts

@@ -1,2037 +1,2460 @@
-/**
- * Settings Registry — single source of truth for ALL FocusPlanner app settings.
- *
- * This shared package defines every setting key, its category, data type,
- * default value, and whether it should be synced to the server.
- *
- * Used by:
- *   - The mobile app (local SQLite settings table, React Query hooks)
- *   - The API (validate & serialize settings profiles)
- *   - The web portal (render settings viewer/editor)
- *
- * App-specific defaults (theme, locale, enrolled mode) are parameterized
- * via `createRegistry(config)`.
- */
-
-// ---------------------------------------------------------------------------
-// Setting types shared across mobile, API, and web
-// ---------------------------------------------------------------------------
-
-export type ThemeSetting = 'light' | 'dark' | 'system';
-export type AlarmSound =
-  | 'none'
-  | 'alarm1'
-  | 'alarm2'
-  | 'alarm3'
-  | 'alarm4'
-  | 'alarm5'
-  | 'alarm6'
-  | 'alarm7'
-  | 'alarm8'
-  | 'alarm9';
-export type LocaleCode = 'en' | 'nb';
-
-export type CalendarType = 'chronological' | 'time-based';
-export type ClockType = 'digital' | 'analog';
-export type TimePickerMode = 'dials' | 'keypad';
-export type AlarmTimeout = 1 | 2 | 3 | 5 | 10;
-export const ALARM_TIMEOUTS: AlarmTimeout[] = [1, 2, 3, 5, 10];
-export type CalendarViewMode =
-  | 'day'
-  | '3-days'
-  | '5-days'
-  | '7-days'
-  | 'week'
-  | 'month'
-  | 'overview';
-export type CalendarDayViewCellZoom = 15 | 30 | 60;
-export type InactivityTimeoutMinutes = 1 | 5 | 10 | 15 | 30 | 45;
-export type LockScreenClockDisplay = 'none' | 'digital' | 'analog';
-export type LockScreenImageMode = 'none' | 'background' | 'photoFrame';
-export type PhotoFrameIntervalSeconds = 30 | 60 | 120 | 300;
-export type EventVisibility = 'Public' | 'Private' | 'Custom';
-export type SuggestEndTimeUnit = 'minutes' | 'hours';
-
-export type WeatherLocation = {
-  address: string;
-  name?: string;
-  latitude: number;
-  longitude: number;
-  placeId?: string;
-};
-
-export type LockScreenImage = {
-  uri: string;
-  filePath: string;
-  fileName?: string;
-  fileSize?: number;
-  width?: number;
-  height?: number;
-  order: number;
-};
-
-export const LOCK_SCREEN_MAX_IMAGES = 10;
-
-export type AllDayPreset = {
-  daysBefore: number;
-  time: string;
-};
-
-// ---------------------------------------------------------------------------
-// UI type discriminator — determines which component renders each setting
-// ---------------------------------------------------------------------------
-
-export type SettingUiType =
-  | 'TOGGLE'
-  | 'SELECT'
-  | 'VOLUME_SLIDER'
-  | 'SLIDER'
-  | 'NUMBER_INPUT'
-  | 'TEXT_INPUT'
-  | 'PIN_INPUT'
-  | 'CUSTOM_THEME_PICKER'
-  | 'CUSTOM_LANGUAGE_PICKER'
-  | 'CUSTOM_CALENDAR_TYPE'
-  | 'CUSTOM_CLOCK_TYPE'
-  | 'CUSTOM_WEATHER_LOCATION'
-  | 'CUSTOM_IMAGE'
-  | 'CUSTOM_IMAGE_ARRAY'
-  | 'CUSTOM_CALENDAR_IDS'
-  | 'CUSTOM_REMINDER_PRESETS'
-  | 'CUSTOM_EVENT_FORM'
-  | 'CUSTOM_CHRONOLOGICAL_EVENT_FORM'
-  | 'CUSTOM_DISPLAY_DENSITY'
-  | 'CUSTOM_BRIGHTNESS'
-  | 'CUSTOM_SPLIT_VIEW_CONFIG'
-  | 'HIDDEN';
-
-export type SettingOption<T = unknown> = {
-  /** The option value */
-  value: T;
-  /** i18n message key for the option label */
-  labelKey: string;
-};
-
-export type SliderConfig = {
-  min: number;
-  max: number;
-  step: number;
-};
-
-// ---------------------------------------------------------------------------
-// Setting categories — used for UI grouping and profile organization
-// ---------------------------------------------------------------------------
-
-export const SETTINGS_CATEGORIES = [
-  'appearance',
-  'calendarView',
-  'calendars',
-  'sound',
-  'timer',
-  'media',
-  'lockScreen',
-  'touch',
-  'device',
-  'language',
-  'notification',
-  'chronological',
-  'eventForm',
-  'chronologicalEventForm',
-] as const;
-
-export type SettingsCategory = (typeof SETTINGS_CATEGORIES)[number];
-
-// ---------------------------------------------------------------------------
-// Category display labels — human-readable names for UI rendering
-// ---------------------------------------------------------------------------
-
-export const CATEGORY_LABELS: Record<SettingsCategory, string> = {
-  appearance: 'Appearance',
-  calendarView: 'Calendar View',
-  calendars: 'Calendars',
-  sound: 'Sound & Alerts',
-  timer: 'Timer',
-  media: 'Media',
-  lockScreen: 'Lock Screen',
-  touch: 'Touch & Gestures',
-  device: 'Device',
-  language: 'Language',
-  notification: 'Notifications',
-  chronological: 'Chronological',
-  eventForm: 'Event Form',
-  chronologicalEventForm: 'Event Form (Chronological)',
-};
-
-// ---------------------------------------------------------------------------
-// Category icons — lucide icon names matching the mobile app
-// ---------------------------------------------------------------------------
-
-export const CATEGORY_ICONS: Record<SettingsCategory, string> = {
-  appearance: 'Palette',
-  calendarView: 'Eye',
-  calendars: 'Calendar',
-  sound: 'Volume2',
-  timer: 'Timer',
-  media: 'Images',
-  lockScreen: 'Lock',
-  touch: 'Hand',
-  device: 'Smartphone',
-  language: 'Globe',
-  notification: 'Bell',
-  chronological: 'List',
-  eventForm: 'CalendarPlus',
-  chronologicalEventForm: 'CalendarPlus',
-};
-
-// ---------------------------------------------------------------------------
-// Calendar-type filtering — which categories are exclusive to a calendar type
-// ---------------------------------------------------------------------------
-
-/** Categories only shown for chronological calendar type */
-export const CHRONOLOGICAL_ONLY_CATEGORIES: ReadonlySet<SettingsCategory> =
-  new Set<SettingsCategory>(['chronological', 'chronologicalEventForm']);
-
-/** Categories only shown for time-based calendar type */
-export const TIME_BASED_ONLY_CATEGORIES: ReadonlySet<SettingsCategory> =
-  new Set<SettingsCategory>(['eventForm']);
-
-/**
- * Filter categories based on the active calendar type.
- * Categories not exclusive to either type are always included.
- */
-export function getCategoriesForCalendarType(
-  calendarType: CalendarType,
-): SettingsCategory[] {
-  return SETTINGS_CATEGORIES.filter((cat) => {
-    if (
-      calendarType === 'time-based' &&
-      CHRONOLOGICAL_ONLY_CATEGORIES.has(cat)
-    ) {
-      return false;
-    }
-    if (
-      calendarType === 'chronological' &&
-      TIME_BASED_ONLY_CATEGORIES.has(cat)
-    ) {
-      return false;
-    }
-    return true;
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Settings groups — user-facing groups that reorganize raw categories
-// ---------------------------------------------------------------------------
-
-/**
- * Settings group IDs matching the mobile app's settings menu structure.
- * These provide user-friendly groupings that may pull settings from multiple
- * raw registry categories.
- */
-export const SETTINGS_GROUP_IDS = [
-  // Calendar section
-  'calendarView',
-  'timer',
-  'activities',
-  'dateWeather',
-  'touch',
-  'calendarType',
-  'chronological',
-  // Unit section
-  'appearance',
-  'soundAlerts',
-  'lockScreen',
-  'language',
-  'device',
-] as const;
-
-export type SettingsGroupId = (typeof SETTINGS_GROUP_IDS)[number];
-
-export type SettingsGroupDef = {
-  /** Unique group identifier */
-  id: SettingsGroupId;
-  /** i18n message key for the group label */
-  labelKey: string;
-  /** Lucide icon name */
-  icon: string;
-  /**
-   * Setting key matchers. A setting is included if its key:
-   * - equals a matcher exactly, OR
-   * - starts with a matcher that ends with '.' (prefix match)
-   */
-  keys: string[];
-  /** Only show for this calendar type (undefined = always) */
-  calendarType?: CalendarType;
-  /** Only show for this app mode (undefined = always) */
-  appMode?: 'ENROLLED';
-};
-
-/**
- * Group definitions matching the mobile app's settings structure.
- *
- * ─ i18n keys use the format `Settings.GroupLabel.<Id>` and must exist
- *   in every consumer's i18n catalog.
- */
-export const SETTINGS_GROUPS: readonly SettingsGroupDef[] = [
-  // ── Calendar section ──────────────────────────────────────────────────
-  {
-    id: 'calendarView',
-    labelKey: 'Settings.CalendarView',
-    icon: 'Eye',
-    keys: [
-      'calendarView.showCalendarNames',
-      'calendarView.splitView',
-      'calendarView.dayViewZoom',
-      'calendarView.weekViewZoom',
-      'calendarView.calendarColumns',
-    ],
-  },
-  {
-    id: 'timer',
-    labelKey: 'Settings.TimerTitle',
-    icon: 'Timer',
-    keys: [
-      'chronological.timer.',
-      'timer.',
-      'sound.timerAlarmSound',
-      'sound.timerAlarmTimeout',
-      'sound.timerVolume',
-    ],
-    appMode: 'ENROLLED',
-  },
-  {
-    id: 'activities',
-    labelKey: 'Settings.Activities',
-    icon: 'CalendarPlus',
-    keys: ['eventForm.', 'chronologicalEventForm.'],
-  },
-  {
-    id: 'dateWeather',
-    labelKey: 'Settings.DateWeather',
-    icon: 'CloudSun',
-    keys: [
-      'calendarView.showWeatherOnTimeline',
-      'calendarView.weatherLocation',
-      'calendarView.showWeatherOnEvents',
-    ],
-  },
-  {
-    id: 'touch',
-    labelKey: 'Settings.FunctionsTitle',
-    icon: 'Hand',
-    keys: ['touch.'],
-  },
-  {
-    id: 'calendarType',
-    labelKey: 'Settings.CalendarType',
-    icon: 'ArrowLeftRight',
-    keys: ['calendarView.type'],
-  },
-  {
-    id: 'chronological',
-    labelKey: 'Settings.Chronological',
-    icon: 'List',
-    keys: ['chronological.'],
-    calendarType: 'chronological',
-  },
-  // ── Unit section ──────────────────────────────────────────────────────
-  {
-    id: 'appearance',
-    labelKey: 'Settings.Appearance',
-    icon: 'Palette',
-    keys: [
-      'appearance.theme',
-      'appearance.clockType',
-      'appearance.enableDayColors',
-    ],
-  },
-  {
-    id: 'soundAlerts',
-    labelKey: 'Settings.SoundAlerts',
-    icon: 'Volume2',
-    keys: [
-      'sound.reminderVolume',
-      'sound.mediaVolume',
-      'sound.reminderAlarmSound',
-      'sound.startAlarmSound',
-      'sound.endAlarmSound',
-      'sound.reminderAlarmTimeout',
-      'sound.allowCustomReminderSounds',
-      'notification.',
-      'sound.ttsEnabled',
-      'sound.ttsRate',
-      'sound.alarmSound',
-    ],
-  },
-  {
-    id: 'lockScreen',
-    labelKey: 'Settings.LockScreen',
-    icon: 'Lock',
-    keys: ['lockScreen.'],
-    appMode: 'ENROLLED',
-  },
-  {
-    id: 'language',
-    labelKey: 'Settings.Language',
-    icon: 'Globe',
-    keys: ['language.'],
-  },
-  {
-    id: 'device',
-    labelKey: 'SettingsDevices.Title',
-    icon: 'Smartphone',
-    keys: [
-      'device.',
-      'calendarView.autoReturnToTodayEnabled',
-      'calendarView.autoReturnToTodayTimeoutSeconds',
-    ],
-  },
-] as const;
-
-/**
- * Settings excluded from remote editing (web portal / profile management).
- * These are device-local or internal-only settings.
- */
-export const EXCLUDED_DEVICE_SETTINGS: ReadonlySet<string> = new Set([
-  'device.id',
-  'device.devMenuEnabled',
-  'device.authWarningDismissTtlDays',
-  'notification.enabled',
-  'notification.notifyAllCalendars',
-  'notification.enabledCalendarIds',
-  'notification.hasBeenPrompted',
-]);
-
-// ---------------------------------------------------------------------------
-// Per-setting i18n label / description keys
-// ---------------------------------------------------------------------------
-
-export type SettingLabelDef = {
-  /** i18n message key for the setting label */
-  labelKey: string;
-  /** Optional i18n message key for a description shown below the label */
-  descriptionKey?: string;
-};
-
-/**
- * Maps each setting key to its i18n label and optional description key.
- * These keys must exist in every consumer's i18n catalog.
- *
- * When a key is missing from this map, consumers should fall back to
- * the auto-generated label from `SettingsRegistry.getSettingLabel()`.
- */
-export const SETTINGS_LABELS: Readonly<Record<string, SettingLabelDef>> = {
-  // ── Appearance ──────────────────────────────────────────────────────────
-  'appearance.theme': { labelKey: 'Settings.SelectTheme' },
-  'appearance.clockType': {
-    labelKey: 'Settings.ClockType',
-    descriptionKey: 'Settings.ClockTypeDescription',
-  },
-  'appearance.enableDayColors': {
-    labelKey: 'Settings.EnableDayColors',
-    descriptionKey: 'Settings.EnableDayColorsDescription',
-  },
-
-  // ── Calendar type ───────────────────────────────────────────────────────
-  'calendarView.type': {
-    labelKey: 'Settings.CalendarType',
-    descriptionKey: 'Settings.ModeDescription',
-  },
-  'calendarView.view': { labelKey: 'Settings.Calendar' },
-
-  // ── Calendar view ───────────────────────────────────────────────────────
-  'calendarView.showCalendarNames': { labelKey: 'Settings.ShowCalendarNames' },
-  'calendarView.splitView': {
-    labelKey: 'Settings.SplitViewLabel',
-    descriptionKey: 'Settings.SplitViewDescription',
-  },
-  'calendarView.calendarColumns': {
-    labelKey: 'Settings.SplitViewConfig',
-    descriptionKey: 'Settings.SplitViewConfigDescription',
-  },
-  'calendarView.dayViewZoom': {
-    labelKey: 'Settings.CalendarDayViewIntervalTitle',
-    descriptionKey: 'Settings.CalendarDayViewIntervalDescription',
-  },
-  'calendarView.weekViewZoom': {
-    labelKey: 'Settings.CalendarWeekViewIntervalTitle',
-    descriptionKey: 'Settings.CalendarWeekViewIntervalDescription',
-  },
-
-  // ── Auto return to today ────────────────────────────────────────────────
-  'calendarView.autoReturnToTodayEnabled': {
-    labelKey: 'Settings.AutoReturnToTodayEnabled',
-  },
-  'calendarView.autoReturnToTodayTimeoutSeconds': {
-    labelKey: 'Settings.AutoReturnToTodayTimeout',
-  },
-
-  // ── Weather ─────────────────────────────────────────────────────────────
-  'calendarView.weatherLocation': { labelKey: 'Settings.WeatherLocation' },
-  'calendarView.showWeatherOnEvents': {
-    labelKey: 'Settings.ShowWeatherOnEvents',
-    descriptionKey: 'Settings.ShowWeatherOnEventsDescription',
-  },
-  'calendarView.showWeatherOnTimeline': {
-    labelKey: 'Settings.ShowWeatherOnTimeline',
-    descriptionKey: 'Settings.ShowWeatherOnTimelineDescription',
-  },
-
-  // ── Sound & alerts ──────────────────────────────────────────────────────
-  'sound.reminderVolume': {
-    labelKey: 'Settings.ReminderVolume',
-    descriptionKey: 'Settings.ReminderVolumeDescription',
-  },
-  'sound.timerVolume': {
-    labelKey: 'Settings.TimerVolume',
-    descriptionKey: 'Settings.TimerVolumeDescription',
-  },
-  'sound.mediaVolume': {
-    labelKey: 'Settings.MediaVolume',
-    descriptionKey: 'Settings.MediaVolumeDescription',
-  },
-  'sound.alarmSound': { labelKey: 'Settings.AlarmSound' },
-  'sound.reminderAlarmSound': { labelKey: 'Settings.ReminderAlarmAsset' },
-  'sound.startAlarmSound': { labelKey: 'Settings.StartAlarmSound' },
-  'sound.endAlarmSound': { labelKey: 'Settings.EndAlarmSound' },
-  'sound.reminderAlarmTimeout': { labelKey: 'Settings.ReminderAlarmTimeout' },
-  'sound.timerAlarmSound': { labelKey: 'Settings.TimerAlarmSound' },
-  'sound.timerAlarmTimeout': { labelKey: 'Settings.TimerAlarmTimeout' },
-  'sound.allowCustomReminderSounds': {
-    labelKey: 'Settings.AllowCustomReminderSounds',
-  },
-  'sound.ttsEnabled': {
-    labelKey: 'Settings.EnableSpeech',
-    descriptionKey: 'Settings.EnableSpeechDescription',
-  },
-  'sound.ttsRate': { labelKey: 'Settings.TtsTitle' },
-
-  // ── Timer ───────────────────────────────────────────────────────────────
-  'timer.showTimeRemaining': { labelKey: 'Settings.TimerShowTimeRemaining' },
-  'timer.showEndTime': { labelKey: 'Settings.TimerShowEndTime' },
-  'timer.showRestartButton': { labelKey: 'Settings.TimerShowRestartButton' },
-  'timer.showPauseButton': { labelKey: 'Settings.TimerShowPauseButton' },
-
-  // ── Lock screen ─────────────────────────────────────────────────────────
-  'lockScreen.pin': { labelKey: 'Settings.LockScreenTitlePin' },
-  'lockScreen.clockDisplay': { labelKey: 'Settings.LockScreenClockTitle' },
-  'lockScreen.showDate': { labelKey: 'Settings.LockScreenShowDate' },
-  'lockScreen.showHourNumbers': {
-    labelKey: 'Settings.LockScreenShowHourNumbers',
-  },
-  'lockScreen.imageMode': { labelKey: 'Settings.LockScreenImageModeTitle' },
-  'lockScreen.backgroundImage': {
-    labelKey: 'Settings.LockScreenImageModeBackground',
-  },
-  'lockScreen.photoFrameImages': {
-    labelKey: 'Settings.LockScreenImageModePhotoFrame',
-  },
-  'lockScreen.photoFrameIntervalSeconds': {
-    labelKey: 'Settings.LockScreenPhotoFrameIntervalTitle',
-  },
-  'lockScreen.inactivityLockEnabled': {
-    labelKey: 'SettingsInactivity.EnableLabel',
-  },
-  'lockScreen.inactivityTimeoutMinutes': {
-    labelKey: 'SettingsInactivity.TimeoutLabel',
-  },
-
-  // ── Touch / gestures ───────────────────────────────────────────────────
-  'touch.enableTapToCreate': {
-    labelKey: 'Settings.EnableTapToCreate',
-    descriptionKey: 'Settings.EnableTapToCreateDescription',
-  },
-  'touch.enableDragDrop': {
-    labelKey: 'Settings.EnableDragDrop',
-    descriptionKey: 'Settings.EnableDragDropDescription',
-  },
-
-  // ── Device ──────────────────────────────────────────────────────────────
-  'device.timePickerMode': { labelKey: 'Settings.DateTimeTitle' },
-
-  // ── Language ────────────────────────────────────────────────────────────
-  'language.locale': { labelKey: 'Settings.SelectLanguage' },
-
-  // ── Notifications ───────────────────────────────────────────────────────
-  'notification.enabled': { labelKey: 'Settings.NotificationsEnabled' },
-  'notification.notifyAllCalendars': {
-    labelKey: 'Settings.NotifyAllCalendars',
-  },
-  'notification.enabledCalendarIds': {
-    labelKey: 'Settings.NotificationsCalendars',
-  },
-
-  // ── Chronological header ────────────────────────────────────────────────
-  'chronological.header.showNavigationArrows': {
-    labelKey: 'ChronologicalFeatures.NavigationArrows',
-  },
-  'chronological.header.showClock': {
-    labelKey: 'ChronologicalFeatures.Clock',
-  },
-  'chronological.header.showCurrentYearInDate': {
-    labelKey: 'ChronologicalFeatures.ShowCurrentYear',
-  },
-  'chronological.header.showTimeOfDay': {
-    labelKey: 'ChronologicalFeatures.TimeOfDay',
-  },
-
-  // ── Chronological footer ────────────────────────────────────────────────
-  'chronological.footer.showMenuButton': {
-    labelKey: 'ChronologicalFeatures.MenuButton',
-  },
-  'chronological.footer.showViewSwitcherDay': {
-    labelKey: 'ChronologicalFeatures.ViewSwitcherDay',
-  },
-  'chronological.footer.showViewSwitcherWeek': {
-    labelKey: 'ChronologicalFeatures.ViewSwitcherWeek',
-  },
-  'chronological.footer.showViewSwitcherMonth': {
-    labelKey: 'ChronologicalFeatures.ViewSwitcherMonth',
-  },
-  'chronological.footer.showTimerButton': {
-    labelKey: 'ChronologicalFeatures.TimerButton',
-  },
-  'chronological.footer.showNewEventButton': {
-    labelKey: 'ChronologicalFeatures.NewEventButton',
-  },
-  'chronological.footer.showSettingsButton': {
-    labelKey: 'ChronologicalFeatures.SettingsButton',
-  },
-
-  // ── Chronological timer ─────────────────────────────────────────────────
-  'chronological.timer.showNewCountdown': {
-    labelKey: 'TimerFeatures.ShowNewCountdown',
-  },
-  'chronological.timer.showFromTemplate': {
-    labelKey: 'TimerFeatures.ShowFromTemplate',
-  },
-  'chronological.timer.showEditTemplate': {
-    labelKey: 'TimerFeatures.ShowEditTemplate',
-  },
-  'chronological.timer.showDeleteTemplate': {
-    labelKey: 'TimerFeatures.ShowDeleteTemplate',
-  },
-  'chronological.timer.showAddTemplate': {
-    labelKey: 'TimerFeatures.ShowAddTemplate',
-  },
-
-  // ── Chronological menu ──────────────────────────────────────────────────
-  'chronological.menu.showSettingsButton': {
-    labelKey: 'ChronologicalFeatures.MenuSettingsButton',
-  },
-  'chronological.quickSettings.showTimerVolume': {
-    labelKey: 'ChronologicalFeatures.QuickSettingsTimerVolume',
-  },
-  'chronological.quickSettings.showReminderVolume': {
-    labelKey: 'ChronologicalFeatures.QuickSettingsReminderVolume',
-  },
-  'chronological.quickSettings.showMediaVolume': {
-    labelKey: 'ChronologicalFeatures.QuickSettingsMediaVolume',
-  },
-  'chronological.quickSettings.showBrightness': {
-    labelKey: 'ChronologicalFeatures.QuickSettingsBrightness',
-  },
-  'chronological.quickSettings.showLockScreen': {
-    labelKey: 'ChronologicalFeatures.QuickSettingsLockScreen',
-  },
-
-  // ── Event form (time-based) ─────────────────────────────────────────────
-  'eventForm.recurrence': { labelKey: 'Calendar.LabelRecurrence' },
-  'eventForm.reminders': { labelKey: 'Calendar.LabelReminders' },
-  'eventForm.emailReminders': { labelKey: 'Calendar.LabelEmailReminders' },
-  'eventForm.location': { labelKey: 'Common.Location' },
-  'eventForm.travelTime': { labelKey: 'TravelTime.Title' },
-  'eventForm.description': { labelKey: 'Common.Description' },
-  'eventForm.checklist': { labelKey: 'EventChecklist.DefaultName' },
-  'eventForm.images': { labelKey: 'EventImageGallery.SectionTitle' },
-  'eventForm.audioClips': { labelKey: 'EventAudioGallery.SectionTitle' },
-  'eventForm.notificationReceivers': { labelKey: 'EventForm.NotificationReceivers' },
-  'eventForm.visibility': { labelKey: 'EventVisibility.Title' },
-};
-
-/**
- * Check whether a setting key matches a group's key matchers.
- */
-function matchesGroup(key: string, group: SettingsGroupDef): boolean {
-  return group.keys.some(
-    (matcher) =>
-      key === matcher || (matcher.endsWith('.') && key.startsWith(matcher)),
-  );
-}
-
-/** Return the index of the first matching key pattern in the group, for sorting. */
-function groupKeyIndex(key: string, keys: readonly string[]): number {
-  for (let i = 0; i < keys.length; i++) {
-    const matcher = keys[i];
-    if (key === matcher || (matcher.endsWith('.') && key.startsWith(matcher))) {
-      return i;
-    }
-  }
-  return keys.length;
-}
-
-/**
- * Lazy-initialized map from setting key → declaration index in buildEntries.
- * Used as a tiebreaker when multiple keys share the same prefix group index.
- */
-let _registryKeyOrder: Map<string, number> | undefined;
-function registryKeyOrder(): Map<string, number> {
-  if (!_registryKeyOrder) {
-    _registryKeyOrder = new Map();
-    const keys = Object.keys(buildEntries(DEFAULT_REGISTRY_CONFIG));
-    for (let i = 0; i < keys.length; i++) {
-      _registryKeyOrder.set(keys[i], i);
-    }
-  }
-  return _registryKeyOrder;
-}
-
-/**
- * Group parsed setting entries into user-facing groups matching the mobile
- * app's settings menu structure.
- *
- * Takes a flat list of parsed settings (from `parseSettingsSnapshot`) and
- * buckets them into the standard groups, filtering by calendar type and
- * excluded keys.
- */
-export function groupSettingsForDevice(
-  allSettings: ParsedSettingEntry[],
-  calendarType: CalendarType,
-  appMode?: 'ENROLLED',
-): { id: SettingsGroupId; labelKey: string; icon: string; settings: ParsedSettingEntry[] }[] {
-  // Filter excluded and hidden settings
-  const settings = allSettings.filter(
-    (s) => !EXCLUDED_DEVICE_SETTINGS.has(s.key) && s.uiType !== 'HIDDEN',
-  );
-
-  // Calendar type filtering for event form keys
-  const isChronological = calendarType === 'chronological';
-  const filteredSettings = settings.filter((s) => {
-    if (isChronological && s.key.startsWith('eventForm.')) {
-      return false;
-    }
-    if (!isChronological && s.key.startsWith('chronologicalEventForm.')) {
-      return false;
-    }
-    // Per-setting calendar type restriction
-    if (s.calendarType && s.calendarType !== calendarType) {
-      return false;
-    }
-    // Per-setting app mode restriction
-    if (s.appMode && s.appMode !== appMode) {
-      return false;
-    }
-    return true;
-  });
-
-  const claimed = new Set<string>();
-  const result: {
-    id: SettingsGroupId;
-    labelKey: string;
-    icon: string;
-    settings: ParsedSettingEntry[];
-  }[] = [];
-
-  for (const group of SETTINGS_GROUPS) {
-    // Skip groups not relevant for current calendar type
-    if (group.calendarType && group.calendarType !== calendarType) {
-      continue;
-    }
-
-    // Skip groups not relevant for current app mode
-    if (group.appMode && group.appMode !== appMode) {
-      continue;
-    }
-
-    const matched = filteredSettings.filter(
-      (s) => !claimed.has(s.key) && matchesGroup(s.key, group),
-    );
-    if (matched.length === 0) {
-      continue;
-    }
-
-    // Sort matched settings by the order defined in group.keys,
-    // with registry declaration order as tiebreaker for prefix matches
-    const order = registryKeyOrder();
-    matched.sort((a, b) => {
-      const aIdx = groupKeyIndex(a.key, group.keys);
-      const bIdx = groupKeyIndex(b.key, group.keys);
-      if (aIdx !== bIdx) {
-        return aIdx - bIdx;
-      }
-      return (order.get(a.key) ?? Infinity) - (order.get(b.key) ?? Infinity);
-    });
-
-    for (const s of matched) {
-      claimed.add(s.key);
-    }
-
-    result.push({
-      id: group.id,
-      labelKey: group.labelKey,
-      icon: group.icon,
-      settings: matched,
-    });
-  }
-
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// Data type discriminator — stored alongside each setting in the DB
-// ---------------------------------------------------------------------------
-
-export type SettingsDataType = 'string' | 'number' | 'boolean' | 'json';
-
-// ---------------------------------------------------------------------------
-// Single registry entry definition
-// ---------------------------------------------------------------------------
-
-export type SettingDef<T = unknown> = {
-  category: SettingsCategory;
-  type: SettingsDataType;
-  default: T;
-  /** Whether this setting should be synced to the server. Default true. */
-  sync: boolean;
-  /** UI component type for rendering this setting */
-  uiType: SettingUiType;
-  /** Available options for SELECT-type settings */
-  options?: readonly SettingOption<T>[];
-  /** Slider configuration for SLIDER-type settings */
-  sliderConfig?: SliderConfig;
-  /** Only show this setting for enrolled/kiosk devices (undefined = always) */
-  appMode?: 'ENROLLED';
-  /** Only show this setting for a specific calendar type (undefined = always) */
-  calendarType?: CalendarType;
-};
-
-// ---------------------------------------------------------------------------
-// Configuration for app-specific defaults
-// ---------------------------------------------------------------------------
-
-export type RegistryConfig = {
-  /** Whether the device is in enrolled/kiosk mode */
-  isEnrolled: boolean;
-  /** Default theme code */
-  defaultTheme: ThemeSetting;
-  /** Default locale code */
-  defaultLocale: LocaleCode;
-};
-
-/** Default config for non-enrolled mode */
-export const DEFAULT_REGISTRY_CONFIG: RegistryConfig = {
-  isEnrolled: false,
-  defaultTheme: 'system',
-  defaultLocale: 'nb',
-};
-
-// ---------------------------------------------------------------------------
-// Shared option arrays (reused across multiple settings)
-// ---------------------------------------------------------------------------
-
-const ALARM_SOUND_OPTIONS: readonly SettingOption<AlarmSound>[] = [
-  { value: 'none', labelKey: 'Settings.Option.AlarmSound.None' },
-  { value: 'alarm1', labelKey: 'Settings.Option.AlarmSound.Alarm1' },
-  { value: 'alarm2', labelKey: 'Settings.Option.AlarmSound.Alarm2' },
-  { value: 'alarm3', labelKey: 'Settings.Option.AlarmSound.Alarm3' },
-  { value: 'alarm4', labelKey: 'Settings.Option.AlarmSound.Alarm4' },
-  { value: 'alarm5', labelKey: 'Settings.Option.AlarmSound.Alarm5' },
-  { value: 'alarm6', labelKey: 'Settings.Option.AlarmSound.Alarm6' },
-  { value: 'alarm7', labelKey: 'Settings.Option.AlarmSound.Alarm7' },
-  { value: 'alarm8', labelKey: 'Settings.Option.AlarmSound.Alarm8' },
-  { value: 'alarm9', labelKey: 'Settings.Option.AlarmSound.Alarm9' },
-];
-
-const ALARM_TIMEOUT_OPTIONS: readonly SettingOption<AlarmTimeout>[] = [
-  { value: 1, labelKey: 'Settings.Option.AlarmTimeout.1min' },
-  { value: 2, labelKey: 'Settings.Option.AlarmTimeout.2min' },
-  { value: 3, labelKey: 'Settings.Option.AlarmTimeout.3min' },
-  { value: 5, labelKey: 'Settings.Option.AlarmTimeout.5min' },
-  { value: 10, labelKey: 'Settings.Option.AlarmTimeout.10min' },
-];
-
-const DAY_VIEW_ZOOM_OPTIONS: readonly SettingOption<CalendarDayViewCellZoom>[] = [
-  { value: 15, labelKey: 'Settings.Option.DayViewZoom.15min' },
-  { value: 30, labelKey: 'Settings.Option.DayViewZoom.30min' },
-  { value: 60, labelKey: 'Settings.Option.DayViewZoom.1hour' },
-];
-
-const TIME_OF_DAY_SLIDER: SliderConfig = { min: 0, max: 23, step: 1 };
-
-// ---------------------------------------------------------------------------
-// Helper
-// ---------------------------------------------------------------------------
-
-function def<T>(
-  category: SettingsCategory,
-  type: SettingsDataType,
-  defaultValue: T,
-  uiType: SettingUiType,
-  extra?: {
-    sync?: boolean;
-    options?: readonly SettingOption<T>[];
-    sliderConfig?: SliderConfig;
-    appMode?: 'ENROLLED';
-    calendarType?: CalendarType;
-  },
-): SettingDef<T> {
-  const result: SettingDef<T> = {
-    category,
-    type,
-    default: defaultValue,
-    sync: extra?.sync ?? true,
-    uiType,
-  };
-  if (extra?.options) {
-    result.options = extra.options;
-  }
-  if (extra?.sliderConfig) {
-    result.sliderConfig = extra.sliderConfig;
-  }
-  if (extra?.appMode) {
-    result.appMode = extra.appMode;
-  }
-  if (extra?.calendarType) {
-    result.calendarType = extra.calendarType;
-  }
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// Entry builder (internal — used by SettingsRegistry class and factory)
-// ---------------------------------------------------------------------------
-
-function buildEntries(config: RegistryConfig) {
-  return {
-    // ═══════════════════════════════════════════════════════════════════════
-    // Appearance
-    // ═══════════════════════════════════════════════════════════════════════
-    'appearance.theme': def<ThemeSetting>(
-      'appearance',
-      'string',
-      config.defaultTheme,
-      'CUSTOM_THEME_PICKER',
-      {
-        options: [
-          { value: 'light', labelKey: 'Settings.Option.Theme.Light' },
-          { value: 'dark', labelKey: 'Settings.Option.Theme.Dark' },
-          { value: 'system', labelKey: 'Settings.Option.Theme.System' },
-        ],
-      },
-    ),
-    'appearance.clockType': def<ClockType>(
-      'appearance',
-      'string',
-      'digital',
-      'CUSTOM_CLOCK_TYPE',
-      {
-        options: [
-          { value: 'digital', labelKey: 'Settings.Option.ClockType.Digital' },
-          { value: 'analog', labelKey: 'Settings.Option.ClockType.Analog' },
-        ],
-        appMode: 'ENROLLED',
-      },
-    ),
-    'appearance.enableDayColors': def<boolean>(
-      'appearance',
-      'boolean',
-      false,
-      'TOGGLE',
-      { calendarType: 'chronological' },
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Calendar view
-    // ═══════════════════════════════════════════════════════════════════════
-    'calendarView.type': def<CalendarType>(
-      'calendarView',
-      'string',
-      'time-based',
-      'CUSTOM_CALENDAR_TYPE',
-      {
-        options: [
-          {
-            value: 'chronological',
-            labelKey: 'Settings.Option.CalendarType.Chronological',
-          },
-          {
-            value: 'time-based',
-            labelKey: 'Settings.Option.CalendarType.TimeBased',
-          },
-        ],
-      },
-    ),
-    'calendarView.view': def<CalendarViewMode>(
-      'calendarView',
-      'string',
-      'day',
-      'SELECT',
-      {
-        options: [
-          { value: 'day', labelKey: 'Settings.Option.CalendarView.Day' },
-          {
-            value: '3-days',
-            labelKey: 'Settings.Option.CalendarView.3Days',
-          },
-          {
-            value: '5-days',
-            labelKey: 'Settings.Option.CalendarView.5Days',
-          },
-          {
-            value: '7-days',
-            labelKey: 'Settings.Option.CalendarView.7Days',
-          },
-          { value: 'week', labelKey: 'Settings.Option.CalendarView.Week' },
-          {
-            value: 'month',
-            labelKey: 'Settings.Option.CalendarView.Month',
-          },
-          {
-            value: 'overview',
-            labelKey: 'Settings.Option.CalendarView.Overview',
-          },
-        ],
-      },
-    ),
-    'calendarView.dayViewZoom': def<CalendarDayViewCellZoom>(
-      'calendarView',
-      'number',
-      60,
-      'SELECT',
-      { options: DAY_VIEW_ZOOM_OPTIONS, calendarType: 'time-based' },
-    ),
-    'calendarView.weekViewZoom': def<CalendarDayViewCellZoom>(
-      'calendarView',
-      'number',
-      60,
-      'SELECT',
-      { options: DAY_VIEW_ZOOM_OPTIONS, calendarType: 'time-based' },
-    ),
-    'calendarView.splitView': def<boolean>(
-      'calendarView',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'calendarView.showCalendarNames': def<boolean>(
-      'calendarView',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'calendarView.calendarColumns': def<unknown[]>(
-      'calendarView',
-      'json',
-      [],
-      'CUSTOM_SPLIT_VIEW_CONFIG',
-    ),
-    'calendarView.autoReturnToTodayEnabled': def<boolean>(
-      'calendarView',
-      'boolean',
-      config.isEnrolled,
-      'TOGGLE',
-    ),
-    'calendarView.autoReturnToTodayTimeoutSeconds': def<number>(
-      'calendarView',
-      'number',
-      300,
-      'SLIDER',
-      { sliderConfig: { min: 30, max: 600, step: 30 } },
-    ),
-    'calendarView.showWeatherOnEvents': def<boolean>(
-      'calendarView',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'calendarView.showWeatherOnTimeline': def<boolean>(
-      'calendarView',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'calendarView.weatherLocation': def<WeatherLocation | null>(
-      'calendarView',
-      'json',
-      null,
-      'CUSTOM_WEATHER_LOCATION',
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Event form field visibility (time-based)
-    // ═══════════════════════════════════════════════════════════════════════
-    'eventForm.recurrence': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
-    'eventForm.location': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
-    'eventForm.travelTime': def<boolean>('eventForm', 'boolean', false, 'TOGGLE'),
-    'eventForm.reminders': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
-    'eventForm.emailReminders': def<boolean>('eventForm', 'boolean', false, 'TOGGLE'),
-    'eventForm.description': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
-    'eventForm.checklist': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
-    'eventForm.images': def<boolean>('eventForm', 'boolean', false, 'TOGGLE'),
-    'eventForm.audioClips': def<boolean>('eventForm', 'boolean', false, 'TOGGLE'),
-    'eventForm.notificationReceivers': def<boolean>(
-      'eventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'eventForm.visibility': def<boolean>('eventForm', 'boolean', false, 'TOGGLE'),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Sound & alerts
-    // ═══════════════════════════════════════════════════════════════════════
-    'sound.timerVolume': def<number>('sound', 'number', 0.5, 'VOLUME_SLIDER'),
-    'sound.reminderVolume': def<number>('sound', 'number', 0.5, 'VOLUME_SLIDER', { appMode: 'ENROLLED' }),
-    'sound.mediaVolume': def<number>('sound', 'number', 0.5, 'VOLUME_SLIDER', { appMode: 'ENROLLED' }),
-    'sound.alarmSound': def<AlarmSound>(
-      'sound',
-      'string',
-      'alarm1',
-      'SELECT',
-      { options: ALARM_SOUND_OPTIONS },
-    ),
-    'sound.reminderAlarmSound': def<AlarmSound>(
-      'sound',
-      'string',
-      'alarm1',
-      'SELECT',
-      { options: ALARM_SOUND_OPTIONS },
-    ),
-    'sound.startAlarmSound': def<AlarmSound>(
-      'sound',
-      'string',
-      'none',
-      'SELECT',
-      { options: ALARM_SOUND_OPTIONS, appMode: 'ENROLLED' },
-    ),
-    'sound.endAlarmSound': def<AlarmSound>(
-      'sound',
-      'string',
-      'none',
-      'SELECT',
-      { options: ALARM_SOUND_OPTIONS, appMode: 'ENROLLED' },
-    ),
-    'sound.timerAlarmSound': def<AlarmSound>(
-      'sound',
-      'string',
-      'alarm1',
-      'SELECT',
-      { options: ALARM_SOUND_OPTIONS },
-    ),
-    'sound.timerAlarmTimeout': def<AlarmTimeout>(
-      'sound',
-      'number',
-      3,
-      'SELECT',
-      { options: ALARM_TIMEOUT_OPTIONS },
-    ),
-    'sound.reminderAlarmTimeout': def<AlarmTimeout>(
-      'sound',
-      'number',
-      3,
-      'SELECT',
-      { options: ALARM_TIMEOUT_OPTIONS },
-    ),
-    'sound.allowCustomReminderSounds': def<boolean>(
-      'sound',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'sound.ttsEnabled': def<boolean>(
-      'sound',
-      'boolean',
-      config.isEnrolled,
-      'TOGGLE',
-      { appMode: 'ENROLLED' },
-    ),
-    'sound.ttsRate': def<number>(
-      'sound',
-      'number',
-      1.0,
-      'SLIDER',
-      { sliderConfig: { min: 0.5, max: 2, step: 0.1 }, appMode: 'ENROLLED' },
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Timer
-    // ═══════════════════════════════════════════════════════════════════════
-    'timer.showTimeRemaining': def<boolean>('timer', 'boolean', true, 'TOGGLE'),
-    'timer.showEndTime': def<boolean>('timer', 'boolean', true, 'TOGGLE', { calendarType: 'time-based' }),
-    'timer.showRestartButton': def<boolean>('timer', 'boolean', true, 'TOGGLE'),
-    'timer.showPauseButton': def<boolean>('timer', 'boolean', true, 'TOGGLE', { calendarType: 'time-based' }),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Lock screen
-    // ═══════════════════════════════════════════════════════════════════════
-    'lockScreen.inactivityLockEnabled': def<boolean>(
-      'lockScreen',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'lockScreen.inactivityTimeoutMinutes': def<InactivityTimeoutMinutes>(
-      'lockScreen',
-      'number',
-      5,
-      'SELECT',
-      {
-        options: [
-          { value: 1, labelKey: 'Settings.Option.InactivityTimeout.1min' },
-          { value: 5, labelKey: 'Settings.Option.InactivityTimeout.5min' },
-          { value: 10, labelKey: 'Settings.Option.InactivityTimeout.10min' },
-          { value: 15, labelKey: 'Settings.Option.InactivityTimeout.15min' },
-          { value: 30, labelKey: 'Settings.Option.InactivityTimeout.30min' },
-          { value: 45, labelKey: 'Settings.Option.InactivityTimeout.45min' },
-        ],
-      },
-    ),
-    'lockScreen.pin': def<string>('lockScreen', 'string', '', 'PIN_INPUT'),
-    'lockScreen.clockDisplay': def<LockScreenClockDisplay>(
-      'lockScreen',
-      'string',
-      'digital',
-      'SELECT',
-      {
-        options: [
-          { value: 'none', labelKey: 'Settings.Option.ClockDisplay.None' },
-          {
-            value: 'digital',
-            labelKey: 'Settings.Option.ClockDisplay.Digital',
-          },
-          {
-            value: 'analog',
-            labelKey: 'Settings.Option.ClockDisplay.Analog',
-          },
-        ],
-      },
-    ),
-    'lockScreen.showHourNumbers': def<boolean>(
-      'lockScreen',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'lockScreen.showDate': def<boolean>(
-      'lockScreen',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'lockScreen.imageMode': def<LockScreenImageMode>(
-      'lockScreen',
-      'string',
-      'none',
-      'SELECT',
-      {
-        options: [
-          { value: 'none', labelKey: 'Settings.Option.ImageMode.None' },
-          {
-            value: 'background',
-            labelKey: 'Settings.Option.ImageMode.Background',
-          },
-          {
-            value: 'photoFrame',
-            labelKey: 'Settings.Option.ImageMode.PhotoFrame',
-          },
-        ],
-      },
-    ),
-    'lockScreen.backgroundImage': def<string | null>(
-      'lockScreen',
-      'json',
-      null,
-      'CUSTOM_IMAGE',
-    ),
-    'lockScreen.photoFrameIntervalSeconds': def<PhotoFrameIntervalSeconds>(
-      'lockScreen',
-      'number',
-      60,
-      'SELECT',
-      {
-        options: [
-          { value: 30, labelKey: 'Settings.Option.PhotoFrameInterval.30sec' },
-          { value: 60, labelKey: 'Settings.Option.PhotoFrameInterval.1min' },
-          { value: 120, labelKey: 'Settings.Option.PhotoFrameInterval.2min' },
-          { value: 300, labelKey: 'Settings.Option.PhotoFrameInterval.5min' },
-        ],
-      },
-    ),
-
-    'lockScreen.photoFrameImages': def<LockScreenImage[]>(
-      'lockScreen',
-      'json',
-      [],
-      'CUSTOM_IMAGE_ARRAY',
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Touch / gestures
-    // ═══════════════════════════════════════════════════════════════════════
-    'touch.enableTapToCreate': def<boolean>('touch', 'boolean', false, 'TOGGLE'),
-    'touch.enableDragDrop': def<boolean>('touch', 'boolean', false, 'TOGGLE'),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Device (not synced unless noted)
-    // ═══════════════════════════════════════════════════════════════════════
-    'device.id': def<string>('device', 'string', '', 'HIDDEN', { sync: false }),
-    'device.timePickerMode': def<TimePickerMode>(
-      'device',
-      'string',
-      'dials',
-      'SELECT',
-      {
-        options: [
-          { value: 'dials', labelKey: 'Settings.Option.TimePickerMode.Dials' },
-          {
-            value: 'keypad',
-            labelKey: 'Settings.Option.TimePickerMode.Keypad',
-          },
-        ],
-      },
-    ),
-    'device.devMenuEnabled': def<boolean>(
-      'device',
-      'boolean',
-      false,
-      'HIDDEN',
-      { sync: false },
-    ),
-    'device.authWarningDismissTtlDays': def<number>(
-      'device',
-      'number',
-      3,
-      'HIDDEN',
-      { sync: false },
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Language
-    // ═══════════════════════════════════════════════════════════════════════
-    'language.locale': def<LocaleCode>(
-      'language',
-      'string',
-      config.defaultLocale,
-      'CUSTOM_LANGUAGE_PICKER',
-      {
-        options: [
-          { value: 'nb', labelKey: 'Settings.Option.Language.Norwegian' },
-          { value: 'en', labelKey: 'Settings.Option.Language.English' },
-        ],
-      },
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Notifications
-    // ═══════════════════════════════════════════════════════════════════════
-    'notification.enabled': def<boolean>(
-      'notification',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'notification.notifyAllCalendars': def<boolean>(
-      'notification',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'notification.enabledCalendarIds': def<string[]>(
-      'notification',
-      'json',
-      [],
-      'CUSTOM_CALENDAR_IDS',
-    ),
-    'notification.hasBeenPrompted': def<boolean>(
-      'notification',
-      'boolean',
-      false,
-      'HIDDEN',
-      { sync: false },
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Chronological features (header, footer, menu, quick settings, timer)
-    // ═══════════════════════════════════════════════════════════════════════
-    // Header
-    'chronological.header.showNavigationArrows': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.header.showCurrentYearInDate': def<boolean>(
-      'chronological',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'chronological.header.showClock': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.header.showTimeOfDay': def<boolean>(
-      'chronological',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    // Footer
-    'chronological.footer.showMenuButton': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.footer.showViewSwitcherDay': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.footer.showViewSwitcherWeek': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.footer.showViewSwitcherMonth': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.footer.showTimerButton': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.footer.showNewEventButton': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.footer.showNowButton': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.footer.showSettingsButton': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    // Timer features
-    'chronological.timer.showNewCountdown': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.timer.showFromTemplate': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.timer.showAddTemplate': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.timer.showEditTemplate': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.timer.showDeleteTemplate': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    // Menu
-    'chronological.menu.showSettingsButton': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    // Quick settings
-    'chronological.quickSettings.showTimerVolume': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.quickSettings.showReminderVolume': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.quickSettings.showMediaVolume': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.quickSettings.showBrightness': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronological.quickSettings.showLockScreen': def<boolean>(
-      'chronological',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    // Time-of-day periods
-    'chronological.timeOfDay.morningStart': def<number>(
-      'chronological',
-      'number',
-      6,
-      'SLIDER',
-      { sliderConfig: TIME_OF_DAY_SLIDER },
-    ),
-    'chronological.timeOfDay.forenoonStart': def<number>(
-      'chronological',
-      'number',
-      9,
-      'SLIDER',
-      { sliderConfig: TIME_OF_DAY_SLIDER },
-    ),
-    'chronological.timeOfDay.afternoonStart': def<number>(
-      'chronological',
-      'number',
-      12,
-      'SLIDER',
-      { sliderConfig: TIME_OF_DAY_SLIDER },
-    ),
-    'chronological.timeOfDay.eveningStart': def<number>(
-      'chronological',
-      'number',
-      18,
-      'SLIDER',
-      { sliderConfig: TIME_OF_DAY_SLIDER },
-    ),
-    'chronological.timeOfDay.nightStart': def<number>(
-      'chronological',
-      'number',
-      0,
-      'SLIDER',
-      { sliderConfig: TIME_OF_DAY_SLIDER },
-    ),
-
-    // ═══════════════════════════════════════════════════════════════════════
-    // Chronological event form
-    // ═══════════════════════════════════════════════════════════════════════
-    // Fixed fields
-    'chronologicalEventForm.fixedField.allDay': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.fixedField.endTime': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.fixedField.alarm': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.fixedField.visibility': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    // Toggleable fields
-    'chronologicalEventForm.field.acknowledge': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.field.description': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.field.recurrence': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.field.checklist': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.field.extraImages': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.field.reminders': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.field.audioClips': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      true,
-      'TOGGLE',
-    ),
-    // Suggest end time
-    'chronologicalEventForm.suggestEndTime.enabled': def<boolean>(
-      'chronologicalEventForm',
-      'boolean',
-      false,
-      'TOGGLE',
-    ),
-    'chronologicalEventForm.suggestEndTime.value': def<number>(
-      'chronologicalEventForm',
-      'number',
-      30,
-      'SLIDER',
-      { sliderConfig: { min: 5, max: 480, step: 5 } },
-    ),
-    'chronologicalEventForm.suggestEndTime.unit': def<SuggestEndTimeUnit>(
-      'chronologicalEventForm',
-      'string',
-      'minutes',
-      'SELECT',
-      {
-        options: [
-          {
-            value: 'minutes',
-            labelKey: 'Settings.Option.SuggestEndTimeUnit.Minutes',
-          },
-          {
-            value: 'hours',
-            labelKey: 'Settings.Option.SuggestEndTimeUnit.Hours',
-          },
-        ],
-      },
-    ),
-    // Default visibility
-    'chronologicalEventForm.defaultVisibility': def<EventVisibility>(
-      'chronologicalEventForm',
-      'string',
-      'Private',
-      'SELECT',
-      {
-        options: [
-          { value: 'Public', labelKey: 'Settings.Option.Visibility.Public' },
-          { value: 'Private', labelKey: 'Settings.Option.Visibility.Private' },
-          { value: 'Custom', labelKey: 'Settings.Option.Visibility.Custom' },
-        ],
-      },
-    ),
-    // Reminder presets
-    'chronologicalEventForm.reminderPresets.timed': def<number[]>(
-      'chronologicalEventForm',
-      'json',
-      [5, 15, 30, 60, 120, 1440],
-      'CUSTOM_REMINDER_PRESETS',
-    ),
-    'chronologicalEventForm.reminderPresets.allDay': def<AllDayPreset[]>(
-      'chronologicalEventForm',
-      'json',
-      [
-        { daysBefore: 0, time: '09:00' },
-        { daysBefore: 1, time: '18:00' },
-        { daysBefore: 2, time: '09:00' },
-      ],
-      'CUSTOM_REMINDER_PRESETS',
-    ),
-  } as const satisfies Record<string, SettingDef>;
-}
-
-// ---------------------------------------------------------------------------
-// Derived types (based on entry shape — all configs produce the same keys)
-// ---------------------------------------------------------------------------
-
-type SettingsEntries = ReturnType<typeof buildEntries>;
-
-/** Union type of every valid setting key */
-export type SettingKey = keyof SettingsEntries;
-
-/** Type-safe value type for a given setting key */
-export type SettingValue<K extends SettingKey> = SettingsEntries[K]['default'];
-
-/** Complete settings map — all keys resolved to their value types */
-export type SettingsMap = {
-  [K in SettingKey]: SettingValue<K>;
-};
-
-// ---------------------------------------------------------------------------
-// Registry class
-// ---------------------------------------------------------------------------
-
-export class SettingsRegistry {
-  /** The raw setting definitions (category, type, default, sync) */
-  readonly entries: SettingsEntries;
-
-  /** All setting keys as an array */
-  readonly keys: SettingKey[];
-
-  constructor(config: Partial<RegistryConfig> = {}) {
-    const full: RegistryConfig = { ...DEFAULT_REGISTRY_CONFIG, ...config };
-    this.entries = buildEntries(full);
-    this.keys = Object.keys(this.entries) as SettingKey[];
-  }
-
-  /** Get the default value for a setting */
-  getDefault<K extends SettingKey>(key: K): SettingValue<K> {
-    return this.entries[key].default as SettingValue<K>;
-  }
-
-  /** Get a complete map of all default values */
-  getAllDefaults(): SettingsMap {
-    const defaults = {} as Record<string, unknown>;
-    for (const key of this.keys) {
-      defaults[key] = this.entries[key].default;
-    }
-    return defaults as SettingsMap;
-  }
-
-  /** Get the data type for a setting key */
-  getDataType(key: SettingKey): SettingsDataType {
-    return this.entries[key].type;
-  }
-
-  /** Check whether a setting should be synced */
-  isSynced(key: SettingKey): boolean {
-    return this.entries[key].sync;
-  }
-
-  /** Get all setting keys for a category */
-  getByCategory(category: SettingsCategory): SettingKey[] {
-    return this.keys.filter((key) => this.entries[key].category === category);
-  }
-
-  /** Serialize a setting value to a string for DB storage */
-  serialize(key: SettingKey, value: unknown): string {
-    const dataType = this.getDataType(key);
-    switch (dataType) {
-      case 'string':
-        return String(value ?? '');
-      case 'number':
-        return String(value ?? 0);
-      case 'boolean':
-        if (typeof value === 'string') {
-          return value === 'true' ? 'true' : 'false';
-        }
-        return value ? 'true' : 'false';
-      case 'json':
-        // If already a serialized JSON string, return as-is to avoid
-        // double-wrapping (e.g. JSON.stringify("[]") → "\"[]\"")
-        if (typeof value === 'string') {
-          try {
-            JSON.parse(value);
-            return value;
-          } catch {
-            return JSON.stringify(value);
-          }
-        }
-        return JSON.stringify(value);
-    }
-  }
-
-  /** Deserialize a DB string back to a typed setting value */
-  deserialize<K extends SettingKey>(
-    key: K,
-    raw: string | null,
-  ): SettingValue<K> {
-    if (raw === null || raw === undefined) {
-      return this.getDefault(key);
-    }
-
-    const dataType = this.getDataType(key);
-    switch (dataType) {
-      case 'string':
-        return raw as SettingValue<K>;
-      case 'number':
-        return Number(raw) as SettingValue<K>;
-      case 'boolean':
-        return (raw === 'true') as SettingValue<K>;
-      case 'json':
-        try {
-          let result: unknown = JSON.parse(raw);
-          // Unwrap multiply-escaped JSON strings caused by repeated
-          // double-serialization (each push/pull cycle added a layer)
-          while (typeof result === 'string') {
-            try {
-              result = JSON.parse(result);
-            } catch {
-              break;
-            }
-          }
-          return result as SettingValue<K>;
-        } catch {
-          return this.getDefault(key);
-        }
-    }
-  }
-
-  /**
-   * Get the category for a setting key.
-   * Returns undefined if the key is not recognized.
-   */
-  getCategory(key: string): SettingsCategory | undefined {
-    if (key in this.entries) {
-      return this.entries[key as SettingKey].category;
-    }
-    // Fallback: extract category from dot-prefix
-    const dotIndex = key.indexOf('.');
-    if (dotIndex > 0) {
-      const prefix = key.substring(0, dotIndex);
-      if (SETTINGS_CATEGORIES.includes(prefix as SettingsCategory)) {
-        return prefix as SettingsCategory;
-      }
-    }
-    return undefined;
-  }
-
-  /**
-   * Get a human-readable label for a setting key.
-   * Strips the category prefix and formats the remaining path.
-   * Example: 'lockScreen.inactivityTimeoutMinutes' → 'Inactivity Timeout Minutes'
-   */
-  getSettingLabel(key: string): string {
-    const dotIndex = key.indexOf('.');
-    const name = dotIndex > 0 ? key.substring(dotIndex + 1) : key;
-    // Convert camelCase / dot-separated path to Title Case words
-    return name
-      .replace(/\./g, ' › ')
-      .replace(/([a-z])([A-Z])/g, '$1 $2')
-      .replace(/^./, (c) => c.toUpperCase());
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Snapshot parsing — parse a JSON settings snapshot into categorized groups
-// ---------------------------------------------------------------------------
-
-export type ParsedSettingEntry = {
-  /** The full setting key (e.g. 'lockScreen.inactivityTimeoutMinutes') */
-  key: string;
-  /** The setting name without category prefix (e.g. 'inactivityTimeoutMinutes') */
-  name: string;
-  /** Human-readable label (e.g. 'Inactivity Timeout Minutes') */
-  label: string;
-  /** i18n message key for the label (from SETTINGS_LABELS) */
-  labelKey?: string;
-  /** i18n message key for a description (from SETTINGS_LABELS) */
-  descriptionKey?: string;
-  /** The setting value */
-  value: unknown;
-  /** UI component type for rendering this setting */
-  uiType: SettingUiType;
-  /** Available options for SELECT-type settings */
-  options?: readonly SettingOption[];
-  /** Slider configuration for SLIDER-type settings */
-  sliderConfig?: SliderConfig;
-  /** Only show this setting for enrolled/kiosk devices (undefined = always) */
-  appMode?: 'ENROLLED';
-  /** Only show this setting for a specific calendar type (undefined = always) */
-  calendarType?: CalendarType;
-};
-
-export type ParsedSettingsGroup = {
-  /** The category key */
-  category: SettingsCategory;
-  /** Human-readable category label */
-  label: string;
-  /** Settings in this category */
-  settings: ParsedSettingEntry[];
-};
-
-/**
- * Parse a settings JSON snapshot into categorized groups, optionally filtered
- * by calendar type. This is the single function both web and mobile should use
- * to display a settings snapshot.
- *
- * @param json The raw JSON string from the settings snapshot
- * @param calendarType Optional calendar type filter — hides irrelevant categories
- * @param registry Optional registry instance (uses defaultRegistry if omitted)
- */
-export function parseSettingsSnapshot(
-  json: string | Record<string, unknown>,
-  calendarType?: CalendarType,
-  registry: SettingsRegistry = defaultRegistry,
-): ParsedSettingsGroup[] {
-  let parsed: Record<string, unknown>;
-  if (typeof json === 'string') {
-    try {
-      parsed = JSON.parse(json);
-    } catch {
-      return [];
-    }
-  } else {
-    parsed = json;
-  }
-
-  const groups = new Map<SettingsCategory, ParsedSettingEntry[]>();
-
-  for (const [key, rawValue] of Object.entries(parsed)) {
-    const category = registry.getCategory(key);
-    if (!category) {
-      continue;
-    }
-
-    // Deserialize string values to their native types using the registry
-    let value: unknown = rawValue;
-    if (typeof rawValue === 'string' && key in registry.entries) {
-      value = registry.deserialize(key as SettingKey, rawValue);
-    }
-
-    const dotIndex = key.indexOf('.');
-    const name = dotIndex > 0 ? key.substring(dotIndex + 1) : key;
-
-    if (!groups.has(category)) {
-      groups.set(category, []);
-    }
-
-    const labelDef = SETTINGS_LABELS[key];
-    const entryDef = key in registry.entries
-      ? registry.entries[key as SettingKey]
-      : undefined;
-    groups.get(category)!.push({
-      key,
-      name,
-      label: registry.getSettingLabel(key),
-      labelKey: labelDef?.labelKey,
-      descriptionKey: labelDef?.descriptionKey,
-      value,
-      uiType: entryDef?.uiType ?? 'TEXT_INPUT',
-      ...(entryDef?.options && { options: entryDef.options as readonly SettingOption[] }),
-      ...(entryDef?.sliderConfig && { sliderConfig: entryDef.sliderConfig }),
-      ...(entryDef?.appMode && { appMode: entryDef.appMode }),
-      ...(entryDef?.calendarType && { calendarType: entryDef.calendarType }),
-    });
-  }
-
-  // Determine which categories to show
-  const allowedCategories = calendarType
-    ? getCategoriesForCalendarType(calendarType)
-    : [...SETTINGS_CATEGORIES];
-
-  return allowedCategories
-    .filter((cat) => groups.has(cat))
-    .map((category) => ({
-      category,
-      label: CATEGORY_LABELS[category],
-      settings: groups.get(category)!,
-    }));
-}
-
-/**
- * Format a setting value for display.
- * Handles booleans, numbers, strings, arrays, objects, and null/undefined.
- */
-export function formatSettingValue(value: unknown): string {
-  if (value === null || value === undefined) {
-    return '—';
-  }
-  if (typeof value === 'boolean') {
-    return value ? 'true' : 'false';
-  }
-  if (typeof value === 'number') {
-    return String(value);
-  }
-  if (typeof value === 'string') {
-    return value || '""';
-  }
-  if (Array.isArray(value)) {
-    return `[${value.length} items]`;
-  }
-  if (typeof value === 'object') {
-    return JSON.stringify(value);
-  }
-  return String(value);
-}
-
-/**
- * Serialize a settings object (with mixed native types) into a
- * string-values-only snapshot suitable for pushing to a mobile device.
- *
- * Uses the registry's `serialize()` method for known keys so that
- * booleans become "true"/"false", numbers become digit strings, etc.
- * Unknown keys are converted with `String(value)`.
- */
-export function serializeSettingsSnapshot(
-  settings: Record<string, unknown>,
-  registry: SettingsRegistry,
-): Record<string, string> {
-  const result: Record<string, string> = {};
-  for (const [key, value] of Object.entries(settings)) {
-    if (key in registry.entries) {
-      result[key] = registry.serialize(key as SettingKey, value);
-    } else {
-      result[key] = String(value ?? '');
-    }
-  }
-  return result;
-}
-
-/**
- * Deserialize a settings snapshot (string values from the server/DB) into
- * native-typed values using the registry.
- *
- * This ensures local state always contains native types (boolean, number, etc.)
- * so that subsequent `serializeSettingsSnapshot` calls produce correct results.
- */
-export function deserializeSettingsSnapshot(
-  snapshot: Record<string, unknown>,
-  registry: SettingsRegistry = defaultRegistry,
-): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-  for (const [key, value] of Object.entries(snapshot)) {
-    if (typeof value === 'string' && key in registry.entries) {
-      result[key] = registry.deserialize(key as SettingKey, value);
-    } else {
-      result[key] = value;
-    }
-  }
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// Default registry instance (non-enrolled, system theme, nb locale)
-// ---------------------------------------------------------------------------
-
-export const defaultRegistry = new SettingsRegistry();
-
-// ---------------------------------------------------------------------------
-// Factory function — returns raw entry map for local type derivation.
-// Consumers that need precise generic inference (e.g. useQuery<K>) can use
-// this to anchor types on a local const variable.
-// ---------------------------------------------------------------------------
-
-export function createSettingsRegistry(config: Partial<RegistryConfig> = {}) {
-  return buildEntries({ ...DEFAULT_REGISTRY_CONFIG, ...config });
-}
+/**
+ * Settings Registry — single source of truth for ALL FocusPlanner app settings.
+ *
+ * This shared package defines every setting key, its category, data type,
+ * default value, and whether it should be synced to the server.
+ *
+ * Used by:
+ *   - The mobile app (local SQLite settings table, React Query hooks)
+ *   - The API (validate & serialize settings profiles)
+ *   - The web portal (render settings viewer/editor)
+ *
+ * App-specific defaults (theme, locale, enrolled mode) are parameterized
+ * via `createRegistry(config)`.
+ */
+
+// ---------------------------------------------------------------------------
+// Setting types shared across mobile, API, and web
+// ---------------------------------------------------------------------------
+
+export type ThemeSetting = 'light' | 'dark' | 'system';
+export type AlarmSound =
+  | 'none'
+  | 'alarm1'
+  | 'alarm2'
+  | 'alarm3'
+  | 'alarm4'
+  | 'alarm5'
+  | 'alarm6'
+  | 'alarm7'
+  | 'alarm8'
+  | 'alarm9';
+export type LocaleCode = 'en' | 'nb';
+
+export type CalendarType = 'chronological' | 'time-based';
+export type ClockType = 'digital' | 'analog';
+export type TimePickerMode = 'dials' | 'keypad';
+export type AlarmTimeout = 5 | 30 | 60 | 120 | 180 | 300 | 600;
+export const ALARM_TIMEOUTS: AlarmTimeout[] = [5, 30, 60, 120, 180, 300, 600];
+export type CalendarViewMode =
+  | 'day'
+  | '3-days'
+  | '5-days'
+  | '7-days'
+  | 'week'
+  | 'month'
+  | 'overview';
+export type CalendarDayViewCellZoom = 15 | 30 | 60;
+export type InactivityTimeoutMinutes = 1 | 5 | 10 | 15 | 30 | 45;
+export type LockScreenClockDisplay = 'none' | 'digital' | 'analog';
+export type LockScreenImageMode = 'none' | 'background' | 'photoFrame';
+export type PhotoFrameIntervalSeconds = 30 | 60 | 120 | 300;
+export type EventVisibility = 'Public' | 'Private' | 'Custom';
+export type SuggestEndTimeUnit = 'minutes' | 'hours';
+export type ChronologicalDayViewDisplayMode = 'list' | 'timeline';
+
+export type WeatherLocation = {
+  address: string;
+  name?: string;
+  latitude: number;
+  longitude: number;
+  placeId?: string;
+};
+
+export type LockScreenImage = {
+  uri: string;
+  filePath: string;
+  fileName?: string;
+  fileSize?: number;
+  width?: number;
+  height?: number;
+  order: number;
+};
+
+export const LOCK_SCREEN_MAX_IMAGES = 10;
+
+export type AllDayPreset = {
+  daysBefore: number;
+  time: string;
+};
+
+// ---------------------------------------------------------------------------
+// UI type discriminator — determines which component renders each setting
+// ---------------------------------------------------------------------------
+
+export type SettingUiType =
+  | 'TOGGLE'
+  | 'SELECT'
+  | 'VOLUME_SLIDER'
+  | 'SLIDER'
+  | 'NUMBER_INPUT'
+  | 'TEXT_INPUT'
+  | 'PIN_INPUT'
+  | 'CUSTOM_THEME_PICKER'
+  | 'CUSTOM_LANGUAGE_PICKER'
+  | 'CUSTOM_CALENDAR_TYPE'
+  | 'CUSTOM_CLOCK_TYPE'
+  | 'CUSTOM_WEATHER_LOCATION'
+  | 'CUSTOM_IMAGE'
+  | 'CUSTOM_IMAGE_ARRAY'
+  | 'CUSTOM_CALENDAR_IDS'
+  | 'CUSTOM_REMINDER_PRESETS'
+  | 'CUSTOM_EVENT_FORM'
+  | 'CUSTOM_CHRONOLOGICAL_EVENT_FORM'
+  | 'CUSTOM_DISPLAY_DENSITY'
+  | 'CUSTOM_BRIGHTNESS'
+  | 'CUSTOM_SPLIT_VIEW_CONFIG'
+  | 'CUSTOM_EVENT_CATEGORIES'
+  | 'HIDDEN';
+
+export type SettingOption<T = unknown> = {
+  /** The option value */
+  value: T;
+  /** i18n message key for the option label */
+  labelKey: string;
+  /** Optional values to pass to the i18n message formatter */
+  labelValues?: Record<string, unknown>;
+};
+
+export type SliderConfig = {
+  min: number;
+  max: number;
+  step: number;
+};
+
+// ---------------------------------------------------------------------------
+// Visibility & disabled conditions — declarative rules for conditional display
+// ---------------------------------------------------------------------------
+
+export type VisibilityCondition =
+  | { dependsOn: string; equals: unknown }
+  | { dependsOn: string; notEquals: unknown }
+  | { dependsOn: string; isTruthy: true };
+
+/** Single condition or array of conditions (all must be true = AND). */
+export type VisibilityRule = VisibilityCondition | VisibilityCondition[];
+
+/** Alias — same shape, controls interactivity instead of visibility. */
+export type DisabledRule = VisibilityCondition | VisibilityCondition[];
+
+/**
+ * Evaluate a visibility/disabled rule against current setting values.
+ * Returns `true` if the setting should be visible (or disabled, depending on usage).
+ * `undefined` rule = always true (no restriction).
+ */
+export function evaluateVisibility(
+  rule: VisibilityRule | undefined,
+  getValue: (key: string) => unknown,
+): boolean {
+  if (!rule) return true;
+  const conditions: VisibilityCondition[] = Array.isArray(rule) ? rule : [rule];
+  return conditions.every((c) => {
+    const value = getValue(c.dependsOn);
+    if ('equals' in c) return value === c.equals;
+    if ('notEquals' in c) return value !== c.notEquals;
+    if ('isTruthy' in c) return !!value;
+    return true;
+  });
+}
+
+/** Convenience: returns true when the setting should be disabled. */
+export function evaluateDisabled(
+  rule: DisabledRule | undefined,
+  getValue: (key: string) => unknown,
+): boolean {
+  if (!rule) return false;
+  return evaluateVisibility(rule, getValue);
+}
+
+// ---------------------------------------------------------------------------
+// Setting categories — used for UI grouping and profile organization
+// ---------------------------------------------------------------------------
+
+export const SETTINGS_CATEGORIES = [
+  'appearance',
+  'calendarView',
+  'calendars',
+  'sound',
+  'timer',
+  'media',
+  'lockScreen',
+  'touch',
+  'device',
+  'language',
+  'notification',
+  'chronological',
+  'eventForm',
+  'chronologicalEventForm',
+] as const;
+
+export type SettingsCategory = (typeof SETTINGS_CATEGORIES)[number];
+
+// ---------------------------------------------------------------------------
+// Category display labels — human-readable names for UI rendering
+// ---------------------------------------------------------------------------
+
+export const CATEGORY_LABELS: Record<SettingsCategory, string> = {
+  appearance: 'Appearance',
+  calendarView: 'Calendar View',
+  calendars: 'Calendars',
+  sound: 'Sound & Alerts',
+  timer: 'Timer',
+  media: 'Media',
+  lockScreen: 'Lock Screen',
+  touch: 'Touch & Gestures',
+  device: 'Device',
+  language: 'Language',
+  notification: 'Notifications',
+  chronological: 'Chronological',
+  eventForm: 'Event Form',
+  chronologicalEventForm: 'Event Form (Chronological)',
+};
+
+// ---------------------------------------------------------------------------
+// Category icons — lucide icon names matching the mobile app
+// ---------------------------------------------------------------------------
+
+export const CATEGORY_ICONS: Record<SettingsCategory, string> = {
+  appearance: 'Palette',
+  calendarView: 'Eye',
+  calendars: 'Calendar',
+  sound: 'Volume2',
+  timer: 'Timer',
+  media: 'Images',
+  lockScreen: 'Lock',
+  touch: 'Hand',
+  device: 'Smartphone',
+  language: 'Globe',
+  notification: 'Bell',
+  chronological: 'List',
+  eventForm: 'CalendarPlus',
+  chronologicalEventForm: 'CalendarPlus',
+};
+
+// ---------------------------------------------------------------------------
+// Calendar-type filtering — which categories are exclusive to a calendar type
+// ---------------------------------------------------------------------------
+
+/** Categories only shown for chronological calendar type */
+export const CHRONOLOGICAL_ONLY_CATEGORIES: ReadonlySet<SettingsCategory> =
+  new Set<SettingsCategory>(['chronological', 'chronologicalEventForm']);
+
+/** Categories only shown for time-based calendar type */
+export const TIME_BASED_ONLY_CATEGORIES: ReadonlySet<SettingsCategory> =
+  new Set<SettingsCategory>(['eventForm']);
+
+/**
+ * Filter categories based on the active calendar type.
+ * Categories not exclusive to either type are always included.
+ */
+export function getCategoriesForCalendarType(
+  calendarType: CalendarType,
+): SettingsCategory[] {
+  return SETTINGS_CATEGORIES.filter((cat) => {
+    if (
+      calendarType === 'time-based' &&
+      CHRONOLOGICAL_ONLY_CATEGORIES.has(cat)
+    ) {
+      return false;
+    }
+    if (
+      calendarType === 'chronological' &&
+      TIME_BASED_ONLY_CATEGORIES.has(cat)
+    ) {
+      return false;
+    }
+    return true;
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Settings sections — top-level groupings (e.g. "Kalender", "Enhet")
+// ---------------------------------------------------------------------------
+
+export const SETTINGS_SECTION_IDS = ['calendar', 'unit'] as const;
+export type SettingsSectionId = (typeof SETTINGS_SECTION_IDS)[number];
+
+export type SettingsSectionDef = {
+  id: SettingsSectionId;
+  labelKey: string;
+};
+
+export const SETTINGS_SECTIONS: readonly SettingsSectionDef[] = [
+  { id: 'calendar', labelKey: 'Calendar.LabelCalendar' },
+  { id: 'unit', labelKey: 'Settings.Unit' },
+];
+
+// ---------------------------------------------------------------------------
+// Settings menu items — ordered list of all items in the settings menu
+// ---------------------------------------------------------------------------
+
+export const SETTINGS_MENU_ITEM_IDS = [
+  // Calendar section
+  'calendarView',
+  'calendars',
+  'eventCategories',
+  'notification',
+  'timer',
+  'guests',
+  'eventForm',
+  'chronologicalEventForm',
+  'weather',
+  'gallery',
+  'audioClips',
+  'gestures',
+  'calendarType',
+  'sharing',
+  // Unit section
+  'screen',
+  'volume',
+  'lockScreen',
+  'language',
+  'wifi',
+  'devices',
+  'profiles',
+  'tts',
+  'updates',
+  'about',
+  'help',
+  'dev',
+  // Account (rendered separately)
+  'account',
+  'activityLog',
+] as const;
+
+export type SettingsMenuItemId = (typeof SETTINGS_MENU_ITEM_IDS)[number];
+
+export type SettingsMenuItemDef = {
+  id: SettingsMenuItemId;
+  labelKey: string;
+  icon: string;
+  section: SettingsSectionId | 'account';
+  /** Screen/page identifiers rendered for this menu item */
+  screens: string[];
+  /**
+   * Setting key matchers for remote editing (web portal / profile editor).
+   * A setting is included if its key equals a matcher exactly, or starts
+   * with a matcher that ends with '.' (prefix match).
+   * Items without keys are navigation-only (e.g. gallery, guests).
+   */
+  keys?: string[];
+  /** Only show for this calendar type (undefined = always) */
+  calendarType?: CalendarType;
+  /** Only show for this app mode (undefined = always) */
+  appMode?: 'ENROLLED';
+  /** If true, don't wrap content in a scroll container */
+  noScrollView?: boolean;
+};
+
+/**
+ * Ordered list of all settings menu items. The array order defines the
+ * display order within each section. Items without registry setting keys
+ * are navigation-only (e.g. gallery, guests).
+ */
+export const SETTINGS_MENU_ITEMS: readonly SettingsMenuItemDef[] = [
+  // -- Calendar section --
+  {
+    id: 'calendarView',
+    labelKey: 'Settings.Calendar',
+    icon: 'Eye',
+    section: 'calendar',
+    screens: [
+      'calendarDayView',
+      'calendarWeekView',
+      'chronologicalHeader',
+      'chronologicalFooter',
+      'chronologicalMenu',
+      'dayColors',
+      'dateTime',
+    ],
+    keys: [
+      'calendarView.showCalendarNames',
+      'calendarView.splitView',
+      'calendarView.dayViewZoom',
+      'calendarView.weekViewZoom',
+      'calendarView.calendarColumns',
+      'appearance.enableDayColors',
+      'chronological.dayView.displayMode',
+      'chronological.header.',
+      'chronological.footer.',
+      'chronological.menu.',
+      'chronological.quickSettings.',
+      'chronological.timeOfDay.',
+    ],
+  },
+  {
+    id: 'calendars',
+    labelKey: 'Common.Calendars',
+    icon: 'Calendar',
+    section: 'calendar',
+    screens: ['calendars'],
+  },
+  {
+    id: 'eventCategories',
+    labelKey: 'EventCategory.SettingsTitle',
+    icon: 'Tag',
+    section: 'calendar',
+    screens: ['eventCategories'],
+    calendarType: 'chronological',
+  },
+  {
+    id: 'notification',
+    labelKey: 'Settings.Notification',
+    icon: 'Bell',
+    section: 'calendar',
+    screens: ['notification'],
+    keys: [
+      'sound.reminderAlarmSound',
+      'sound.startAlarmSound',
+      'sound.endAlarmSound',
+      'sound.reminderAlarmTimeout',
+      'sound.reminderVolume',
+    ],
+  },
+  {
+    id: 'timer',
+    labelKey: 'Settings.TimerTitle',
+    icon: 'Timer',
+    section: 'calendar',
+    screens: ['timerFeatures', 'timer'],
+    appMode: 'ENROLLED',
+    keys: [
+      'chronological.timer.',
+      'timer.',
+      'sound.timerAlarmSound',
+      'sound.timerAlarmTimeout',
+      'sound.timerVolume',
+    ],
+  },
+  {
+    id: 'guests',
+    labelKey: 'Settings.GuestUsers',
+    icon: 'Users',
+    section: 'calendar',
+    screens: ['guests'],
+  },
+  {
+    id: 'eventForm',
+    labelKey: 'SettingsEventForm.Title',
+    icon: 'ClipboardList',
+    section: 'calendar',
+    screens: ['eventForm'],
+    calendarType: 'time-based',
+    keys: ['eventForm.'],
+  },
+  {
+    id: 'chronologicalEventForm',
+    labelKey: 'SettingsChronologicalEventForm.Title',
+    icon: 'Plus',
+    section: 'calendar',
+    screens: ['chronologicalEventForm'],
+    calendarType: 'chronological',
+    keys: ['chronologicalEventForm.'],
+  },
+  {
+    id: 'weather',
+    labelKey: 'Settings.WeatherTitle',
+    icon: 'CloudSun',
+    section: 'calendar',
+    screens: ['weather'],
+    calendarType: 'time-based',
+    keys: [
+      'calendarView.showWeatherOnTimeline',
+      'calendarView.weatherLocation',
+      'calendarView.showWeatherOnEvents',
+    ],
+  },
+  {
+    id: 'gallery',
+    labelKey: 'Gallery.Title',
+    icon: 'Images',
+    section: 'calendar',
+    screens: ['gallery'],
+    noScrollView: true,
+  },
+  {
+    id: 'audioClips',
+    labelKey: 'AudioClips.Title',
+    icon: 'AudioLines',
+    section: 'calendar',
+    screens: ['audioClips'],
+    noScrollView: true,
+  },
+  {
+    id: 'gestures',
+    labelKey: 'Settings.FunctionsTitle',
+    icon: 'Hand',
+    section: 'calendar',
+    screens: ['gestures'],
+    keys: ['touch.'],
+  },
+  {
+    id: 'calendarType',
+    labelKey: 'Settings.Mode',
+    icon: 'SlidersHorizontal',
+    section: 'calendar',
+    screens: ['calendarType'],
+    keys: ['calendarView.type'],
+  },
+  {
+    id: 'sharing',
+    labelKey: 'Settings.Sharing',
+    icon: 'Share2',
+    section: 'calendar',
+    screens: ['icalSubscriptions'],
+  },
+  // -- Unit section --
+  {
+    id: 'screen',
+    labelKey: 'Settings.Screen',
+    icon: 'LaptopMinimal',
+    section: 'unit',
+    screens: ['displayDensity', 'darkMode'],
+    keys: ['appearance.theme', 'appearance.clockType'],
+  },
+  {
+    id: 'volume',
+    labelKey: 'Common.Volume',
+    icon: 'Volume2',
+    section: 'unit',
+    screens: ['volume'],
+    appMode: 'ENROLLED',
+    keys: [
+      'sound.reminderVolume',
+      'sound.timerVolume',
+      'sound.mediaVolume',
+    ],
+  },
+  {
+    id: 'lockScreen',
+    labelKey: 'Settings.LockScreen',
+    icon: 'Lock',
+    section: 'unit',
+    screens: ['inactivity', 'lockScreen'],
+    appMode: 'ENROLLED',
+    keys: ['lockScreen.'],
+  },
+  {
+    id: 'language',
+    labelKey: 'Settings.Language',
+    icon: 'Globe',
+    section: 'unit',
+    screens: ['language'],
+    keys: ['language.'],
+  },
+  {
+    id: 'wifi',
+    labelKey: 'Settings.WifiTitle',
+    icon: 'Wifi',
+    section: 'unit',
+    screens: ['wifi'],
+    appMode: 'ENROLLED',
+  },
+  {
+    id: 'devices',
+    labelKey: 'SettingsDevices.Title',
+    icon: 'Smartphone',
+    section: 'unit',
+    screens: ['devices'],
+    keys: [
+      'device.',
+      'calendarView.autoReturnToTodayEnabled',
+      'calendarView.autoReturnToTodayTimeoutSeconds',
+    ],
+  },
+  {
+    id: 'tts',
+    labelKey: 'Settings.TtsTitle',
+    icon: 'Speech',
+    section: 'unit',
+    screens: ['tts'],
+    appMode: 'ENROLLED',
+    keys: [
+      'sound.ttsEnabled',
+      'sound.ttsRate',
+    ],
+  },
+  {
+    id: 'updates',
+    labelKey: 'Settings.UpdatesTitle',
+    icon: 'Download',
+    section: 'unit',
+    screens: ['updates'],
+  },
+  {
+    id: 'about',
+    labelKey: 'Settings.About',
+    icon: 'Info',
+    section: 'unit',
+    screens: ['restoreDefaults', 'recycleAppData', 'license', 'version'],
+  },
+  {
+    id: 'help',
+    labelKey: 'Settings.HelpTitle',
+    icon: 'CircleQuestionMark',
+    section: 'unit',
+    screens: ['help'],
+  },
+  {
+    id: 'dev',
+    labelKey: 'Settings.Dev',
+    icon: 'FolderCode',
+    section: 'unit',
+    screens: [
+      'devDeviceInfo',
+      'devComponents',
+      'devStores',
+      'devActions',
+      'devAuth',
+      'devNavigation',
+      'devNetwork',
+      'devAndroidSettings',
+    ],
+  },
+  // -- Account (rendered separately) --
+  {
+    id: 'account',
+    labelKey: 'Settings.Profile',
+    icon: 'User',
+    section: 'account',
+    screens: ['account', 'mfa'],
+  },
+  {
+    id: 'activityLog',
+    labelKey: 'SettingsActivityLog.Title',
+    icon: 'ScrollText',
+    section: 'account',
+    screens: ['activityLog'],
+  },
+];
+
+/**
+ * Settings excluded from remote editing (web portal / profile management).
+ * These are device-local or internal-only settings.
+ */
+export const EXCLUDED_DEVICE_SETTINGS: ReadonlySet<string> = new Set([
+  'device.id',
+  'device.devMenuEnabled',
+  'device.authWarningDismissTtlDays',
+  'notification.enabled',
+  'notification.notifyAllCalendars',
+  'notification.enabledCalendarIds',
+  'notification.hasBeenPrompted',
+]);
+
+// ---------------------------------------------------------------------------
+// Per-setting i18n label / description keys
+// ---------------------------------------------------------------------------
+
+export type SettingLabelDef = {
+  /** i18n message key for the setting label */
+  labelKey: string;
+  /** Optional i18n message key for a description shown below the label */
+  descriptionKey?: string;
+};
+
+/**
+ * Maps each setting key to its i18n label and optional description key.
+ * These keys must exist in every consumer's i18n catalog.
+ *
+ * When a key is missing from this map, consumers should fall back to
+ * the auto-generated label from `SettingsRegistry.getSettingLabel()`.
+ */
+export const SETTINGS_LABELS: Readonly<Record<string, SettingLabelDef>> = {
+  // ── Appearance ──────────────────────────────────────────────────────────
+  'appearance.theme': { labelKey: 'Settings.SelectTheme' },
+  'appearance.clockType': {
+    labelKey: 'Settings.ClockType',
+    descriptionKey: 'Settings.ClockTypeDescription',
+  },
+  'appearance.enableDayColors': {
+    labelKey: 'Settings.EnableDayColors',
+    descriptionKey: 'Settings.EnableDayColorsDescription',
+  },
+
+  // ── Chronological day view display mode ──────────────────────────────────
+  'chronological.dayView.displayMode': {
+    labelKey: 'Settings.DayViewDisplayMode',
+  },
+
+  // ── Calendar type ───────────────────────────────────────────────────────
+  'calendarView.type': {
+    labelKey: 'Settings.CalendarType',
+    descriptionKey: 'Settings.ModeDescription',
+  },
+  'calendarView.view': { labelKey: 'Settings.Calendar' },
+
+  // ── Calendar view ───────────────────────────────────────────────────────
+  'calendarView.showCalendarNames': { labelKey: 'Settings.ShowCalendarNames' },
+  'calendarView.splitView': {
+    labelKey: 'Settings.SplitViewLabel',
+    descriptionKey: 'Settings.SplitViewDescription',
+  },
+  'calendarView.calendarColumns': {
+    labelKey: 'Settings.SplitViewConfig',
+    descriptionKey: 'Settings.SplitViewConfigDescription',
+  },
+  'calendarView.dayViewZoom': {
+    labelKey: 'Settings.CalendarDayViewIntervalTitle',
+    descriptionKey: 'Settings.CalendarDayViewIntervalDescription',
+  },
+  'calendarView.weekViewZoom': {
+    labelKey: 'Settings.CalendarWeekViewIntervalTitle',
+    descriptionKey: 'Settings.CalendarWeekViewIntervalDescription',
+  },
+
+  // ── Auto return to today ────────────────────────────────────────────────
+  'calendarView.autoReturnToTodayEnabled': {
+    labelKey: 'Settings.AutoReturnToTodayEnabled',
+  },
+  'calendarView.autoReturnToTodayTimeoutSeconds': {
+    labelKey: 'Settings.AutoReturnToTodayTimeout',
+  },
+
+  // ── Weather ─────────────────────────────────────────────────────────────
+  'calendarView.weatherLocation': { labelKey: 'Settings.WeatherLocation' },
+  'calendarView.showWeatherOnEvents': {
+    labelKey: 'Settings.ShowWeatherOnEvents',
+    descriptionKey: 'Settings.ShowWeatherOnEventsDescription',
+  },
+  'calendarView.showWeatherOnTimeline': {
+    labelKey: 'Settings.ShowWeatherOnTimeline',
+    descriptionKey: 'Settings.ShowWeatherOnTimelineDescription',
+  },
+
+  // ── Sound & alerts ──────────────────────────────────────────────────────
+  'sound.reminderVolume': {
+    labelKey: 'Settings.ReminderVolume',
+    descriptionKey: 'Settings.ReminderVolumeDescription',
+  },
+  'sound.timerVolume': {
+    labelKey: 'Settings.TimerVolume',
+    descriptionKey: 'Settings.TimerVolumeDescription',
+  },
+  'sound.mediaVolume': {
+    labelKey: 'Settings.MediaVolume',
+    descriptionKey: 'Settings.MediaVolumeDescription',
+  },
+  'sound.alarmSound': { labelKey: 'Settings.AlarmSound' },
+  'sound.reminderAlarmSound': { labelKey: 'Settings.ReminderAlarmAsset' },
+  'sound.startAlarmSound': { labelKey: 'Settings.StartAlarmSound' },
+  'sound.endAlarmSound': { labelKey: 'Settings.EndAlarmSound' },
+  'sound.reminderAlarmTimeout': { labelKey: 'Settings.ReminderAlarmTimeout' },
+  'sound.timerAlarmSound': { labelKey: 'Settings.TimerAlarmSound' },
+  'sound.timerAlarmTimeout': { labelKey: 'Settings.TimerAlarmTimeout' },
+  'sound.allowCustomReminderSounds': {
+    labelKey: 'Settings.AllowCustomReminderSounds',
+  },
+  'sound.ttsEnabled': {
+    labelKey: 'Settings.EnableSpeech',
+    descriptionKey: 'Settings.EnableSpeechDescription',
+  },
+  'sound.ttsRate': { labelKey: 'Settings.TtsTitle' },
+
+  // ── Timer ───────────────────────────────────────────────────────────────
+  'timer.face': { labelKey: 'Settings.TimerFace' },
+  'timer.showTimeRemaining': { labelKey: 'Settings.TimerShowTimeRemaining' },
+  'timer.showEndTime': { labelKey: 'Settings.TimerShowEndTime' },
+  'timer.showRestartButton': { labelKey: 'Settings.TimerShowRestartButton' },
+  'timer.showPauseButton': { labelKey: 'Settings.TimerShowPauseButton' },
+
+  // ── Lock screen ─────────────────────────────────────────────────────────
+  'lockScreen.pin': { labelKey: 'Settings.LockScreenTitlePin' },
+  'lockScreen.clockDisplay': { labelKey: 'Settings.LockScreenClockTitle' },
+  'lockScreen.showDate': { labelKey: 'Settings.LockScreenShowDate' },
+  'lockScreen.showHourNumbers': {
+    labelKey: 'Settings.LockScreenShowHourNumbers',
+  },
+  'lockScreen.imageMode': { labelKey: 'Settings.LockScreenImageModeTitle' },
+  'lockScreen.backgroundImage': {
+    labelKey: 'Settings.LockScreenImageModeBackground',
+  },
+  'lockScreen.photoFrameImages': {
+    labelKey: 'Settings.LockScreenImageModePhotoFrame',
+  },
+  'lockScreen.photoFrameIntervalSeconds': {
+    labelKey: 'Settings.LockScreenPhotoFrameIntervalTitle',
+  },
+  'lockScreen.inactivityLockEnabled': {
+    labelKey: 'SettingsInactivity.EnableLabel',
+  },
+  'lockScreen.inactivityTimeoutMinutes': {
+    labelKey: 'SettingsInactivity.TimeoutLabel',
+  },
+
+  // ── Touch / gestures ───────────────────────────────────────────────────
+  'touch.enableTapToCreate': {
+    labelKey: 'Settings.EnableTapToCreate',
+    descriptionKey: 'Settings.EnableTapToCreateDescription',
+  },
+  'touch.enableDragDrop': {
+    labelKey: 'Settings.EnableDragDrop',
+    descriptionKey: 'Settings.EnableDragDropDescription',
+  },
+
+  // ── Device ──────────────────────────────────────────────────────────────
+  'device.timePickerMode': { labelKey: 'Settings.DateTimeTitle' },
+
+  // ── Language ────────────────────────────────────────────────────────────
+  'language.locale': { labelKey: 'Settings.SelectLanguage' },
+
+  // ── Notifications ───────────────────────────────────────────────────────
+  'notification.enabled': { labelKey: 'Settings.NotificationsEnabled' },
+  'notification.notifyAllCalendars': {
+    labelKey: 'Settings.NotifyAllCalendars',
+  },
+  'notification.enabledCalendarIds': {
+    labelKey: 'Settings.NotificationsCalendars',
+  },
+
+  // ── Chronological header ────────────────────────────────────────────────
+  'chronological.header.showNavigationArrows': {
+    labelKey: 'ChronologicalFeatures.NavigationArrows',
+  },
+  'chronological.header.showClock': {
+    labelKey: 'ChronologicalFeatures.Clock',
+  },
+  'chronological.header.showCurrentYearInDate': {
+    labelKey: 'ChronologicalFeatures.ShowCurrentYear',
+  },
+  'chronological.header.showTimeOfDay': {
+    labelKey: 'ChronologicalFeatures.TimeOfDay',
+  },
+
+  // ── Chronological footer ────────────────────────────────────────────────
+  'chronological.footer.showMenuButton': {
+    labelKey: 'ChronologicalFeatures.MenuButton',
+  },
+  'chronological.footer.showViewSwitcherDay': {
+    labelKey: 'ChronologicalFeatures.ViewSwitcherDay',
+  },
+  'chronological.footer.showViewSwitcherWeek': {
+    labelKey: 'ChronologicalFeatures.ViewSwitcherWeek',
+  },
+  'chronological.footer.showViewSwitcherMonth': {
+    labelKey: 'ChronologicalFeatures.ViewSwitcherMonth',
+  },
+  'chronological.footer.showTimerButton': {
+    labelKey: 'ChronologicalFeatures.TimerButton',
+  },
+  'chronological.footer.showNewEventButton': {
+    labelKey: 'ChronologicalFeatures.NewEventButton',
+  },
+  'chronological.footer.showNowButton': {
+    labelKey: 'ChronologicalFeatures.NowButton',
+  },
+  'chronological.footer.showSettingsButton': {
+    labelKey: 'ChronologicalFeatures.SettingsButton',
+  },
+
+  // ── Chronological timer ─────────────────────────────────────────────────
+  'chronological.timer.showNewCountdown': {
+    labelKey: 'TimerFeatures.ShowNewCountdown',
+  },
+  'chronological.timer.showFromTemplate': {
+    labelKey: 'TimerFeatures.ShowFromTemplate',
+  },
+  'chronological.timer.showEditTemplate': {
+    labelKey: 'TimerFeatures.ShowEditTemplate',
+  },
+  'chronological.timer.showDeleteTemplate': {
+    labelKey: 'TimerFeatures.ShowDeleteTemplate',
+  },
+  'chronological.timer.showAddTemplate': {
+    labelKey: 'TimerFeatures.ShowAddTemplate',
+  },
+
+  // ── Chronological menu ──────────────────────────────────────────────────
+  'chronological.menu.showSettingsButton': {
+    labelKey: 'ChronologicalFeatures.MenuSettingsButton',
+  },
+  'chronological.quickSettings.showTimerVolume': {
+    labelKey: 'ChronologicalFeatures.QuickSettingsTimerVolume',
+  },
+  'chronological.quickSettings.showReminderVolume': {
+    labelKey: 'ChronologicalFeatures.QuickSettingsReminderVolume',
+  },
+  'chronological.quickSettings.showMediaVolume': {
+    labelKey: 'ChronologicalFeatures.QuickSettingsMediaVolume',
+  },
+  'chronological.quickSettings.showBrightness': {
+    labelKey: 'ChronologicalFeatures.QuickSettingsBrightness',
+  },
+  'chronological.quickSettings.showLockScreen': {
+    labelKey: 'ChronologicalFeatures.QuickSettingsLockScreen',
+  },
+
+  // ── Event form (time-based) ─────────────────────────────────────────────
+  'eventForm.recurrence': { labelKey: 'Calendar.LabelRecurrence' },
+  'eventForm.reminders': { labelKey: 'Calendar.LabelReminders' },
+  'eventForm.emailReminders': { labelKey: 'Calendar.LabelEmailReminders' },
+  'eventForm.location': { labelKey: 'Common.Location' },
+  'eventForm.travelTime': { labelKey: 'TravelTime.Title' },
+  'eventForm.description': { labelKey: 'Common.Description' },
+  'eventForm.checklist': { labelKey: 'EventChecklist.DefaultName' },
+  'eventForm.images': { labelKey: 'EventImageGallery.SectionTitle' },
+  'eventForm.audioClips': { labelKey: 'EventAudioGallery.SectionTitle' },
+  'eventForm.notificationReceivers': {
+    labelKey: 'EventForm.NotificationReceivers',
+  },
+  'eventForm.visibility': { labelKey: 'EventVisibility.Title' },
+
+  // ── Chronological event form ────────────────────────────────────────────
+  'chronologicalEventForm.field.category': {
+    labelKey: 'ChronologicalEventForm.CategoryField',
+  },
+};
+
+/** Return the index of the first matching key pattern in the group, for sorting. */
+function groupKeyIndex(key: string, keys: readonly string[]): number {
+  for (let i = 0; i < keys.length; i++) {
+    const matcher = keys[i];
+    if (key === matcher || (matcher.endsWith('.') && key.startsWith(matcher))) {
+      return i;
+    }
+  }
+  return keys.length;
+}
+
+/**
+ * Lazy-initialized map from setting key → declaration index in buildEntries.
+ * Used as a tiebreaker when multiple keys share the same prefix group index.
+ */
+let _registryKeyOrder: Map<string, number> | undefined;
+function registryKeyOrder(): Map<string, number> {
+  if (!_registryKeyOrder) {
+    _registryKeyOrder = new Map();
+    const keys = Object.keys(buildEntries(DEFAULT_REGISTRY_CONFIG));
+    for (let i = 0; i < keys.length; i++) {
+      _registryKeyOrder.set(keys[i], i);
+    }
+  }
+  return _registryKeyOrder;
+}
+
+/**
+ * Get the ordered list of setting keys for a given menu item.
+ * Returns keys matching the app's render order, filtered by EXCLUDED_DEVICE_SETTINGS and HIDDEN.
+ */
+export function getKeysForMenuItem(
+  menuItemId: SettingsMenuItemId,
+  reg: SettingsRegistry = defaultRegistry,
+): string[] {
+  const menuItem = SETTINGS_MENU_ITEMS.find((m) => m.id === menuItemId);
+  if (!menuItem?.keys || menuItem.keys.length === 0) return [];
+
+  const matched = reg.keys.filter((key) => {
+    if (EXCLUDED_DEVICE_SETTINGS.has(key)) return false;
+    const entry = reg.entries[key as keyof typeof reg.entries];
+    if (entry?.uiType === 'HIDDEN') return false;
+    return menuItem.keys!.some((k) =>
+      k.endsWith('.') ? key.startsWith(k) : key === k,
+    );
+  });
+
+  const order = registryKeyOrder();
+  matched.sort((a, b) => {
+    const aIdx = groupKeyIndex(a, menuItem.keys!);
+    const bIdx = groupKeyIndex(b, menuItem.keys!);
+    if (aIdx !== bIdx) return aIdx - bIdx;
+    return (order.get(a) ?? Infinity) - (order.get(b) ?? Infinity);
+  });
+
+  return matched;
+}
+
+/**
+ * Group parsed setting entries using the app's menu structure (SETTINGS_MENU_ITEMS).
+ * Only includes menu items that have `keys` defined (editable settings).
+ * This ensures the web editor has the exact same menu items, order, sections,
+ * labels, and icons as the mobile app.
+ */
+export function groupSettingsForWeb(
+  allSettings: ParsedSettingEntry[],
+  calendarType: CalendarType,
+  appMode?: 'ENROLLED',
+): {
+  id: SettingsMenuItemId;
+  labelKey: string;
+  icon: string;
+  section: SettingsSectionId | 'account';
+  settings: ParsedSettingEntry[];
+}[] {
+  // Filter excluded and hidden settings
+  const settings = allSettings.filter(
+    (s) => !EXCLUDED_DEVICE_SETTINGS.has(s.key) && s.uiType !== 'HIDDEN',
+  );
+
+  const isChronological = calendarType === 'chronological';
+  const filteredSettings = settings.filter((s) => {
+    if (isChronological && s.key.startsWith('eventForm.')) return false;
+    if (!isChronological && s.key.startsWith('chronologicalEventForm.'))
+      return false;
+    if (s.calendarType && s.calendarType !== calendarType) return false;
+    if (s.appMode && s.appMode !== appMode) return false;
+    return true;
+  });
+
+  const claimed = new Set<string>();
+  const result: {
+    id: SettingsMenuItemId;
+    labelKey: string;
+    icon: string;
+    section: SettingsSectionId | 'account';
+    settings: ParsedSettingEntry[];
+  }[] = [];
+
+  for (const menuItem of SETTINGS_MENU_ITEMS) {
+    // Skip items without keys (navigation-only like gallery, guests, etc.)
+    if (!menuItem.keys || menuItem.keys.length === 0) continue;
+
+    // Skip items not relevant for current calendar type
+    if (menuItem.calendarType && menuItem.calendarType !== calendarType)
+      continue;
+
+    // Skip items not relevant for current app mode
+    if (menuItem.appMode && menuItem.appMode !== appMode) continue;
+
+    const matched = filteredSettings.filter((s) => {
+      if (claimed.has(s.key)) return false;
+      return menuItem.keys!.some((k) =>
+        k.endsWith('.') ? s.key.startsWith(k) : s.key === k,
+      );
+    });
+
+    if (matched.length === 0) continue;
+
+    // Sort by key order within the menu item's keys array
+    const order = registryKeyOrder();
+    matched.sort((a, b) => {
+      const aIdx = groupKeyIndex(a.key, menuItem.keys!);
+      const bIdx = groupKeyIndex(b.key, menuItem.keys!);
+      if (aIdx !== bIdx) return aIdx - bIdx;
+      return (order.get(a.key) ?? Infinity) - (order.get(b.key) ?? Infinity);
+    });
+
+    for (const s of matched) {
+      claimed.add(s.key);
+    }
+
+    result.push({
+      id: menuItem.id,
+      labelKey: menuItem.labelKey,
+      icon: menuItem.icon,
+      section: menuItem.section,
+      settings: matched,
+    });
+  }
+
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Data type discriminator — stored alongside each setting in the DB
+// ---------------------------------------------------------------------------
+
+export type SettingsDataType = 'string' | 'number' | 'boolean' | 'json';
+
+// ---------------------------------------------------------------------------
+// Single registry entry definition
+// ---------------------------------------------------------------------------
+
+export type SettingDef<T = unknown> = {
+  category: SettingsCategory;
+  type: SettingsDataType;
+  default: T;
+  /** Whether this setting should be synced to the server. Default true. */
+  sync: boolean;
+  /** UI component type for rendering this setting */
+  uiType: SettingUiType;
+  /** Available options for SELECT-type settings */
+  options?: readonly SettingOption<T>[];
+  /** Slider configuration for SLIDER-type settings */
+  sliderConfig?: SliderConfig;
+  /** Only show this setting for enrolled/kiosk devices (undefined = always) */
+  appMode?: 'ENROLLED';
+  /** Only show this setting for a specific calendar type (undefined = always) */
+  calendarType?: CalendarType;
+  /** Show this setting only when condition(s) are met */
+  visibleWhen?: VisibilityRule;
+  /** Disable (but still show) this setting when condition(s) are met */
+  disabledWhen?: DisabledRule;
+};
+
+// ---------------------------------------------------------------------------
+// Configuration for app-specific defaults
+// ---------------------------------------------------------------------------
+
+export type RegistryConfig = {
+  /** Whether the device is in enrolled/kiosk mode */
+  isEnrolled: boolean;
+  /** Default theme code */
+  defaultTheme: ThemeSetting;
+  /** Default locale code */
+  defaultLocale: LocaleCode;
+};
+
+/** Default config for non-enrolled mode */
+export const DEFAULT_REGISTRY_CONFIG: RegistryConfig = {
+  isEnrolled: false,
+  defaultTheme: 'system',
+  defaultLocale: 'nb',
+};
+
+// ---------------------------------------------------------------------------
+// Shared option arrays (reused across multiple settings)
+// ---------------------------------------------------------------------------
+
+const ALARM_SOUND_OPTIONS: readonly SettingOption<AlarmSound>[] = [
+  { value: 'none', labelKey: 'AlarmAsset.none' },
+  { value: 'alarm1', labelKey: 'AlarmAsset.alarm1' },
+  { value: 'alarm2', labelKey: 'AlarmAsset.alarm2' },
+  { value: 'alarm3', labelKey: 'AlarmAsset.alarm3' },
+  { value: 'alarm4', labelKey: 'AlarmAsset.alarm4' },
+  { value: 'alarm5', labelKey: 'AlarmAsset.alarm5' },
+  { value: 'alarm6', labelKey: 'AlarmAsset.alarm6' },
+  { value: 'alarm7', labelKey: 'AlarmAsset.alarm7' },
+  { value: 'alarm8', labelKey: 'AlarmAsset.alarm8' },
+  { value: 'alarm9', labelKey: 'AlarmAsset.alarm9' },
+];
+
+const ALARM_TIMEOUT_OPTIONS: readonly SettingOption<AlarmTimeout>[] = [
+  { value: 5, labelKey: 'Duration.CountSeconds', labelValues: { count: 5 } },
+  { value: 30, labelKey: 'Duration.CountSeconds', labelValues: { count: 30 } },
+  { value: 60, labelKey: 'Duration.CountMinutes', labelValues: { count: 1 } },
+  { value: 120, labelKey: 'Duration.CountMinutes', labelValues: { count: 2 } },
+  { value: 180, labelKey: 'Duration.CountMinutes', labelValues: { count: 3 } },
+  { value: 300, labelKey: 'Duration.CountMinutes', labelValues: { count: 5 } },
+  { value: 600, labelKey: 'Duration.CountMinutes', labelValues: { count: 10 } },
+];
+
+const DAY_VIEW_ZOOM_OPTIONS: readonly SettingOption<CalendarDayViewCellZoom>[] =
+  [
+    { value: 15, labelKey: 'Settings.Option.DayViewZoom.15min' },
+    { value: 30, labelKey: 'Settings.Option.DayViewZoom.30min' },
+    { value: 60, labelKey: 'Settings.Option.DayViewZoom.1hour' },
+  ];
+
+const TIME_OF_DAY_SLIDER: SliderConfig = { min: 0, max: 23, step: 1 };
+
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+
+function def<T>(
+  category: SettingsCategory,
+  type: SettingsDataType,
+  defaultValue: T,
+  uiType: SettingUiType,
+  extra?: {
+    sync?: boolean;
+    options?: readonly SettingOption<T>[];
+    sliderConfig?: SliderConfig;
+    appMode?: 'ENROLLED';
+    calendarType?: CalendarType;
+    visibleWhen?: VisibilityRule;
+    disabledWhen?: DisabledRule;
+  },
+): SettingDef<T> {
+  const result: SettingDef<T> = {
+    category,
+    type,
+    default: defaultValue,
+    sync: extra?.sync ?? true,
+    uiType,
+  };
+  if (extra?.options) {
+    result.options = extra.options;
+  }
+  if (extra?.sliderConfig) {
+    result.sliderConfig = extra.sliderConfig;
+  }
+  if (extra?.appMode) {
+    result.appMode = extra.appMode;
+  }
+  if (extra?.calendarType) {
+    result.calendarType = extra.calendarType;
+  }
+  if (extra?.visibleWhen) {
+    result.visibleWhen = extra.visibleWhen;
+  }
+  if (extra?.disabledWhen) {
+    result.disabledWhen = extra.disabledWhen;
+  }
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Entry builder (internal — used by SettingsRegistry class and factory)
+// ---------------------------------------------------------------------------
+
+function buildEntries(config: RegistryConfig) {
+  return {
+    // ═══════════════════════════════════════════════════════════════════════
+    // Appearance
+    // ═══════════════════════════════════════════════════════════════════════
+    'appearance.theme': def<ThemeSetting>(
+      'appearance',
+      'string',
+      config.defaultTheme,
+      'CUSTOM_THEME_PICKER',
+      {
+        options: config.isEnrolled
+          ? [
+              { value: 'light', labelKey: 'Settings.Option.Theme.Light' },
+              { value: 'dark', labelKey: 'Settings.Option.Theme.Dark' },
+            ]
+          : [
+              { value: 'light', labelKey: 'Settings.Option.Theme.Light' },
+              { value: 'dark', labelKey: 'Settings.Option.Theme.Dark' },
+              { value: 'system', labelKey: 'Settings.Option.Theme.System' },
+            ],
+      },
+    ),
+    'appearance.clockType': def<ClockType>(
+      'appearance',
+      'string',
+      'digital',
+      'CUSTOM_CLOCK_TYPE',
+      {
+        options: [
+          { value: 'digital', labelKey: 'Settings.Option.ClockType.Digital' },
+          { value: 'analog', labelKey: 'Settings.Option.ClockType.Analog' },
+        ],
+        appMode: 'ENROLLED',
+      },
+    ),
+    'appearance.enableDayColors': def<boolean>(
+      'appearance',
+      'boolean',
+      false,
+      'TOGGLE',
+      { calendarType: 'chronological' },
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Calendar view
+    // ═══════════════════════════════════════════════════════════════════════
+    'calendarView.type': def<CalendarType>(
+      'calendarView',
+      'string',
+      'time-based',
+      'CUSTOM_CALENDAR_TYPE',
+      {
+        options: [
+          {
+            value: 'chronological',
+            labelKey: 'Settings.Option.CalendarType.Chronological',
+          },
+          {
+            value: 'time-based',
+            labelKey: 'Settings.Option.CalendarType.TimeBased',
+          },
+        ],
+      },
+    ),
+    'calendarView.view': def<CalendarViewMode>(
+      'calendarView',
+      'string',
+      'day',
+      'SELECT',
+      {
+        options: [
+          { value: 'day', labelKey: 'Settings.Option.CalendarView.Day' },
+          {
+            value: '3-days',
+            labelKey: 'Settings.Option.CalendarView.3Days',
+          },
+          {
+            value: '5-days',
+            labelKey: 'Settings.Option.CalendarView.5Days',
+          },
+          {
+            value: '7-days',
+            labelKey: 'Settings.Option.CalendarView.7Days',
+          },
+          { value: 'week', labelKey: 'Settings.Option.CalendarView.Week' },
+          {
+            value: 'month',
+            labelKey: 'Settings.Option.CalendarView.Month',
+          },
+          {
+            value: 'overview',
+            labelKey: 'Settings.Option.CalendarView.Overview',
+          },
+        ],
+      },
+    ),
+    'calendarView.dayViewZoom': def<CalendarDayViewCellZoom>(
+      'calendarView',
+      'number',
+      60,
+      'SELECT',
+      { options: DAY_VIEW_ZOOM_OPTIONS, calendarType: 'time-based' },
+    ),
+    'calendarView.weekViewZoom': def<CalendarDayViewCellZoom>(
+      'calendarView',
+      'number',
+      60,
+      'SELECT',
+      { options: DAY_VIEW_ZOOM_OPTIONS, calendarType: 'time-based' },
+    ),
+    'calendarView.splitView': def<boolean>(
+      'calendarView',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'calendarView.showCalendarNames': def<boolean>(
+      'calendarView',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'calendarView.calendarColumns': def<unknown[]>(
+      'calendarView',
+      'json',
+      [],
+      'CUSTOM_SPLIT_VIEW_CONFIG',
+    ),
+    'calendarView.autoReturnToTodayEnabled': def<boolean>(
+      'calendarView',
+      'boolean',
+      config.isEnrolled,
+      'TOGGLE',
+    ),
+    'calendarView.autoReturnToTodayTimeoutSeconds': def<number>(
+      'calendarView',
+      'number',
+      300,
+      'SLIDER',
+      {
+        sliderConfig: { min: 30, max: 600, step: 30 },
+        visibleWhen: { dependsOn: 'calendarView.autoReturnToTodayEnabled', isTruthy: true },
+      },
+    ),
+    'calendarView.showWeatherOnEvents': def<boolean>(
+      'calendarView',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'calendarView.showWeatherOnTimeline': def<boolean>(
+      'calendarView',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'calendarView.weatherLocation': def<WeatherLocation | null>(
+      'calendarView',
+      'json',
+      null,
+      'CUSTOM_WEATHER_LOCATION',
+      { visibleWhen: { dependsOn: 'calendarView.showWeatherOnTimeline', isTruthy: true } },
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Event form field visibility (time-based)
+    // ═══════════════════════════════════════════════════════════════════════
+    'eventForm.recurrence': def<boolean>(
+      'eventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'eventForm.location': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
+    'eventForm.travelTime': def<boolean>(
+      'eventForm',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'eventForm.reminders': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
+    'eventForm.emailReminders': def<boolean>(
+      'eventForm',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'eventForm.description': def<boolean>(
+      'eventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'eventForm.checklist': def<boolean>('eventForm', 'boolean', true, 'TOGGLE'),
+    'eventForm.images': def<boolean>('eventForm', 'boolean', false, 'TOGGLE'),
+    'eventForm.audioClips': def<boolean>(
+      'eventForm',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'eventForm.notificationReceivers': def<boolean>(
+      'eventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'eventForm.visibility': def<boolean>(
+      'eventForm',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Sound & alerts
+    // ═══════════════════════════════════════════════════════════════════════
+    'sound.timerVolume': def<number>('sound', 'number', 0.5, 'VOLUME_SLIDER', {
+      visibleWhen: { dependsOn: 'sound.timerAlarmSound', notEquals: 'none' },
+    }),
+    'sound.reminderVolume': def<number>(
+      'sound',
+      'number',
+      0.5,
+      'VOLUME_SLIDER',
+      {
+        appMode: 'ENROLLED',
+        visibleWhen: { dependsOn: 'sound.reminderAlarmSound', notEquals: 'none' },
+      },
+    ),
+    'sound.mediaVolume': def<number>('sound', 'number', 0.5, 'VOLUME_SLIDER', {
+      appMode: 'ENROLLED',
+    }),
+    'sound.alarmSound': def<AlarmSound>('sound', 'string', 'alarm1', 'SELECT', {
+      options: ALARM_SOUND_OPTIONS,
+    }),
+    'sound.reminderAlarmSound': def<AlarmSound>(
+      'sound',
+      'string',
+      'alarm1',
+      'SELECT',
+      { options: ALARM_SOUND_OPTIONS },
+    ),
+    'sound.startAlarmSound': def<AlarmSound>(
+      'sound',
+      'string',
+      'alarm1',
+      'SELECT',
+      {
+        options: ALARM_SOUND_OPTIONS,
+        visibleWhen: { dependsOn: 'calendarView.type', equals: 'chronological' },
+      },
+    ),
+    'sound.endAlarmSound': def<AlarmSound>(
+      'sound',
+      'string',
+      'alarm1',
+      'SELECT',
+      {
+        options: ALARM_SOUND_OPTIONS,
+        visibleWhen: { dependsOn: 'calendarView.type', equals: 'chronological' },
+      },
+    ),
+    'sound.timerAlarmSound': def<AlarmSound>(
+      'sound',
+      'string',
+      'alarm1',
+      'SELECT',
+      { options: ALARM_SOUND_OPTIONS },
+    ),
+    'sound.timerAlarmTimeout': def<AlarmTimeout>(
+      'sound',
+      'number',
+      180,
+      'SELECT',
+      {
+        options: ALARM_TIMEOUT_OPTIONS,
+        visibleWhen: { dependsOn: 'sound.timerAlarmSound', notEquals: 'none' },
+      },
+    ),
+    'sound.reminderAlarmTimeout': def<AlarmTimeout>(
+      'sound',
+      'number',
+      180,
+      'SELECT',
+      {
+        options: ALARM_TIMEOUT_OPTIONS,
+        visibleWhen: { dependsOn: 'sound.reminderAlarmSound', notEquals: 'none' },
+      },
+    ),
+    'sound.allowCustomReminderSounds': def<boolean>(
+      'sound',
+      'boolean',
+      false,
+      'HIDDEN',
+    ),
+    'sound.ttsEnabled': def<boolean>(
+      'sound',
+      'boolean',
+      config.isEnrolled,
+      'TOGGLE',
+      { appMode: 'ENROLLED' },
+    ),
+    'sound.ttsRate': def<number>('sound', 'number', 1.0, 'SLIDER', {
+      sliderConfig: { min: 0.5, max: 2, step: 0.1 },
+      appMode: 'ENROLLED',
+      visibleWhen: { dependsOn: 'sound.ttsEnabled', isTruthy: true },
+    }),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Timer
+    // ═══════════════════════════════════════════════════════════════════════
+    'timer.face': def<'ring' | 'bars'>('timer', 'string', 'ring', 'SELECT', {
+      options: [
+        { value: 'ring', labelKey: 'Timer.FaceRing' },
+        { value: 'bars', labelKey: 'Timer.FaceBars' },
+      ],
+    }),
+    'timer.showTimeRemaining': def<boolean>('timer', 'boolean', true, 'TOGGLE'),
+    'timer.showEndTime': def<boolean>('timer', 'boolean', true, 'TOGGLE'),
+    'timer.showRestartButton': def<boolean>('timer', 'boolean', true, 'TOGGLE'),
+    'timer.showPauseButton': def<boolean>('timer', 'boolean', true, 'TOGGLE'),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Lock screen
+    // ═══════════════════════════════════════════════════════════════════════
+    'lockScreen.inactivityLockEnabled': def<boolean>(
+      'lockScreen',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'lockScreen.inactivityTimeoutMinutes': def<InactivityTimeoutMinutes>(
+      'lockScreen',
+      'number',
+      5,
+      'SELECT',
+      {
+        options: [
+          { value: 1, labelKey: 'Settings.Option.InactivityTimeout.1min' },
+          { value: 5, labelKey: 'Settings.Option.InactivityTimeout.5min' },
+          { value: 10, labelKey: 'Settings.Option.InactivityTimeout.10min' },
+          { value: 15, labelKey: 'Settings.Option.InactivityTimeout.15min' },
+          { value: 30, labelKey: 'Settings.Option.InactivityTimeout.30min' },
+          { value: 45, labelKey: 'Settings.Option.InactivityTimeout.45min' },
+        ],
+        visibleWhen: { dependsOn: 'lockScreen.inactivityLockEnabled', isTruthy: true },
+      },
+    ),
+    'lockScreen.pin': def<string>('lockScreen', 'string', '', 'PIN_INPUT'),
+    'lockScreen.clockDisplay': def<LockScreenClockDisplay>(
+      'lockScreen',
+      'string',
+      'digital',
+      'SELECT',
+      {
+        options: [
+          { value: 'none', labelKey: 'Settings.Option.ClockDisplay.None' },
+          {
+            value: 'digital',
+            labelKey: 'Settings.Option.ClockDisplay.Digital',
+          },
+          {
+            value: 'analog',
+            labelKey: 'Settings.Option.ClockDisplay.Analog',
+          },
+        ],
+      },
+    ),
+    'lockScreen.showHourNumbers': def<boolean>(
+      'lockScreen',
+      'boolean',
+      true,
+      'TOGGLE',
+      { visibleWhen: { dependsOn: 'lockScreen.clockDisplay', equals: 'analog' } },
+    ),
+    'lockScreen.showDate': def<boolean>(
+      'lockScreen',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'lockScreen.imageMode': def<LockScreenImageMode>(
+      'lockScreen',
+      'string',
+      'none',
+      'SELECT',
+      {
+        options: [
+          { value: 'none', labelKey: 'Settings.Option.ImageMode.None' },
+          {
+            value: 'background',
+            labelKey: 'Settings.Option.ImageMode.Background',
+          },
+          {
+            value: 'photoFrame',
+            labelKey: 'Settings.Option.ImageMode.PhotoFrame',
+          },
+        ],
+      },
+    ),
+    'lockScreen.backgroundImage': def<string | null>(
+      'lockScreen',
+      'json',
+      null,
+      'CUSTOM_IMAGE',
+      { visibleWhen: { dependsOn: 'lockScreen.imageMode', equals: 'background' } },
+    ),
+    'lockScreen.photoFrameIntervalSeconds': def<PhotoFrameIntervalSeconds>(
+      'lockScreen',
+      'number',
+      60,
+      'SELECT',
+      {
+        options: [
+          { value: 30, labelKey: 'Settings.Option.PhotoFrameInterval.30sec' },
+          { value: 60, labelKey: 'Settings.Option.PhotoFrameInterval.1min' },
+          { value: 120, labelKey: 'Settings.Option.PhotoFrameInterval.2min' },
+          { value: 300, labelKey: 'Settings.Option.PhotoFrameInterval.5min' },
+        ],
+        visibleWhen: { dependsOn: 'lockScreen.imageMode', equals: 'photoFrame' },
+      },
+    ),
+
+    'lockScreen.photoFrameImages': def<LockScreenImage[]>(
+      'lockScreen',
+      'json',
+      [],
+      'CUSTOM_IMAGE_ARRAY',
+      { visibleWhen: { dependsOn: 'lockScreen.imageMode', equals: 'photoFrame' } },
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Touch / gestures
+    // ═══════════════════════════════════════════════════════════════════════
+    'touch.enableTapToCreate': def<boolean>(
+      'touch',
+      'boolean',
+      false,
+      'TOGGLE',
+      { disabledWhen: { dependsOn: 'sound.ttsEnabled', isTruthy: true } },
+    ),
+    'touch.enableDragDrop': def<boolean>('touch', 'boolean', false, 'TOGGLE', {
+      disabledWhen: { dependsOn: 'sound.ttsEnabled', isTruthy: true },
+    }),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Device (not synced unless noted)
+    // ═══════════════════════════════════════════════════════════════════════
+    'device.id': def<string>('device', 'string', '', 'HIDDEN', { sync: false }),
+    'device.timePickerMode': def<TimePickerMode>(
+      'device',
+      'string',
+      'dials',
+      'SELECT',
+      {
+        options: [
+          { value: 'dials', labelKey: 'Settings.Option.TimePickerMode.Dials' },
+          {
+            value: 'keypad',
+            labelKey: 'Settings.Option.TimePickerMode.Keypad',
+          },
+        ],
+      },
+    ),
+    'device.devMenuEnabled': def<boolean>(
+      'device',
+      'boolean',
+      false,
+      'HIDDEN',
+      { sync: false },
+    ),
+    'device.authWarningDismissTtlDays': def<number>(
+      'device',
+      'number',
+      3,
+      'HIDDEN',
+      { sync: false },
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Language
+    // ═══════════════════════════════════════════════════════════════════════
+    'language.locale': def<LocaleCode>(
+      'language',
+      'string',
+      config.defaultLocale,
+      'CUSTOM_LANGUAGE_PICKER',
+      {
+        options: [
+          { value: 'nb', labelKey: 'Settings.Option.Language.Norwegian' },
+          { value: 'en', labelKey: 'Settings.Option.Language.English' },
+        ],
+      },
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Notifications
+    // ═══════════════════════════════════════════════════════════════════════
+    'notification.enabled': def<boolean>(
+      'notification',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'notification.notifyAllCalendars': def<boolean>(
+      'notification',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'notification.enabledCalendarIds': def<string[]>(
+      'notification',
+      'json',
+      [],
+      'CUSTOM_CALENDAR_IDS',
+    ),
+    'notification.hasBeenPrompted': def<boolean>(
+      'notification',
+      'boolean',
+      false,
+      'HIDDEN',
+      { sync: false },
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Chronological features (header, footer, menu, quick settings, timer)
+    // ═══════════════════════════════════════════════════════════════════════
+    // Header
+    'chronological.header.showNavigationArrows': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.header.showCurrentYearInDate': def<boolean>(
+      'chronological',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'chronological.header.showClock': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.header.showTimeOfDay': def<boolean>(
+      'chronological',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    // Footer
+    'chronological.footer.showMenuButton': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.footer.showViewSwitcherDay': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.footer.showViewSwitcherWeek': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.footer.showViewSwitcherMonth': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.footer.showTimerButton': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.footer.showNewEventButton': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.footer.showNowButton': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.footer.showSettingsButton': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    // Timer features
+    'chronological.timer.showNewCountdown': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.timer.showFromTemplate': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.timer.showAddTemplate': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.timer.showEditTemplate': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.timer.showDeleteTemplate': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    // Menu
+    'chronological.menu.showSettingsButton': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    // Quick settings
+    'chronological.quickSettings.showTimerVolume': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.quickSettings.showReminderVolume': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.quickSettings.showMediaVolume': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.quickSettings.showBrightness': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.quickSettings.showLockScreen': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronological.quickSettings.showDayViewMode': def<boolean>(
+      'chronological',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    // Day view display mode
+    'chronological.dayView.displayMode':
+      def<ChronologicalDayViewDisplayMode>(
+        'chronological',
+        'string',
+        'list',
+        'SELECT',
+        {
+          options: [
+            {
+              value: 'list' as const,
+              labelKey: 'Settings.Option.DayViewDisplayMode.List',
+            },
+            {
+              value: 'timeline' as const,
+              labelKey: 'Settings.Option.DayViewDisplayMode.Timeline',
+            },
+          ],
+          calendarType: 'chronological',
+        },
+      ),
+    // Time-of-day periods
+    'chronological.timeOfDay.morningStart': def<number>(
+      'chronological',
+      'number',
+      6,
+      'SLIDER',
+      { sliderConfig: TIME_OF_DAY_SLIDER },
+    ),
+    'chronological.timeOfDay.forenoonStart': def<number>(
+      'chronological',
+      'number',
+      9,
+      'SLIDER',
+      { sliderConfig: TIME_OF_DAY_SLIDER },
+    ),
+    'chronological.timeOfDay.afternoonStart': def<number>(
+      'chronological',
+      'number',
+      12,
+      'SLIDER',
+      { sliderConfig: TIME_OF_DAY_SLIDER },
+    ),
+    'chronological.timeOfDay.eveningStart': def<number>(
+      'chronological',
+      'number',
+      18,
+      'SLIDER',
+      { sliderConfig: TIME_OF_DAY_SLIDER },
+    ),
+    'chronological.timeOfDay.nightStart': def<number>(
+      'chronological',
+      'number',
+      0,
+      'SLIDER',
+      { sliderConfig: TIME_OF_DAY_SLIDER },
+    ),
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // Chronological event form
+    // ═══════════════════════════════════════════════════════════════════════
+    // Fixed fields
+    'chronologicalEventForm.fixedField.category': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.fixedField.allDay': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.fixedField.endTime': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.fixedField.alarm': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.fixedField.visibility': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    // Toggleable fields
+    'chronologicalEventForm.field.acknowledge': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.field.description': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.field.recurrence': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.field.checklist': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.field.extraImages': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.field.reminders': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.field.audioClips': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.field.category': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    // Suggest end time
+    'chronologicalEventForm.suggestEndTime.enabled': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.suggestEndTime.value': def<number>(
+      'chronologicalEventForm',
+      'number',
+      30,
+      'SLIDER',
+      { sliderConfig: { min: 5, max: 480, step: 5 } },
+    ),
+    'chronologicalEventForm.suggestEndTime.unit': def<SuggestEndTimeUnit>(
+      'chronologicalEventForm',
+      'string',
+      'minutes',
+      'SELECT',
+      {
+        options: [
+          {
+            value: 'minutes',
+            labelKey: 'Settings.Option.SuggestEndTimeUnit.Minutes',
+          },
+          {
+            value: 'hours',
+            labelKey: 'Settings.Option.SuggestEndTimeUnit.Hours',
+          },
+        ],
+      },
+    ),
+    // Default visibility
+    'chronologicalEventForm.defaultVisibility': def<EventVisibility>(
+      'chronologicalEventForm',
+      'string',
+      'Private',
+      'SELECT',
+      {
+        options: [
+          { value: 'Public', labelKey: 'Settings.Option.Visibility.Public' },
+          { value: 'Private', labelKey: 'Settings.Option.Visibility.Private' },
+          { value: 'Custom', labelKey: 'Settings.Option.Visibility.Custom' },
+        ],
+      },
+    ),
+    // Default alarm toggles
+    'chronologicalEventForm.defaultAlarm.atStart': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      true,
+      'TOGGLE',
+    ),
+    'chronologicalEventForm.defaultAlarm.atEnd': def<boolean>(
+      'chronologicalEventForm',
+      'boolean',
+      false,
+      'TOGGLE',
+    ),
+    // Reminder presets
+    'chronologicalEventForm.reminderPresets.timed': def<number[]>(
+      'chronologicalEventForm',
+      'json',
+      [5, 15, 30, 60, 120, 1440],
+      'CUSTOM_REMINDER_PRESETS',
+    ),
+    'chronologicalEventForm.reminderPresets.allDay': def<AllDayPreset[]>(
+      'chronologicalEventForm',
+      'json',
+      [
+        { daysBefore: 0, time: '09:00' },
+        { daysBefore: 1, time: '18:00' },
+        { daysBefore: 2, time: '09:00' },
+      ],
+      'CUSTOM_REMINDER_PRESETS',
+    ),
+  } as const satisfies Record<string, SettingDef>;
+}
+
+// ---------------------------------------------------------------------------
+// Derived types (based on entry shape — all configs produce the same keys)
+// ---------------------------------------------------------------------------
+
+type SettingsEntries = ReturnType<typeof buildEntries>;
+
+/** Union type of every valid setting key */
+export type SettingKey = keyof SettingsEntries;
+
+/** Type-safe value type for a given setting key */
+export type SettingValue<K extends SettingKey> = SettingsEntries[K]['default'];
+
+/** Complete settings map — all keys resolved to their value types */
+export type SettingsMap = {
+  [K in SettingKey]: SettingValue<K>;
+};
+
+// ---------------------------------------------------------------------------
+// Registry class
+// ---------------------------------------------------------------------------
+
+export class SettingsRegistry {
+  /** The raw setting definitions (category, type, default, sync) */
+  readonly entries: SettingsEntries;
+
+  /** All setting keys as an array */
+  readonly keys: SettingKey[];
+
+  constructor(config: Partial<RegistryConfig> = {}) {
+    const full: RegistryConfig = { ...DEFAULT_REGISTRY_CONFIG, ...config };
+    this.entries = buildEntries(full);
+    this.keys = Object.keys(this.entries) as SettingKey[];
+  }
+
+  /** Get the default value for a setting */
+  getDefault<K extends SettingKey>(key: K): SettingValue<K> {
+    return this.entries[key].default as SettingValue<K>;
+  }
+
+  /** Get a complete map of all default values */
+  getAllDefaults(): SettingsMap {
+    const defaults = {} as Record<string, unknown>;
+    for (const key of this.keys) {
+      defaults[key] = this.entries[key].default;
+    }
+    return defaults as SettingsMap;
+  }
+
+  /** Get the data type for a setting key */
+  getDataType(key: SettingKey): SettingsDataType {
+    return this.entries[key].type;
+  }
+
+  /** Check whether a setting should be synced */
+  isSynced(key: SettingKey): boolean {
+    return this.entries[key].sync;
+  }
+
+  /** Get all setting keys for a category */
+  getByCategory(category: SettingsCategory): SettingKey[] {
+    return this.keys.filter((key) => this.entries[key].category === category);
+  }
+
+  /** Serialize a setting value to a string for DB storage */
+  serialize(key: SettingKey, value: unknown): string {
+    const dataType = this.getDataType(key);
+    switch (dataType) {
+      case 'string':
+        return String(value ?? '');
+      case 'number':
+        return String(value ?? 0);
+      case 'boolean':
+        if (typeof value === 'string') {
+          return value === 'true' ? 'true' : 'false';
+        }
+        return value ? 'true' : 'false';
+      case 'json':
+        // If already a serialized JSON string, return as-is to avoid
+        // double-wrapping (e.g. JSON.stringify("[]") → "\"[]\"")
+        if (typeof value === 'string') {
+          try {
+            JSON.parse(value);
+            return value;
+          } catch {
+            return JSON.stringify(value);
+          }
+        }
+        return JSON.stringify(value);
+    }
+  }
+
+  /** Deserialize a DB string back to a typed setting value */
+  deserialize<K extends SettingKey>(
+    key: K,
+    raw: string | null,
+  ): SettingValue<K> {
+    if (raw === null || raw === undefined) {
+      return this.getDefault(key);
+    }
+
+    const dataType = this.getDataType(key);
+    switch (dataType) {
+      case 'string':
+        return raw as SettingValue<K>;
+      case 'number':
+        return Number(raw) as SettingValue<K>;
+      case 'boolean':
+        return (raw === 'true') as SettingValue<K>;
+      case 'json':
+        try {
+          let result: unknown = JSON.parse(raw);
+          // Unwrap multiply-escaped JSON strings caused by repeated
+          // double-serialization (each push/pull cycle added a layer)
+          while (typeof result === 'string') {
+            try {
+              result = JSON.parse(result);
+            } catch {
+              break;
+            }
+          }
+          return result as SettingValue<K>;
+        } catch {
+          return this.getDefault(key);
+        }
+    }
+  }
+
+  /**
+   * Get the category for a setting key.
+   * Returns undefined if the key is not recognized.
+   */
+  getCategory(key: string): SettingsCategory | undefined {
+    if (key in this.entries) {
+      return this.entries[key as SettingKey].category;
+    }
+    // Fallback: extract category from dot-prefix
+    const dotIndex = key.indexOf('.');
+    if (dotIndex > 0) {
+      const prefix = key.substring(0, dotIndex);
+      if (SETTINGS_CATEGORIES.includes(prefix as SettingsCategory)) {
+        return prefix as SettingsCategory;
+      }
+    }
+    return undefined;
+  }
+
+  /**
+   * Get a human-readable label for a setting key.
+   * Strips the category prefix and formats the remaining path.
+   * Example: 'lockScreen.inactivityTimeoutMinutes' → 'Inactivity Timeout Minutes'
+   */
+  getSettingLabel(key: string): string {
+    const dotIndex = key.indexOf('.');
+    const name = dotIndex > 0 ? key.substring(dotIndex + 1) : key;
+    // Convert camelCase / dot-separated path to Title Case words
+    return name
+      .replace(/\./g, ' › ')
+      .replace(/([a-z])([A-Z])/g, '$1 $2')
+      .replace(/^./, (c) => c.toUpperCase());
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Snapshot parsing — parse a JSON settings snapshot into categorized groups
+// ---------------------------------------------------------------------------
+
+export type ParsedSettingEntry = {
+  /** The full setting key (e.g. 'lockScreen.inactivityTimeoutMinutes') */
+  key: string;
+  /** The setting name without category prefix (e.g. 'inactivityTimeoutMinutes') */
+  name: string;
+  /** Human-readable label (e.g. 'Inactivity Timeout Minutes') */
+  label: string;
+  /** i18n message key for the label (from SETTINGS_LABELS) */
+  labelKey?: string;
+  /** i18n message key for a description (from SETTINGS_LABELS) */
+  descriptionKey?: string;
+  /** The setting value */
+  value: unknown;
+  /** UI component type for rendering this setting */
+  uiType: SettingUiType;
+  /** Available options for SELECT-type settings */
+  options?: readonly SettingOption[];
+  /** Slider configuration for SLIDER-type settings */
+  sliderConfig?: SliderConfig;
+  /** Only show this setting for enrolled/kiosk devices (undefined = always) */
+  appMode?: 'ENROLLED';
+  /** Only show this setting for a specific calendar type (undefined = always) */
+  calendarType?: CalendarType;
+  /** Show this setting only when condition(s) are met */
+  visibleWhen?: VisibilityRule;
+  /** Disable (but still show) this setting when condition(s) are met */
+  disabledWhen?: DisabledRule;
+};
+
+export type ParsedSettingsGroup = {
+  /** The category key */
+  category: SettingsCategory;
+  /** Human-readable category label */
+  label: string;
+  /** Settings in this category */
+  settings: ParsedSettingEntry[];
+};
+
+/**
+ * Parse a settings JSON snapshot into categorized groups, optionally filtered
+ * by calendar type. This is the single function both web and mobile should use
+ * to display a settings snapshot.
+ *
+ * @param json The raw JSON string from the settings snapshot
+ * @param calendarType Optional calendar type filter — hides irrelevant categories
+ * @param registry Optional registry instance (uses defaultRegistry if omitted)
+ */
+export function parseSettingsSnapshot(
+  json: string | Record<string, unknown>,
+  calendarType?: CalendarType,
+  registry: SettingsRegistry = defaultRegistry,
+): ParsedSettingsGroup[] {
+  let parsed: Record<string, unknown>;
+  if (typeof json === 'string') {
+    try {
+      parsed = JSON.parse(json);
+    } catch {
+      return [];
+    }
+  } else {
+    parsed = json;
+  }
+
+  const groups = new Map<SettingsCategory, ParsedSettingEntry[]>();
+
+  for (const [key, rawValue] of Object.entries(parsed)) {
+    const category = registry.getCategory(key);
+    if (!category) {
+      continue;
+    }
+
+    // Deserialize string values to their native types using the registry
+    let value: unknown = rawValue;
+    if (typeof rawValue === 'string' && key in registry.entries) {
+      value = registry.deserialize(key as SettingKey, rawValue);
+    }
+
+    const dotIndex = key.indexOf('.');
+    const name = dotIndex > 0 ? key.substring(dotIndex + 1) : key;
+
+    if (!groups.has(category)) {
+      groups.set(category, []);
+    }
+
+    const labelDef = SETTINGS_LABELS[key];
+    const entryDef =
+      key in registry.entries ? registry.entries[key as SettingKey] : undefined;
+    groups.get(category)!.push({
+      key,
+      name,
+      label: registry.getSettingLabel(key),
+      labelKey: labelDef?.labelKey,
+      descriptionKey: labelDef?.descriptionKey,
+      value,
+      uiType: entryDef?.uiType ?? 'TEXT_INPUT',
+      ...(entryDef?.options && {
+        options: entryDef.options as readonly SettingOption[],
+      }),
+      ...(entryDef?.sliderConfig && { sliderConfig: entryDef.sliderConfig }),
+      ...(entryDef?.appMode && { appMode: entryDef.appMode }),
+      ...(entryDef?.calendarType && { calendarType: entryDef.calendarType }),
+      ...(entryDef?.visibleWhen && { visibleWhen: entryDef.visibleWhen }),
+      ...(entryDef?.disabledWhen && { disabledWhen: entryDef.disabledWhen }),
+    });
+  }
+
+  // Determine which categories to show
+  const allowedCategories = calendarType
+    ? getCategoriesForCalendarType(calendarType)
+    : [...SETTINGS_CATEGORIES];
+
+  return allowedCategories
+    .filter((cat) => groups.has(cat))
+    .map((category) => ({
+      category,
+      label: CATEGORY_LABELS[category],
+      settings: groups.get(category)!,
+    }));
+}
+
+/**
+ * Format a setting value for display.
+ * Handles booleans, numbers, strings, arrays, objects, and null/undefined.
+ */
+export function formatSettingValue(value: unknown): string {
+  if (value === null || value === undefined) {
+    return '—';
+  }
+  if (typeof value === 'boolean') {
+    return value ? 'true' : 'false';
+  }
+  if (typeof value === 'number') {
+    return String(value);
+  }
+  if (typeof value === 'string') {
+    return value || '""';
+  }
+  if (Array.isArray(value)) {
+    return `[${value.length} items]`;
+  }
+  if (typeof value === 'object') {
+    return JSON.stringify(value);
+  }
+  return String(value);
+}
+
+/**
+ * Serialize a settings object (with mixed native types) into a
+ * string-values-only snapshot suitable for pushing to a mobile device.
+ *
+ * Uses the registry's `serialize()` method for known keys so that
+ * booleans become "true"/"false", numbers become digit strings, etc.
+ * Unknown keys are converted with `String(value)`.
+ */
+export function serializeSettingsSnapshot(
+  settings: Record<string, unknown>,
+  registry: SettingsRegistry,
+): Record<string, string> {
+  const result: Record<string, string> = {};
+  for (const [key, value] of Object.entries(settings)) {
+    if (key in registry.entries) {
+      result[key] = registry.serialize(key as SettingKey, value);
+    } else {
+      result[key] = String(value ?? '');
+    }
+  }
+  return result;
+}
+
+/**
+ * Deserialize a settings snapshot (string values from the server/DB) into
+ * native-typed values using the registry.
+ *
+ * This ensures local state always contains native types (boolean, number, etc.)
+ * so that subsequent `serializeSettingsSnapshot` calls produce correct results.
+ */
+export function deserializeSettingsSnapshot(
+  snapshot: Record<string, unknown>,
+  registry: SettingsRegistry = defaultRegistry,
+): Record<string, unknown> {
+  const result: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(snapshot)) {
+    if (typeof value === 'string' && key in registry.entries) {
+      result[key] = registry.deserialize(key as SettingKey, value);
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Default registry instance (non-enrolled, system theme, nb locale)
+// ---------------------------------------------------------------------------
+
+export const defaultRegistry = new SettingsRegistry();
+
+// ---------------------------------------------------------------------------
+// Factory function — returns raw entry map for local type derivation.
+// Consumers that need precise generic inference (e.g. useQuery<K>) can use
+// this to anchor types on a local const variable.
+// ---------------------------------------------------------------------------
+
+export function createSettingsRegistry(config: Partial<RegistryConfig> = {}) {
+  return buildEntries({ ...DEFAULT_REGISTRY_CONFIG, ...config });
+}