@nxgt/mail-i18n 0.1.0

package/dist/index.js

@@ -0,0 +1,675 @@
+// src/manifest.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { isAbsolute, join as join2, relative as relative2, sep as sep2 } from "node:path";
+
+// src/translator.ts
+import { IntlMessageFormat } from "intl-messageformat";
+function lookup(catalogue, key) {
+  let node = catalogue;
+  for (const segment of key.split(".")) {
+    if (typeof node !== "object" || !Object.hasOwn(node, segment))
+      return null;
+    node = node[segment];
+  }
+  return typeof node === "string" ? node : null;
+}
+var resolveLanguage = (language) => typeof language === "function" ? language() : language;
+function createFormatter(prefix) {
+  const compiled = new Map;
+  return (locale, key, text, args) => {
+    const id = `${locale}\x00${key}`;
+    try {
+      let format = compiled.get(id);
+      if (format === undefined) {
+        format = new IntlMessageFormat(text, locale, undefined, {
+          ignoreTag: true
+        });
+        compiled.set(id, format);
+      }
+      return String(format.format(args));
+    } catch (cause) {
+      throw new Error(`${prefix}: ${locale}: ${key} could not be formatted`, {
+        cause
+      });
+    }
+  };
+}
+function createTranslator(catalogues, getLanguage) {
+  if (typeof catalogues !== "object" || catalogues === null) {
+    throw new TypeError("createTranslator: catalogues must be an object of catalogues by locale, as { en, fr }");
+  }
+  if (typeof getLanguage !== "string" && typeof getLanguage !== "function") {
+    throw new TypeError("createTranslator: getLanguage must be a locale or a function that answers one");
+  }
+  const format = createFormatter("t");
+  return (key, args, language = getLanguage) => {
+    const locale = resolveLanguage(language);
+    if (typeof locale !== "string" || !Object.hasOwn(catalogues, locale)) {
+      throw new Error("t: the language is not a locale of the catalogues — pick one with pickLocale");
+    }
+    const text = lookup(catalogues[locale], key);
+    if (text === null)
+      throw new Error(`t: ${locale}: ${key} is not a key`);
+    return format(locale, key, text, args);
+  };
+}
+
+// src/wrappers.ts
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync
+} from "node:fs";
+import { dirname, join, relative, sep } from "node:path";
+var NAME = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+var posix = (path) => path.split(sep).join("/");
+function listEmails(dir, label) {
+  if (!existsSync(dir))
+    return [];
+  return readdirSync(dir, { recursive: true, encoding: "utf8" }).filter((file) => file.endsWith(".vue")).map((file) => {
+    const email = posix(file).slice(0, -".vue".length);
+    for (const segment of email.split("/")) {
+      if (!NAME.test(segment)) {
+        throw new Error(`i18n: ${label}/${email}.vue is not a kebab-case name — name a template as verify-email.vue`);
+      }
+    }
+    return email;
+  }).sort();
+}
+function entryPath(entry, layout) {
+  return layout === "nested" ? `${entry.locale}/${entry.email}` : `${entry.email}.${entry.locale}`;
+}
+function parseEntry(path, layout, locales) {
+  if (layout === "nested") {
+    const [locale, ...rest] = path.split("/");
+    if (locale === undefined || rest.length === 0)
+      return null;
+    return locales.includes(locale) ? { email: rest.join("/"), locale } : null;
+  }
+  const dot = path.lastIndexOf(".");
+  const locale = path.slice(dot + 1);
+  return dot > 0 && locales.includes(locale) ? { email: path.slice(0, dot), locale } : null;
+}
+function wrapperSource(wrapper, template) {
+  const from = posix(relative(dirname(wrapper), template));
+  return [
+    "<!-- Generated by @nxgt/mail-i18n: one per template and locale. Never edited, never committed. -->",
+    "<script setup>",
+    `import Email from '${from.startsWith(".") ? from : `./${from}`}';`,
+    "</script>",
+    "<template><Email /></template>",
+    ""
+  ].join(`
+`);
+}
+function listFiles(dir) {
+  if (!existsSync(dir))
+    return [];
+  return readdirSync(dir, { recursive: true, encoding: "utf8" }).map((file) => join(dir, file)).filter((file) => file.endsWith(".vue"));
+}
+function folderEmails({
+  dir,
+  label,
+  only,
+  packaged
+}) {
+  const emails = listEmails(dir, label);
+  if (packaged && emails.length === 0) {
+    throw new Error(`i18n: ${label} holds no template — is ${dir} the folder of a package's e-mails?`);
+  }
+  for (const email of only ?? []) {
+    if (!emails.includes(email)) {
+      throw new Error(`i18n: ${label} has no template ${email}.vue — name one of its e-mails`);
+    }
+  }
+  return [...only ?? emails];
+}
+function collectTemplates(folders) {
+  const templates = new Map;
+  const owners = new Map;
+  for (const folder of folders) {
+    for (const email of folderEmails(folder)) {
+      const owner = owners.get(email);
+      if (owner === undefined) {
+        owners.set(email, folder);
+        templates.set(email, join(folder.dir, `${email}.vue`));
+      } else if (owner.packaged) {
+        throw new Error(`i18n: ${owner.label} and ${folder.label} both have ${email}.vue — keep one with emails: [...], or write the project's own in its folder`);
+      }
+    }
+  }
+  return templates;
+}
+function writeWrappers(options) {
+  const { wrappersDir, locales, layout } = options;
+  const templates = collectTemplates(options.folders);
+  const wanted = new Set;
+  for (const [email, template] of templates) {
+    for (const locale of locales) {
+      const wrapper = join(wrappersDir, `${entryPath({ email, locale }, layout)}.vue`);
+      wanted.add(wrapper);
+      const source = wrapperSource(wrapper, template);
+      if (existsSync(wrapper) && readFileSync(wrapper, "utf8") === source) {
+        continue;
+      }
+      mkdirSync(dirname(wrapper), { recursive: true });
+      writeFileSync(wrapper, source);
+    }
+  }
+  for (const file of listFiles(wrappersDir)) {
+    if (!wanted.has(file))
+      rmSync(file);
+  }
+  return [...templates.keys()].sort();
+}
+function watchTemplates(emailsDir, regenerate) {
+  return {
+    name: "nxgt-mail-i18n:wrappers",
+    configureServer(server) {
+      server.watcher.add(emailsDir);
+      const onTemplate = (file) => {
+        if (!file.startsWith(emailsDir + sep) || !file.endsWith(".vue"))
+          return;
+        try {
+          regenerate();
+        } catch (error) {
+          console.error(error instanceof Error ? error.message : error);
+        }
+      };
+      server.watcher.on("add", onTemplate);
+      server.watcher.on("unlink", onTemplate);
+    }
+  };
+}
+
+// src/manifest.ts
+var PLACEHOLDER = /\{\{\s*([a-z][a-zA-Z0-9]*)\s*\}\}/g;
+var URL_ATTRIBUTE = /\s(?:href|src|background|poster|action)\s*=\s*(?:"\s*(\{\{[^"]*)"|'\s*(\{\{[^']*)')/gi;
+var placeholderMark = (name) => `{{ ${name} }}`;
+var placeholdersIn = (text) => [...text.matchAll(PLACEHOLDER)].map((match) => match[1]);
+var emailKey = (email) => email.split("/").map((segment) => segment.replace(/-([a-z0-9])/g, (_, char) => char.toUpperCase())).join(".");
+function subjectOf(email, locale, messages, format) {
+  const key = `${emailKey(email)}.subject`;
+  const message = messages.get(key);
+  if (message === undefined) {
+    throw new Error(`i18n: ${email} has no subject — add ${key} to the catalogues`);
+  }
+  const args = {};
+  for (const [name, kind] of message.args) {
+    if (message.selects.has(name)) {
+      throw new Error(`i18n: ${locale}: ${key} chooses on {${name}} with a select — a subject's arguments are placeholders, which always choose other`);
+    }
+    if (kind !== "string") {
+      throw new Error(`i18n: ${locale}: ${key} uses {${name}} as a ${kind} — a subject's arguments are placeholders, filled at send time as strings`);
+    }
+    args[name] = placeholderMark(name);
+  }
+  return format(locale, key, message.text, args);
+}
+var sorted = (values) => [...new Set(values)].sort();
+function buildManifest(options) {
+  const { layout, locales } = options;
+  const format = createFormatter("i18n");
+  const found = new Map;
+  for (const file of options.files) {
+    const path = relative2(options.outputDir, file).split(sep2).join("/");
+    if (path.startsWith("../") || isAbsolute(path)) {
+      throw new Error(`i18n: ${path} was written outside the output folder — the i18n plugin lays out every e-mail; set no plaintext.destination and no output path in a template`);
+    }
+    const dot = path.lastIndexOf(".");
+    const base = path.slice(0, Math.max(dot, 0));
+    const entry = dot > 0 ? parseEntry(base, layout, locales) : null;
+    if (entry === null) {
+      throw new Error(`i18n: ${path} is not where the i18n plugin puts an e-mail — set no output path in a template`);
+    }
+    const seen = found.get(base) ?? { entry, html: null, text: null };
+    if (path.slice(dot + 1) === options.htmlExtension)
+      seen.html = path;
+    else
+      seen.text = path;
+    found.set(base, seen);
+  }
+  const emails = {};
+  for (const email of sorted([...found.values()].map((seen) => seen.entry.email))) {
+    const variables = [];
+    const urlVariables = [];
+    const subject = {};
+    const files = {};
+    for (const locale of locales) {
+      const seen = found.get(entryPath({ email, locale }, layout));
+      if (seen?.html == null) {
+        throw new Error(`i18n: ${email} was not built in ${locale}`);
+      }
+      const html = readFileSync2(join2(options.outputDir, seen.html), "utf8");
+      if (html.replace(/<!doctype[^>]*>/i, "").trim() === "") {
+        throw new Error(`i18n: ${seen.html} is empty — a tag of its template resolved to no component; list the plugin that brings it, as ui()`);
+      }
+      variables.push(...placeholdersIn(html));
+      for (const match of html.matchAll(URL_ATTRIBUTE)) {
+        urlVariables.push(...placeholdersIn(match[1] ?? match[2] ?? "").slice(0, 1));
+      }
+      if (seen.text !== null) {
+        const text = readFileSync2(join2(options.outputDir, seen.text), "utf8");
+        variables.push(...placeholdersIn(text));
+      }
+      subject[locale] = subjectOf(email, locale, options.messages.get(locale), format);
+      variables.push(...placeholdersIn(subject[locale]));
+      files[locale] = { html: seen.html, text: seen.text };
+    }
+    emails[email] = {
+      variables: sorted(variables),
+      urlVariables: sorted(urlVariables),
+      subject,
+      files
+    };
+  }
+  return {
+    locales: [...locales],
+    fallbackLocale: options.fallbackLocale,
+    emails
+  };
+}
+// src/plugin.ts
+import { existsSync as existsSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join3, relative as relative3, resolve, sep as sep3 } from "node:path";
+import { isMainThread } from "node:worker_threads";
+import { defineMailPlugin } from "@nxgt/mail-config";
+
+// src/catalogues.ts
+import {
+  parse,
+  TYPE
+} from "@formatjs/icu-messageformat-parser";
+var SEGMENT = /^[a-z][a-zA-Z0-9]*$/;
+var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function mergeCatalogue(under, over) {
+  const out = { ...under };
+  for (const [key, value] of Object.entries(over)) {
+    const below = Object.hasOwn(out, key) ? out[key] : undefined;
+    Object.defineProperty(out, key, {
+      value: isObject(below) && isObject(value) ? mergeCatalogue(below, value) : value,
+      enumerable: true,
+      writable: true,
+      configurable: true
+    });
+  }
+  return out;
+}
+function layerCatalogues(sources, project) {
+  const out = {};
+  for (const [locale, catalogue] of Object.entries(project)) {
+    out[locale] = [...sources.map((source) => source[locale]), catalogue].filter((layer) => layer !== undefined).reduce(mergeCatalogue, {});
+  }
+  return out;
+}
+function flatten(catalogue, locale, prefix, into) {
+  if (!isObject(catalogue)) {
+    throw new Error(`i18n: ${locale}: ${prefix || "the catalogue"} must be an object of messages`);
+  }
+  for (const [segment, value] of Object.entries(catalogue)) {
+    const key = prefix === "" ? segment : `${prefix}.${segment}`;
+    if (!SEGMENT.test(segment)) {
+      throw new Error(`i18n: ${locale}: ${key} is not camelCase — every segment of a key is camelCase, and nested rather than dotted, as verifyEmail.title`);
+    }
+    if (typeof value === "string")
+      into.set(key, value);
+    else if (isObject(value))
+      flatten(value, locale, key, into);
+    else {
+      throw new Error(`i18n: ${locale}: ${key} must be a message (a string) or an object of messages`);
+    }
+  }
+}
+function collect(elements, uses) {
+  const use = (name, kind) => uses.set(name, (uses.get(name) ?? new Set).add(kind));
+  for (const element of elements) {
+    if (element.type === TYPE.argument)
+      use(element.value, "plain");
+    else if (element.type === TYPE.number)
+      use(element.value, "number");
+    else if (element.type === TYPE.date || element.type === TYPE.time) {
+      use(element.value, "date");
+    } else if (element.type === TYPE.select || element.type === TYPE.plural) {
+      use(element.value, element.type === TYPE.plural ? "number" : "select");
+      for (const option of Object.values(element.options)) {
+        collect(option.value, uses);
+      }
+    } else if (element.type === TYPE.tag)
+      collect(element.children, uses);
+  }
+}
+function analyse(text, locale, key) {
+  let ast;
+  try {
+    ast = parse(text, { ignoreTag: true, shouldParseSkeletons: true });
+  } catch (cause) {
+    const reason = cause instanceof Error ? cause.message : "refused";
+    throw new Error(`i18n: ${locale}: ${key} is not a valid ICU message (${reason})`);
+  }
+  const uses = new Map;
+  collect(ast, uses);
+  const args = new Map;
+  const selects = new Set;
+  for (const [name, kinds] of uses) {
+    if (!SEGMENT.test(name)) {
+      throw new Error(`i18n: ${locale}: ${key} uses {${name}}, which is not camelCase — an argument is a camelCase name, as {firstName}`);
+    }
+    if (kinds.has("select"))
+      selects.add(name);
+    const typed = [
+      ...new Set([...kinds].filter((kind) => kind !== "plain").map((kind) => kind === "select" ? "string" : kind))
+    ];
+    if (typed.length > 1) {
+      throw new Error(`i18n: ${locale}: ${key} uses {${name}} as ${typed.join(" and as ")}`);
+    }
+    args.set(name, typed[0] ?? "string");
+  }
+  return { text, args, selects };
+}
+function compare(locale, messages, fallbackLocale, reference) {
+  for (const key of [...reference.keys()].sort()) {
+    if (!messages.has(key)) {
+      throw new Error(`i18n: ${locale}: ${key} is missing — ${fallbackLocale}, the fallback locale, has it`);
+    }
+  }
+  for (const key of [...messages.keys()].sort()) {
+    const declared = reference.get(key);
+    if (declared === undefined) {
+      throw new Error(`i18n: ${locale}: ${key} is not a key of ${fallbackLocale}, the fallback locale`);
+    }
+    for (const [name, kind] of messages.get(key).args) {
+      const expected = declared.args.get(name);
+      if (expected === undefined) {
+        throw new Error(`i18n: ${locale}: ${key} uses {${name}}, which ${fallbackLocale} does not declare`);
+      }
+      if (expected !== kind) {
+        throw new Error(`i18n: ${locale}: ${key} uses {${name}} as ${kind}, and ${fallbackLocale} declares it as ${expected}`);
+      }
+    }
+  }
+}
+function checkCatalogues(catalogues, locales, fallbackLocale) {
+  const out = new Map;
+  for (const locale of locales) {
+    const flat = new Map;
+    flatten(catalogues[locale], locale, "", flat);
+    out.set(locale, new Map([...flat].map(([key, text]) => [key, analyse(text, locale, key)])));
+  }
+  const reference = out.get(fallbackLocale);
+  for (const locale of locales) {
+    if (locale !== fallbackLocale) {
+      compare(locale, out.get(locale), fallbackLocale, reference);
+    }
+  }
+  return out;
+}
+
+// src/sources.ts
+import { isAbsolute as isAbsolute2 } from "node:path";
+var isObject2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isSource = (source) => isObject2(source) && typeof source.dir === "string" && isAbsolute2(source.dir) && (source.emails === undefined || Array.isArray(source.emails) && source.emails.length > 0 && source.emails.every((email) => typeof email === "string") && new Set(source.emails).size === source.emails.length);
+function checkTemplates(templates) {
+  if (templates !== undefined && (!Array.isArray(templates) || !templates.every(isSource))) {
+    throw new TypeError("i18n: templates must be a list of template folders, as [{ dir: '/abs/path/emails' }] — emails, when given, names at least one, each once");
+  }
+}
+function templateFolders(emails, templates) {
+  return [
+    { dir: emails.dir, label: emails.name },
+    ...templates.map((source, index) => ({
+      dir: source.dir,
+      label: `templates[${index}]`,
+      packaged: true,
+      ...source.emails && { only: source.emails }
+    }))
+  ];
+}
+
+// src/template.ts
+var NAME2 = /^[a-z][a-zA-Z0-9]*$/;
+var KINDS = {
+  string: (value) => typeof value === "string" || typeof value === "number",
+  number: (value) => typeof value === "number",
+  date: (value) => value instanceof Date || typeof value === "number"
+};
+var isPlaceholder = (value) => typeof value === "string" && /^\{\{ [a-z][a-zA-Z0-9]* \}\}$/.test(value);
+var kindOf = (value) => value === null ? "null" : value instanceof Date ? "date" : typeof value;
+function templateProperties(options) {
+  const { email, locale, messages, reference, format } = options;
+  const where = `i18n: ${locale}: ${email}`;
+  return {
+    locale,
+    t(key, args = {}) {
+      const message = typeof key === "string" ? messages.get(key) : undefined;
+      const declared = typeof key === "string" ? reference.get(key) : undefined;
+      if (message === undefined || declared === undefined) {
+        throw new Error(`${where} calls t('${String(key)}'), which is not a key of the catalogues`);
+      }
+      if (typeof args !== "object" || args === null) {
+        throw new Error(`${where} calls t('${key}') with arguments that are not an object, as { name: placeholder('name') }`);
+      }
+      for (const [name, kind] of declared.args) {
+        if (!Object.hasOwn(args, name)) {
+          throw new Error(`${where} calls t('${key}') without {${name}}`);
+        }
+        if (declared.selects.has(name) && isPlaceholder(args[name])) {
+          throw new Error(`${where} passes a placeholder to {${name}}, which ${key} chooses on with a select — a placeholder always chooses other`);
+        }
+        if (!KINDS[kind](args[name])) {
+          throw new Error(`${where} passes {${name}} to ${key} as a ${kindOf(args[name])} — the message uses it as a ${kind}`);
+        }
+      }
+      for (const name of Object.keys(args)) {
+        if (!declared.args.has(name)) {
+          throw new Error(`${where} passes {${name}} to ${key}, which does not use it`);
+        }
+      }
+      return format(locale, key, message.text, args);
+    },
+    placeholder(name) {
+      if (typeof name !== "string" || !NAME2.test(name)) {
+        throw new Error(`${where} calls placeholder() with a name that is not camelCase — as placeholder('firstName')`);
+      }
+      return placeholderMark(name);
+    }
+  };
+}
+
+// src/types.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname2 } from "node:path";
+var TYPES_FILE = ".maizzle/nxgt-mail-i18n.d.ts";
+var TYPE_OF = {
+  string: "string | number",
+  number: "number",
+  date: "Date | number"
+};
+function templateTypes(reference, fallbackLocale) {
+  const entries = [...reference.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([key, message]) => {
+    const args = [...message.args.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([name, kind]) => `${name}: ${TYPE_OF[kind]}`);
+    return `		'${key}': { ${args.join("; ")}${args.length > 0 ? " " : ""}};`;
+  });
+  return [
+    `// Generated by @nxgt/mail-i18n from the ${fallbackLocale} catalogue, each time the config loads.`,
+    "// Never edited, never committed: it types t() in the templates.",
+    "import type {} from '@nxgt/mail-i18n';",
+    "",
+    "declare module '@nxgt/mail-i18n' {",
+    "\tinterface TemplateMessages {",
+    ...entries,
+    "\t}",
+    "}",
+    ""
+  ].join(`
+`);
+}
+var RENDERER_TYPES_HEADER = "// Generated by @nxgt/mail-i18n from the build";
+var RENDERER_TYPES_FILE = "generated/mail.ts";
+function rendererTypes(manifest) {
+  const entries = Object.entries(manifest.emails).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([email, { variables, urlVariables }]) => {
+    const fields = variables.map((name) => `readonly ${name}: ${urlVariables.includes(name) ? "string" : "string | number"}`);
+    const type = fields.length > 0 ? `{ ${fields.join("; ")} }` : "Readonly<Record<string, never>>";
+    return `	${JSON.stringify(email)}: ${type};`;
+  });
+  return [
+    `${RENDERER_TYPES_HEADER}, after each maizzle build.`,
+    "// Never edited; committed, so the code that sends type-checks without a build.",
+    "",
+    "/** The e-mails of the build, each with the variables it takes when it is sent. */",
+    "export interface MailEmails {",
+    ...entries,
+    "}",
+    ""
+  ].join(`
+`);
+}
+function writeRendererTypes(file, path, source) {
+  if (existsSync2(file) && !readFileSync3(file, "utf8").startsWith(RENDERER_TYPES_HEADER)) {
+    throw new Error(`i18n: ${path} was not written by i18n() — point rendererTypes at a file of its own`);
+  }
+  writeIfChanged(file, source);
+}
+function writeIfChanged(file, source) {
+  if (existsSync2(file) && readFileSync3(file, "utf8") === source)
+    return;
+  mkdirSync2(dirname2(file), { recursive: true });
+  writeFileSync2(file, source);
+}
+
+// src/plugin.ts
+var WRAPPERS_DIR = ".maizzle/i18n";
+var MANIFEST_FILE = "mail-manifest.json";
+var LOCALE = /^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$/;
+var isObject3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function checkOptions(options) {
+  if (typeof options !== "object" || options === null) {
+    throw new TypeError("i18n: options must be an object, as { locales: ['en', 'fr'] }");
+  }
+  const { locales } = options;
+  if (!Array.isArray(locales) || locales.length === 0) {
+    throw new TypeError("i18n: locales must hold at least one locale, as ['en', 'fr']");
+  }
+  for (const locale of locales) {
+    if (typeof locale !== "string" || !LOCALE.test(locale)) {
+      throw new TypeError("i18n: locales holds something that is not a locale — write each as a BCP 47 tag, as en or pt-BR");
+    }
+  }
+  if (new Set(locales).size !== locales.length) {
+    throw new TypeError("i18n: locales holds the same locale twice");
+  }
+  if (options.fallbackLocale !== undefined && !locales.includes(options.fallbackLocale)) {
+    throw new TypeError("i18n: fallbackLocale must be one of locales");
+  }
+  for (const key of ["dir", "emails"]) {
+    const value = options[key];
+    if (value !== undefined && (typeof value !== "string" || value === "")) {
+      throw new TypeError(`i18n: ${key} must be a folder of the project`);
+    }
+  }
+  if (options.layout !== undefined && options.layout !== "nested" && options.layout !== "flat") {
+    throw new TypeError("i18n: layout must be 'nested' or 'flat'");
+  }
+  const { catalogues } = options;
+  if (catalogues !== undefined && (!Array.isArray(catalogues) || !catalogues.every((source) => isObject3(source) && Object.values(source).every(isObject3)))) {
+    throw new TypeError("i18n: catalogues must be a list of catalogues by locale, as [{ en: {...}, fr: {...} }]");
+  }
+  const typesPath = options.rendererTypes;
+  if (typesPath !== undefined && typesPath !== false && (typeof typesPath !== "string" || !typesPath.endsWith(".ts"))) {
+    throw new TypeError("i18n: rendererTypes must be the path of a .ts file, as generated/mail.ts, or false");
+  }
+  checkTemplates(options.templates);
+}
+function readCatalogues(dir, dirName, locales) {
+  const out = {};
+  for (const locale of locales) {
+    const file = join3(dir, `${locale}.json`);
+    const name = `${dirName}/${locale}.json`;
+    if (!existsSync3(file)) {
+      throw new Error(`i18n: ${name} is missing — every locale has a catalogue`);
+    }
+    try {
+      out[locale] = JSON.parse(readFileSync4(file, "utf8"));
+    } catch {
+      throw new Error(`i18n: ${name} is not valid JSON`);
+    }
+  }
+  return out;
+}
+function i18n(options) {
+  checkOptions(options);
+  const { locales } = options;
+  const fallbackLocale = options.fallbackLocale ?? locales[0];
+  const layout = options.layout ?? "nested";
+  const dirName = options.dir ?? "locales";
+  const emailsName = options.emails ?? "emails";
+  const cwd = process.cwd();
+  const emailsDir = resolve(cwd, emailsName);
+  const wrappersDir = resolve(cwd, WRAPPERS_DIR);
+  const messages = checkCatalogues(layerCatalogues(options.catalogues ?? [], readCatalogues(resolve(cwd, dirName), dirName, locales)), locales, fallbackLocale);
+  const reference = messages.get(fallbackLocale);
+  const format = createFormatter("i18n");
+  const regenerate = () => writeWrappers({
+    folders: templateFolders({ dir: emailsDir, name: emailsName }, options.templates ?? []),
+    wrappersDir,
+    locales,
+    layout
+  });
+  if (isMainThread) {
+    regenerate();
+    writeIfChanged(resolve(cwd, TYPES_FILE), templateTypes(reference, fallbackLocale));
+  }
+  return defineMailPlugin({
+    name: "i18n",
+    content: [`${wrappersDir}/**/*.vue`],
+    ...dirName === "locales" ? {} : { server: { watch: [`${dirName}/**`] } },
+    vite: { plugins: [watchTemplates(emailsDir, regenerate)] },
+    beforeRender({ config, template }) {
+      const path = relative3(wrappersDir, join3(template.path.dir, template.path.name)).split(sep3).join("/");
+      const entry = parseEntry(path, layout, locales);
+      if (entry === null) {
+        throw new Error(`i18n: ${relative3(cwd, join3(template.path.dir, template.path.base))} is not built through the i18n plugin — leave content to it, and put templates in ${emailsName}/`);
+      }
+      config.vue ??= {};
+      config.vue.globalProperties = {
+        ...config.vue.globalProperties,
+        ...templateProperties({
+          ...entry,
+          messages: messages.get(entry.locale),
+          reference,
+          format
+        })
+      };
+    },
+    afterBuild({ files, config }) {
+      const outputDir = resolve(cwd, config.output?.path ?? "dist");
+      const manifest = buildManifest({
+        files,
+        outputDir,
+        htmlExtension: config.output?.extension ?? "html",
+        layout,
+        locales,
+        fallbackLocale,
+        messages
+      });
+      writeFileSync3(join3(outputDir, MANIFEST_FILE), `${JSON.stringify(manifest, null, "\t")}
+`);
+      const typesFile = options.rendererTypes ?? RENDERER_TYPES_FILE;
+      if (typesFile !== false) {
+        writeRendererTypes(resolve(cwd, typesFile), typesFile, rendererTypes(manifest));
+      }
+    }
+  });
+}
+export {
+  MANIFEST_FILE,
+  WRAPPERS_DIR,
+  createTranslator,
+  emailKey,
+  i18n
+};
+
+//# debugId=874EDA850D792EF364756E2164756E21
+//# sourceMappingURL=index.js.map