@inlang/paraglide-js 2.26.0 → 2.28.0

package/dist/compiler/create-readme.js

@@ -1,43 +1,47 @@
 /**
  * Creates the README.md content for the compiled output.
  *
- * This helps LLMs understand the compiled Paraglide JS output.
+ * The README tells coding agents what this generated folder is, what to edit
+ * instead, and where inlang tooling ends and Paraglide JS begins.
  * See https://llmstxt.org/ for the format guidelines.
  */
 export function createReadme(args) {
     const compiledFromLine = args.projectPath
         ? `\nCompiled from: \`${args.projectPath}\`\n`
         : "";
+    const projectPath = args.projectPath ?? "./project.inlang";
+    const gitignoreNote = args.gitignored === false
+        ? ""
+        : " This folder is git-ignored (see `.gitignore`), so don't commit it.";
     return `# Paraglide JS Compiled Output
 
-> Auto-generated i18n message functions. Import \`messages.js\` to use translated strings.
+> Generated by [Paraglide JS](https://paraglidejs.com). Do not edit: every file here is overwritten on the next compile.
 ${compiledFromLine}
-
 ## What is this folder?
 
-This folder contains compiled [Paraglide JS](https://github.com/opral/paraglide-js) output. Paraglide JS compiles your translation messages into tree-shakeable JavaScript functions.
+Paraglide JS is a compiler-based i18n library. It compiles an [inlang](https://inlang.com) project into typesafe message functions. Messages and params are type-checked, unused messages are tree-shaken out of the bundle, and the runtime includes locale detection and localized URLs. It targets Vite-based apps (React, TanStack Start/Router, SvelteKit, Vue, Solid, Astro, ...) and has plugins for other bundlers. It also compiles standalone with its CLI (\`npx @inlang/paraglide-js compile\`), without a bundler.
+
+## Edit the source, not this folder
 
-## At a glance
+- **Text and translations:** the translation files of the inlang project (see \`pathPattern\` in \`${projectPath}/settings.json\`, for example \`messages/{locale}.json\`). Add, rename and fix messages there.
+- **Locales and file format:** \`${projectPath}/settings.json\`.
+- **Compiler options** (\`strategy\`, \`outdir\`, ...): the bundler plugin options or \`${projectPath}/paraglide.config.*\`.
+- **Regenerate:** the bundler plugin (for example \`paraglideVitePlugin\`) recompiles on dev and build. Without a bundler, run \`npx @inlang/paraglide-js compile --project ${projectPath} --outdir <this folder>\`.${gitignoreNote}
 
-Purpose:
-- This folder stores compiled i18n message functions.
-- Source translations live outside this folder in your inlang project.
+If a new message has no \`m.*\` function yet, the output is stale: recompile (for example, restart the dev server).
 
-Safe to import:
-- \`messages.js\` — all message functions
-- \`runtime.js\` — locale utilities
-- \`server.js\` — server-side middleware
+## inlang vs. Paraglide JS
 
-Do not edit:
-- All files in this folder are auto-generated.
-- Changes will be overwritten on next compilation.
+- **inlang** owns the localization project: messages, translation files, \`settings.json\`, plugins, and the tooling around them. Use the inlang CLI for [checks](https://inlang.com/m/2qj2w8pu/app-inlang-cli#check) (\`npx @inlang/cli check --project ${projectPath}\` finds missing translations and unused messages) and [machine translation](https://inlang.com/m/2qj2w8pu/app-inlang-cli#machine-translate). Translators can use [Fink](https://inlang.com/m/tdozzpar/app-inlang-finkLocalizationEditor), designers [Parrot](https://inlang.com/m/gkrpgoir/app-parrot-figmaPlugin) in Figma, and developers [Sherlock](https://inlang.com/m/r7kp499g/app-inlang-ideExtension) in VS Code. The project folder has its own README.
+- **Paraglide JS** owns this folder: message functions, the locale runtime, and server middleware.
+- The file format (inlang message format, i18next, ICU MessageFormat, ...) is an inlang plugin. Switching formats doesn't change your \`m.*\` calls. See [file formats](https://paraglidejs.com/file-formats). Switching to a runtime library such as i18next gives up the compiled typesafety and tree-shaking; inlang's checks, machine translation and editors keep working through a format plugin. See the [comparison](https://paraglidejs.com/comparison).
 
 \`\`\`
 paraglide/
 ├── messages.js      # Message exports (import this)
 ├── messages/        # Individual message functions
 ├── runtime.js       # Locale detection & configuration
-├── registry.js      # Formatting utilities (plural, number, datetime, relativetime)
+├── registry.js      # Formatters for plural, number, datetime, date, time, relativetime, icu:pound
 ├── server.js        # Server-side middleware
 └── .gitignore       # Marks folder as generated
 \`\`\`
@@ -45,129 +49,33 @@ paraglide/
 ## 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!"
+import { m } from "./paraglide/messages.js";
 
-// Override locale per-call
-m.hello_world({}, { locale: "de" });           // "Hallo, Welt!"
+m.hello_world();                          // "Hello, World!" (current locale)
+m.greeting({ name: "Sam" });              // "Hello, Sam!"
 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({
-  project: "./project.inlang",
-  outdir: "./src/paraglide",
-  strategy: ["url", "cookie", "baseLocale"],
-});
-\`\`\`
-
-See the [strategy documentation](https://paraglidejs.com/strategy) for details.
-
-## 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.*\`).
-
-This is the default inlang message syntax. Paraglide's message format is plugin-based — you can use [ICU MessageFormat 1](https://inlang.com/m/p7c8m1d2/plugin-inlang-icu-messageformat-1), [i18next](https://inlang.com/m/3i8bor92/plugin-inlang-i18next), or other [plugins](https://inlang.com/c/plugins) instead.
-
-### Rendering markup
-
-Calling the message function still returns **plain text** (markup stripped):
-
-\`\`\`js
-m.cta({ relationship: "noopener" }); // "Read the docs"
-\`\`\`
-
-To render markup, use the framework adapter or the low-level \`parts()\` API:
-
-\`\`\`js
-const parts = m.cta.parts({ relationship: "noopener" });
-// [
-//   { type: "markup-start", name: "link", options: { to: "/docs", rel: "noopener" }, attributes: { track: true } },
-//   { type: "text", value: "Read the docs" },
-//   { type: "markup-end", name: "link" }
-// ]
-\`\`\`
-
-Framework adapters provide a \`<ParaglideMessage>\` component that accepts markup renderers:
-
-- \`@inlang/paraglide-js-react\`
-- \`@inlang/paraglide-js-vue\`
-- \`@inlang/paraglide-js-svelte\`
-- \`@inlang/paraglide-js-solid\`
-
-\`\`\`jsx
-import { ParaglideMessage } from "@inlang/paraglide-js-react"; // or -vue, -svelte, -solid
+import { getLocale, setLocale, locales, baseLocale, getTextDirection } from "./paraglide/runtime.js";
 
-<ParaglideMessage
-  message={m.welcome}
-  inputs={{ name: "Ada" }}
-  markup={{
-    b: ({ children }) => <b>{children}</b>,
-    icon: () => <span aria-hidden="true" className="icon-wave" />,
-  }}
-/>
+getLocale();        // e.g. "en"
+setLocale("de");    // reloads the page by default; pass { reload: false } to skip
+locales;            // e.g. ["en", "de"]
+getTextDirection(); // "ltr" | "rtl"
 \`\`\`
 
-The available renderer/snippet names come from the message itself. You can inspect them through \`message.parts()\`, and TypeScript uses the same names to type-check your markup renderers.
+## Strategy and localized URLs
 
-See the [markup documentation](https://paraglidejs.com/markup) for details.
+The compiler option \`strategy\` is an ordered list of how the locale is detected and stored; the first strategy that resolves a locale wins (default \`["cookie", "globalVariable", "baseLocale"]\`). Options include \`"url"\` (localized URLs such as \`/de/about\`), \`"cookie"\`, \`"localStorage"\`, \`"preferredLanguage"\`, \`"globalVariable"\`, \`"baseLocale"\` and \`"custom-*"\`. See [strategy](https://paraglidejs.com/strategy) and [i18n routing](https://paraglidejs.com/i18n-routing).
 
-## Key concepts
+## Markup
 
-- **Tree-shakeable**: Each message is a function, enabling [up to 70% smaller i18n bundle sizes](https://paraglidejs.com/benchmark) than traditional i18n libraries.
-- **Typesafe**: Full TypeScript/JSDoc support with autocomplete.
-- **Variants**: Messages can have variants for pluralization, gender, etc.
-- **Fallbacks**: Missing translations fall back to the base locale.
+Messages can contain markup such as \`{#link to=|/docs|}Read the docs{/link}\`. Calling the message returns plain text. To render markup, use \`m.key.parts()\` or the \`<ParaglideMessage>\` component from \`@inlang/paraglide-js-react\`, \`-vue\`, \`-svelte\` or \`-solid\`. Tag names are app-defined, so \`{#b}\` does not render \`<b>\` on its own. See [markup](https://paraglidejs.com/markup).
 
 ## Links
 
-- [Paraglide JS Documentation](https://paraglidejs.com)
-- [Source Repository](https://github.com/opral/paraglide-js)
+- [Paraglide JS documentation](https://paraglidejs.com) and [basics](https://paraglidejs.com/basics)
 `;
 }
 //# sourceMappingURL=create-readme.js.map

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

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6JjB,CAAC;AACF,CAAC","sourcesContent":["/**\n * Creates the README.md content for the compiled output.\n *\n * This helps LLMs understand the compiled Paraglide JS output.\n * See https://llmstxt.org/ for the format guidelines.\n */\nexport function createReadme(args: { projectPath?: string }): string {\n\tconst compiledFromLine = args.projectPath\n\t\t? `\\nCompiled from: \\`${args.projectPath}\\`\\n`\n\t\t: \"\";\n\n\treturn `# Paraglide JS 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 [Paraglide JS](https://github.com/opral/paraglide-js) output. Paraglide JS compiles your translation messages into tree-shakeable JavaScript functions.\n\n## At a glance\n\nPurpose:\n- This folder stores compiled i18n message functions.\n- Source translations live outside this folder in your inlang project.\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  project: \"./project.inlang\",\n  outdir: \"./src/paraglide\",\n  strategy: [\"url\", \"cookie\", \"baseLocale\"],\n});\n\\`\\`\\`\n\nSee the [strategy documentation](https://paraglidejs.com/strategy) for details.\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\nThis is the default inlang message syntax. Paraglide's message format is plugin-based — you can use [ICU MessageFormat 1](https://inlang.com/m/p7c8m1d2/plugin-inlang-icu-messageformat-1), [i18next](https://inlang.com/m/3i8bor92/plugin-inlang-i18next), or other [plugins](https://inlang.com/c/plugins) instead.\n\n### Rendering markup\n\nCalling the message function still returns **plain text** (markup stripped):\n\n\\`\\`\\`js\nm.cta({ relationship: \"noopener\" }); // \"Read the docs\"\n\\`\\`\\`\n\nTo render markup, use the framework adapter or the low-level \\`parts()\\` API:\n\n\\`\\`\\`js\nconst parts = m.cta.parts({ relationship: \"noopener\" });\n// [\n//   { type: \"markup-start\", name: \"link\", options: { to: \"/docs\", rel: \"noopener\" }, attributes: { track: true } },\n//   { type: \"text\", value: \"Read the docs\" },\n//   { type: \"markup-end\", name: \"link\" }\n// ]\n\\`\\`\\`\n\nFramework adapters provide a \\`<ParaglideMessage>\\` component that accepts markup renderers:\n\n- \\`@inlang/paraglide-js-react\\`\n- \\`@inlang/paraglide-js-vue\\`\n- \\`@inlang/paraglide-js-svelte\\`\n- \\`@inlang/paraglide-js-solid\\`\n\n\\`\\`\\`jsx\nimport { ParaglideMessage } from \"@inlang/paraglide-js-react\"; // or -vue, -svelte, -solid\n\n<ParaglideMessage\n  message={m.welcome}\n  inputs={{ name: \"Ada\" }}\n  markup={{\n    b: ({ children }) => <b>{children}</b>,\n    icon: () => <span aria-hidden=\"true\" className=\"icon-wave\" />,\n  }}\n/>\n\\`\\`\\`\n\nThe available renderer/snippet names come from the message itself. You can inspect them through \\`message.parts()\\`, and TypeScript uses the same names to type-check your markup renderers.\n\nSee the [markup documentation](https://paraglidejs.com/markup) for details.\n\n## Key concepts\n\n- **Tree-shakeable**: Each message is a function, enabling [up to 70% smaller i18n bundle sizes](https://paraglidejs.com/benchmark) than traditional i18n libraries.\n- **Typesafe**: Full TypeScript/JSDoc support with autocomplete.\n- **Variants**: Messages can have variants for pluralization, gender, etc.\n- **Fallbacks**: Missing translations fall back to the base locale.\n\n## Links\n\n- [Paraglide JS Documentation](https://paraglidejs.com)\n- [Source Repository](https://github.com/opral/paraglide-js)\n`;\n}\n"]}
+{"version":3,"file":"create-readme.js","sourceRoot":"","sources":["../../src/compiler/create-readme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAI5B;IACA,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW;QACxC,CAAC,CAAC,sBAAsB,IAAI,CAAC,WAAW,MAAM;QAC9C,CAAC,CAAC,EAAE,CAAC;IACN,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,kBAAkB,CAAC;IAC3D,MAAM,aAAa,GAClB,IAAI,CAAC,UAAU,KAAK,KAAK;QACxB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,qEAAqE,CAAC;IAE1E,OAAO;;;EAGN,gBAAgB;;;;;;;qGAOmF,WAAW;mCAC7E,WAAW;0FAC4C,WAAW;8KACyE,WAAW,6BAA6B,aAAa;;;;;;2PAMwB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CrQ,CAAC;AACF,CAAC","sourcesContent":["/**\n * Creates the README.md content for the compiled output.\n *\n * The README tells coding agents what this generated folder is, what to edit\n * instead, and where inlang tooling ends and Paraglide JS begins.\n * See https://llmstxt.org/ for the format guidelines.\n */\nexport function createReadme(args: {\n\tprojectPath?: string;\n\t/** Whether the output also contains a `.gitignore` that ignores it. */\n\tgitignored?: boolean;\n}): string {\n\tconst compiledFromLine = args.projectPath\n\t\t? `\\nCompiled from: \\`${args.projectPath}\\`\\n`\n\t\t: \"\";\n\tconst projectPath = args.projectPath ?? \"./project.inlang\";\n\tconst gitignoreNote =\n\t\targs.gitignored === false\n\t\t\t? \"\"\n\t\t\t: \" This folder is git-ignored (see `.gitignore`), so don't commit it.\";\n\n\treturn `# Paraglide JS Compiled Output\n\n> Generated by [Paraglide JS](https://paraglidejs.com). Do not edit: every file here is overwritten on the next compile.\n${compiledFromLine}\n## What is this folder?\n\nParaglide JS is a compiler-based i18n library. It compiles an [inlang](https://inlang.com) project into typesafe message functions. Messages and params are type-checked, unused messages are tree-shaken out of the bundle, and the runtime includes locale detection and localized URLs. It targets Vite-based apps (React, TanStack Start/Router, SvelteKit, Vue, Solid, Astro, ...) and has plugins for other bundlers. It also compiles standalone with its CLI (\\`npx @inlang/paraglide-js compile\\`), without a bundler.\n\n## Edit the source, not this folder\n\n- **Text and translations:** the translation files of the inlang project (see \\`pathPattern\\` in \\`${projectPath}/settings.json\\`, for example \\`messages/{locale}.json\\`). Add, rename and fix messages there.\n- **Locales and file format:** \\`${projectPath}/settings.json\\`.\n- **Compiler options** (\\`strategy\\`, \\`outdir\\`, ...): the bundler plugin options or \\`${projectPath}/paraglide.config.*\\`.\n- **Regenerate:** the bundler plugin (for example \\`paraglideVitePlugin\\`) recompiles on dev and build. Without a bundler, run \\`npx @inlang/paraglide-js compile --project ${projectPath} --outdir <this folder>\\`.${gitignoreNote}\n\nIf a new message has no \\`m.*\\` function yet, the output is stale: recompile (for example, restart the dev server).\n\n## inlang vs. Paraglide JS\n\n- **inlang** owns the localization project: messages, translation files, \\`settings.json\\`, plugins, and the tooling around them. Use the inlang CLI for [checks](https://inlang.com/m/2qj2w8pu/app-inlang-cli#check) (\\`npx @inlang/cli check --project ${projectPath}\\` finds missing translations and unused messages) and [machine translation](https://inlang.com/m/2qj2w8pu/app-inlang-cli#machine-translate). Translators can use [Fink](https://inlang.com/m/tdozzpar/app-inlang-finkLocalizationEditor), designers [Parrot](https://inlang.com/m/gkrpgoir/app-parrot-figmaPlugin) in Figma, and developers [Sherlock](https://inlang.com/m/r7kp499g/app-inlang-ideExtension) in VS Code. The project folder has its own README.\n- **Paraglide JS** owns this folder: message functions, the locale runtime, and server middleware.\n- The file format (inlang message format, i18next, ICU MessageFormat, ...) is an inlang plugin. Switching formats doesn't change your \\`m.*\\` calls. See [file formats](https://paraglidejs.com/file-formats). Switching to a runtime library such as i18next gives up the compiled typesafety and tree-shaking; inlang's checks, machine translation and editors keep working through a format plugin. See the [comparison](https://paraglidejs.com/comparison).\n\n\\`\\`\\`\nparaglide/\n├── messages.js      # Message exports (import this)\n├── messages/        # Individual message functions\n├── runtime.js       # Locale detection & configuration\n├── registry.js      # Formatters for plural, number, datetime, date, time, relativetime, icu:pound\n├── server.js        # Server-side middleware\n└── .gitignore       # Marks folder as generated\n\\`\\`\\`\n\n## Usage\n\n\\`\\`\\`js\nimport { m } from \"./paraglide/messages.js\";\n\nm.hello_world();                          // \"Hello, World!\" (current locale)\nm.greeting({ name: \"Sam\" });              // \"Hello, Sam!\"\nm.greeting({ name: \"Sam\" }, { locale: \"de\" }); // \"Hallo, Sam!\"\n\\`\\`\\`\n\n\\`\\`\\`js\nimport { getLocale, setLocale, locales, baseLocale, getTextDirection } from \"./paraglide/runtime.js\";\n\ngetLocale();        // e.g. \"en\"\nsetLocale(\"de\");    // reloads the page by default; pass { reload: false } to skip\nlocales;            // e.g. [\"en\", \"de\"]\ngetTextDirection(); // \"ltr\" | \"rtl\"\n\\`\\`\\`\n\n## Strategy and localized URLs\n\nThe compiler option \\`strategy\\` is an ordered list of how the locale is detected and stored; the first strategy that resolves a locale wins (default \\`[\"cookie\", \"globalVariable\", \"baseLocale\"]\\`). Options include \\`\"url\"\\` (localized URLs such as \\`/de/about\\`), \\`\"cookie\"\\`, \\`\"localStorage\"\\`, \\`\"preferredLanguage\"\\`, \\`\"globalVariable\"\\`, \\`\"baseLocale\"\\` and \\`\"custom-*\"\\`. See [strategy](https://paraglidejs.com/strategy) and [i18n routing](https://paraglidejs.com/i18n-routing).\n\n## Markup\n\nMessages can contain markup such as \\`{#link to=|/docs|}Read the docs{/link}\\`. Calling the message returns plain text. To render markup, use \\`m.key.parts()\\` or the \\`<ParaglideMessage>\\` component from \\`@inlang/paraglide-js-react\\`, \\`-vue\\`, \\`-svelte\\` or \\`-solid\\`. Tag names are app-defined, so \\`{#b}\\` does not render \\`<b>\\` on its own. See [markup](https://paraglidejs.com/markup).\n\n## Links\n\n- [Paraglide JS documentation](https://paraglidejs.com) and [basics](https://paraglidejs.com/basics)\n`;\n}\n"]}

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

@@ -33,13 +33,13 @@ test("emitTsDeclarations uses the compiler API for a default-only interop shape
         messages: [
             {
                 id: "greeting.hello_en",
-                bundleId: "greeting.hello",
+                bundle_id: "greeting.hello",
                 locale: "en",
                 selectors: [],
                 variants: [
                     {
                         id: "greeting.hello_en_variant",
-                        messageId: "greeting.hello",
+                        message_id: "greeting.hello",
                         matches: [],
                         pattern: [{ type: "text", value: "Hello" }],
                     },

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

@@ -1 +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,EAEN,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,oEAAoE;AACpE,wEAAwE;AACxE,sEAAsE;AACtE,sEAAsE;AACtE,yEAAyE;AACzE,2DAA2D;AAC3D,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,8CAA8C;AAC9C,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,MAAM,mBAAmB,CAAC;QACzC,IAAI,EAAE,MAAM,UAAU,CAAC;YACtB,QAAQ,EAAE;gBACT,OAAO,EAAE,CAAC,IAAI,CAAC;gBACf,UAAU,EAAE,IAAI;aAChB;SACD,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAiB;QAC5B,EAAE,EAAE,gBAAgB;QACpB,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE;YACT;gBACC,EAAE,EAAE,mBAAmB;gBACvB,QAAQ,EAAE,gBAAgB;gBAC1B,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE;oBACT;wBACC,EAAE,EAAE,2BAA2B;wBAC/B,SAAS,EAAE,gBAAgB;wBAC3B,OAAO,EAAE,EAAE;wBACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;qBAC3C;iBACD;aACD;SACD;KACD,CAAC;IACF,MAAM,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QACnC,OAAO;QACP,eAAe,EAAE;YAChB,kBAAkB,EAAE,IAAI;SACxB;KACD,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,yEAAyE;IACzE,yEAAyE;IACzE,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 {\n\ttype BundleNested,\n\tinsertBundleNested,\n\tloadProjectInMemory,\n\tnewProject,\n} from \"@inlang/sdk\";\nimport { compileProject } from \"./compile-project.js\";\n\n// Bundlers and CJS interop can deliver the `typescript` module in a\n// default-only shape (`{ default: ts }` without hoisted named exports).\n// TypeScript 5/6 in that shape must still be routed to the in-process\n// compiler API: the CLI fallback intended for TypeScript 7+ would run\n// TypeScript 5's `tsc`, whose declaration emitter produces syntactically\n// invalid unquoted export aliases (`export { x as a.b }`).\n//\n// `createProgram: undefined` is stubbed explicitly because vitest wraps\n// factory mocks in a proxy that throws on missing exports, while a real\n// default-only namespace returns `undefined`.\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 project = await loadProjectInMemory({\n\t\tblob: await newProject({\n\t\t\tsettings: {\n\t\t\t\tlocales: [\"en\"],\n\t\t\t\tbaseLocale: \"en\",\n\t\t\t},\n\t\t}),\n\t});\n\n\tconst bundle: BundleNested = {\n\t\tid: \"greeting.hello\",\n\t\tdeclarations: [],\n\t\tmessages: [\n\t\t\t{\n\t\t\t\tid: \"greeting.hello_en\",\n\t\t\t\tbundleId: \"greeting.hello\",\n\t\t\t\tlocale: \"en\",\n\t\t\t\tselectors: [],\n\t\t\t\tvariants: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"greeting.hello_en_variant\",\n\t\t\t\t\t\tmessageId: \"greeting.hello\",\n\t\t\t\t\t\tmatches: [],\n\t\t\t\t\t\tpattern: [{ type: \"text\", value: \"Hello\" }],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n\tawait insertBundleNested(project.db, bundle);\n\n\tconst output = await compileProject({\n\t\tproject,\n\t\tcompilerOptions: {\n\t\t\temitTsDeclarations: true,\n\t\t},\n\t});\n\n\texpect(output).toHaveProperty(\"runtime.d.ts\");\n\t// the quoted alias distinguishes the two paths: TypeScript 5's CLI would\n\t// emit the invalid `export { greeting_hello as greeting.hello }` instead\n\texpect(output[\"messages/greeting_hello.d.ts\"]).toContain(\n\t\t`export { greeting_hello as \"greeting.hello\" };`\n\t);\n});\n"]}
+{"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,EAEN,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,oEAAoE;AACpE,wEAAwE;AACxE,sEAAsE;AACtE,sEAAsE;AACtE,yEAAyE;AACzE,2DAA2D;AAC3D,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,8CAA8C;AAC9C,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,MAAM,mBAAmB,CAAC;QACzC,IAAI,EAAE,MAAM,UAAU,CAAC;YACtB,QAAQ,EAAE;gBACT,OAAO,EAAE,CAAC,IAAI,CAAC;gBACf,UAAU,EAAE,IAAI;aAChB;SACD,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,GAAiB;QAC5B,EAAE,EAAE,gBAAgB;QACpB,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE;YACT;gBACC,EAAE,EAAE,mBAAmB;gBACvB,SAAS,EAAE,gBAAgB;gBAC3B,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE;oBACT;wBACC,EAAE,EAAE,2BAA2B;wBAC/B,UAAU,EAAE,gBAAgB;wBAC5B,OAAO,EAAE,EAAE;wBACX,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;qBAC3C;iBACD;aACD;SACD;KACD,CAAC;IACF,MAAM,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;QACnC,OAAO;QACP,eAAe,EAAE;YAChB,kBAAkB,EAAE,IAAI;SACxB;KACD,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IAC9C,yEAAyE;IACzE,yEAAyE;IACzE,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 {\n\ttype BundleNested,\n\tinsertBundleNested,\n\tloadProjectInMemory,\n\tnewProject,\n} from \"@inlang/sdk\";\nimport { compileProject } from \"./compile-project.js\";\n\n// Bundlers and CJS interop can deliver the `typescript` module in a\n// default-only shape (`{ default: ts }` without hoisted named exports).\n// TypeScript 5/6 in that shape must still be routed to the in-process\n// compiler API: the CLI fallback intended for TypeScript 7+ would run\n// TypeScript 5's `tsc`, whose declaration emitter produces syntactically\n// invalid unquoted export aliases (`export { x as a.b }`).\n//\n// `createProgram: undefined` is stubbed explicitly because vitest wraps\n// factory mocks in a proxy that throws on missing exports, while a real\n// default-only namespace returns `undefined`.\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 project = await loadProjectInMemory({\n\t\tblob: await newProject({\n\t\t\tsettings: {\n\t\t\t\tlocales: [\"en\"],\n\t\t\t\tbaseLocale: \"en\",\n\t\t\t},\n\t\t}),\n\t});\n\n\tconst bundle: BundleNested = {\n\t\tid: \"greeting.hello\",\n\t\tdeclarations: [],\n\t\tmessages: [\n\t\t\t{\n\t\t\t\tid: \"greeting.hello_en\",\n\t\t\t\tbundle_id: \"greeting.hello\",\n\t\t\t\tlocale: \"en\",\n\t\t\t\tselectors: [],\n\t\t\t\tvariants: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"greeting.hello_en_variant\",\n\t\t\t\t\t\tmessage_id: \"greeting.hello\",\n\t\t\t\t\t\tmatches: [],\n\t\t\t\t\t\tpattern: [{ type: \"text\", value: \"Hello\" }],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n\tawait insertBundleNested(project.db, bundle);\n\n\tconst output = await compileProject({\n\t\tproject,\n\t\tcompilerOptions: {\n\t\t\temitTsDeclarations: true,\n\t\t},\n\t});\n\n\texpect(output).toHaveProperty(\"runtime.d.ts\");\n\t// the quoted alias distinguishes the two paths: TypeScript 5's CLI would\n\t// emit the invalid `export { greeting_hello as greeting.hello }` instead\n\texpect(output[\"messages/greeting_hello.d.ts\"]).toContain(\n\t\t`export { greeting_hello as \"greeting.hello\" };`\n\t);\n});\n"]}

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

@@ -59,13 +59,13 @@ async function newProjectWithMessages() {
         messages: [
             {
                 id: "greeting.hello_en",
-                bundleId: "greeting.hello",
+                bundle_id: "greeting.hello",
                 locale: "en",
                 selectors: [],
                 variants: [
                     {
                         id: "greeting.hello_en_variant",
-                        messageId: "greeting.hello",
+                        message_id: "greeting.hello",
                         matches: [],
                         pattern: [{ type: "text", value: "Hello" }],
                     },
@@ -80,13 +80,13 @@ async function newProjectWithMessages() {
         messages: [
             {
                 id: "balance_en",
-                bundleId: "balance",
+                bundle_id: "balance",
                 locale: "en",
                 selectors: [],
                 variants: [
                     {
                         id: "balance_en_variant",
-                        messageId: "balance",
+                        message_id: "balance",
                         matches: [],
                         pattern: [
                             { type: "text", value: "You have " },

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

@@ -1 +1 @@
-{"version":3,"file":"emit-ts-declarations.test.js","sourceRoot":"","sources":["../../src/compiler/emit-ts-declarations.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { beforeEach, expect, test, vi } from \"vitest\";\nimport { createProject as typescriptProject, ts } from \"@ts-morph/bootstrap\";\nimport {\n\ttype BundleNested,\n\tinsertBundleNested,\n\tloadProjectInMemory,\n\tnewProject,\n} from \"@inlang/sdk\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { compileProject } from \"./compile-project.js\";\n\n// TypeScript 7 (the Go-based compiler, npm `latest` since 7.0.2) no longer\n// ships the in-process compiler API. Its main entry point only exports\n// `version` and `versionMajorMinor` — no `createProgram`, no `ScriptTarget`,\n// no `ModuleKind`. Emitting declarations must go through the `tsc` CLI\n// instead. https://github.com/opral/paraglide-js/issues/711\n//\n// The repo's own `typescript` dev dependency stays on 5.x for the existing\n// tests; this file swaps in the aliased TypeScript 7 package to simulate a\n// user who upgraded.\n//\n// Note: vitest wraps factory mocks in a proxy that throws on missing exports.\n// The real TypeScript 7 module returns `undefined` for them instead, so the\n// classic compiler API surface is stubbed out explicitly to mirror that.\nvi.mock(\"typescript\", async () => {\n\tconst actual =\n\t\tawait vi.importActual<typeof import(\"typescript-go\")>(\"typescript-go\");\n\treturn {\n\t\t...actual,\n\t\tcreateProgram: undefined,\n\t\tcreateCompilerHost: undefined,\n\t\tcreateSourceFile: undefined,\n\t\tScriptTarget: undefined,\n\t\tScriptKind: undefined,\n\t\tModuleKind: undefined,\n\t\tModuleResolutionKind: undefined,\n\t};\n});\n\n// In production, the `typescript` module and the `tsc` CLI resolve to the\n// same package. In this test the module is mocked with the TypeScript 7\n// alias, so the CLI resolution must point at that alias too — otherwise it\n// would find the repo's TypeScript 5 dev dependency. Mutable so the error\n// path can be tested with a broken resolution.\nconst tscResolution = vi.hoisted(() => ({ tscJsPath: \"\" }));\n\nvi.mock(\"./resolve-tsc-js-path.js\", () => ({\n\tresolveTscJsPath: () => tscResolution.tscJsPath,\n}));\n\nconst typescriptGoTscJsPath = path.join(\n\tpath.dirname(\n\t\tcreateRequire(import.meta.url).resolve(\"typescript-go/package.json\")\n\t),\n\t\"lib\",\n\t\"tsc.js\"\n);\n\nbeforeEach(() => {\n\ttscResolution.tscJsPath = typescriptGoTscJsPath;\n});\n\nasync function newProjectWithMessages() {\n\tconst project = await loadProjectInMemory({\n\t\tblob: await newProject({\n\t\t\tsettings: {\n\t\t\t\tlocales: [\"en\"],\n\t\t\t\tbaseLocale: \"en\",\n\t\t\t},\n\t\t}),\n\t});\n\n\t// a message id that is not a valid JS identifier -> quoted export alias\n\tconst quotedAliasBundle: BundleNested = {\n\t\tid: \"greeting.hello\",\n\t\tdeclarations: [],\n\t\tmessages: [\n\t\t\t{\n\t\t\t\tid: \"greeting.hello_en\",\n\t\t\t\tbundleId: \"greeting.hello\",\n\t\t\t\tlocale: \"en\",\n\t\t\t\tselectors: [],\n\t\t\t\tvariants: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"greeting.hello_en_variant\",\n\t\t\t\t\t\tmessageId: \"greeting.hello\",\n\t\t\t\t\t\tmatches: [],\n\t\t\t\t\t\tpattern: [{ type: \"text\", value: \"Hello\" }],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n\n\t// a message with an input so the declarations carry a typed parameter\n\tconst parameterizedBundle: BundleNested = {\n\t\tid: \"balance\",\n\t\tdeclarations: [{ type: \"input-variable\", name: \"amount\" }],\n\t\tmessages: [\n\t\t\t{\n\t\t\t\tid: \"balance_en\",\n\t\t\t\tbundleId: \"balance\",\n\t\t\t\tlocale: \"en\",\n\t\t\t\tselectors: [],\n\t\t\t\tvariants: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"balance_en_variant\",\n\t\t\t\t\t\tmessageId: \"balance\",\n\t\t\t\t\t\tmatches: [],\n\t\t\t\t\t\tpattern: [\n\t\t\t\t\t\t\t{ type: \"text\", value: \"You have \" },\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttype: \"expression\",\n\t\t\t\t\t\t\t\targ: { type: \"variable-reference\", name: \"amount\" },\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{ type: \"text\", value: \" coins.\" },\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n\n\tawait insertBundleNested(project.db, quotedAliasBundle);\n\tawait insertBundleNested(project.db, parameterizedBundle);\n\treturn project;\n}\n\ntest(\"emitTsDeclarations works with TypeScript 7 (tsgo)\", async () => {\n\tconst project = await newProjectWithMessages();\n\n\tfor (const outputStructure of [\n\t\t\"message-modules\",\n\t\t\"locale-modules\",\n\t] as const) {\n\t\tconst output = await compileProject({\n\t\t\tproject,\n\t\t\tcompilerOptions: {\n\t\t\t\temitTsDeclarations: true,\n\t\t\t\toutputStructure,\n\t\t\t\t// path-traversing keys (incl. Windows separators) must be\n\t\t\t\t// silently skipped like on the compiler-API path — neither\n\t\t\t\t// escaping the temp dir nor failing the completeness check\n\t\t\t\tadditionalFiles: {\n\t\t\t\t\t\"../escape.js\": \"export const escape = 1;\",\n\t\t\t\t\t\"foo\\\\..\\\\..\\\\escape.js\": \"export const escape = 1;\",\n\t\t\t\t},\n\t\t\t},\n\t\t});\n\n\t\texpect(output[\"../escape.d.ts\"]).toBeUndefined();\n\t\texpect(output[\"foo\\\\..\\\\..\\\\escape.d.ts\"]).toBeUndefined();\n\n\t\texpect(output).toHaveProperty(\"runtime.d.ts\");\n\t\texpect(output).toHaveProperty(\"messages.d.ts\");\n\t\texpect(output).toHaveProperty(\"registry.d.ts\");\n\t\texpect(output[\"runtime.d.ts\"]).toContain(\"getLocale\");\n\n\t\t// TypeScript 5's declaration emitter drops the quotes around export\n\t\t// aliases that are not valid identifiers (worked around by a custom\n\t\t// transformer on the compiler-API path); tsgo emits them correctly.\n\t\tconst declarationFile =\n\t\t\toutputStructure === \"message-modules\"\n\t\t\t\t? \"messages/greeting_hello.d.ts\"\n\t\t\t\t: \"messages/_index.d.ts\";\n\n\t\texpect(output[declarationFile]).toContain(`as \"greeting.hello\"`);\n\n\t\t// the emitted declarations must typecheck for a consumer\n\t\t// (@ts-morph/bootstrap bundles its own compiler and is unaffected\n\t\t// by the TypeScript 7 mock above)\n\t\tconst tsProject = await typescriptProject({\n\t\t\tuseInMemoryFileSystem: true,\n\t\t\tcompilerOptions: {\n\t\t\t\tmodule: ts.ModuleKind.Node16,\n\t\t\t\tmoduleResolution: ts.ModuleResolutionKind.Node16,\n\t\t\t\tstrict: true,\n\t\t\t},\n\t\t});\n\n\t\tfor (const [fileName, code] of Object.entries(output)) {\n\t\t\tif (fileName.endsWith(\".d.ts\")) {\n\t\t\t\ttsProject.createSourceFile(fileName, code);\n\t\t\t}\n\t\t}\n\n\t\ttsProject.createSourceFile(\n\t\t\t\"test.ts\",\n\t\t\t`\n\t\t\t\timport { \"greeting.hello\" as greetingHello, balance } from \"./messages.js\";\n\n\t\t\t\tgreetingHello() satisfies string;\n\t\t\t\tbalance({ amount: 5 }) satisfies string;\n\t\t\t`\n\t\t);\n\n\t\tconst program = tsProject.createProgram();\n\t\tconst diagnostics = ts.getPreEmitDiagnostics(program);\n\t\tfor (const diagnostic of diagnostics) {\n\t\t\tconsole.error(diagnostic.messageText, diagnostic.file?.fileName);\n\t\t}\n\t\texpect(diagnostics.length).toEqual(0);\n\t}\n});\n\ntest(\"emitTsDeclarations throws a descriptive error when the tsc CLI produces no declarations\", async () => {\n\ttscResolution.tscJsPath = path.join(\n\t\tpath.dirname(typescriptGoTscJsPath),\n\t\t\"does-not-exist.js\"\n\t);\n\n\tconst project = await newProjectWithMessages();\n\n\tawait expect(\n\t\tcompileProject({\n\t\t\tproject,\n\t\t\tcompilerOptions: {\n\t\t\t\temitTsDeclarations: true,\n\t\t\t},\n\t\t})\n\t).rejects.toThrow(/did not produce a declaration file for every compiled/);\n});\n"]}
+{"version":3,"file":"emit-ts-declarations.test.js","sourceRoot":"","sources":["../../src/compiler/emit-ts-declarations.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { beforeEach, expect, test, vi } from \"vitest\";\nimport { createProject as typescriptProject, ts } from \"@ts-morph/bootstrap\";\nimport {\n\ttype BundleNested,\n\tinsertBundleNested,\n\tloadProjectInMemory,\n\tnewProject,\n} from \"@inlang/sdk\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { compileProject } from \"./compile-project.js\";\n\n// TypeScript 7 (the Go-based compiler, npm `latest` since 7.0.2) no longer\n// ships the in-process compiler API. Its main entry point only exports\n// `version` and `versionMajorMinor` — no `createProgram`, no `ScriptTarget`,\n// no `ModuleKind`. Emitting declarations must go through the `tsc` CLI\n// instead. https://github.com/opral/paraglide-js/issues/711\n//\n// The repo's own `typescript` dev dependency stays on 5.x for the existing\n// tests; this file swaps in the aliased TypeScript 7 package to simulate a\n// user who upgraded.\n//\n// Note: vitest wraps factory mocks in a proxy that throws on missing exports.\n// The real TypeScript 7 module returns `undefined` for them instead, so the\n// classic compiler API surface is stubbed out explicitly to mirror that.\nvi.mock(\"typescript\", async () => {\n\tconst actual =\n\t\tawait vi.importActual<typeof import(\"typescript-go\")>(\"typescript-go\");\n\treturn {\n\t\t...actual,\n\t\tcreateProgram: undefined,\n\t\tcreateCompilerHost: undefined,\n\t\tcreateSourceFile: undefined,\n\t\tScriptTarget: undefined,\n\t\tScriptKind: undefined,\n\t\tModuleKind: undefined,\n\t\tModuleResolutionKind: undefined,\n\t};\n});\n\n// In production, the `typescript` module and the `tsc` CLI resolve to the\n// same package. In this test the module is mocked with the TypeScript 7\n// alias, so the CLI resolution must point at that alias too — otherwise it\n// would find the repo's TypeScript 5 dev dependency. Mutable so the error\n// path can be tested with a broken resolution.\nconst tscResolution = vi.hoisted(() => ({ tscJsPath: \"\" }));\n\nvi.mock(\"./resolve-tsc-js-path.js\", () => ({\n\tresolveTscJsPath: () => tscResolution.tscJsPath,\n}));\n\nconst typescriptGoTscJsPath = path.join(\n\tpath.dirname(\n\t\tcreateRequire(import.meta.url).resolve(\"typescript-go/package.json\")\n\t),\n\t\"lib\",\n\t\"tsc.js\"\n);\n\nbeforeEach(() => {\n\ttscResolution.tscJsPath = typescriptGoTscJsPath;\n});\n\nasync function newProjectWithMessages() {\n\tconst project = await loadProjectInMemory({\n\t\tblob: await newProject({\n\t\t\tsettings: {\n\t\t\t\tlocales: [\"en\"],\n\t\t\t\tbaseLocale: \"en\",\n\t\t\t},\n\t\t}),\n\t});\n\n\t// a message id that is not a valid JS identifier -> quoted export alias\n\tconst quotedAliasBundle: BundleNested = {\n\t\tid: \"greeting.hello\",\n\t\tdeclarations: [],\n\t\tmessages: [\n\t\t\t{\n\t\t\t\tid: \"greeting.hello_en\",\n\t\t\t\tbundle_id: \"greeting.hello\",\n\t\t\t\tlocale: \"en\",\n\t\t\t\tselectors: [],\n\t\t\t\tvariants: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"greeting.hello_en_variant\",\n\t\t\t\t\t\tmessage_id: \"greeting.hello\",\n\t\t\t\t\t\tmatches: [],\n\t\t\t\t\t\tpattern: [{ type: \"text\", value: \"Hello\" }],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n\n\t// a message with an input so the declarations carry a typed parameter\n\tconst parameterizedBundle: BundleNested = {\n\t\tid: \"balance\",\n\t\tdeclarations: [{ type: \"input-variable\", name: \"amount\" }],\n\t\tmessages: [\n\t\t\t{\n\t\t\t\tid: \"balance_en\",\n\t\t\t\tbundle_id: \"balance\",\n\t\t\t\tlocale: \"en\",\n\t\t\t\tselectors: [],\n\t\t\t\tvariants: [\n\t\t\t\t\t{\n\t\t\t\t\t\tid: \"balance_en_variant\",\n\t\t\t\t\t\tmessage_id: \"balance\",\n\t\t\t\t\t\tmatches: [],\n\t\t\t\t\t\tpattern: [\n\t\t\t\t\t\t\t{ type: \"text\", value: \"You have \" },\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\ttype: \"expression\",\n\t\t\t\t\t\t\t\targ: { type: \"variable-reference\", name: \"amount\" },\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{ type: \"text\", value: \" coins.\" },\n\t\t\t\t\t\t],\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t};\n\n\tawait insertBundleNested(project.db, quotedAliasBundle);\n\tawait insertBundleNested(project.db, parameterizedBundle);\n\treturn project;\n}\n\ntest(\"emitTsDeclarations works with TypeScript 7 (tsgo)\", async () => {\n\tconst project = await newProjectWithMessages();\n\n\tfor (const outputStructure of [\n\t\t\"message-modules\",\n\t\t\"locale-modules\",\n\t] as const) {\n\t\tconst output = await compileProject({\n\t\t\tproject,\n\t\t\tcompilerOptions: {\n\t\t\t\temitTsDeclarations: true,\n\t\t\t\toutputStructure,\n\t\t\t\t// path-traversing keys (incl. Windows separators) must be\n\t\t\t\t// silently skipped like on the compiler-API path — neither\n\t\t\t\t// escaping the temp dir nor failing the completeness check\n\t\t\t\tadditionalFiles: {\n\t\t\t\t\t\"../escape.js\": \"export const escape = 1;\",\n\t\t\t\t\t\"foo\\\\..\\\\..\\\\escape.js\": \"export const escape = 1;\",\n\t\t\t\t},\n\t\t\t},\n\t\t});\n\n\t\texpect(output[\"../escape.d.ts\"]).toBeUndefined();\n\t\texpect(output[\"foo\\\\..\\\\..\\\\escape.d.ts\"]).toBeUndefined();\n\n\t\texpect(output).toHaveProperty(\"runtime.d.ts\");\n\t\texpect(output).toHaveProperty(\"messages.d.ts\");\n\t\texpect(output).toHaveProperty(\"registry.d.ts\");\n\t\texpect(output[\"runtime.d.ts\"]).toContain(\"getLocale\");\n\n\t\t// TypeScript 5's declaration emitter drops the quotes around export\n\t\t// aliases that are not valid identifiers (worked around by a custom\n\t\t// transformer on the compiler-API path); tsgo emits them correctly.\n\t\tconst declarationFile =\n\t\t\toutputStructure === \"message-modules\"\n\t\t\t\t? \"messages/greeting_hello.d.ts\"\n\t\t\t\t: \"messages/_index.d.ts\";\n\n\t\texpect(output[declarationFile]).toContain(`as \"greeting.hello\"`);\n\n\t\t// the emitted declarations must typecheck for a consumer\n\t\t// (@ts-morph/bootstrap bundles its own compiler and is unaffected\n\t\t// by the TypeScript 7 mock above)\n\t\tconst tsProject = await typescriptProject({\n\t\t\tuseInMemoryFileSystem: true,\n\t\t\tcompilerOptions: {\n\t\t\t\tmodule: ts.ModuleKind.Node16,\n\t\t\t\tmoduleResolution: ts.ModuleResolutionKind.Node16,\n\t\t\t\tstrict: true,\n\t\t\t},\n\t\t});\n\n\t\tfor (const [fileName, code] of Object.entries(output)) {\n\t\t\tif (fileName.endsWith(\".d.ts\")) {\n\t\t\t\ttsProject.createSourceFile(fileName, code);\n\t\t\t}\n\t\t}\n\n\t\ttsProject.createSourceFile(\n\t\t\t\"test.ts\",\n\t\t\t`\n\t\t\t\timport { \"greeting.hello\" as greetingHello, balance } from \"./messages.js\";\n\n\t\t\t\tgreetingHello() satisfies string;\n\t\t\t\tbalance({ amount: 5 }) satisfies string;\n\t\t\t`\n\t\t);\n\n\t\tconst program = tsProject.createProgram();\n\t\tconst diagnostics = ts.getPreEmitDiagnostics(program);\n\t\tfor (const diagnostic of diagnostics) {\n\t\t\tconsole.error(diagnostic.messageText, diagnostic.file?.fileName);\n\t\t}\n\t\texpect(diagnostics.length).toEqual(0);\n\t}\n});\n\ntest(\"emitTsDeclarations throws a descriptive error when the tsc CLI produces no declarations\", async () => {\n\ttscResolution.tscJsPath = path.join(\n\t\tpath.dirname(typescriptGoTscJsPath),\n\t\t\"does-not-exist.js\"\n\t);\n\n\tconst project = await newProjectWithMessages();\n\n\tawait expect(\n\t\tcompileProject({\n\t\t\tproject,\n\t\t\tcompilerOptions: {\n\t\t\t\temitTsDeclarations: true,\n\t\t\t},\n\t\t})\n\t).rejects.toThrow(/did not produce a declaration file for every compiled/);\n});\n"]}

package/dist/compiler/index.d.ts

@@ -5,7 +5,7 @@ export type { ServerRuntime } from "./server/type.js";
 export { compile } from "./compile.js";
 export { compileProject } from "./compile-project.js";
 export { compileBundle } from "./compile-bundle.js";
-export { compileMessage } from "./compile-message.js";
+export { compileMessage, type CompilableMessage, type CompilableVariant, } from "./compile-message.js";
 export { compilePattern } from "./compile-pattern.js";
 export { writeOutput } from "../services/file-handling/write-output.js";
 export { createParaglide } from "./create-paraglide.js";

package/dist/compiler/index.js

@@ -2,7 +2,7 @@ export { defaultCompilerOptions, } from "./compiler-options.js";
 export { compile } from "./compile.js";
 export { compileProject } from "./compile-project.js";
 export { compileBundle } from "./compile-bundle.js";
-export { compileMessage } from "./compile-message.js";
+export { compileMessage, } from "./compile-message.js";
 export { compilePattern } from "./compile-pattern.js";
 export { writeOutput } from "../services/file-handling/write-output.js";
 export { createParaglide } from "./create-paraglide.js";

package/dist/compiler/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,sBAAsB,GAEtB,MAAM,uBAAuB,CAAC;AAgB/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export {\n\tdefaultCompilerOptions,\n\ttype CompilerOptions,\n} from \"./compiler-options.js\";\nexport type {\n\tLocalizedString,\n\tMessagePart,\n\tMessageMarkupAttribute,\n\tMessageMarkupOption,\n\tMessageMarkupAttributes,\n\tMessageMarkupOptions,\n\tMessageMarkupTag,\n\tMessageMarkupSchema,\n\tMessageMetadata,\n\tMessageBundleFunction,\n\tMessageFunction,\n} from \"./types.js\";\nexport type { Runtime } from \"./runtime/type.js\";\nexport type { ServerRuntime } from \"./server/type.js\";\nexport { compile } from \"./compile.js\";\nexport { compileProject } from \"./compile-project.js\";\nexport { compileBundle } from \"./compile-bundle.js\";\nexport { compileMessage } from \"./compile-message.js\";\nexport { compilePattern } from \"./compile-pattern.js\";\nexport { writeOutput } from \"../services/file-handling/write-output.js\";\nexport { createParaglide } from \"./create-paraglide.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,sBAAsB,GAEtB,MAAM,uBAAuB,CAAC;AAgB/B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACN,cAAc,GAGd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export {\n\tdefaultCompilerOptions,\n\ttype CompilerOptions,\n} from \"./compiler-options.js\";\nexport type {\n\tLocalizedString,\n\tMessagePart,\n\tMessageMarkupAttribute,\n\tMessageMarkupOption,\n\tMessageMarkupAttributes,\n\tMessageMarkupOptions,\n\tMessageMarkupTag,\n\tMessageMarkupSchema,\n\tMessageMetadata,\n\tMessageBundleFunction,\n\tMessageFunction,\n} from \"./types.js\";\nexport type { Runtime } from \"./runtime/type.js\";\nexport type { ServerRuntime } from \"./server/type.js\";\nexport { compile } from \"./compile.js\";\nexport { compileProject } from \"./compile-project.js\";\nexport { compileBundle } from \"./compile-bundle.js\";\nexport {\n\tcompileMessage,\n\ttype CompilableMessage,\n\ttype CompilableVariant,\n} from \"./compile-message.js\";\nexport { compilePattern } from \"./compile-pattern.js\";\nexport { writeOutput } from \"../services/file-handling/write-output.js\";\nexport { createParaglide } from \"./create-paraglide.js\";\n"]}

package/dist/compiler/input-alias.d.ts

@@ -0,0 +1,21 @@
+import type { Declaration } from "@inlang/sdk";
+/**
+ * Returns the name of the input a variable holds the unmodified value of, or
+ * `undefined` if the variable can hold anything else.
+ *
+ * Inputs resolve to themselves. A local variable resolves to an input when it
+ * is an un-annotated reference to an input, directly or through a chain of
+ * un-annotated local variables. Annotated locals (`:plural`, `:number`, ...)
+ * and literal values do not resolve, because their value is not the input.
+ *
+ * Message selectors use this to match aliases like the ones ICU MessageFormat 1
+ * imports produce for exact number cases (`=0`) the same way as the input:
+ *
+ * @example
+ *   // .input {$count}
+ *   // .local countPluralExact = {$count}
+ *   // .local countPlural = {$count :plural}
+ *   resolveInputAlias("countPluralExact", declarations) // "count"
+ *   resolveInputAlias("countPlural", declarations) // undefined
+ */
+export declare function resolveInputAlias(name: string, declarations: readonly Declaration[]): string | undefined;

package/dist/compiler/input-alias.js

@@ -0,0 +1,42 @@
+/**
+ * Returns the name of the input a variable holds the unmodified value of, or
+ * `undefined` if the variable can hold anything else.
+ *
+ * Inputs resolve to themselves. A local variable resolves to an input when it
+ * is an un-annotated reference to an input, directly or through a chain of
+ * un-annotated local variables. Annotated locals (`:plural`, `:number`, ...)
+ * and literal values do not resolve, because their value is not the input.
+ *
+ * Message selectors use this to match aliases like the ones ICU MessageFormat 1
+ * imports produce for exact number cases (`=0`) the same way as the input:
+ *
+ * @example
+ *   // .input {$count}
+ *   // .local countPluralExact = {$count}
+ *   // .local countPlural = {$count :plural}
+ *   resolveInputAlias("countPluralExact", declarations) // "count"
+ *   resolveInputAlias("countPlural", declarations) // undefined
+ */
+export function resolveInputAlias(name, declarations) {
+    const visited = new Set();
+    let current = name;
+    while (!visited.has(current)) {
+        visited.add(current);
+        // first declaration wins, consistent with compileVariableAccess()
+        const declaration = declarations.find((candidate) => candidate.name === current);
+        if (!declaration) {
+            return undefined;
+        }
+        if (declaration.type === "input-variable") {
+            return declaration.name;
+        }
+        if (declaration.value.annotation ||
+            declaration.value.arg.type !== "variable-reference") {
+            return undefined;
+        }
+        current = declaration.value.arg.name;
+    }
+    // cyclic local variable references
+    return undefined;
+}
+//# sourceMappingURL=input-alias.js.map

package/dist/compiler/input-alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-alias.js","sourceRoot":"","sources":["../../src/compiler/input-alias.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAChC,IAAY,EACZ,YAAoC;IAEpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,kEAAkE;QAClE,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CACpC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,CACzC,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC3C,OAAO,WAAW,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,IACC,WAAW,CAAC,KAAK,CAAC,UAAU;YAC5B,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,oBAAoB,EAClD,CAAC;YACF,OAAO,SAAS,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,mCAAmC;IACnC,OAAO,SAAS,CAAC;AAClB,CAAC","sourcesContent":["import type { Declaration } from \"@inlang/sdk\";\n\n/**\n * Returns the name of the input a variable holds the unmodified value of, or\n * `undefined` if the variable can hold anything else.\n *\n * Inputs resolve to themselves. A local variable resolves to an input when it\n * is an un-annotated reference to an input, directly or through a chain of\n * un-annotated local variables. Annotated locals (`:plural`, `:number`, ...)\n * and literal values do not resolve, because their value is not the input.\n *\n * Message selectors use this to match aliases like the ones ICU MessageFormat 1\n * imports produce for exact number cases (`=0`) the same way as the input:\n *\n * @example\n *   // .input {$count}\n *   // .local countPluralExact = {$count}\n *   // .local countPlural = {$count :plural}\n *   resolveInputAlias(\"countPluralExact\", declarations) // \"count\"\n *   resolveInputAlias(\"countPlural\", declarations) // undefined\n */\nexport function resolveInputAlias(\n\tname: string,\n\tdeclarations: readonly Declaration[]\n): string | undefined {\n\tconst visited = new Set<string>();\n\tlet current = name;\n\n\twhile (!visited.has(current)) {\n\t\tvisited.add(current);\n\t\t// first declaration wins, consistent with compileVariableAccess()\n\t\tconst declaration = declarations.find(\n\t\t\t(candidate) => candidate.name === current\n\t\t);\n\t\tif (!declaration) {\n\t\t\treturn undefined;\n\t\t}\n\t\tif (declaration.type === \"input-variable\") {\n\t\t\treturn declaration.name;\n\t\t}\n\t\tif (\n\t\t\tdeclaration.value.annotation ||\n\t\t\tdeclaration.value.arg.type !== \"variable-reference\"\n\t\t) {\n\t\t\treturn undefined;\n\t\t}\n\t\tcurrent = declaration.value.arg.name;\n\t}\n\n\t// cyclic local variable references\n\treturn undefined;\n}\n"]}

package/dist/compiler/input-alias.test.d.ts

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

package/dist/compiler/input-alias.test.js

@@ -0,0 +1,58 @@
+import { expect, test } from "vitest";
+import { resolveInputAlias } from "./input-alias.js";
+const alias = (name, target) => ({
+    type: "local-variable",
+    name,
+    value: {
+        type: "expression",
+        arg: { type: "variable-reference", name: target },
+    },
+});
+test("resolves inputs and chains of un-annotated aliases to the input", () => {
+    const declarations = [
+        { type: "input-variable", name: "count" },
+        alias("a", "count"),
+        alias("b", "a"),
+    ];
+    expect(resolveInputAlias("count", declarations)).toBe("count");
+    expect(resolveInputAlias("a", declarations)).toBe("count");
+    expect(resolveInputAlias("b", declarations)).toBe("count");
+});
+test("does not resolve annotated locals, literals, aliases of them, or undeclared names", () => {
+    const declarations = [
+        { type: "input-variable", name: "count" },
+        {
+            type: "local-variable",
+            name: "countPlural",
+            value: {
+                type: "expression",
+                arg: { type: "variable-reference", name: "count" },
+                annotation: { type: "function-reference", name: "plural", options: [] },
+            },
+        },
+        alias("pluralAlias", "countPlural"),
+        {
+            type: "local-variable",
+            name: "constant",
+            value: { type: "expression", arg: { type: "literal", value: "0" } },
+        },
+        alias("undeclaredAlias", "missing"),
+    ];
+    expect(resolveInputAlias("countPlural", declarations)).toBeUndefined();
+    expect(resolveInputAlias("pluralAlias", declarations)).toBeUndefined();
+    expect(resolveInputAlias("constant", declarations)).toBeUndefined();
+    expect(resolveInputAlias("undeclaredAlias", declarations)).toBeUndefined();
+    expect(resolveInputAlias("missing", declarations)).toBeUndefined();
+});
+test("terminates on cyclic aliases", () => {
+    const declarations = [
+        alias("self", "self"),
+        alias("a", "b"),
+        alias("b", "c"),
+        alias("c", "a"),
+    ];
+    expect(resolveInputAlias("self", declarations)).toBeUndefined();
+    expect(resolveInputAlias("a", declarations)).toBeUndefined();
+    expect(resolveInputAlias("c", declarations)).toBeUndefined();
+});
+//# sourceMappingURL=input-alias.test.js.map

package/dist/compiler/input-alias.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-alias.test.js","sourceRoot":"","sources":["../../src/compiler/input-alias.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, test } from \"vitest\";\nimport type { Declaration } from \"@inlang/sdk\";\nimport { resolveInputAlias } from \"./input-alias.js\";\n\nconst alias = (name: string, target: string): Declaration => ({\n\ttype: \"local-variable\",\n\tname,\n\tvalue: {\n\t\ttype: \"expression\",\n\t\targ: { type: \"variable-reference\", name: target },\n\t},\n});\n\ntest(\"resolves inputs and chains of un-annotated aliases to the input\", () => {\n\tconst declarations: Declaration[] = [\n\t\t{ type: \"input-variable\", name: \"count\" },\n\t\talias(\"a\", \"count\"),\n\t\talias(\"b\", \"a\"),\n\t];\n\n\texpect(resolveInputAlias(\"count\", declarations)).toBe(\"count\");\n\texpect(resolveInputAlias(\"a\", declarations)).toBe(\"count\");\n\texpect(resolveInputAlias(\"b\", declarations)).toBe(\"count\");\n});\n\ntest(\"does not resolve annotated locals, literals, aliases of them, or undeclared names\", () => {\n\tconst declarations: Declaration[] = [\n\t\t{ type: \"input-variable\", name: \"count\" },\n\t\t{\n\t\t\ttype: \"local-variable\",\n\t\t\tname: \"countPlural\",\n\t\t\tvalue: {\n\t\t\t\ttype: \"expression\",\n\t\t\t\targ: { type: \"variable-reference\", name: \"count\" },\n\t\t\t\tannotation: { type: \"function-reference\", name: \"plural\", options: [] },\n\t\t\t},\n\t\t},\n\t\talias(\"pluralAlias\", \"countPlural\"),\n\t\t{\n\t\t\ttype: \"local-variable\",\n\t\t\tname: \"constant\",\n\t\t\tvalue: { type: \"expression\", arg: { type: \"literal\", value: \"0\" } },\n\t\t},\n\t\talias(\"undeclaredAlias\", \"missing\"),\n\t];\n\n\texpect(resolveInputAlias(\"countPlural\", declarations)).toBeUndefined();\n\texpect(resolveInputAlias(\"pluralAlias\", declarations)).toBeUndefined();\n\texpect(resolveInputAlias(\"constant\", declarations)).toBeUndefined();\n\texpect(resolveInputAlias(\"undeclaredAlias\", declarations)).toBeUndefined();\n\texpect(resolveInputAlias(\"missing\", declarations)).toBeUndefined();\n});\n\ntest(\"terminates on cyclic aliases\", () => {\n\tconst declarations: Declaration[] = [\n\t\talias(\"self\", \"self\"),\n\t\talias(\"a\", \"b\"),\n\t\talias(\"b\", \"c\"),\n\t\talias(\"c\", \"a\"),\n\t];\n\n\texpect(resolveInputAlias(\"self\", declarations)).toBeUndefined();\n\texpect(resolveInputAlias(\"a\", declarations)).toBeUndefined();\n\texpect(resolveInputAlias(\"c\", declarations)).toBeUndefined();\n});\n"]}

package/dist/compiler/message-locals.d.ts

@@ -0,0 +1,46 @@
+import type { Declaration, LocalVariable, Pattern } from "@inlang/sdk";
+import type { CompilePatternMode } from "./compile-pattern.js";
+/**
+ * Returns the names of the variables a compiled pattern reads.
+ *
+ * Mirrors what `compilePattern()` emits: expression arguments, the options of
+ * registry function annotations (unknown annotations are dropped from the
+ * output), and in `parts` mode the options of markup.
+ */
+export declare function patternVariableReferences(pattern: Pattern, mode: CompilePatternMode): string[];
+/**
+ * Returns the names of the variables a compiled local variable reads.
+ *
+ * Mirrors what `compileLocalVariable()` emits: the argument and the options
+ * of a registry function annotation (unknown annotations are dropped).
+ */
+export declare function localVariableReferences(declaration: LocalVariable): string[];
+/**
+ * Resolves the local variables a message function has to declare.
+ *
+ * Starting from the variables the function body reads (patterns, match
+ * conditions), it follows local variables to the variables they read in turn
+ * and returns only the locals that are read, ordered so that every local is
+ * declared after the locals it reads. Locals the message does not read are
+ * left out, so the output passes `noUnusedLocals`.
+ *
+ * Throws if a read variable is not declared, or if locals reference each
+ * other in a cycle, because the emitted code would throw a `ReferenceError`
+ * at runtime.
+ *
+ * @example
+ *   // .input {$count}
+ *   // .local countPlural = {$count :plural}
+ *   // .local countPluralExact = {$count}
+ *   resolveMessageLocals({ reads: ["countPlural"], ... })
+ *   // { locals: [countPlural], readsInput: true }
+ */
+export declare function resolveMessageLocals(args: {
+    reads: Iterable<string>;
+    declarations: readonly Declaration[];
+    bundleId: string;
+    locale: string;
+}): {
+    locals: LocalVariable[];
+    readsInput: boolean;
+};