@inlang/paraglide-js 2.0.0-beta.8 → 2.0.0-beta.9

package/dist/adapter-utils/routing/resolveUserPathDefinition.test.js

@@ -8,14 +8,14 @@ describe("resolvePathTranslations", () => {
                 de: "/ueber-uns",
             },
         };
-        const availableLanguageTags = ["en", "de"];
-        const result = resolveUserPathDefinitions(userTranslations, availableLanguageTags);
+        const availableLocales = ["en", "de"];
+        const result = resolveUserPathDefinitions(userTranslations, availableLocales);
         expect(result).toEqual(userTranslations);
     });
     it("resolves message translations", () => {
         const userTranslations = {
-            "/about": (_, { languageTag }) => {
-                switch (languageTag) {
+            "/about": (_, { locale }) => {
+                switch (locale) {
                     case "en":
                         return "/about";
                     case "de":
@@ -23,8 +23,8 @@ describe("resolvePathTranslations", () => {
                 }
             },
         };
-        const availableLanguageTags = ["en", "de"];
-        const result = resolveUserPathDefinitions(userTranslations, availableLanguageTags);
+        const availableLocales = ["en", "de"];
+        const result = resolveUserPathDefinitions(userTranslations, availableLocales);
         expect(result).toEqual({
             "/about": {
                 en: "/about",

package/dist/adapter-utils/routing/resolveUserPathDefinitions.d.ts

@@ -1,4 +1,4 @@
-import type { MessageIndexFunction } from "../../index.js";
+import type { MessageBundleFunction } from "../../compiler/types.js";
 import type { PathDefinitionTranslations } from "./routeDefinitions.js";
 /**
  * Maps canonical paths to translations for each language.
@@ -22,7 +22,7 @@ import type { PathDefinitionTranslations } from "./routeDefinitions.js";
  * ```
  */
 export type UserPathDefinitionTranslations<T extends string = string> = {
-    [canonicalPath: `/${string}`]: Record<T, `/${string}`> | MessageIndexFunction<T>;
+    [canonicalPath: `/${string}`]: Record<T, `/${string}`> | MessageBundleFunction<T>;
 };
 /**
  * For UX purpouses we let users pass messages as pathnames.
@@ -33,8 +33,8 @@ export type UserPathDefinitionTranslations<T extends string = string> = {
  * Does NOT perform any validation on if the user-provided path translation configuration is valid.
  *
  * @param userTranslations The user-provided path translation configuration.
- * @param availableLanguageTags The available language tags.
+ * @param availableLocales The available language tags.
  * @returns The resolved path translations.
  */
-export declare const resolveUserPathDefinitions: <T extends string>(userTranslations: UserPathDefinitionTranslations<T>, availableLanguageTags: readonly T[]) => PathDefinitionTranslations<T>;
+export declare const resolveUserPathDefinitions: <T extends string>(userTranslations: UserPathDefinitionTranslations<T>, availableLocales: readonly T[]) => PathDefinitionTranslations<T>;
 //# sourceMappingURL=resolveUserPathDefinitions.d.ts.map

package/dist/adapter-utils/routing/resolveUserPathDefinitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveUserPathDefinitions.d.ts","sourceRoot":"","sources":["../../../src/adapter-utils/routing/resolveUserPathDefinitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACvE,CAAC,aAAa,EAAE,IAAI,MAAM,EAAE,GACzB,MAAM,CAAC,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC,GACvB,oBAAoB,CAAC,CAAC,CAAC,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,MAAM,oBACxC,8BAA8B,CAAC,CAAC,CAAC,yBAC5B,SAAS,CAAC,EAAE,KACjC,0BAA0B,CAAC,CAAC,CAQ7B,CAAC"}
+{"version":3,"file":"resolveUserPathDefinitions.d.ts","sourceRoot":"","sources":["../../../src/adapter-utils/routing/resolveUserPathDefinitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACvE,CAAC,aAAa,EAAE,IAAI,MAAM,EAAE,GACzB,MAAM,CAAC,CAAC,EAAE,IAAI,MAAM,EAAE,CAAC,GACvB,qBAAqB,CAAC,CAAC,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,CAAC,SAAS,MAAM,oBACxC,8BAA8B,CAAC,CAAC,CAAC,oBACjC,SAAS,CAAC,EAAE,KAC5B,0BAA0B,CAAC,CAAC,CAQ7B,CAAC"}

package/dist/adapter-utils/routing/resolveUserPathDefinitions.js

@@ -7,16 +7,13 @@
  * Does NOT perform any validation on if the user-provided path translation configuration is valid.
  *
  * @param userTranslations The user-provided path translation configuration.
- * @param availableLanguageTags The available language tags.
+ * @param availableLocales The available language tags.
  * @returns The resolved path translations.
  */
-export const resolveUserPathDefinitions = (userTranslations, availableLanguageTags) => Object.fromEntries(Object.entries(userTranslations).map(([path, translation]) => [
+export const resolveUserPathDefinitions = (userTranslations, availableLocales) => Object.fromEntries(Object.entries(userTranslations).map(([path, translation]) => [
     path,
     typeof translation === "object"
         ? translation
-        : fromMessage(translation, availableLanguageTags),
-]));
-const fromMessage = (message, availableLanguageTags) => Object.fromEntries(availableLanguageTags.map((languageTag) => [
-    languageTag,
-    message({}, { languageTag }),
+        : fromMessage(translation, availableLocales),
 ]));
+const fromMessage = (message, availableLocales) => Object.fromEntries(availableLocales.map((locale) => [locale, message({}, { locale })]));

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

@@ -1,6 +1,2 @@
-export declare const paraglideRollupPlugin: (options: {
-    project: string;
-    outdir: string;
-    compilerOptions?: import("../compiler/compileProject.js").ParaglideCompilerOptions;
-}) => import("unplugin").RollupPlugin<any> | import("unplugin").RollupPlugin<any>[];
+export declare const paraglideRollupPlugin: (options: import("../index.js").CompilerArgs) => import("unplugin").RollupPlugin<any> | import("unplugin").RollupPlugin<any>[];
 //# sourceMappingURL=rollup.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/rollup.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB;;;;mFAAsC,CAAC"}
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/rollup.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,gIAAsC,CAAC"}

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

@@ -1,18 +1,4 @@
 import type { UnpluginFactory } from "unplugin";
-import type { ParaglideCompilerOptions } from "../compiler/compileProject.js";
-export declare const unpluginFactory: UnpluginFactory<{
-    /**
-     * The path to the inlang project.
-     *
-     * @example "./project.inlang"
-     */
-    project: string;
-    /**
-     * The path to the output directory.
-     *
-     * @example "./src/paraglide"
-     */
-    outdir: string;
-    compilerOptions?: ParaglideCompilerOptions;
-}>;
+import { type CompilerArgs } from "../compiler/compile.js";
+export declare const unpluginFactory: UnpluginFactory<CompilerArgs>;
 //# sourceMappingURL=unplugin.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"unplugin.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/unplugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAO9E,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC;IAC7C;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,wBAAwB,CAAC;CAC3C,CAwCC,CAAC"}
+{"version":3,"file":"unplugin.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/unplugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAMpE,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,YAAY,CAwCxD,CAAC"}

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

@@ -1,6 +1,2 @@
-export declare const paraglideVitePlugin: (options: {
-    project: string;
-    outdir: string;
-    compilerOptions?: import("../compiler/compileProject.js").ParaglideCompilerOptions;
-}) => import("vite").Plugin<any> | import("vite").Plugin<any>[];
+export declare const paraglideVitePlugin: (options: import("../index.js").CompilerArgs) => import("vite").Plugin<any> | import("vite").Plugin<any>[];
 //# sourceMappingURL=vite.d.ts.map

package/dist/bundler-plugins/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/vite.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB;;;;+DAAoC,CAAC"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../src/bundler-plugins/vite.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,4GAAoC,CAAC"}

package/dist/compiler/compile.d.ts

@@ -1,4 +1,30 @@
-import { type ParaglideCompilerOptions } from "./compileProject.js";
+import { type CompilerOptions } from "./compileProject.js";
+export type CompilerArgs = {
+    /**
+     * The path to the project to compile.
+     *
+     * @example
+     *   './project.inlang'
+     */
+    project: string;
+    /**
+     * The path to the directory to write the output to.
+     *
+     * @example
+     *   './src/paraglide'
+     */
+    outdir: string;
+    /**
+     * Additional compiler options.
+     */
+    compilerOptions?: CompilerOptions;
+    /**
+     * The file system to use. Defaults to `await import('node:fs')`.
+     *
+     * Useful for testing the paraglide compiler by mocking the fs.
+     */
+    fs?: typeof import("node:fs");
+};
 /**
  * Loads, compiles, and writes the output to disk.
  *
@@ -12,10 +38,5 @@ import { type ParaglideCompilerOptions } from "./compileProject.js";
  *     outdir: 'path/to/output',
  *   })
  */
-export declare function compile(args: {
-    project: string;
-    outdir: string;
-    fs?: typeof import("node:fs");
-    compilerOptions?: ParaglideCompilerOptions;
-}): Promise<void>;
+export declare function compile(args: CompilerArgs): Promise<void>;
 //# sourceMappingURL=compile.d.ts.map

package/dist/compiler/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/compiler/compile.ts"],"names":[],"mappings":"AAGA,OAAO,EAEN,KAAK,wBAAwB,EAC7B,MAAM,qBAAqB,CAAC;AAO7B;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,cAAc,SAAS,CAAC,CAAC;IAC9B,eAAe,CAAC,EAAE,wBAAwB,CAAC;CAC3C,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhB"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/compiler/compile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAO3E,MAAM,MAAM,YAAY,GAAG;IAC1B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;OAIG;IACH,EAAE,CAAC,EAAE,cAAc,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B/D"}

package/dist/compiler/compile.js

@@ -1,7 +1,7 @@
 import { loadProjectFromDirectory } from "@inlang/sdk";
 import path from "node:path";
 import { ENV_VARIABLES } from "../services/env-variables/index.js";
-import { compileProject, } from "./compileProject.js";
+import { compileProject } from "./compileProject.js";
 import { writeOutput } from "../services/file-handling/write-output.js";
 import { getLocalAccount, saveLocalAccount, } from "../services/account/index.js";
 /**

package/dist/compiler/compileBundle.js

@@ -10,7 +10,7 @@ export const compileBundle = (args) => {
     const compiledMessages = {};
     for (const message of args.bundle.messages) {
         if (compiledMessages[message.locale]) {
-            throw new Error(`Duplicate language tag: ${message.locale}`);
+            throw new Error(`Duplicate locale: ${message.locale}`);
         }
         const compiledMessage = compileMessage(args.bundle.declarations, message, message.variants, args.registry);
         // add types to the compiled message function
@@ -48,7 +48,7 @@ const compileBundleFunction = (args) => {
 */
 /* @__NO_SIDE_EFFECTS__ */
 const ${jsIdentifier(args.bundle.id)} = (inputs${emitTs ? tsInputType(inputs) : ""} ${hasInputs ? "" : "= {}"}, options${emitTs ? tsOptionsType(args.availableLocales) : ""} = {}) ${emitTs ? ": string" : ""} => {
-	const locale = options.locale ?? options.languageTag ?? getLocale()
+	const locale = options.locale ?? getLocale()
 	${args.availableLocales
         .map((locale, index) => `${index > 0 ? "	" : ""}if (locale === "${locale}") return ${jsIdentifier(locale)}.${args.bundle.id}(inputs)`)
         .join("\n")}
@@ -69,7 +69,7 @@ const ${jsIdentifier(args.bundle.id)} = (inputs${emitTs ? tsInputType(inputs) :
 };
 function tsOptionsType(locales) {
     const localesUnion = locales.map((locale) => `"${locale}"`).join(" | ");
-    return `: { locale?: ${localesUnion},/** @deprecated use \`locale\` instead */languageTag?: ${localesUnion} }`;
+    return `: { locale?: ${localesUnion} }`;
 }
 function tsInputType(inputs) {
     const inputParams = inputs

package/dist/compiler/compileBundle.test.js

@@ -20,8 +20,8 @@ test("compiles as ts", async () => {
 * 
 */
 /* @__NO_SIDE_EFFECTS__ */
-const blue_moon_bottle = (inputs: { age: NonNullable<unknown> } , options: { locale?: "en" | "en-US",/** @deprecated use \`locale\` instead */languageTag?: "en" | "en-US" } = {}) : string => {
-	const locale = options.locale ?? options.languageTag ?? getLocale()
+const blue_moon_bottle = (inputs: { age: NonNullable<unknown> } , options: { locale?: "en" | "en-US" } = {}) : string => {
+	const locale = options.locale ?? getLocale()
 	if (locale === "en") return en.blue_moon_bottle(inputs)
 	if (locale === "en-US") return en_US.blue_moon_bottle(inputs)
 	return "blue_moon_bottle"

package/dist/compiler/compileProject.d.ts

@@ -1,5 +1,5 @@
 import { type InlangProject } from "@inlang/sdk";
-export type ParaglideCompilerOptions = {
+export type CompilerOptions = {
     /**
      * Whether to emit TypeScript files instead of JSDoc annotated JavaScript.
      *
@@ -55,7 +55,7 @@ export type ParaglideCompilerOptions = {
  */
 export declare const compileProject: (args: {
     project: InlangProject;
-    compilerOptions?: ParaglideCompilerOptions;
+    compilerOptions?: CompilerOptions;
 }) => Promise<Record<string, string>>;
 export declare function getFallbackMap<T extends string>(locales: T[], baseLocale: NoInfer<T>): Record<T, T | undefined>;
 //# sourceMappingURL=compileProject.d.ts.map

package/dist/compiler/compileProject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compileProject.d.ts","sourceRoot":"","sources":["../../src/compiler/compileProject.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKrE,MAAM,MAAM,wBAAwB,GAAG;IACtC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;;;;;;;;;OAgBG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;CACvD,CAAC;AAUF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,SAAgB;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,wBAAwB,CAAC;CAC3C,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4DjC,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GACpB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAY1B"}
+{"version":3,"file":"compileProject.d.ts","sourceRoot":"","sources":["../../src/compiler/compileProject.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKrE,MAAM,MAAM,eAAe,GAAG;IAC7B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;;;;;;;;;;;;OAgBG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;CACvD,CAAC;AAUF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,SAAgB;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,CAAC,EAAE,eAAe,CAAC;CAClC,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4DjC,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,CAAC,EAAE,EACZ,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GACpB,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAY1B"}

package/dist/compiler/compileProject.test.js

@@ -1,7 +1,7 @@
 import { expect, test, describe, vi, beforeEach } from "vitest";
 import { createProject as typescriptProject, ts } from "@ts-morph/bootstrap";
 import { Declaration, insertBundleNested, loadProjectInMemory, newProject, Pattern, VariableReference, } from "@inlang/sdk";
-import { compileProject, } from "./compileProject.js";
+import { compileProject } from "./compileProject.js";
 import virtual from "@rollup/plugin-virtual";
 import { rolldown } from "rolldown";
 beforeEach(() => {
@@ -183,16 +183,16 @@ describe.each([
             expect(cb2).toHaveBeenCalledTimes(1);
             expect(cb1).toHaveBeenCalledTimes(1);
         });
-        test("should return the correct message if a languageTag is set in the message options", async () => {
+        test("should return the correct message if a locale is set in the message options", async () => {
             const { m, runtime } = await importCode(code);
             // set the language tag to de to make sure that the message options override the runtime language tag
-            runtime.setLanguageTag("de");
+            runtime.setLocale("de");
             expect(m.sad_penguin_bundle()).toBe("Eine einfache Nachricht.");
-            expect(m.sad_penguin_bundle(undefined, { languageTag: "en" })).toBe("A simple message.");
+            expect(m.sad_penguin_bundle(undefined, { locale: "en" })).toBe("A simple message.");
         });
         test("runtime.isAvailableLocale should only return `true` if a locale is passed to it", async () => {
             const { runtime } = await importCode(code);
-            for (const tag of runtime.availableLanguageTags) {
+            for (const tag of runtime.availableLocales) {
                 expect(runtime.isAvailableLocale(tag)).toBe(true);
             }
             expect(runtime.isAvailableLocale("")).toBe(false);
@@ -334,62 +334,6 @@ describe.each([
         }
         expect(diagnostics.length).toEqual(0);
     });
-    // remove with v3 of paraglide js
-    test("./runtime.js (legacy) types", async () => {
-        const project = await typescriptProject({
-            useInMemoryFileSystem: true,
-            compilerOptions: {
-                outDir: "dist",
-                declaration: true,
-                allowJs: true,
-                checkJs: true,
-                module: ts.ModuleKind.Node16,
-                strict: true,
-            },
-        });
-        for (const [fileName, code] of Object.entries(output)) {
-            if (fileName.endsWith(".js") || fileName.endsWith(".ts")) {
-                project.createSourceFile(fileName, code);
-            }
-        }
-        project.createSourceFile("test.ts", `
-    import * as runtime from "./runtime.js"
-
-    // --------- RUNTIME ---------
-
-    // sourceLanguageTag should have a narrow type, not a generic string
-
-    runtime.sourceLanguageTag satisfies "en"
-
-    // availableLanguageTags should have a narrow type, not a generic string
-    runtime.availableLanguageTags satisfies Readonly<Array<"de" | "en" | "en-US">>
-
-    // setLanguageTag() should fail if the given language tag is not included in availableLanguageTags
-    // @ts-expect-error
-    runtime.setLanguageTag("fr")
-
-    // setLanguageTag() should not fail if the given language tag is included in availableLanguageTags
-    runtime.setLanguageTag("de")
-
-    // languageTag should return type should be a union of language tags, not a generic string
-    runtime.languageTag() satisfies "de" | "en" | "en-US"
-
-		// isAvailableLocale should narrow the type of it's argument
-		const thing = 5;
-		if(runtime.isAvailableLocale(thing)) {
-			const a : "de" | "en" | "en-US" = thing
-		} else {
-			// @ts-expect-error - thing is not a language tag
-			const a : "de" | "en" | "en-US" = thing
-		}
-  `);
-        const program = project.createProgram();
-        const diagnostics = ts.getPreEmitDiagnostics(program);
-        for (const diagnostic of diagnostics) {
-            console.error(diagnostic.messageText, diagnostic.file?.fileName);
-        }
-        expect(diagnostics.length).toEqual(0);
-    });
     test("./messages.js types", async () => {
         const project = await typescriptProject({
             useInMemoryFileSystem: true,
@@ -425,15 +369,15 @@ describe.each([
     m.sad_penguin_bundle() satisfies string
 
 		// --------- MESSAGE OPTIONS ---------
-		// the languageTag option should be optional
+		// the locale option should be optional
 		m.sad_penguin_bundle({}, {}) satisfies string
 
-		// the languageTag option should be allowed
-		m.sad_penguin_bundle({}, { languageTag: "en" }) satisfies string
+		// the locale option should be allowed
+		m.sad_penguin_bundle({}, { locale: "en" }) satisfies string
 
-		// the languageTag option must be a valid language tag
+		// the locale option must be a valid language tag
 		// @ts-expect-error - invalid language tag
-		m.sad_penguin_bundle({}, { languageTag: "---" })
+		m.sad_penguin_bundle({}, { locale: "---" })
   `);
         const program = project.createProgram();
         const diagnostics = ts.getPreEmitDiagnostics(program);

package/dist/compiler/emit-dts.d.ts

@@ -0,0 +1,7 @@
+import type { CompiledBundleWithMessages } from "./compileBundle.js";
+/**
+ * @param inputFiles The files in the `outdir`
+ * @returns .d.ts files for each file in the `outdir`
+ */
+export declare function emitDts(compiledBundles: CompiledBundleWithMessages[], compiledRuntime: string, compiledRegistry: string): Record<string, string>;
+//# sourceMappingURL=emit-dts.d.ts.map

package/dist/compiler/emit-dts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-dts.d.ts","sourceRoot":"","sources":["../../src/compiler/emit-dts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;GAGG;AACH,wBAAgB,OAAO,CACtB,eAAe,EAAE,0BAA0B,EAAE,EAC7C,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyCxB"}

package/dist/compiler/emit-dts.js

@@ -0,0 +1,56 @@
+import { createProgram, createCompilerHost, } from "typescript";
+/**
+ * @param inputFiles The files in the `outdir`
+ * @returns .d.ts files for each file in the `outdir`
+ */
+export function emitDts(compiledBundles, compiledRuntime, compiledRegistry) {
+    /**
+     * Stores files that were emitted as `.d.ts` files during the output.
+     * @example
+     * ```js
+     * {
+     *      "paraglide/runtime.d.ts": "export type AvailableLanguageTag = ...",
+     *      "paragildes/messages.d.ts": "...",
+     * }
+     * ```
+     */
+    const outputFiles = {};
+    const host = createCompilerHost(compilerOptions);
+    const inputFiles = {
+        "messages.js": compiledBundles
+            .map((compiled) => compiled.bundle.code)
+            .join("\n"),
+        "registry.js": compiledRegistry,
+        "runtime.js": compiledRuntime,
+    };
+    // A list of input paths for the compiler
+    const inputs = Object.keys(inputFiles);
+    // intercept read/write methods of the compiler
+    host.writeFile = (path, contents) => (outputFiles[path] = contents);
+    host.readFile = (path) => inputFiles[path];
+    // run the TS compiler
+    // this will cause `host.writeFile` to be called
+    // our output files are in `outputFiles` after this
+    const program = createProgram(inputs, compilerOptions, host);
+    program.emit();
+    const output = {};
+    for (const [path, content] of Object.entries(outputFiles)) {
+        output[path] = `/* eslint-disable */\n` + content;
+    }
+    return output;
+}
+/**
+ * TypeScript compiler options
+ */
+const compilerOptions = {
+    allowJs: true,
+    checkJs: true,
+    declaration: true,
+    declarationDir: undefined,
+    declarationMap: false,
+    emitDeclarationOnly: true,
+    lib: undefined,
+    noEmit: false,
+    noEmitOnError: false,
+    skipLibCheck: true,
+};

package/dist/compiler/index.d.ts

@@ -1,3 +1,5 @@
+export type { CompilerArgs } from "./compile.js";
+export type { CompilerOptions } from "./compileProject.js";
 export { compile } from "./compile.js";
 export { compileProject } from "./compileProject.js";
 export { compileBundle } from "./compileBundle.js";

package/dist/compiler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/compiler/jsDocComment.d.ts

@@ -0,0 +1,9 @@
+import type { InputVariable } from "@inlang/sdk";
+export declare function jsDocBundleComment(args: {
+    inputs: InputVariable[];
+    locales: string[];
+}): string;
+export declare function jsDocMessageComment(args: {
+    inputs: InputVariable[];
+}): string;
+//# sourceMappingURL=jsDocComment.d.ts.map

package/dist/compiler/jsDocComment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsDocComment.d.ts","sourceRoot":"","sources":["../../src/compiler/jsDocComment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,MAAM,CAqBT;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,GAAG,MAAM,CAU7E"}

package/dist/compiler/jsDocComment.js

@@ -0,0 +1,30 @@
+export function jsDocBundleComment(args) {
+    const inputParams = args.inputs
+        .map((input) => {
+        return `${input.name}: NonNullable<unknown>`;
+    })
+        .join(", ");
+    const localesUnion = args.locales.map((locale) => `"${locale}"`).join(" | ");
+    return `/**
+* This function has been compiled by [Paraglide JS](https://inlang.com/m/gerre34r).
+*
+* - Changing this function will be over-written by the next build.
+*
+* - If you want to change the translations, you can either edit the source files e.g. \`en.json\`, or
+* use another inlang app like [Fink](https://inlang.com/m/tdozzpar) or the [VSCode extension Sherlock](https://inlang.com/m/r7kp499g).
+*
+* @param {{ ${inputParams} }} inputs
+* @param {{ locale?: ${localesUnion}, languageTag?: ${localesUnion} }} options
+* @returns {string}
+*/`;
+}
+export function jsDocMessageComment(args) {
+    const inputParams = args.inputs
+        .map((input) => {
+        return `${input.name}: NonNullable<unknown>`;
+    })
+        .join(", ");
+    return `/**
+* @param {{ ${inputParams} }} i
+*/`;
+}

package/dist/compiler/jsdoc-types.js

@@ -7,7 +7,7 @@ export function jsDocBundleFunctionTypes(args) {
     const localesUnion = args.locales.map((locale) => `"${locale}"`).join(" | ");
     return `
 * @param {{ ${inputParams} }} inputs
-* @param {{ locale?: ${localesUnion}, languageTag?: ${localesUnion} }} options
+* @param {{ locale?: ${localesUnion} }} options
 * @returns {string}
 `;
 }

package/dist/compiler/runtime.js

@@ -136,31 +136,6 @@ export function isAvailableLocale(locale) {
  *
  * @typedef {(typeof availableLocales)[number]} AvailableLocale
  */
-
-// ------ LEGACY RUNTIME (will be removed in the next major version) ------
-
-/** @deprecated Use \`baseLocale\` instead */
-export const sourceLanguageTag = baseLocale;
-
-/** @deprecated Use \`availableLocales\` instead */
-export const availableLanguageTags = availableLocales;
-
-/** @deprecated Use \`getLocale()\` instead */
-export let languageTag = getLocale;
-
-/** @deprecated Use \`setLocale()\` instead */
-export const setLanguageTag = setLocale;
-
-/**
- * @deprecated Use \`isAvailableLocale()\` instead
- * @returns {thing is AvailableLanguageTag}
- */
-export const isAvailableLanguageTag = isAvailableLocale;
-
-/**
- * @deprecated Use \`AvailableLocale\` instead
- * @typedef {(typeof availableLocales)[number]} AvailableLanguageTag
- */
 `;
 const tsRuntime = (settings) => `
 /* eslint-disable */
@@ -279,28 +254,4 @@ export function isAvailableLocale(locale: any): locale is AvailableLocale {
  *
  */
 export type AvailableLocale = (typeof availableLocales)[number];
-
-// ------ LEGACY RUNTIME (will be removed in the next major version) ------
-
-/** @deprecated Use \`baseLocale\` instead */
-export const sourceLanguageTag = baseLocale;
-
-/** @deprecated Use \`availableLocales\` instead */
-export const availableLanguageTags = availableLocales;
-
-/** @deprecated Use \`getLocale()\` instead */
-export let languageTag = getLocale;
-
-/** @deprecated Use \`setLocale()\` instead */
-export const setLanguageTag = setLocale;
-
-/**
- * @deprecated Use \`isAvailableLocale()\` instead
- */
-export const isAvailableLanguageTag = isAvailableLocale;
-
-/**
- * @deprecated Use \`AvailableLocale\` instead
- */
-export type AvailableLanguageTag = AvailableLocale;
 `;

package/dist/compiler/types.d.ts

@@ -4,6 +4,23 @@ export type Compiled<Node> = {
     /** The code generated to implement the AST node */
     code: string;
 };
+/**
+ * A message function that takes inputs and returns a message.
+ *
+ * @example
+ *   import
+ */
+export type MessageFunction = (inputs?: Record<string, never>) => string;
+/**
+ * A message bundle function.
+ *
+ * @example
+ *   import * as m from './messages.js'
+ *   m.hello({ name: 'world', { locale: "en" } })
+ */
+export type MessageBundleFunction<T extends string> = (params: Record<string, never>, options: {
+    locale: T;
+}) => string;
 /**
  * Attempts to merge type restrictions from two variants.
  */

package/dist/compiler/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,IAAI,IAAI;IAC5B,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,IAAI,IAAI;IAC5B,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,MAAM,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,MAAM,IAAI,CACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,OAAO,EAAE;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,KAClB,MAAM,CAAC;AAEZ;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBxB"}

package/dist/index.d.ts

@@ -1,7 +1,3 @@
-export type MessageIndexFunction<T extends string> = (params: Record<string, never>, options: {
-    languageTag: T;
-}) => string;
-export type MessageFunction = (params?: Record<string, never>) => string;
-export { paraglideVitePlugin } from "./bundler-plugins/vite.js";
-export { paraglideRollupPlugin } from "./bundler-plugins/rollup.js";
+export * from "./bundler-plugins/index.js";
+export * from "./compiler/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,MAAM,IAAI,CACpD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC7B,OAAO,EAAE;IAAE,WAAW,EAAE,CAAC,CAAA;CAAE,KACvB,MAAM,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,MAAM,CAAC;AAEzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { paraglideVitePlugin } from "./bundler-plugins/vite.js";
-export { paraglideRollupPlugin } from "./bundler-plugins/rollup.js";
+export * from "./bundler-plugins/index.js";
+export * from "./compiler/index.js";

package/dist/services/env-variables/index.js

@@ -1,5 +1,5 @@
 export const ENV_VARIABLES = {
     PARJS_APP_ID: "library.inlang.paraglideJs",
     PARJS_POSTHOG_TOKEN: "phc_m5yJZCxjOGxF8CJvP5sQ3H0d76xpnLrsmiZHduT4jDz",
-    PARJS_PACKAGE_VERSION: "2.0.0-beta.8",
+    PARJS_PACKAGE_VERSION: "2.0.0-beta.9",
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inlang/paraglide-js",
   "type": "module",
-  "version": "2.0.0-beta.8",
+  "version": "2.0.0-beta.9",
   "license": "MIT",
   "publishConfig": {
     "access": "public",