@sebbro/paraglide-lite 0.1.0

package/dist/compiler/create-paraglide.js

@@ -0,0 +1,69 @@
+import { defaultCompilerOptions, } from "./compiler-options.js";
+import { createRuntimeFile } from "./runtime/create-runtime.js";
+import { createServerFile } from "./server/create-server-file.js";
+import { assertURLPatternAvailable } from "./assert-url-pattern-available.js";
+/**
+ * Creates an in-memory Paraglide module for use in tests and non-bundled environments.
+ *
+ * @example
+ *   const paraglide = await createParaglide({
+ *     baseLocale: "en",
+ *     locales: ["en", "de"],
+ *     strategy: ["cookie", "baseLocale"],
+ *   })
+ *
+ *   paraglide.localizeUrl("https://example.com", { locale: "de" })
+ *   app.use(paraglide.paraglideMiddleware())
+ */
+export async function createParaglide(args) {
+    const baseLocale = args.baseLocale;
+    const locales = args.locales;
+    if (!baseLocale) {
+        throw new Error("baseLocale is required");
+    }
+    if (!locales || locales.length === 0) {
+        throw new Error("At least one locale is required");
+    }
+    const needsUrlPattern = args.urlPatterns !== undefined ||
+        (args.routeStrategies?.length ?? 0) > 0;
+    if (needsUrlPattern) {
+        assertURLPatternAvailable();
+    }
+    const clientSideRuntime = createRuntimeFile({
+        baseLocale,
+        locales,
+        compilerOptions: {
+            ...defaultCompilerOptions,
+            ...args,
+        },
+    });
+    const serverSideRuntime = createServerFile({
+        compiledBundles: [],
+        compilerOptions: {
+            experimentalMiddlewareLocaleSplitting: args.experimentalMiddlewareLocaleSplitting ??
+                defaultCompilerOptions.experimentalMiddlewareLocaleSplitting,
+            disableAsyncLocalStorage: args.disableAsyncLocalStorage ??
+                defaultCompilerOptions.disableAsyncLocalStorage,
+        },
+    })
+        .replace(`import * as runtime from "./runtime.js";`, "")
+        .replaceAll("runtime.", "");
+    const mockMessageCode = `
+	export const m = new Proxy({}, {
+		get(target, prop) {
+			if (typeof prop === 'string' && prop !== 'then') {
+				throw new Error(
+					"Message functions are not available in createParaglide. " +
+					"Upvote and explain your use case in https://github.com/opral/inlang-paraglide-js/issues/471"
+				);
+			}
+			return undefined;
+		}
+	});`;
+    const combinedCode = clientSideRuntime + serverSideRuntime + mockMessageCode;
+    return await import(
+    /* @vite-ignore */
+    "data:text/javascript;base64," +
+        Buffer.from(combinedCode, "utf-8").toString("base64"));
+}
+//# sourceMappingURL=create-paraglide.js.map

