wolmar-i18n 0.1.0

package/dist/types/messages.d.ts

@@ -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.ts.map

package/dist/utils/config.cjs

@@ -0,0 +1,37 @@
+const require_locale = require("./locale.cjs");
+const require_paths = require("./paths.cjs");
+//#region src/utils/config.ts
+/**
+* The default cookie name used to store the user's locale preference.
+* This can be overridden in the i18n config.
+* @default "NEXT_LOCALE"
+*/
+const DEFAULT_COOKIE_NAME = "NEXT_LOCALE";
+/**
+* A function to build the shared i18n config.
+* Call this once and export the result; every other factory in the package takes it as its first argument.
+* @param options The supported locales, the default locale, and an optional cookie name, which falls back to `"NEXT_LOCALE"`.
+* @returns A frozen config object whose `hasLocale`, `stripLocale` and `staticParams` are already bound to `locales`, so callers do not pass the list around.
+* @example
+* export const i18n = defineI18nConfig({
+*   locales: ["da", "en"],
+*   defaultLocale: "da",
+* });
+*/
+function defineI18nConfig(options) {
+	const { locales, defaultLocale, cookieName = DEFAULT_COOKIE_NAME } = options;
+	return Object.freeze({
+		locales,
+		defaultLocale,
+		cookieName,
+		hasLocale: (value) => require_locale.hasLocale(value, locales),
+		localizePath: require_paths.localizePath,
+		stripLocale: (pathname) => require_paths.stripLocale(pathname, locales),
+		staticParams: () => locales.map((locale) => ({ locale }))
+	});
+}
+//#endregion
+exports.DEFAULT_COOKIE_NAME = DEFAULT_COOKIE_NAME;
+exports.defineI18nConfig = defineI18nConfig;
+
+//# sourceMappingURL=config.cjs.map

package/dist/utils/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.cjs","names":["hasLocale","stripLocale"],"sources":["../../src/utils/config.ts"],"sourcesContent":["import type { I18nConfig, I18nOptions, LocaleList } from \"../types\";\nimport { hasLocale } from \"./locale\";\nimport { localizePath, stripLocale } from \"./paths\";\n\n/**\n * The default cookie name used to store the user's locale preference.\n * This can be overridden in the i18n config.\n * @default \"NEXT_LOCALE\"\n */\nexport const DEFAULT_COOKIE_NAME = \"NEXT_LOCALE\";\n\n/**\n * A function to build the shared i18n config.\n * Call this once and export the result; every other factory in the package takes it as its first argument.\n * @param options The supported locales, the default locale, and an optional cookie name, which falls back to `\"NEXT_LOCALE\"`.\n * @returns A frozen config object whose `hasLocale`, `stripLocale` and `staticParams` are already bound to `locales`, so callers do not pass the list around.\n * @example\n * export const i18n = defineI18nConfig({\n *   locales: [\"da\", \"en\"],\n *   defaultLocale: \"da\",\n * });\n */\nexport function defineI18nConfig<const TLocales extends LocaleList>(\n  options: I18nOptions<TLocales>,\n): I18nConfig<TLocales> {\n  const { locales, defaultLocale, cookieName = DEFAULT_COOKIE_NAME } = options;\n\n  return Object.freeze({\n    locales,\n    defaultLocale,\n    cookieName,\n\n    hasLocale: (value: unknown): value is TLocales[number] =>\n      hasLocale(value, locales),\n\n    localizePath,\n\n    stripLocale: (pathname: string) => stripLocale(pathname, locales),\n\n    staticParams: () => locales.map((locale) => ({ locale })),\n  });\n}\n"],"mappings":";;;;;;;;AASA,MAAa,sBAAsB;;;;;;;;;;;;AAanC,SAAgB,iBACd,SACsB;CACtB,MAAM,EAAE,SAAS,eAAe,aAAa,wBAAwB;AAErE,QAAO,OAAO,OAAO;EACnB;EACA;EACA;EAEA,YAAY,UACVA,eAAAA,UAAU,OAAO,QAAQ;EAE3B,cAAA,cAAA;EAEA,cAAc,aAAqBC,cAAAA,YAAY,UAAU,QAAQ;EAEjE,oBAAoB,QAAQ,KAAK,YAAY,EAAE,QAAQ,EAAE;EAC1D,CAAC"}

package/dist/utils/config.d.cts

@@ -0,0 +1,24 @@
+import { I18nConfig, I18nOptions, LocaleList } from "../types/config.cjs";
+
+//#region src/utils/config.d.ts
+/**
+ * The default cookie name used to store the user's locale preference.
+ * This can be overridden in the i18n config.
+ * @default "NEXT_LOCALE"
+ */
+declare const DEFAULT_COOKIE_NAME = "NEXT_LOCALE";
+/**
+ * A function to build the shared i18n config.
+ * Call this once and export the result; every other factory in the package takes it as its first argument.
+ * @param options The supported locales, the default locale, and an optional cookie name, which falls back to `"NEXT_LOCALE"`.
+ * @returns A frozen config object whose `hasLocale`, `stripLocale` and `staticParams` are already bound to `locales`, so callers do not pass the list around.
+ * @example
+ * export const i18n = defineI18nConfig({
+ *   locales: ["da", "en"],
+ *   defaultLocale: "da",
+ * });
+ */
+declare function defineI18nConfig<const TLocales extends LocaleList>(options: I18nOptions<TLocales>): I18nConfig<TLocales>;
+//#endregion
+export { DEFAULT_COOKIE_NAME, defineI18nConfig };
+//# sourceMappingURL=config.d.cts.map

