@sebbro/paraglide-lite 0.1.0

package/dist/compiler/runtime/strategy.js

@@ -0,0 +1,65 @@
+/**
+ * @typedef {"cookie" | "baseLocale" | "globalVariable" | "url" | "preferredLanguage" | "localStorage"} BuiltInStrategy
+ */
+/**
+ * @typedef {`custom_${string}`} CustomStrategy
+ */
+/**
+ * @typedef {BuiltInStrategy | CustomStrategy} Strategy
+ */
+/**
+ * @typedef {Array<Strategy>} Strategies
+ */
+/**
+ * @typedef {{ getLocale: (request?: Request) => Promise<string | undefined> | (string | undefined) }} CustomServerStrategyHandler
+ */
+/**
+ * @typedef {{ getLocale: () => Promise<string|undefined> | (string | undefined), setLocale: (locale: string) => Promise<void> | void }} CustomClientStrategyHandler
+ */
+/** @type {Map<string, CustomServerStrategyHandler>} */
+export const customServerStrategies = new Map();
+/** @type {Map<string, CustomClientStrategyHandler>} */
+export const customClientStrategies = new Map();
+/**
+ * Checks if the given strategy is a custom strategy.
+ *
+ * @param {unknown} strategy The name of the custom strategy to validate.
+ * Must be a string that starts with "custom-" followed by alphanumeric characters, hyphens, or underscores.
+ * @returns {boolean} Returns true if it is a custom strategy, false otherwise.
+ */
+export function isCustomStrategy(strategy) {
+    return (typeof strategy === "string" && /^custom-[A-Za-z0-9_-]+$/.test(strategy));
+}
+/**
+ * Defines a custom strategy that is executed on the server.
+ *
+ * @see https://paraglidejs.com/strategy#write-your-own-strategy
+ *
+ * @param {string} strategy The name of the custom strategy to define. Must follow the pattern custom-name with alphanumeric characters, hyphens, or underscores.
+ * @param {CustomServerStrategyHandler} handler The handler for the custom strategy, which should implement
+ * the method getLocale.
+ * @returns {void}
+ */
+export function defineCustomServerStrategy(strategy, handler) {
+    if (!isCustomStrategy(strategy)) {
+        throw new Error(`Invalid custom strategy: "${strategy}". Must be a custom strategy following the pattern custom-name.`);
+    }
+    customServerStrategies.set(strategy, handler);
+}
+/**
+ * Defines a custom strategy that is executed on the client.
+ *
+ * @see https://paraglidejs.com/strategy#write-your-own-strategy
+ *
+ * @param {string} strategy The name of the custom strategy to define. Must follow the pattern custom-name with alphanumeric characters, hyphens, or underscores.
+ * @param {CustomClientStrategyHandler} handler The handler for the custom strategy, which should implement the
+ * methods getLocale and setLocale.
+ * @returns {void}
+ */
+export function defineCustomClientStrategy(strategy, handler) {
+    if (!isCustomStrategy(strategy)) {
+        throw new Error(`Invalid custom strategy: "${strategy}". Must be a custom strategy following the pattern custom-name.`);
+    }
+    customClientStrategies.set(strategy, handler);
+}
+//# sourceMappingURL=strategy.js.map