package/dist/compiler/create-paraglide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-paraglide.js","sourceRoot":"","sources":["../../src/compiler/create-paraglide.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,sBAAsB,GAEtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAQ9E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,IAAyB;IAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAE7B,IAAI,CAAC,UAAU,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,eAAe,GACpB,IAAI,CAAC,WAAW,KAAK,SAAS;QAC9B,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAEzC,IAAI,eAAe,EAAE,CAAC;QACrB,yBAAyB,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,UAAU;QACV,OAAO;QACP,eAAe,EAAE;YAChB,GAAG,sBAAsB;YACzB,GAAG,IAAI;SACP;KACD,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;QAC1C,eAAe,EAAE,EAAE;QACnB,eAAe,EAAE;YAChB,qCAAqC,EACpC,IAAI,CAAC,qCAAqC;gBAC1C,sBAAsB,CAAC,qCAAqC;YAC7D,wBAAwB,EACvB,IAAI,CAAC,wBAAwB;gBAC7B,sBAAsB,CAAC,wBAAwB;SAChD;KACD,CAAC;SACA,OAAO,CAAC,0CAA0C,EAAE,EAAE,CAAC;SACvD,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE7B,MAAM,eAAe,GAAG;;;;;;;;;;;KAWpB,CAAC;IAEL,MAAM,YAAY,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAE7E,OAAO,MAAM,MAAM;IAClB,kBAAkB;IAClB,8BAA8B;QAC7B,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACtD,CAAC;AACH,CAAC","sourcesContent":["import type { Runtime } from \"./runtime/type.js\";\nimport type { ServerRuntime } from \"./server/type.js\";\nimport {\n\tdefaultCompilerOptions,\n\ttype CompilerOptions,\n} from \"./compiler-options.js\";\nimport { createRuntimeFile } from \"./runtime/create-runtime.js\";\nimport { createServerFile } from \"./server/create-server-file.js\";\nimport { assertURLPatternAvailable } from \"./assert-url-pattern-available.js\";\n\ntype CreateParaglideArgs = Pick<CompilerOptions, \"baseLocale\" | \"locales\"> &\n\tOmit<\n\t\tCompilerOptions,\n\t\t\"outdir\" | \"messages\" | \"fs\" | \"baseLocale\" | \"locales\"\n\t>;\n\n/**\n * Creates an in-memory Paraglide module for use in tests and non-bundled environments.\n *\n * @example\n *   const paraglide = await createParaglide({\n *     baseLocale: \"en\",\n *     locales: [\"en\", \"de\"],\n *     strategy: [\"cookie\", \"baseLocale\"],\n *   })\n *\n *   paraglide.localizeUrl(\"https://example.com\", { locale: \"de\" })\n *   app.use(paraglide.paraglideMiddleware())\n */\nexport async function createParaglide(\n\targs: CreateParaglideArgs\n): Promise<Runtime & ServerRuntime & { m: Record<string, unknown> }> {\n\tconst baseLocale = args.baseLocale;\n\tconst locales = args.locales;\n\n\tif (!baseLocale) {\n\t\tthrow new Error(\"baseLocale is required\");\n\t}\n\n\tif (!locales || locales.length === 0) {\n\t\tthrow new Error(\"At least one locale is required\");\n\t}\n\n\tconst needsUrlPattern =\n\t\targs.urlPatterns !== undefined ||\n\t\t(args.routeStrategies?.length ?? 0) > 0;\n\n\tif (needsUrlPattern) {\n\t\tassertURLPatternAvailable();\n\t}\n\n\tconst clientSideRuntime = createRuntimeFile({\n\t\tbaseLocale,\n\t\tlocales,\n\t\tcompilerOptions: {\n\t\t\t...defaultCompilerOptions,\n\t\t\t...args,\n\t\t},\n\t});\n\n\tconst serverSideRuntime = createServerFile({\n\t\tcompiledBundles: [],\n\t\tcompilerOptions: {\n\t\t\texperimentalMiddlewareLocaleSplitting:\n\t\t\t\targs.experimentalMiddlewareLocaleSplitting ??\n\t\t\t\tdefaultCompilerOptions.experimentalMiddlewareLocaleSplitting,\n\t\t\tdisableAsyncLocalStorage:\n\t\t\t\targs.disableAsyncLocalStorage ??\n\t\t\t\tdefaultCompilerOptions.disableAsyncLocalStorage,\n\t\t},\n\t})\n\t\t.replace(`import * as runtime from \"./runtime.js\";`, \"\")\n\t\t.replaceAll(\"runtime.\", \"\");\n\n\tconst mockMessageCode = `\n\texport const m = new Proxy({}, {\n\t\tget(target, prop) {\n\t\t\tif (typeof prop === 'string' && prop !== 'then') {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t\"Message functions are not available in createParaglide. \" +\n\t\t\t\t\t\"Upvote and explain your use case in https://github.com/opral/inlang-paraglide-js/issues/471\"\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn undefined;\n\t\t}\n\t});`;\n\n\tconst combinedCode = clientSideRuntime + serverSideRuntime + mockMessageCode;\n\n\treturn await import(\n\t\t/* @vite-ignore */\n\t\t\"data:text/javascript;base64,\" +\n\t\t\tBuffer.from(combinedCode, \"utf-8\").toString(\"base64\")\n\t);\n}\n"]}

package/dist/compiler/create-paraglide.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compiler/create-paraglide.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-paraglide.test.d.ts","sourceRoot":"","sources":["../../src/compiler/create-paraglide.test.ts"],"names":[],"mappings":""}

package/dist/compiler/create-paraglide.test.js

@@ -0,0 +1,55 @@
+import { test, expect } from "vitest";
+import { createParaglide } from "./create-paraglide.js";
+test("createParaglideModule should create a module with runtime and server functions", async () => {
+    const paraglide = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+    });
+    // Check that runtime properties are available
+    expect(paraglide.baseLocale).toBe("en");
+    expect(paraglide.locales).toEqual(["en", "de", "fr"]);
+    expect(typeof paraglide.localizeUrl).toBe("function");
+    expect(typeof paraglide.getLocale).toBe("function");
+    expect(typeof paraglide.setLocale).toBe("function");
+    // Check that server functions are available
+    expect(typeof paraglide.paraglideMiddleware).toBe("function");
+});
+test("createParaglideModule should allow configuring compiler options", async () => {
+    const paraglide = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+        strategy: ["url"],
+        cookieName: "custom-cookie",
+    });
+    // Check that compiler options are applied
+    expect(paraglide.strategy).toEqual(["url"]);
+    expect(paraglide.cookieName).toBe("custom-cookie");
+});
+test("createParaglideModule should work with URL localization", async () => {
+    const paraglide = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+        strategy: ["url"],
+    });
+    // Test URL localization
+    const url = "https://example.com/products";
+    const localizedUrl = paraglide.localizeUrl(url, { locale: "de" });
+    expect(localizedUrl.href).toBe("https://example.com/de/products");
+    // Test URL delocalization
+    const deLocalizedUrl = paraglide.deLocalizeUrl(localizedUrl);
+    expect(deLocalizedUrl.href).toBe(url);
+});
+test("createParaglideModule should provide mock message functions that throw helpful errors", async () => {
+    const paraglide = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de", "fr"],
+    });
+    // Verify m object exists
+    expect(paraglide.m).toBeDefined();
+    // Verify accessing a message function throws a helpful error
+    expect(() => {
+        // @ts-expect-error - We're testing runtime behavior
+        paraglide.m.someMessage();
+    }).toThrow(/Message functions are not available in createParaglide/);
+});
+//# sourceMappingURL=create-paraglide.test.js.map