package/dist/utils/config.d.ts

@@ -0,0 +1,24 @@
+import { I18nConfig, I18nOptions, LocaleList } from "../types/config.js";
+
+//#region src/utils/config.d.ts
+/**
+ * The default cookie name used to store the user's locale preference.
+ * This can be overridden in the i18n config.
+ * @default "NEXT_LOCALE"
+ */
+declare const DEFAULT_COOKIE_NAME = "NEXT_LOCALE";
+/**
+ * A function to build the shared i18n config.
+ * Call this once and export the result; every other factory in the package takes it as its first argument.
+ * @param options The supported locales, the default locale, and an optional cookie name, which falls back to `"NEXT_LOCALE"`.
+ * @returns A frozen config object whose `hasLocale`, `stripLocale` and `staticParams` are already bound to `locales`, so callers do not pass the list around.
+ * @example
+ * export const i18n = defineI18nConfig({
+ *   locales: ["da", "en"],
+ *   defaultLocale: "da",
+ * });
+ */
+declare function defineI18nConfig<const TLocales extends LocaleList>(options: I18nOptions<TLocales>): I18nConfig<TLocales>;
+//#endregion
+export { DEFAULT_COOKIE_NAME, defineI18nConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.js

@@ -0,0 +1,36 @@
+import { hasLocale } from "./locale.js";
+import { localizePath, stripLocale } from "./paths.js";
+//#region src/utils/config.ts
+/**
+* The default cookie name used to store the user's locale preference.
+* This can be overridden in the i18n config.
+* @default "NEXT_LOCALE"
+*/
+const DEFAULT_COOKIE_NAME = "NEXT_LOCALE";
+/**
+* A function to build the shared i18n config.
+* Call this once and export the result; every other factory in the package takes it as its first argument.
+* @param options The supported locales, the default locale, and an optional cookie name, which falls back to `"NEXT_LOCALE"`.
+* @returns A frozen config object whose `hasLocale`, `stripLocale` and `staticParams` are already bound to `locales`, so callers do not pass the list around.
+* @example
+* export const i18n = defineI18nConfig({
+*   locales: ["da", "en"],
+*   defaultLocale: "da",
+* });
+*/
+function defineI18nConfig(options) {
+	const { locales, defaultLocale, cookieName = DEFAULT_COOKIE_NAME } = options;
+	return Object.freeze({
+		locales,
+		defaultLocale,
+		cookieName,
+		hasLocale: (value) => hasLocale(value, locales),
+		localizePath,
+		stripLocale: (pathname) => stripLocale(pathname, locales),
+		staticParams: () => locales.map((locale) => ({ locale }))
+	});
+}
+//#endregion
+export { DEFAULT_COOKIE_NAME, defineI18nConfig };
+
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../src/utils/config.ts"],"sourcesContent":["import type { I18nConfig, I18nOptions, LocaleList } from \"../types\";\nimport { hasLocale } from \"./locale\";\nimport { localizePath, stripLocale } from \"./paths\";\n\n/**\n * The default cookie name used to store the user's locale preference.\n * This can be overridden in the i18n config.\n * @default \"NEXT_LOCALE\"\n */\nexport const DEFAULT_COOKIE_NAME = \"NEXT_LOCALE\";\n\n/**\n * A function to build the shared i18n config.\n * Call this once and export the result; every other factory in the package takes it as its first argument.\n * @param options The supported locales, the default locale, and an optional cookie name, which falls back to `\"NEXT_LOCALE\"`.\n * @returns A frozen config object whose `hasLocale`, `stripLocale` and `staticParams` are already bound to `locales`, so callers do not pass the list around.\n * @example\n * export const i18n = defineI18nConfig({\n *   locales: [\"da\", \"en\"],\n *   defaultLocale: \"da\",\n * });\n */\nexport function defineI18nConfig<const TLocales extends LocaleList>(\n  options: I18nOptions<TLocales>,\n): I18nConfig<TLocales> {\n  const { locales, defaultLocale, cookieName = DEFAULT_COOKIE_NAME } = options;\n\n  return Object.freeze({\n    locales,\n    defaultLocale,\n    cookieName,\n\n    hasLocale: (value: unknown): value is TLocales[number] =>\n      hasLocale(value, locales),\n\n    localizePath,\n\n    stripLocale: (pathname: string) => stripLocale(pathname, locales),\n\n    staticParams: () => locales.map((locale) => ({ locale })),\n  });\n}\n"],"mappings":";;;;;;;;AASA,MAAa,sBAAsB;;;;;;;;;;;;AAanC,SAAgB,iBACd,SACsB;CACtB,MAAM,EAAE,SAAS,eAAe,aAAa,wBAAwB;AAErE,QAAO,OAAO,OAAO;EACnB;EACA;EACA;EAEA,YAAY,UACV,UAAU,OAAO,QAAQ;EAE3B;EAEA,cAAc,aAAqB,YAAY,UAAU,QAAQ;EAEjE,oBAAoB,QAAQ,KAAK,YAAY,EAAE,QAAQ,EAAE;EAC1D,CAAC"}

package/dist/utils/dictionary.cjs

@@ -0,0 +1,20 @@
+//#region src/utils/dictionary.ts
+/**
+* A function to read the value at a dot-separated key in a dictionary.
+* @param source The dictionary, or a sub-dictionary, to read from.
+* @param key The dot-separated key to read, e.g. `"home.title"`.
+* @returns The value at the key, or `undefined` if any segment is missing.
+*/
+function resolveMessageAt(source, key) {
+	let current = source;
+	for (const segment of key.split(".")) {
+		if (current === null || typeof current !== "object") return void 0;
+		if (!Object.hasOwn(current, segment)) return void 0;
+		current = current[segment];
+	}
+	return current;
+}
+//#endregion
+exports.resolveMessageAt = resolveMessageAt;
+
+//# sourceMappingURL=dictionary.cjs.map

