@mapomodule/i18n 2.0.0-beta.2

package/dist/runtime/locales/mapo.it.json

@@ -0,0 +1,261 @@
+{
+  "mapo": {
+    "cancel": "Annulla",
+    "save": "Salva",
+    "apply": "Applica",
+    "confirm": "Conferma",
+    "ok": "OK",
+    "close": "Chiudi",
+    "edit": "Modifica",
+    "delete": "Elimina",
+    "add": "Aggiungi",
+    "remove": "Rimuovi",
+    "clear": "Svuota",
+    "expand": "Espandi",
+    "collapse": "Comprimi",
+    "search": "Cerca...",
+    "create": "Crea",
+    "new": "Nuovo",
+    "createContinue": "Crea e continua",
+    "saveContinue": "Salva e continua",
+    "back": "Indietro",
+    "leave": "Esci",
+    "preview": "Anteprima",
+    "refresh": "Aggiorna",
+    "select": "Seleziona",
+    "change": "Cambia",
+    "duplicate": "Duplica",
+    "restore": "Ripristina",
+    "discard": "Scarta",
+    "loading": "Caricamento...",
+    "genericError": "Qualcosa è andato storto, riprova più tardi...",
+    "saveSuccess": "Elemento salvato con successo!",
+    "createSuccess": "Elemento creato con successo!",
+    "deleteSuccess": "Elemento eliminato con successo!",
+    "saveError": "Salvataggio non riuscito",
+    "deleteError": "Eliminazione non riuscita",
+    "loadError": "Caricamento dati non riuscito",
+    "loadItemError": "Caricamento elemento non riuscito",
+    "fixErrors": "Correggi gli errori prima di salvare.",
+    "confirmDelete": "Vuoi veramente eliminare questo elemento?",
+    "unsavedData": "Modifiche non salvate",
+    "confirmLeaveChanges": "Ci sono modifiche non salvate. Vuoi uscire senza salvare?",
+    "fetchingData": "Caricamento in corso...",
+    "login": {
+      "welcome": "Benvenuto in Mapo",
+      "subtitle": "Inserisci le tue credenziali per continuare",
+      "tagline": "Un framework admin moderno costruito su Nuxt 4, Pinia e Nuxt UI v4.",
+      "invalidCredentials": "Credenziali non valide. Riprova."
+    },
+    "logout": "Esci",
+    "signIn": "Accedi",
+    "username": "Nome utente",
+    "password": "Password",
+    "name": "Nome",
+    "title": "Titolo",
+    "description": "Descrizione",
+    "mime": "Tipo MIME",
+    "fileName": "Nome file",
+    "file": "File",
+    "folder": "Cartella",
+    "created": "Creato il",
+    "size": "Dimensioni",
+    "altTag": "Testo alternativo",
+    "url": "URL",
+    "linkedModels": "Modelli collegati",
+    "latitude": "Latitudine",
+    "longitude": "Longitudine",
+    "language": "Lingua",
+    "index": {
+      "welcomeMessage": "Congratulazioni!! 🥳 Mapo è stato installato correttamente!"
+    },
+    "themeToggle": {
+      "light": "Passa al tema chiaro",
+      "dark": "Passa al tema scuro"
+    },
+    "confirmDialog": {
+      "areYouSure": "Sei sicuro di ciò che stai facendo?"
+    },
+    "dropArea": {
+      "dropOrClick": "Trascina qui i tuoi file, o clicca per selezionarli.",
+      "dropHere": "Trascina qui",
+      "onlyOneFile": "È possibile caricare un solo file alla volta..."
+    },
+    "detail": {
+      "deleteQuestion": "Vuoi veramente eliminare questo elemento? Questa azione non può essere annullata.",
+      "draftFound": "È presente una bozza locale non salvata. Vuoi ripristinarla o scartarla?",
+      "draftSavedAt": "Bozza non salvata trovata — ultima modifica {date}"
+    },
+    "form": {
+      "required": "Questo campo è obbligatorio.",
+      "tabErrors": "Questa scheda contiene errori"
+    },
+    "fksField": {
+      "searchSelect": "Cerca e seleziona...",
+      "noResults": "Nessun risultato trovato",
+      "noItems": "Nessun elemento disponibile"
+    },
+    "dateField": {
+      "selectDate": "Seleziona data",
+      "selectDateTime": "Seleziona data e ora"
+    },
+    "fileField": {
+      "removeFile": "Rimuovi file"
+    },
+    "mediaField": {
+      "selectMedia": "Seleziona media"
+    },
+    "mediaM2MField": {
+      "addMedia": "Aggiungi media"
+    },
+    "enhancedMediaField": {
+      "altText": "Testo alternativo",
+      "caption": "Didascalia"
+    },
+    "repeater": {
+      "repeater": "Repeater",
+      "nItems": "{n} elemento | {n} elementi",
+      "nSelected": "{n} selezionati",
+      "all": "Tutti",
+      "collapseAll": "Comprimi tutti",
+      "expandAll": "Espandi tutti",
+      "deleteItem": "Elimina elemento",
+      "deleteItems": "Elimina elementi",
+      "confirmBulkDelete": "Eliminare {count} elementi selezionati?",
+      "actionBlocked": "Azione bloccata",
+      "minItemsBlock": "Impossibile eliminare: devono rimanere almeno {min} elementi.",
+      "undoLastAction": "Annulla ultima azione",
+      "bulkSelection": "Selezione multipla",
+      "exitSelection": "Esci dalla selezione",
+      "duplicateSelected": "Duplica selezionati",
+      "duplicateLimited": "Solo {slots} di {count} possono essere duplicati (raggiunto maxItems)",
+      "moveToTop": "Sposta in cima",
+      "moveUp": "Sposta su",
+      "moveDown": "Sposta giù",
+      "position": "Posizione",
+      "editFullScreen": "Modifica a schermo intero",
+      "empty": "Nessun elemento. Clicca \"Aggiungi\" per iniziare."
+    },
+    "seoPreview": {
+      "seoTitle": "Titolo SEO",
+      "metaDescription": "Meta descrizione",
+      "googlePreview": "Anteprima Google",
+      "titlePlaceholder": "Titolo della pagina...",
+      "descriptionPlaceholder": "Descrizione della pagina...",
+      "defaultTitle": "Titolo della pagina",
+      "defaultDescription": "Descrizione della pagina che apparirà nei risultati di ricerca di Google."
+    },
+    "wygEditor": {
+      "insertImage": "Inserisci immagine",
+      "requiresUikit": "Richiede {'@'}mapomodule/uikit"
+    },
+    "listActions": {
+      "bulkActions": "Azioni di gruppo...",
+      "permanentDelete": "Eliminazione permanente",
+      "confirmBulk": "Questa azione verrà applicata a tutti gli elementi. Vuoi continuare?",
+      "confirmBulkCount": "Questa azione verrà applicata a {count} elementi. Vuoi continuare?",
+      "actionCompleted": "Azione completata",
+      "actionFailed": "Azione non riuscita"
+    },
+    "listFilters": {
+      "filters": "Filtri",
+      "clearAll": "Rimuovi tutti"
+    },
+    "listQuickEdit": {
+      "newItem": "Nuovo elemento"
+    },
+    "listTable": {
+      "deleteItemTitle": "Elimina elemento",
+      "itemDeleted": "Elemento eliminato",
+      "deleteItemError": "Eliminazione elemento non riuscita",
+      "orderSaved": "Ordinamento salvato",
+      "orderError": "Riordinamento non riuscito",
+      "selectAllRows": "Seleziona tutte le righe",
+      "selectRow": "Seleziona riga",
+      "dragToReorder": "Trascina per riordinare",
+      "clearToReorder": "Svuota ricerca e ordinamento per riordinare",
+      "noItems": "Nessun elemento trovato",
+      "totalItems": "{total} elementi",
+      "perPage": "{n} / pagina"
+    },
+    "menuManager": {
+      "menu": "Menu",
+      "noSelectedNode": "Seleziona un nodo da modificare o creane uno nuovo."
+    },
+    "menuTreeview": {
+      "newNode": "Crea nodo",
+      "noRootNodes": "Non c'è nessun nodo qui. Creane uno nuovo!",
+      "deleteTitle": "Elimina nodo",
+      "areYouSureDelete": "Sei sicuro di voler eliminare questo nodo e tutti i suoi discendenti?",
+      "maxDepthReached": "Raggiunta la profondità massima di annidamento ({max} livelli)"
+    },
+    "menuNodeEditor": {
+      "editNode": "Nodo",
+      "title": "Titolo",
+      "linkTypeLabel": "Tipo di link",
+      "styleLabel": "Stile",
+      "openInNewTabLabel": "Apri in una nuova finestra",
+      "relContentTypeLabel": "Tipo di pagina",
+      "relPageIdLabel": "Pagina",
+      "staticLabel": "URL statico",
+      "relational": "Relazionale",
+      "static": "Statico",
+      "nodeErrors": "Questo nodo contiene errori"
+    },
+    "mediaEditor": {
+      "details": "Dettagli",
+      "defaultLang": "Predefinita",
+      "openInNewTab": "Apri in una nuova scheda",
+      "confirmDelete": "Vuoi veramente eliminare \"{name}\"?"
+    },
+    "mediaFileChanger": {
+      "replaceFile": "Sostituisci file",
+      "dragOrClick": "Trascina o clicca per scegliere un file",
+      "keepUrl": "Mantieni URL attuale"
+    },
+    "mediaFolders": {
+      "folders": "Cartelle",
+      "goBack": "Torna alla radice",
+      "noFolders": "Non sono presenti cartelle... Creane una!",
+      "newFolder": "Nuova cartella",
+      "folderName": "Nome cartella",
+      "allFolder": "Tutti",
+      "imageFolder": "Immagini",
+      "videoFolder": "Video",
+      "audioFolder": "Audio",
+      "docFolder": "Documenti",
+      "deleteTitle": "Elimina cartella",
+      "confirmDelete": "Eliminare la cartella \"{name}\"? I media al suo interno non verranno eliminati."
+    },
+    "mediaGallery": {
+      "noMediaFound": "Nessun media trovato",
+      "selectAll": "Seleziona pagina",
+      "deselectAll": "Deseleziona pagina",
+      "nSelected": "{number} selezionati",
+      "deleteTitle": "Elimina media selezionati",
+      "deleteSelectedLabel": "Elimina selezionati",
+      "deleteSelected": "Stai per eliminare {number} elementi. Vuoi continuare?",
+      "deleteSuccess": "{number} elementi eliminati!"
+    },
+    "mediaManager": {
+      "root": "Media",
+      "gallery": "Galleria",
+      "uploader": "Caricamento",
+      "fileInfo": "Media aggiornato",
+      "deleteTitle": "Elimina media",
+      "selectMedia": "Seleziona media",
+      "selectAMedia": "Seleziona un media"
+    },
+    "mediaUploader": {
+      "dragHere": "Trascina qui i file oppure",
+      "browse": "sfoglia",
+      "limits": "Immagini fino a {img} MB · Video fino a {vid} MB",
+      "nSelected": "{n} file selezionato | {n} file selezionati",
+      "uploadCta": "Carica {n} file | Carica {n} file",
+      "uploaded": "Caricato",
+      "uploadFailed": "Caricamento non riuscito",
+      "fileTooLarge": "File \"{name}\" troppo grande (max {max} MB)",
+      "success": "{numberFiles} file caricati con successo"
+    }
+  }
+}

