feat(content): collection filters

[harlan-zw]

🔗 Linked issue

#501

❓ 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)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Adds a filter option to asSitemapCollection() for Nuxt Content v3, allowing users to exclude content entries from the sitemap at runtime.

import { defineCollection, defineContentConfig, z } from '@nuxt/content'
import { asSitemapCollection } from '@nuxtjs/sitemap/content'

export default defineContentConfig({
  collections: {
    // The `name` option must match the collection key — here both are 'blog'
    blog: defineCollection(
      asSitemapCollection({
        type: 'page',
        source: 'blog/**/*.md',
        schema: z.object({
          date: z.string().optional(),
          draft: z.boolean().optional(),
        }),
      }, {
        name: 'blog', // ← must match the key above
        filter: (entry) => {
          // exclude drafts and future-dated posts
          if (entry.draft) return false
          if (entry.date && new Date(entry.date) > new Date()) return false
          return true
        },
      }),
    ),
  },
})

Important: The name option must match the collection key exactly. This is how the filter is matched to the correct collection at runtime.

How it works:

• Filter functions are stored in a global Map at build time via asSitemapCollection()
• Serialized into a virtual Nitro module (#sitemap/content-filters) during nitro:config
• Applied at query time in the content URL handler, fetching all fields when a filter is present

Changes:

• src/content.ts — AsSitemapCollectionOptions interface with name and filter, global filter storage
• src/module.ts — virtual module injection for filters
• nuxt-content-urls-v3.ts — conditional field selection and filter application
• Docs and e2e tests with draft/future/published fixtures