@verbaly/next 0.20.0 → 0.21.0

package/dist/index.cjs

@@ -13,6 +13,12 @@ function writeIfChanged(file, content) {
 	(0, node_fs.writeFileSync)(file, content);
 	return true;
 }
+function syncAndWrite(compiler, cfg, catalogs, registry, requestOptions) {
+	const { added } = compiler.syncCatalogs(cfg, catalogs, registry);
+	for (const locale of Object.keys(added)) compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});
+	compiler.writeDts(cfg, catalogs[cfg.sourceLocale] ?? {});
+	writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
+}
 function writeGeneratedModules(compiler, cfg, catalogs, requestOptions = {}) {
 	const dir = generatedDir(cfg.root);
 	const localeDir = (0, node_path.join)(dir, "locale");
@@ -48,12 +54,7 @@ function startWatcher(compiler, cfg, requestOptions) {
 		}
 		running = true;
 		try {
-			const catalogs = compiler.loadCatalogs(cfg);
-			const registry = await compiler.extractProject(cfg);
-			const { added } = compiler.syncCatalogs(cfg, catalogs, registry);
-			for (const locale of Object.keys(added)) compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});
-			compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));
-			writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
+			syncAndWrite(compiler, cfg, compiler.loadCatalogs(cfg), await compiler.extractProject(cfg), requestOptions);
 		} catch (error) {
 			console.warn("[verbaly] live extraction failed:", error);
 		} finally {
@@ -104,14 +105,12 @@ function withVerbaly(nextConfig, options = {}) {
 		const catalogs = compiler.loadCatalogs(cfg);
 		const registry = await compiler.extractProject(cfg);
 		if (phase === BUILD_PHASE) {
-			if (failOnMissing !== false) compiler.runBuildGate(cfg, registry);
+			compiler.runBuildGate(cfg, registry, failOnMissing);
+			writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
 		} else {
-			const { added } = compiler.syncCatalogs(cfg, catalogs, registry);
-			for (const locale of Object.keys(added)) compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});
-			compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));
+			syncAndWrite(compiler, cfg, catalogs, registry, requestOptions);
 			startWatcher(compiler, cfg, requestOptions);
 		}
-		writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
 		return composeConfig(base, cfg.root);
 	};
 }