package/dist/compiler/create-paraglide.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-paraglide.test.js","sourceRoot":"","sources":["../../src/compiler/create-paraglide.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { test, expect } from \"vitest\";\nimport { createParaglide } from \"./create-paraglide.js\";\n\ntest(\"createParaglideModule should create a module with runtime and server functions\", async () => {\n\tconst paraglide = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t});\n\n\t// Check that runtime properties are available\n\texpect(paraglide.baseLocale).toBe(\"en\");\n\texpect(paraglide.locales).toEqual([\"en\", \"de\", \"fr\"]);\n\texpect(typeof paraglide.localizeUrl).toBe(\"function\");\n\texpect(typeof paraglide.getLocale).toBe(\"function\");\n\texpect(typeof paraglide.setLocale).toBe(\"function\");\n\n\t// Check that server functions are available\n\texpect(typeof paraglide.paraglideMiddleware).toBe(\"function\");\n});\n\ntest(\"createParaglideModule should allow configuring compiler options\", async () => {\n\tconst paraglide = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t\tstrategy: [\"url\"],\n\t\tcookieName: \"custom-cookie\",\n\t});\n\n\t// Check that compiler options are applied\n\texpect(paraglide.strategy).toEqual([\"url\"]);\n\texpect(paraglide.cookieName).toBe(\"custom-cookie\");\n});\n\ntest(\"createParaglideModule should work with URL localization\", async () => {\n\tconst paraglide = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t\tstrategy: [\"url\"],\n\t});\n\n\t// Test URL localization\n\tconst url = \"https://example.com/products\";\n\tconst localizedUrl = paraglide.localizeUrl(url, { locale: \"de\" });\n\n\texpect(localizedUrl.href).toBe(\"https://example.com/de/products\");\n\n\t// Test URL delocalization\n\tconst deLocalizedUrl = paraglide.deLocalizeUrl(localizedUrl);\n\texpect(deLocalizedUrl.href).toBe(url);\n});\n\ntest(\"createParaglideModule should provide mock message functions that throw helpful errors\", async () => {\n\tconst paraglide = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t});\n\n\t// Verify m object exists\n\texpect(paraglide.m).toBeDefined();\n\n\t// Verify accessing a message function throws a helpful error\n\texpect(() => {\n\t\t// @ts-expect-error - We're testing runtime behavior\n\t\tparaglide.m.someMessage();\n\t}).toThrow(/Message functions are not available in createParaglide/);\n});\n"]}

package/dist/compiler/create-readme.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Creates the README.md content for the compiled output.
+ *
+ * This helps LLMs understand the compiled output.
+ * See https://llmstxt.org/ for the format guidelines.
+ */
+export declare function createReadme(args: {
+    sourceLabel?: string;
+}): string;

package/dist/compiler/create-readme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-readme.d.ts","sourceRoot":"","sources":["../../src/compiler/create-readme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAsKnE"}

package/dist/compiler/create-readme.js