package/dist/utils/dictionary.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.cjs","names":[],"sources":["../../src/utils/dictionary.ts"],"sourcesContent":["/**\n * A function to read the value at a dot-separated key in a dictionary.\n * @param source The dictionary, or a sub-dictionary, to read from.\n * @param key The dot-separated key to read, e.g. `\"home.title\"`.\n * @returns The value at the key, or `undefined` if any segment is missing.\n */\nexport function resolveMessageAt(source: unknown, key: string): unknown {\n  let current: unknown = source;\n\n  for (const segment of key.split(\".\")) {\n    if (current === null || typeof current !== \"object\") return undefined;\n    if (!Object.hasOwn(current, segment)) return undefined;\n\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  return current;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,iBAAiB,QAAiB,KAAsB;CACtE,IAAI,UAAmB;AAEvB,MAAK,MAAM,WAAW,IAAI,MAAM,IAAI,EAAE;AACpC,MAAI,YAAY,QAAQ,OAAO,YAAY,SAAU,QAAO,KAAA;AAC5D,MAAI,CAAC,OAAO,OAAO,SAAS,QAAQ,CAAE,QAAO,KAAA;AAE7C,YAAW,QAAoC;;AAGjD,QAAO"}

package/dist/utils/dictionary.js

@@ -0,0 +1,20 @@
+//#region src/utils/dictionary.ts
+/**
+* A function to read the value at a dot-separated key in a dictionary.
+* @param source The dictionary, or a sub-dictionary, to read from.
+* @param key The dot-separated key to read, e.g. `"home.title"`.
+* @returns The value at the key, or `undefined` if any segment is missing.
+*/
+function resolveMessageAt(source, key) {
+	let current = source;
+	for (const segment of key.split(".")) {
+		if (current === null || typeof current !== "object") return void 0;
+		if (!Object.hasOwn(current, segment)) return void 0;
+		current = current[segment];
+	}
+	return current;
+}
+//#endregion
+export { resolveMessageAt };
+
+//# sourceMappingURL=dictionary.js.map

package/dist/utils/dictionary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionary.js","names":[],"sources":["../../src/utils/dictionary.ts"],"sourcesContent":["/**\n * A function to read the value at a dot-separated key in a dictionary.\n * @param source The dictionary, or a sub-dictionary, to read from.\n * @param key The dot-separated key to read, e.g. `\"home.title\"`.\n * @returns The value at the key, or `undefined` if any segment is missing.\n */\nexport function resolveMessageAt(source: unknown, key: string): unknown {\n  let current: unknown = source;\n\n  for (const segment of key.split(\".\")) {\n    if (current === null || typeof current !== \"object\") return undefined;\n    if (!Object.hasOwn(current, segment)) return undefined;\n\n    current = (current as Record<string, unknown>)[segment];\n  }\n\n  return current;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,iBAAiB,QAAiB,KAAsB;CACtE,IAAI,UAAmB;AAEvB,MAAK,MAAM,WAAW,IAAI,MAAM,IAAI,EAAE;AACpC,MAAI,YAAY,QAAQ,OAAO,YAAY,SAAU,QAAO,KAAA;AAC5D,MAAI,CAAC,OAAO,OAAO,SAAS,QAAQ,CAAE,QAAO,KAAA;AAE7C,YAAW,QAAoC;;AAGjD,QAAO"}

package/dist/utils/interpolate.cjs

@@ -0,0 +1,20 @@
+//#region src/utils/interpolate.ts
+/**
+* A function to replace the `{placeholder}` tokens in a message.
+* @param message The message to interpolate.
+* @param args The values to replace the tokens with, keyed by placeholder name.
+* @returns The message with every matched token replaced. A token with no
+* matching value is left in place.
+*/
+function interpolate(message, args) {
+	if (!args) return message;
+	return message.replace(/\{([^}]+)\}/g, (token, name) => {
+		if (!Object.hasOwn(args, name)) return token;
+		const value = args[name];
+		return value === void 0 || value === null ? token : String(value);
+	});
+}
+//#endregion
+exports.interpolate = interpolate;
+
+//# sourceMappingURL=interpolate.cjs.map

package/dist/utils/interpolate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.cjs","names":[],"sources":["../../src/utils/interpolate.ts"],"sourcesContent":["/**\n * A function to replace the `{placeholder}` tokens in a message.\n * @param message The message to interpolate.\n * @param args The values to replace the tokens with, keyed by placeholder name.\n * @returns The message with every matched token replaced. A token with no\n * matching value is left in place.\n */\nexport function interpolate(\n  message: string,\n  args?: Record<string, string | number>,\n): string {\n  if (!args) return message;\n\n  return message.replace(/\\{([^}]+)\\}/g, (token, name: string) => {\n    if (!Object.hasOwn(args, name)) return token;\n\n    const value = args[name];\n\n    return value === undefined || value === null ? token : String(value);\n  });\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,YACd,SACA,MACQ;AACR,KAAI,CAAC,KAAM,QAAO;AAElB,QAAO,QAAQ,QAAQ,iBAAiB,OAAO,SAAiB;AAC9D,MAAI,CAAC,OAAO,OAAO,MAAM,KAAK,CAAE,QAAO;EAEvC,MAAM,QAAQ,KAAK;AAEnB,SAAO,UAAU,KAAA,KAAa,UAAU,OAAO,QAAQ,OAAO,MAAM;GACpE"}

package/dist/utils/interpolate.js

@@ -0,0 +1,20 @@
+//#region src/utils/interpolate.ts
+/**
+* A function to replace the `{placeholder}` tokens in a message.
+* @param message The message to interpolate.
+* @param args The values to replace the tokens with, keyed by placeholder name.
+* @returns The message with every matched token replaced. A token with no
+* matching value is left in place.
+*/
+function interpolate(message, args) {
+	if (!args) return message;
+	return message.replace(/\{([^}]+)\}/g, (token, name) => {
+		if (!Object.hasOwn(args, name)) return token;
+		const value = args[name];
+		return value === void 0 || value === null ? token : String(value);
+	});
+}
+//#endregion
+export { interpolate };
+
+//# sourceMappingURL=interpolate.js.map

package/dist/utils/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","names":[],"sources":["../../src/utils/interpolate.ts"],"sourcesContent":["/**\n * A function to replace the `{placeholder}` tokens in a message.\n * @param message The message to interpolate.\n * @param args The values to replace the tokens with, keyed by placeholder name.\n * @returns The message with every matched token replaced. A token with no\n * matching value is left in place.\n */\nexport function interpolate(\n  message: string,\n  args?: Record<string, string | number>,\n): string {\n  if (!args) return message;\n\n  return message.replace(/\\{([^}]+)\\}/g, (token, name: string) => {\n    if (!Object.hasOwn(args, name)) return token;\n\n    const value = args[name];\n\n    return value === undefined || value === null ? token : String(value);\n  });\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,YACd,SACA,MACQ;AACR,KAAI,CAAC,KAAM,QAAO;AAElB,QAAO,QAAQ,QAAQ,iBAAiB,OAAO,SAAiB;AAC9D,MAAI,CAAC,OAAO,OAAO,MAAM,KAAK,CAAE,QAAO;EAEvC,MAAM,QAAQ,KAAK;AAEnB,SAAO,UAAU,KAAA,KAAa,UAAU,OAAO,QAAQ,OAAO,MAAM;GACpE"}

package/dist/utils/locale.cjs

@@ -0,0 +1,14 @@
+//#region src/utils/locale.ts
+/**
+* A function to check whether a value is one of the supported locales.
+* @param value The value to check.
+* @param locales A list of supported locales to check against.
+* @returns True if the value is a supported locale.
+*/
+function hasLocale(value, locales) {
+	return typeof value === "string" && locales.includes(value);
+}
+//#endregion
+exports.hasLocale = hasLocale;
+
+//# sourceMappingURL=locale.cjs.map

package/dist/utils/locale.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.cjs","names":[],"sources":["../../src/utils/locale.ts"],"sourcesContent":["import type { LocaleList } from \"../types\";\n\n/**\n * A function to check whether a value is one of the supported locales.\n * @param value The value to check.\n * @param locales A list of supported locales to check against.\n * @returns True if the value is a supported locale.\n */\nexport function hasLocale<TLocales extends LocaleList>(\n  value: unknown,\n  locales: TLocales,\n): value is TLocales[number] {\n  return typeof value === \"string\" && locales.includes(value);\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,UACd,OACA,SAC2B;AAC3B,QAAO,OAAO,UAAU,YAAY,QAAQ,SAAS,MAAM"}

package/dist/utils/locale.js

@@ -0,0 +1,14 @@
+//#region src/utils/locale.ts
+/**
+* A function to check whether a value is one of the supported locales.
+* @param value The value to check.
+* @param locales A list of supported locales to check against.
+* @returns True if the value is a supported locale.
+*/
+function hasLocale(value, locales) {
+	return typeof value === "string" && locales.includes(value);
+}
+//#endregion
+export { hasLocale };
+
+//# sourceMappingURL=locale.js.map

package/dist/utils/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","names":[],"sources":["../../src/utils/locale.ts"],"sourcesContent":["import type { LocaleList } from \"../types\";\n\n/**\n * A function to check whether a value is one of the supported locales.\n * @param value The value to check.\n * @param locales A list of supported locales to check against.\n * @returns True if the value is a supported locale.\n */\nexport function hasLocale<TLocales extends LocaleList>(\n  value: unknown,\n  locales: TLocales,\n): value is TLocales[number] {\n  return typeof value === \"string\" && locales.includes(value);\n}\n"],"mappings":";;;;;;;AAQA,SAAgB,UACd,OACA,SAC2B;AAC3B,QAAO,OAAO,UAAU,YAAY,QAAQ,SAAS,MAAM"}

