MetaList 0.22.0__tar.gz → 0.24.0__tar.gz

{metalist-0.22.0/metalist.egg-info → metalist-0.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metalist
-Version: 0.22.0
+Version: 0.24.0
 Summary: A minimalist single-user note-taking app with SSR, fast in-memory tree operations, and efficient sync.
 Project-URL: Homepage, https://metalist.app
 Project-URL: Repository, https://github.com/metalist-app/metalist
@@ -36,7 +36,7 @@ Provides-Extra: dev
 Requires-Dist: hypothesis==6.164.0; extra == "dev"
 Requires-Dist: pytest==9.1.1; extra == "dev"
 Requires-Dist: pytest-cov==7.1.0; extra == "dev"
-Requires-Dist: shockharness==0.17.0; extra == "dev"
+Requires-Dist: shockharness==0.26.0; extra == "dev"
 Requires-Dist: mypy==2.4.0; extra == "dev"
 
 # MetaList
@@ -53,6 +53,31 @@ A minimalist single-user note-taking app focused on server-side rendering (SSR),
 - Multi-tab search contexts with server-persisted scroll/search state (survives browser restarts)
 - Manual namespace backups/restores to a user-selected backup folder with retention controls
 
+## Changes in 0.24.0
+
+- **Super tags.** A tag can carry values: `jogging:miles=3:duration=30`, `drug:dosage=10mg`, `run:start=10:30pm`. Search by them with `jogging:miles>2`, `jogging:miles?` (notes missing it), `date>=2024-01`, or `jogging:miles=MAX` / `=MIN` for the largest or smallest among the notes found. Values compare as numbers (a unit is a label: `dosage>5mg` compares only mg, `dosage>5` every unit), dates, times (`10:30pm` = `22:30`) or text. A search reads values through tag rules too: with `jogging => exercise`, `exercise:miles>2` finds your runs. The tag bar and the search box suggest the property names and units you already use, and `MAX`/`MIN` after `=`. A plain `jogging` search still finds `jogging:miles=3`; children inherit the tag, never its values.
+- Tag rules can test values: `jogging:miles>10 => long-run`, `task:due? => needs-date`. The tag a rule gives passes to the note's children; Edit Tag Relationships shows such a rule in the left column of the tag it gives, suggests names and units while you type one, and warns about a property no note has (a typo). Saving one re-tags only the notes it can concern.
+- The AI can propose super tags with values a note states (`jogging:miles=3` for "ran 3 miles"), reusing your property names and units; accepting one adds its values to the note's tag.
+- **Date range** (right-click menu, search box menu and command palette): show only notes created, or last updated, today, in the last 7 or 30 days, this year, or in a custom range. A chip in the search box names it; its `×`, a new search or leaving the tab ends it.
+- File names are searchable: a quoted search (`"congratulation"`) and find (Cmd/Ctrl+F) match the names of files a note holds, and the AI sees them.
+- ⌘+ / ⌘− with the pointer on a picture or diagram makes it bigger or smaller, viewing or editing.
+- Right-clicking the search box past what you typed offers View, Sort by and Date range.
+
+## Changes in 0.23.0
+
+- **Reference views.** Following a reference (a link, an embed's reference icon, Go to Source Note) or an AI answer's references slides the list to the left, and a gray chip takes the search box's place: **Source note** (its first line is the tooltip), **Reference** or **All references**. `←` or Escape goes back one level, `×` straight back to your search, each to the exact place you left; the list slides back to the right. With Reduce Motion it is a quick fade. The magnifier beside the chip starts a new search. Reference tabs keep their label and chip after a reload and in every window: no tab is named by a note ID any more.
+- One reference icon, a page with an arrow coming into it, on embeds, links, the chip, the tab list and the right-click menu's **Go to Source Note**; All references has two pages. A collapsed embed shows its source's first line in its own formatting (a green heading stays a green heading), and embeds are a shade darker grey, deeper again for an embed inside an embed.
+- Sort orders and Untagged show as chips inside the search box (`Created`, `Updated`, `A–Z`, `Size`, `Untagged`; the full name is the tooltip). New **Reverse Order** in Sort by works with any order: Z to A, oldest or smallest first, or your own order bottom to top. Typing a new search or leaving a tab ends its sort; a new tab starts unsorted; a reference view and back keeps it.
+- Right-clicking the list offers **Paste Note as Reference at Top** (⌘R) beside Paste Note at Top.
+- Backlinks (`↖`) are hidden for now, until they have a sign of their own.
+- Coming back to a tab, or from a reference view, lands exactly where you were; a note just below the top could put you up to 80px further down.
+- **Find in the list** (Cmd/Ctrl+F) finds text far below the loaded notes and inside folded ones; a folded match opens just for the find.
+- Namespaces are called **vaults** on screen; `--vault` works like `--namespace`.
+- Edit tag relationships: suggestions list tags linked to the focus tag first, a condition shows one part per line, and with no focus tag the `+` buttons are dimmed instead of stopping MetaList.
+- A file link downloads only from its badge and name; a click beside it edits the note.
+- Make Bigger, Make Smaller and Reset Size keep the caret on its side of the image.
+- Logging out while a log entry was being written could close the log under it; the logout now waits.
+
 ## Changes in 0.22.0
 
 - Tag suggestions only narrow as you type, however many letters: `q`, `qu`, `que` keep their order, and a tag that already applies (a parent's, or implied by a rule) stays right after the tags with evidence instead of dropping to the bottom. Each letter after the first answers in a few milliseconds. Measured on a 107,000-note namespace, the wanted tag is in the top five more often after two and three letters (90% and 96%, up from 88% and 93%).

{metalist-0.22.0 → metalist-0.24.0}/README.md

@@ -12,6 +12,31 @@ A minimalist single-user note-taking app focused on server-side rendering (SSR),
 - Multi-tab search contexts with server-persisted scroll/search state (survives browser restarts)
 - Manual namespace backups/restores to a user-selected backup folder with retention controls
 
+## Changes in 0.24.0
+
+- **Super tags.** A tag can carry values: `jogging:miles=3:duration=30`, `drug:dosage=10mg`, `run:start=10:30pm`. Search by them with `jogging:miles>2`, `jogging:miles?` (notes missing it), `date>=2024-01`, or `jogging:miles=MAX` / `=MIN` for the largest or smallest among the notes found. Values compare as numbers (a unit is a label: `dosage>5mg` compares only mg, `dosage>5` every unit), dates, times (`10:30pm` = `22:30`) or text. A search reads values through tag rules too: with `jogging => exercise`, `exercise:miles>2` finds your runs. The tag bar and the search box suggest the property names and units you already use, and `MAX`/`MIN` after `=`. A plain `jogging` search still finds `jogging:miles=3`; children inherit the tag, never its values.
+- Tag rules can test values: `jogging:miles>10 => long-run`, `task:due? => needs-date`. The tag a rule gives passes to the note's children; Edit Tag Relationships shows such a rule in the left column of the tag it gives, suggests names and units while you type one, and warns about a property no note has (a typo). Saving one re-tags only the notes it can concern.
+- The AI can propose super tags with values a note states (`jogging:miles=3` for "ran 3 miles"), reusing your property names and units; accepting one adds its values to the note's tag.
+- **Date range** (right-click menu, search box menu and command palette): show only notes created, or last updated, today, in the last 7 or 30 days, this year, or in a custom range. A chip in the search box names it; its `×`, a new search or leaving the tab ends it.
+- File names are searchable: a quoted search (`"congratulation"`) and find (Cmd/Ctrl+F) match the names of files a note holds, and the AI sees them.
+- ⌘+ / ⌘− with the pointer on a picture or diagram makes it bigger or smaller, viewing or editing.
+- Right-clicking the search box past what you typed offers View, Sort by and Date range.
+
+## Changes in 0.23.0
+
+- **Reference views.** Following a reference (a link, an embed's reference icon, Go to Source Note) or an AI answer's references slides the list to the left, and a gray chip takes the search box's place: **Source note** (its first line is the tooltip), **Reference** or **All references**. `←` or Escape goes back one level, `×` straight back to your search, each to the exact place you left; the list slides back to the right. With Reduce Motion it is a quick fade. The magnifier beside the chip starts a new search. Reference tabs keep their label and chip after a reload and in every window: no tab is named by a note ID any more.
+- One reference icon, a page with an arrow coming into it, on embeds, links, the chip, the tab list and the right-click menu's **Go to Source Note**; All references has two pages. A collapsed embed shows its source's first line in its own formatting (a green heading stays a green heading), and embeds are a shade darker grey, deeper again for an embed inside an embed.
+- Sort orders and Untagged show as chips inside the search box (`Created`, `Updated`, `A–Z`, `Size`, `Untagged`; the full name is the tooltip). New **Reverse Order** in Sort by works with any order: Z to A, oldest or smallest first, or your own order bottom to top. Typing a new search or leaving a tab ends its sort; a new tab starts unsorted; a reference view and back keeps it.
+- Right-clicking the list offers **Paste Note as Reference at Top** (⌘R) beside Paste Note at Top.
+- Backlinks (`↖`) are hidden for now, until they have a sign of their own.
+- Coming back to a tab, or from a reference view, lands exactly where you were; a note just below the top could put you up to 80px further down.
+- **Find in the list** (Cmd/Ctrl+F) finds text far below the loaded notes and inside folded ones; a folded match opens just for the find.
+- Namespaces are called **vaults** on screen; `--vault` works like `--namespace`.
+- Edit tag relationships: suggestions list tags linked to the focus tag first, a condition shows one part per line, and with no focus tag the `+` buttons are dimmed instead of stopping MetaList.
+- A file link downloads only from its badge and name; a click beside it edits the note.
+- Make Bigger, Make Smaller and Reset Size keep the caret on its side of the image.
+- Logging out while a log entry was being written could close the log under it; the logout now waits.
+
 ## Changes in 0.22.0
 
 - Tag suggestions only narrow as you type, however many letters: `q`, `qu`, `que` keep their order, and a tag that already applies (a parent's, or implied by a rule) stays right after the tags with evidence instead of dropping to the bottom. Each letter after the first answers in a few milliseconds. Measured on a 107,000-note namespace, the wanted tag is in the top five more often after two and three letters (90% and 96%, up from 88% and 93%).

{metalist-0.22.0 → metalist-0.24.0}/app/api/note_requests.py

@@ -56,18 +56,26 @@ class Viewport(TypedDict):
     scrollY: Nonnegative
     scrollAnchor: ScrollAnchor | None
 
+# A root sort order, and the same order reversed (app/services/root_sorting.py).
+SortMode = Literal[
+    'normal', 'created', 'updated', 'alphabetical', 'content-volume',
+    'normal-reversed', 'created-reversed', 'updated-reversed', 'alphabetical-reversed', 'content-volume-reversed',
+]
+
 @with_config(ConfigDict(strict=True))
 class Tab(TypedDict):
     searchQuery: Text
     scrollY: Nonnegative
     anchorRootId: Text | None
     scrollAnchor: ScrollAnchor | None
-    sortMode: Literal['normal', 'created', 'updated', 'alphabetical', 'content-volume']
+    sortMode: SortMode
 
 @with_config(ConfigDict(strict=True))
 class ViewDiffRequest(TypedDict):
     clientId: Identifier
     editingNoteId: Text | None
+    # The note find opened to show a match folded away, for this view only (docs/ui/find.md).
+    findRevealNoteId: Text | None
     search: Text | None
     tabId: Identifier
     undoContext: UndoContext
@@ -77,16 +85,54 @@ class ViewDiffRequest(TypedDict):
     isUntaggedView: bool
     startAtListEnd: bool
 
+# Find in the list (docs/ui/find.md): one step from a root position of the view.
+@with_config(ConfigDict(strict=True))
+class FindInListRequest(TypedDict):
+    tabId: Identifier
+    search: Text | None
+    isUntaggedView: bool
+    text: Annotated[str, Field(min_length=1, max_length=KIB)]
+    fromRootIndex: Nonnegative
+    direction: Literal['forward', 'backward']
+
+@with_config(ConfigDict(strict=True))
+class ReferenceOriginScope(TypedDict):
+    scopeTabId: Identifier
+    searchQuery: Text
+    sortMode: SortMode
+    isUntaggedView: bool
+
+# A tab showing a reference view, opened from another tab (app/services/tab_state.py).
+@with_config(ConfigDict(strict=True))
+class ReferenceView(TypedDict):
+    fromTabId: Identifier
+    referenceQuery: Text
+    viewKind: Literal['source', 'backlinks', 'reference', 'references']
+    originScope: ReferenceOriginScope
+
 @with_config(ConfigDict(strict=True))
 class UpdateTabStateRequest(TypedDict):
     activeTabId: Identifier
     tabs: dict[Identifier, Tab]
     tabOrder: list[Identifier]
+    referenceViews: dict[Identifier, ReferenceView]
 
 @with_config(ConfigDict(strict=True))
 class UpdateTabSortModeRequest(TypedDict):
     tabId: Identifier
-    sortMode: Literal['normal', 'created', 'updated', 'alphabetical', 'content-volume']
+    sortMode: SortMode
+    clientId: Identifier
+    undoContext: UndoContext
+
+@with_config(ConfigDict(strict=True))
+class UpdateTabDateFilterRequest(TypedDict):
+    tabId: Identifier
+    field: Literal["created", "updated"]
+    # "none" shows every date again.
+    rangeKind: Literal["none", "today", "last-7-days", "last-30-days", "this-year", "custom"]
+    # A custom range's ends (YYYY-MM-DD); "" for an open end, and for every other range.
+    fromDate: Text
+    toDate: Text
     clientId: Identifier
     undoContext: UndoContext
 
@@ -126,7 +172,7 @@ class TabSearchInteractionRequest(TypedDict):
 class DictationPasteRequest(TypedDict):
     """Text pasted into the search bar or the tag bar, and the field's current value."""
     text: Text
-    target: Literal["search", "tags", "tag", "condition"]
+    target: Literal["search", "tags", "tag"]
     current_value: Text
     # The spoken phrases around a quoted phrase (Dictation Settings).
     quote_open: Identifier

{metalist-0.22.0 → metalist-0.24.0}/app/api/routes/ai.py

@@ -498,6 +498,7 @@ def suggest_tags_for_note_with_ai(
     scope = resolve_view_scope_membership(
         search=payload.search,
         sort_mode=tab_state_store.get_sort_mode(tab_id=payload.tab_id),
+        date_filter=tab_state_store.get_date_filter(tab_id=payload.tab_id),
         is_untagged_view=payload.is_untagged_view,
     )
     if note_id not in scope.allowed_note_ids:
@@ -559,6 +560,7 @@ def _export_title_request(scope: ExportTitleScope, token: str) -> ExportTitleReq
     root_ids, allowed_note_ids = resolve_export_scope(
         search=search,
         sort_mode=tab_state_store.get_sort_mode(tab_id=scope.tab_id),
+        date_filter=tab_state_store.get_date_filter(tab_id=scope.tab_id),
         is_untagged_view=scope.is_untagged_view, root_note_id=note_id,
     )
     boundary = resolve_cloud_privacy_boundary(preferences=load_client_preferences(token=token), provider=scope.provider)
@@ -903,21 +905,26 @@ def stream_ai_chat(
     authoritative_sort_mode = tab_state_store.get_sort_mode(
         tab_id=payload.scope.scope_tab_id
     )
+    authoritative_date_filter = tab_state_store.get_date_filter(tab_id=payload.scope.scope_tab_id)
     active_search_query = authoritative_search_query
     active_sort_mode = authoritative_sort_mode
+    active_date_filter = authoritative_date_filter
     if payload.selected_note_id and payload.scope.active_tab_id != payload.scope.scope_tab_id:
         active_search_query = tab_state_store.get_search_query(tab_id=authoritative_active_tab_id)
         active_sort_mode = tab_state_store.get_sort_mode(tab_id=authoritative_active_tab_id)
+        active_date_filter = tab_state_store.get_date_filter(tab_id=authoritative_active_tab_id)
     frozen_scope = scoped_search_snapshot_factory.freeze(
         descriptor=payload.scope,
         authoritative_search_query=authoritative_search_query,
         authoritative_sort_mode=authoritative_sort_mode,
+        authoritative_date_filter=authoritative_date_filter,
         run_id=str(uuid4()),
         session_key=session_key,
         privacy_boundary=privacy_boundary,
         selected_note_id=payload.selected_note_id,
         authoritative_active_search_query=active_search_query,
         authoritative_active_sort_mode=active_sort_mode,
+        authoritative_active_date_filter=active_date_filter,
     )
     tagging_run = TaggingRun(token=token, snapshot=frozen_scope, privacy_boundary=privacy_boundary,
         preferences=preferences, sync_uuid=get_current_sync_uuid(),
@@ -1054,7 +1061,9 @@ def manage_bulk_proposals(payload: BulkManageRequest, token: Annotated[str, Depe
         raise HTTPException(status_code=HTTPStatus.CONFLICT, detail="Search context changed")
     async def execute():
         with bulk_operation_guard.acquire(token_service.get_session_key(token)):
-            note_ids = proposal_scope_ids(payload.scope)
+            note_ids = proposal_scope_ids(
+                payload.scope, date_filter=tab_state_store.get_date_filter(tab_id=payload.scope.scope_tab_id),
+            )
             if payload.target == "namespace":
                 note_ids = tuple(note_store.list_note_ids())
             changes, count, _ = prepare_proposal_changes(

{metalist-0.22.0 → metalist-0.24.0}/app/api/routes/auth.py

@@ -1024,7 +1024,7 @@ def namespace_delete_job_status(
         exc = job_record_capture.captured_exception
         raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail=str(exc)) from exc
     if job_record is None:
-        raise HTTPException(status_code=HTTPStatus.NOT_FOUND, detail=f"Namespace deletion job not found: {job_id}")
+        raise HTTPException(status_code=HTTPStatus.NOT_FOUND, detail=f"Vault deletion job not found: {job_id}")
     return job_record
 
 
@@ -1038,7 +1038,7 @@ def namespace_rename_job_status(job_id: str):
         exc = job_record_capture.captured_exception
         raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail=str(exc)) from exc
     if job_record is None:
-        raise HTTPException(status_code=HTTPStatus.NOT_FOUND, detail=f"Namespace rename job not found: {job_id}")
+        raise HTTPException(status_code=HTTPStatus.NOT_FOUND, detail=f"Vault rename job not found: {job_id}")
     return job_record
 
 

{metalist-0.22.0 → metalist-0.24.0}/app/api/routes/backups.py

@@ -301,7 +301,7 @@ def _normalize_selected_namespaces(*, selected_namespaces: list[str]) -> list[st
         raise TypeError("selected_namespaces must be a list")
     normalized_selected_namespaces = _order_namespaces(namespaces=selected_namespaces)
     if len(normalized_selected_namespaces) == 0:
-        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="Select at least one namespace to back up")
+        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="Select at least one vault to back up")
     return normalized_selected_namespaces
 
 
@@ -310,7 +310,7 @@ def _require_existing_selected_namespaces(*, selected_namespaces: list[str]) ->
     for namespace in normalized_selected_namespaces:
         database_path = resolve_namespaced_database_path(namespace=namespace)
         if not database_path.is_file():
-            raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail=f"Selected namespace has no database yet: {namespace}")
+            raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail=f"Selected vault has no database yet: {namespace}")
     return normalized_selected_namespaces
 
 
@@ -324,7 +324,7 @@ def _filter_deleted_selected_namespaces(*, selected_namespaces: list[str]) -> li
     if len(existing_selected_namespaces) == 0:
         raise HTTPException(
             status_code=HTTPStatus.BAD_REQUEST,
-            detail="None of the selected backup namespaces still exist",
+            detail="None of the selected backup vaults still exist",
         )
     return existing_selected_namespaces
 
@@ -583,7 +583,7 @@ def _verify_target_namespace_password(*, target_namespace: str, password: str) -
     if not _target_auth_settings_have_password(settings=settings):
         return
     if password == "":
-        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="Target namespace password is required")
+        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="Target vault password is required")
 
     assert settings is not None
     auth_salt = settings["auth_salt"]
@@ -610,7 +610,7 @@ def _verify_target_namespace_password(*, target_namespace: str, password: str) -
         parallelism,
     ).hex()
     if not secrets.compare_digest(candidate, auth_verifier):
-        raise HTTPException(status_code=HTTPStatus.FORBIDDEN, detail="Target namespace password is incorrect")
+        raise HTTPException(status_code=HTTPStatus.FORBIDDEN, detail="Target vault password is incorrect")
 
 
 def _collect_import_profile_port_conflicts(
@@ -633,7 +633,7 @@ def _collect_import_profile_port_conflicts(
             continue
         conflict_namespace, conflict_service = occupied_ports[port]
         conflicts.append(
-            f"{service} port {port} conflicts with {conflict_service} port reserved for namespace {conflict_namespace}"
+            f"{service} port {port} conflicts with {conflict_service} port reserved for vault {conflict_namespace}"
         )
     return conflicts
 
@@ -959,7 +959,7 @@ def restore_backup_preflight(
 
     folder_namespace, folder_filename = _parse_folder_backup_id(payload.backup_id)
     if folder_namespace != backup_namespace:
-        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup namespace does not match payload")
+        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup vault does not match payload")
     if folder_filename != payload.backup_filename:
         raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup filename does not match payload")
     settings = load_backup_settings(token=token)
@@ -1030,7 +1030,7 @@ def restore_backup(
 
     folder_namespace, folder_filename = _parse_folder_backup_id(payload.backup_id)
     if folder_namespace != backup_namespace:
-        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup namespace does not match payload")
+        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup vault does not match payload")
     if folder_filename != payload.backup_filename:
         raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup filename does not match payload")
     settings = load_backup_settings(token=token)
@@ -1101,7 +1101,7 @@ def import_backup(
     if target_exists and not payload.overwrite_existing_target:
         raise HTTPException(
             status_code=HTTPStatus.CONFLICT,
-            detail=f"Target namespace already exists: {target_namespace}",
+            detail=f"Target vault already exists: {target_namespace}",
         )
     if target_exists:
         _verify_target_namespace_password(
@@ -1112,7 +1112,7 @@ def import_backup(
     target_database_path = resolve_namespaced_database_path(namespace=target_namespace)
     folder_namespace, folder_filename = _parse_folder_backup_id(payload.backup_id)
     if folder_namespace != backup_namespace:
-        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup namespace does not match payload")
+        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup vault does not match payload")
     if folder_filename != payload.backup_filename:
         raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="folder backup filename does not match payload")
     settings = load_backup_settings(token=token)

{metalist-0.22.0 → metalist-0.24.0}/app/api/routes/notes.py

@@ -11,7 +11,9 @@ from pydantic import BaseModel
 
 from app.api.note_requests import (
     ViewDiffRequest,
+    FindInListRequest,
     UpdateTabStateRequest,
+    UpdateTabDateFilterRequest,
     UpdateTabSortModeRequest,
     CreateNewTabRequest,
     DeleteTabRequest,
@@ -62,7 +64,16 @@ from app.api.note_requests import (
 )
 from app.api.transactions import serialized_read_route, transactional_route
 from app.services.sync import touch_client
+from app.services.root_date_filter import DATE_RANGE_NONE
+from app.services.tag_properties import PROPERTY_SUGGESTIONS_IN_SEARCH
+from app.services.tag_properties import PROPERTY_SUGGESTIONS_IN_TAG_BAR
+from app.services.tag_properties import PropertySuggestion
+from app.services.tag_properties import has_property_syntax
+from app.services.tag_properties import is_property_term
+from app.services.root_date_filter import RootDateFilter
+from app.services.root_date_filter import make_root_date_filter
 from app.services.snapshot import build_view_state
+from app.services.snapshot import find_in_view
 from app.services.snapshot import resolve_search_scope
 from app.services.snapshot import resolve_view_scope_membership
 from app.services.note_store import store as note_store
@@ -260,6 +271,13 @@ def _resolve_tab_sort_mode(tab_id: object) -> str:
     return sort_mode
 
 
+def _resolve_tab_date_filter(tab_id: str) -> RootDateFilter | None:
+    """The tab's date range filter (None: every date), as its sort order is resolved."""
+    if not isinstance(tab_id, str) or tab_id == "":
+        raise TypeError("tabId must be a non-empty string")
+    return tab_state_store.get_date_filter(tab_id=tab_id)
+
+
 def _block_root_reorder_when_sorted(note_id: str, *, tab_id: object, new_parent_id: object) -> None:
     sort_mode = _resolve_tab_sort_mode(tab_id)
     if not is_root_reorder_locked(sort_mode):
@@ -300,6 +318,7 @@ def view_diff(payload: ViewDiffRequest):
     client_id = payload["clientId"]
     touch_client(client_id)
     editing_note_id = payload["editingNoteId"]
+    find_reveal_note_id = payload["findRevealNoteId"]
     search = payload["search"]
     tab_id = payload["tabId"]
     undo_context = payload["undoContext"]
@@ -341,6 +360,10 @@ def view_diff(payload: ViewDiffRequest):
         if not note_store.has_note(normalized_editing_note_id):
             normalized_editing_note_id = None
 
+    # Like editingNoteId, the note find opened can be gone by now (deleted, undone).
+    if find_reveal_note_id is not None and not note_store.has_note(find_reveal_note_id):
+        find_reveal_note_id = None
+
     # The server keeps each tab's warm view (what that browser tab displays),
     # so the browser sends only where it is. A tab with no warm view, or one
     # whose browser shows nothing for it, gets its initial window.
@@ -357,8 +380,10 @@ def view_diff(payload: ViewDiffRequest):
 
     state = build_view_state(
         editing_note_id=normalized_editing_note_id,
+        find_reveal_note_id=find_reveal_note_id,
         search=normalized_search,
         sort_mode=sort_mode,
+        date_filter=_resolve_tab_date_filter(tab_id),
         client_known_note_ids=client_known_note_ids,
         previous_root_ids=previous_root_ids,
         visible_top_root_id=visible_top_root_id,
@@ -414,17 +439,26 @@ def get_tab_state() -> Dict[str, object]:
 @router.post("/notes/tab-state")
 @transactional_route
 def update_tab_state(payload: UpdateTabStateRequest) -> Dict[str, object]:
-    if "activeTabId" not in payload or "tabs" not in payload or "tabOrder" not in payload:
-        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="activeTabId, tabs, and tabOrder are required")
+    if (
+        "activeTabId" not in payload or "tabs" not in payload or "tabOrder" not in payload
+        or "referenceViews" not in payload
+    ):
+        raise HTTPException(
+            status_code=HTTPStatus.BAD_REQUEST,
+            detail="activeTabId, tabs, tabOrder, and referenceViews are required",
+        )
     active_tab_id = payload["activeTabId"]
     tabs = payload["tabs"]
     tab_order = payload["tabOrder"]
+    reference_views = payload["referenceViews"]
     if not isinstance(tab_order, list):
         raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="tabOrder must be a list")
     tab_order_list = [str(entry) for entry in tab_order]
     capture = CapturedExceptionContext(InputRejected, boundary='app/api/routes/notes.py:update_tab_state:capture')
     with capture:
-        response = tab_state_store.update(active_tab_id=active_tab_id, tabs=tabs, tab_order=tab_order_list)
+        response = tab_state_store.update(
+            active_tab_id=active_tab_id, tabs=tabs, tab_order=tab_order_list, reference_views=reference_views,
+        )
     if capture.captured_exception is not None:
         raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="Invalid or stale tab state") from capture.captured_exception
     return response
@@ -457,6 +491,23 @@ def update_tab_sort_mode(payload: UpdateTabSortModeRequest) -> Dict[str, object]
     return response
 
 
+@router.post("/notes/tab-state/date-filter")
+@transactional_route
+def update_tab_date_filter(payload: UpdateTabDateFilterRequest) -> Dict[str, object]:
+    """Set or clear a tab's date range filter (root_date_filter.py). A range that is
+    not one (its start after its end, say) is answered as rejected input."""
+    date_filter: RootDateFilter | None = None
+    if payload["rangeKind"] != DATE_RANGE_NONE:
+        date_filter = make_root_date_filter(
+            field=payload["field"], range_kind=payload["rangeKind"],
+            from_date=payload["fromDate"], to_date=payload["toDate"],
+        )
+    response = tab_state_store.set_date_filter(tab_id=payload["tabId"], date_filter=date_filter)
+    if response["changed"] is True:
+        reset_undo_stack(payload["clientId"], payload["undoContext"])
+    return response
+
+
 @router.post("/notes/tab-state/new-tab")
 @transactional_route
 def create_new_tab(payload: CreateNewTabRequest) -> Dict[str, object]:
@@ -506,6 +557,15 @@ def search_suggestions(request: Request, payload: SearchSuggestionsRequest) -> D
         )
     window_days = tuple(raw_window_days)
     validate_tag_activity_windows(window_days)
+    # Typing a property term (exercise:mi, drug:dosage>5): its names or units.
+    typed_term = _typed_property_term(query)
+    if typed_term is not None:
+        return _property_suggestions_response(
+            search_index.suggest_property_completions(
+                typed=typed_term, place=PROPERTY_SUGGESTIONS_IN_SEARCH, limit=MAX_SEARCH_SUGGESTIONS,
+            ),
+            personalized=True,
+        )
     all_suggestions = search_index.suggest_all_tag_completions(query=query)
     suggestions = all_suggestions[:MAX_SEARCH_SUGGESTIONS]
     personalized_selections: list[TagActivityWindowSelection] = []
@@ -544,7 +604,31 @@ def search_suggestions(request: Request, payload: SearchSuggestionsRequest) -> D
             tag: list(search_suggestion_reasons(facts=facts, term=tag, recent_activity=recent_activity))
             for tag in suggestions
         },
+        "labels": {tag: tag for tag in suggestions},
+    }
+
+
+def _typed_property_term(query: str) -> str | None:
+    """The property term being typed at the end of a search, without its - or +."""
+    if query == "" or query[-1].isspace():
+        return None
+    term = query.split()[-1].lstrip("+-")
+    if '"' in term or "'" in term or not is_property_term(term):
+        return None
+    return term
+
+
+def _property_suggestions_response(suggestions: list[PropertySuggestion], *, personalized: bool) -> Dict[str, object]:
+    """Property names or units as the suggestion lists take them: the full replacement,
+    the part the list shows (miles= for jogging:miles=) and why."""
+    response: Dict[str, object] = {
+        "suggestions": [suggestion.replacement for suggestion in suggestions],
+        "reasons": {suggestion.replacement: list(suggestion.reasons) for suggestion in suggestions},
+        "labels": {suggestion.replacement: suggestion.label for suggestion in suggestions},
     }
+    if personalized:
+        response["personalizedSuggestions"] = []
+    return response
 
 
 @router.post("/notes/prioritize-tag-suggestions")
@@ -632,6 +716,40 @@ def get_memory_usage(request: Request) -> Dict[str, object]:
     return describe_memory_usage()
 
 
+@router.post("/notes/find")
+@transactional_route
+def find_in_list(payload: FindInListRequest) -> Dict[str, object]:
+    """One step of find through the list a tab shows (docs/ui/find.md): the notes the
+    text occurs in, in list order, from a root position forward or before it backward."""
+    search = payload["search"]
+    if search is None or search.strip() == "":
+        search = ""
+    else:
+        # A search that does not parse is answered as rejected input, as the view does.
+        parse_search_query(search)
+    if payload["text"].strip() == "":
+        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST, detail="text must hold more than spaces")
+    window = find_in_view(
+        find_text=payload["text"], search=search, sort_mode=_resolve_tab_sort_mode(payload["tabId"]),
+        date_filter=_resolve_tab_date_filter(payload["tabId"]),
+        is_untagged_view=payload["isUntaggedView"], from_root_index=payload["fromRootIndex"],
+        direction=payload["direction"],
+    )
+    return {
+        "matches": [
+            {
+                "noteId": match.note_id, "rootId": match.root_id, "rootIndex": match.root_index,
+                "contentCount": match.content_count, "commentCount": match.comment_count,
+                "previewCount": match.preview_count, "isUnderFoldedNote": match.is_under_folded_note,
+            }
+            for match in window.matches
+        ],
+        "firstRootIndex": window.first_root_index,
+        "endRootIndex": window.end_root_index,
+        "rootCount": window.root_count,
+    }
+
+
 @router.get("/notes/memory-usage/breakdown")
 @serialized_read_route
 def get_memory_breakdown(request: Request) -> Dict[str, object]:
@@ -687,6 +805,15 @@ def tag_suggestions(payload: TagSuggestionsRequest) -> Dict[str, object]:
 
     _require_note_present(note_id, context="notes.tag-suggestions")
 
+    # Typing after a tag's colon (jogging:mi, drug:dosage=10m): property names or units.
+    if has_property_syntax(prefix):
+        return _property_suggestions_response(
+            search_index.suggest_property_completions(
+                typed=prefix, place=PROPERTY_SUGGESTIONS_IN_TAG_BAR, limit=MAX_TAG_SUGGESTIONS,
+            ),
+            personalized=False,
+        )
+
     suggestions = suggest_tags_with_reasons_for_note(
         note_id=note_id,
         anchors=anchors,
@@ -699,6 +826,7 @@ def tag_suggestions(payload: TagSuggestionsRequest) -> Dict[str, object]:
     return {
         "suggestions": [suggestion.tag for suggestion in suggestions],
         "reasons": {suggestion.tag: list(suggestion.reasons) for suggestion in suggestions},
+        "labels": {suggestion.tag: suggestion.tag for suggestion in suggestions},
     }
 
 
@@ -747,6 +875,7 @@ def export_summary(request: Request) -> Dict[str, object]:
         normalized_search = None
     counts = exported_credential_counts(
         search=normalized_search, sort_mode=_resolve_tab_sort_mode(tab_id),
+        date_filter=_resolve_tab_date_filter(tab_id),
         is_untagged_view=is_untagged_view == "true", root_note_id=note_id,
     )
     return {
@@ -806,6 +935,7 @@ def export_notes_html(request: Request) -> Response:
     document = build_notes_export_document(
         search=normalized_search,
         sort_mode=_resolve_tab_sort_mode(tab_id),
+        date_filter=_resolve_tab_date_filter(tab_id),
         is_untagged_view=is_untagged_view == "true",
         theme=normalized_theme,
         token=token,
@@ -867,6 +997,7 @@ def backlinks(request: Request, note_id: str) -> Dict[str, object]:
             search=normalized_search,
             editing_note_id=None,
             sort_mode="normal",
+            date_filter=None,
             ordered_root_ids=None,
         )
         source_note_ids = search_scope.allowed_note_ids
@@ -1067,6 +1198,7 @@ def _robot_scope_note_ids(body: dict) -> frozenset[str]:
     return resolve_view_scope_membership(
         search=body["search"],
         sort_mode=_resolve_tab_sort_mode(body["tabId"]),
+        date_filter=_resolve_tab_date_filter(body["tabId"]),
         is_untagged_view=body["isUntaggedView"],
     ).allowed_note_ids