wolmar-i18n 0.1.0

package/dist/proxy/create-proxy.d.ts

@@ -0,0 +1,25 @@
+import { I18nConfig, LocaleList } from "../types/config.js";
+import { NextRequest, NextResponse } from "next/server.js";
+
+//#region src/proxy/create-proxy.d.ts
+/**
+ * A function to build the Next.js proxy that keeps every URL locale-prefixed.
+ *
+ * A saved locale outranks the link: someone whose cookie says `da` opening
+ * `/en/projects` is redirected to `/da/projects`. Choosing a locale is a
+ * decision; receiving a link is not.
+ *
+ * Resolution order: cookie, path prefix, `Accept-Language`, default locale.
+ *
+ * @param config The config returned by `defineI18nConfig`.
+ * @returns The proxy function to export from the app's `proxy.ts`.
+ * @example
+ * export const proxy = createI18nProxy(i18n);
+ * export const config = {
+ *   matcher: ["/((?!api|_next|.*\\..*|favicon.ico|robots.txt).*)"],
+ * };
+ */
+declare function createI18nProxy<TLocales extends LocaleList>(config: I18nConfig<TLocales>): (request: NextRequest) => NextResponse;
+//#endregion
+export { createI18nProxy };
+//# sourceMappingURL=create-proxy.d.ts.map

package/dist/proxy/create-proxy.js

@@ -0,0 +1,41 @@
+import { firstSegment } from "../utils/paths.js";
+import { matchLocale } from "./negotiate.js";
+import { NextResponse } from "next/server.js";
+//#region src/proxy/create-proxy.ts
+/**
+* A function to build the Next.js proxy that keeps every URL locale-prefixed.
+*
+* A saved locale outranks the link: someone whose cookie says `da` opening
+* `/en/projects` is redirected to `/da/projects`. Choosing a locale is a
+* decision; receiving a link is not.
+*
+* Resolution order: cookie, path prefix, `Accept-Language`, default locale.
+*
+* @param config The config returned by `defineI18nConfig`.
+* @returns The proxy function to export from the app's `proxy.ts`.
+* @example
+* export const proxy = createI18nProxy(i18n);
+* export const config = {
+*   matcher: ["/((?!api|_next|.*\\..*|favicon.ico|robots.txt).*)"],
+* };
+*/
+function createI18nProxy(config) {
+	return function proxy(request) {
+		const { pathname } = request.nextUrl;
+		const prefix = firstSegment(pathname);
+		const isPrefixed = config.hasLocale(prefix);
+		const cookie = request.cookies.get(config.cookieName)?.value;
+		const locale = (config.hasLocale(cookie) ? cookie : void 0) ?? (isPrefixed ? prefix : void 0) ?? matchLocale(request.headers.get("accept-language"), config.locales) ?? config.defaultLocale;
+		if (isPrefixed && prefix === locale) return NextResponse.next();
+		const barePath = isPrefixed ? config.stripLocale(pathname) : pathname;
+		const url = request.nextUrl.clone();
+		url.pathname = config.localizePath(barePath, locale);
+		const response = NextResponse.redirect(url, 307);
+		response.headers.set("Vary", "Accept-Language, Cookie");
+		return response;
+	};
+}
+//#endregion
+export { createI18nProxy };
+
+//# sourceMappingURL=create-proxy.js.map

package/dist/proxy/create-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-proxy.js","names":[],"sources":["../../src/proxy/create-proxy.ts"],"sourcesContent":["import { NextResponse } from \"next/server\";\nimport type { NextRequest } from \"next/server\";\nimport type { I18nConfig, LocaleList } from \"../types\";\nimport { firstSegment } from \"../utils/paths\";\nimport { matchLocale } from \"./negotiate\";\n\n/**\n * A function to build the Next.js proxy that keeps every URL locale-prefixed.\n *\n * A saved locale outranks the link: someone whose cookie says `da` opening\n * `/en/projects` is redirected to `/da/projects`. Choosing a locale is a\n * decision; receiving a link is not.\n *\n * Resolution order: cookie, path prefix, `Accept-Language`, default locale.\n *\n * @param config The config returned by `defineI18nConfig`.\n * @returns The proxy function to export from the app's `proxy.ts`.\n * @example\n * export const proxy = createI18nProxy(i18n);\n * export const config = {\n *   matcher: [\"/((?!api|_next|.*\\\\..*|favicon.ico|robots.txt).*)\"],\n * };\n */\nexport function createI18nProxy<TLocales extends LocaleList>(\n  config: I18nConfig<TLocales>,\n): (request: NextRequest) => NextResponse {\n  return function proxy(request: NextRequest): NextResponse {\n    const { pathname } = request.nextUrl;\n\n    const prefix = firstSegment(pathname);\n    const isPrefixed = config.hasLocale(prefix);\n\n    const cookie = request.cookies.get(config.cookieName)?.value;\n    const saved = config.hasLocale(cookie) ? cookie : undefined;\n\n    const locale =\n      saved ??\n      (isPrefixed ? prefix : undefined) ??\n      matchLocale(request.headers.get(\"accept-language\"), config.locales) ??\n      config.defaultLocale;\n\n    if (isPrefixed && prefix === locale) return NextResponse.next();\n\n    const barePath = isPrefixed ? config.stripLocale(pathname) : pathname;\n\n    const url = request.nextUrl.clone();\n    url.pathname = config.localizePath(barePath, locale);\n\n    const response = NextResponse.redirect(url, 307);\n\n    response.headers.set(\"Vary\", \"Accept-Language, Cookie\");\n\n    return response;\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,gBACd,QACwC;AACxC,QAAO,SAAS,MAAM,SAAoC;EACxD,MAAM,EAAE,aAAa,QAAQ;EAE7B,MAAM,SAAS,aAAa,SAAS;EACrC,MAAM,aAAa,OAAO,UAAU,OAAO;EAE3C,MAAM,SAAS,QAAQ,QAAQ,IAAI,OAAO,WAAW,EAAE;EAGvD,MAAM,UAFQ,OAAO,UAAU,OAAO,GAAG,SAAS,KAAA,OAI/C,aAAa,SAAS,KAAA,MACvB,YAAY,QAAQ,QAAQ,IAAI,kBAAkB,EAAE,OAAO,QAAQ,IACnE,OAAO;AAET,MAAI,cAAc,WAAW,OAAQ,QAAO,aAAa,MAAM;EAE/D,MAAM,WAAW,aAAa,OAAO,YAAY,SAAS,GAAG;EAE7D,MAAM,MAAM,QAAQ,QAAQ,OAAO;AACnC,MAAI,WAAW,OAAO,aAAa,UAAU,OAAO;EAEpD,MAAM,WAAW,aAAa,SAAS,KAAK,IAAI;AAEhD,WAAS,QAAQ,IAAI,QAAQ,0BAA0B;AAEvD,SAAO"}