package/dist/compiler/runtime/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../src/compiler/runtime/strategy.js"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH;;GAEG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAE,CAAC;AAChD,uDAAuD;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAE,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAQ;IACxC,OAAO,CACN,OAAO,QAAQ,KAAK,QAAQ,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CACxE,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAQ,EAAE,OAAO;IAC3D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACd,6BAA6B,QAAQ,iEAAiE,CACtG,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAQ,EAAE,OAAO;IAC3D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACd,6BAA6B,QAAQ,iEAAiE,CACtG,CAAC;IACH,CAAC;IAED,sBAAsB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["/**\n * @typedef {\"cookie\" | \"baseLocale\" | \"globalVariable\" | \"url\" | \"preferredLanguage\" | \"localStorage\"} BuiltInStrategy\n */\n\n/**\n * @typedef {`custom_${string}`} CustomStrategy\n */\n\n/**\n * @typedef {BuiltInStrategy | CustomStrategy} Strategy\n */\n\n/**\n * @typedef {Array<Strategy>} Strategies\n */\n\n/**\n * @typedef {{ getLocale: (request?: Request) => Promise<string | undefined> | (string | undefined) }} CustomServerStrategyHandler\n */\n\n/**\n * @typedef {{ getLocale: () => Promise<string|undefined> | (string | undefined), setLocale: (locale: string) => Promise<void> | void }} CustomClientStrategyHandler\n */\n\n/** @type {Map<string, CustomServerStrategyHandler>} */\nexport const customServerStrategies = new Map();\n/** @type {Map<string, CustomClientStrategyHandler>} */\nexport const customClientStrategies = new Map();\n\n/**\n * Checks if the given strategy is a custom strategy.\n *\n * @param {unknown} strategy The name of the custom strategy to validate.\n * Must be a string that starts with \"custom-\" followed by alphanumeric characters, hyphens, or underscores.\n * @returns {boolean} Returns true if it is a custom strategy, false otherwise.\n */\nexport function isCustomStrategy(strategy) {\n\treturn (\n\t\ttypeof strategy === \"string\" && /^custom-[A-Za-z0-9_-]+$/.test(strategy)\n\t);\n}\n\n/**\n * Defines a custom strategy that is executed on the server.\n *\n * @see https://paraglidejs.com/strategy#write-your-own-strategy\n *\n * @param {string} strategy The name of the custom strategy to define. Must follow the pattern custom-name with alphanumeric characters, hyphens, or underscores.\n * @param {CustomServerStrategyHandler} handler The handler for the custom strategy, which should implement\n * the method getLocale.\n * @returns {void}\n */\nexport function defineCustomServerStrategy(strategy, handler) {\n\tif (!isCustomStrategy(strategy)) {\n\t\tthrow new Error(\n\t\t\t`Invalid custom strategy: \"${strategy}\". Must be a custom strategy following the pattern custom-name.`\n\t\t);\n\t}\n\n\tcustomServerStrategies.set(strategy, handler);\n}\n\n/**\n * Defines a custom strategy that is executed on the client.\n *\n * @see https://paraglidejs.com/strategy#write-your-own-strategy\n *\n * @param {string} strategy The name of the custom strategy to define. Must follow the pattern custom-name with alphanumeric characters, hyphens, or underscores.\n * @param {CustomClientStrategyHandler} handler The handler for the custom strategy, which should implement the\n * methods getLocale and setLocale.\n * @returns {void}\n */\nexport function defineCustomClientStrategy(strategy, handler) {\n\tif (!isCustomStrategy(strategy)) {\n\t\tthrow new Error(\n\t\t\t`Invalid custom strategy: \"${strategy}\". Must be a custom strategy following the pattern custom-name.`\n\t\t);\n\t}\n\n\tcustomClientStrategies.set(strategy, handler);\n}\n"]}

package/dist/compiler/runtime/strategy.test.d.ts

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

package/dist/compiler/runtime/strategy.test.d.ts.map

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

package/dist/compiler/runtime/strategy.test.js

@@ -0,0 +1,90 @@
+import { test, expect, describe, beforeEach } from "vitest";
+import { defineCustomServerStrategy, defineCustomClientStrategy, isCustomStrategy, } from "./strategy.js";
+import { createParaglide } from "../create-paraglide.js";
+describe("isCustomStrategy", () => {
+    test("returns true for valid custom strategy patterns", () => {
+        expect(isCustomStrategy("custom-header")).toBe(true);
+        expect(isCustomStrategy("custom-auth123")).toBe(true);
+        expect(isCustomStrategy("custom-API")).toBe(true);
+        expect(isCustomStrategy("custom-sessionStorage")).toBe(true);
+        expect(isCustomStrategy("custom-oAuth2")).toBe(true);
+        expect(isCustomStrategy("custom-a")).toBe(true);
+        expect(isCustomStrategy("custom-1")).toBe(true);
+        expect(isCustomStrategy("custom-Z")).toBe(true);
+        expect(isCustomStrategy("custom-9")).toBe(true);
+        expect(isCustomStrategy("custom-aZ19")).toBe(true);
+    });
+    test("returns false for invalid custom strategy patterns", () => {
+        expect(isCustomStrategy("")).toBe(false);
+        expect(isCustomStrategy("custom_")).toBe(false);
+        expect(isCustomStrategy("custom-")).toBe(false);
+        expect(isCustomStrategy("header")).toBe(false);
+        expect(isCustomStrategy("custom")).toBe(false);
+        // These are now valid with our relaxed pattern:
+        expect(isCustomStrategy("custom-invalid-name")).toBe(true);
+        expect(isCustomStrategy("custom-invalid_name")).toBe(true);
+        // But spaces and special chars are still invalid:
+        expect(isCustomStrategy("custom-invalid name")).toBe(false);
+        expect(isCustomStrategy("custom-invalid@")).toBe(false);
+        expect(isCustomStrategy("Custom-header")).toBe(false);
+        expect(isCustomStrategy("CUSTOM-header")).toBe(false);
+        expect(isCustomStrategy(null)).toBe(false);
+        expect(isCustomStrategy(undefined)).toBe(false);
+        expect(isCustomStrategy(123)).toBe(false);
+        expect(isCustomStrategy({})).toBe(false);
+        expect(isCustomStrategy([])).toBe(false);
+    });
+    test("returns false for built-in strategy names", () => {
+        expect(isCustomStrategy("cookie")).toBe(false);
+        expect(isCustomStrategy("baseLocale")).toBe(false);
+        expect(isCustomStrategy("globalVariable")).toBe(false);
+        expect(isCustomStrategy("url")).toBe(false);
+        expect(isCustomStrategy("preferredLanguage")).toBe(false);
+        expect(isCustomStrategy("localStorage")).toBe(false);
+    });
+});
+describe.each([
+    ["defineCustomServerStrategy", defineCustomServerStrategy],
+    ["defineCustomClientStrategy", defineCustomClientStrategy],
+])("%s", (strategyName, defineStrategy) => {
+    beforeEach(() => {
+        // Reset global variables before each test
+        if (typeof globalThis !== "undefined") {
+            // @ts-expect-error - Testing environment cleanup
+            delete globalThis.document;
+            // @ts-expect-error - Testing environment cleanup
+            delete globalThis.window;
+            // @ts-expect-error - Testing environment cleanup
+            delete globalThis.localStorage;
+            // @ts-expect-error - Testing environment cleanup
+            delete globalThis.navigator;
+        }
+    });
+    const defaultHandler = { getLocale: () => "en", setLocale: () => { } };
+    const invalidInputs = [
+        ["", "empty name"],
+        ["@invalid", "names with special characters (@)"],
+        ["invalid!", "names with special characters (!)"],
+        ["inva lid", "names with spaces"],
+    ];
+    test.each(invalidInputs)(`${strategyName} throws error for %s (%s)`, (input) => {
+        expect(() => defineStrategy(input, defaultHandler)).toThrow(`Invalid custom strategy: "${input}". Must be a custom strategy following the pattern custom-name.`);
+    });
+    test(`${strategyName} should compile with custom strategies in strategy array`, async () => {
+        // Test that compile accepts custom strategies
+        const runtime = await createParaglide({
+            baseLocale: "en",
+            locales: ["en", "de", "fr"],
+            strategy: ["custom-auth", "custom-header", "cookie", "baseLocale"],
+            cookieName: "PARAGLIDE_LOCALE",
+        });
+        // Verify the runtime contains the strategy array
+        expect(runtime.strategy).toEqual([
+            "custom-auth",
+            "custom-header",
+            "cookie",
+            "baseLocale",
+        ]);
+    });
+});
+//# sourceMappingURL=strategy.test.js.map

