feat: instant search becomes optional

[alex-key]

🔗 Linked issue

Resolved #1710

🧭 Context

For a11y purposes we want to make instant search optional, so user could disable it in settings

📚 Description

• Settings section "DATA SOURCE" renamed to "SEARCH FEATURES"
• Instant search switcher added to "SEARCH FEATURES"
• Adjusted code in useGlobalSearch composable, Index page, Search page to be dependent on instantSearch setting

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
npmx.dev	Ready	Preview, Comment	Mar 2, 2026 10:42pm

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ignored	Preview	Mar 2, 2026 10:42pm
npmx-lunaria	Ignored		Mar 2, 2026 10:42pm

[github-actions]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
i18n/locales/en.json	Source changed, localizations will be marked as outdated.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[knowler]

It works! Thank you so much, @alex-key!

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b6b7784 and be1fcc8.

📒 Files selected for processing (1)

• i18n/locales/en.json

---

📝 Walkthrough

Walkthrough

This pull request adds an "instant search" toggle to settings and changes the global search flow to support manual versus instant submission. useSettings now exposes an instantSearch boolean (default true). useGlobalSearch gained a committedModel state and a startSearch function; the previous flushUpdateUrlQuery is removed from the public API and its behaviour is adjusted internally to commit the search query and conditionally update the URL. Header, index and search pages are updated to use startSearch/committedModel, and the settings UI and i18n entries for the instant search toggle are added.

Possibly related PRs

• perf: search improvements #1431: Introduced the original useGlobalSearch() shape exposing flushUpdateUrlQuery that this change refactors to committedModel/startSearch.
• perf: speed up algolia 🚀 + split out search suggestion logic #1271: Modified debounced URL update and header search plumbing which this PR further adapts by adding committed search state and manual submission handling.
• fix: missed input parts on quick search #1394: Adjusted header/search flow and shared global search state that this PR extends with the instant/manual search toggle and committed-query behaviour.

Suggested reviewers

• danielroe

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description check	✅ Passed	The PR description clearly relates to the changeset, outlining the settings section rename, instant search toggle addition, and code adjustments.
Linked Issues check	✅ Passed	All coding requirements from issue #1710 are met: instantSearch setting added and defaults to true; search behaviour now depends on this setting; Enter key handling updated.
Out of Scope Changes check	✅ Passed	All changes are scoped to implementing the instant search toggle feature. No unrelated modifications detected in the changeset.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (2)

app/pages/search.vue (1)

199-199: Use a trimmed committed query for fetch/render gating.

Whitespace-only committed input currently passes the v-if gate and can trigger avoidable search work.

♻️ Suggested refinement

 const {
   model: searchQuery,
   committedModel: committedQuery,
   provider: searchProvider,
 } = useGlobalSearch()
+const committedQueryTrimmed = computed(() => committedQuery.value.trim())
@@
 } = useSearch(
-  committedQuery,
+  committedQueryTrimmed,
   searchProvider,
   () => ({
     size: requestedSize.value,
   }),
   { suggestions: true },
 )
@@
-      <section v-if="committedQuery" class="results-layout">
+      <section v-if="committedQueryTrimmed" class="results-layout">

Also applies to: 675-675

app/composables/useGlobalSearch.ts (1)

31-35: Synchronise committed query when instant search is toggled on.

Switching instantSearch from off → on currently waits for another input change before committedSearchQuery updates.

♻️ Suggested refinement

 watch(searchQuery, val => {
   if (settings.value.instantSearch) {
     committedSearchQuery.value = val
   }
 })
+
+watch(
+  () => settings.value.instantSearch,
+  enabled => {
+    if (enabled) {
+      committedSearchQuery.value = searchQuery.value
+    }
+  },
+)

---

ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b3af9c6 and b6b7784.

📒 Files selected for processing (8)

• app/components/Header/SearchBox.vue
• app/composables/useGlobalSearch.ts
• app/composables/useSettings.ts
• app/pages/index.vue
• app/pages/search.vue
• app/pages/settings.vue
• i18n/locales/en.json
• i18n/schema.json

[codecov]

Codecov Report

❌ Patch coverage is 23.52941% with 13 lines in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
app/composables/useGlobalSearch.ts	33.33%	5 Missing and 3 partials ⚠️
app/pages/settings.vue	0.00%	3 Missing ⚠️
app/components/Header/SearchBox.vue	0.00%	1 Missing ⚠️
app/pages/index.vue	0.00%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!