Collection filters

We expose a few utilities to help you handle i18n collections in getStaticPaths, through collectionFilters.

import { collectionFilters } from "@astrolicious/i18n/content-collections"

byLocale

Allows you to filter by locale, assuming your entries slugs (or ids) follow the [locale]/[...parts] pattern:

import { getCollection } from "astro:content";
import { getLocalePlaceholder } from "i18n:astro";
import { collectionFilters } from "@astrolicious/i18n/content-collections"

export const getStaticPaths = (async () => {
    // ...
    const locale = getLocalePlaceholder();
    const posts = await getCollection("posts", (post) =>
      collectionFilters.byLocale(post, { locale }),
    );
    // ...
})

matchingEntries

Allows you to get all entries that match an entry you pass. The usecase is to generate dynamic params:

import { getCollection } from "astro:content";
import {
  getDefaultLocalePlaceholder,
  getLocalePlaceholder,
} from "i18n:astro";
import {
  collectionFilters,
  generateDynamicParams,
    handleI18nSlug,
} from "@astrolicious/i18n/content-collections";
import type { GetStaticPaths } from "astro";

export const getStaticPaths = (async () => {
  const locale = getLocalePlaceholder();
  const defaultLocale = getDefaultLocalePlaceholder();

  const posts = await getCollection("posts", (post) =>
    collectionFilters.byLocale(post, { locale }),
  );

  return await Promise.all(
    posts.map(async (post) => {
      const equivalentPosts = await getCollection("posts", (p) =>
        collectionFilters.matchingEntries(p, {
          currentEntry: post,
          key: "defaultLocaleVersion",
          locale,
          defaultLocale,
        }),
      );

      const dynamicParams = equivalentPosts.map((entry) => {
        const { locale, slug } = handleI18nSlug(entry.slug);

        return {
          locale,
          params: {
            slug,
          },
        };
      });

      return {
        params: {
          slug: handleI18nSlug(post.slug).slug,
        },
        props: {
          post,
          dynamicParams,
        },
      };
    }),
  );
}) satisfies GetStaticPaths;