feat(search): add useSearchCollection composable with FTS5 full-text search

[benjamincanac]

🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Adds useSearchCollection, a client-side composable that provides full-text search powered by SQLite FTS5. it builds an inverted index from content sections at runtime and queries it with BM25 ranking, prefix matching, and multi-column snippets. no external dependencies needed.

const { status, search } = useSearchCollection(['docs', 'blog'])

const results = await search('vue compo', {
  limit: 20,
  snippet: { columns: ['title', 'content'], around: 40 },
  weights: { title: 10, content: 5, heading: true }
})

Unified FTS5 table across multiple collections, lazy index building with immediate: false option, prefix matching on all terms (typing compo matches "composable"), configurable field restriction, BM25 column weights with heading-level boosting, camelCase title normalization for better ranking, and graceful handling of FTS5 syntax errors. queryCollectionSearchSections still available for Fuse.js/MiniSearch users who need typo tolerance.

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
content	Ready	Preview, Comment	May 8, 2026 1:43pm

[pkg-pr-new]

npm i https://pkg.pr.new/@nuxt/content@3787

commit: 3a0140c

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	destr@​2.0.5
	docus@​5.8.1
	chokidar@​5.0.0
	db0@​0.3.4
	consola@​3.4.2
	csvtojson@​2.0.14
	@​vueuse/​nuxt@​14.2.1
	@​webcontainer/​env@​1.1.1
	@​vue/​test-utils@​2.4.6
	drizzle-orm@​0.45.2
	eslint@​10.2.0
	better-sqlite3@​12.8.0
	c12@​3.3.3

View full report

[socket-security]

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action	Severity	Alert  (click "▶" to expand/collapse)
Warn		Critical CVE: Basic FTP has Path Traversal Vulnerability in its downloadToDir() method in npm basic-ftp CVE: GHSA-5rq4-664w-9x2c Basic FTP has Path Traversal Vulnerability in its downloadToDir() method (CRITICAL) Affected versions: < 5.2.0 Patched version: 5.2.0 From: pnpm-lock.yaml → npm/basic-ftp@5.1.0 ℹ Read more on: This package | This alert | What is a critical CVE? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Remove or replace dependencies that include known critical CVEs. Consumers can use dependency overrides or npm audit fix --force to remove vulnerable dependencies. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/basic-ftp@5.1.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report