package/dist/utils/paths.cjs

@@ -0,0 +1,40 @@
+//#region src/utils/paths.ts
+/**
+* A function to localize a path by prepending the locale to the path.
+* @param barePath The path to localize, which should not already contain a locale segment.
+* A missing leading slash is normalized, so `"projects"` is treated as `"/projects"`.
+* @param locale The locale to prepend to the path.
+* @returns The localized path. A trailing slash is not added, so `"/"` becomes
+* `"/da"` rather than `"/da/"`.
+*/
+function localizePath(barePath, locale) {
+	if (!barePath || barePath === "/") return `/${locale}`;
+	return `/${locale}${barePath.startsWith("/") ? barePath : `/${barePath}`}`;
+}
+/**
+* A function to strip the locale from a pathname.
+* @param pathname The pathname from which to strip the locale.
+* @param locales A list of supported locales to check against.
+* @returns The pathname without the locale segment, or the pathname unchanged
+* when its first segment is not a supported locale. A trailing slash is
+* dropped, so `"/da/"` becomes `"/"`.
+*/
+function stripLocale(pathname, locales) {
+	const segments = pathname.split("/").filter(Boolean);
+	if (!segments.length || !locales.includes(segments[0])) return pathname;
+	return `/${segments.slice(1).join("/")}`;
+}
+/**
+* A function to get the first segment of a pathname.
+* @param pathname The pathname to read, e.g. `"/da/projects"`.
+* @returns The first segment, or `undefined` when the pathname has none.
+*/
+function firstSegment(pathname) {
+	return pathname.split("/").filter(Boolean)[0];
+}
+//#endregion
+exports.firstSegment = firstSegment;
+exports.localizePath = localizePath;
+exports.stripLocale = stripLocale;
+
+//# sourceMappingURL=paths.cjs.map

