next-intlayer 9.2.0 → 9.3.1

package/dist/esm/server/prepareSwcOptimization.mjs

@@ -0,0 +1,185 @@
+import { dirname, join } from "node:path";
+import * as ANSIColors from "@intlayer/config/colors";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
+import { getProjectRequire } from "@intlayer/config/utils";
+import { runOnce } from "@intlayer/engine/utils";
+import { readFileSync, rmSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+
+//#region src/server/prepareSwcOptimization.ts
+/**
+* Opt-in to the SWC plugin's per-file tracing.
+*
+* The plugin transforms one file at a time with no cross-file state, so all it
+* can report is a line per file — hundreds of them on a real project, and with
+* no counterpart in the Vite build output. The purge and minify summaries that
+* `log.mode` does control are emitted by the pipeline itself, in Node; this
+* variable is purely a debugging aid on top.
+*/
+const SWC_LOG_LEVEL_ENV_VAR = "INTLAYER_SWC_LOG_LEVEL";
+/** Sentinel coordinating the pipeline across the processes of one build. */
+const PURGE_SENTINEL_FILE_NAME = "intlayer-swc-purge.lock";
+/** Where the serialised field-rename tables are cached between processes. */
+const FIELD_RENAME_MAP_FILE_NAME = "swc-field-rename-map.json";
+/**
+* Next.js evaluates `next.config.*` in the main build process and again in each
+* Turbopack/webpack worker. The dictionary rewrite must happen exactly once —
+* a second run would derive the short aliases from the already-renamed JSON —
+* so the sentinel window has to cover a whole build startup.
+*/
+const PURGE_CACHE_TIMEOUT_MS = 3e4;
+/** Absolute path of a file in the intlayer cache directory. */
+const getCacheFilePath = (intlayerConfig, fileName) => join(intlayerConfig.system.baseDir, ".intlayer", "cache", fileName);
+/**
+* Resolves the verbosity the `@intlayer/swc` plugin should report at.
+*
+* Off unless {@link SWC_LOG_LEVEL_ENV_VAR} asks for tracing: `log.mode` governs
+* the purge and minify reporting, which the pipeline emits in Node so the
+* Next.js build reads the same as the Vite one.
+*/
+const resolveSwcLogLevel = (intlayerConfig) => {
+	if (intlayerConfig.log.mode === "disabled") return "off";
+	const requestedLogLevel = process.env[SWC_LOG_LEVEL_ENV_VAR];
+	return requestedLogLevel === "info" || requestedLogLevel === "debug" ? requestedLogLevel : "off";
+};
+/**
+* Whether the purge / minify pipeline should run for this build.
+*
+* Compat-adapter callers disable it: their descriptors reach `withIntlayer`
+* only in the SWC plugin's lossy wire format, so the usage analyser would not
+* recognise `useTranslation(...)` & co. and would purge fields those call sites
+* still read.
+*/
+const getIsPurgePipelineEnabled = (intlayerConfig, swcExtraCallers, isSwcPluginUsable) => {
+	const { purge, minify, optimize } = intlayerConfig.build;
+	if (optimize === false) return false;
+	if (!purge && !minify) return false;
+	if (!isSwcPluginUsable) return false;
+	if (swcExtraCallers && swcExtraCallers.length > 0) {
+		getAppLogger(intlayerConfig)([
+			"Dictionary purge and minification are",
+			colorize("disabled", ANSIColors.GREY_DARK),
+			"because compat-adapter callers are configured — their call sites are",
+			"not visible to the usage analyser."
+		], { level: "warn" });
+		return false;
+	}
+	return true;
+};
+/**
+* Exports this module needs from `@intlayer/babel`. Checked one by one so a
+* version predating the purge pipeline is rejected like a missing package,
+* instead of failing later with `runIntlayerPurgePipeline is not a function`.
+*/
+const REQUIRED_BABEL_EXPORTS = [
+	"getPurgePluginOptions",
+	"runIntlayerPurgePipeline",
+	"serializeFieldRenameMap"
+];
+/**
+* Lazily loads `@intlayer/babel`, or `null` when it is not installed or too old
+* to expose the purge pipeline.
+*/
+const loadIntlayerBabel = (intlayerConfig) => {
+	try {
+		const intlayerBabel = (intlayerConfig.build?.require ?? getProjectRequire())("@intlayer/babel");
+		if (!REQUIRED_BABEL_EXPORTS.every((exportName) => typeof intlayerBabel?.[exportName] === "function")) return null;
+		return intlayerBabel;
+	} catch {
+		return null;
+	}
+};
+/**
+* Whether the purge / minify pipeline can run at all, i.e. whether a usable
+* `@intlayer/babel` is resolvable from the project.
+*
+* Used by `withIntlayer` to keep the build report honest: announcing
+* `Dictionary minification enabled` while the pipeline cannot load would describe a
+* pass that never happens.
+*/
+const getIsPurgePipelineAvailable = (intlayerConfig) => loadIntlayerBabel(intlayerConfig) !== null;
+/**
+* Runs the purge / minify pipeline and writes the resulting field-rename
+* tables to the cache file so every process of the build reads the same ones.
+*/
+const runPurgePipelineOnce = async (intlayerConfig, configOptions, dictionaries, fieldRenameMapFilePath) => {
+	const appLogger = getAppLogger(intlayerConfig);
+	const intlayerBabel = loadIntlayerBabel(intlayerConfig);
+	if (!intlayerBabel) {
+		appLogger([
+			"Dictionary purge and minification are",
+			colorize("disabled", ANSIColors.GREY_DARK),
+			"because",
+			colorize("@intlayer/babel", ANSIColors.GREY_LIGHT),
+			"is missing or too old to expose the purge pipeline — install it in",
+			"this project to enable them."
+		], { level: "warn" });
+		return;
+	}
+	const { getPurgePluginOptions, runIntlayerPurgePipeline, serializeFieldRenameMap } = intlayerBabel;
+	let fieldRenameMap;
+	try {
+		fieldRenameMap = serializeFieldRenameMap(runIntlayerPurgePipeline(getPurgePluginOptions({
+			configOptions,
+			dictionaries
+		})));
+	} catch (pipelineError) {
+		appLogger([
+			"Dictionary purge and minification",
+			colorize("failed", ANSIColors.RED),
+			"— the compiled dictionaries are left untouched.",
+			pipelineError instanceof Error ? `(${pipelineError.message})` : String(pipelineError)
+		], { level: "error" });
+		return;
+	}
+	await mkdir(dirname(fieldRenameMapFilePath), { recursive: true });
+	await writeFile(fieldRenameMapFilePath, JSON.stringify(fieldRenameMap), "utf-8");
+};
+/** Reads the cached field-rename tables, or `{}` when none were written. */
+const readFieldRenameMapFile = (fieldRenameMapFilePath) => {
+	try {
+		return JSON.parse(readFileSync(fieldRenameMapFilePath, "utf-8"));
+	} catch {
+		return {};
+	}
+};
+/** Removes the cached field-rename tables, ignoring a missing file. */
+const removeFieldRenameMapFile = (fieldRenameMapFilePath) => {
+	try {
+		rmSync(fieldRenameMapFilePath, { force: true });
+	} catch {}
+};
+/**
+* Prepares the parts of the build optimisation the `@intlayer/swc` plugin
+* cannot do itself, and returns the field-rename tables it needs.
+*
+* Removing unused content fields (`build.purge`) and assigning short field
+* aliases (`build.minify`) require reading every component source file and
+* rewriting the compiled dictionary JSON — file I/O and cross-file state that a
+* per-file Wasm transform has no access to. That analysis therefore runs here,
+* in Node, through `@intlayer/babel`; the plugin only receives the resulting
+* tables and rewrites the matching source accesses
+* (`content.title` → `content.a`).
+*
+* The work is coordinated by a sentinel file: Next.js loads `next.config.*` in
+* several processes per build, and running the minify pass twice would derive
+* the aliases from the already-renamed dictionaries. Processes that lose the
+* race read the tables the winner cached.
+*
+* @returns The field-rename tables, keyed by dictionary key. Empty when the
+*   pipeline is disabled, unavailable, or renamed nothing.
+*/
+const prepareSwcOptimization = async (intlayerConfig, params) => {
+	const { configOptions, dictionaries, swcExtraCallers, isSwcPluginUsable } = params;
+	const fieldRenameMapFilePath = getCacheFilePath(intlayerConfig, FIELD_RENAME_MAP_FILE_NAME);
+	if (!getIsPurgePipelineEnabled(intlayerConfig, swcExtraCallers, isSwcPluginUsable)) {
+		removeFieldRenameMapFile(fieldRenameMapFilePath);
+		return {};
+	}
+	await runOnce(getCacheFilePath(intlayerConfig, PURGE_SENTINEL_FILE_NAME), () => runPurgePipelineOnce(intlayerConfig, configOptions, dictionaries, fieldRenameMapFilePath), { cacheTimeoutMs: PURGE_CACHE_TIMEOUT_MS });
+	return readFieldRenameMapFile(fieldRenameMapFilePath);
+};
+
+//#endregion
+export { getIsPurgePipelineAvailable, prepareSwcOptimization, resolveSwcLogLevel };
+//# sourceMappingURL=prepareSwcOptimization.mjs.map

package/dist/esm/server/prepareSwcOptimization.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareSwcOptimization.mjs","names":[],"sources":["../../../src/server/prepareSwcOptimization.ts"],"sourcesContent":["import { readFileSync, rmSync } from 'node:fs';\nimport { mkdir, writeFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport type {\n  getPurgePluginOptions as GetPurgePluginOptions,\n  runIntlayerPurgePipeline as RunIntlayerPurgePipeline,\n  SerializedFieldRenameMap,\n  serializeFieldRenameMap as SerializeFieldRenameMap,\n} from '@intlayer/babel';\nimport type { SwcExtraCallerConfig } from '@intlayer/config/callers';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { GetConfigurationOptions } from '@intlayer/config/node';\nimport { getProjectRequire } from '@intlayer/config/utils';\nimport { runOnce } from '@intlayer/engine/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport type { Dictionary } from '@intlayer/types/dictionary';\n\n/**\n * Field-rename tables keyed by dictionary key, forwarded to the\n * `@intlayer/swc` plugin's `fieldRenameMap` option.\n */\nexport type FieldRenameMapByDictionaryKey = Record<\n  string,\n  SerializedFieldRenameMap\n>;\n\n/** Verbosity forwarded to the `@intlayer/swc` plugin's `logLevel` option. */\nexport type SwcLogLevel = 'off' | 'info' | 'debug';\n\n/**\n * Subset of `@intlayer/babel` this module needs. The package is only an\n * optional runtime dependency, so it is required lazily and never imported at\n * module scope.\n */\ntype IntlayerBabelModule = {\n  getPurgePluginOptions: typeof GetPurgePluginOptions;\n  runIntlayerPurgePipeline: typeof RunIntlayerPurgePipeline;\n  serializeFieldRenameMap: typeof SerializeFieldRenameMap;\n};\n\n/**\n * Opt-in to the SWC plugin's per-file tracing.\n *\n * The plugin transforms one file at a time with no cross-file state, so all it\n * can report is a line per file — hundreds of them on a real project, and with\n * no counterpart in the Vite build output. The purge and minify summaries that\n * `log.mode` does control are emitted by the pipeline itself, in Node; this\n * variable is purely a debugging aid on top.\n */\nconst SWC_LOG_LEVEL_ENV_VAR = 'INTLAYER_SWC_LOG_LEVEL';\n\n/** Sentinel coordinating the pipeline across the processes of one build. */\nconst PURGE_SENTINEL_FILE_NAME = 'intlayer-swc-purge.lock';\n\n/** Where the serialised field-rename tables are cached between processes. */\nconst FIELD_RENAME_MAP_FILE_NAME = 'swc-field-rename-map.json';\n\n/**\n * Next.js evaluates `next.config.*` in the main build process and again in each\n * Turbopack/webpack worker. The dictionary rewrite must happen exactly once —\n * a second run would derive the short aliases from the already-renamed JSON —\n * so the sentinel window has to cover a whole build startup.\n */\nconst PURGE_CACHE_TIMEOUT_MS = 30 * 1000;\n\n/** Absolute path of a file in the intlayer cache directory. */\nconst getCacheFilePath = (\n  intlayerConfig: IntlayerConfig,\n  fileName: string\n): string =>\n  join(intlayerConfig.system.baseDir, '.intlayer', 'cache', fileName);\n\n/**\n * Resolves the verbosity the `@intlayer/swc` plugin should report at.\n *\n * Off unless {@link SWC_LOG_LEVEL_ENV_VAR} asks for tracing: `log.mode` governs\n * the purge and minify reporting, which the pipeline emits in Node so the\n * Next.js build reads the same as the Vite one.\n */\nexport const resolveSwcLogLevel = (\n  intlayerConfig: IntlayerConfig\n): SwcLogLevel => {\n  if (intlayerConfig.log.mode === 'disabled') return 'off';\n\n  const requestedLogLevel = process.env[SWC_LOG_LEVEL_ENV_VAR];\n\n  return requestedLogLevel === 'info' || requestedLogLevel === 'debug'\n    ? requestedLogLevel\n    : 'off';\n};\n\n/**\n * Whether the purge / minify pipeline should run for this build.\n *\n * Compat-adapter callers disable it: their descriptors reach `withIntlayer`\n * only in the SWC plugin's lossy wire format, so the usage analyser would not\n * recognise `useTranslation(...)` & co. and would purge fields those call sites\n * still read.\n */\nconst getIsPurgePipelineEnabled = (\n  intlayerConfig: IntlayerConfig,\n  swcExtraCallers: SwcExtraCallerConfig[] | undefined,\n  isSwcPluginUsable: boolean\n): boolean => {\n  const { purge, minify, optimize } = intlayerConfig.build;\n\n  if (optimize === false) return false;\n  if (!purge && !minify) return false;\n\n  // The pipeline rewrites the compiled dictionaries in place — dropping unused\n  // fields and renaming the rest to short aliases. Only the SWC plugin rewrites\n  // the matching source accesses, so running this without it would ship\n  // dictionaries whose keys no longer match the code reading them.\n  if (!isSwcPluginUsable) return false;\n\n  // `editor.enabled` is deliberately not checked here: the pipeline stands down\n  // on its own and explains why, the same way the Vite build does.\n\n  if (swcExtraCallers && swcExtraCallers.length > 0) {\n    getAppLogger(intlayerConfig)(\n      [\n        'Dictionary purge and minification are',\n        colorize('disabled', ANSIColors.GREY_DARK),\n        'because compat-adapter callers are configured — their call sites are',\n        'not visible to the usage analyser.',\n      ],\n      { level: 'warn' }\n    );\n    return false;\n  }\n\n  return true;\n};\n\n/**\n * Exports this module needs from `@intlayer/babel`. Checked one by one so a\n * version predating the purge pipeline is rejected like a missing package,\n * instead of failing later with `runIntlayerPurgePipeline is not a function`.\n */\nconst REQUIRED_BABEL_EXPORTS = [\n  'getPurgePluginOptions',\n  'runIntlayerPurgePipeline',\n  'serializeFieldRenameMap',\n] as const satisfies readonly (keyof IntlayerBabelModule)[];\n\n/**\n * Lazily loads `@intlayer/babel`, or `null` when it is not installed or too old\n * to expose the purge pipeline.\n */\nconst loadIntlayerBabel = (\n  intlayerConfig: IntlayerConfig\n): IntlayerBabelModule | null => {\n  try {\n    const requireFunction =\n      intlayerConfig.build?.require ?? getProjectRequire();\n\n    const intlayerBabel = requireFunction(\n      '@intlayer/babel'\n    ) as Partial<IntlayerBabelModule>;\n\n    const hasEveryRequiredExport = REQUIRED_BABEL_EXPORTS.every(\n      (exportName) => typeof intlayerBabel?.[exportName] === 'function'\n    );\n\n    if (!hasEveryRequiredExport) return null;\n\n    return intlayerBabel as IntlayerBabelModule;\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Whether the purge / minify pipeline can run at all, i.e. whether a usable\n * `@intlayer/babel` is resolvable from the project.\n *\n * Used by `withIntlayer` to keep the build report honest: announcing\n * `Dictionary minification enabled` while the pipeline cannot load would describe a\n * pass that never happens.\n */\nexport const getIsPurgePipelineAvailable = (\n  intlayerConfig: IntlayerConfig\n): boolean => loadIntlayerBabel(intlayerConfig) !== null;\n\n/**\n * Runs the purge / minify pipeline and writes the resulting field-rename\n * tables to the cache file so every process of the build reads the same ones.\n */\nconst runPurgePipelineOnce = async (\n  intlayerConfig: IntlayerConfig,\n  configOptions: GetConfigurationOptions | undefined,\n  dictionaries: Dictionary[] | undefined,\n  fieldRenameMapFilePath: string\n): Promise<void> => {\n  const appLogger = getAppLogger(intlayerConfig);\n\n  const intlayerBabel = loadIntlayerBabel(intlayerConfig);\n\n  if (!intlayerBabel) {\n    // Not verbose: the build asked for purge / minify and is silently getting\n    // neither, which is exactly the kind of thing a default build must report.\n    appLogger(\n      [\n        'Dictionary purge and minification are',\n        colorize('disabled', ANSIColors.GREY_DARK),\n        'because',\n        colorize('@intlayer/babel', ANSIColors.GREY_LIGHT),\n        'is missing or too old to expose the purge pipeline — install it in',\n        'this project to enable them.',\n      ],\n      { level: 'warn' }\n    );\n    return;\n  }\n\n  const {\n    getPurgePluginOptions,\n    runIntlayerPurgePipeline,\n    serializeFieldRenameMap,\n  } = intlayerBabel;\n\n  // `runOnce` discards whatever this callback throws, so a pipeline failure\n  // would otherwise leave the build with no dictionaries rewritten and no\n  // explanation of why.\n  let fieldRenameMap: FieldRenameMapByDictionaryKey;\n\n  try {\n    // The pipeline reports what it purged and minified through the intlayer\n    // logger, matching the Vite build output.\n    const pruneContext = runIntlayerPurgePipeline(\n      getPurgePluginOptions({ configOptions, dictionaries })\n    );\n\n    fieldRenameMap = serializeFieldRenameMap(pruneContext);\n  } catch (pipelineError) {\n    appLogger(\n      [\n        'Dictionary purge and minification',\n        colorize('failed', ANSIColors.RED),\n        '— the compiled dictionaries are left untouched.',\n        pipelineError instanceof Error\n          ? `(${pipelineError.message})`\n          : String(pipelineError),\n      ],\n      { level: 'error' }\n    );\n    return;\n  }\n\n  await mkdir(dirname(fieldRenameMapFilePath), { recursive: true });\n  await writeFile(\n    fieldRenameMapFilePath,\n    JSON.stringify(fieldRenameMap),\n    'utf-8'\n  );\n};\n\n/** Reads the cached field-rename tables, or `{}` when none were written. */\nconst readFieldRenameMapFile = (\n  fieldRenameMapFilePath: string\n): FieldRenameMapByDictionaryKey => {\n  try {\n    return JSON.parse(\n      readFileSync(fieldRenameMapFilePath, 'utf-8')\n    ) as FieldRenameMapByDictionaryKey;\n  } catch {\n    return {};\n  }\n};\n\n/** Removes the cached field-rename tables, ignoring a missing file. */\nconst removeFieldRenameMapFile = (fieldRenameMapFilePath: string): void => {\n  try {\n    rmSync(fieldRenameMapFilePath, { force: true });\n  } catch {\n    // Nothing to clean up.\n  }\n};\n\ntype PrepareSwcOptimizationParams = {\n  /** Options forwarded to the intlayer configuration loader. */\n  configOptions?: GetConfigurationOptions;\n  /** Pre-loaded dictionaries, to avoid a second `getDictionaries` call. */\n  dictionaries?: Dictionary[];\n  /** Compat-adapter callers declared by the consuming plugin, if any. */\n  swcExtraCallers?: SwcExtraCallerConfig[];\n  /**\n   * Whether the `@intlayer/swc` plugin is installed *and* the resolved Next.js\n   * version can load it. False leaves the compiled dictionaries untouched.\n   */\n  isSwcPluginUsable: boolean;\n};\n\n/**\n * Prepares the parts of the build optimisation the `@intlayer/swc` plugin\n * cannot do itself, and returns the field-rename tables it needs.\n *\n * Removing unused content fields (`build.purge`) and assigning short field\n * aliases (`build.minify`) require reading every component source file and\n * rewriting the compiled dictionary JSON — file I/O and cross-file state that a\n * per-file Wasm transform has no access to. That analysis therefore runs here,\n * in Node, through `@intlayer/babel`; the plugin only receives the resulting\n * tables and rewrites the matching source accesses\n * (`content.title` → `content.a`).\n *\n * The work is coordinated by a sentinel file: Next.js loads `next.config.*` in\n * several processes per build, and running the minify pass twice would derive\n * the aliases from the already-renamed dictionaries. Processes that lose the\n * race read the tables the winner cached.\n *\n * @returns The field-rename tables, keyed by dictionary key. Empty when the\n *   pipeline is disabled, unavailable, or renamed nothing.\n */\nexport const prepareSwcOptimization = async (\n  intlayerConfig: IntlayerConfig,\n  params: PrepareSwcOptimizationParams\n): Promise<FieldRenameMapByDictionaryKey> => {\n  const { configOptions, dictionaries, swcExtraCallers, isSwcPluginUsable } =\n    params;\n\n  const fieldRenameMapFilePath = getCacheFilePath(\n    intlayerConfig,\n    FIELD_RENAME_MAP_FILE_NAME\n  );\n\n  // A stale file from an earlier build would rename source accesses that the\n  // dictionaries no longer match.\n  if (\n    !getIsPurgePipelineEnabled(\n      intlayerConfig,\n      swcExtraCallers,\n      isSwcPluginUsable\n    )\n  ) {\n    removeFieldRenameMapFile(fieldRenameMapFilePath);\n    return {};\n  }\n\n  await runOnce(\n    getCacheFilePath(intlayerConfig, PURGE_SENTINEL_FILE_NAME),\n    () =>\n      runPurgePipelineOnce(\n        intlayerConfig,\n        configOptions,\n        dictionaries,\n        fieldRenameMapFilePath\n      ),\n    { cacheTimeoutMs: PURGE_CACHE_TIMEOUT_MS }\n  );\n\n  return readFieldRenameMapFile(fieldRenameMapFilePath);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkDA,MAAM,wBAAwB;;AAG9B,MAAM,2BAA2B;;AAGjC,MAAM,6BAA6B;;;;;;;AAQnC,MAAM,yBAAyB;;AAG/B,MAAM,oBACJ,gBACA,aAEA,KAAK,eAAe,OAAO,SAAS,aAAa,SAAS,QAAQ;;;;;;;;AASpE,MAAa,sBACX,mBACgB;CAChB,IAAI,eAAe,IAAI,SAAS,YAAY,OAAO;CAEnD,MAAM,oBAAoB,QAAQ,IAAI;CAEtC,OAAO,sBAAsB,UAAU,sBAAsB,UACzD,oBACA;AACN;;;;;;;;;AAUA,MAAM,6BACJ,gBACA,iBACA,sBACY;CACZ,MAAM,EAAE,OAAO,QAAQ,aAAa,eAAe;CAEnD,IAAI,aAAa,OAAO,OAAO;CAC/B,IAAI,CAAC,SAAS,CAAC,QAAQ,OAAO;CAM9B,IAAI,CAAC,mBAAmB,OAAO;CAK/B,IAAI,mBAAmB,gBAAgB,SAAS,GAAG;EACjD,aAAa,cAAc,CAAC,CAC1B;GACE;GACA,SAAS,YAAY,WAAW,SAAS;GACzC;GACA;EACF,GACA,EAAE,OAAO,OAAO,CAClB;EACA,OAAO;CACT;CAEA,OAAO;AACT;;;;;;AAOA,MAAM,yBAAyB;CAC7B;CACA;CACA;AACF;;;;;AAMA,MAAM,qBACJ,mBAC+B;CAC/B,IAAI;EAIF,MAAM,iBAFJ,eAAe,OAAO,WAAW,kBAAkB,EAEhB,CACnC,iBACF;EAMA,IAAI,CAJ2B,uBAAuB,OACnD,eAAe,OAAO,gBAAgB,gBAAgB,UAG/B,GAAG,OAAO;EAEpC,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;;;AAUA,MAAa,+BACX,mBACY,kBAAkB,cAAc,MAAM;;;;;AAMpD,MAAM,uBAAuB,OAC3B,gBACA,eACA,cACA,2BACkB;CAClB,MAAM,YAAY,aAAa,cAAc;CAE7C,MAAM,gBAAgB,kBAAkB,cAAc;CAEtD,IAAI,CAAC,eAAe;EAGlB,UACE;GACE;GACA,SAAS,YAAY,WAAW,SAAS;GACzC;GACA,SAAS,mBAAmB,WAAW,UAAU;GACjD;GACA;EACF,GACA,EAAE,OAAO,OAAO,CAClB;EACA;CACF;CAEA,MAAM,EACJ,uBACA,0BACA,4BACE;CAKJ,IAAI;CAEJ,IAAI;EAOF,iBAAiB,wBAJI,yBACnB,sBAAsB;GAAE;GAAe;EAAa,CAAC,CAGH,CAAC;CACvD,SAAS,eAAe;EACtB,UACE;GACE;GACA,SAAS,UAAU,WAAW,GAAG;GACjC;GACA,yBAAyB,QACrB,IAAI,cAAc,QAAQ,KAC1B,OAAO,aAAa;EAC1B,GACA,EAAE,OAAO,QAAQ,CACnB;EACA;CACF;CAEA,MAAM,MAAM,QAAQ,sBAAsB,GAAG,EAAE,WAAW,KAAK,CAAC;CAChE,MAAM,UACJ,wBACA,KAAK,UAAU,cAAc,GAC7B,OACF;AACF;;AAGA,MAAM,0BACJ,2BACkC;CAClC,IAAI;EACF,OAAO,KAAK,MACV,aAAa,wBAAwB,OAAO,CAC9C;CACF,QAAQ;EACN,OAAO,CAAC;CACV;AACF;;AAGA,MAAM,4BAA4B,2BAAyC;CACzE,IAAI;EACF,OAAO,wBAAwB,EAAE,OAAO,KAAK,CAAC;CAChD,QAAQ,CAER;AACF;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,yBAAyB,OACpC,gBACA,WAC2C;CAC3C,MAAM,EAAE,eAAe,cAAc,iBAAiB,sBACpD;CAEF,MAAM,yBAAyB,iBAC7B,gBACA,0BACF;CAIA,IACE,CAAC,0BACC,gBACA,iBACA,iBACF,GACA;EACA,yBAAyB,sBAAsB;EAC/C,OAAO,CAAC;CACV;CAEA,MAAM,QACJ,iBAAiB,gBAAgB,wBAAwB,SAEvD,qBACE,gBACA,eACA,cACA,sBACF,GACF,EAAE,gBAAgB,uBAAuB,CAC3C;CAEA,OAAO,uBAAuB,sBAAsB;AACtD"}

package/dist/esm/server/swcPluginCompatibility.mjs

@@ -0,0 +1,55 @@
+import { compareVersions } from "@intlayer/config/utils";
+
+//#region src/server/swcPluginCompatibility.ts
+/**
+* Oldest Next.js release whose bundled SWC can load the `@intlayer/swc` Wasm
+* plugin.
+*
+* A Wasm plugin only loads in a host that speaks its `swc_ecma_ast` schema.
+* Next.js 16.1.0 is the first release built on SWC's forward-compatible plugin
+* ABI — the AST travels as self-describing CBOR instead of rkyv, so a plugin
+* compiled against an older `swc_core` keeps loading in newer hosts. Every
+* earlier release uses the rkyv ABI, which requires an exact schema match and
+* rejects the plugin outright, failing the build with `failed to invoke
+* plugin`.
+*
+* Verified by driving `transformSync` on the shipped `@next/swc` binaries with
+* the plugin attached:
+*
+* | Next.js | swc_ecma_ast | plugin loads |
+* | ------- | ------------ | ------------ |
+* | 14.2.x  | 0.112.7      | no           |
+* | 15.5.x  | 14.0.0       | no           |
+* | 16.0.x  | 16.0.0       | no           |
+* | 16.1.x  | 19.0.0       | yes          |
+* | 16.2.x  | 20.0.1       | yes          |
+* | 16.3.x  | 25.0.0       | yes          |
+*
+* Keep in sync with the `swc_core` pin in
+* `packages/@intlayer/swc/Cargo.toml`: the plugin must stay on the
+* `swc_ecma_ast` version this Next.js release ships, never a newer one, or the
+* floor moves up with it.
+*/
+const MINIMUM_SWC_PLUGIN_NEXT_VERSION = "16.1.0";
+/**
+* Whether `nextVersion` bundles an SWC able to load the `@intlayer/swc` Wasm
+* plugin.
+*
+* Pre-releases of a supported version (`16.1.0-canary.4`, `16.3.0-preview.5`)
+* count as supported: they track the release they lead to, and opting into a
+* canary already means opting into its churn.
+*
+* @param nextVersion - Version string read from the project's `next/package.json`.
+* @returns `true` when the plugin can be registered in `experimental.swcPlugins`.
+*
+* @example
+* ```ts
+* getIsSwcPluginSupported('16.3.0'); // true
+* getIsSwcPluginSupported('15.5.18'); // false
+* ```
+*/
+const getIsSwcPluginSupported = (nextVersion) => compareVersions(nextVersion, "≥", MINIMUM_SWC_PLUGIN_NEXT_VERSION);
+
+//#endregion
+export { MINIMUM_SWC_PLUGIN_NEXT_VERSION, getIsSwcPluginSupported };
+//# sourceMappingURL=swcPluginCompatibility.mjs.map

package/dist/esm/server/swcPluginCompatibility.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"swcPluginCompatibility.mjs","names":[],"sources":["../../../src/server/swcPluginCompatibility.ts"],"sourcesContent":["import { compareVersions } from '@intlayer/config/utils';\n\n/**\n * Oldest Next.js release whose bundled SWC can load the `@intlayer/swc` Wasm\n * plugin.\n *\n * A Wasm plugin only loads in a host that speaks its `swc_ecma_ast` schema.\n * Next.js 16.1.0 is the first release built on SWC's forward-compatible plugin\n * ABI — the AST travels as self-describing CBOR instead of rkyv, so a plugin\n * compiled against an older `swc_core` keeps loading in newer hosts. Every\n * earlier release uses the rkyv ABI, which requires an exact schema match and\n * rejects the plugin outright, failing the build with `failed to invoke\n * plugin`.\n *\n * Verified by driving `transformSync` on the shipped `@next/swc` binaries with\n * the plugin attached:\n *\n * | Next.js | swc_ecma_ast | plugin loads |\n * | ------- | ------------ | ------------ |\n * | 14.2.x  | 0.112.7      | no           |\n * | 15.5.x  | 14.0.0       | no           |\n * | 16.0.x  | 16.0.0       | no           |\n * | 16.1.x  | 19.0.0       | yes          |\n * | 16.2.x  | 20.0.1       | yes          |\n * | 16.3.x  | 25.0.0       | yes          |\n *\n * Keep in sync with the `swc_core` pin in\n * `packages/@intlayer/swc/Cargo.toml`: the plugin must stay on the\n * `swc_ecma_ast` version this Next.js release ships, never a newer one, or the\n * floor moves up with it.\n */\nexport const MINIMUM_SWC_PLUGIN_NEXT_VERSION = '16.1.0';\n\n/**\n * Whether `nextVersion` bundles an SWC able to load the `@intlayer/swc` Wasm\n * plugin.\n *\n * Pre-releases of a supported version (`16.1.0-canary.4`, `16.3.0-preview.5`)\n * count as supported: they track the release they lead to, and opting into a\n * canary already means opting into its churn.\n *\n * @param nextVersion - Version string read from the project's `next/package.json`.\n * @returns `true` when the plugin can be registered in `experimental.swcPlugins`.\n *\n * @example\n * ```ts\n * getIsSwcPluginSupported('16.3.0'); // true\n * getIsSwcPluginSupported('15.5.18'); // false\n * ```\n */\nexport const getIsSwcPluginSupported = (nextVersion: string): boolean =>\n  compareVersions(nextVersion, '≥', MINIMUM_SWC_PLUGIN_NEXT_VERSION);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,kCAAkC;;;;;;;;;;;;;;;;;;AAmB/C,MAAa,2BAA2B,gBACtC,gBAAgB,aAAa,KAAK,+BAA+B"}

package/dist/esm/server/useDictionary.mjs

@@ -9,7 +9,8 @@ import { useDictionary as useDictionary$1 } from "react-intlayer/server";
 * If the locale is not provided, it will use the locale from the server context.
 */
 const useDictionary = (dictionary, localeOrSelector) => {
-	return useDictionary$1(dictionary, localeOrSelector, safeUseLocale());
+	const storedLocale = safeUseLocale();
+	return useDictionary$1(dictionary, localeOrSelector, storedLocale);
 };
 
 //#endregion

package/dist/esm/server/useDictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionary.mjs","names":["useDictionaryBase"],"sources":["../../../src/server/useDictionary.ts"],"sourcesContent":["import type {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useDictionary as useDictionaryBase } from 'react-intlayer/server';\nimport { safeUseLocale } from './useIntlayer';\n\n/**\n * On the server side, hook that transforms a dictionary (or qualified\n * dictionary group) and returns the content for the given locale or selector.\n *\n * If the locale is not provided, it will use the locale from the server context.\n */\nexport const useDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n): ReturnType<typeof useDictionaryBase<T, A>> => {\n  const storedLocale = safeUseLocale();\n\n  return useDictionaryBase<T, A>(dictionary, localeOrSelector, storedLocale);\n};\n"],"mappings":";;;;;;;;;;AAmBA,MAAa,iBAMX,YACA,qBAC+C;CAG/C,OAAOA,gBAAwB,YAAY,kBAFtB,cAEmD,CAAC;AAC3E"}
+{"version":3,"file":"useDictionary.mjs","names":["useDictionaryBase"],"sources":["../../../src/server/useDictionary.ts"],"sourcesContent":["import type {\n  Dictionary,\n  DictionarySelector,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useDictionary as useDictionaryBase } from 'react-intlayer/server';\nimport { safeUseLocale } from './useIntlayer';\n\n/**\n * On the server side, hook that transforms a dictionary (or qualified\n * dictionary group) and returns the content for the given locale or selector.\n *\n * If the locale is not provided, it will use the locale from the server context.\n */\nexport const useDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n): ReturnType<typeof useDictionaryBase<T, A>> => {\n  const storedLocale = safeUseLocale();\n\n  return useDictionaryBase<T, A>(dictionary, localeOrSelector, storedLocale);\n};\n"],"mappings":";;;;;;;;;;AAmBA,MAAa,iBAMX,YACA,qBAC+C;CAC/C,MAAM,eAAe,cAAc;CAEnC,OAAOA,gBAAwB,YAAY,kBAAkB,YAAY;AAC3E"}

package/dist/esm/server/useDictionaryAsync.mjs

@@ -8,7 +8,8 @@ import { useDictionaryAsync as useDictionaryAsync$1 } from "react-intlayer/serve
 * If the locale is not provided, it will use the locale from the server context
 */
 const useDictionaryAsync = async (dictionaryPromise, locale) => {
-	return useDictionaryAsync$1(dictionaryPromise, locale, await getLocale());
+	const storedLocale = await getLocale();
+	return useDictionaryAsync$1(dictionaryPromise, locale, storedLocale);
 };
 
 //#endregion

package/dist/esm/server/useDictionaryAsync.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryAsync.mjs","names":["useDictionaryAsyncBase"],"sources":["../../../src/server/useDictionaryAsync.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useDictionaryAsync as useDictionaryAsyncBase } from 'react-intlayer/server';\nimport { getLocale } from './getLocale';\n\n/**\n * On the server side, Hook that transform a dictionary and return the content\n *\n * If the locale is not provided, it will use the locale from the server context\n */\nexport const useDictionaryAsync = async <\n  const T extends Dictionary,\n  const L extends DeclaredLocales = DeclaredLocales,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  locale?: L\n): ReturnType<typeof useDictionaryAsyncBase<T, L>> => {\n  const storedLocale = await getLocale();\n\n  return useDictionaryAsyncBase<T, L>(dictionaryPromise, locale, storedLocale);\n};\n"],"mappings":";;;;;;;;;AAaA,MAAa,qBAAqB,OAIhC,mBACA,WACoD;CAGpD,OAAOA,qBAA6B,mBAAmB,QAAQ,MAFpC,UAAU,CAEsC;AAC7E"}
+{"version":3,"file":"useDictionaryAsync.mjs","names":["useDictionaryAsyncBase"],"sources":["../../../src/server/useDictionaryAsync.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useDictionaryAsync as useDictionaryAsyncBase } from 'react-intlayer/server';\nimport { getLocale } from './getLocale';\n\n/**\n * On the server side, Hook that transform a dictionary and return the content\n *\n * If the locale is not provided, it will use the locale from the server context\n */\nexport const useDictionaryAsync = async <\n  const T extends Dictionary,\n  const L extends DeclaredLocales = DeclaredLocales,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  locale?: L\n): ReturnType<typeof useDictionaryAsyncBase<T, L>> => {\n  const storedLocale = await getLocale();\n\n  return useDictionaryAsyncBase<T, L>(dictionaryPromise, locale, storedLocale);\n};\n"],"mappings":";;;;;;;;;AAaA,MAAa,qBAAqB,OAIhC,mBACA,WACoD;CACpD,MAAM,eAAe,MAAM,UAAU;CAErC,OAAOA,qBAA6B,mBAAmB,QAAQ,YAAY;AAC7E"}

