@i18n-micro/types 1.2.15 → 1.2.17

package/dist/index.d.cts

@@ -259,10 +259,22 @@ export interface ModuleOptions {
      */
     translationDir?: string;
     /**
-     * Controls how translation payloads are emitted (Node: `public/<apiBaseUrl>`; Edge: Nitro `serverAssets`).
+     * Extra directories (relative to the project root / each Nuxt layer root) whose top-level
+     * `{locale}.json` files are deep-merged into the global dictionary before `translationDir`.
      *
-     * - **Node**: `serverAssets` means local SSR via `readFile` under `public/` (no Rollup `raw:`).
-     * - **Edge**: `serverAssets` registers Nitro `serverAssets` (`assets:i18n`); it does not force a public copy.
+     * Merge order: each entry in array order (across layers), then `translationDir` (wins on conflicts).
+     * Only root `{locale}.json` files are read — `pages/` under these dirs is ignored.
+     *
+     * Example: `translationDir: 'frontend'`, `additionalTranslationDirs: ['common']` → `common/en.json` then `frontend/en.json`.
+     * @default []
+     */
+    additionalTranslationDirs?: string[];
+    /**
+     * Controls how translation payloads are emitted (Node server: `public/<apiBaseUrl>`; Edge / function / inline: Nitro `serverAssets`).
+     *
+     * - **Node server** (`node-server`, `node-cluster`, disk `serveStatic`): `serverAssets` means local SSR via `readFile` under `public/` (no Rollup `raw:`).
+     * - **Edge, function presets, and `serveStatic: "inline"`** (`vercel`, `netlify`, `aws-lambda`, winterjs, …): `serverAssets` registers Nitro `serverAssets` (`assets:i18n`),
+     *   because `public/` is not available to SSR on disk. Does not force a public copy — set `publicAssets: true` for CDN/static.
      *
      * Keep the defaults for the usual all-in-one setup. For large Edge catalogs prefer `mode: 'source'`.
      * For CDN-backed deployments, disable local outputs and set `apiBaseClientHost` / `apiBaseServerHost`.
@@ -500,13 +512,15 @@ export interface TranslationPayloadOptions {
      */
     mode?: 'premerged' | 'source';
     /**
-     * Local SSR payloads: Node reads `public/<apiBaseUrl>` (forces public copy); Edge embeds via Nitro `serverAssets`.
+     * Local SSR payloads: a Node server that serves `public/` from disk reads that tree (forces public copy);
+     * Edge, function presets, and `serveStatic: "inline"` embed via Nitro `serverAssets`.
      *
-     * - **Node**: no Nitro `serverAssets` (avoids Rollup `raw:`). SSR reads
+     * - **Node server** (preset serves `public/` itself, e.g. `node-server`): no Nitro `serverAssets` (avoids Rollup `raw:`). SSR reads
      *   `public/<apiBaseUrl|publicDir>` as `{page}/{locale}/data.json`; when this is `true`,
      *   a public copy is forced even if `publicAssets` is false.
-     * - **Edge** (`nitro.node === false`): Nitro `serverAssets` (`assets:i18n`) with the same
-     *   layout as `mode`. Does **not** force a public copy — set `publicAssets: true` for CDN.
+     * - **Edge, function presets, and inline** (`nitro.node === false`, no disk `serveStatic` such as `vercel` /
+     *   `netlify` / `aws-lambda`, or `serveStatic: "inline"` e.g. winterjs): Nitro `serverAssets` (`assets:i18n`)
+     *   with the same layout as `mode`. Does **not** force a public copy — set `publicAssets: true` for CDN/static.
      * @default true
      */
     serverAssets?: boolean;
@@ -519,7 +533,8 @@ export interface TranslationPayloadOptions {
     /**
      * Copy payloads into Nitro public output. Premerged → `{page}/{locale}/data.json` under `apiBaseUrl`; source → compact tree.
      *
-     * On Node this tree is also the SSR source when `serverAssets` forces a public copy.
+     * When SSR reads `public/` (`node-server` and similar), `serverAssets: true` also forces this copy.
+     * On Edge / function / `serveStatic: "inline"` presets, copy only when this is `true` (SSR uses the Nitro embed).
      * @default true in premerged mode, false in source mode
      */
     publicAssets?: boolean;

package/dist/index.d.ts

@@ -259,10 +259,22 @@ export interface ModuleOptions {
      */
     translationDir?: string;
     /**
-     * Controls how translation payloads are emitted (Node: `public/<apiBaseUrl>`; Edge: Nitro `serverAssets`).
+     * Extra directories (relative to the project root / each Nuxt layer root) whose top-level
+     * `{locale}.json` files are deep-merged into the global dictionary before `translationDir`.
      *
-     * - **Node**: `serverAssets` means local SSR via `readFile` under `public/` (no Rollup `raw:`).
-     * - **Edge**: `serverAssets` registers Nitro `serverAssets` (`assets:i18n`); it does not force a public copy.
+     * Merge order: each entry in array order (across layers), then `translationDir` (wins on conflicts).
+     * Only root `{locale}.json` files are read — `pages/` under these dirs is ignored.
+     *
+     * Example: `translationDir: 'frontend'`, `additionalTranslationDirs: ['common']` → `common/en.json` then `frontend/en.json`.
+     * @default []
+     */
+    additionalTranslationDirs?: string[];
+    /**
+     * Controls how translation payloads are emitted (Node server: `public/<apiBaseUrl>`; Edge / function / inline: Nitro `serverAssets`).
+     *
+     * - **Node server** (`node-server`, `node-cluster`, disk `serveStatic`): `serverAssets` means local SSR via `readFile` under `public/` (no Rollup `raw:`).
+     * - **Edge, function presets, and `serveStatic: "inline"`** (`vercel`, `netlify`, `aws-lambda`, winterjs, …): `serverAssets` registers Nitro `serverAssets` (`assets:i18n`),
+     *   because `public/` is not available to SSR on disk. Does not force a public copy — set `publicAssets: true` for CDN/static.
      *
      * Keep the defaults for the usual all-in-one setup. For large Edge catalogs prefer `mode: 'source'`.
      * For CDN-backed deployments, disable local outputs and set `apiBaseClientHost` / `apiBaseServerHost`.
@@ -500,13 +512,15 @@ export interface TranslationPayloadOptions {
      */
     mode?: 'premerged' | 'source';
     /**
-     * Local SSR payloads: Node reads `public/<apiBaseUrl>` (forces public copy); Edge embeds via Nitro `serverAssets`.
+     * Local SSR payloads: a Node server that serves `public/` from disk reads that tree (forces public copy);
+     * Edge, function presets, and `serveStatic: "inline"` embed via Nitro `serverAssets`.
      *
-     * - **Node**: no Nitro `serverAssets` (avoids Rollup `raw:`). SSR reads
+     * - **Node server** (preset serves `public/` itself, e.g. `node-server`): no Nitro `serverAssets` (avoids Rollup `raw:`). SSR reads
      *   `public/<apiBaseUrl|publicDir>` as `{page}/{locale}/data.json`; when this is `true`,
      *   a public copy is forced even if `publicAssets` is false.
-     * - **Edge** (`nitro.node === false`): Nitro `serverAssets` (`assets:i18n`) with the same
-     *   layout as `mode`. Does **not** force a public copy — set `publicAssets: true` for CDN.
+     * - **Edge, function presets, and inline** (`nitro.node === false`, no disk `serveStatic` such as `vercel` /
+     *   `netlify` / `aws-lambda`, or `serveStatic: "inline"` e.g. winterjs): Nitro `serverAssets` (`assets:i18n`)
+     *   with the same layout as `mode`. Does **not** force a public copy — set `publicAssets: true` for CDN/static.
      * @default true
      */
     serverAssets?: boolean;
@@ -519,7 +533,8 @@ export interface TranslationPayloadOptions {
     /**
      * Copy payloads into Nitro public output. Premerged → `{page}/{locale}/data.json` under `apiBaseUrl`; source → compact tree.
      *
-     * On Node this tree is also the SSR source when `serverAssets` forces a public copy.
+     * When SSR reads `public/` (`node-server` and similar), `serverAssets: true` also forces this copy.
+     * On Edge / function / `serveStatic: "inline"` presets, copy only when this is `true` (SSR uses the Nitro embed).
      * @default true in premerged mode, false in source mode
      */
     publicAssets?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/types",
-  "version": "1.2.15",
+  "version": "1.2.17",
   "description": "TypeScript definitions for the Nuxt I18n Micro ecosystem.",
   "keywords": [
     "i18n",