@inlang/paraglide-js 2.24.0 → 2.25.0

package/dist/bundler-plugins/esbuild.d.ts

@@ -1 +1 @@
-export declare const paraglideEsbuildPlugin: (options: import("../index.js").CompilerOptions) => import("unplugin").EsbuildPlugin;
+export declare const paraglideEsbuildPlugin: (options: import("./unplugin.js").ParaglidePluginOptions) => import("unplugin").EsbuildPlugin;

package/dist/bundler-plugins/per-locale-build/index.d.ts

@@ -1,6 +1,6 @@
 import type { Plugin } from "vite";
-import type { CompilerOptions } from "../../compiler/compiler-options.js";
+import type { ParaglidePluginOptions } from "../unplugin.js";
 export declare function createPerLocaleBuildPlugins(args: {
-    compilerOptions: CompilerOptions;
-    createCompilerPlugin: (options: CompilerOptions) => Plugin;
+    compilerOptions: ParaglidePluginOptions;
+    createCompilerPlugin: (options: ParaglidePluginOptions) => Plugin;
 }): Plugin[];

package/dist/bundler-plugins/per-locale-build/index.js

@@ -1,14 +1,36 @@
 import nodeFs from "node:fs";
+import { resolve } from "node:path";
 import { loadProjectFromDirectory } from "@inlang/sdk";
 import { perLocaleBuildStaticLocaleExpression } from "../../compiler/per-locale-build.js";
 import { createViteLocaleEnvironmentPlugin } from "./vite-environments.js";
+import { loadParaglideConfig, resolveCompilerOptions, } from "../../services/config/index.js";
 export function createPerLocaleBuildPlugins(args) {
-    validateCompilerOptions(args.compilerOptions);
+    // Config file values are not known yet — they are validated in
+    // loadSettings once the config has been loaded.
+    validateExplicitCompilerOptions(args.compilerOptions, undefined);
     const compilerOptions = createPerLocaleCompilerOptions(args.compilerOptions);
+    // Project root as reported by vite. Config file discovery starts here.
+    let discoveryRoot;
     return [
+        {
+            name: "paraglide-config-discovery-root",
+            enforce: "pre",
+            // The locale-environment plugin loads settings from its own
+            // `config` hook, which runs BEFORE any `configResolved`. Capture
+            // an explicitly configured root here so it is available in time;
+            // `configResolved` still overwrites it with Vite's final value
+            // (covering roots supplied via CLI flags).
+            config(config) {
+                if (config.root !== undefined)
+                    discoveryRoot = config.root;
+            },
+            configResolved(config) {
+                discoveryRoot = config.root;
+            },
+        },
         args.createCompilerPlugin(compilerOptions),
         createViteLocaleEnvironmentPlugin({
-            settings: () => loadSettings(compilerOptions),
+            settings: () => loadSettings(args.compilerOptions, discoveryRoot),
         }),
     ];
 }
@@ -17,37 +39,59 @@ function createPerLocaleCompilerOptions(compilerOptions) {
         ...compilerOptions,
         outputStructure: compilerOptions.outputStructure ?? "locale-modules",
         experimentalStaticLocale: perLocaleBuildStaticLocaleExpression,
-        additionalFiles: {
-            ...compilerOptions.additionalFiles,
-        },
+        // Only forward additionalFiles when explicitly supplied — an empty
+        // object would override files provided by paraglide.config.*.
+        ...(compilerOptions.additionalFiles !== undefined
+            ? { additionalFiles: { ...compilerOptions.additionalFiles } }
+            : {}),
     };
 }