package/dist/compiler/runtime/strategy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.test.js","sourceRoot":"","sources":["../../../src/compiler/runtime/strategy.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { test, expect, describe, beforeEach } from \"vitest\";\nimport {\n\tdefineCustomServerStrategy,\n\tdefineCustomClientStrategy,\n\tisCustomStrategy,\n} from \"./strategy.js\";\nimport { createParaglide } from \"../create-paraglide.js\";\n\ndescribe(\"isCustomStrategy\", () => {\n\ttest(\"returns true for valid custom strategy patterns\", () => {\n\t\texpect(isCustomStrategy(\"custom-header\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-auth123\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-API\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-sessionStorage\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-oAuth2\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-a\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-1\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-Z\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-9\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-aZ19\")).toBe(true);\n\t});\n\n\ttest(\"returns false for invalid custom strategy patterns\", () => {\n\t\texpect(isCustomStrategy(\"\")).toBe(false);\n\t\texpect(isCustomStrategy(\"custom_\")).toBe(false);\n\t\texpect(isCustomStrategy(\"custom-\")).toBe(false);\n\t\texpect(isCustomStrategy(\"header\")).toBe(false);\n\t\texpect(isCustomStrategy(\"custom\")).toBe(false);\n\t\t// These are now valid with our relaxed pattern:\n\t\texpect(isCustomStrategy(\"custom-invalid-name\")).toBe(true);\n\t\texpect(isCustomStrategy(\"custom-invalid_name\")).toBe(true);\n\t\t// But spaces and special chars are still invalid:\n\t\texpect(isCustomStrategy(\"custom-invalid name\")).toBe(false);\n\t\texpect(isCustomStrategy(\"custom-invalid@\")).toBe(false);\n\t\texpect(isCustomStrategy(\"Custom-header\")).toBe(false);\n\t\texpect(isCustomStrategy(\"CUSTOM-header\")).toBe(false);\n\t\texpect(isCustomStrategy(null)).toBe(false);\n\t\texpect(isCustomStrategy(undefined)).toBe(false);\n\t\texpect(isCustomStrategy(123)).toBe(false);\n\t\texpect(isCustomStrategy({})).toBe(false);\n\t\texpect(isCustomStrategy([])).toBe(false);\n\t});\n\n\ttest(\"returns false for built-in strategy names\", () => {\n\t\texpect(isCustomStrategy(\"cookie\")).toBe(false);\n\t\texpect(isCustomStrategy(\"baseLocale\")).toBe(false);\n\t\texpect(isCustomStrategy(\"globalVariable\")).toBe(false);\n\t\texpect(isCustomStrategy(\"url\")).toBe(false);\n\t\texpect(isCustomStrategy(\"preferredLanguage\")).toBe(false);\n\t\texpect(isCustomStrategy(\"localStorage\")).toBe(false);\n\t});\n});\n\ndescribe.each([\n\t[\"defineCustomServerStrategy\", defineCustomServerStrategy],\n\t[\"defineCustomClientStrategy\", defineCustomClientStrategy],\n])(\"%s\", (strategyName, defineStrategy) => {\n\tbeforeEach(() => {\n\t\t// Reset global variables before each test\n\t\tif (typeof globalThis !== \"undefined\") {\n\t\t\t// @ts-expect-error - Testing environment cleanup\n\t\t\tdelete globalThis.document;\n\t\t\t// @ts-expect-error - Testing environment cleanup\n\t\t\tdelete globalThis.window;\n\t\t\t// @ts-expect-error - Testing environment cleanup\n\t\t\tdelete globalThis.localStorage;\n\t\t\t// @ts-expect-error - Testing environment cleanup\n\t\t\tdelete globalThis.navigator;\n\t\t}\n\t});\n\n\tconst defaultHandler = { getLocale: () => \"en\", setLocale: () => {} };\n\n\tconst invalidInputs = [\n\t\t[\"\", \"empty name\"],\n\t\t[\"@invalid\", \"names with special characters (@)\"],\n\t\t[\"invalid!\", \"names with special characters (!)\"],\n\t\t[\"inva lid\", \"names with spaces\"],\n\t];\n\n\ttest.each(invalidInputs)(\n\t\t`${strategyName} throws error for %s (%s)`,\n\t\t(input) => {\n\t\t\texpect(() => defineStrategy(input, defaultHandler)).toThrow(\n\t\t\t\t`Invalid custom strategy: \"${input}\". Must be a custom strategy following the pattern custom-name.`\n\t\t\t);\n\t\t}\n\t);\n\n\ttest(`${strategyName} should compile with custom strategies in strategy array`, async () => {\n\t\t// Test that compile accepts custom strategies\n\t\tconst runtime = await createParaglide({\n\t\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\", \"fr\"],\n\t\t\tstrategy: [\"custom-auth\", \"custom-header\", \"cookie\", \"baseLocale\"],\n\t\t\tcookieName: \"PARAGLIDE_LOCALE\",\n\t\t});\n\n\t\t// Verify the runtime contains the strategy array\n\t\texpect(runtime.strategy).toEqual([\n\t\t\t\"custom-auth\",\n\t\t\t\"custom-header\",\n\t\t\t\"cookie\",\n\t\t\t\"baseLocale\",\n\t\t]);\n\t});\n});\n"]}