package/dist/proxy/index.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_negotiate = require("./negotiate.cjs");
+const require_create_proxy = require("./create-proxy.cjs");
+exports.createI18nProxy = require_create_proxy.createI18nProxy;
+exports.matchLocale = require_negotiate.matchLocale;
+exports.parseAcceptLanguage = require_negotiate.parseAcceptLanguage;

package/dist/proxy/index.d.cts

@@ -0,0 +1,3 @@
+import { createI18nProxy } from "./create-proxy.cjs";
+import { matchLocale, parseAcceptLanguage } from "./negotiate.cjs";
+export { createI18nProxy, matchLocale, parseAcceptLanguage };

package/dist/proxy/index.d.ts

@@ -0,0 +1,3 @@
+import { createI18nProxy } from "./create-proxy.js";
+import { matchLocale, parseAcceptLanguage } from "./negotiate.js";
+export { createI18nProxy, matchLocale, parseAcceptLanguage };

package/dist/proxy/index.js

@@ -0,0 +1,3 @@
+import { matchLocale, parseAcceptLanguage } from "./negotiate.js";
+import { createI18nProxy } from "./create-proxy.js";
+export { createI18nProxy, matchLocale, parseAcceptLanguage };

package/dist/proxy/negotiate.cjs

@@ -0,0 +1,40 @@
+//#region src/proxy/negotiate.ts
+/**
+* A function to parse an `Accept-Language` header into locale tags.
+* @param header The raw header value, or `null` when the request has none.
+* @returns The tags ordered by q-value, highest first, with `*` and anything
+* explicitly refused (`q=0`) removed.
+*/
+function parseAcceptLanguage(header) {
+	if (!header) return [];
+	return header.split(",").map((part) => {
+		const [tag = "", ...params] = part.trim().split(";");
+		const weight = params.map((param) => param.trim()).find((param) => param.toLowerCase().startsWith("q="));
+		const quality = weight ? Number.parseFloat(weight.slice(2)) : 1;
+		return {
+			tag: tag.trim(),
+			quality: Number.isNaN(quality) ? 0 : quality
+		};
+	}).filter((entry) => entry.tag && entry.tag !== "*" && entry.quality > 0).sort((a, b) => b.quality - a.quality).map((entry) => entry.tag);
+}
+/**
+* A function to pick the best supported locale for an `Accept-Language` header.
+* @param header The raw header value, or `null` when the request has none.
+* @param locales A list of supported locales to match against.
+* @returns The best matching locale, or `undefined` when none match.
+*/
+function matchLocale(header, locales) {
+	for (const tag of parseAcceptLanguage(header)) {
+		const wanted = tag.toLowerCase();
+		const exact = locales.find((locale) => locale.toLowerCase() === wanted);
+		if (exact) return exact;
+		const primary = wanted.split("-")[0];
+		const partial = locales.find((locale) => locale.toLowerCase() === primary);
+		if (partial) return partial;
+	}
+}
+//#endregion
+exports.matchLocale = matchLocale;
+exports.parseAcceptLanguage = parseAcceptLanguage;
+
+//# sourceMappingURL=negotiate.cjs.map

