astro 4.2.4 → 4.2.6

package/dist/core/errors/errors-data.js

@@ -259,7 +259,7 @@ const LocalImageUsedWrongly = {
   name: "LocalImageUsedWrongly",
   title: "Local images must be imported.",
   message: (imageFilePath) => `\`Image\`'s and \`getImage\`'s \`src\` parameter must be an imported image or an URL, it cannot be a string filepath. Received \`${imageFilePath}\`.`,
-  hint: "If you want to use an image from your `src` folder, you need to either import it or if the image is coming from a content collection, use the [image() schema helper](https://docs.astro.build/en/guides/images/#images-in-content-collections) See https://docs.astro.build/en/guides/images/#src-required for more information on the `src` property."
+  hint: "If you want to use an image from your `src` folder, you need to either import it or if the image is coming from a content collection, use the [image() schema helper](https://docs.astro.build/en/guides/images/#images-in-content-collections). See https://docs.astro.build/en/guides/images/#src-required for more information on the `src` property."
 };
 const AstroGlobUsedOutside = {
   name: "AstroGlobUsedOutside",
@@ -270,7 +270,8 @@ const AstroGlobUsedOutside = {
 const AstroGlobNoMatch = {
   name: "AstroGlobNoMatch",
   title: "Astro.glob() did not match any files.",
-  message: (globStr) => `\`Astro.glob(${globStr})\` did not return any matching files. Check the pattern for typos.`
+  message: (globStr) => `\`Astro.glob(${globStr})\` did not return any matching files.`,
+  hint: "Check the pattern for typos."
 };
 const RedirectWithNoLocation = {
   name: "RedirectWithNoLocation",
@@ -316,8 +317,8 @@ const MissingLocale = {
 const MissingIndexForInternationalization = {
   name: "MissingIndexForInternationalizationError",
   title: "Index page not found.",
-  message: (src) => `Astro couldn't find the index URL. This index page is required to create a redirect from the index URL to the index URL of the default locale. 
-Create an index page in \`${src}\``
+  message: (defaultLocale) => `Could not find index page. A root index page is required in order to create a redirect to the index URL of the default locale. (\`/${defaultLocale}\`)`,
+  hint: (src) => `Create an index page (\`index.astro, index.md, etc.\`) in \`${src}\`.`
 };
 const CantRenderPage = {
   name: "CantRenderPage",
@@ -332,6 +333,12 @@ const UnhandledRejection = {
 ${stack}`,
   hint: "Make sure your promises all have an `await` or a `.catch()` handler."
 };
+const i18nNotEnabled = {
+  name: "i18nNotEnabled",
+  title: "i18n Not Enabled",
+  message: "The `astro:i18n` module can not be used without enabling i18n in your Astro config.",
+  hint: "See https://docs.astro.build/en/guides/internationalization for a guide on setting up i18n."
+};
 const UnknownCSSError = {
   name: "UnknownCSSError",
   title: "Unknown CSS Error."
@@ -539,5 +546,6 @@ export {
   UnknownViteError,
   UnsupportedConfigTransformError,
   UnsupportedImageConversion,
-  UnsupportedImageFormat
+  UnsupportedImageFormat,
+  i18nNotEnabled
 };

package/dist/core/messages.js

@@ -36,7 +36,7 @@ function serverStart({
   host,
   base
 }) {
-  const version = "4.2.4";
+  const version = "4.2.6";
   const localPrefix = `${dim("\u2503")} Local    `;
   const networkPrefix = `${dim("\u2503")} Network  `;
   const emptyPrefix = " ".repeat(11);
@@ -258,7 +258,7 @@ function printHelp({
     message.push(
       linebreak(),
       `  ${bgGreen(black(` ${commandName} `))} ${green(
-        `v${"4.2.4"}`
+        `v${"4.2.6"}`
       )} ${headline}`
     );
   }

package/dist/core/middleware/vite-plugin.js

@@ -3,7 +3,7 @@ import { getOutputDirectory } from "../../prerender/utils.js";
 import { addRollupInput } from "../build/add-rollup-input.js";
 import { MIDDLEWARE_PATH_SEGMENT_NAME } from "../constants.js";
 const MIDDLEWARE_MODULE_ID = "\0astro-internal:middleware";
-const EMPTY_MIDDLEWARE = "\0empty-middleware";
+const NOOP_MIDDLEWARE = "\0noop-middleware";
 function vitePluginMiddleware({ settings }) {
   let isCommandBuild = false;
   let resolvedMiddlewareId = void 0;
@@ -27,16 +27,16 @@ function vitePluginMiddleware({ settings }) {
         } else if (hasIntegrationMiddleware) {
           return MIDDLEWARE_MODULE_ID;
         } else {
-          return EMPTY_MIDDLEWARE;
+          return NOOP_MIDDLEWARE;
         }
       }
-      if (id === EMPTY_MIDDLEWARE) {
-        return EMPTY_MIDDLEWARE;
+      if (id === NOOP_MIDDLEWARE) {
+        return NOOP_MIDDLEWARE;
       }
     },
     async load(id) {
-      if (id === EMPTY_MIDDLEWARE) {
-        return "export const onRequest = undefined";
+      if (id === NOOP_MIDDLEWARE) {
+        return "export const onRequest = (_, next) => next()";
       } else if (id === MIDDLEWARE_MODULE_ID) {
         if (isCommandBuild) {
           this.emitFile({

package/dist/core/routing/manifest/create.js

@@ -5,11 +5,11 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { getPrerenderDefault } from "../../../prerender/utils.js";
 import { SUPPORTED_MARKDOWN_FILE_EXTENSIONS } from "../../constants.js";
+import { MissingIndexForInternationalization } from "../../errors/errors-data.js";
+import { AstroError } from "../../errors/index.js";
 import { removeLeadingForwardSlash, slash } from "../../path.js";
 import { resolvePages } from "../../util.js";
 import { getRouteGenerator } from "./generator.js";
-import { AstroError } from "../../errors/index.js";
-import { MissingIndexForInternationalization } from "../../errors/errors-data.js";
 const require2 = createRequire(import.meta.url);
 function countOccurrences(needle, haystack) {
   let count = 0;
@@ -446,7 +446,8 @@ function createRouteManifest(params, logger) {
         );
         throw new AstroError({
           ...MissingIndexForInternationalization,
-          message: MissingIndexForInternationalization.message(relativePath)
+          message: MissingIndexForInternationalization.message(i18n.defaultLocale),
+          hint: MissingIndexForInternationalization.hint(relativePath)
         });
       }
     }

package/dist/events/toolbar.d.ts

@@ -0,0 +1,10 @@
+interface AppToggledEventPayload {
+    app: string;
+}
+export declare function eventAppToggled(options: {
+    appName: 'other' | (string & {});
+}): {
+    eventName: string;
+    payload: AppToggledEventPayload;
+}[];
+export {};

package/dist/events/toolbar.js

@@ -0,0 +1,10 @@
+const EVENT_TOOLBAR_APP_TOGGLED = "ASTRO_TOOLBAR_APP_TOGGLED";
+function eventAppToggled(options) {
+  const payload = {
+    app: options.appName
+  };
+  return [{ eventName: EVENT_TOOLBAR_APP_TOGGLED, payload }];
+}
+export {
+  eventAppToggled
+};

package/dist/i18n/index.d.ts

@@ -35,29 +35,32 @@ export declare function getLocaleRelativeUrl({ locale, base, locales: _locales,
  * The absolute URL
  */
 export declare function getLocaleAbsoluteUrl({ site, ...rest }: GetLocaleAbsoluteUrl): string;
-type GetLocalesBaseUrl = GetLocaleOptions & {
+interface GetLocalesRelativeUrlList extends GetLocaleOptions {
     base: string;
     locales: Locales;
     trailingSlash: AstroConfig['trailingSlash'];
     format: AstroConfig['build']['format'];
     routing?: RoutingStrategies;
     defaultLocale: string;
-};
-export declare function getLocaleRelativeUrlList({ base, locales: _locales, trailingSlash, format, path, prependWith, normalizeLocale, routing, defaultLocale, }: GetLocalesBaseUrl): string[];
-export declare function getLocaleAbsoluteUrlList({ site, ...rest }: GetLocaleAbsoluteUrl): string[];
+}
+export declare function getLocaleRelativeUrlList({ base, locales: _locales, trailingSlash, format, path, prependWith, normalizeLocale, routing, defaultLocale, }: GetLocalesRelativeUrlList): string[];
+interface GetLocalesAbsoluteUrlList extends GetLocalesRelativeUrlList {
+    site?: string;
+}
+export declare function getLocaleAbsoluteUrlList({ site, ...rest }: GetLocalesAbsoluteUrlList): string[];
 /**
  * Given a locale (code), it returns its corresponding path
  * @param locale
  * @param locales
  */
-export declare function getPathByLocale(locale: string, locales: Locales): string | undefined;
+export declare function getPathByLocale(locale: string, locales: Locales): string;
 /**
  * An utility function that retrieves the preferred locale that correspond to a path.
  *
  * @param path
  * @param locales
  */
-export declare function getLocaleByPath(path: string, locales: Locales): string | undefined;
+export declare function getLocaleByPath(path: string, locales: Locales): string;
 /**
  *
  * Given a locale, this function:

package/dist/i18n/index.js

@@ -95,19 +95,22 @@ function getPathByLocale(locale, locales) {
       }
     }
   }
+  throw new Unreachable();
 }
 function getLocaleByPath(path, locales) {
   for (const locale of locales) {
     if (typeof locale !== "string") {
       if (locale.path === path) {
         const code = locale.codes.at(0);
+        if (code === void 0)
+          throw new Unreachable();
         return code;
       }
     } else if (locale === path) {
       return locale;
     }
   }
-  return void 0;
+  throw new Unreachable();
 }
 function normalizeTheLocale(locale) {
   return locale.replaceAll("_", "-").toLowerCase();
@@ -150,6 +153,13 @@ function peekCodePathToUse(locales, locale) {
   }
   return void 0;
 }
+class Unreachable extends Error {
+  constructor() {
+    super(
+      "Astro encountered an unexpected line of code.\nIn most cases, this is not your fault, but a bug in astro code.\nIf there isn't one already, please create an issue.\nhttps://astro.build/issues"
+    );
+  }
+}
 export {
   getLocaleAbsoluteUrl,
   getLocaleAbsoluteUrlList,

package/dist/i18n/middleware.d.ts

@@ -1,6 +1,6 @@
 import type { MiddlewareHandler, SSRManifest } from '../@types/astro.js';
 import type { PipelineHookFunction } from '../core/pipeline.js';
-export declare function createI18nMiddleware(i18n: SSRManifest['i18n'], base: SSRManifest['base'], trailingSlash: SSRManifest['trailingSlash'], buildFormat: SSRManifest['buildFormat']): MiddlewareHandler | undefined;
+export declare function createI18nMiddleware(i18n: SSRManifest['i18n'], base: SSRManifest['base'], trailingSlash: SSRManifest['trailingSlash'], buildFormat: SSRManifest['buildFormat']): MiddlewareHandler;
 /**
  * This pipeline hook attaches a `RouteData` object to the `Request`
  */

package/dist/i18n/middleware.js

@@ -18,18 +18,12 @@ function pathnameHasLocale(pathname, locales) {
   return false;
 }
 function createI18nMiddleware(i18n, base, trailingSlash, buildFormat) {
-  if (!i18n) {
-    return void 0;
-  }
+  if (!i18n)
+    return (_, next) => next();
   return async (context, next) => {
-    if (!i18n) {
-      return await next();
-    }
     const routeData = Reflect.get(context.request, routeDataSymbol);
-    if (routeData) {
-      if (routeData.type !== "page" && routeData.type !== "fallback") {
-        return await next();
-      }
+    if (routeData?.type !== "page" && routeData?.type !== "fallback") {
+      return await next();
     }
     const url = context.url;
     const { locales, defaultLocale, fallback, routing } = i18n;

package/dist/i18n/vite-plugin-i18n.d.ts

@@ -1,7 +1,9 @@
 import type * as vite from 'vite';
-import type { AstroSettings } from '../@types/astro.js';
+import type { AstroConfig, AstroSettings } from '../@types/astro.js';
 type AstroInternationalization = {
     settings: AstroSettings;
 };
+export interface I18nInternalConfig extends Pick<AstroConfig, 'base' | 'site' | 'trailingSlash'>, NonNullable<AstroConfig['i18n']>, Pick<AstroConfig['build'], 'format'> {
+}
 export default function astroInternationalization({ settings, }: AstroInternationalization): vite.Plugin;
 export {};

package/dist/i18n/vite-plugin-i18n.js

@@ -1,61 +1,44 @@
+import { AstroError } from "../core/errors/errors.js";
+import { AstroErrorData } from "../core/errors/index.js";
 const virtualModuleId = "astro:i18n";
-const resolvedVirtualModuleId = "\0" + virtualModuleId;
+const configId = "astro-internal:i18n-config";
+const resolvedConfigId = `\0${configId}`;
 function astroInternationalization({
   settings
 }) {
+  const {
+    base,
+    build: { format },
+    i18n,
+    site,
+    trailingSlash
+  } = settings.config;
   return {
     name: "astro:i18n",
     enforce: "pre",
     async resolveId(id) {
       if (id === virtualModuleId) {
-        return resolvedVirtualModuleId;
+        if (i18n === void 0)
+          throw new AstroError(AstroErrorData.i18nNotEnabled);
+        return this.resolve("astro/virtual-modules/i18n.js");
       }
+      if (id === configId)
+        return resolvedConfigId;
     },
     load(id) {
-      if (id === resolvedVirtualModuleId) {
-        return `
-					import { 
-						getLocaleRelativeUrl as _getLocaleRelativeUrl, 
-						getLocaleRelativeUrlList as _getLocaleRelativeUrlList,
-						getLocaleAbsoluteUrl as _getLocaleAbsoluteUrl, 
-						getLocaleAbsoluteUrlList as _getLocaleAbsoluteUrlList,
-						getPathByLocale as _getPathByLocale, 
-						getLocaleByPath as _getLocaleByPath,
-					} from "astro/virtual-modules/i18n.js";
-					
-					const base =  ${JSON.stringify(settings.config.base)};
-					const trailingSlash =  ${JSON.stringify(settings.config.trailingSlash)};
-					const format =  ${JSON.stringify(settings.config.build.format)};
-					const site = ${JSON.stringify(settings.config.site)};
-					const i18n = ${JSON.stringify(settings.config.i18n)};
-					
-					export const getRelativeLocaleUrl = (locale, path = "", opts) => _getLocaleRelativeUrl({ 
-						locale,
-						path, 
-						base, 
-						trailingSlash, 
-						format,
-						...i18n,
-						...opts 
-					});
-					export const getAbsoluteLocaleUrl = (locale, path = "", opts) => _getLocaleAbsoluteUrl({ 
-						locale, 
-						path, 
-						base, 
-						trailingSlash, 
-						format, 
-						site, 
-						...i18n,
-						...opts 
-					});
-					
-					export const getRelativeLocaleUrlList = (path = "", opts) => _getLocaleRelativeUrlList({ 
-						base, path, trailingSlash, format, ...i18n, ...opts });
-					export const getAbsoluteLocaleUrlList = (path = "", opts) => _getLocaleAbsoluteUrlList({ base, path, trailingSlash, format, site, ...i18n, ...opts });
-					
-					export const getPathByLocale = (locale) => _getPathByLocale(locale, i18n.locales);
-					export const getLocaleByPath = (path) => _getLocaleByPath(path, i18n.locales);
-				`;
+      if (id === resolvedConfigId) {
+        const { defaultLocale, locales, routing, fallback } = i18n;
+        const config = {
+          base,
+          format,
+          site,
+          trailingSlash,
+          defaultLocale,
+          locales,
+          routing,
+          fallback
+        };
+        return `export default ${JSON.stringify(config)};`;
       }
     }
   };

package/dist/runtime/client/dev-toolbar/apps/audit/a11y.js

@@ -42,11 +42,8 @@ const aria_non_interactive_roles = [
   "application",
   "article",
   "banner",
-  "button",
   "cell",
-  "checkbox",
   "columnheader",
-  "combobox",
   "complementary",
   "contentinfo",
   "definition",
@@ -56,55 +53,30 @@ const aria_non_interactive_roles = [
   "feed",
   "figure",
   "form",
-  "grid",
-  "gridcell",
   "group",
   "heading",
   "img",
-  "link",
   "list",
-  "listbox",
   "listitem",
   "log",
   "main",
   "marquee",
   "math",
-  "menu",
-  "menubar",
-  "menuitem",
-  "menuitemcheckbox",
   "menuitemradio",
   "navigation",
   "none",
   "note",
-  "option",
   "presentation",
-  "progressbar",
-  "radio",
-  "radiogroup",
   "region",
   "row",
   "rowgroup",
   "rowheader",
-  "scrollbar",
   "search",
-  "searchbox",
-  "separator",
-  "slider",
-  "spinbutton",
   "status",
-  "switch",
-  "tab",
-  "tablist",
-  "tabpanel",
   "term",
-  "textbox",
   "timer",
   "toolbar",
-  "tooltip",
-  "tree",
-  "treegrid",
-  "treeitem"
+  "tooltip"
 ];
 const a11y_required_content = [
   // anchor-has-content

package/dist/runtime/client/dev-toolbar/toolbar.js

@@ -371,6 +371,11 @@ class AstroDevToolbar extends HTMLElement {
       return;
     if (app !== activeApp) {
       await this.setAppStatus(app, true);
+      if (import.meta.hot && app.id !== "astro:more") {
+        import.meta.hot.send("astro:devtoolbar:app:toggled", {
+          app
+        });
+      }
     }
   }
   async setAppStatus(app, newStatus) {

package/dist/runtime/server/consts.d.ts

@@ -0,0 +1 @@
+export declare const REROUTE_DIRECTIVE_HEADER = "X-Astro-Reroute";

package/dist/runtime/server/consts.js

@@ -0,0 +1,4 @@
+const REROUTE_DIRECTIVE_HEADER = "X-Astro-Reroute";
+export {
+  REROUTE_DIRECTIVE_HEADER
+};

package/dist/runtime/server/endpoint.js

@@ -1,4 +1,5 @@
 import { bold } from "kleur/colors";
+import { REROUTE_DIRECTIVE_HEADER } from "./consts.js";
 async function renderEndpoint(mod, context, ssr, logger) {
   const { request, url } = context;
   const method = request.method.toUpperCase();
@@ -22,7 +23,7 @@ Found handlers: ${Object.keys(mod).map((exp) => JSON.stringify(exp)).join(", ")}
     return new Response(null, { status: 404 });
   }
   const response = await handler.call(mod, context);
-  response.headers.set("X-Astro-Reroute", "no");
+  response.headers.set(REROUTE_DIRECTIVE_HEADER, "no");
   return response;
 }
 export {

package/dist/runtime/server/transition.js

@@ -1,5 +1,6 @@
 import { fade, slide } from "../../transitions/index.js";
 import { markHTMLString } from "./escape.js";
+import cssesc from "cssesc";
 const transitionNameMap = /* @__PURE__ */ new WeakMap();
 function incrementTransitionNumber(result) {
   let num = 1;
@@ -13,9 +14,6 @@ function createTransitionScope(result, hash) {
   const num = incrementTransitionNumber(result);
   return `astro-${hash}-${num}`;
 }
-function toValidIdent(name) {
-  return name.replace(/[^a-zA-Z0-9\-\_]/g, "_").replace(/^\_+|\_+$/g, "");
-}
 const getAnimations = (name) => {
   if (name === "fade")
     return fade();
@@ -35,7 +33,7 @@ function renderTransition(result, hash, animationName, transitionName) {
   if (!animationName)
     animationName = "fade";
   const scope = createTransitionScope(result, hash);
-  const name = transitionName ? toValidIdent(transitionName) : scope;
+  const name = transitionName ? cssesc(transitionName, { isIdentifier: true }) : scope;
   const sheet = new ViewTransitionStyleSheet(scope, name);
   const animations = getAnimations(animationName);
   if (animations) {

package/dist/virtual-modules/i18n.d.ts

@@ -1 +1,126 @@
-export * from '../i18n/index.js';
+import * as I18nInternals from '../i18n/index.js';
+export { normalizeTheLocale, toCodes, toPaths } from '../i18n/index.js';
+export type GetLocaleOptions = I18nInternals.GetLocaleOptions;
+/**
+ * @param locale A locale
+ * @param path An optional path to add after the `locale`.
+ * @param options Customise the generated path
+ *
+ * Returns a _relative_ path with passed locale.
+ *
+ * ## Errors
+ *
+ * Throws an error if the locale doesn't exist in the list of locales defined in the configuration.
+ *
+ * ## Examples
+ *
+ * ```js
+ * import { getRelativeLocaleUrl } from "astro:i18n";
+ * getRelativeLocaleUrl("es"); // /es
+ * getRelativeLocaleUrl("es", "getting-started"); // /es/getting-started
+ * getRelativeLocaleUrl("es_US", "getting-started", { prependWith: "blog" }); // /blog/es-us/getting-started
+ * getRelativeLocaleUrl("es_US", "getting-started", { prependWith: "blog", normalizeLocale: false }); // /blog/es_US/getting-started
+ * ```
+ */
+export declare const getRelativeLocaleUrl: (locale: string, path?: string, options?: GetLocaleOptions) => string;
+/**
+ *
+ * @param locale A locale
+ * @param path An optional path to add after the `locale`.
+ * @param options Customise the generated path
+ *
+ * Returns an absolute path with the passed locale. The behaviour is subject to change based on `site` configuration.
+ * If _not_ provided, the function will return a _relative_ URL.
+ *
+ * ## Errors
+ *
+ * Throws an error if the locale doesn't exist in the list of locales defined in the configuration.
+ *
+ * ## Examples
+ *
+ * If `site` is `https://example.com`:
+ *
+ * ```js
+ * import { getAbsoluteLocaleUrl } from "astro:i18n";
+ * getAbsoluteLocaleUrl("es"); // https://example.com/es
+ * getAbsoluteLocaleUrl("es", "getting-started"); // https://example.com/es/getting-started
+ * getAbsoluteLocaleUrl("es_US", "getting-started", { prependWith: "blog" }); // https://example.com/blog/es-us/getting-started
+ * getAbsoluteLocaleUrl("es_US", "getting-started", { prependWith: "blog", normalizeLocale: false }); // https://example.com/blog/es_US/getting-started
+ * ```
+ */
+export declare const getAbsoluteLocaleUrl: (locale: string, path?: string, options?: GetLocaleOptions) => string;
+/**
+ * @param path An optional path to add after the `locale`.
+ * @param options Customise the generated path
+ *
+ * Works like `getRelativeLocaleUrl` but it emits the relative URLs for ALL locales:
+ */
+export declare const getRelativeLocaleUrlList: (path?: string, options?: GetLocaleOptions) => string[];
+/**
+ * @param path An optional path to add after the `locale`.
+ * @param options Customise the generated path
+ *
+ * Works like `getAbsoluteLocaleUrl` but it emits the absolute URLs for ALL locales:
+ */
+export declare const getAbsoluteLocaleUrlList: (path?: string, options?: GetLocaleOptions) => string[];
+/**
+ * A function that return the `path` associated to a locale (defined as code). It's particularly useful in case you decide
+ * to use locales that are broken down in paths and codes.
+ *
+ * @param locale The code of the locale
+ * @returns The path associated to the locale
+ *
+ * ## Example
+ *
+ * ```js
+ * // astro.config.mjs
+ *
+ * export default defineConfig({
+ * 	i18n: {
+ * 		locales: [
+ * 			{ codes: ["it", "it-VT"], path: "italiano" },
+ * 			"es"
+ * 		]
+ * 	}
+ * })
+ * ```
+ *
+ * ```js
+ * import { getPathByLocale } from "astro:i18n";
+ * getPathByLocale("it"); // returns "italiano"
+ * getPathByLocale("it-VT"); // returns "italiano"
+ * getPathByLocale("es"); // returns "es"
+ * ```
+ */
+export declare const getPathByLocale: (locale: string) => string;
+/**
+ * A function that returns the preferred locale given a certain path. This is particularly useful if you configure a locale using
+ * `path` and `codes`. When you define multiple `code`, this function will return the first code of the array.
+ *
+ * Astro will treat the first code as the one that the user prefers.
+ *
+ * @param path The path that maps to a locale
+ * @returns The path associated to the locale
+ *
+ * ## Example
+ *
+ * ```js
+ * // astro.config.mjs
+ *
+ * export default defineConfig({
+ * 	i18n: {
+ * 		locales: [
+ * 			{ codes: ["it-VT", "it"], path: "italiano" },
+ * 			"es"
+ * 		]
+ * 	}
+ * })
+ * ```
+ *
+ * ```js
+ * import { getLocaleByPath } from "astro:i18n";
+ * getLocaleByPath("italiano"); // returns "it-VT" because that's the first code configured
+ * getLocaleByPath("es"); // returns "es"
+ * ```
+ */
+export declare const getLocaleByPath: (path: string) => string;