import { defineCollection } from 'astro:content';
import { docsLoader } from '@astrojs/starlight/loaders';
import { docsSchema } from '@astrojs/starlight/schema';

/**
 * Starlight injects a root-level `[...slug]` route, so a page's URL is its path inside the
 * collection. The extra `docs/` level below is what mounts the documentation at `/docs/`
 * rather than at the site root, leaving `/`, `/features/` and the rest to the marketing
 * pages in `src/pages/` — which win, being more specific than a rest parameter.
 *
 *   src/content/docs/docs/index.mdx           ->  /docs/
 *   src/content/docs/docs/getting-started/…   ->  /docs/getting-started/…
 */
export const collections = {
  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
};