@@ -147,7 +146,7 @@ function composeConfig(base, root) {
 			config.module ??= {};
 			config.module.rules ??= [];
 			config.module.rules.push({
-				test: /\.[cm]?[jt]sx?$/,
+				test: SOURCE_PATH_RE,
 				exclude: /node_modules/,
 				enforce: "pre",
 				use: [{ loader: LOADER }]

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/codegen.ts","../src/watch.ts","../src/index.ts"],"sourcesContent":["import type { Catalogs, ResolvedConfig } from '@verbaly/compiler';\nimport { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport type Compiler = typeof import('@verbaly/compiler');\n\nexport interface RequestOptions {\n  cookie?: string | false;\n  fallback?: string;\n}\n\nexport const GENERATED_DIR = '.verbaly';\n\nexport function generatedDir(root: string): string {\n  return join(root, GENERATED_DIR);\n}\n\n// content compare: identical rewrites must not retrigger the bundler\nfunction writeIfChanged(file: string, content: string): boolean {\n  try {\n    if (readFileSync(file, 'utf8') === content) return false;\n  } catch {\n    // new file\n  }\n  writeFileSync(file, content);\n  return true;\n}\n\n// real-file replacement for virtual:verbaly: Turbopack has no virtual modules\nexport function writeGeneratedModules(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  catalogs: Catalogs,\n  requestOptions: RequestOptions = {},\n): boolean {\n  const dir = generatedDir(cfg.root);\n  const localeDir = join(dir, 'locale');\n  mkdirSync(localeDir, { recursive: true });\n\n  let changed = writeIfChanged(join(dir, '.gitignore'), '*\\n');\n\n  const runtime = compiler.generateRuntimeModule(cfg, {\n    localeImport: (locale) => `./locale/${locale}.js`,\n    extraExports: `export const requestOptions = ${JSON.stringify(requestOptions)};\\n`,\n  });\n  changed = writeIfChanged(join(dir, 'index.js'), runtime) || changed;\n\n  const expected = new Set(cfg.locales.map((locale) => `${locale}.js`));\n  for (const locale of cfg.locales) {\n    changed =\n      writeIfChanged(\n        join(localeDir, `${locale}.js`),\n        compiler.generateLocaleModule(catalogs[locale] ?? {}),\n      ) || changed;\n  }\n  for (const file of readdirSync(localeDir)) {\n    if (!expected.has(file)) {\n      rmSync(join(localeDir, file));\n      changed = true;\n    }\n  }\n  return changed;\n}\n","import type { ResolvedConfig } from '@verbaly/compiler';\nimport { watch } from 'node:fs';\nimport { relative } from 'node:path';\nimport { GENERATED_DIR, writeGeneratedModules, type Compiler, type RequestOptions } from './codegen';\n\n// one watcher per project root: next.config can be evaluated more than once\nconst active = new Map<string, () => void>();\n\nexport function startWatcher(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  requestOptions: RequestOptions,\n): () => void {\n  const existing = active.get(cfg.root);\n  if (existing) return existing;\n\n  const catalogDir = relative(cfg.root, cfg.dir).replaceAll('\\\\', '/');\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let running = false;\n  let queued = false;\n\n  async function refresh(): Promise<void> {\n    if (running) {\n      queued = true;\n      return;\n    }\n    running = true;\n    try {\n      const catalogs = compiler.loadCatalogs(cfg);\n      const registry = await compiler.extractProject(cfg);\n      const { added } = compiler.syncCatalogs(cfg, catalogs, registry);\n      for (const locale of Object.keys(added)) {\n        compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});\n      }\n      compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));\n      writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n    } catch (error) {\n      console.warn('[verbaly] live extraction failed:', error);\n    } finally {\n      running = false;\n      if (queued) {\n        queued = false;\n        schedule();\n      }\n    }\n  }\n\n  function schedule(): void {\n    clearTimeout(timer);\n    timer = setTimeout(() => void refresh(), 150);\n  }\n\n  const watcher = watch(cfg.root, { recursive: true }, (_event, filename) => {\n    if (!filename) return;\n    const file = filename.replaceAll('\\\\', '/');\n    if (\n      file.startsWith(`${GENERATED_DIR}/`) ||\n      file.startsWith('.next/') ||\n      file.includes('node_modules/') ||\n      file.endsWith('.d.ts')\n    ) {\n      return;\n    }\n    const isCatalog = file.startsWith(`${catalogDir}/`) && file.endsWith('.json');\n    if (isCatalog || compiler.SOURCE_FILE_RE.test(file)) schedule();\n  });\n  watcher.unref?.();\n\n  const dispose = (): void => {\n    clearTimeout(timer);\n    watcher.close();\n    active.delete(cfg.root);\n  };\n  active.set(cfg.root, dispose);\n  return dispose;\n}\n\n// test hook\nexport function stopWatcher(root: string): void {\n  active.get(root)?.();\n}\n","import type { VerbalyConfig } from '@verbaly/compiler';\nimport { join } from 'node:path';\nimport {\n  GENERATED_DIR,\n  generatedDir,\n  writeGeneratedModules,\n  type Compiler,\n  type RequestOptions,\n} from './codegen';\nimport { startWatcher } from './watch';\n\nexport type { VerbalyConfig } from '@verbaly/compiler';\nexport type { RequestOptions } from './codegen';\n\nexport interface NextVerbalyOptions extends VerbalyConfig {\n  failOnMissing?: boolean;\n  cookie?: string | false;\n  fallback?: string;\n}\n\n// structural NextConfig subset: compat asserted against next's real type in tests.\n// No index signatures: Next's real interfaces have none and a target index\n// signature would reject them.\nexport interface WebpackConfigLike {\n  resolve?: { alias?: Record<string, unknown>; [key: string]: unknown };\n  module?: { rules?: unknown[]; [key: string]: unknown };\n  plugins?: unknown[];\n  [key: string]: unknown;\n}\n\ninterface WebpackContextLike {\n  webpack?: {\n    NormalModuleReplacementPlugin: new (test: RegExp, resource: string) => unknown;\n  };\n}\n\n// context param is `never` so Next's real webpack fn (specific context type) stays assignable\nexport type WebpackFn = (config: WebpackConfigLike, context: never) => unknown;\n\nexport interface TurbopackLike {\n  resolveAlias?: Record<string, unknown>;\n  rules?: Record<string, unknown>;\n}\n\nexport interface NextConfigLike {\n  webpack?: WebpackFn | null;\n  turbopack?: TurbopackLike;\n}\n\n// constraint is `object` (not NextConfigLike): an all-optional target would\n// reject configs sharing no keys with it (TS weak-type rule)\nexport type NextConfigInput<C extends object> =\n  | C\n  | ((phase: string, context: { defaultConfig?: unknown }) => C | Promise<C>);\n\n// next/constants values: literal to keep this module import-free of next\nconst DEV_PHASE = 'phase-development-server';\nconst BUILD_PHASE = 'phase-production-build';\n\nconst LOADER = '@verbaly/next/loader';\n// compiler's SOURCE_FILE_RE (inlined: the compiler is only dynamically imported here).\n// Matching happens via `condition.path`: a bare extension glob also matches Next's\n// internal App Router entry and Turbopack panics reading it as a file.\nconst SOURCE_PATH_RE = /\\.[cm]?[jt]sx?$/;\n\nexport function withVerbaly<C extends object>(\n  nextConfig?: NextConfigInput<C>,\n  options: NextVerbalyOptions = {},\n): (phase: string, context?: { defaultConfig?: unknown }) => Promise<C> {\n  const { failOnMissing, cookie, fallback, ...verbalyConfig } = options;\n  const requestOptions: RequestOptions = { cookie, fallback };\n\n  return async (phase, context = {}) => {\n    const base: C =\n      typeof nextConfig === 'function' ? await nextConfig(phase, context) : (nextConfig ?? ({} as C));\n    const root = verbalyConfig.root ?? process.cwd();\n\n    // production server / export: everything is bundled, so no FS work, config only\n    if (phase !== DEV_PHASE && phase !== BUILD_PHASE) {\n      return composeConfig(base, root);\n    }\n\n    // dynamic: the compiler is ESM-only and this entry is also consumed as CJS\n    const compiler: Compiler = await import('@verbaly/compiler');\n\n    const cfg = await compiler.loadConfig(root, verbalyConfig);\n    const catalogs = compiler.loadCatalogs(cfg);\n    const registry = await compiler.extractProject(cfg);\n\n    if (phase === BUILD_PHASE) {\n      if (failOnMissing !== false) compiler.runBuildGate(cfg, registry);\n    } else {\n      const { added } = compiler.syncCatalogs(cfg, catalogs, registry);\n      for (const locale of Object.keys(added)) {\n        compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});\n      }\n      compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));\n      startWatcher(compiler, cfg, requestOptions);\n    }\n\n    writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n    return composeConfig(base, cfg.root);\n  };\n}\n\nfunction composeConfig<C extends object>(base: C, root: string): C {\n  const runtimeModule = join(generatedDir(root), 'index.js');\n  const { webpack: userWebpack, turbopack } = base as NextConfigLike;\n\n  const rules: Record<string, unknown> = { ...turbopack?.rules };\n  const verbalyRule = {\n    condition: { all: [{ not: 'foreign' }, { path: SOURCE_PATH_RE }] },\n    loaders: [LOADER],\n  };\n  const existing = rules['*'];\n  rules['*'] = existing\n    ? [...(Array.isArray(existing) ? existing : [existing]), verbalyRule]\n    : verbalyRule;\n\n  return {\n    ...base,\n    turbopack: {\n      ...turbopack,\n      resolveAlias: {\n        ...turbopack?.resolveAlias,\n        'virtual:verbaly': `./${GENERATED_DIR}/index.js`,\n      },\n      rules,\n    },\n    webpack(config: WebpackConfigLike, context: unknown) {\n      // webpack 5 treats 'virtual:' as a URI scheme: resolve.alias never fires,\n      // module replacement does; the alias stays as a fallback for odd setups\n      const { webpack: webpackInstance } = (context ?? {}) as WebpackContextLike;\n      if (webpackInstance?.NormalModuleReplacementPlugin) {\n        config.plugins ??= [];\n        config.plugins.push(\n          new webpackInstance.NormalModuleReplacementPlugin(/^virtual:verbaly$/, runtimeModule),\n        );\n      }\n      config.resolve ??= {};\n      config.resolve.alias ??= {};\n      (config.resolve.alias as Record<string, unknown>)['virtual:verbaly'] = runtimeModule;\n      config.module ??= {};\n      config.module.rules ??= [];\n      config.module.rules.push({\n        test: /\\.[cm]?[jt]sx?$/,\n        exclude: /node_modules/,\n        enforce: 'pre',\n        use: [{ loader: LOADER }],\n      });\n      return userWebpack ? userWebpack(config, context as never) : config;\n    },\n  } as C;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/codegen.ts","../src/watch.ts","../src/index.ts"],"sourcesContent":["import type { Catalogs, ResolvedConfig } from '@verbaly/compiler';\nimport { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport type Compiler = typeof import('@verbaly/compiler');\n\nexport interface RequestOptions {\n  cookie?: string | false;\n  fallback?: string;\n}\n\nexport const GENERATED_DIR = '.verbaly';\n\nexport function generatedDir(root: string): string {\n  return join(root, GENERATED_DIR);\n}\n\n// content compare: identical rewrites must not retrigger the bundler\nfunction writeIfChanged(file: string, content: string): boolean {\n  try {\n    if (readFileSync(file, 'utf8') === content) return false;\n  } catch {\n    // new file\n  }\n  writeFileSync(file, content);\n  return true;\n}\n\n// dev-phase pipeline shared by withVerbaly and the watcher: sync catalogs to\n// the sources, refresh verbaly.d.ts, regenerate the runtime modules\nexport function syncAndWrite(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  catalogs: Catalogs,\n  registry: Awaited<ReturnType<Compiler['extractProject']>>,\n  requestOptions: RequestOptions,\n): void {\n  const { added } = compiler.syncCatalogs(cfg, catalogs, registry);\n  for (const locale of Object.keys(added)) {\n    compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});\n  }\n  compiler.writeDts(cfg, catalogs[cfg.sourceLocale] ?? {});\n  writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n}\n\n// real-file replacement for virtual:verbaly: Turbopack has no virtual modules\nexport function writeGeneratedModules(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  catalogs: Catalogs,\n  requestOptions: RequestOptions = {},\n): boolean {\n  const dir = generatedDir(cfg.root);\n  const localeDir = join(dir, 'locale');\n  mkdirSync(localeDir, { recursive: true });\n\n  let changed = writeIfChanged(join(dir, '.gitignore'), '*\\n');\n\n  const runtime = compiler.generateRuntimeModule(cfg, {\n    localeImport: (locale) => `./locale/${locale}.js`,\n    extraExports: `export const requestOptions = ${JSON.stringify(requestOptions)};\\n`,\n  });\n  changed = writeIfChanged(join(dir, 'index.js'), runtime) || changed;\n\n  const expected = new Set(cfg.locales.map((locale) => `${locale}.js`));\n  for (const locale of cfg.locales) {\n    changed =\n      writeIfChanged(\n        join(localeDir, `${locale}.js`),\n        compiler.generateLocaleModule(catalogs[locale] ?? {}),\n      ) || changed;\n  }\n  for (const file of readdirSync(localeDir)) {\n    if (!expected.has(file)) {\n      rmSync(join(localeDir, file));\n      changed = true;\n    }\n  }\n  return changed;\n}\n","import type { ResolvedConfig } from '@verbaly/compiler';\nimport { watch } from 'node:fs';\nimport { relative } from 'node:path';\nimport { GENERATED_DIR, syncAndWrite, type Compiler, type RequestOptions } from './codegen';\n\n// one watcher per project root: next.config can be evaluated more than once\nconst active = new Map<string, () => void>();\n\nexport function startWatcher(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  requestOptions: RequestOptions,\n): () => void {\n  const existing = active.get(cfg.root);\n  if (existing) return existing;\n\n  const catalogDir = relative(cfg.root, cfg.dir).replaceAll('\\\\', '/');\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let running = false;\n  let queued = false;\n\n  async function refresh(): Promise<void> {\n    if (running) {\n      queued = true;\n      return;\n    }\n    running = true;\n    try {\n      const catalogs = compiler.loadCatalogs(cfg);\n      const registry = await compiler.extractProject(cfg);\n      syncAndWrite(compiler, cfg, catalogs, registry, requestOptions);\n    } catch (error) {\n      console.warn('[verbaly] live extraction failed:', error);\n    } finally {\n      running = false;\n      if (queued) {\n        queued = false;\n        schedule();\n      }\n    }\n  }\n\n  function schedule(): void {\n    clearTimeout(timer);\n    timer = setTimeout(() => void refresh(), 150);\n  }\n\n  const watcher = watch(cfg.root, { recursive: true }, (_event, filename) => {\n    if (!filename) return;\n    const file = filename.replaceAll('\\\\', '/');\n    if (\n      file.startsWith(`${GENERATED_DIR}/`) ||\n      file.startsWith('.next/') ||\n      file.includes('node_modules/') ||\n      file.endsWith('.d.ts')\n    ) {\n      return;\n    }\n    const isCatalog = file.startsWith(`${catalogDir}/`) && file.endsWith('.json');\n    if (isCatalog || compiler.SOURCE_FILE_RE.test(file)) schedule();\n  });\n  watcher.unref?.();\n\n  const dispose = (): void => {\n    clearTimeout(timer);\n    watcher.close();\n    active.delete(cfg.root);\n  };\n  active.set(cfg.root, dispose);\n  return dispose;\n}\n\n// test hook\nexport function stopWatcher(root: string): void {\n  active.get(root)?.();\n}\n","import type { PluginOptions } from '@verbaly/compiler';\nimport { join } from 'node:path';\nimport {\n  GENERATED_DIR,\n  generatedDir,\n  syncAndWrite,\n  writeGeneratedModules,\n  type Compiler,\n  type RequestOptions,\n} from './codegen';\nimport { startWatcher } from './watch';\n\nexport type { VerbalyConfig } from '@verbaly/compiler';\nexport type { RequestOptions } from './codegen';\n\nexport interface NextVerbalyOptions extends PluginOptions {\n  cookie?: string | false;\n  fallback?: string;\n}\n\n// structural NextConfig subset: compat asserted against next's real type in tests.\n// No index signatures: Next's real interfaces have none and a target index\n// signature would reject them.\nexport interface WebpackConfigLike {\n  resolve?: { alias?: Record<string, unknown>; [key: string]: unknown };\n  module?: { rules?: unknown[]; [key: string]: unknown };\n  plugins?: unknown[];\n  [key: string]: unknown;\n}\n\ninterface WebpackContextLike {\n  webpack?: {\n    NormalModuleReplacementPlugin: new (test: RegExp, resource: string) => unknown;\n  };\n}\n\n// context param is `never` so Next's real webpack fn (specific context type) stays assignable\nexport type WebpackFn = (config: WebpackConfigLike, context: never) => unknown;\n\nexport interface TurbopackLike {\n  resolveAlias?: Record<string, unknown>;\n  rules?: Record<string, unknown>;\n}\n\nexport interface NextConfigLike {\n  webpack?: WebpackFn | null;\n  turbopack?: TurbopackLike;\n}\n\n// constraint is `object` (not NextConfigLike): an all-optional target would\n// reject configs sharing no keys with it (TS weak-type rule)\nexport type NextConfigInput<C extends object> =\n  | C\n  | ((phase: string, context: { defaultConfig?: unknown }) => C | Promise<C>);\n\n// next/constants values: literal to keep this module import-free of next\nconst DEV_PHASE = 'phase-development-server';\nconst BUILD_PHASE = 'phase-production-build';\n\nconst LOADER = '@verbaly/next/loader';\n// compiler's SOURCE_FILE_RE (inlined: the compiler is only dynamically imported here).\n// Matching happens via `condition.path`: a bare extension glob also matches Next's\n// internal App Router entry and Turbopack panics reading it as a file.\nconst SOURCE_PATH_RE = /\\.[cm]?[jt]sx?$/;\n\nexport function withVerbaly<C extends object>(\n  nextConfig?: NextConfigInput<C>,\n  options: NextVerbalyOptions = {},\n): (phase: string, context?: { defaultConfig?: unknown }) => Promise<C> {\n  const { failOnMissing, cookie, fallback, ...verbalyConfig } = options;\n  const requestOptions: RequestOptions = { cookie, fallback };\n\n  return async (phase, context = {}) => {\n    const base: C =\n      typeof nextConfig === 'function' ? await nextConfig(phase, context) : (nextConfig ?? ({} as C));\n    const root = verbalyConfig.root ?? process.cwd();\n\n    // production server / export: everything is bundled, so no FS work, config only\n    if (phase !== DEV_PHASE && phase !== BUILD_PHASE) {\n      return composeConfig(base, root);\n    }\n\n    // dynamic: the compiler is ESM-only and this entry is also consumed as CJS\n    const compiler: Compiler = await import('@verbaly/compiler');\n\n    const cfg = await compiler.loadConfig(root, verbalyConfig);\n    const catalogs = compiler.loadCatalogs(cfg);\n    const registry = await compiler.extractProject(cfg);\n\n    if (phase === BUILD_PHASE) {\n      compiler.runBuildGate(cfg, registry, failOnMissing);\n      writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n    } else {\n      syncAndWrite(compiler, cfg, catalogs, registry, requestOptions);\n      startWatcher(compiler, cfg, requestOptions);\n    }\n\n    return composeConfig(base, cfg.root);\n  };\n}\n\nfunction composeConfig<C extends object>(base: C, root: string): C {\n  const runtimeModule = join(generatedDir(root), 'index.js');\n  const { webpack: userWebpack, turbopack } = base as NextConfigLike;\n\n  const rules: Record<string, unknown> = { ...turbopack?.rules };\n  const verbalyRule = {\n    condition: { all: [{ not: 'foreign' }, { path: SOURCE_PATH_RE }] },\n    loaders: [LOADER],\n  };\n  const existing = rules['*'];\n  rules['*'] = existing\n    ? [...(Array.isArray(existing) ? existing : [existing]), verbalyRule]\n    : verbalyRule;\n\n  return {\n    ...base,\n    turbopack: {\n      ...turbopack,\n      resolveAlias: {\n        ...turbopack?.resolveAlias,\n        'virtual:verbaly': `./${GENERATED_DIR}/index.js`,\n      },\n      rules,\n    },\n    webpack(config: WebpackConfigLike, context: unknown) {\n      // webpack 5 treats 'virtual:' as a URI scheme: resolve.alias never fires,\n      // module replacement does; the alias stays as a fallback for odd setups\n      const { webpack: webpackInstance } = (context ?? {}) as WebpackContextLike;\n      if (webpackInstance?.NormalModuleReplacementPlugin) {\n        config.plugins ??= [];\n        config.plugins.push(\n          new webpackInstance.NormalModuleReplacementPlugin(/^virtual:verbaly$/, runtimeModule),\n        );\n      }\n      config.resolve ??= {};\n      config.resolve.alias ??= {};\n      (config.resolve.alias as Record<string, unknown>)['virtual:verbaly'] = runtimeModule;\n      config.module ??= {};\n      config.module.rules ??= [];\n      config.module.rules.push({\n        test: SOURCE_PATH_RE,\n        exclude: /node_modules/,\n        enforce: 'pre',\n        use: [{ loader: LOADER }],\n      });\n      return userWebpack ? userWebpack(config, context as never) : config;\n    },\n  } as C;\n}\n"],"mappings":";;;;AAWA,MAAa,gBAAgB;AAE7B,SAAgB,aAAa,MAAsB;CACjD,QAAA,GAAA,UAAA,KAAA,CAAY,MAAM,aAAa;AACjC;AAGA,SAAS,eAAe,MAAc,SAA0B;CAC9D,IAAI;EACF,KAAA,GAAA,QAAA,aAAA,CAAiB,MAAM,MAAM,MAAM,SAAS,OAAO;CACrD,QAAQ,CAER;CACA,CAAA,GAAA,QAAA,cAAA,CAAc,MAAM,OAAO;CAC3B,OAAO;AACT;AAIA,SAAgB,aACd,UACA,KACA,UACA,UACA,gBACM;CACN,MAAM,EAAE,UAAU,SAAS,aAAa,KAAK,UAAU,QAAQ;CAC/D,KAAK,MAAM,UAAU,OAAO,KAAK,KAAK,GACpC,SAAS,aAAa,KAAK,QAAQ,SAAS,WAAW,CAAC,CAAC;CAE3D,SAAS,SAAS,KAAK,SAAS,IAAI,iBAAiB,CAAC,CAAC;CACvD,sBAAsB,UAAU,KAAK,UAAU,cAAc;AAC/D;AAGA,SAAgB,sBACd,UACA,KACA,UACA,iBAAiC,CAAC,GACzB;CACT,MAAM,MAAM,aAAa,IAAI,IAAI;CACjC,MAAM,aAAA,GAAA,UAAA,KAAA,CAAiB,KAAK,QAAQ;CACpC,CAAA,GAAA,QAAA,UAAA,CAAU,WAAW,EAAE,WAAW,KAAK,CAAC;CAExC,IAAI,UAAU,gBAAA,GAAA,UAAA,KAAA,CAAoB,KAAK,YAAY,GAAG,KAAK;CAE3D,MAAM,UAAU,SAAS,sBAAsB,KAAK;EAClD,eAAe,WAAW,YAAY,OAAO;EAC7C,cAAc,iCAAiC,KAAK,UAAU,cAAc,EAAE;CAChF,CAAC;CACD,UAAU,gBAAA,GAAA,UAAA,KAAA,CAAoB,KAAK,UAAU,GAAG,OAAO,KAAK;CAE5D,MAAM,WAAW,IAAI,IAAI,IAAI,QAAQ,KAAK,WAAW,GAAG,OAAO,IAAI,CAAC;CACpE,KAAK,MAAM,UAAU,IAAI,SACvB,UACE,gBAAA,GAAA,UAAA,KAAA,CACO,WAAW,GAAG,OAAO,IAAI,GAC9B,SAAS,qBAAqB,SAAS,WAAW,CAAC,CAAC,CACtD,KAAK;CAET,KAAK,MAAM,SAAA,GAAA,QAAA,YAAA,CAAoB,SAAS,GACtC,IAAI,CAAC,SAAS,IAAI,IAAI,GAAG;EACvB,CAAA,GAAA,QAAA,OAAA,EAAA,GAAA,UAAA,KAAA,CAAY,WAAW,IAAI,CAAC;EAC5B,UAAU;CACZ;CAEF,OAAO;AACT;;;ACzEA,MAAM,yBAAS,IAAI,IAAwB;AAE3C,SAAgB,aACd,UACA,KACA,gBACY;CACZ,MAAM,WAAW,OAAO,IAAI,IAAI,IAAI;CACpC,IAAI,UAAU,OAAO;CAErB,MAAM,cAAA,GAAA,UAAA,SAAA,CAAsB,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,MAAM,GAAG;CACnE,IAAI;CACJ,IAAI,UAAU;CACd,IAAI,SAAS;CAEb,eAAe,UAAyB;EACtC,IAAI,SAAS;GACX,SAAS;GACT;EACF;EACA,UAAU;EACV,IAAI;GAGF,aAAa,UAAU,KAFN,SAAS,aAAa,GAEJ,GAAG,MADf,SAAS,eAAe,GAAG,GACF,cAAc;EAChE,SAAS,OAAO;GACd,QAAQ,KAAK,qCAAqC,KAAK;EACzD,UAAU;GACR,UAAU;GACV,IAAI,QAAQ;IACV,SAAS;IACT,SAAS;GACX;EACF;CACF;CAEA,SAAS,WAAiB;EACxB,aAAa,KAAK;EAClB,QAAQ,iBAAiB,KAAK,QAAQ,GAAG,GAAG;CAC9C;CAEA,MAAM,WAAA,GAAA,QAAA,MAAA,CAAgB,IAAI,MAAM,EAAE,WAAW,KAAK,IAAI,QAAQ,aAAa;EACzE,IAAI,CAAC,UAAU;EACf,MAAM,OAAO,SAAS,WAAW,MAAM,GAAG;EAC1C,IACE,KAAK,WAAW,WAAmB,KACnC,KAAK,WAAW,QAAQ,KACxB,KAAK,SAAS,eAAe,KAC7B,KAAK,SAAS,OAAO,GAErB;EAGF,IADkB,KAAK,WAAW,GAAG,WAAW,EAAE,KAAK,KAAK,SAAS,OAAO,KAC3D,SAAS,eAAe,KAAK,IAAI,GAAG,SAAS;CAChE,CAAC;CACD,QAAQ,QAAQ;CAEhB,MAAM,gBAAsB;EAC1B,aAAa,KAAK;EAClB,QAAQ,MAAM;EACd,OAAO,OAAO,IAAI,IAAI;CACxB;CACA,OAAO,IAAI,IAAI,MAAM,OAAO;CAC5B,OAAO;AACT;;;ACdA,MAAM,YAAY;AAClB,MAAM,cAAc;AAEpB,MAAM,SAAS;AAIf,MAAM,iBAAiB;AAEvB,SAAgB,YACd,YACA,UAA8B,CAAC,GACuC;CACtE,MAAM,EAAE,eAAe,QAAQ,UAAU,GAAG,kBAAkB;CAC9D,MAAM,iBAAiC;EAAE;EAAQ;CAAS;CAE1D,OAAO,OAAO,OAAO,UAAU,CAAC,MAAM;EACpC,MAAM,OACJ,OAAO,eAAe,aAAa,MAAM,WAAW,OAAO,OAAO,IAAK,cAAe,CAAC;EACzF,MAAM,OAAO,cAAc,QAAQ,QAAQ,IAAI;EAG/C,IAAI,UAAU,aAAa,UAAU,aACnC,OAAO,cAAc,MAAM,IAAI;EAIjC,MAAM,WAAqB,MAAM,OAAO;EAExC,MAAM,MAAM,MAAM,SAAS,WAAW,MAAM,aAAa;EACzD,MAAM,WAAW,SAAS,aAAa,GAAG;EAC1C,MAAM,WAAW,MAAM,SAAS,eAAe,GAAG;EAElD,IAAI,UAAU,aAAa;GACzB,SAAS,aAAa,KAAK,UAAU,aAAa;GAClD,sBAAsB,UAAU,KAAK,UAAU,cAAc;EAC/D,OAAO;GACL,aAAa,UAAU,KAAK,UAAU,UAAU,cAAc;GAC9D,aAAa,UAAU,KAAK,cAAc;EAC5C;EAEA,OAAO,cAAc,MAAM,IAAI,IAAI;CACrC;AACF;AAEA,SAAS,cAAgC,MAAS,MAAiB;CACjE,MAAM,iBAAA,GAAA,UAAA,KAAA,CAAqB,aAAa,IAAI,GAAG,UAAU;CACzD,MAAM,EAAE,SAAS,aAAa,cAAc;CAE5C,MAAM,QAAiC,EAAE,GAAG,WAAW,MAAM;CAC7D,MAAM,cAAc;EAClB,WAAW,EAAE,KAAK,CAAC,EAAE,KAAK,UAAU,GAAG,EAAE,MAAM,eAAe,CAAC,EAAE;EACjE,SAAS,CAAC,MAAM;CAClB;CACA,MAAM,WAAW,MAAM;CACvB,MAAM,OAAO,WACT,CAAC,GAAI,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,QAAQ,GAAI,WAAW,IAClE;CAEJ,OAAO;EACL,GAAG;EACH,WAAW;GACT,GAAG;GACH,cAAc;IACZ,GAAG,WAAW;IACd,mBAAmB,KAAK,cAAc;GACxC;GACA;EACF;EACA,QAAQ,QAA2B,SAAkB;GAGnD,MAAM,EAAE,SAAS,oBAAqB,WAAW,CAAC;GAClD,IAAI,iBAAiB,+BAA+B;IAClD,OAAO,YAAY,CAAC;IACpB,OAAO,QAAQ,KACb,IAAI,gBAAgB,8BAA8B,qBAAqB,aAAa,CACtF;GACF;GACA,OAAO,YAAY,CAAC;GACpB,OAAO,QAAQ,UAAU,CAAC;GAC1B,OAAQ,QAAQ,MAAkC,qBAAqB;GACvE,OAAO,WAAW,CAAC;GACnB,OAAO,OAAO,UAAU,CAAC;GACzB,OAAO,OAAO,MAAM,KAAK;IACvB,MAAM;IACN,SAAS;IACT,SAAS;IACT,KAAK,CAAC,EAAE,QAAQ,OAAO,CAAC;GAC1B,CAAC;GACD,OAAO,cAAc,YAAY,QAAQ,OAAgB,IAAI;EAC/D;CACF;AACF"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { VerbalyConfig, VerbalyConfig as VerbalyConfig$1 } from "@verbaly/compiler";
+import { PluginOptions, VerbalyConfig } from "@verbaly/compiler";
 //#region src/codegen.d.ts
 interface RequestOptions {
   cookie?: string | false;
@@ -6,8 +6,7 @@ interface RequestOptions {
 }
 //#endregion
 //#region src/index.d.ts
-interface NextVerbalyOptions extends VerbalyConfig$1 {
-  failOnMissing?: boolean;
+interface NextVerbalyOptions extends PluginOptions {
   cookie?: string | false;
   fallback?: string;
 }

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { VerbalyConfig, VerbalyConfig as VerbalyConfig$1 } from "@verbaly/compiler";
+import { PluginOptions, VerbalyConfig } from "@verbaly/compiler";
 //#region src/codegen.d.ts
 interface RequestOptions {
   cookie?: string | false;
@@ -6,8 +6,7 @@ interface RequestOptions {
 }
 //#endregion
 //#region src/index.d.ts
-interface NextVerbalyOptions extends VerbalyConfig$1 {
-  failOnMissing?: boolean;
+interface NextVerbalyOptions extends PluginOptions {
   cookie?: string | false;
   fallback?: string;
 }

package/dist/index.js

@@ -12,6 +12,12 @@ function writeIfChanged(file, content) {
 	writeFileSync(file, content);
 	return true;
 }
+function syncAndWrite(compiler, cfg, catalogs, registry, requestOptions) {
+	const { added } = compiler.syncCatalogs(cfg, catalogs, registry);
+	for (const locale of Object.keys(added)) compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});
+	compiler.writeDts(cfg, catalogs[cfg.sourceLocale] ?? {});
+	writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
+}
 function writeGeneratedModules(compiler, cfg, catalogs, requestOptions = {}) {
 	const dir = generatedDir(cfg.root);
 	const localeDir = join(dir, "locale");
@@ -47,12 +53,7 @@ function startWatcher(compiler, cfg, requestOptions) {
 		}
 		running = true;
 		try {
-			const catalogs = compiler.loadCatalogs(cfg);
-			const registry = await compiler.extractProject(cfg);
-			const { added } = compiler.syncCatalogs(cfg, catalogs, registry);
-			for (const locale of Object.keys(added)) compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});
-			compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));
-			writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
+			syncAndWrite(compiler, cfg, compiler.loadCatalogs(cfg), await compiler.extractProject(cfg), requestOptions);
 		} catch (error) {
 			console.warn("[verbaly] live extraction failed:", error);
 		} finally {
@@ -103,14 +104,12 @@ function withVerbaly(nextConfig, options = {}) {
 		const catalogs = compiler.loadCatalogs(cfg);
 		const registry = await compiler.extractProject(cfg);
 		if (phase === BUILD_PHASE) {
-			if (failOnMissing !== false) compiler.runBuildGate(cfg, registry);
+			compiler.runBuildGate(cfg, registry, failOnMissing);
+			writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
 		} else {
-			const { added } = compiler.syncCatalogs(cfg, catalogs, registry);
-			for (const locale of Object.keys(added)) compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});
-			compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));
+			syncAndWrite(compiler, cfg, catalogs, registry, requestOptions);
 			startWatcher(compiler, cfg, requestOptions);
 		}
-		writeGeneratedModules(compiler, cfg, catalogs, requestOptions);
 		return composeConfig(base, cfg.root);
 	};
 }