@@ -0,0 +1,127 @@
+/**
+ * Creates the README.md content for the compiled output.
+ *
+ * This helps LLMs understand the compiled output.
+ * See https://llmstxt.org/ for the format guidelines.
+ */
+export function createReadme(args) {
+    const compiledFromLine = args.sourceLabel
+        ? `\nCompiled from: \`${args.sourceLabel}\`\n`
+        : "";
+    return `# paraglide-lite compiled output
+
+> Auto-generated i18n message functions. Import \`messages.js\` to use translated strings.
+${compiledFromLine}
+
+## What is this folder?
+
+This folder contains compiled [@sebbro/paraglide-lite](https://github.com/SebbeBroman/paraglide-js) output — an unofficial fork of Paraglide JS that compiles translation messages into tree-shakeable JavaScript functions without an inlang project.
+
+## At a glance
+
+Purpose:
+- This folder stores compiled i18n message functions.
+- Source translations live outside this folder (e.g. \`messages/{locale}.json\`).
+
+Safe to import:
+- \`messages.js\` — all message functions
+- \`runtime.js\` — locale utilities
+- \`server.js\` — server-side middleware
+
+Do not edit:
+- All files in this folder are auto-generated.
+- Changes will be overwritten on next compilation.
+
+\`\`\`
+paraglide/
+├── messages.js      # Message exports (import this)
+├── messages/        # Individual message functions
+├── runtime.js       # Locale detection & configuration
+├── registry.js      # Formatting utilities (plural, number, datetime, relativetime)
+├── server.js        # Server-side middleware
+└── .gitignore       # Marks folder as generated
+\`\`\`
+
+## Usage
+
+\`\`\`js
+import * as m from "./paraglide/messages.js";
+
+// Messages are functions that return localized strings
+m.hello_world();             // "Hello, World!" (in current locale)
+m.greeting({ name: "Sam" }); // "Hello, Sam!"
+
+// Override locale per-call
+m.hello_world({}, { locale: "de" });           // "Hallo, Welt!"
+m.greeting({ name: "Sam" }, { locale: "de" }); // "Hallo, Sam!"
+\`\`\`
+
+## Runtime API
+
+\`\`\`js
+import { getLocale, getTextDirection, setLocale, locales, baseLocale } from "./paraglide/runtime.js";
+
+getLocale();    // Current locale, e.g., "en"
+getTextDirection(); // "ltr" | "rtl" for current locale
+setLocale("de"); // Set locale
+locales;        // Available locales, e.g., ["en", "de", "fr"]
+baseLocale;     // Default locale, e.g., "en"
+\`\`\`
+
+## Strategy
+
+The strategy determines how the current locale is detected and persisted:
+
+- **Cookie**: Stores locale preference in a cookie.
+- **URL**: Derives locale from URL patterns (e.g., \`/en/about\`, \`en.example.com\`).
+- **GlobalVariable**: Uses a global variable (client-side only).
+- **BaseLocale**: Always returns the base locale.
+
+Strategies can be combined. The order defines precedence:
+
+\`\`\`js
+await compile({
+  messages: "./messages/{locale}.json",
+  locales: ["en", "de"],
+  baseLocale: "en",
+  outdir: "./src/paraglide",
+  strategy: ["url", "cookie", "baseLocale"],
+});
+\`\`\`
+
+## Markup (rich text)
+
+Messages can contain markup tags for bold, links, and other inline elements. Translators control where tags appear; developers control how they render.
+
+Important:
+- Tag names are app-defined. There is no built-in list of HTML tags.
+- \`{#b}...{/b}\` does not automatically render as \`<b>...</b>\`.
+- Renderers/snippets are looked up by the same tag name used in the message.
+
+### Message syntax
+
+\`\`\`json
+{
+  "cta": "{#link to=|/docs| rel=$relationship @track}Read the docs{/link}",
+  "welcome": "{#b}Hi {name}{/b}{#icon/}"
+}
+\`\`\`
+
+- \`{#tagName}\` opens a tag, \`{/tagName}\` closes it.
+- \`{#tagName/}\` creates a standalone tag.
+- Options: \`to=|/docs|\` or \`rel=$relationship\` (accessed via \`options.*\`).
+- Attributes: \`@track\` or \`@variant=|hero|\` (accessed via \`attributes.*\`).
+
+Calling the message function still returns **plain text** (markup stripped). To render markup, use \`message.parts()\`:
+
+\`\`\`js
+const parts = m.cta.parts({ relationship: "noopener" });
+\`\`\`
+
+## Links
+
+- Official Paraglide JS (recommended for most users): https://paraglidejs.com
+- This fork: https://github.com/SebbeBroman/paraglide-js
+`;
+}
+//# sourceMappingURL=create-readme.js.map