package/dist/esm/server/useDictionaryDynamic.mjs

@@ -9,7 +9,8 @@ import { useDictionaryDynamic as useDictionaryDynamic$1 } from "react-intlayer/s
 * If the locale is not provided, it will use the locale from the server context.
 */
 const useDictionaryDynamic = (dictionaryPromise, key, localeOrSelector) => {
-	return useDictionaryDynamic$1(dictionaryPromise, key, localeOrSelector, safeUseLocale());
+	const storedLocale = safeUseLocale();
+	return useDictionaryDynamic$1(dictionaryPromise, key, localeOrSelector, storedLocale);
 };
 
 //#endregion

package/dist/esm/server/useDictionaryDynamic.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.mjs","names":["useDictionaryDynamicBase"],"sources":["../../../src/server/useDictionaryDynamic.ts"],"sourcesContent":["import type { QualifiedDynamicLoaderMap } from '@intlayer/core/dictionaryManipulator';\nimport type {\n  Dictionary,\n  DictionarySelector,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useDictionaryDynamic as useDictionaryDynamicBase } from 'react-intlayer/server';\nimport { safeUseLocale } from './useIntlayer';\n\n/**\n * On the server side, hook that lazily loads a dictionary (plain or qualified)\n * and returns the content for the given locale or selector.\n *\n * If the locale is not provided, it will use the locale from the server context.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const A extends LocalesValues | DictionarySelector = DeclaredLocales,\n>(\n  dictionaryPromise:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: string,\n  localeOrSelector?: A\n): ReturnType<typeof useDictionaryDynamicBase<T, A>> => {\n  const storedLocale = safeUseLocale();\n\n  return useDictionaryDynamicBase<T, A>(\n    dictionaryPromise,\n    key,\n    localeOrSelector,\n    storedLocale\n  );\n};\n"],"mappings":";;;;;;;;;;AAmBA,MAAa,wBAIX,mBAGA,KACA,qBACsD;CAGtD,OAAOA,uBACL,mBACA,KACA,kBALmB,cAMR,CACb;AACF"}
+{"version":3,"file":"useDictionaryDynamic.mjs","names":["useDictionaryDynamicBase"],"sources":["../../../src/server/useDictionaryDynamic.ts"],"sourcesContent":["import type { QualifiedDynamicLoaderMap } from '@intlayer/core/dictionaryManipulator';\nimport type {\n  Dictionary,\n  DictionarySelector,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useDictionaryDynamic as useDictionaryDynamicBase } from 'react-intlayer/server';\nimport { safeUseLocale } from './useIntlayer';\n\n/**\n * On the server side, hook that lazily loads a dictionary (plain or qualified)\n * and returns the content for the given locale or selector.\n *\n * If the locale is not provided, it will use the locale from the server context.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const A extends LocalesValues | DictionarySelector = DeclaredLocales,\n>(\n  dictionaryPromise:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: string,\n  localeOrSelector?: A\n): ReturnType<typeof useDictionaryDynamicBase<T, A>> => {\n  const storedLocale = safeUseLocale();\n\n  return useDictionaryDynamicBase<T, A>(\n    dictionaryPromise,\n    key,\n    localeOrSelector,\n    storedLocale\n  );\n};\n"],"mappings":";;;;;;;;;;AAmBA,MAAa,wBAIX,mBAGA,KACA,qBACsD;CACtD,MAAM,eAAe,cAAc;CAEnC,OAAOA,uBACL,mBACA,KACA,kBACA,YACF;AACF"}

package/dist/esm/server/useIntlayer.mjs

@@ -20,7 +20,8 @@ const safeUseLocale = () => {
 * If the locale is not provided, it will use the locale from the server context.
 */
 const useIntlayer = (key, localeOrSelector) => {
-	return useIntlayer$1(key, localeOrSelector, safeUseLocale());
+	const storedLocale = safeUseLocale();
+	return useIntlayer$1(key, localeOrSelector, storedLocale);
 };
 
 //#endregion