package/dist/proxy/negotiate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiate.cjs","names":[],"sources":["../../src/proxy/negotiate.ts"],"sourcesContent":["import type { LocaleList } from \"../types\";\n\n/**\n * A function to parse an `Accept-Language` header into locale tags.\n * @param header The raw header value, or `null` when the request has none.\n * @returns The tags ordered by q-value, highest first, with `*` and anything\n * explicitly refused (`q=0`) removed.\n */\nexport function parseAcceptLanguage(header: string | null): string[] {\n  if (!header) return [];\n\n  return header\n    .split(\",\")\n    .map((part) => {\n      const [tag = \"\", ...params] = part.trim().split(\";\");\n\n      const weight = params\n        .map((param) => param.trim())\n        .find((param) => param.toLowerCase().startsWith(\"q=\"));\n      const quality = weight ? Number.parseFloat(weight.slice(2)) : 1;\n\n      return {\n        tag: tag.trim(),\n        quality: Number.isNaN(quality) ? 0 : quality,\n      };\n    })\n    .filter((entry) => entry.tag && entry.tag !== \"*\" && entry.quality > 0)\n    .sort((a, b) => b.quality - a.quality)\n    .map((entry) => entry.tag);\n}\n\n/**\n * A function to pick the best supported locale for an `Accept-Language` header.\n * @param header The raw header value, or `null` when the request has none.\n * @param locales A list of supported locales to match against.\n * @returns The best matching locale, or `undefined` when none match.\n */\nexport function matchLocale<TLocales extends LocaleList>(\n  header: string | null,\n  locales: TLocales,\n): TLocales[number] | undefined {\n  for (const tag of parseAcceptLanguage(header)) {\n    const wanted = tag.toLowerCase();\n\n    // Each tag is tried exactly, then by its primary subtag, before moving to\n    // the next one — so a higher-weighted `en-GB` beats a lower-weighted `da`.\n    const exact = locales.find((locale) => locale.toLowerCase() === wanted);\n    if (exact) return exact;\n\n    const primary = wanted.split(\"-\")[0];\n    const partial = locales.find((locale) => locale.toLowerCase() === primary);\n    if (partial) return partial;\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,oBAAoB,QAAiC;AACnE,KAAI,CAAC,OAAQ,QAAO,EAAE;AAEtB,QAAO,OACJ,MAAM,IAAI,CACV,KAAK,SAAS;EACb,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,KAAK,MAAM,CAAC,MAAM,IAAI;EAEpD,MAAM,SAAS,OACZ,KAAK,UAAU,MAAM,MAAM,CAAC,CAC5B,MAAM,UAAU,MAAM,aAAa,CAAC,WAAW,KAAK,CAAC;EACxD,MAAM,UAAU,SAAS,OAAO,WAAW,OAAO,MAAM,EAAE,CAAC,GAAG;AAE9D,SAAO;GACL,KAAK,IAAI,MAAM;GACf,SAAS,OAAO,MAAM,QAAQ,GAAG,IAAI;GACtC;GACD,CACD,QAAQ,UAAU,MAAM,OAAO,MAAM,QAAQ,OAAO,MAAM,UAAU,EAAE,CACtE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,QAAQ,CACrC,KAAK,UAAU,MAAM,IAAI;;;;;;;;AAS9B,SAAgB,YACd,QACA,SAC8B;AAC9B,MAAK,MAAM,OAAO,oBAAoB,OAAO,EAAE;EAC7C,MAAM,SAAS,IAAI,aAAa;EAIhC,MAAM,QAAQ,QAAQ,MAAM,WAAW,OAAO,aAAa,KAAK,OAAO;AACvE,MAAI,MAAO,QAAO;EAElB,MAAM,UAAU,OAAO,MAAM,IAAI,CAAC;EAClC,MAAM,UAAU,QAAQ,MAAM,WAAW,OAAO,aAAa,KAAK,QAAQ;AAC1E,MAAI,QAAS,QAAO"}

package/dist/proxy/negotiate.d.cts

@@ -0,0 +1,20 @@
+import { LocaleList } from "../types/config.cjs";
+
+//#region src/proxy/negotiate.d.ts
+/**
+ * A function to parse an `Accept-Language` header into locale tags.
+ * @param header The raw header value, or `null` when the request has none.
+ * @returns The tags ordered by q-value, highest first, with `*` and anything
+ * explicitly refused (`q=0`) removed.
+ */
+declare function parseAcceptLanguage(header: string | null): string[];
+/**
+ * A function to pick the best supported locale for an `Accept-Language` header.
+ * @param header The raw header value, or `null` when the request has none.
+ * @param locales A list of supported locales to match against.
+ * @returns The best matching locale, or `undefined` when none match.
+ */
+declare function matchLocale<TLocales extends LocaleList>(header: string | null, locales: TLocales): TLocales[number] | undefined;
+//#endregion
+export { matchLocale, parseAcceptLanguage };
+//# sourceMappingURL=negotiate.d.cts.map

package/dist/proxy/negotiate.d.ts

@@ -0,0 +1,20 @@
+import { LocaleList } from "../types/config.js";
+
+//#region src/proxy/negotiate.d.ts
+/**
+ * A function to parse an `Accept-Language` header into locale tags.
+ * @param header The raw header value, or `null` when the request has none.
+ * @returns The tags ordered by q-value, highest first, with `*` and anything
+ * explicitly refused (`q=0`) removed.
+ */
+declare function parseAcceptLanguage(header: string | null): string[];
+/**
+ * A function to pick the best supported locale for an `Accept-Language` header.
+ * @param header The raw header value, or `null` when the request has none.
+ * @param locales A list of supported locales to match against.
+ * @returns The best matching locale, or `undefined` when none match.
+ */
+declare function matchLocale<TLocales extends LocaleList>(header: string | null, locales: TLocales): TLocales[number] | undefined;
+//#endregion
+export { matchLocale, parseAcceptLanguage };
+//# sourceMappingURL=negotiate.d.ts.map

package/dist/proxy/negotiate.js

@@ -0,0 +1,39 @@
+//#region src/proxy/negotiate.ts
+/**
+* A function to parse an `Accept-Language` header into locale tags.
+* @param header The raw header value, or `null` when the request has none.
+* @returns The tags ordered by q-value, highest first, with `*` and anything
+* explicitly refused (`q=0`) removed.
+*/
+function parseAcceptLanguage(header) {
+	if (!header) return [];
+	return header.split(",").map((part) => {
+		const [tag = "", ...params] = part.trim().split(";");
+		const weight = params.map((param) => param.trim()).find((param) => param.toLowerCase().startsWith("q="));
+		const quality = weight ? Number.parseFloat(weight.slice(2)) : 1;
+		return {
+			tag: tag.trim(),
+			quality: Number.isNaN(quality) ? 0 : quality
+		};
+	}).filter((entry) => entry.tag && entry.tag !== "*" && entry.quality > 0).sort((a, b) => b.quality - a.quality).map((entry) => entry.tag);
+}
+/**
+* A function to pick the best supported locale for an `Accept-Language` header.
+* @param header The raw header value, or `null` when the request has none.
+* @param locales A list of supported locales to match against.
+* @returns The best matching locale, or `undefined` when none match.
+*/
+function matchLocale(header, locales) {
+	for (const tag of parseAcceptLanguage(header)) {
+		const wanted = tag.toLowerCase();
+		const exact = locales.find((locale) => locale.toLowerCase() === wanted);
+		if (exact) return exact;
+		const primary = wanted.split("-")[0];
+		const partial = locales.find((locale) => locale.toLowerCase() === primary);
+		if (partial) return partial;
+	}
+}
+//#endregion
+export { matchLocale, parseAcceptLanguage };
+
+//# sourceMappingURL=negotiate.js.map