package/dist/utils/paths.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.cjs","names":[],"sources":["../../src/utils/paths.ts"],"sourcesContent":["import type { LocaleList } from \"../types\";\n\n/**\n * A function to localize a path by prepending the locale to the path.\n * @param barePath The path to localize, which should not already contain a locale segment.\n * A missing leading slash is normalized, so `\"projects\"` is treated as `\"/projects\"`.\n * @param locale The locale to prepend to the path.\n * @returns The localized path. A trailing slash is not added, so `\"/\"` becomes\n * `\"/da\"` rather than `\"/da/\"`.\n */\nexport function localizePath(barePath: string, locale: string): string {\n  if (!barePath || barePath === \"/\") return `/${locale}`;\n\n  const path = barePath.startsWith(\"/\") ? barePath : `/${barePath}`;\n\n  return `/${locale}${path}`;\n}\n\n/**\n * A function to strip the locale from a pathname.\n * @param pathname The pathname from which to strip the locale.\n * @param locales A list of supported locales to check against.\n * @returns The pathname without the locale segment, or the pathname unchanged\n * when its first segment is not a supported locale. A trailing slash is\n * dropped, so `\"/da/\"` becomes `\"/\"`.\n */\nexport function stripLocale(pathname: string, locales: LocaleList): string {\n  const segments = pathname.split(\"/\").filter(Boolean);\n  if (!segments.length || !locales.includes(segments[0])) return pathname;\n\n  return `/${segments.slice(1).join(\"/\")}`;\n}\n\n/**\n * A function to get the first segment of a pathname.\n * @param pathname The pathname to read, e.g. `\"/da/projects\"`.\n * @returns The first segment, or `undefined` when the pathname has none.\n */\nexport function firstSegment(pathname: string): string | undefined {\n  return pathname.split(\"/\").filter(Boolean)[0];\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,aAAa,UAAkB,QAAwB;AACrE,KAAI,CAAC,YAAY,aAAa,IAAK,QAAO,IAAI;AAI9C,QAAO,IAAI,SAFE,SAAS,WAAW,IAAI,GAAG,WAAW,IAAI;;;;;;;;;;AAazD,SAAgB,YAAY,UAAkB,SAA6B;CACzE,MAAM,WAAW,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ;AACpD,KAAI,CAAC,SAAS,UAAU,CAAC,QAAQ,SAAS,SAAS,GAAG,CAAE,QAAO;AAE/D,QAAO,IAAI,SAAS,MAAM,EAAE,CAAC,KAAK,IAAI;;;;;;;AAQxC,SAAgB,aAAa,UAAsC;AACjE,QAAO,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC"}

package/dist/utils/paths.d.cts

@@ -0,0 +1,19 @@
+//#region src/utils/paths.d.ts
+/**
+ * A function to localize a path by prepending the locale to the path.
+ * @param barePath The path to localize, which should not already contain a locale segment.
+ * A missing leading slash is normalized, so `"projects"` is treated as `"/projects"`.
+ * @param locale The locale to prepend to the path.
+ * @returns The localized path. A trailing slash is not added, so `"/"` becomes
+ * `"/da"` rather than `"/da/"`.
+ */
+declare function localizePath(barePath: string, locale: string): string;
+/**
+ * A function to get the first segment of a pathname.
+ * @param pathname The pathname to read, e.g. `"/da/projects"`.
+ * @returns The first segment, or `undefined` when the pathname has none.
+ */
+declare function firstSegment(pathname: string): string | undefined;
+//#endregion
+export { firstSegment, localizePath };
+//# sourceMappingURL=paths.d.cts.map

package/dist/utils/paths.d.ts

@@ -0,0 +1,19 @@
+//#region src/utils/paths.d.ts
+/**
+ * A function to localize a path by prepending the locale to the path.
+ * @param barePath The path to localize, which should not already contain a locale segment.
+ * A missing leading slash is normalized, so `"projects"` is treated as `"/projects"`.
+ * @param locale The locale to prepend to the path.
+ * @returns The localized path. A trailing slash is not added, so `"/"` becomes
+ * `"/da"` rather than `"/da/"`.
+ */
+declare function localizePath(barePath: string, locale: string): string;
+/**
+ * A function to get the first segment of a pathname.
+ * @param pathname The pathname to read, e.g. `"/da/projects"`.
+ * @returns The first segment, or `undefined` when the pathname has none.
+ */
+declare function firstSegment(pathname: string): string | undefined;
+//#endregion
+export { firstSegment, localizePath };
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.js