package/dist/compiler/runtime/track-message-call.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @param {string} safeModuleId
+ * @param {Locale} locale
+ */
+export declare function trackMessageCall(safeModuleId: string, locale: Locale): void;

package/dist/compiler/runtime/track-message-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-message-call.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/track-message-call.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAHlC,MAGkC,EAAE,MAAM,EAF1C,MAE0C,QAQpD"}

package/dist/compiler/runtime/track-message-call.js

@@ -0,0 +1,14 @@
+import { serverAsyncLocalStorage, isServer } from "./variables.js";
+/**
+ * @param {string} safeModuleId
+ * @param {Locale} locale
+ */
+export function trackMessageCall(safeModuleId, locale) {
+    if (isServer === false)
+        return;
+    const store = serverAsyncLocalStorage?.getStore();
+    if (store) {
+        store.messageCalls?.add(`${safeModuleId}:${locale}`);
+    }
+}
+//# sourceMappingURL=track-message-call.js.map

package/dist/compiler/runtime/track-message-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-message-call.js","sourceRoot":"","sources":["../../../src/compiler/runtime/track-message-call.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAY,EAAE,MAAM;IACpD,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO;IAE/B,MAAM,KAAK,GAAG,uBAAuB,EAAE,QAAQ,EAAE,CAAC;IAElD,IAAI,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,GAAG,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;AACF,CAAC","sourcesContent":["import { serverAsyncLocalStorage, isServer } from \"./variables.js\";\n\n/**\n * @param {string} safeModuleId\n * @param {Locale} locale\n */\nexport function trackMessageCall(safeModuleId, locale) {\n\tif (isServer === false) return;\n\n\tconst store = serverAsyncLocalStorage?.getStore();\n\n\tif (store) {\n\t\tstore.messageCalls?.add(`${safeModuleId}:${locale}`);\n\t}\n}\n"]}

package/dist/compiler/runtime/track-message-call.test.d.ts

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

package/dist/compiler/runtime/track-message-call.test.d.ts.map

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

package/dist/compiler/runtime/track-message-call.test.js