package/dist/proxy/negotiate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiate.js","names":[],"sources":["../../src/proxy/negotiate.ts"],"sourcesContent":["import type { LocaleList } from \"../types\";\n\n/**\n * A function to parse an `Accept-Language` header into locale tags.\n * @param header The raw header value, or `null` when the request has none.\n * @returns The tags ordered by q-value, highest first, with `*` and anything\n * explicitly refused (`q=0`) removed.\n */\nexport function parseAcceptLanguage(header: string | null): string[] {\n  if (!header) return [];\n\n  return header\n    .split(\",\")\n    .map((part) => {\n      const [tag = \"\", ...params] = part.trim().split(\";\");\n\n      const weight = params\n        .map((param) => param.trim())\n        .find((param) => param.toLowerCase().startsWith(\"q=\"));\n      const quality = weight ? Number.parseFloat(weight.slice(2)) : 1;\n\n      return {\n        tag: tag.trim(),\n        quality: Number.isNaN(quality) ? 0 : quality,\n      };\n    })\n    .filter((entry) => entry.tag && entry.tag !== \"*\" && entry.quality > 0)\n    .sort((a, b) => b.quality - a.quality)\n    .map((entry) => entry.tag);\n}\n\n/**\n * A function to pick the best supported locale for an `Accept-Language` header.\n * @param header The raw header value, or `null` when the request has none.\n * @param locales A list of supported locales to match against.\n * @returns The best matching locale, or `undefined` when none match.\n */\nexport function matchLocale<TLocales extends LocaleList>(\n  header: string | null,\n  locales: TLocales,\n): TLocales[number] | undefined {\n  for (const tag of parseAcceptLanguage(header)) {\n    const wanted = tag.toLowerCase();\n\n    // Each tag is tried exactly, then by its primary subtag, before moving to\n    // the next one — so a higher-weighted `en-GB` beats a lower-weighted `da`.\n    const exact = locales.find((locale) => locale.toLowerCase() === wanted);\n    if (exact) return exact;\n\n    const primary = wanted.split(\"-\")[0];\n    const partial = locales.find((locale) => locale.toLowerCase() === primary);\n    if (partial) return partial;\n  }\n\n  return undefined;\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,oBAAoB,QAAiC;AACnE,KAAI,CAAC,OAAQ,QAAO,EAAE;AAEtB,QAAO,OACJ,MAAM,IAAI,CACV,KAAK,SAAS;EACb,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,KAAK,MAAM,CAAC,MAAM,IAAI;EAEpD,MAAM,SAAS,OACZ,KAAK,UAAU,MAAM,MAAM,CAAC,CAC5B,MAAM,UAAU,MAAM,aAAa,CAAC,WAAW,KAAK,CAAC;EACxD,MAAM,UAAU,SAAS,OAAO,WAAW,OAAO,MAAM,EAAE,CAAC,GAAG;AAE9D,SAAO;GACL,KAAK,IAAI,MAAM;GACf,SAAS,OAAO,MAAM,QAAQ,GAAG,IAAI;GACtC;GACD,CACD,QAAQ,UAAU,MAAM,OAAO,MAAM,QAAQ,OAAO,MAAM,UAAU,EAAE,CACtE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,QAAQ,CACrC,KAAK,UAAU,MAAM,IAAI;;;;;;;;AAS9B,SAAgB,YACd,QACA,SAC8B;AAC9B,MAAK,MAAM,OAAO,oBAAoB,OAAO,EAAE;EAC7C,MAAM,SAAS,IAAI,aAAa;EAIhC,MAAM,QAAQ,QAAQ,MAAM,WAAW,OAAO,aAAa,KAAK,OAAO;AACvE,MAAI,MAAO,QAAO;EAElB,MAAM,UAAU,OAAO,MAAM,IAAI,CAAC;EAClC,MAAM,UAAU,QAAQ,MAAM,WAAW,OAAO,aAAa,KAAK,QAAQ;AAC1E,MAAI,QAAS,QAAO"}

package/dist/server/create-server.cjs

@@ -0,0 +1,35 @@
+const require_translator = require("../utils/translator.cjs");
+//#region src/server/create-server.ts
+/**
+* A function to build the server-side translation helpers.
+* @param config The config returned by `defineI18nConfig`.
+* @param loaders One dynamic `import()` per locale, so only the requested
+* locale's dictionary is ever loaded.
+* @returns `getDictionary` for the raw object and `getTranslations` for a `t`
+* function.
+* @example
+* import "server-only";
+* export const { getDictionary, getTranslations } = createServerI18n(i18n, {
+*   da: async () => (await import("@/locales/da")).default,
+*   en: async () => (await import("@/locales/en")).default,
+* });
+*/
+function createServerI18n(config, loaders) {
+	async function getDictionary(locale) {
+		const resolved = config.hasLocale(locale) ? locale : config.defaultLocale;
+		const load = loaders[resolved];
+		if (!load) throw new Error(`createServerI18n: no dictionary loader for locale "${resolved}".`);
+		return load();
+	}
+	async function getTranslations(locale, namespace) {
+		return require_translator.createTranslator(await getDictionary(locale), namespace);
+	}
+	return {
+		getDictionary,
+		getTranslations
+	};
+}
+//#endregion
+exports.createServerI18n = createServerI18n;
+
+//# sourceMappingURL=create-server.cjs.map