@@ -0,0 +1,38 @@
+//#region src/utils/paths.ts
+/**
+* A function to localize a path by prepending the locale to the path.
+* @param barePath The path to localize, which should not already contain a locale segment.
+* A missing leading slash is normalized, so `"projects"` is treated as `"/projects"`.
+* @param locale The locale to prepend to the path.
+* @returns The localized path. A trailing slash is not added, so `"/"` becomes
+* `"/da"` rather than `"/da/"`.
+*/
+function localizePath(barePath, locale) {
+	if (!barePath || barePath === "/") return `/${locale}`;
+	return `/${locale}${barePath.startsWith("/") ? barePath : `/${barePath}`}`;
+}
+/**
+* A function to strip the locale from a pathname.
+* @param pathname The pathname from which to strip the locale.
+* @param locales A list of supported locales to check against.
+* @returns The pathname without the locale segment, or the pathname unchanged
+* when its first segment is not a supported locale. A trailing slash is
+* dropped, so `"/da/"` becomes `"/"`.
+*/
+function stripLocale(pathname, locales) {
+	const segments = pathname.split("/").filter(Boolean);
+	if (!segments.length || !locales.includes(segments[0])) return pathname;
+	return `/${segments.slice(1).join("/")}`;
+}
+/**
+* A function to get the first segment of a pathname.
+* @param pathname The pathname to read, e.g. `"/da/projects"`.
+* @returns The first segment, or `undefined` when the pathname has none.
+*/
+function firstSegment(pathname) {
+	return pathname.split("/").filter(Boolean)[0];
+}
+//#endregion
+export { firstSegment, localizePath, stripLocale };
+
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","names":[],"sources":["../../src/utils/paths.ts"],"sourcesContent":["import type { LocaleList } from \"../types\";\n\n/**\n * A function to localize a path by prepending the locale to the path.\n * @param barePath The path to localize, which should not already contain a locale segment.\n * A missing leading slash is normalized, so `\"projects\"` is treated as `\"/projects\"`.\n * @param locale The locale to prepend to the path.\n * @returns The localized path. A trailing slash is not added, so `\"/\"` becomes\n * `\"/da\"` rather than `\"/da/\"`.\n */\nexport function localizePath(barePath: string, locale: string): string {\n  if (!barePath || barePath === \"/\") return `/${locale}`;\n\n  const path = barePath.startsWith(\"/\") ? barePath : `/${barePath}`;\n\n  return `/${locale}${path}`;\n}\n\n/**\n * A function to strip the locale from a pathname.\n * @param pathname The pathname from which to strip the locale.\n * @param locales A list of supported locales to check against.\n * @returns The pathname without the locale segment, or the pathname unchanged\n * when its first segment is not a supported locale. A trailing slash is\n * dropped, so `\"/da/\"` becomes `\"/\"`.\n */\nexport function stripLocale(pathname: string, locales: LocaleList): string {\n  const segments = pathname.split(\"/\").filter(Boolean);\n  if (!segments.length || !locales.includes(segments[0])) return pathname;\n\n  return `/${segments.slice(1).join(\"/\")}`;\n}\n\n/**\n * A function to get the first segment of a pathname.\n * @param pathname The pathname to read, e.g. `\"/da/projects\"`.\n * @returns The first segment, or `undefined` when the pathname has none.\n */\nexport function firstSegment(pathname: string): string | undefined {\n  return pathname.split(\"/\").filter(Boolean)[0];\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,aAAa,UAAkB,QAAwB;AACrE,KAAI,CAAC,YAAY,aAAa,IAAK,QAAO,IAAI;AAI9C,QAAO,IAAI,SAFE,SAAS,WAAW,IAAI,GAAG,WAAW,IAAI;;;;;;;;;;AAazD,SAAgB,YAAY,UAAkB,SAA6B;CACzE,MAAM,WAAW,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ;AACpD,KAAI,CAAC,SAAS,UAAU,CAAC,QAAQ,SAAS,SAAS,GAAG,CAAE,QAAO;AAE/D,QAAO,IAAI,SAAS,MAAM,EAAE,CAAC,KAAK,IAAI;;;;;;;AAQxC,SAAgB,aAAa,UAAsC;AACjE,QAAO,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC"}

package/dist/utils/translator.cjs

@@ -0,0 +1,54 @@
+const require_dictionary = require("./dictionary.cjs");
+const require_interpolate = require("./interpolate.cjs");
+//#region src/utils/translator.ts
+/**
+* The warnings already logged. Module-scoped, so a message is logged once per
+* process rather than once per translator.
+*/
+const warned = /* @__PURE__ */ new Set();
+/**
+* A function to log a problem once in development and never in production.
+* @param problem What went wrong, e.g. `"Missing message"`.
+* @param key The key it went wrong for.
+*/
+function warnOnce(problem, key) {
+	if (process.env.NODE_ENV === "production") return;
+	const message = `${problem}: "${key}"`;
+	if (warned.has(message)) return;
+	warned.add(message);
+	console.warn(`[wolmar-i18n] ${message}`);
+}
+/**
+* A function to build the `t` function messages are read through.
+*
+* `TScoped` is the shape the returned `t` reads from — the namespace's
+* sub-dictionary when a namespace is given, the whole dictionary when it is
+* not. Callers pass it explicitly, usually as `Scoped<TDictionary, TNamespace>`.
+*
+* @param dictionary The dictionary to read messages from.
+* @param namespace The dot-separated key to read relative to, e.g. `"home"`.
+* @returns A `t` function whose keys are relative to the namespace.
+*
+* An unresolved key is returned as its own full dotted path rather than
+* throwing, and warns once in development. Note this means a key typed as
+* `readonly string[]` yields a **string** when it is missing, so calling
+* `.map()` on the result would fail — only reachable through untyped data or a
+* cast, since `MessageSchema` makes a missing key a compile error.
+*/
+function createTranslator(dictionary, namespace) {
+	const scope = namespace ? require_dictionary.resolveMessageAt(dictionary, namespace) : dictionary;
+	if (namespace && scope === void 0) warnOnce("Missing namespace", namespace);
+	function translate(key, args) {
+		const value = require_dictionary.resolveMessageAt(scope, key);
+		if (typeof value === "string") return require_interpolate.interpolate(value, args);
+		if (Array.isArray(value)) return value;
+		const path = namespace ? `${namespace}.${key}` : key;
+		warnOnce("Missing message", path);
+		return path;
+	}
+	return translate;
+}
+//#endregion
+exports.createTranslator = createTranslator;
+
+//# sourceMappingURL=translator.cjs.map

