add dist

2026-07-31 23:21:51 +02:00
parent f6b4b36df8
commit f14f2cfd98
294 changed files with 5880 additions and 0 deletions
@@ -0,0 +1,34 @@
+import type { I18nConfig, LocalizedSlugs } from '../i18n/index.js';
+type BuildHreflangArgs = {
+    /** Absolute site origin, e.g. 'https://example.com'. Omit for relative paths. */
+    baseUrl?: string;
+    config: I18nConfig;
+    /** Home slug that collapses to the locale root. Defaults to 'home'. */
+    homeSlug?: string;
+    /**
+     * Localized segment the document lives under (an archive page's slugs),
+     * e.g. { pl: 'artykuly', en: 'articles' }. Locales missing from the prefix
+     * are omitted — an entry with no archive in that language has no URL there.
+     */
+    prefix?: LocalizedSlugs;
+    /** slug per locale for the current document, e.g. { pl: 'o-nas', en: 'about' } */
+    slugs: LocalizedSlugs;
+};
+/**
+ * Builds a map of locale → URL for hreflang alternate links, suitable for
+ * Next.js Metadata `alternates.languages`.
+ *
+ * Bridges SEO and i18n: for each configured locale that the document has a
+ * slug in, it produces the locale-aware path (via buildLocalizedPath),
+ * optionally prefixed with an absolute origin.
+ *
+ * @example
+ * buildHreflangAlternates({
+ *   slugs: { pl: 'o-nas', en: 'about' },
+ *   config,
+ *   baseUrl: 'https://example.com',
+ * })
+ * // → { pl: 'https://example.com/pl/o-nas', en: 'https://example.com/en/about' }
+ */
+export declare function buildHreflangAlternates({ baseUrl, config, homeSlug, prefix, slugs, }: BuildHreflangArgs): Record<string, string>;
+export {};