package/dist/server/create-server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.cjs","names":["createTranslator"],"sources":["../../src/server/create-server.ts"],"sourcesContent":["import { createTranslator } from \"../utils/translator\";\nimport type {\n  DictionaryLoaders,\n  I18nConfig,\n  LocaleList,\n  MessageSchema,\n  NamespacePath,\n  Scoped,\n  Translator,\n} from \"../types\";\n\nexport interface ServerI18n<TLocales extends LocaleList, TDictionary> {\n  /**\n   * Loads the whole dictionary for a locale, for passing to `I18nProvider`.\n   */\n  getDictionary(locale: TLocales[number]): Promise<MessageSchema<TDictionary>>;\n  /**\n   * Loads a locale and returns its `t` function, optionally scoped to a namespace.\n   */\n  getTranslations<\n    TNamespace extends NamespacePath<TDictionary> | undefined = undefined,\n  >(\n    locale: TLocales[number],\n    namespace?: TNamespace,\n  ): Promise<Translator<Scoped<TDictionary, TNamespace>>>;\n}\n\n/**\n * A function to build the server-side translation helpers.\n * @param config The config returned by `defineI18nConfig`.\n * @param loaders One dynamic `import()` per locale, so only the requested\n * locale's dictionary is ever loaded.\n * @returns `getDictionary` for the raw object and `getTranslations` for a `t`\n * function.\n * @example\n * import \"server-only\";\n * export const { getDictionary, getTranslations } = createServerI18n(i18n, {\n *   da: async () => (await import(\"@/locales/da\")).default,\n *   en: async () => (await import(\"@/locales/en\")).default,\n * });\n */\nexport function createServerI18n<TLocales extends LocaleList, TDictionary>(\n  config: I18nConfig<TLocales>,\n  loaders: DictionaryLoaders<TLocales, TDictionary>,\n): ServerI18n<TLocales, TDictionary> {\n  async function getDictionary(\n    locale: TLocales[number],\n  ): Promise<MessageSchema<TDictionary>> {\n    const resolved = config.hasLocale(locale) ? locale : config.defaultLocale;\n    const load = loaders[resolved];\n\n    if (!load) {\n      throw new Error(\n        `createServerI18n: no dictionary loader for locale \"${resolved}\".`,\n      );\n    }\n\n    return load();\n  }\n\n  async function getTranslations<\n    TNamespace extends NamespacePath<TDictionary> | undefined = undefined,\n  >(\n    locale: TLocales[number],\n    namespace?: TNamespace,\n  ): Promise<Translator<Scoped<TDictionary, TNamespace>>> {\n    const dictionary = await getDictionary(locale);\n\n    return createTranslator<Scoped<TDictionary, TNamespace>>(\n      dictionary,\n      namespace as string | undefined,\n    );\n  }\n\n  return { getDictionary, getTranslations };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyCA,SAAgB,iBACd,QACA,SACmC;CACnC,eAAe,cACb,QACqC;EACrC,MAAM,WAAW,OAAO,UAAU,OAAO,GAAG,SAAS,OAAO;EAC5D,MAAM,OAAO,QAAQ;AAErB,MAAI,CAAC,KACH,OAAM,IAAI,MACR,sDAAsD,SAAS,IAChE;AAGH,SAAO,MAAM;;CAGf,eAAe,gBAGb,QACA,WACsD;AAGtD,SAAOA,mBAAAA,iBAFY,MAAM,cAAc,OAAO,EAI5C,UACD;;AAGH,QAAO;EAAE;EAAe;EAAiB"}

package/dist/server/create-server.d.cts

@@ -0,0 +1,32 @@
+import { MessageSchema, NamespacePath, Scoped, Translator } from "../types/messages.cjs";
+import { DictionaryLoaders, I18nConfig, LocaleList } from "../types/config.cjs";
+
+//#region src/server/create-server.d.ts
+interface ServerI18n<TLocales extends LocaleList, TDictionary> {
+  /**
+   * Loads the whole dictionary for a locale, for passing to `I18nProvider`.
+   */
+  getDictionary(locale: TLocales[number]): Promise<MessageSchema<TDictionary>>;
+  /**
+   * Loads a locale and returns its `t` function, optionally scoped to a namespace.
+   */
+  getTranslations<TNamespace extends NamespacePath<TDictionary> | undefined = undefined>(locale: TLocales[number], namespace?: TNamespace): Promise<Translator<Scoped<TDictionary, TNamespace>>>;
+}
+/**
+ * A function to build the server-side translation helpers.
+ * @param config The config returned by `defineI18nConfig`.
+ * @param loaders One dynamic `import()` per locale, so only the requested
+ * locale's dictionary is ever loaded.
+ * @returns `getDictionary` for the raw object and `getTranslations` for a `t`
+ * function.
+ * @example
+ * import "server-only";
+ * export const { getDictionary, getTranslations } = createServerI18n(i18n, {
+ *   da: async () => (await import("@/locales/da")).default,
+ *   en: async () => (await import("@/locales/en")).default,
+ * });
+ */
+declare function createServerI18n<TLocales extends LocaleList, TDictionary>(config: I18nConfig<TLocales>, loaders: DictionaryLoaders<TLocales, TDictionary>): ServerI18n<TLocales, TDictionary>;
+//#endregion
+export { ServerI18n, createServerI18n };
+//# sourceMappingURL=create-server.d.cts.map