@@ -0,0 +1,22 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createParaglide } from "../create-paraglide.js";
+import { test, expect } from "vitest";
+test("tracks message calls", async () => {
+    const runtime = await createParaglide({
+        baseLocale: "en",
+        locales: ["en", "de"],
+    });
+    const mockMessage = (str) => {
+        runtime.trackMessageCall(str, "de");
+    };
+    runtime.overwriteServerAsyncLocalStorage(new AsyncLocalStorage());
+    const messageCalls = new Set();
+    const result = runtime.serverAsyncLocalStorage?.run({ messageCalls }, () => {
+        mockMessage("test1");
+        mockMessage("test2");
+        return "test3";
+    });
+    expect(result).toBe("test3");
+    expect(messageCalls).toEqual(new Set(["test1:de", "test2:de"]));
+});
+//# sourceMappingURL=track-message-call.test.js.map

package/dist/compiler/runtime/track-message-call.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-message-call.test.js","sourceRoot":"","sources":["../../../src/compiler/runtime/track-message-call.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEtC,IAAI,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IACvC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC;QACrC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KACrB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE;QACnC,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,OAAO,CAAC,gCAAgC,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAElE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,MAAM,MAAM,GAAG,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE;QAC1E,WAAW,CAAC,OAAO,CAAC,CAAC;QACrB,WAAW,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC,CAAC,CAAC","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { createParaglide } from \"../create-paraglide.js\";\nimport { test, expect } from \"vitest\";\n\ntest(\"tracks message calls\", async () => {\n\tconst runtime = await createParaglide({\n\t\tbaseLocale: \"en\",\n\t\tlocales: [\"en\", \"de\"],\n\t});\n\n\tconst mockMessage = (str: string) => {\n\t\truntime.trackMessageCall(str, \"de\");\n\t};\n\n\truntime.overwriteServerAsyncLocalStorage(new AsyncLocalStorage());\n\n\tconst messageCalls = new Set<string>();\n\n\tconst result = runtime.serverAsyncLocalStorage?.run({ messageCalls }, () => {\n\t\tmockMessage(\"test1\");\n\t\tmockMessage(\"test2\");\n\t\treturn \"test3\";\n\t});\n\n\texpect(result).toBe(\"test3\");\n\texpect(messageCalls).toEqual(new Set([\"test1:de\", \"test2:de\"]));\n});\n"]}

package/dist/compiler/runtime/type-definitions.d.ts