package/dist/compiler/create-readme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-readme.js","sourceRoot":"","sources":["../../src/compiler/create-readme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAA8B;IAC1D,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW;QACxC,CAAC,CAAC,sBAAsB,IAAI,CAAC,WAAW,MAAM;QAC9C,CAAC,CAAC,EAAE,CAAC;IAEN,OAAO;;;EAGN,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+GjB,CAAC;AACF,CAAC","sourcesContent":["/**\n * Creates the README.md content for the compiled output.\n *\n * This helps LLMs understand the compiled output.\n * See https://llmstxt.org/ for the format guidelines.\n */\nexport function createReadme(args: { sourceLabel?: string }): string {\n\tconst compiledFromLine = args.sourceLabel\n\t\t? `\\nCompiled from: \\`${args.sourceLabel}\\`\\n`\n\t\t: \"\";\n\n\treturn `# paraglide-lite compiled output\n\n> Auto-generated i18n message functions. Import \\`messages.js\\` to use translated strings.\n${compiledFromLine}\n\n## What is this folder?\n\nThis folder contains compiled [@sebbro/paraglide-lite](https://github.com/SebbeBroman/paraglide-js) output — an unofficial fork of Paraglide JS that compiles translation messages into tree-shakeable JavaScript functions without an inlang project.\n\n## At a glance\n\nPurpose:\n- This folder stores compiled i18n message functions.\n- Source translations live outside this folder (e.g. \\`messages/{locale}.json\\`).\n\nSafe to import:\n- \\`messages.js\\` — all message functions\n- \\`runtime.js\\` — locale utilities\n- \\`server.js\\` — server-side middleware\n\nDo not edit:\n- All files in this folder are auto-generated.\n- Changes will be overwritten on next compilation.\n\n\\`\\`\\`\nparaglide/\n├── messages.js      # Message exports (import this)\n├── messages/        # Individual message functions\n├── runtime.js       # Locale detection & configuration\n├── registry.js      # Formatting utilities (plural, number, datetime, relativetime)\n├── server.js        # Server-side middleware\n└── .gitignore       # Marks folder as generated\n\\`\\`\\`\n\n## Usage\n\n\\`\\`\\`js\nimport * as m from \"./paraglide/messages.js\";\n\n// Messages are functions that return localized strings\nm.hello_world();             // \"Hello, World!\" (in current locale)\nm.greeting({ name: \"Sam\" }); // \"Hello, Sam!\"\n\n// Override locale per-call\nm.hello_world({}, { locale: \"de\" });           // \"Hallo, Welt!\"\nm.greeting({ name: \"Sam\" }, { locale: \"de\" }); // \"Hallo, Sam!\"\n\\`\\`\\`\n\n## Runtime API\n\n\\`\\`\\`js\nimport { getLocale, getTextDirection, setLocale, locales, baseLocale } from \"./paraglide/runtime.js\";\n\ngetLocale();    // Current locale, e.g., \"en\"\ngetTextDirection(); // \"ltr\" | \"rtl\" for current locale\nsetLocale(\"de\"); // Set locale\nlocales;        // Available locales, e.g., [\"en\", \"de\", \"fr\"]\nbaseLocale;     // Default locale, e.g., \"en\"\n\\`\\`\\`\n\n## Strategy\n\nThe strategy determines how the current locale is detected and persisted:\n\n- **Cookie**: Stores locale preference in a cookie.\n- **URL**: Derives locale from URL patterns (e.g., \\`/en/about\\`, \\`en.example.com\\`).\n- **GlobalVariable**: Uses a global variable (client-side only).\n- **BaseLocale**: Always returns the base locale.\n\nStrategies can be combined. The order defines precedence:\n\n\\`\\`\\`js\nawait compile({\n  messages: \"./messages/{locale}.json\",\n  locales: [\"en\", \"de\"],\n  baseLocale: \"en\",\n  outdir: \"./src/paraglide\",\n  strategy: [\"url\", \"cookie\", \"baseLocale\"],\n});\n\\`\\`\\`\n\n## Markup (rich text)\n\nMessages can contain markup tags for bold, links, and other inline elements. Translators control where tags appear; developers control how they render.\n\nImportant:\n- Tag names are app-defined. There is no built-in list of HTML tags.\n- \\`{#b}...{/b}\\` does not automatically render as \\`<b>...</b>\\`.\n- Renderers/snippets are looked up by the same tag name used in the message.\n\n### Message syntax\n\n\\`\\`\\`json\n{\n  \"cta\": \"{#link to=|/docs| rel=$relationship @track}Read the docs{/link}\",\n  \"welcome\": \"{#b}Hi {name}{/b}{#icon/}\"\n}\n\\`\\`\\`\n\n- \\`{#tagName}\\` opens a tag, \\`{/tagName}\\` closes it.\n- \\`{#tagName/}\\` creates a standalone tag.\n- Options: \\`to=|/docs|\\` or \\`rel=$relationship\\` (accessed via \\`options.*\\`).\n- Attributes: \\`@track\\` or \\`@variant=|hero|\\` (accessed via \\`attributes.*\\`).\n\nCalling the message function still returns **plain text** (markup stripped). To render markup, use \\`message.parts()\\`:\n\n\\`\\`\\`js\nconst parts = m.cta.parts({ relationship: \"noopener\" });\n\\`\\`\\`\n\n## Links\n\n- Official Paraglide JS (recommended for most users): https://paraglidejs.com\n- This fork: https://github.com/SebbeBroman/paraglide-js\n`;\n}\n"]}

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

@@ -0,0 +1,15 @@
+import type { CompilerOptions } from "../compiler/compiler-options.js";
+export type EmitFiles = true | false | "types";
+/**
+ * Filters compiled output according to `emitFiles`.
+ *
+ * - `true` — write everything (default)
+ * - `"types"` — write `.d.ts` plus ignore/readme/package.json meta files
+ * - `false` — write nothing, except `.d.ts` when present (`emitTsDeclarations`)
+ */
+export declare function filterOutputForEmit(output: Record<string, string>, emitFiles: EmitFiles): Record<string, string>;
+/**
+ * Builds an absolute-path map of generated JS modules for virtual resolve/load.
+ */
+export declare function buildVirtualModules(outdir: string, output: Record<string, string>, cwd?: string): Map<string, string>;
+export declare function resolveEmitFiles(options: Pick<CompilerOptions, "emitFiles">): EmitFiles;

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit-files.d.ts","sourceRoot":"","sources":["../../src/compiler/emit-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC;AAS/C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,EAAE,SAAS,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAcD;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,GAAE,MAAsB,GACzB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAerB;AAED,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GACzC,SAAS,CAEX"}

package/dist/compiler/emit-files.js