package/dist/utils/translator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.cjs","names":["resolveMessageAt","interpolate"],"sources":["../../src/utils/translator.ts"],"sourcesContent":["import type { Translator } from \"../types\";\nimport { resolveMessageAt } from \"./dictionary\";\nimport { interpolate } from \"./interpolate\";\n\n/**\n * The warnings already logged. Module-scoped, so a message is logged once per\n * process rather than once per translator.\n */\nconst warned = new Set<string>();\n\n/**\n * A function to log a problem once in development and never in production.\n * @param problem What went wrong, e.g. `\"Missing message\"`.\n * @param key The key it went wrong for.\n */\nfunction warnOnce(problem: string, key: string): void {\n  if (process.env.NODE_ENV === \"production\") return;\n\n  const message = `${problem}: \"${key}\"`;\n\n  if (warned.has(message)) return;\n\n  warned.add(message);\n  console.warn(`[wolmar-i18n] ${message}`);\n}\n\n/**\n * A function to build the `t` function messages are read through.\n *\n * `TScoped` is the shape the returned `t` reads from — the namespace's\n * sub-dictionary when a namespace is given, the whole dictionary when it is\n * not. Callers pass it explicitly, usually as `Scoped<TDictionary, TNamespace>`.\n *\n * @param dictionary The dictionary to read messages from.\n * @param namespace The dot-separated key to read relative to, e.g. `\"home\"`.\n * @returns A `t` function whose keys are relative to the namespace.\n *\n * An unresolved key is returned as its own full dotted path rather than\n * throwing, and warns once in development. Note this means a key typed as\n * `readonly string[]` yields a **string** when it is missing, so calling\n * `.map()` on the result would fail — only reachable through untyped data or a\n * cast, since `MessageSchema` makes a missing key a compile error.\n */\nexport function createTranslator<TScoped>(\n  dictionary: unknown,\n  namespace?: string,\n): Translator<TScoped> {\n  const scope = namespace\n    ? resolveMessageAt(dictionary, namespace)\n    : dictionary;\n\n  if (namespace && scope === undefined) {\n    warnOnce(\"Missing namespace\", namespace);\n  }\n\n  function translate(\n    key: string,\n    args?: Record<string, string | number>,\n  ): string | readonly string[] {\n    const value = resolveMessageAt(scope, key);\n\n    if (typeof value === \"string\") return interpolate(value, args);\n    if (Array.isArray(value)) return value;\n\n    const path = namespace ? `${namespace}.${key}` : key;\n\n    warnOnce(\"Missing message\", path);\n\n    return path;\n  }\n\n  return translate as unknown as Translator<TScoped>;\n}\n"],"mappings":";;;;;;;AAQA,MAAM,yBAAS,IAAI,KAAa;;;;;;AAOhC,SAAS,SAAS,SAAiB,KAAmB;AACpD,KAAI,QAAQ,IAAI,aAAa,aAAc;CAE3C,MAAM,UAAU,GAAG,QAAQ,KAAK,IAAI;AAEpC,KAAI,OAAO,IAAI,QAAQ,CAAE;AAEzB,QAAO,IAAI,QAAQ;AACnB,SAAQ,KAAK,iBAAiB,UAAU;;;;;;;;;;;;;;;;;;;AAoB1C,SAAgB,iBACd,YACA,WACqB;CACrB,MAAM,QAAQ,YACVA,mBAAAA,iBAAiB,YAAY,UAAU,GACvC;AAEJ,KAAI,aAAa,UAAU,KAAA,EACzB,UAAS,qBAAqB,UAAU;CAG1C,SAAS,UACP,KACA,MAC4B;EAC5B,MAAM,QAAQA,mBAAAA,iBAAiB,OAAO,IAAI;AAE1C,MAAI,OAAO,UAAU,SAAU,QAAOC,oBAAAA,YAAY,OAAO,KAAK;AAC9D,MAAI,MAAM,QAAQ,MAAM,CAAE,QAAO;EAEjC,MAAM,OAAO,YAAY,GAAG,UAAU,GAAG,QAAQ;AAEjD,WAAS,mBAAmB,KAAK;AAEjC,SAAO;;AAGT,QAAO"}

package/dist/utils/translator.js