@@ -0,0 +1,197 @@
+export type Locale = string;
+export type LocalizedString = string & {
+    readonly __brand: 'LocalizedString';
+};
+export type MessageMarkupOption = {
+    name: string;
+    value: unknown;
+};
+export type MessageMarkupAttribute = {
+    name: string;
+    value: string | true;
+};
+export type MessageMarkupOptions = Record<string, unknown>;
+export type MessageMarkupAttributes = Record<string, string | true>;
+export type MessageMarkupTag = {
+    options: MessageMarkupOptions;
+    attributes: MessageMarkupAttributes;
+    children: boolean;
+};
+export type MessageMarkupSchema = Record<string, MessageMarkupTag>;
+export type MessageMetadata<Inputs, Options, Markup extends MessageMarkupSchema = MessageMarkupSchema> = {
+    readonly __paraglide?: {
+        inputs: Inputs;
+        options: Options;
+        markup: Markup;
+    };
+};
+export type MessagePart = {
+    type: "text";
+    value: string;
+} | {
+    type: "markup-start";
+    name: string;
+    options: MessageMarkupOptions;
+    attributes: MessageMarkupAttributes;
+} | {
+    type: "markup-end";
+    name: string;
+    options: MessageMarkupOptions;
+    attributes: MessageMarkupAttributes;
+} | {
+    type: "markup-standalone";
+    name: string;
+    options: MessageMarkupOptions;
+    attributes: MessageMarkupAttributes;
+};
+export type MessageFunction = (inputs?: Record<string, never>) => LocalizedString;
+export type MessageBundleFunction<T extends string> = (params: Record<string, never>, options: {
+    locale: T;
+}) => LocalizedString;
+/**
+ * A locale that is available in the project.
+ *
+ * @example
+ *   setLocale(request.locale as Locale)
+ *
+ * @typedef {string} Locale
+ */
+/**
+ * A branded type representing a localized string.
+ *
+ * Message functions return this type instead of \`string\`, enabling TypeScript
+ * to distinguish translated strings from regular strings at compile time.
+ * This allows you to enforce that only properly localized content is used
+ * in your UI components.
+ *
+ * Since \`LocalizedString\` is a branded subtype of \`string\`, it remains fully
+ * backward compatible—you can pass it anywhere a \`string\` is expected.
+ *
+ * @example
+ *   // Enforce localized strings in your components
+ *   function PageTitle(props: { title: LocalizedString }) {
+ *     return <h1>{props.title}</h1>
+ *   }
+ *
+ *   // ✅ Correct: using a message function
+ *   <PageTitle title={m.welcome_title()} />
+ *
+ *   // ❌ Type error: raw strings are not LocalizedString
+ *   <PageTitle title="Welcome" />
+ *
+ * @example
+ *   // LocalizedString is assignable to string (backward compatible)
+ *   const localized: LocalizedString = m.greeting()
+ *   const str: string = localized  // ✅ works fine
+ *
+ *   // But string is not assignable to LocalizedString
+ *   const raw: LocalizedString = "Hello"  // ❌ Type error
+ *
+ * @example
+ *   // Catches accidental string concatenation
+ *   function showMessage(msg: LocalizedString) { ... }
+ *
+ *   showMessage(m.hello())                    // ✅
+ *   showMessage("Hello " + userName)          // ❌ Type error
+ *   showMessage(m.hello_user({ name: userName }))  // ✅ use params instead
+ *
+ * @typedef {string & { readonly __brand: 'LocalizedString' }} LocalizedString
+ */
+/**
+ * A single markup option passed to a tag instance.
+ *
+ * @typedef {{
+ *   name: string;
+ *   value: unknown;
+ * }} MessageMarkupOption
+ */
+/**
+ * A single static markup attribute attached to a tag instance.
+ *
+ * @typedef {{
+ *   name: string;
+ *   value: string | true;
+ * }} MessageMarkupAttribute
+ */
+/**
+ * Record of markup options for a tag instance.
+ *
+ * @typedef {Record<string, unknown>} MessageMarkupOptions
+ */
+/**
+ * Record of markup attributes for a tag instance.
+ *
+ * @typedef {Record<string, string | true>} MessageMarkupAttributes
+ */
+/**
+ * Type-level schema for a single markup tag.
+ *
+ * @typedef {{
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ *   children: boolean;
+ * }} MessageMarkupTag
+ */
+/**
+ * Type-level schema for all markup tags in a message.
+ *
+ * @typedef {Record<string, MessageMarkupTag>} MessageMarkupSchema
+ */
+/**
+ * Type-only metadata attached to compiled message functions.
+ *
+ * @template Inputs
+ * @template Options
+ * @template {MessageMarkupSchema} [Markup = MessageMarkupSchema]
+ * @typedef {{
+ *   readonly __paraglide?: {
+ *     inputs: Inputs;
+ *     options: Options;
+ *     markup: Markup;
+ *   };
+ * }} MessageMetadata
+ */
+/**
+ * A compiled, framework-neutral message part.
+ *
+ * @typedef {{
+ *   type: "text";
+ *   value: string;
+ * } | {
+ *   type: "markup-start";
+ *   name: string;
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ * } | {
+ *   type: "markup-end";
+ *   name: string;
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ * } | {
+ *   type: "markup-standalone";
+ *   name: string;
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ * }} MessagePart
+ */
+/**
+ * A message function is a message for a specific locale.
+ *
+ * @example
+ *   m.hello({ name: 'world' })
+ *
+ * @typedef {(inputs?: Record<string, never>) => LocalizedString} MessageFunction
+ */
+/**
+ * A message bundle function that selects the message to be returned.
+ *
+ * Uses `getLocale()` under the hood to determine the locale with an option.
+ *
+ * @template {string} T
+ *
+ * @example
+ *   import { m } from './messages.js'
+ *   m.hello({ name: 'world' }, { locale: "en" })
+ *
+ * @typedef {(params: Record<string, never>, options: { locale: T }) => LocalizedString} MessageBundleFunction
+ */

package/dist/compiler/runtime/type-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-definitions.d.ts","sourceRoot":"","sources":["../../../src/compiler/runtime/type-definitions.js"],"names":[],"mappings":"AAQG,YAAkB,MAAM,GAAd,MAAM,CAAQ;AA0CxB,YAA4D,eAAe,GAAjE,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAiB;AAM3E,YAGG,mBAAmB,GAHZ;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAqB;AAMtB,YAGG,sBAAsB,GAHf;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAwB;AAMzB,YAAmC,oBAAoB,GAA7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAsB;AAMvD,YAAyC,uBAAuB,GAAtD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAyB;AAMhE,YAIG,gBAAgB,GAJT;IACR,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,uBAAuB,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAkB;AAMnB,YAA4C,mBAAmB,GAArD,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAqB;AAS/D,YAMG,eAAe,CATR,MAAM,EACN,OAAO,EACgB,MAAM,SAA5B,mBAAmB,GAAY,mBAAoB,IACpD;IACZ,QAAY,CAAC,WAAW,CAAC,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAiB;AAMlB,YAkBG,WAAW,GAlBJ;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,GAAG;IACF,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,uBAAuB,CAAC;CACrC,GAAG;IACF,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,uBAAuB,CAAC;CACrC,GAAG;IACF,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,UAAU,EAAE,uBAAuB,CAAC;CACrC,CAAa;AASd,YAA+D,eAAe,GAApE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,eAAe,CAAiB;AAc9E,YAAsF,qBAAqB,CANxF,CAAC,SAAT,MAAS,IAMV,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,KAAK,eAAe,CAAuB;AA5J9G;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG"}