package/dist/types.d.mts

@@ -0,0 +1,9 @@
+import type { NuxtModule } from '@nuxt/schema'
+
+import type { default as Module } from './module.mjs'
+
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
+
+export { default } from './module.mjs'
+
+export { type MapoI18nOptions, type MapoLocale } from './module.mjs'

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@mapomodule/i18n",
+  "version": "2.0.0-beta.2",
+  "description": "Mapo i18n wrapper: @nuxtjs/i18n v9 + base translations",
+  "type": "module",
+  "license": "MIT",
+  "author": "Lotrek Agency (https://lotrek.it)",
+  "homepage": "https://lotrekagency.github.io/mapo-new/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lotrekagency/mapo-new.git",
+    "directory": "packages/@mapomodule/i18n"
+  },
+  "bugs": {
+    "url": "https://github.com/lotrekagency/mapo-new/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/module.d.mts",
+      "import": "./dist/module.mjs"
+    },
+    "./types": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./runtime/*": {
+      "types": "./src/runtime/*.ts",
+      "import": "./dist/runtime/*.js",
+      "default": "./src/runtime/*"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "dev": "nuxt-module-build build --stub --watch",
+    "build": "nuxt-module-build build && tsc -p tsconfig.build-types.json",
+    "dev:prepare": "nuxt-module-build build --stub",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src"
+  },
+  "dependencies": {
+    "@nuxtjs/i18n": "^10.4.1",
+    "defu": "^6.1.4"
+  },
+  "peerDependencies": {
+    "nuxt": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@nuxt/kit": "4.4.2",
+    "@nuxt/module-builder": "^1.0.2",
+    "@nuxt/schema": "4.4.2",
+    "nuxt": "^4.5.1",
+    "vue": "^3.5.40"
+  }
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+// Re-export types for direct TypeScript access outside Nuxt context
+import en from "./runtime/locales/mapo.en.json";
+
+export type { MapoI18nOptions, MapoLocale } from "./module";
+
+/**
+ * Shape of the Mapo built-in message catalog (English is the source of
+ * truth — every locale ships the same keys).
+ */
+export type MapoMessages = typeof en;
+
+/**
+ * Recursively builds the union of dot-separated key paths of an object type.
+ * `{ mapo: { save: string } }` → `"mapo" | "mapo.save"`.
+ */
+type DotPaths<T, Prefix extends string = ""> = {
+  [K in keyof T & string]: T[K] extends Record<string, unknown>
+    ? `${Prefix}${K}` | DotPaths<T[K], `${Prefix}${K}.`>
+    : `${Prefix}${K}`;
+}[keyof T & string];
+
+/**
+ * Union of every valid Mapo translation key
+ * (e.g. `"mapo.save"`, `"mapo.menuManager.noSelectedNode"`).
+ *
+ * Useful to type helper wrappers in consuming apps:
+ * ```ts
+ * import type { MapoI18nKey } from "@mapomodule/i18n/types";
+ * const key: MapoI18nKey = "mapo.save";
+ * t(key);
+ * ```
+ */
+export type MapoI18nKey = DotPaths<MapoMessages>;