package/dist/esm/server/useIntlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useIntlayer.mjs","names":["useIntlayerBase"],"sources":["../../../src/server/useIntlayer.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport React from 'react';\nimport { useIntlayer as useIntlayerBase } from 'react-intlayer/server';\nimport { getLocale } from './getLocale';\n\nconst getCachedLocale =\n  typeof React.cache === 'function' ? React.cache(getLocale) : getLocale;\n\nexport const safeUseLocale = (): Locale | undefined => {\n  // getLocale returns a Promise based on your TS error\n  const localeData = getCachedLocale() as Promise<Locale> | Locale;\n\n  if (localeData instanceof Promise) {\n    if (typeof React.use === 'function') {\n      return React.use(localeData); // Safely unwraps in React 19+\n    }\n\n    // React < 19 cannot synchronously unwrap Promises in hooks.\n    // Return undefined to trigger the localeTarget fallback.\n    return undefined;\n  }\n\n  return localeData;\n};\n\n/**\n * On the server side, hook that picks one dictionary by its key and returns the\n * content for the given locale or selector (`{ item }`, `{ variant }`,\n * optionally combined with `locale`).\n *\n * If the locale is not provided, it will use the locale from the server context.\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n): ReturnType<typeof useIntlayerBase<T, A>> => {\n  const storedLocale = safeUseLocale();\n\n  return useIntlayerBase<T, A>(key, localeOrSelector, storedLocale);\n};\n"],"mappings":";;;;;AAWA,MAAM,kBACJ,OAAO,MAAM,UAAU,aAAa,MAAM,MAAM,SAAS,IAAI;AAE/D,MAAa,sBAA0C;CAErD,MAAM,aAAa,gBAAgB;CAEnC,IAAI,sBAAsB,SAAS;EACjC,IAAI,OAAO,MAAM,QAAQ,YACvB,OAAO,MAAM,IAAI,UAAU;EAK7B;CACF;CAEA,OAAO;AACT;;;;;;;;AASA,MAAa,eAIX,KACA,qBAC6C;CAG7C,OAAOA,cAAsB,KAAK,kBAFb,cAE0C,CAAC;AAClE"}
+{"version":3,"file":"useIntlayer.mjs","names":["useIntlayerBase"],"sources":["../../../src/server/useIntlayer.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport React from 'react';\nimport { useIntlayer as useIntlayerBase } from 'react-intlayer/server';\nimport { getLocale } from './getLocale';\n\nconst getCachedLocale =\n  typeof React.cache === 'function' ? React.cache(getLocale) : getLocale;\n\nexport const safeUseLocale = (): Locale | undefined => {\n  // getLocale returns a Promise based on your TS error\n  const localeData = getCachedLocale() as Promise<Locale> | Locale;\n\n  if (localeData instanceof Promise) {\n    if (typeof React.use === 'function') {\n      return React.use(localeData); // Safely unwraps in React 19+\n    }\n\n    // React < 19 cannot synchronously unwrap Promises in hooks.\n    // Return undefined to trigger the localeTarget fallback.\n    return undefined;\n  }\n\n  return localeData;\n};\n\n/**\n * On the server side, hook that picks one dictionary by its key and returns the\n * content for the given locale or selector (`{ item }`, `{ variant }`,\n * optionally combined with `locale`).\n *\n * If the locale is not provided, it will use the locale from the server context.\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n): ReturnType<typeof useIntlayerBase<T, A>> => {\n  const storedLocale = safeUseLocale();\n\n  return useIntlayerBase<T, A>(key, localeOrSelector, storedLocale);\n};\n"],"mappings":";;;;;AAWA,MAAM,kBACJ,OAAO,MAAM,UAAU,aAAa,MAAM,MAAM,SAAS,IAAI;AAE/D,MAAa,sBAA0C;CAErD,MAAM,aAAa,gBAAgB;CAEnC,IAAI,sBAAsB,SAAS;EACjC,IAAI,OAAO,MAAM,QAAQ,YACvB,OAAO,MAAM,IAAI,UAAU;EAK7B;CACF;CAEA,OAAO;AACT;;;;;;;;AASA,MAAa,eAIX,KACA,qBAC6C;CAC7C,MAAM,eAAe,cAAc;CAEnC,OAAOA,cAAsB,KAAK,kBAAkB,YAAY;AAClE"}

package/dist/esm/server/withIntlayer.mjs

@@ -1,10 +1,13 @@
+import { getIsPurgePipelineAvailable, prepareSwcOptimization, resolveSwcLogLevel } from "./prepareSwcOptimization.mjs";
+import { MINIMUM_SWC_PLUGIN_NEXT_VERSION, getIsSwcPluginSupported } from "./swcPluginCompatibility.mjs";
 import { IMPORT_MODE } from "@intlayer/config/defaultValues";
-import { colorize, getAppLogger } from "@intlayer/config/logger";
 import { join, relative, resolve } from "node:path";
 import * as ANSIColors from "@intlayer/config/colors";
-import { formatDictionarySelectorEnvVar, formatNodeTypeToEnvVar, getConfigEnvVars } from "@intlayer/config/envVars";
+import { formatDictionarySelectorEnvVar, formatNodeTypeToEnvVar, formatOptimizedNestingEnvVar, getConfigEnvVars } from "@intlayer/config/envVars";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
 import { compareVersions, getAlias, getHasDictionarySelector, getProjectRequire, getUnusedNodeTypes, normalizePath } from "@intlayer/config/utils";
+import { getNestedDictionaryGraph } from "@intlayer/core/dictionaryManipulator";
 import { getDictionaries } from "@intlayer/dictionaries-entry";
 import { prepareIntlayer } from "@intlayer/engine/build";
 import { logConfigDetails } from "@intlayer/engine/cli";
@@ -25,10 +28,16 @@ const getNextVersionFlags = (intlayerConfig) => {
 		nextVersion = (intlayerConfig.build?.require ?? getProjectRequire())("next/package.json").version;
 	} catch {}
 	return {
+		nextVersion,
 		isGteNext13: compareVersions(nextVersion, "≥", "13.0.0"),
 		isGteNext15: compareVersions(nextVersion, "≥", "15.0.0"),
 		isGteNext16: compareVersions(nextVersion, "≥", "16.0.0"),
-		isTurbopackStable: compareVersions(nextVersion, "≥", "15.3.0")
+		isTurbopackStable: compareVersions(nextVersion, "≥", "15.3.0"),
+		/**
+		* Whether this Next.js release can load the `@intlayer/swc` Wasm plugin.
+		* See {@link MINIMUM_SWC_PLUGIN_NEXT_VERSION}.
+		*/
+		isSwcPluginSupported: getIsSwcPluginSupported(nextVersion)
 	};
 };
 const getIsSwcPluginAvailable = (intlayerConfig) => {
@@ -52,8 +61,9 @@ const resolvePluginPath = (pluginPath, intlayerConfig, isTurbopackEnabled) => {
 	if (isTurbopackEnabled) return normalizePath(`./${relative(process.cwd(), pluginPathResolved)}`);
 	return pluginPathResolved;
 };
-const getPruneConfig = (intlayerConfig, isBuildCommand, isTurbopackEnabled, isDevCommand, isGteNext13, swcExtraCallers) => {
-	const { optimize } = intlayerConfig.build;
+const getPruneConfig = ({ intlayerConfig, isBuildCommand, isTurbopackEnabled, isDevCommand, isGteNext13, isSwcPluginSupported, nextVersion, swcExtraCallers, fieldRenameMap }) => {
+	const { optimize, minify, purge } = intlayerConfig.build;
+	const editorEnabled = intlayerConfig.editor.enabled;
 	const importMode = intlayerConfig.build.importMode ?? intlayerConfig.dictionary?.importMode;
 	const { dictionariesDir, unmergedDictionariesDir, dynamicDictionariesDir, fetchDictionariesDir, mainDir } = intlayerConfig.system;
 	const { baseDir } = intlayerConfig.system;
@@ -63,28 +73,39 @@ const getPruneConfig = (intlayerConfig, isBuildCommand, isTurbopackEnabled, isDe
 	if (!isGteNext13) return {};
 	const isSwcPluginAvailable = getIsSwcPluginAvailable(intlayerConfig);
 	runOnce(join(baseDir, ".intlayer", "cache", "intlayer-prune-plugin-enabled.lock"), () => {
-		if (isSwcPluginAvailable) logger([
-			`Build optimization ${colorize("enabled", ANSIColors.GREEN)}`,
-			colorize(`(import mode:`, ANSIColors.GREY_DARK),
-			colorize(importMode ?? IMPORT_MODE, ANSIColors.BLUE),
-			colorize(`)`, ANSIColors.GREY_DARK)
-		]);
-		else logger([
+		if (isSwcPluginAvailable && !isSwcPluginSupported) logger([
+			`Build optimization ${colorize("disabled", ANSIColors.GREY_DARK)}:`,
+			colorize("@intlayer/swc", ANSIColors.GREY_LIGHT),
+			colorize(`cannot run on Next.js ${nextVersion} — its bundled SWC predates the`, ANSIColors.GREY),
+			colorize("stable Wasm plugin ABI. Upgrade to Next.js", ANSIColors.GREY),
+			colorize(MINIMUM_SWC_PLUGIN_NEXT_VERSION, ANSIColors.BLUE),
+			colorize("or later to enable it.", ANSIColors.GREY)
+		], { level: "warn" });
+		else if (isSwcPluginAvailable) {
+			logger([
+				`Build optimization ${colorize("enabled", ANSIColors.GREEN)}`,
+				colorize(`(import mode:`, ANSIColors.GREY_DARK),
+				colorize(importMode ?? IMPORT_MODE, ANSIColors.BLUE),
+				colorize(`)`, ANSIColors.GREY_DARK)
+			]);
+			const isPurgePipelineEnabled = !editorEnabled && !swcExtraCallers?.length && getIsPurgePipelineAvailable(intlayerConfig);
+			if (isPurgePipelineEnabled && minify) logger(`Dictionary minification ${colorize("enabled", ANSIColors.GREEN)}`);
+			if (isPurgePipelineEnabled && purge) logger(`Dictionary purge unused keys ${colorize("enabled", ANSIColors.GREEN)}`);
+		} else logger([
 			colorize("Recommended: Install", ANSIColors.GREY),
 			colorize("@intlayer/swc", ANSIColors.GREY_LIGHT),
 			colorize("package to enable build optimization. See documentation:", ANSIColors.GREY),
 			colorize("https://intlayer.org/docs/bundle-optimization", ANSIColors.GREY_LIGHT)
 		]);
-	}, { cacheTimeoutMs: 1e3 * 30 });
+	}, { cacheTimeoutMs: 3e4 });
 	runOnce(join(baseDir, ".intlayer", "cache", "intlayer-compiler-plugin-enabled.lock"), () => {
 		if (getIsBabelExtractPluginAvailable(intlayerConfig)) {
 			let isEnabled = intlayerConfig.compiler?.enabled ?? true;
 			if (isEnabled === "build-only") isEnabled = !isDevCommand;
 			if (isEnabled) logger("Intlayer compiler enabled");
-			else logger("Intlayer compiler disabled");
 		}
-	}, { cacheTimeoutMs: 1e3 * 30 });
-	if (!isSwcPluginAvailable) return {};
+	}, { cacheTimeoutMs: 3e4 });
+	if (!isSwcPluginAvailable || !isSwcPluginSupported) return {};
 	const dictionariesEntryPath = join(mainDir, "dictionaries.mjs");
 	const dynamicDictionariesEntryPath = join(mainDir, "dynamic_dictionaries.mjs");
 	const unmergedDictionariesEntryPath = join(mainDir, "unmerged_dictionaries.mjs");
@@ -99,6 +120,7 @@ const getPruneConfig = (intlayerConfig, isBuildCommand, isTurbopackEnabled, isDe
 	Object.values(dictionaries).forEach((dictionary) => {
 		dictionaryModeMap[dictionary.key] = dictionary.importMode ?? importMode ?? IMPORT_MODE;
 	});
+	const nestingDictionaryKeys = [...getNestedDictionaryGraph(Object.values(dictionaries)).keys()];
 	return { experimental: { swcPlugins: [[resolvePluginPath("@intlayer/swc", intlayerConfig, isTurbopackEnabled), {
 		dictionariesDir,
 		dictionariesEntryPath,
@@ -111,8 +133,11 @@ const getPruneConfig = (intlayerConfig, isBuildCommand, isTurbopackEnabled, isDe
 		importMode,
 		filesList,
 		replaceDictionaryEntry: true,
+		nestingDictionaryKeys,
 		dictionaryModeMap,
-		extraCallers: swcExtraCallers ?? []
+		extraCallers: swcExtraCallers ?? [],
+		fieldRenameMap: fieldRenameMap ?? {},
+		logLevel: resolveSwcLogLevel(intlayerConfig)
 	}]] } };
 };
 const getCommandsEvent = () => {
@@ -170,7 +195,7 @@ const withIntlayerSync = (nextConfig = {}, configOptions) => {
 	const intlayerConfig = getConfiguration(resolvedConfigOptions);
 	logConfigDetails(resolvedConfigOptions);
 	const appLogger = getAppLogger(intlayerConfig);
-	const { isGteNext13, isGteNext15, isGteNext16, isTurbopackStable } = getNextVersionFlags(intlayerConfig);
+	const { nextVersion, isGteNext13, isGteNext15, isGteNext16, isTurbopackStable, isSwcPluginSupported } = getNextVersionFlags(intlayerConfig);
 	const isTurbopackEnabledFromCommand = isGteNext16 ? !process.env["npm_lifecycle_script"]?.includes("--webpack") : process.env["npm_lifecycle_script"]?.includes("--turbo");
 	const isTurbopackEnabled = configOptions?.enableTurbopack ?? isTurbopackEnabledFromCommand;
 	if (isTurbopackEnabled && typeof nextConfig.webpack !== "undefined") appLogger("Turbopack is enabled but a custom webpack config is present. It will be ignored.");
@@ -208,6 +233,7 @@ const withIntlayerSync = (nextConfig = {}, configOptions) => {
 		env = {
 			...env,
 			...formatNodeTypeToEnvVar(unusedNodeTypes),
+			...formatOptimizedNestingEnvVar(intlayerConfig.build.optimize !== false),
 			...formatDictionarySelectorEnvVar(getHasDictionarySelector(dictionaries)),
 			...getConfigEnvVars(intlayerConfig)
 		};
@@ -225,18 +251,19 @@ const withIntlayerSync = (nextConfig = {}, configOptions) => {
 				serverComponentsExternalPackages: serverExternalPackages
 			}
 		};
-		if (isTurbopackEnabled) if (isGteNext15 && isTurbopackStable) config = {
-			...config,
-			turbopack: turboConfig
-		};
-		else config = {
-			...config,
-			experimental: {
-				...config?.experimental ?? {},
-				turbo: turboConfig
-			}
-		};
-		else config = {
+		if (isTurbopackEnabled) {
+			if (isGteNext15 && isTurbopackStable) config = {
+				...config,
+				turbopack: turboConfig
+			};
+			else config = {
+				...config,
+				experimental: {
+					...config?.experimental ?? {},
+					turbo: turboConfig
+				}
+			};
+		} else config = {
 			...config,
 			webpack: (config, options) => {
 				const { isServer, nextRuntime } = options;
@@ -272,8 +299,19 @@ const withIntlayerSync = (nextConfig = {}, configOptions) => {
 		};
 		return config;
 	};
-	const pruneConfig = getPruneConfig(intlayerConfig, isBuildCommand, isTurbopackEnabled ?? false, isDevCommand, isGteNext13, configOptions?.swcExtraCallers);
-	return defu(defu(getNewConfig(), pruneConfig), nextConfig);
+	const pruneConfig = getPruneConfig({
+		intlayerConfig,
+		isBuildCommand,
+		isTurbopackEnabled: isTurbopackEnabled ?? false,
+		isDevCommand,
+		isGteNext13,
+		isSwcPluginSupported,
+		nextVersion,
+		swcExtraCallers: configOptions?.swcExtraCallers,
+		fieldRenameMap: configOptions?.fieldRenameMap
+	});
+	const intlayerNextConfig = defu(getNewConfig(), pruneConfig);
+	return defu(intlayerNextConfig, nextConfig);
 };
 /**
 * A Next.js plugin that adds the intlayer configuration to the webpack configuration
@@ -298,13 +336,22 @@ const withIntlayer = async (nextConfig = {}, configOptions) => {
 	const { mode } = intlayerConfig.build;
 	if (!isStartCommand && (isDevCommand || isBuildCommand || mode === "auto")) await prepareIntlayer(intlayerConfig, {
 		clean: isBuildCommand,
-		cacheTimeoutMs: isBuildCommand ? 1e3 * 30 : 1e3 * 60 * 60,
+		cacheTimeoutMs: isBuildCommand ? 3e4 : 36e5,
 		env: isBuildCommand ? "prod" : "dev"
 	});
+	const { isSwcPluginSupported } = getNextVersionFlags(intlayerConfig);
+	const fieldRenameMap = isBuildCommand ? await prepareSwcOptimization(intlayerConfig, {
+		configOptions: resolvedConfigOptions,
+		swcExtraCallers: configOptions?.swcExtraCallers,
+		isSwcPluginUsable: isSwcPluginSupported && getIsSwcPluginAvailable(intlayerConfig)
+	}) : {};
 	const nextConfigResolved = await nextConfig;
-	return withIntlayerSync(nextConfigResolved, resolvedConfigOptions);
+	return withIntlayerSync(nextConfigResolved, {
+		...resolvedConfigOptions,
+		fieldRenameMap
+	});
 };
 
 //#endregion
-export { withIntlayer, withIntlayerSync };
+export { MINIMUM_SWC_PLUGIN_NEXT_VERSION, getIsSwcPluginSupported, withIntlayer, withIntlayerSync };
 //# sourceMappingURL=withIntlayer.mjs.map