package/dist/compiler/runtime/type-definitions.js

@@ -0,0 +1,150 @@
+// ------ TYPES ------
+export {};
+/**
+ * A locale that is available in the project.
+ *
+ * @example
+ *   setLocale(request.locale as Locale)
+ *
+ * @typedef {string} Locale
+ */
+/**
+ * A branded type representing a localized string.
+ *
+ * Message functions return this type instead of \`string\`, enabling TypeScript
+ * to distinguish translated strings from regular strings at compile time.
+ * This allows you to enforce that only properly localized content is used
+ * in your UI components.
+ *
+ * Since \`LocalizedString\` is a branded subtype of \`string\`, it remains fully
+ * backward compatible—you can pass it anywhere a \`string\` is expected.
+ *
+ * @example
+ *   // Enforce localized strings in your components
+ *   function PageTitle(props: { title: LocalizedString }) {
+ *     return <h1>{props.title}</h1>
+ *   }
+ *
+ *   // ✅ Correct: using a message function
+ *   <PageTitle title={m.welcome_title()} />
+ *
+ *   // ❌ Type error: raw strings are not LocalizedString
+ *   <PageTitle title="Welcome" />
+ *
+ * @example
+ *   // LocalizedString is assignable to string (backward compatible)
+ *   const localized: LocalizedString = m.greeting()
+ *   const str: string = localized  // ✅ works fine
+ *
+ *   // But string is not assignable to LocalizedString
+ *   const raw: LocalizedString = "Hello"  // ❌ Type error
+ *
+ * @example
+ *   // Catches accidental string concatenation
+ *   function showMessage(msg: LocalizedString) { ... }
+ *
+ *   showMessage(m.hello())                    // ✅
+ *   showMessage("Hello " + userName)          // ❌ Type error
+ *   showMessage(m.hello_user({ name: userName }))  // ✅ use params instead
+ *
+ * @typedef {string & { readonly __brand: 'LocalizedString' }} LocalizedString
+ */
+/**
+ * A single markup option passed to a tag instance.
+ *
+ * @typedef {{
+ *   name: string;
+ *   value: unknown;
+ * }} MessageMarkupOption
+ */
+/**
+ * A single static markup attribute attached to a tag instance.
+ *
+ * @typedef {{
+ *   name: string;
+ *   value: string | true;
+ * }} MessageMarkupAttribute
+ */
+/**
+ * Record of markup options for a tag instance.
+ *
+ * @typedef {Record<string, unknown>} MessageMarkupOptions
+ */
+/**
+ * Record of markup attributes for a tag instance.
+ *
+ * @typedef {Record<string, string | true>} MessageMarkupAttributes
+ */
+/**
+ * Type-level schema for a single markup tag.
+ *
+ * @typedef {{
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ *   children: boolean;
+ * }} MessageMarkupTag
+ */
+/**
+ * Type-level schema for all markup tags in a message.
+ *
+ * @typedef {Record<string, MessageMarkupTag>} MessageMarkupSchema
+ */
+/**
+ * Type-only metadata attached to compiled message functions.
+ *
+ * @template Inputs
+ * @template Options
+ * @template {MessageMarkupSchema} [Markup = MessageMarkupSchema]
+ * @typedef {{
+ *   readonly __paraglide?: {
+ *     inputs: Inputs;
+ *     options: Options;
+ *     markup: Markup;
+ *   };
+ * }} MessageMetadata
+ */
+/**
+ * A compiled, framework-neutral message part.
+ *
+ * @typedef {{
+ *   type: "text";
+ *   value: string;
+ * } | {
+ *   type: "markup-start";
+ *   name: string;
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ * } | {
+ *   type: "markup-end";
+ *   name: string;
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ * } | {
+ *   type: "markup-standalone";
+ *   name: string;
+ *   options: MessageMarkupOptions;
+ *   attributes: MessageMarkupAttributes;
+ * }} MessagePart
+ */
+/**
+ * A message function is a message for a specific locale.
+ *
+ * @example
+ *   m.hello({ name: 'world' })
+ *
+ * @typedef {(inputs?: Record<string, never>) => LocalizedString} MessageFunction
+ */
+/**
+ * A message bundle function that selects the message to be returned.
+ *
+ * Uses `getLocale()` under the hood to determine the locale with an option.
+ *
+ * @template {string} T
+ *
+ * @example
+ *   import { m } from './messages.js'
+ *   m.hello({ name: 'world' }, { locale: "en" })
+ *
+ * @typedef {(params: Record<string, never>, options: { locale: T }) => LocalizedString} MessageBundleFunction
+ */
+//# sourceMappingURL=type-definitions.js.map