package/src/module.ts

@@ -0,0 +1,193 @@
+import {
+  defineNuxtModule,
+  hasNuxtModule,
+  installModule,
+  createResolver,
+  addImports,
+  addTemplate,
+} from "@nuxt/kit";
+import type { NuxtModule } from "@nuxt/schema";
+import { defu } from "defu";
+// Side-effect type import: augments NuxtHooks with `i18n:registerModule`.
+import type {} from "@nuxtjs/i18n";
+
+/**
+ * Locale descriptor accepted by `mapoI18n.locales`.
+ * Mirrors the shape of `@nuxtjs/i18n` LocaleObject without importing its types
+ * (they are only available once the module is installed in the app).
+ */
+export interface MapoLocale {
+  /** Locale code used in URLs/cookies and by `setLocale` (e.g. `"en"`). */
+  code: string;
+  /** BCP-47 language tag used for SEO/browser matching (e.g. `"en-US"`). */
+  language?: string;
+  /** Human readable name shown by `<MapoLangSwitcher>`. */
+  name?: string;
+  /**
+   * Translation file(s) resolved from the app's `i18n/locales/` directory.
+   * Only needed when the app provides its own messages for this locale.
+   */
+  file?: string;
+  /** Multiple translation files merged in order. */
+  files?: string[];
+  /** Text direction. */
+  dir?: "ltr" | "rtl" | "auto";
+  [key: string]: unknown;
+}
+
+export interface MapoI18nOptions {
+  /**
+   * Default UI locale. Also used as `fallbackLocale` for missing keys.
+   * @default "en"
+   */
+  defaultLocale?: string;
+
+  /**
+   * Locales available in the app. Defaults to English + Italian (the two
+   * languages Mapo ships translations for). Add entries with `file`/`files`
+   * to bring your own languages — Mapo strings fall back to `defaultLocale`
+   * for locales it doesn't cover.
+   */
+  locales?: MapoLocale[];
+
+  /**
+   * Detect the browser language on first visit and persist the choice in a
+   * cookie. Set `false` to always start from `defaultLocale`.
+   * @default true
+   */
+  detectBrowserLanguage?: boolean;
+
+  /**
+   * Extra options forwarded verbatim to `@nuxtjs/i18n` (they win over the
+   * Mapo defaults). Use this as an escape hatch for advanced setups —
+   * e.g. `strategy`, `customRoutes`, `vueI18n` config path…
+   * @see https://i18n.nuxtjs.org/docs/api/options
+   */
+  i18n?: Record<string, unknown>;
+}
+
+const MAPO_LOCALES = [
+  { code: "en", language: "en-US", name: "English" },
+  { code: "it", language: "it-IT", name: "Italiano" },
+] satisfies MapoLocale[];
+
+/**
+ * Nuxt module that wires `@nuxtjs/i18n` into a Mapo app:
+ *
+ * - registers Mapo's built-in UI translations (`en`, `it`) under the `mapo.*`
+ *   key namespace via the `i18n:registerModule` hook;
+ * - installs `@nuxtjs/i18n` with admin-friendly defaults (`no_prefix`
+ *   strategy, browser detection, cookie persistence) unless the app already
+ *   declares it in `modules[]` — in that case the app's configuration wins
+ *   and this module only contributes the Mapo message catalogs.
+ *
+ * Apps override single strings by shipping the same key in their own locale
+ * files (`i18n/locales/<code>.json`): project-level messages are merged on
+ * top of module-registered ones.
+ */
+export default defineNuxtModule<MapoI18nOptions>({
+  meta: {
+    name: "@mapomodule/i18n",
+    configKey: "mapoI18n",
+  },
+
+  defaults: {
+    defaultLocale: "en",
+    detectBrowserLanguage: true,
+  },
+
+  async setup(options, nuxt) {
+    const resolver = createResolver(import.meta.url);
+
+    // Auto-import the translator so consuming apps never have to import it from
+    // `@mapomodule/i18n/runtime/*`: with pnpm's isolated layout that subpath is
+    // only resolvable when the app lists this package in its own dependencies,
+    // and apps install it transitively through `mapomodule`.
+    // Registered before the early return below so it also applies when the app
+    // manages @nuxtjs/i18n itself.
+    addImports([
+      {
+        name: "useMapoT",
+        from: resolver.resolve("./runtime/composables/useMapoT"),
+      },
+    ]);
+
+    // Register the hook BEFORE installing @nuxtjs/i18n so the catalogs are
+    // picked up regardless of module ordering in the consuming app.
+    // The catalog files are named `mapo.<code>.json`, not `<code>.json`:
+    // @nuxtjs/i18n keys its locale loaders by file basename, so a Mapo catalog
+    // called `en.json` would collide with the app's own `i18n/locales/en.json`
+    // and only one of the two would survive — silently dropping the consumer's
+    // overrides.
+    nuxt.hook("i18n:registerModule", (register) => {
+      register({
+        langDir: resolver.resolve("./runtime/locales"),
+        locales: [
+          { code: "en", language: "en-US", file: "mapo.en.json" },
+          { code: "it", language: "it-IT", file: "mapo.it.json" },
+        ],
+      });
+    });
+
+    if (hasNuxtModule("@nuxtjs/i18n")) {
+      // The app manages @nuxtjs/i18n itself — don't fight its configuration.
+      return;
+    }
+
+    // Generated vue-i18n config: `fallbackLocale` follows `defaultLocale` so
+    // locales without Mapo catalogs (e.g. a consumer-added "fr") still render
+    // Mapo strings instead of raw keys.
+    const vueI18nConfig = addTemplate({
+      filename: "mapo-i18n.config.mjs",
+      write: true,
+      getContents: () =>
+        `export default () => ({\n` +
+        `  legacy: false,\n` +
+        `  fallbackLocale: ${JSON.stringify(options.defaultLocale ?? "en")},\n` +
+        `});\n`,
+    });
+
+    const i18nConfig = defu(options.i18n ?? {}, {
+      strategy: "no_prefix",
+      defaultLocale: options.defaultLocale ?? "en",
+      locales: options.locales ?? MAPO_LOCALES,
+      detectBrowserLanguage: options.detectBrowserLanguage
+        ? {
+            useCookie: true,
+            cookieKey: "i18n_redirected",
+            redirectOn: "root",
+          }
+        : false,
+      vueI18n: vueI18nConfig.dst,
+    });
+
+    // The configuration has to land on the LAYER config, not just on
+    // `nuxt.options.i18n`: @nuxtjs/i18n discovers per-locale translation files
+    // by walking `nuxt.options._layers[].config.i18n` (see `getLayerI18n`),
+    // which is the raw nuxt.config object and ignores anything a module writes
+    // to `nuxt.options` at setup time. Writing only to `nuxt.options.i18n`
+    // configures the module but silently drops every `file` declared by the
+    // consuming app — so `mapo.i18n.locales` overrides would never load.
+    // Both are set, and whatever the app declared itself always wins.
+    // `i18n` comes from @nuxtjs/i18n's own NuxtOptions augmentation, which is
+    // not resolvable here — hence the structural casts.
+    const nuxtOptions = nuxt.options as unknown as {
+      i18n?: Record<string, unknown>;
+      _layers?: Array<{ config: { i18n?: Record<string, unknown> } }>;
+    };
+    nuxtOptions.i18n = defu(nuxtOptions.i18n ?? {}, i18nConfig) as Record<
+      string,
+      unknown
+    >;
+
+    const rootLayer = nuxtOptions._layers?.[0];
+    if (rootLayer) {
+      rootLayer.config.i18n = defu(
+        rootLayer.config.i18n ?? {},
+        i18nConfig,
+      ) as Record<string, unknown>;
+    }
+
+    await installModule("@nuxtjs/i18n");
+  },
+}) satisfies NuxtModule<MapoI18nOptions>;

package/src/runtime/composables/useMapoT.ts

@@ -0,0 +1,21 @@
+import { useNuxtApp } from "nuxt/app";
+
+type TranslateFn = (key: string, named?: Record<string, unknown>) => string;
+
+/**
+ * Returns the global vue-i18n `t` function bound to the app's i18n instance.
+ *
+ * Use this in contexts where `useI18n()` is not available — Pinia store
+ * actions, composables invoked outside component `setup`, imperative
+ * snack/confirm messages. Inside components prefer `useI18n()` from
+ * `vue-i18n`, which is reactive to locale changes in render functions.
+ */
+export function useMapoT(): TranslateFn {
+  const { $i18n } = useNuxtApp() as unknown as {
+    $i18n?: { t: TranslateFn };
+  };
+  // Degrade to the raw key instead of throwing when no i18n instance is
+  // available (unit tests instantiating a store outside a Nuxt app).
+  if (!$i18n?.t) return (key) => key;
+  return (key, named) => (named ? $i18n.t(key, named) : $i18n.t(key));
+}