@@ -0,0 +1,54 @@
+import { resolveMessageAt } from "./dictionary.js";
+import { interpolate } from "./interpolate.js";
+//#region src/utils/translator.ts
+/**
+* The warnings already logged. Module-scoped, so a message is logged once per
+* process rather than once per translator.
+*/
+const warned = /* @__PURE__ */ new Set();
+/**
+* A function to log a problem once in development and never in production.
+* @param problem What went wrong, e.g. `"Missing message"`.
+* @param key The key it went wrong for.
+*/
+function warnOnce(problem, key) {
+	if (process.env.NODE_ENV === "production") return;
+	const message = `${problem}: "${key}"`;
+	if (warned.has(message)) return;
+	warned.add(message);
+	console.warn(`[wolmar-i18n] ${message}`);
+}
+/**
+* A function to build the `t` function messages are read through.
+*
+* `TScoped` is the shape the returned `t` reads from — the namespace's
+* sub-dictionary when a namespace is given, the whole dictionary when it is
+* not. Callers pass it explicitly, usually as `Scoped<TDictionary, TNamespace>`.
+*
+* @param dictionary The dictionary to read messages from.
+* @param namespace The dot-separated key to read relative to, e.g. `"home"`.
+* @returns A `t` function whose keys are relative to the namespace.
+*
+* An unresolved key is returned as its own full dotted path rather than
+* throwing, and warns once in development. Note this means a key typed as
+* `readonly string[]` yields a **string** when it is missing, so calling
+* `.map()` on the result would fail — only reachable through untyped data or a
+* cast, since `MessageSchema` makes a missing key a compile error.
+*/
+function createTranslator(dictionary, namespace) {
+	const scope = namespace ? resolveMessageAt(dictionary, namespace) : dictionary;
+	if (namespace && scope === void 0) warnOnce("Missing namespace", namespace);
+	function translate(key, args) {
+		const value = resolveMessageAt(scope, key);
+		if (typeof value === "string") return interpolate(value, args);
+		if (Array.isArray(value)) return value;
+		const path = namespace ? `${namespace}.${key}` : key;
+		warnOnce("Missing message", path);
+		return path;
+	}
+	return translate;
+}
+//#endregion
+export { createTranslator };
+
+//# sourceMappingURL=translator.js.map

package/dist/utils/translator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.js","names":[],"sources":["../../src/utils/translator.ts"],"sourcesContent":["import type { Translator } from \"../types\";\nimport { resolveMessageAt } from \"./dictionary\";\nimport { interpolate } from \"./interpolate\";\n\n/**\n * The warnings already logged. Module-scoped, so a message is logged once per\n * process rather than once per translator.\n */\nconst warned = new Set<string>();\n\n/**\n * A function to log a problem once in development and never in production.\n * @param problem What went wrong, e.g. `\"Missing message\"`.\n * @param key The key it went wrong for.\n */\nfunction warnOnce(problem: string, key: string): void {\n  if (process.env.NODE_ENV === \"production\") return;\n\n  const message = `${problem}: \"${key}\"`;\n\n  if (warned.has(message)) return;\n\n  warned.add(message);\n  console.warn(`[wolmar-i18n] ${message}`);\n}\n\n/**\n * A function to build the `t` function messages are read through.\n *\n * `TScoped` is the shape the returned `t` reads from — the namespace's\n * sub-dictionary when a namespace is given, the whole dictionary when it is\n * not. Callers pass it explicitly, usually as `Scoped<TDictionary, TNamespace>`.\n *\n * @param dictionary The dictionary to read messages from.\n * @param namespace The dot-separated key to read relative to, e.g. `\"home\"`.\n * @returns A `t` function whose keys are relative to the namespace.\n *\n * An unresolved key is returned as its own full dotted path rather than\n * throwing, and warns once in development. Note this means a key typed as\n * `readonly string[]` yields a **string** when it is missing, so calling\n * `.map()` on the result would fail — only reachable through untyped data or a\n * cast, since `MessageSchema` makes a missing key a compile error.\n */\nexport function createTranslator<TScoped>(\n  dictionary: unknown,\n  namespace?: string,\n): Translator<TScoped> {\n  const scope = namespace\n    ? resolveMessageAt(dictionary, namespace)\n    : dictionary;\n\n  if (namespace && scope === undefined) {\n    warnOnce(\"Missing namespace\", namespace);\n  }\n\n  function translate(\n    key: string,\n    args?: Record<string, string | number>,\n  ): string | readonly string[] {\n    const value = resolveMessageAt(scope, key);\n\n    if (typeof value === \"string\") return interpolate(value, args);\n    if (Array.isArray(value)) return value;\n\n    const path = namespace ? `${namespace}.${key}` : key;\n\n    warnOnce(\"Missing message\", path);\n\n    return path;\n  }\n\n  return translate as unknown as Translator<TScoped>;\n}\n"],"mappings":";;;;;;;AAQA,MAAM,yBAAS,IAAI,KAAa;;;;;;AAOhC,SAAS,SAAS,SAAiB,KAAmB;AACpD,KAAI,QAAQ,IAAI,aAAa,aAAc;CAE3C,MAAM,UAAU,GAAG,QAAQ,KAAK,IAAI;AAEpC,KAAI,OAAO,IAAI,QAAQ,CAAE;AAEzB,QAAO,IAAI,QAAQ;AACnB,SAAQ,KAAK,iBAAiB,UAAU;;;;;;;;;;;;;;;;;;;AAoB1C,SAAgB,iBACd,YACA,WACqB;CACrB,MAAM,QAAQ,YACV,iBAAiB,YAAY,UAAU,GACvC;AAEJ,KAAI,aAAa,UAAU,KAAA,EACzB,UAAS,qBAAqB,UAAU;CAG1C,SAAS,UACP,KACA,MAC4B;EAC5B,MAAM,QAAQ,iBAAiB,OAAO,IAAI;AAE1C,MAAI,OAAO,UAAU,SAAU,QAAO,YAAY,OAAO,KAAK;AAC9D,MAAI,MAAM,QAAQ,MAAM,CAAE,QAAO;EAEjC,MAAM,OAAO,YAAY,GAAG,UAAU,GAAG,QAAQ;AAEjD,WAAS,mBAAmB,KAAK;AAEjC,SAAO;;AAGT,QAAO"}