@@ -0,0 +1,58 @@
+import path from "node:path";
+const META_FILES = new Set([
+    ".gitignore",
+    ".prettierignore",
+    "README.md",
+    "messages/package.json",
+]);
+/**
+ * Filters compiled output according to `emitFiles`.
+ *
+ * - `true` — write everything (default)
+ * - `"types"` — write `.d.ts` plus ignore/readme/package.json meta files
+ * - `false` — write nothing, except `.d.ts` when present (`emitTsDeclarations`)
+ */
+export function filterOutputForEmit(output, emitFiles) {
+    if (emitFiles === true) {
+        return output;
+    }
+    const filtered = {};
+    for (const [filePath, content] of Object.entries(output)) {
+        if (shouldEmitFile(filePath, emitFiles)) {
+            filtered[filePath] = content;
+        }
+    }
+    return filtered;
+}
+function shouldEmitFile(filePath, emitFiles) {
+    const normalized = filePath.replaceAll("\\", "/");
+    if (normalized.endsWith(".d.ts")) {
+        return true;
+    }
+    if (emitFiles === false) {
+        return false;
+    }
+    // emitFiles === "types"
+    return META_FILES.has(normalized);
+}
+/**
+ * Builds an absolute-path map of generated JS modules for virtual resolve/load.
+ */
+export function buildVirtualModules(outdir, output, cwd = process.cwd()) {
+    const absoluteOutdir = path.resolve(cwd, outdir);
+    const modules = new Map();
+    for (const [relativePath, content] of Object.entries(output)) {
+        const normalized = relativePath.replaceAll("\\", "/");
+        if (!normalized.endsWith(".js") &&
+            !normalized.endsWith(".mjs") &&
+            !normalized.endsWith(".cjs")) {
+            continue;
+        }
+        modules.set(path.resolve(absoluteOutdir, relativePath), content);
+    }
+    return modules;
+}
+export function resolveEmitFiles(options) {
+    return options.emitFiles ?? true;
+}
+//# sourceMappingURL=emit-files.js.map

package/dist/compiler/emit-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-files.js","sourceRoot":"","sources":["../../src/compiler/emit-files.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IAC1B,YAAY;IACZ,iBAAiB;IACjB,WAAW;IACX,uBAAuB;CACvB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAClC,MAA8B,EAC9B,SAAoB;IAEpB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,IAAI,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC;YACzC,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB,EAAE,SAAoB;IAC7D,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IACD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,wBAAwB;IACxB,OAAO,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,MAAc,EACd,MAA8B,EAC9B,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE;IAE3B,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACtD,IACC,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC3B,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC5B,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAC3B,CAAC;YACF,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC/B,OAA2C;IAE3C,OAAO,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;AAClC,CAAC","sourcesContent":["import path from \"node:path\";\nimport type { CompilerOptions } from \"../compiler/compiler-options.js\";\n\nexport type EmitFiles = true | false | \"types\";\n\nconst META_FILES = new Set([\n\t\".gitignore\",\n\t\".prettierignore\",\n\t\"README.md\",\n\t\"messages/package.json\",\n]);\n\n/**\n * Filters compiled output according to `emitFiles`.\n *\n * - `true` — write everything (default)\n * - `\"types\"` — write `.d.ts` plus ignore/readme/package.json meta files\n * - `false` — write nothing, except `.d.ts` when present (`emitTsDeclarations`)\n */\nexport function filterOutputForEmit(\n\toutput: Record<string, string>,\n\temitFiles: EmitFiles\n): Record<string, string> {\n\tif (emitFiles === true) {\n\t\treturn output;\n\t}\n\n\tconst filtered: Record<string, string> = {};\n\tfor (const [filePath, content] of Object.entries(output)) {\n\t\tif (shouldEmitFile(filePath, emitFiles)) {\n\t\t\tfiltered[filePath] = content;\n\t\t}\n\t}\n\treturn filtered;\n}\n\nfunction shouldEmitFile(filePath: string, emitFiles: EmitFiles): boolean {\n\tconst normalized = filePath.replaceAll(\"\\\\\", \"/\");\n\tif (normalized.endsWith(\".d.ts\")) {\n\t\treturn true;\n\t}\n\tif (emitFiles === false) {\n\t\treturn false;\n\t}\n\t// emitFiles === \"types\"\n\treturn META_FILES.has(normalized);\n}\n\n/**\n * Builds an absolute-path map of generated JS modules for virtual resolve/load.\n */\nexport function buildVirtualModules(\n\toutdir: string,\n\toutput: Record<string, string>,\n\tcwd: string = process.cwd()\n): Map<string, string> {\n\tconst absoluteOutdir = path.resolve(cwd, outdir);\n\tconst modules = new Map<string, string>();\n\tfor (const [relativePath, content] of Object.entries(output)) {\n\t\tconst normalized = relativePath.replaceAll(\"\\\\\", \"/\");\n\t\tif (\n\t\t\t!normalized.endsWith(\".js\") &&\n\t\t\t!normalized.endsWith(\".mjs\") &&\n\t\t\t!normalized.endsWith(\".cjs\")\n\t\t) {\n\t\t\tcontinue;\n\t\t}\n\t\tmodules.set(path.resolve(absoluteOutdir, relativePath), content);\n\t}\n\treturn modules;\n}\n\nexport function resolveEmitFiles(\n\toptions: Pick<CompilerOptions, \"emitFiles\">\n): EmitFiles {\n\treturn options.emitFiles ?? true;\n}\n"]}

package/dist/compiler/emit-files.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compiler/emit-files.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-files.test.d.ts","sourceRoot":"","sources":["../../src/compiler/emit-files.test.ts"],"names":[],"mappings":""}