package/dist/server/create-server.d.ts

@@ -0,0 +1,32 @@
+import { MessageSchema, NamespacePath, Scoped, Translator } from "../types/messages.js";
+import { DictionaryLoaders, I18nConfig, LocaleList } from "../types/config.js";
+
+//#region src/server/create-server.d.ts
+interface ServerI18n<TLocales extends LocaleList, TDictionary> {
+  /**
+   * Loads the whole dictionary for a locale, for passing to `I18nProvider`.
+   */
+  getDictionary(locale: TLocales[number]): Promise<MessageSchema<TDictionary>>;
+  /**
+   * Loads a locale and returns its `t` function, optionally scoped to a namespace.
+   */
+  getTranslations<TNamespace extends NamespacePath<TDictionary> | undefined = undefined>(locale: TLocales[number], namespace?: TNamespace): Promise<Translator<Scoped<TDictionary, TNamespace>>>;
+}
+/**
+ * A function to build the server-side translation helpers.
+ * @param config The config returned by `defineI18nConfig`.
+ * @param loaders One dynamic `import()` per locale, so only the requested
+ * locale's dictionary is ever loaded.
+ * @returns `getDictionary` for the raw object and `getTranslations` for a `t`
+ * function.
+ * @example
+ * import "server-only";
+ * export const { getDictionary, getTranslations } = createServerI18n(i18n, {
+ *   da: async () => (await import("@/locales/da")).default,
+ *   en: async () => (await import("@/locales/en")).default,
+ * });
+ */
+declare function createServerI18n<TLocales extends LocaleList, TDictionary>(config: I18nConfig<TLocales>, loaders: DictionaryLoaders<TLocales, TDictionary>): ServerI18n<TLocales, TDictionary>;
+//#endregion
+export { ServerI18n, createServerI18n };
+//# sourceMappingURL=create-server.d.ts.map

package/dist/server/create-server.js

@@ -0,0 +1,35 @@
+import { createTranslator } from "../utils/translator.js";
+//#region src/server/create-server.ts
+/**
+* A function to build the server-side translation helpers.
+* @param config The config returned by `defineI18nConfig`.
+* @param loaders One dynamic `import()` per locale, so only the requested
+* locale's dictionary is ever loaded.
+* @returns `getDictionary` for the raw object and `getTranslations` for a `t`
+* function.
+* @example
+* import "server-only";
+* export const { getDictionary, getTranslations } = createServerI18n(i18n, {
+*   da: async () => (await import("@/locales/da")).default,
+*   en: async () => (await import("@/locales/en")).default,
+* });
+*/
+function createServerI18n(config, loaders) {
+	async function getDictionary(locale) {
+		const resolved = config.hasLocale(locale) ? locale : config.defaultLocale;
+		const load = loaders[resolved];
+		if (!load) throw new Error(`createServerI18n: no dictionary loader for locale "${resolved}".`);
+		return load();
+	}
+	async function getTranslations(locale, namespace) {
+		return createTranslator(await getDictionary(locale), namespace);
+	}
+	return {
+		getDictionary,
+		getTranslations
+	};
+}
+//#endregion
+export { createServerI18n };
+
+//# sourceMappingURL=create-server.js.map

package/dist/server/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","names":[],"sources":["../../src/server/create-server.ts"],"sourcesContent":["import { createTranslator } from \"../utils/translator\";\nimport type {\n  DictionaryLoaders,\n  I18nConfig,\n  LocaleList,\n  MessageSchema,\n  NamespacePath,\n  Scoped,\n  Translator,\n} from \"../types\";\n\nexport interface ServerI18n<TLocales extends LocaleList, TDictionary> {\n  /**\n   * Loads the whole dictionary for a locale, for passing to `I18nProvider`.\n   */\n  getDictionary(locale: TLocales[number]): Promise<MessageSchema<TDictionary>>;\n  /**\n   * Loads a locale and returns its `t` function, optionally scoped to a namespace.\n   */\n  getTranslations<\n    TNamespace extends NamespacePath<TDictionary> | undefined = undefined,\n  >(\n    locale: TLocales[number],\n    namespace?: TNamespace,\n  ): Promise<Translator<Scoped<TDictionary, TNamespace>>>;\n}\n\n/**\n * A function to build the server-side translation helpers.\n * @param config The config returned by `defineI18nConfig`.\n * @param loaders One dynamic `import()` per locale, so only the requested\n * locale's dictionary is ever loaded.\n * @returns `getDictionary` for the raw object and `getTranslations` for a `t`\n * function.\n * @example\n * import \"server-only\";\n * export const { getDictionary, getTranslations } = createServerI18n(i18n, {\n *   da: async () => (await import(\"@/locales/da\")).default,\n *   en: async () => (await import(\"@/locales/en\")).default,\n * });\n */\nexport function createServerI18n<TLocales extends LocaleList, TDictionary>(\n  config: I18nConfig<TLocales>,\n  loaders: DictionaryLoaders<TLocales, TDictionary>,\n): ServerI18n<TLocales, TDictionary> {\n  async function getDictionary(\n    locale: TLocales[number],\n  ): Promise<MessageSchema<TDictionary>> {\n    const resolved = config.hasLocale(locale) ? locale : config.defaultLocale;\n    const load = loaders[resolved];\n\n    if (!load) {\n      throw new Error(\n        `createServerI18n: no dictionary loader for locale \"${resolved}\".`,\n      );\n    }\n\n    return load();\n  }\n\n  async function getTranslations<\n    TNamespace extends NamespacePath<TDictionary> | undefined = undefined,\n  >(\n    locale: TLocales[number],\n    namespace?: TNamespace,\n  ): Promise<Translator<Scoped<TDictionary, TNamespace>>> {\n    const dictionary = await getDictionary(locale);\n\n    return createTranslator<Scoped<TDictionary, TNamespace>>(\n      dictionary,\n      namespace as string | undefined,\n    );\n  }\n\n  return { getDictionary, getTranslations };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyCA,SAAgB,iBACd,QACA,SACmC;CACnC,eAAe,cACb,QACqC;EACrC,MAAM,WAAW,OAAO,UAAU,OAAO,GAAG,SAAS,OAAO;EAC5D,MAAM,OAAO,QAAQ;AAErB,MAAI,CAAC,KACH,OAAM,IAAI,MACR,sDAAsD,SAAS,IAChE;AAGH,SAAO,MAAM;;CAGf,eAAe,gBAGb,QACA,WACsD;AAGtD,SAAO,iBAFY,MAAM,cAAc,OAAO,EAI5C,UACD;;AAGH,QAAO;EAAE;EAAe;EAAiB"}

