121 lines
7.5 KiB
Markdown
121 lines
7.5 KiB
Markdown
# WinterGram — feature → implementation map
|
|
|
|
> Developer reference. User-facing overview: [`docs/FEATURES.md`](FEATURES.md).
|
|
|
|
This document maps every WinterGram option to where it is wired into the
|
|
codebase. The settings themselves live in a single store:
|
|
|
|
- `submodules/TelegramUIPreferences/Sources/WinterGramSettings.swift` — the `WinterGramSettings`
|
|
`Codable` struct, its sub-structs (`WinterGramLiquidGlass`) and enums, plus
|
|
`updateWinterGramSettingsInteractively(...)`, `winterGramSettings(accountManager:)`, and the
|
|
synchronous snapshot `currentWinterGramSettings` (kept fresh by
|
|
`observeWinterGramSettings(accountManager:)`, started from `AppDelegate`).
|
|
- `submodules/TelegramUIPreferences/Sources/PostboxKeys.swift` — the shared-data key
|
|
`ApplicationSpecificSharedDataKeys.winterGramSettings` (value `23`).
|
|
- `submodules/TelegramCore/Sources/WinterGram/WinterGramCoreSettings.swift` — a minimal
|
|
mirror for hooks inside `TelegramCore` (which cannot import `TelegramUIPreferences`);
|
|
fed by the same observer.
|
|
|
|
Read the store anywhere that already has an `AccountContext` / `AccountManager` via
|
|
`winterGramSettings(accountManager:)` (reactive) or `currentWinterGramSettings` (sync),
|
|
and write it via `updateWinterGramSettingsInteractively`.
|
|
|
|
## Status legend
|
|
|
|
- ✅ — setting persists and the behavior hook is in place.
|
|
- ⏳ — setting persists, behavior not fully hooked yet.
|
|
|
|
## Privacy & Ghost Mode
|
|
|
|
| Setting | Status | Hook |
|
|
| :-- | :-- | :-- |
|
|
| `ghostModeEnabled` | ✅ | Master switch read by the gates below. |
|
|
| `sendReadReceipts` | ✅ | `AccountContext.applyMaxReadIndex` (`submodules/TelegramUI/Sources/AccountContext.swift`) returns early in ghost mode. |
|
|
| `sendReadStories` | ✅ | All four `markAsSeen` implementations in `StoryChatContent.swift` return early in ghost mode. |
|
|
| `sendOnlineStatus` | ✅ | `SharedWakeupManager` forces `shouldKeepOnlinePresence` to false in ghost mode. |
|
|
| `sendUploadProgress` | ✅ | Typing-activity subscription in `ChatController.swift` skips `updateLocalInputActivity` in ghost mode. |
|
|
| `sendOfflineAfterOnline` | ⏳ | Emit a one-shot offline presence packet after going online. |
|
|
| `markReadAfterAction` | ⏳ | After replying/reacting, locally mark read without sending receipts. |
|
|
| `useScheduledMessages` | ✅ | "Отложка": `transformEnqueueMessages` in `ChatController.swift` routes ghost-mode sends through the scheduled path (now + 12 s) so sending doesn't mark the chat read. |
|
|
| `sendWithoutSound` | ✅ | `transformEnqueueMessages` computes `effectiveSilentPosting` from never / in-ghost / always. |
|
|
| `suggestGhostBeforeStory` | ⏳ | Story viewer — present the ghost confirmation before opening. |
|
|
|
|
## History & Recovery
|
|
|
|
| Setting | Status | Hook |
|
|
| :-- | :-- | :-- |
|
|
| `saveDeletedMessages` | ✅ | Remote deletions (`.DeleteMessages` / `.DeleteMessagesWithGlobalIds`) skipped in `AccountStateManagementUtils.swift` via `currentWinterGramCoreSettings`. |
|
|
| `saveMessagesHistory` | ✅ | On remote `.EditMessage`, the previous text/entities/timestamp are appended to `WinterGramEditHistoryAttribute` (`submodules/TelegramCore/Sources/WinterGram/`); registered in `AccountManager.swift`. Viewing UI: ⏳. |
|
|
| `semiTransparentDeletedMessages` | ⏳ | Render kept-deleted bubbles at reduced alpha. |
|
|
|
|
## Hidden Archive ("ААрхив")
|
|
|
|
| Setting | Status | Hook |
|
|
| :-- | :-- | :-- |
|
|
| `stashedPeerIds` | ✅ | Hidden from the main tab in `ChatListNodeEntries.swift`; stash/unstash via chat-list context menu (`ChatContextMenus.swift`); browse via Settings → WinterGram → Stashed Chats (`WinterGramStashController.swift`). |
|
|
| `stashMuteNotifications` | ✅ | In-app notification pipeline in `ApplicationContext.swift` drops banners for stashed peers. (APNs pushes need the NotificationService extension: ⏳.) |
|
|
| `stashAutoMarkRead` | ✅ | Same pipeline calls `applyMaxReadIndexInteractively` for stashed peers. |
|
|
|
|
## Anti-Features
|
|
|
|
| Setting | Status | Hook |
|
|
| :-- | :-- | :-- |
|
|
| `disableAds` | ✅ | Ad insertion gate in `ChatHistoryEntriesForView.swift`. |
|
|
| `localPremium` | ✅ | `isPremium` resolution in `submodules/TelegramUI/Sources/AccountContext.swift`. |
|
|
| `shadowBanIds` | ✅ | Entry filter by author in `ChatHistoryEntriesForView.swift`. |
|
|
| `disableStories` | ✅ | `shouldDisplayStoriesInChatListHeader` in `ChatListControllerNode.swift` returns false. |
|
|
| `hidePremiumStatuses` | ✅ | `ChatTitleView` / `ChatTitleComponent` / `ChatListItem` / `ItemListPeerItem`. |
|
|
| `disableOpenLinkWarning` | ✅ | Concealed-link alert gate in `OpenUserGeneratedUrl.swift`. |
|
|
|
|
## In-app purchases
|
|
|
|
Fully disabled: `InAppPurchaseManager.buyProduct` fails immediately with `.cantMakePayments`
|
|
(every purchase screen maps that to a localized error), and `PremiumIntroScreen.buy()` shows a
|
|
"subscribe via the official Telegram app" alert before reaching the manager. Redeeming gift
|
|
codes still works (not an IAP).
|
|
|
|
## Chat Conveniences
|
|
|
|
| Setting | Status | Hook |
|
|
| :-- | :-- | :-- |
|
|
| `stickerConfirmation` / `gifConfirmation` | ✅ | `ChatController.swift` send paths. |
|
|
| `voiceConfirmation` | ✅ | `ChatControllerMediaRecording.swift`. |
|
|
| `showMessageSeconds` | ✅ | `StringForMessageTimestampStatus.swift`. |
|
|
| `showPeerId` | ✅ | ID row (long-press copies) in `PeerInfoProfileItems.swift` for users and channels/groups, honoring Telegram/Bot-API format. |
|
|
| `translateMessages` / `translationProvider` | ⏳ | Message context-menu translate + provider. |
|
|
| `webviewSpoofPlatform` | ✅ | `BotWebView.swift` in TelegramCore reads `currentWinterGramCoreSettings.webviewPlatform` (ios / android / macos / tdesktop), fed by the settings observer. |
|
|
| `increaseWebviewHeight` | ⏳ | WebApp controller viewport. |
|
|
|
|
## Appearance & Customization
|
|
|
|
| Setting | Status | Hook |
|
|
| :-- | :-- | :-- |
|
|
| `liquidGlass.*` | ⏳ | Blur/material layers behind chat list, nav bar, tab bar. |
|
|
| `materialDesign` | ⏳ | Switch/control styling. |
|
|
| `avatarCornerRadius` / `singleCornerRadius` | ⏳ | `AvatarNode` corner rounding. Note: photos are circle-clipped inside the bitmap (`PeerAvatar.swift` `roundCorners` mask), so a real implementation must touch every render path, not just `imageNode.cornerRadius`. |
|
|
| `messageBubbleRadius` / `removeMessageTail` | ⏳ | Bubble background drawing. |
|
|
| `customFont` / `monoFont` | ⏳ | `PresentationData` font resolution. |
|
|
| `appIcon` / `iconPack` | ⏳ | Alternate-icon switching; assets in `DefaultAppIcon.xcassets/WinterGramDarkIcon.appiconset`. |
|
|
| `showOnlyAddedEmojisAndStickers` | ⏳ | Emoji/sticker panel data sources. |
|
|
|
|
## Accounts
|
|
|
|
- Unlimited accounts: `maximumNumberOfAccounts` / `maximumPremiumNumberOfAccounts` = 100 in
|
|
`submodules/AccountUtils/Sources/AccountUtils.swift`; the add-account flow in
|
|
`PeerInfoScreenSettingsActions.swift` uses the same constants.
|
|
- Account data is included in iCloud/iTunes device backups (`isExcludedFromBackup = false` in
|
|
`TelegramCore/Sources/Account/AccountManager.swift`). Tradeoff: session auth keys become part
|
|
of the backup.
|
|
|
|
## Deep links — `wnt://`
|
|
|
|
Registered in `Telegram/Telegram-iOS/Info.plist` and `InfoBazel.plist` (alongside `tg`).
|
|
Normalized to `tg://` at the app entry by `normalizeWinterGramUrlScheme(_:)` in
|
|
`submodules/TelegramUI/Sources/AppDelegate.swift`, so every `tg://` route also accepts `wnt://`.
|
|
|
|
## Settings UI
|
|
|
|
The **WinterGram** entry is the first row of Settings (snowball icon,
|
|
`PresentationResourcesSettings.winterGram`), opening
|
|
`submodules/SettingsUI/Sources/WinterGramSettingsController.swift`. The Hidden Archive browser
|
|
lives in `WinterGramStashController.swift` next to it.
|