@i18n-micro/types 1.2.16 → 1.2.18

package/dist/index.d.cts

@@ -270,10 +270,11 @@ export interface ModuleOptions {
      */
     additionalTranslationDirs?: string[];
     /**
-     * Controls how translation payloads are emitted (Node: `public/<apiBaseUrl>`; Edge: Nitro `serverAssets`).
+     * Controls how translation payloads are emitted (Node server: `public/<apiBaseUrl>`; Edge / function / inline: Nitro `serverAssets`).
      *
-     * - **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.
+     * - **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`.
@@ -511,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;
@@ -530,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;
@@ -583,6 +587,11 @@ export interface ModuleOptionsExtend extends ModuleOptions {
 export interface ModulePrivateOptionsExtend extends ModuleOptions {
     /** Absolute path to the Nuxt project root directory. */
     rootDir: string;
+    /**
+     * Absolute Nuxt layer roots in merge order (extends first, project last).
+     * Used by live/HMR translation reads so layers match build-time merge.
+     */
+    rootDirs: string[];
     /** Resolved debug flag. */
     debug: boolean;
     /** Resolved path to the translations directory. */

package/dist/index.d.ts

@@ -270,10 +270,11 @@ export interface ModuleOptions {
      */
     additionalTranslationDirs?: string[];
     /**
-     * Controls how translation payloads are emitted (Node: `public/<apiBaseUrl>`; Edge: Nitro `serverAssets`).
+     * Controls how translation payloads are emitted (Node server: `public/<apiBaseUrl>`; Edge / function / inline: Nitro `serverAssets`).
      *
-     * - **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.
+     * - **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`.
@@ -511,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;
@@ -530,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;
@@ -583,6 +587,11 @@ export interface ModuleOptionsExtend extends ModuleOptions {
 export interface ModulePrivateOptionsExtend extends ModuleOptions {
     /** Absolute path to the Nuxt project root directory. */
     rootDir: string;
+    /**
+     * Absolute Nuxt layer roots in merge order (extends first, project last).
+     * Used by live/HMR translation reads so layers match build-time merge.
+     */
+    rootDirs: string[];
     /** Resolved debug flag. */
     debug: boolean;
     /** Resolved path to the translations directory. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-micro/types",
-  "version": "1.2.16",
+  "version": "1.2.18",
   "description": "TypeScript definitions for the Nuxt I18n Micro ecosystem.",
   "keywords": [
     "i18n",
@@ -51,9 +51,9 @@
   },
   "devDependencies": {
     "publint": "^0.3.24",
-    "vite": "^8.2.2",
-    "vite-plugin-dts": "^5.1.0",
-    "vitest": "^4.1.11"
+    "vite": "^8.3.1",
+    "vite-plugin-dts": "^5.1.1",
+    "vitest": "^5.0.2"
   },
   "engines": {
     "node": ">=18"