@@ -146,7 +145,7 @@ function composeConfig(base, root) {
 			config.module ??= {};
 			config.module.rules ??= [];
 			config.module.rules.push({
-				test: /\.[cm]?[jt]sx?$/,
+				test: SOURCE_PATH_RE,
 				exclude: /node_modules/,
 				enforce: "pre",
 				use: [{ loader: LOADER }]

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/codegen.ts","../src/watch.ts","../src/index.ts"],"sourcesContent":["import type { Catalogs, ResolvedConfig } from '@verbaly/compiler';\nimport { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport type Compiler = typeof import('@verbaly/compiler');\n\nexport interface RequestOptions {\n  cookie?: string | false;\n  fallback?: string;\n}\n\nexport const GENERATED_DIR = '.verbaly';\n\nexport function generatedDir(root: string): string {\n  return join(root, GENERATED_DIR);\n}\n\n// content compare: identical rewrites must not retrigger the bundler\nfunction writeIfChanged(file: string, content: string): boolean {\n  try {\n    if (readFileSync(file, 'utf8') === content) return false;\n  } catch {\n    // new file\n  }\n  writeFileSync(file, content);\n  return true;\n}\n\n// real-file replacement for virtual:verbaly: Turbopack has no virtual modules\nexport function writeGeneratedModules(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  catalogs: Catalogs,\n  requestOptions: RequestOptions = {},\n): boolean {\n  const dir = generatedDir(cfg.root);\n  const localeDir = join(dir, 'locale');\n  mkdirSync(localeDir, { recursive: true });\n\n  let changed = writeIfChanged(join(dir, '.gitignore'), '*\\n');\n\n  const runtime = compiler.generateRuntimeModule(cfg, {\n    localeImport: (locale) => `./locale/${locale}.js`,\n    extraExports: `export const requestOptions = ${JSON.stringify(requestOptions)};\\n`,\n  });\n  changed = writeIfChanged(join(dir, 'index.js'), runtime) || changed;\n\n  const expected = new Set(cfg.locales.map((locale) => `${locale}.js`));\n  for (const locale of cfg.locales) {\n    changed =\n      writeIfChanged(\n        join(localeDir, `${locale}.js`),\n        compiler.generateLocaleModule(catalogs[locale] ?? {}),\n      ) || changed;\n  }\n  for (const file of readdirSync(localeDir)) {\n    if (!expected.has(file)) {\n      rmSync(join(localeDir, file));\n      changed = true;\n    }\n  }\n  return changed;\n}\n","import type { ResolvedConfig } from '@verbaly/compiler';\nimport { watch } from 'node:fs';\nimport { relative } from 'node:path';\nimport { GENERATED_DIR, writeGeneratedModules, type Compiler, type RequestOptions } from './codegen';\n\n// one watcher per project root: next.config can be evaluated more than once\nconst active = new Map<string, () => void>();\n\nexport function startWatcher(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  requestOptions: RequestOptions,\n): () => void {\n  const existing = active.get(cfg.root);\n  if (existing) return existing;\n\n  const catalogDir = relative(cfg.root, cfg.dir).replaceAll('\\\\', '/');\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let running = false;\n  let queued = false;\n\n  async function refresh(): Promise<void> {\n    if (running) {\n      queued = true;\n      return;\n    }\n    running = true;\n    try {\n      const catalogs = compiler.loadCatalogs(cfg);\n      const registry = await compiler.extractProject(cfg);\n      const { added } = compiler.syncCatalogs(cfg, catalogs, registry);\n      for (const locale of Object.keys(added)) {\n        compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});\n      }\n      compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));\n      writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n    } catch (error) {\n      console.warn('[verbaly] live extraction failed:', error);\n    } finally {\n      running = false;\n      if (queued) {\n        queued = false;\n        schedule();\n      }\n    }\n  }\n\n  function schedule(): void {\n    clearTimeout(timer);\n    timer = setTimeout(() => void refresh(), 150);\n  }\n\n  const watcher = watch(cfg.root, { recursive: true }, (_event, filename) => {\n    if (!filename) return;\n    const file = filename.replaceAll('\\\\', '/');\n    if (\n      file.startsWith(`${GENERATED_DIR}/`) ||\n      file.startsWith('.next/') ||\n      file.includes('node_modules/') ||\n      file.endsWith('.d.ts')\n    ) {\n      return;\n    }\n    const isCatalog = file.startsWith(`${catalogDir}/`) && file.endsWith('.json');\n    if (isCatalog || compiler.SOURCE_FILE_RE.test(file)) schedule();\n  });\n  watcher.unref?.();\n\n  const dispose = (): void => {\n    clearTimeout(timer);\n    watcher.close();\n    active.delete(cfg.root);\n  };\n  active.set(cfg.root, dispose);\n  return dispose;\n}\n\n// test hook\nexport function stopWatcher(root: string): void {\n  active.get(root)?.();\n}\n","import type { VerbalyConfig } from '@verbaly/compiler';\nimport { join } from 'node:path';\nimport {\n  GENERATED_DIR,\n  generatedDir,\n  writeGeneratedModules,\n  type Compiler,\n  type RequestOptions,\n} from './codegen';\nimport { startWatcher } from './watch';\n\nexport type { VerbalyConfig } from '@verbaly/compiler';\nexport type { RequestOptions } from './codegen';\n\nexport interface NextVerbalyOptions extends VerbalyConfig {\n  failOnMissing?: boolean;\n  cookie?: string | false;\n  fallback?: string;\n}\n\n// structural NextConfig subset: compat asserted against next's real type in tests.\n// No index signatures: Next's real interfaces have none and a target index\n// signature would reject them.\nexport interface WebpackConfigLike {\n  resolve?: { alias?: Record<string, unknown>; [key: string]: unknown };\n  module?: { rules?: unknown[]; [key: string]: unknown };\n  plugins?: unknown[];\n  [key: string]: unknown;\n}\n\ninterface WebpackContextLike {\n  webpack?: {\n    NormalModuleReplacementPlugin: new (test: RegExp, resource: string) => unknown;\n  };\n}\n\n// context param is `never` so Next's real webpack fn (specific context type) stays assignable\nexport type WebpackFn = (config: WebpackConfigLike, context: never) => unknown;\n\nexport interface TurbopackLike {\n  resolveAlias?: Record<string, unknown>;\n  rules?: Record<string, unknown>;\n}\n\nexport interface NextConfigLike {\n  webpack?: WebpackFn | null;\n  turbopack?: TurbopackLike;\n}\n\n// constraint is `object` (not NextConfigLike): an all-optional target would\n// reject configs sharing no keys with it (TS weak-type rule)\nexport type NextConfigInput<C extends object> =\n  | C\n  | ((phase: string, context: { defaultConfig?: unknown }) => C | Promise<C>);\n\n// next/constants values: literal to keep this module import-free of next\nconst DEV_PHASE = 'phase-development-server';\nconst BUILD_PHASE = 'phase-production-build';\n\nconst LOADER = '@verbaly/next/loader';\n// compiler's SOURCE_FILE_RE (inlined: the compiler is only dynamically imported here).\n// Matching happens via `condition.path`: a bare extension glob also matches Next's\n// internal App Router entry and Turbopack panics reading it as a file.\nconst SOURCE_PATH_RE = /\\.[cm]?[jt]sx?$/;\n\nexport function withVerbaly<C extends object>(\n  nextConfig?: NextConfigInput<C>,\n  options: NextVerbalyOptions = {},\n): (phase: string, context?: { defaultConfig?: unknown }) => Promise<C> {\n  const { failOnMissing, cookie, fallback, ...verbalyConfig } = options;\n  const requestOptions: RequestOptions = { cookie, fallback };\n\n  return async (phase, context = {}) => {\n    const base: C =\n      typeof nextConfig === 'function' ? await nextConfig(phase, context) : (nextConfig ?? ({} as C));\n    const root = verbalyConfig.root ?? process.cwd();\n\n    // production server / export: everything is bundled, so no FS work, config only\n    if (phase !== DEV_PHASE && phase !== BUILD_PHASE) {\n      return composeConfig(base, root);\n    }\n\n    // dynamic: the compiler is ESM-only and this entry is also consumed as CJS\n    const compiler: Compiler = await import('@verbaly/compiler');\n\n    const cfg = await compiler.loadConfig(root, verbalyConfig);\n    const catalogs = compiler.loadCatalogs(cfg);\n    const registry = await compiler.extractProject(cfg);\n\n    if (phase === BUILD_PHASE) {\n      if (failOnMissing !== false) compiler.runBuildGate(cfg, registry);\n    } else {\n      const { added } = compiler.syncCatalogs(cfg, catalogs, registry);\n      for (const locale of Object.keys(added)) {\n        compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});\n      }\n      compiler.writeDts(cfg, new Map(Object.entries(catalogs[cfg.sourceLocale] ?? {})));\n      startWatcher(compiler, cfg, requestOptions);\n    }\n\n    writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n    return composeConfig(base, cfg.root);\n  };\n}\n\nfunction composeConfig<C extends object>(base: C, root: string): C {\n  const runtimeModule = join(generatedDir(root), 'index.js');\n  const { webpack: userWebpack, turbopack } = base as NextConfigLike;\n\n  const rules: Record<string, unknown> = { ...turbopack?.rules };\n  const verbalyRule = {\n    condition: { all: [{ not: 'foreign' }, { path: SOURCE_PATH_RE }] },\n    loaders: [LOADER],\n  };\n  const existing = rules['*'];\n  rules['*'] = existing\n    ? [...(Array.isArray(existing) ? existing : [existing]), verbalyRule]\n    : verbalyRule;\n\n  return {\n    ...base,\n    turbopack: {\n      ...turbopack,\n      resolveAlias: {\n        ...turbopack?.resolveAlias,\n        'virtual:verbaly': `./${GENERATED_DIR}/index.js`,\n      },\n      rules,\n    },\n    webpack(config: WebpackConfigLike, context: unknown) {\n      // webpack 5 treats 'virtual:' as a URI scheme: resolve.alias never fires,\n      // module replacement does; the alias stays as a fallback for odd setups\n      const { webpack: webpackInstance } = (context ?? {}) as WebpackContextLike;\n      if (webpackInstance?.NormalModuleReplacementPlugin) {\n        config.plugins ??= [];\n        config.plugins.push(\n          new webpackInstance.NormalModuleReplacementPlugin(/^virtual:verbaly$/, runtimeModule),\n        );\n      }\n      config.resolve ??= {};\n      config.resolve.alias ??= {};\n      (config.resolve.alias as Record<string, unknown>)['virtual:verbaly'] = runtimeModule;\n      config.module ??= {};\n      config.module.rules ??= [];\n      config.module.rules.push({\n        test: /\\.[cm]?[jt]sx?$/,\n        exclude: /node_modules/,\n        enforce: 'pre',\n        use: [{ loader: LOADER }],\n      });\n      return userWebpack ? userWebpack(config, context as never) : config;\n    },\n  } as C;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/codegen.ts","../src/watch.ts","../src/index.ts"],"sourcesContent":["import type { Catalogs, ResolvedConfig } from '@verbaly/compiler';\nimport { mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nexport type Compiler = typeof import('@verbaly/compiler');\n\nexport interface RequestOptions {\n  cookie?: string | false;\n  fallback?: string;\n}\n\nexport const GENERATED_DIR = '.verbaly';\n\nexport function generatedDir(root: string): string {\n  return join(root, GENERATED_DIR);\n}\n\n// content compare: identical rewrites must not retrigger the bundler\nfunction writeIfChanged(file: string, content: string): boolean {\n  try {\n    if (readFileSync(file, 'utf8') === content) return false;\n  } catch {\n    // new file\n  }\n  writeFileSync(file, content);\n  return true;\n}\n\n// dev-phase pipeline shared by withVerbaly and the watcher: sync catalogs to\n// the sources, refresh verbaly.d.ts, regenerate the runtime modules\nexport function syncAndWrite(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  catalogs: Catalogs,\n  registry: Awaited<ReturnType<Compiler['extractProject']>>,\n  requestOptions: RequestOptions,\n): void {\n  const { added } = compiler.syncCatalogs(cfg, catalogs, registry);\n  for (const locale of Object.keys(added)) {\n    compiler.writeCatalog(cfg, locale, catalogs[locale] ?? {});\n  }\n  compiler.writeDts(cfg, catalogs[cfg.sourceLocale] ?? {});\n  writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n}\n\n// real-file replacement for virtual:verbaly: Turbopack has no virtual modules\nexport function writeGeneratedModules(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  catalogs: Catalogs,\n  requestOptions: RequestOptions = {},\n): boolean {\n  const dir = generatedDir(cfg.root);\n  const localeDir = join(dir, 'locale');\n  mkdirSync(localeDir, { recursive: true });\n\n  let changed = writeIfChanged(join(dir, '.gitignore'), '*\\n');\n\n  const runtime = compiler.generateRuntimeModule(cfg, {\n    localeImport: (locale) => `./locale/${locale}.js`,\n    extraExports: `export const requestOptions = ${JSON.stringify(requestOptions)};\\n`,\n  });\n  changed = writeIfChanged(join(dir, 'index.js'), runtime) || changed;\n\n  const expected = new Set(cfg.locales.map((locale) => `${locale}.js`));\n  for (const locale of cfg.locales) {\n    changed =\n      writeIfChanged(\n        join(localeDir, `${locale}.js`),\n        compiler.generateLocaleModule(catalogs[locale] ?? {}),\n      ) || changed;\n  }\n  for (const file of readdirSync(localeDir)) {\n    if (!expected.has(file)) {\n      rmSync(join(localeDir, file));\n      changed = true;\n    }\n  }\n  return changed;\n}\n","import type { ResolvedConfig } from '@verbaly/compiler';\nimport { watch } from 'node:fs';\nimport { relative } from 'node:path';\nimport { GENERATED_DIR, syncAndWrite, type Compiler, type RequestOptions } from './codegen';\n\n// one watcher per project root: next.config can be evaluated more than once\nconst active = new Map<string, () => void>();\n\nexport function startWatcher(\n  compiler: Compiler,\n  cfg: ResolvedConfig,\n  requestOptions: RequestOptions,\n): () => void {\n  const existing = active.get(cfg.root);\n  if (existing) return existing;\n\n  const catalogDir = relative(cfg.root, cfg.dir).replaceAll('\\\\', '/');\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let running = false;\n  let queued = false;\n\n  async function refresh(): Promise<void> {\n    if (running) {\n      queued = true;\n      return;\n    }\n    running = true;\n    try {\n      const catalogs = compiler.loadCatalogs(cfg);\n      const registry = await compiler.extractProject(cfg);\n      syncAndWrite(compiler, cfg, catalogs, registry, requestOptions);\n    } catch (error) {\n      console.warn('[verbaly] live extraction failed:', error);\n    } finally {\n      running = false;\n      if (queued) {\n        queued = false;\n        schedule();\n      }\n    }\n  }\n\n  function schedule(): void {\n    clearTimeout(timer);\n    timer = setTimeout(() => void refresh(), 150);\n  }\n\n  const watcher = watch(cfg.root, { recursive: true }, (_event, filename) => {\n    if (!filename) return;\n    const file = filename.replaceAll('\\\\', '/');\n    if (\n      file.startsWith(`${GENERATED_DIR}/`) ||\n      file.startsWith('.next/') ||\n      file.includes('node_modules/') ||\n      file.endsWith('.d.ts')\n    ) {\n      return;\n    }\n    const isCatalog = file.startsWith(`${catalogDir}/`) && file.endsWith('.json');\n    if (isCatalog || compiler.SOURCE_FILE_RE.test(file)) schedule();\n  });\n  watcher.unref?.();\n\n  const dispose = (): void => {\n    clearTimeout(timer);\n    watcher.close();\n    active.delete(cfg.root);\n  };\n  active.set(cfg.root, dispose);\n  return dispose;\n}\n\n// test hook\nexport function stopWatcher(root: string): void {\n  active.get(root)?.();\n}\n","import type { PluginOptions } from '@verbaly/compiler';\nimport { join } from 'node:path';\nimport {\n  GENERATED_DIR,\n  generatedDir,\n  syncAndWrite,\n  writeGeneratedModules,\n  type Compiler,\n  type RequestOptions,\n} from './codegen';\nimport { startWatcher } from './watch';\n\nexport type { VerbalyConfig } from '@verbaly/compiler';\nexport type { RequestOptions } from './codegen';\n\nexport interface NextVerbalyOptions extends PluginOptions {\n  cookie?: string | false;\n  fallback?: string;\n}\n\n// structural NextConfig subset: compat asserted against next's real type in tests.\n// No index signatures: Next's real interfaces have none and a target index\n// signature would reject them.\nexport interface WebpackConfigLike {\n  resolve?: { alias?: Record<string, unknown>; [key: string]: unknown };\n  module?: { rules?: unknown[]; [key: string]: unknown };\n  plugins?: unknown[];\n  [key: string]: unknown;\n}\n\ninterface WebpackContextLike {\n  webpack?: {\n    NormalModuleReplacementPlugin: new (test: RegExp, resource: string) => unknown;\n  };\n}\n\n// context param is `never` so Next's real webpack fn (specific context type) stays assignable\nexport type WebpackFn = (config: WebpackConfigLike, context: never) => unknown;\n\nexport interface TurbopackLike {\n  resolveAlias?: Record<string, unknown>;\n  rules?: Record<string, unknown>;\n}\n\nexport interface NextConfigLike {\n  webpack?: WebpackFn | null;\n  turbopack?: TurbopackLike;\n}\n\n// constraint is `object` (not NextConfigLike): an all-optional target would\n// reject configs sharing no keys with it (TS weak-type rule)\nexport type NextConfigInput<C extends object> =\n  | C\n  | ((phase: string, context: { defaultConfig?: unknown }) => C | Promise<C>);\n\n// next/constants values: literal to keep this module import-free of next\nconst DEV_PHASE = 'phase-development-server';\nconst BUILD_PHASE = 'phase-production-build';\n\nconst LOADER = '@verbaly/next/loader';\n// compiler's SOURCE_FILE_RE (inlined: the compiler is only dynamically imported here).\n// Matching happens via `condition.path`: a bare extension glob also matches Next's\n// internal App Router entry and Turbopack panics reading it as a file.\nconst SOURCE_PATH_RE = /\\.[cm]?[jt]sx?$/;\n\nexport function withVerbaly<C extends object>(\n  nextConfig?: NextConfigInput<C>,\n  options: NextVerbalyOptions = {},\n): (phase: string, context?: { defaultConfig?: unknown }) => Promise<C> {\n  const { failOnMissing, cookie, fallback, ...verbalyConfig } = options;\n  const requestOptions: RequestOptions = { cookie, fallback };\n\n  return async (phase, context = {}) => {\n    const base: C =\n      typeof nextConfig === 'function' ? await nextConfig(phase, context) : (nextConfig ?? ({} as C));\n    const root = verbalyConfig.root ?? process.cwd();\n\n    // production server / export: everything is bundled, so no FS work, config only\n    if (phase !== DEV_PHASE && phase !== BUILD_PHASE) {\n      return composeConfig(base, root);\n    }\n\n    // dynamic: the compiler is ESM-only and this entry is also consumed as CJS\n    const compiler: Compiler = await import('@verbaly/compiler');\n\n    const cfg = await compiler.loadConfig(root, verbalyConfig);\n    const catalogs = compiler.loadCatalogs(cfg);\n    const registry = await compiler.extractProject(cfg);\n\n    if (phase === BUILD_PHASE) {\n      compiler.runBuildGate(cfg, registry, failOnMissing);\n      writeGeneratedModules(compiler, cfg, catalogs, requestOptions);\n    } else {\n      syncAndWrite(compiler, cfg, catalogs, registry, requestOptions);\n      startWatcher(compiler, cfg, requestOptions);\n    }\n\n    return composeConfig(base, cfg.root);\n  };\n}\n\nfunction composeConfig<C extends object>(base: C, root: string): C {\n  const runtimeModule = join(generatedDir(root), 'index.js');\n  const { webpack: userWebpack, turbopack } = base as NextConfigLike;\n\n  const rules: Record<string, unknown> = { ...turbopack?.rules };\n  const verbalyRule = {\n    condition: { all: [{ not: 'foreign' }, { path: SOURCE_PATH_RE }] },\n    loaders: [LOADER],\n  };\n  const existing = rules['*'];\n  rules['*'] = existing\n    ? [...(Array.isArray(existing) ? existing : [existing]), verbalyRule]\n    : verbalyRule;\n\n  return {\n    ...base,\n    turbopack: {\n      ...turbopack,\n      resolveAlias: {\n        ...turbopack?.resolveAlias,\n        'virtual:verbaly': `./${GENERATED_DIR}/index.js`,\n      },\n      rules,\n    },\n    webpack(config: WebpackConfigLike, context: unknown) {\n      // webpack 5 treats 'virtual:' as a URI scheme: resolve.alias never fires,\n      // module replacement does; the alias stays as a fallback for odd setups\n      const { webpack: webpackInstance } = (context ?? {}) as WebpackContextLike;\n      if (webpackInstance?.NormalModuleReplacementPlugin) {\n        config.plugins ??= [];\n        config.plugins.push(\n          new webpackInstance.NormalModuleReplacementPlugin(/^virtual:verbaly$/, runtimeModule),\n        );\n      }\n      config.resolve ??= {};\n      config.resolve.alias ??= {};\n      (config.resolve.alias as Record<string, unknown>)['virtual:verbaly'] = runtimeModule;\n      config.module ??= {};\n      config.module.rules ??= [];\n      config.module.rules.push({\n        test: SOURCE_PATH_RE,\n        exclude: /node_modules/,\n        enforce: 'pre',\n        use: [{ loader: LOADER }],\n      });\n      return userWebpack ? userWebpack(config, context as never) : config;\n    },\n  } as C;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verbaly/next",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Next.js integration for Verbaly — App Router/RSC with per-request locale negotiation, Turbopack and webpack support, flash-free hydration.",
   "keywords": [
     "i18n",
@@ -64,13 +64,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@verbaly/compiler": "^0.20.0"
+    "@verbaly/compiler": "^0.21.0"
   },
   "peerDependencies": {
     "next": "^15.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0",
-    "@verbaly/react": "^0.20.0",
-    "verbaly": "^0.20.0"
+    "@verbaly/react": "^0.21.0",
+    "verbaly": "^0.21.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.17",
@@ -79,8 +79,8 @@
     "next": "^16.2.10",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "verbaly": "0.20.0",
-    "@verbaly/react": "0.20.0"
+    "@verbaly/react": "0.21.0",
+    "verbaly": "0.21.0"
   },
   "scripts": {
     "build": "tsdown",