package/dist/compiler/emit-files.test.js

@@ -0,0 +1,43 @@
+import { describe, expect, test } from "vitest";
+import { buildVirtualModules, filterOutputForEmit, } from "./emit-files.js";
+describe("filterOutputForEmit", () => {
+    const output = {
+        "runtime.js": "export {}",
+        "runtime.d.ts": "export {}",
+        "messages.js": "export {}",
+        "messages/package.json": '{"sideEffects":false}',
+        ".gitignore": "*",
+        "README.md": "# hi",
+        ".prettierignore": "*",
+    };
+    test("true keeps everything", () => {
+        expect(filterOutputForEmit(output, true)).toEqual(output);
+    });
+    test("types keeps declarations and meta", () => {
+        expect(filterOutputForEmit(output, "types")).toEqual({
+            "runtime.d.ts": "export {}",
+            "messages/package.json": '{"sideEffects":false}',
+            ".gitignore": "*",
+            "README.md": "# hi",
+            ".prettierignore": "*",
+        });
+    });
+    test("false keeps only d.ts", () => {
+        expect(filterOutputForEmit(output, false)).toEqual({
+            "runtime.d.ts": "export {}",
+        });
+    });
+});
+describe("buildVirtualModules", () => {
+    test("maps js files to absolute paths", () => {
+        const modules = buildVirtualModules("/out", {
+            "runtime.js": "a",
+            "messages/en.js": "b",
+            "runtime.d.ts": "c",
+        }, "/");
+        expect(modules.get("/out/runtime.js")).toBe("a");
+        expect(modules.get("/out/messages/en.js")).toBe("b");
+        expect(modules.has("/out/runtime.d.ts")).toBe(false);
+    });
+});
+//# sourceMappingURL=emit-files.test.js.map

package/dist/compiler/emit-files.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-files.test.js","sourceRoot":"","sources":["../../src/compiler/emit-files.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EACN,mBAAmB,EACnB,mBAAmB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACpC,MAAM,MAAM,GAAG;QACd,YAAY,EAAE,WAAW;QACzB,cAAc,EAAE,WAAW;QAC3B,aAAa,EAAE,WAAW;QAC1B,uBAAuB,EAAE,uBAAuB;QAChD,YAAY,EAAE,GAAG;QACjB,WAAW,EAAE,MAAM;QACnB,iBAAiB,EAAE,GAAG;KACtB,CAAC;IAEF,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACpD,cAAc,EAAE,WAAW;YAC3B,uBAAuB,EAAE,uBAAuB;YAChD,YAAY,EAAE,GAAG;YACjB,WAAW,EAAE,MAAM;YACnB,iBAAiB,EAAE,GAAG;SACtB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YAClD,cAAc,EAAE,WAAW;SAC3B,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACpC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG,mBAAmB,CAClC,MAAM,EACN;YACC,YAAY,EAAE,GAAG;YACjB,gBAAgB,EAAE,GAAG;YACrB,cAAc,EAAE,GAAG;SACnB,EACD,GAAG,CACH,CAAC;QACF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, test } from \"vitest\";\nimport {\n\tbuildVirtualModules,\n\tfilterOutputForEmit,\n} from \"./emit-files.js\";\n\ndescribe(\"filterOutputForEmit\", () => {\n\tconst output = {\n\t\t\"runtime.js\": \"export {}\",\n\t\t\"runtime.d.ts\": \"export {}\",\n\t\t\"messages.js\": \"export {}\",\n\t\t\"messages/package.json\": '{\"sideEffects\":false}',\n\t\t\".gitignore\": \"*\",\n\t\t\"README.md\": \"# hi\",\n\t\t\".prettierignore\": \"*\",\n\t};\n\n\ttest(\"true keeps everything\", () => {\n\t\texpect(filterOutputForEmit(output, true)).toEqual(output);\n\t});\n\n\ttest(\"types keeps declarations and meta\", () => {\n\t\texpect(filterOutputForEmit(output, \"types\")).toEqual({\n\t\t\t\"runtime.d.ts\": \"export {}\",\n\t\t\t\"messages/package.json\": '{\"sideEffects\":false}',\n\t\t\t\".gitignore\": \"*\",\n\t\t\t\"README.md\": \"# hi\",\n\t\t\t\".prettierignore\": \"*\",\n\t\t});\n\t});\n\n\ttest(\"false keeps only d.ts\", () => {\n\t\texpect(filterOutputForEmit(output, false)).toEqual({\n\t\t\t\"runtime.d.ts\": \"export {}\",\n\t\t});\n\t});\n});\n\ndescribe(\"buildVirtualModules\", () => {\n\ttest(\"maps js files to absolute paths\", () => {\n\t\tconst modules = buildVirtualModules(\n\t\t\t\"/out\",\n\t\t\t{\n\t\t\t\t\"runtime.js\": \"a\",\n\t\t\t\t\"messages/en.js\": \"b\",\n\t\t\t\t\"runtime.d.ts\": \"c\",\n\t\t\t},\n\t\t\t\"/\"\n\t\t);\n\t\texpect(modules.get(\"/out/runtime.js\")).toBe(\"a\");\n\t\texpect(modules.get(\"/out/messages/en.js\")).toBe(\"b\");\n\t\texpect(modules.has(\"/out/runtime.d.ts\")).toBe(false);\n\t});\n});\n"]}

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

