From 4bf37340bdc4469986e0d8ba035fb1c72b2ea720 Mon Sep 17 00:00:00 2001
From: Taksh <takshkothari09@gmail.com>
Date: Sat, 1 Aug 2026 14:11:05 +0300
Subject: [PATCH] docs: note people-sheet filter is display-only

Filtering never mutates PeerListModel row order; clearing the query
restores the full list with existing sticky ordering intact.
---
 bitchat/Utils/PeopleNameFilter.swift | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bitchat/Utils/PeopleNameFilter.swift b/bitchat/Utils/PeopleNameFilter.swift
index 3e3fafdd..0a10fe7d 100644
--- a/bitchat/Utils/PeopleNameFilter.swift
+++ b/bitchat/Utils/PeopleNameFilter.swift
@@ -9,6 +9,9 @@
 import Foundation
 
 /// Case-insensitive nickname / display-name match for the people sheet search field.
+///
+/// Filtering is display-only: callers never mutate `PeerListModel` row order.
+/// Clearing the query restores the full list with existing sticky ordering.
 enum PeopleNameFilter {
     /// Empty / whitespace-only queries match everything (no filter active).
     static func matches(_ displayName: String, query: String) -> Bool {