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,49 @@
+import type { I18nConfig } from '../i18n/index.js';
+/**
+ * The shape we need from an assigned system-page document: its localized slug
+ * field, as returned by Payload when the parent is read with `locale: 'all'`.
+ *
+ * The plugin doesn't know the client's Pages type, so it depends only on this
+ * minimal contract.
+ */
+type AssignedPage = {
+    slug?: null | Record<string, unknown>;
+};
+type GetSystemPagePathArgs = {
+    config: I18nConfig;
+    /**
+     * Slug that represents the site root. Defaults to 'home'. When the assigned
+     * page's slug in the target locale equals this, the path collapses to the
+     * locale root (/pl, /en).
+     */
+    homeSlug?: string;
+    /** Target locale to build the path for. */
+    locale: string;
+    /**
+     * The resolved system-page assignment from SiteSettings — the related
+     * document object (not just an ID), read with `locale: 'all'` so its slug
+     * is a locale→value map. Pass null/undefined if the role is unassigned.
+     */
+    page: AssignedPage | null | undefined;
+};
+/**
+ * Resolves a system-page assignment to a locale-aware path.
+ *
+ * Bridges the Pages module (which document plays a role) and the i18n module
+ * (how that document's localized slug becomes a URL). This is what powers
+ * "visit /pl → serve the homepage": read SiteSettings.homepage, pass the
+ * related document here, get /pl/strona-glowna (or /pl if it's the home slug).
+ *
+ * Returns undefined when the role is unassigned or the assigned page has no
+ * slug in the target locale — the caller decides the fallback (e.g. 404,
+ * redirect to default locale).
+ *
+ * @example
+ * const settings = await payload.findGlobal({ slug: 'site-settings', locale: 'all', depth: 1 })
+ * getSystemPagePath({ page: settings.homepage, locale: 'pl', config })
+ * // → '/pl'  (home slug collapses to root)
+ * getSystemPagePath({ page: settings.privacyPolicy, locale: 'en', config })
+ * // → '/en/privacy-policy'
+ */
+export declare function getSystemPagePath({ config, homeSlug, locale, page, }: GetSystemPagePathArgs): string | undefined;
+export {};