package/dist/compiler/runtime/type-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-definitions.js","sourceRoot":"","sources":["../../../src/compiler/runtime/type-definitions.js"],"names":[],"mappings":"AAAA,sBAAsB;;AAEtB;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;;;GAYG","sourcesContent":["// ------ TYPES ------\n\n/**\n * A locale that is available in the project.\n *\n * @example\n *   setLocale(request.locale as Locale)\n *\n * @typedef {string} Locale\n */\n\n/**\n * A branded type representing a localized string.\n *\n * Message functions return this type instead of \\`string\\`, enabling TypeScript\n * to distinguish translated strings from regular strings at compile time.\n * This allows you to enforce that only properly localized content is used\n * in your UI components.\n *\n * Since \\`LocalizedString\\` is a branded subtype of \\`string\\`, it remains fully\n * backward compatible—you can pass it anywhere a \\`string\\` is expected.\n *\n * @example\n *   // Enforce localized strings in your components\n *   function PageTitle(props: { title: LocalizedString }) {\n *     return <h1>{props.title}</h1>\n *   }\n *\n *   // ✅ Correct: using a message function\n *   <PageTitle title={m.welcome_title()} />\n *\n *   // ❌ Type error: raw strings are not LocalizedString\n *   <PageTitle title=\"Welcome\" />\n *\n * @example\n *   // LocalizedString is assignable to string (backward compatible)\n *   const localized: LocalizedString = m.greeting()\n *   const str: string = localized  // ✅ works fine\n *\n *   // But string is not assignable to LocalizedString\n *   const raw: LocalizedString = \"Hello\"  // ❌ Type error\n *\n * @example\n *   // Catches accidental string concatenation\n *   function showMessage(msg: LocalizedString) { ... }\n *\n *   showMessage(m.hello())                    // ✅\n *   showMessage(\"Hello \" + userName)          // ❌ Type error\n *   showMessage(m.hello_user({ name: userName }))  // ✅ use params instead\n *\n * @typedef {string & { readonly __brand: 'LocalizedString' }} LocalizedString\n */\n\n/**\n * A single markup option passed to a tag instance.\n *\n * @typedef {{\n *   name: string;\n *   value: unknown;\n * }} MessageMarkupOption\n */\n\n/**\n * A single static markup attribute attached to a tag instance.\n *\n * @typedef {{\n *   name: string;\n *   value: string | true;\n * }} MessageMarkupAttribute\n */\n\n/**\n * Record of markup options for a tag instance.\n *\n * @typedef {Record<string, unknown>} MessageMarkupOptions\n */\n\n/**\n * Record of markup attributes for a tag instance.\n *\n * @typedef {Record<string, string | true>} MessageMarkupAttributes\n */\n\n/**\n * Type-level schema for a single markup tag.\n *\n * @typedef {{\n *   options: MessageMarkupOptions;\n *   attributes: MessageMarkupAttributes;\n *   children: boolean;\n * }} MessageMarkupTag\n */\n\n/**\n * Type-level schema for all markup tags in a message.\n *\n * @typedef {Record<string, MessageMarkupTag>} MessageMarkupSchema\n */\n\n/**\n * Type-only metadata attached to compiled message functions.\n *\n * @template Inputs\n * @template Options\n * @template {MessageMarkupSchema} [Markup = MessageMarkupSchema]\n * @typedef {{\n *   readonly __paraglide?: {\n *     inputs: Inputs;\n *     options: Options;\n *     markup: Markup;\n *   };\n * }} MessageMetadata\n */\n\n/**\n * A compiled, framework-neutral message part.\n *\n * @typedef {{\n *   type: \"text\";\n *   value: string;\n * } | {\n *   type: \"markup-start\";\n *   name: string;\n *   options: MessageMarkupOptions;\n *   attributes: MessageMarkupAttributes;\n * } | {\n *   type: \"markup-end\";\n *   name: string;\n *   options: MessageMarkupOptions;\n *   attributes: MessageMarkupAttributes;\n * } | {\n *   type: \"markup-standalone\";\n *   name: string;\n *   options: MessageMarkupOptions;\n *   attributes: MessageMarkupAttributes;\n * }} MessagePart\n */\n\n/**\n * A message function is a message for a specific locale.\n *\n * @example\n *   m.hello({ name: 'world' })\n *\n * @typedef {(inputs?: Record<string, never>) => LocalizedString} MessageFunction\n */\n\n/**\n * A message bundle function that selects the message to be returned.\n *\n * Uses `getLocale()` under the hood to determine the locale with an option.\n *\n * @template {string} T\n *\n * @example\n *   import { m } from './messages.js'\n *   m.hello({ name: 'world' }, { locale: \"en\" })\n *\n * @typedef {(params: Record<string, never>, options: { locale: T }) => LocalizedString} MessageBundleFunction\n */\n"]}