package/dist/server/index.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_create_server = require("./create-server.cjs");
+exports.createServerI18n = require_create_server.createServerI18n;

package/dist/server/index.d.cts

@@ -0,0 +1,2 @@
+import { ServerI18n, createServerI18n } from "./create-server.cjs";
+export { type ServerI18n, createServerI18n };

package/dist/server/index.d.ts

@@ -0,0 +1,2 @@
+import { ServerI18n, createServerI18n } from "./create-server.js";
+export { type ServerI18n, createServerI18n };

package/dist/server/index.js

@@ -0,0 +1,2 @@
+import { createServerI18n } from "./create-server.js";
+export { createServerI18n };

package/dist/types/config.d.cts

@@ -0,0 +1,76 @@
+import { MessageSchema } from "./messages.cjs";
+
+//#region src/types/config.d.ts
+/**
+ * The list of locale codes an app supports.
+ */
+type LocaleList = readonly [string, ...string[]];
+/**
+ * The options passed to `defineI18nConfig`.
+ */
+interface I18nOptions<TLocales extends LocaleList> {
+  /**
+   * Every locale the app supports.
+   */
+  locales: TLocales;
+  /**
+   * The locale to use when none can be resolved from the cookie, path or header.
+   */
+  defaultLocale: TLocales[number];
+  /**
+   * The cookie the visitor's chosen locale is persisted in.
+   * @default "NEXT_LOCALE"
+   */
+  cookieName?: string;
+}
+/**
+ * The shared config returned by `defineI18nConfig`, which every other factory
+ * in the package takes as its first argument.
+ */
+interface I18nConfig<TLocales extends LocaleList = LocaleList> {
+  /**
+   * Every locale the app supports.
+   */
+  readonly locales: TLocales;
+  /**
+   * The locale to fall back to when none can be resolved.
+   */
+  readonly defaultLocale: TLocales[number];
+  /**
+   * The cookie the visitor's chosen locale is persisted in.
+   */
+  readonly cookieName: string;
+  /**
+   * Checks whether an untrusted route param, cookie or header is a supported locale.
+   */
+  hasLocale(value: unknown): value is TLocales[number];
+  /**
+   * Prefixes a path with a locale, for building links and redirect targets.
+   */
+  localizePath(barePath: string, locale: TLocales[number]): string;
+  /**
+   * Removes the locale prefix from a path, for finding the same page in another locale.
+   */
+  stripLocale(pathname: string): string;
+  /**
+   * One route param per locale, for a `[locale]` segment's `generateStaticParams`.
+   */
+  staticParams(): {
+    locale: TLocales[number];
+  }[];
+}
+/**
+ * Reads the locale union out of a config, for typing your own helpers.
+ */
+type LocaleOf<TConfig> = TConfig extends I18nConfig<infer TLocales> ? TLocales[number] : never;
+/**
+ * The per-locale dictionary loaders passed to `createServerI18n`.
+ *
+ * Every loader returns the widened schema rather than `TDictionary` itself: the
+ * default locale's dictionary holds its own literal messages, which no other
+ * locale could ever be assignable to.
+ */
+type DictionaryLoaders<TLocales extends LocaleList, TDictionary> = Record<TLocales[number], () => Promise<MessageSchema<TDictionary>>>;
+//#endregion
+export { DictionaryLoaders, I18nConfig, I18nOptions, LocaleList, LocaleOf };
+//# sourceMappingURL=config.d.cts.map

package/dist/types/config.d.ts