-function validateCompilerOptions(options) {
-    if (options.experimentalStaticLocale !== undefined) {
+// Values that come from the paraglide config file are only known after
+// loading it, so conflicts are checked against both sources here. Only
+// explicitly set values conflict; unset ones fall back to the per-locale
+// defaults.
+function validateExplicitCompilerOptions(options, config) {
+    const explicit = {
+        experimentalStaticLocale: options.experimentalStaticLocale ?? config?.experimentalStaticLocale,
+        experimentalMiddlewareLocaleSplitting: options.experimentalMiddlewareLocaleSplitting ??
+            config?.experimentalMiddlewareLocaleSplitting,
+        outputStructure: options.outputStructure ?? config?.outputStructure,
+    };
+    if (explicit.experimentalStaticLocale !== undefined) {
         throw new Error("experimentalPerLocaleBuild cannot be combined with experimentalStaticLocale because it controls the compiler's static locale expression.");
     }
-    if (options.experimentalMiddlewareLocaleSplitting) {
+    if (explicit.experimentalMiddlewareLocaleSplitting) {
         throw new Error("experimentalPerLocaleBuild cannot be combined with experimentalMiddlewareLocaleSplitting.");
     }
-    if (options.outputStructure !== undefined &&
-        options.outputStructure !== "locale-modules") {
+    if (explicit.outputStructure !== undefined &&
+        explicit.outputStructure !== "locale-modules") {
         throw new Error('experimentalPerLocaleBuild requires outputStructure: "locale-modules".');
     }
 }
-async function loadSettings(options) {
-    const project = await loadProjectFromDirectory({
-        path: options.project,
+async function loadSettings(options, discoveryRoot) {
+    const root = discoveryRoot ?? process.cwd();
+    const loaded = await loadParaglideConfig({
+        projectDir: resolve(root, options.project),
+    });
+    validateExplicitCompilerOptions(options, loaded?.config);
+    const { project } = resolveCompilerOptions({
+        config: loaded?.config,
+        overrides: options,
+        root,
+    });
+    const loadedProject = await loadProjectFromDirectory({
+        path: project,
         fs: options.fs ?? nodeFs,
     });
     try {
-        const settings = await project.settings.get();
+        const settings = await loadedProject.settings.get();
         return {
             baseLocale: settings.baseLocale,
             locales: [...settings.locales],
         };
     }
     finally {
-        await project.close();
+        await loadedProject.close();
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/bundler-plugins/per-locale-build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bundler-plugins/per-locale-build/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,oCAAoC,EAAE,MAAM,oCAAoC,CAAC;AAE1F,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAE3E,MAAM,UAAU,2BAA2B,CAAC,IAG3C;IACA,uBAAuB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,8BAA8B,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7E,OAAO;QACN,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC;QAC1C,iCAAiC,CAAC;YACjC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC;SAC7C,CAAC;KACF,CAAC;AACH,CAAC;AAED,SAAS,8BAA8B,CACtC,eAAgC;IAEhC,OAAO;QACN,GAAG,eAAe;QAClB,eAAe,EAAE,eAAe,CAAC,eAAe,IAAI,gBAAgB;QACpE,wBAAwB,EAAE,oCAAoC;QAC9D,eAAe,EAAE;YAChB,GAAG,eAAe,CAAC,eAAe;SAClC;KACD,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAwB;IACxD,IAAI,OAAO,CAAC,wBAAwB,KAAK,SAAS,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACd,0IAA0I,CAC1I,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,qCAAqC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACd,2FAA2F,CAC3F,CAAC;IACH,CAAC;IACD,IACC,OAAO,CAAC,eAAe,KAAK,SAAS;QACrC,OAAO,CAAC,eAAe,KAAK,gBAAgB,EAC3C,CAAC;QACF,MAAM,IAAI,KAAK,CACd,wEAAwE,CACxE,CAAC;IACH,CAAC;AACF,CAAC;AAED,KAAK,UAAU,YAAY,CAC1B,OAAgD;IAEhD,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC;QAC9C,IAAI,EAAE,OAAO,CAAC,OAAO;QACrB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,MAAM;KACxB,CAAC,CAAC;IACH,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC9C,OAAO;YACN,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;SAC9B,CAAC;IACH,CAAC;YAAS,CAAC;QACV,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACF,CAAC","sourcesContent":["import nodeFs from \"node:fs\";\nimport { loadProjectFromDirectory } from \"@inlang/sdk\";\nimport type { Plugin } from \"vite\";\nimport type { CompilerOptions } from \"../../compiler/compiler-options.js\";\nimport { perLocaleBuildStaticLocaleExpression } from \"../../compiler/per-locale-build.js\";\nimport type { PerLocaleBuildSettings } from \"./types.js\";\nimport { createViteLocaleEnvironmentPlugin } from \"./vite-environments.js\";\n\nexport function createPerLocaleBuildPlugins(args: {\n\tcompilerOptions: CompilerOptions;\n\tcreateCompilerPlugin: (options: CompilerOptions) => Plugin;\n}): Plugin[] {\n\tvalidateCompilerOptions(args.compilerOptions);\n\tconst compilerOptions = createPerLocaleCompilerOptions(args.compilerOptions);\n\treturn [\n\t\targs.createCompilerPlugin(compilerOptions),\n\t\tcreateViteLocaleEnvironmentPlugin({\n\t\t\tsettings: () => loadSettings(compilerOptions),\n\t\t}),\n\t];\n}\n\nfunction createPerLocaleCompilerOptions(\n\tcompilerOptions: CompilerOptions\n): CompilerOptions {\n\treturn {\n\t\t...compilerOptions,\n\t\toutputStructure: compilerOptions.outputStructure ?? \"locale-modules\",\n\t\texperimentalStaticLocale: perLocaleBuildStaticLocaleExpression,\n\t\tadditionalFiles: {\n\t\t\t...compilerOptions.additionalFiles,\n\t\t},\n\t};\n}\n\nfunction validateCompilerOptions(options: CompilerOptions): void {\n\tif (options.experimentalStaticLocale !== undefined) {\n\t\tthrow new Error(\n\t\t\t\"experimentalPerLocaleBuild cannot be combined with experimentalStaticLocale because it controls the compiler's static locale expression.\"\n\t\t);\n\t}\n\tif (options.experimentalMiddlewareLocaleSplitting) {\n\t\tthrow new Error(\n\t\t\t\"experimentalPerLocaleBuild cannot be combined with experimentalMiddlewareLocaleSplitting.\"\n\t\t);\n\t}\n\tif (\n\t\toptions.outputStructure !== undefined &&\n\t\toptions.outputStructure !== \"locale-modules\"\n\t) {\n\t\tthrow new Error(\n\t\t\t'experimentalPerLocaleBuild requires outputStructure: \"locale-modules\".'\n\t\t);\n\t}\n}\n\nasync function loadSettings(\n\toptions: Pick<CompilerOptions, \"project\" | \"fs\">\n): Promise<PerLocaleBuildSettings> {\n\tconst project = await loadProjectFromDirectory({\n\t\tpath: options.project,\n\t\tfs: options.fs ?? nodeFs,\n\t});\n\ttry {\n\t\tconst settings = await project.settings.get();\n\t\treturn {\n\t\t\tbaseLocale: settings.baseLocale,\n\t\t\tlocales: [...settings.locales],\n\t\t};\n\t} finally {\n\t\tawait project.close();\n\t}\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bundler-plugins/per-locale-build/index.ts"],"names":[],"mappings":"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","sourcesContent":["import nodeFs from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { loadProjectFromDirectory } from \"@inlang/sdk\";\nimport type { Plugin } from \"vite\";\nimport { perLocaleBuildStaticLocaleExpression } from \"../../compiler/per-locale-build.js\";\nimport type { PerLocaleBuildSettings } from \"./types.js\";\nimport { createViteLocaleEnvironmentPlugin } from \"./vite-environments.js\";\nimport {\n\tloadParaglideConfig,\n\tresolveCompilerOptions,\n\ttype ParaglideConfig,\n} from \"../../services/config/index.js\";\nimport type { ParaglidePluginOptions } from \"../unplugin.js\";\n\nexport function createPerLocaleBuildPlugins(args: {\n\tcompilerOptions: ParaglidePluginOptions;\n\tcreateCompilerPlugin: (options: ParaglidePluginOptions) => Plugin;\n}): Plugin[] {\n\t// Config file values are not known yet — they are validated in\n\t// loadSettings once the config has been loaded.\n\tvalidateExplicitCompilerOptions(args.compilerOptions, undefined);\n\tconst compilerOptions = createPerLocaleCompilerOptions(args.compilerOptions);\n\t// Project root as reported by vite. Config file discovery starts here.\n\tlet discoveryRoot: string | undefined;\n\treturn [\n\t\t{\n\t\t\tname: \"paraglide-config-discovery-root\",\n\t\t\tenforce: \"pre\",\n\t\t\t// The locale-environment plugin loads settings from its own\n\t\t\t// `config` hook, which runs BEFORE any `configResolved`. Capture\n\t\t\t// an explicitly configured root here so it is available in time;\n\t\t\t// `configResolved` still overwrites it with Vite's final value\n\t\t\t// (covering roots supplied via CLI flags).\n\t\t\tconfig(config) {\n\t\t\t\tif (config.root !== undefined) discoveryRoot = config.root;\n\t\t\t},\n\t\t\tconfigResolved(config) {\n\t\t\t\tdiscoveryRoot = config.root;\n\t\t\t},\n\t\t},\n\t\targs.createCompilerPlugin(compilerOptions),\n\t\tcreateViteLocaleEnvironmentPlugin({\n\t\t\tsettings: () => loadSettings(args.compilerOptions, discoveryRoot),\n\t\t}),\n\t];\n}\n\nfunction createPerLocaleCompilerOptions(\n\tcompilerOptions: ParaglidePluginOptions\n): ParaglidePluginOptions {\n\treturn {\n\t\t...compilerOptions,\n\t\toutputStructure: compilerOptions.outputStructure ?? \"locale-modules\",\n\t\texperimentalStaticLocale: perLocaleBuildStaticLocaleExpression,\n\t\t// Only forward additionalFiles when explicitly supplied — an empty\n\t\t// object would override files provided by paraglide.config.*.\n\t\t...(compilerOptions.additionalFiles !== undefined\n\t\t\t? { additionalFiles: { ...compilerOptions.additionalFiles } }\n\t\t\t: {}),\n\t};\n}\n\n// Values that come from the paraglide config file are only known after\n// loading it, so conflicts are checked against both sources here. Only\n// explicitly set values conflict; unset ones fall back to the per-locale\n// defaults.\nfunction validateExplicitCompilerOptions(\n\toptions: ParaglidePluginOptions,\n\tconfig: ParaglideConfig | undefined\n): void {\n\tconst explicit = {\n\t\texperimentalStaticLocale:\n\t\t\toptions.experimentalStaticLocale ?? config?.experimentalStaticLocale,\n\t\texperimentalMiddlewareLocaleSplitting:\n\t\t\toptions.experimentalMiddlewareLocaleSplitting ??\n\t\t\tconfig?.experimentalMiddlewareLocaleSplitting,\n\t\toutputStructure: options.outputStructure ?? config?.outputStructure,\n\t};\n\tif (explicit.experimentalStaticLocale !== undefined) {\n\t\tthrow new Error(\n\t\t\t\"experimentalPerLocaleBuild cannot be combined with experimentalStaticLocale because it controls the compiler's static locale expression.\"\n\t\t);\n\t}\n\tif (explicit.experimentalMiddlewareLocaleSplitting) {\n\t\tthrow new Error(\n\t\t\t\"experimentalPerLocaleBuild cannot be combined with experimentalMiddlewareLocaleSplitting.\"\n\t\t);\n\t}\n\tif (\n\t\texplicit.outputStructure !== undefined &&\n\t\texplicit.outputStructure !== \"locale-modules\"\n\t) {\n\t\tthrow new Error(\n\t\t\t'experimentalPerLocaleBuild requires outputStructure: \"locale-modules\".'\n\t\t);\n\t}\n}\n\nasync function loadSettings(\n\toptions: ParaglidePluginOptions,\n\tdiscoveryRoot?: string | undefined\n): Promise<PerLocaleBuildSettings> {\n\tconst root = discoveryRoot ?? process.cwd();\n\tconst loaded = await loadParaglideConfig({\n\t\tprojectDir: resolve(root, options.project),\n\t});\n\tvalidateExplicitCompilerOptions(options, loaded?.config);\n\tconst { project } = resolveCompilerOptions({\n\t\tconfig: loaded?.config,\n\t\toverrides: options,\n\t\troot,\n\t});\n\tconst loadedProject = await loadProjectFromDirectory({\n\t\tpath: project,\n\t\tfs: options.fs ?? nodeFs,\n\t});\n\ttry {\n\t\tconst settings = await loadedProject.settings.get();\n\t\treturn {\n\t\t\tbaseLocale: settings.baseLocale,\n\t\t\tlocales: [...settings.locales],\n\t\t};\n\t} finally {\n\t\tawait loadedProject.close();\n\t}\n}\n"]}

package/dist/bundler-plugins/rolldown.d.ts

@@ -1 +1 @@
-export declare const paraglideRolldownPlugin: (options: import("../index.js").CompilerOptions) => import("unplugin").RolldownPlugin<any>[] | import("unplugin").RolldownPlugin<any>;
+export declare const paraglideRolldownPlugin: (options: import("./unplugin.js").ParaglidePluginOptions) => import("unplugin").RolldownPlugin<any>[] | import("unplugin").RolldownPlugin<any>;

package/dist/bundler-plugins/rollup.d.ts

@@ -1 +1 @@
-export declare const paraglideRollupPlugin: (options: import("../index.js").CompilerOptions) => import("unplugin").RollupPlugin<any>[] | import("unplugin").RollupPlugin<any>;
+export declare const paraglideRollupPlugin: (options: import("./unplugin.js").ParaglidePluginOptions) => import("unplugin").RollupPlugin<any>[] | import("unplugin").RollupPlugin<any>;

package/dist/bundler-plugins/rspack.d.ts

@@ -1 +1 @@
-export declare const paraglideRspackPlugin: (options: import("../index.js").CompilerOptions) => RspackPluginInstance;
+export declare const paraglideRspackPlugin: (options: import("./unplugin.js").ParaglidePluginOptions) => RspackPluginInstance;

package/dist/bundler-plugins/unplugin.d.ts

@@ -1,3 +1,37 @@
 import type { UnpluginFactory } from "unplugin";
 import type { CompilerOptions } from "../compiler/compiler-options.js";
-export declare const unpluginFactory: UnpluginFactory<CompilerOptions>;
+/**
+ * The options accepted by the paraglide bundler plugins.
+ *
+ * `project` is required — the path to your inlang project directory, which
+ * also hosts the paraglide config file (`<project>/paraglide.config.*`).
+ * Relative paths are resolved against the tool's project root (Vite `root`,
+ * webpack/rspack `context`, else the process working directory).
+ *
+ * Every other property is optional: values that are not provided are read
+ * from the config file, and anything still missing falls back to the
+ * built-in defaults.
+ *
+ * @example
+ * ```ts
+ * paraglideVitePlugin({ project: "./project.inlang" })
+ *
+ * // Explicit options win over the config file
+ * paraglideVitePlugin({
+ *   project: "./project.inlang",
+ *   outdir: "./src/paraglide-custom",
+ * })
+ * ```
+ */
+export type ParaglidePluginOptions = Omit<Partial<CompilerOptions>, "project"> & {
+    /**
+     * Required — the path to your inlang project directory, which also
+     * hosts the paraglide config file (`<project>/paraglide.config.*`).
+     * Relative paths are resolved against the tool's project root (Vite
+     * `root`, webpack/rspack `context`, else the process working directory).
+     */
+    project: string;
+};
+type UnpluginFactoryWithOptions = (userArgs: ParaglidePluginOptions) => ReturnType<UnpluginFactory<ParaglidePluginOptions>>;
+export declare const unpluginFactory: UnpluginFactoryWithOptions;
+export {};