@@ -0,0 +1,11 @@
+/**
+ * Generates `.d.ts` files for the compiled Paraglide output using the TypeScript compiler.
+ *
+ * @param output - The generated compiler output keyed by relative file path.
+ * @returns The generated declaration files keyed by relative path.
+ *
+ * @example
+ * const declarations = await emitTsDeclarations(output);
+ * // Merge them into the compiler output before writing to disk
+ */
+export declare function emitTsDeclarations(output: Record<string, string>): Promise<Record<string, string>>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit-ts-declarations.d.ts","sourceRoot":"","sources":["../../src/compiler/emit-ts-declarations.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoBjC"}

package/dist/compiler/emit-ts-declarations.interop.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compiler/emit-ts-declarations.interop.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-ts-declarations.interop.test.d.ts","sourceRoot":"","sources":["../../src/compiler/emit-ts-declarations.interop.test.ts"],"names":[],"mappings":""}

package/dist/compiler/emit-ts-declarations.interop.test.js

@@ -0,0 +1,33 @@
+import { expect, test, vi } from "vitest";
+import { createBundleNested } from "./test-helpers.js";
+import { compileProject } from "./compile-project.js";
+vi.mock("typescript", async () => {
+    const actual = await vi.importActual("typescript");
+    return {
+        default: actual,
+        createProgram: undefined,
+    };
+});
+test("emitTsDeclarations uses the compiler API for a default-only interop shape of TypeScript 5", async () => {
+    const bundles = [
+        createBundleNested({
+            id: "greeting.hello",
+            messages: [
+                {
+                    locale: "en",
+                    variants: [{ pattern: [{ type: "text", value: "Hello" }] }],
+                },
+            ],
+        }),
+    ];
+    const output = await compileProject({
+        bundles,
+        settings: { locales: ["en"], baseLocale: "en" },
+        compilerOptions: {
+            emitTsDeclarations: true,
+        },
+    });
+    expect(output).toHaveProperty("runtime.d.ts");
+    expect(output["messages/greeting_hello.d.ts"]).toContain(`export { greeting_hello as "greeting.hello" };`);
+});
+//# sourceMappingURL=emit-ts-declarations.interop.test.js.map

package/dist/compiler/emit-ts-declarations.interop.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-ts-declarations.interop.test.js","sourceRoot":"","sources":["../../src/compiler/emit-ts-declarations.interop.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;IAChC,MAAM,MAAM,GACX,MAAM,EAAE,CAAC,YAAY,CAA8B,YAAY,CAAC,CAAC;IAClE,OAAO;QACN,OAAO,EAAE,MAAM;QACf,aAAa,EAAE,SAAS;KACxB,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2FAA2F,EAAE,KAAK,IAAI,EAAE;IAC5G,MAAM,OAAO,GAAG;QACf,kBAAkB,CAAC;YAClB,EAAE,EAAE,gBAAgB;YACpB,QAAQ,EAAE;gBACT;oBACC,MAAM,EAAE,IAAI;oBACZ,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;iBAC3D;aACD;SACD,CAAC;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QACnC,OAAO;QACP,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE;QAC/C,eAAe,EAAE;YAChB,kBAAkB,EAAE,IAAI;SACxB;KACD,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,MAAM,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,CAAC,SAAS,CACvD,gDAAgD,CAChD,CAAC;AACH,CAAC,CAAC,CAAC","sourcesContent":["import { expect, test, vi } from \"vitest\";\nimport { createBundleNested } from \"./test-helpers.js\";\nimport { compileProject } from \"./compile-project.js\";\n\nvi.mock(\"typescript\", async () => {\n\tconst actual =\n\t\tawait vi.importActual<typeof import(\"typescript\")>(\"typescript\");\n\treturn {\n\t\tdefault: actual,\n\t\tcreateProgram: undefined,\n\t};\n});\n\ntest(\"emitTsDeclarations uses the compiler API for a default-only interop shape of TypeScript 5\", async () => {\n\tconst bundles = [\n\t\tcreateBundleNested({\n\t\t\tid: \"greeting.hello\",\n\t\t\tmessages: [\n\t\t\t\t{\n\t\t\t\t\tlocale: \"en\",\n\t\t\t\t\tvariants: [{ pattern: [{ type: \"text\", value: \"Hello\" }] }],\n\t\t\t\t},\n\t\t\t],\n\t\t}),\n\t];\n\n\tconst output = await compileProject({\n\t\tbundles,\n\t\tsettings: { locales: [\"en\"], baseLocale: \"en\" },\n\t\tcompilerOptions: {\n\t\t\temitTsDeclarations: true,\n\t\t},\n\t});\n\n\texpect(output).toHaveProperty(\"runtime.d.ts\");\n\texpect(output[\"messages/greeting_hello.d.ts\"]).toContain(\n\t\t`export { greeting_hello as \"greeting.hello\" };`\n\t);\n});\n"]}