@@ -0,0 +1,76 @@
+import { MessageSchema } from "./messages.js";
+
+//#region src/types/config.d.ts
+/**
+ * The list of locale codes an app supports.
+ */
+type LocaleList = readonly [string, ...string[]];
+/**
+ * The options passed to `defineI18nConfig`.
+ */
+interface I18nOptions<TLocales extends LocaleList> {
+  /**
+   * Every locale the app supports.
+   */
+  locales: TLocales;
+  /**
+   * The locale to use when none can be resolved from the cookie, path or header.
+   */
+  defaultLocale: TLocales[number];
+  /**
+   * The cookie the visitor's chosen locale is persisted in.
+   * @default "NEXT_LOCALE"
+   */
+  cookieName?: string;
+}
+/**
+ * The shared config returned by `defineI18nConfig`, which every other factory
+ * in the package takes as its first argument.
+ */
+interface I18nConfig<TLocales extends LocaleList = LocaleList> {
+  /**
+   * Every locale the app supports.
+   */
+  readonly locales: TLocales;
+  /**
+   * The locale to fall back to when none can be resolved.
+   */
+  readonly defaultLocale: TLocales[number];
+  /**
+   * The cookie the visitor's chosen locale is persisted in.
+   */
+  readonly cookieName: string;
+  /**
+   * Checks whether an untrusted route param, cookie or header is a supported locale.
+   */
+  hasLocale(value: unknown): value is TLocales[number];
+  /**
+   * Prefixes a path with a locale, for building links and redirect targets.
+   */
+  localizePath(barePath: string, locale: TLocales[number]): string;
+  /**
+   * Removes the locale prefix from a path, for finding the same page in another locale.
+   */
+  stripLocale(pathname: string): string;
+  /**
+   * One route param per locale, for a `[locale]` segment's `generateStaticParams`.
+   */
+  staticParams(): {
+    locale: TLocales[number];
+  }[];
+}
+/**
+ * Reads the locale union out of a config, for typing your own helpers.
+ */
+type LocaleOf<TConfig> = TConfig extends I18nConfig<infer TLocales> ? TLocales[number] : never;
+/**
+ * The per-locale dictionary loaders passed to `createServerI18n`.
+ *
+ * Every loader returns the widened schema rather than `TDictionary` itself: the
+ * default locale's dictionary holds its own literal messages, which no other
+ * locale could ever be assignable to.
+ */
+type DictionaryLoaders<TLocales extends LocaleList, TDictionary> = Record<TLocales[number], () => Promise<MessageSchema<TDictionary>>>;
+//#endregion
+export { DictionaryLoaders, I18nConfig, I18nOptions, LocaleList, LocaleOf };
+//# sourceMappingURL=config.d.ts.map

package/dist/types/messages.d.cts

@@ -0,0 +1,63 @@
+//#region src/types/messages.d.ts
+/**
+ * The value types that end a key path — everything else is a nested namespace.
+ */
+type Leaf = string | readonly string[];
+/**
+ * The dot-separated keys of a dictionary that hold a message, e.g. `"home.title"`,
+ * used to type the key `t` takes. A key naming a nested object is excluded.
+ */
+type MessagePath<TDictionary> = TDictionary extends object ? { [K in keyof TDictionary & string]: TDictionary[K] extends Leaf ? K : `${K}.${MessagePath<TDictionary[K]>}` }[keyof TDictionary & string] : never;
+/**
+ * The dot-separated keys of the nested objects in a dictionary, e.g. `"home"`,
+ * used to type the namespace `getTranslations` and `useTranslations` take.
+ */
+type NamespacePath<TDictionary> = TDictionary extends object ? { [K in keyof TDictionary & string]: TDictionary[K] extends Leaf ? never : K | `${K}.${NamespacePath<TDictionary[K]>}` }[keyof TDictionary & string] : never;
+/**
+ * The value stored at a dot path, used to type what `t` returns and which
+ * interpolation params it demands. Resolves a namespace to its sub-dictionary
+ * as well as a message key to its string.
+ */
+type MessageAt<TDictionary, TPath extends string> = TPath extends `${infer Head}.${infer Rest}` ? Head extends keyof TDictionary ? MessageAt<TDictionary[Head], Rest> : never : TPath extends keyof TDictionary ? TDictionary[TPath] : never;
+/**
+ * Collapses an intersection chain into a single object type, so a message's
+ * params read as one object.
+ */
+type Flatten<T> = { [K in keyof T]: T[K] };
+/**
+ * The interpolation params of a message, collected one `{placeholder}` at a time.
+ */
+type ExtractArgs<TMessage> = TMessage extends `${string}{${infer Name}}${infer Rest}` ? Record<Name, string | number> & ExtractArgs<Rest> : {};
+/**
+ * The interpolation params a message needs, derived from its `{placeholder}`
+ * tokens. A message with no placeholders needs none.
+ */
+type MessageArgs<TMessage> = Flatten<ExtractArgs<TMessage>>;
+/**
+ * The rest params `t` takes for a given message: none when the message has no
+ * placeholders, one required params object when it does.
+ */
+type TranslatorArgs<TMessage> = [keyof MessageArgs<TMessage>] extends [never] ? [] : [args: MessageArgs<TMessage>];
+/**
+ * The value `t` returns for a given message, widened off the literal held in
+ * the default locale's dictionary.
+ */
+type MessageValue<TMessage> = TMessage extends readonly string[] ? readonly string[] : string;
+/**
+ * The `t` function returned by `getTranslations` and `useTranslations`.
+ */
+type Translator<TDictionary> = <TPath extends MessagePath<TDictionary>>(key: TPath, ...args: TranslatorArgs<MessageAt<TDictionary, TPath>>) => MessageValue<MessageAt<TDictionary, TPath>>;
+/**
+ * The dictionary a `t` function reads from, narrowed to a namespace's
+ * sub-dictionary when one is given and the whole dictionary when it is not.
+ */
+type Scoped<TDictionary, TNamespace> = TNamespace extends string ? MessageAt<TDictionary, TNamespace> : TDictionary;
+/**
+ * The shape every dictionary must match, with each message widened to `string`.
+ * Non-default locales pair it with `satisfies` so a missing or stray key is a
+ * compile error.
+ */
+type MessageSchema<TDictionary> = { [K in keyof TDictionary]: TDictionary[K] extends string ? string : TDictionary[K] extends readonly string[] ? readonly string[] : MessageSchema<TDictionary[K]> };
+//#endregion
+export { MessageArgs, MessageAt, MessagePath, MessageSchema, NamespacePath, Scoped, Translator };
+//# sourceMappingURL=messages.d.cts.map