@inlang/paraglide-js 1.3.6 → 1.4.0

package/README.md

@@ -1,33 +1,44 @@
-[<img src="https://cdn.loom.com/sessions/thumbnails/a8365ec4fa2c4f6bbbf4370cf22dd7f6-with-play.gif" width="100%" /> Watch the demo of Paraglide JS](https://www.youtube.com/watch?v=-YES3CCAG90)
+[<img src="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/header.png" alt="Dead Simple i18n. Typesafe, Small Footprint, Treeshsakeable Messages, IDE Integration, Framework Agnostic" width="10000000px" />](https://www.youtube.com/watch?v=-YES3CCAG90)
 
-<!-- ![Paraglide JS header image](https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/paraglide-js-header.png) -->
+# Why Paraglide?
 
-Get started with:
+<doc-features>
+  <doc-feature title="Tiny Runtime" image="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/bundlesize-feature.png"></doc-feature>
+  <doc-feature title="Fully Typesafe" image="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/typesafety-feature.png"></doc-feature>
+  <doc-feature title="Only Ship Used Messages" image="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/unused-translations.png"></doc-feature>
+   <doc-feature title="Sherlock VS Code Extension" image="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/sherlock-preview.png"></doc-feature>
+</doc-features>
 
-```bash
-npx @inlang/paraglide-js@latest init
-```
 
-# Features
+With Paraglide's treeshakeable messages, each page only loads the messages it actually uses. Incremental loading like this would usually take forever to get right, with Paraglide you get it for free.
 
-<doc-features>
-  <doc-feature title="Only used translations are shipped" image="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/unused-translations.png"></doc-feature>
-  <doc-feature title="Tiny Bundle-Size" image="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/reduced-payload.png"></doc-feature>
-  <doc-feature title="Typesafe" image="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/typesafe.png"></doc-feature>
-</doc-features>
+# Use it with your Favorite Framework
+
+Paraglide is framework agnostic, but there are framework-specific libraries available. If there is one for your framework you will want to follow its documentation instead. If there isn't, read on.
+
+<doc-links>
+	<doc-link title="Adapter for NextJS" icon="tabler:brand-nextjs" href="/m/osslbuzt/paraglide-next-i18n" description="Go to Library"></doc-link>
+    <doc-link title="Adapter for SvelteKit" icon="simple-icons:svelte" href="/m/dxnzrydw/paraglide-sveltekit-i18n" description="Go to Library"></doc-link>
+    <doc-link title="Adapter for Astro" icon="devicon-plain:astro" href="/m/iljlwzfs/paraglide-astro-i18n" description="Go to Library"></doc-link>
+    <doc-link title="Adapter for SolidJS" icon="tabler:brand-solidjs" href="/m/n860p17j/paraglide-solidstart-i18n" description="Go to Library"></doc-link>
+	<doc-link title="Adapter for Remix" icon="simple-icons:remix" href="/m/fnhuwzrx/paraglide-remix-i18n" description="Go to Library"></doc-link>
+	<doc-link title="Or write your own" icon="ph:sparkle-fill" href="#writing-an-adapter" description="Learn How"></doc-link>
+</doc-links>
 
-### Treeshaking
+# People Love It
 
-<doc-figure src="https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/tree-shaking.jpg" alt="An illustration explaining the benefits of treeshaking in software" caption="How Paraglide JS treeshaking works">
-</doc-figure>
+A few recent comments.
 
-Treeshaking gives us superpowers. With it, each page of your app only loads the messages that it actually uses. Incremental loading like this would usually take hours of manual tweaking to get right. With Paraglide-JS you get it for free. Say goodbye to huge bundles.
+<doc-comments>
+<doc-comment text="Just tried Paraglide JS from @inlangHQ. This is how i18n should be done! Totally new level of DX for both implementation and managing translations! Superb support for SvelteKit as well ⭐" author="Patrik Engborg" icon="mdi:twitter" data-source="https://twitter.com/patrikengborg/status/1747260930873053674"></doc-comment>
+<doc-comment text="I was messing with various i18n frameworks and tools in combination with Astro, and must say that Paraglide was the smoothest experience. I have migrated my website from i18next and it was a breeze. SSG and SSR worked out of the box (which was the first one for me), and overall DX is great. Thanks for your work!" author="Dalibor Hon" icon="mdi:discord" data-source="https://discord.com/channels/897438559458430986/1096039983116202034/1220796380772307004"></doc-comment>
+<doc-comment text="Awesome library 🙂 Thanks so much! 1) The docs were simple and straight forward 2) Everything just worked.. no headaches" author="Dimitry" icon="mdi:discord" data-source="https://discord.com/channels/897438559458430986/1083724234142011392/1225658097016766574"></doc-comment>
+<doc-comment text="Thank you for that huge work you have done and still doing!" author="ZerdoX-x" icon="mdi:github"></doc-comment>
+</doc-comments>
 
 # Getting started
 
-### 1. Initialize paraglide-js
-
-Initialize ParaglideJS whith:
+To use Paraglide standalone without a framework, run the following command:
 
 ```bash
 npx @inlang/paraglide-js@latest init
@@ -35,41 +46,36 @@ npx @inlang/paraglide-js@latest init
 
 This will:
 
-1. Install necessary dependencies
-2. Add the Paraglide compiler to your `build` script
-3. Set up configuration files
+- Install necessary dependencies
+- Generate a `messages/` folder where your translation files live
+- Add the Paraglide compiler to your `build` script in `package.json`
+- Create necessary configuration files
 
-### 2. Set up an adapter (optional)
+Running the Paraglide compiler will generate a `src/paraglide` folder. This folder contains all the code that you will use in your app.
 
-Adapters are framework-integrations for Paraglide. If you are using a framework, using an adapter is recommended , but not required.
+## Adding and Editing Messages
 
-<doc-links>
-	<doc-link title="Adapter for NextJS" icon="tabler:brand-nextjs" href="/m/osslbuzt/paraglide-next-i18n" description="Go to Library"></doc-link>
-    <doc-link title="Adapter for SvelteKit" icon="simple-icons:svelte" href="/m/dxnzrydw/paraglide-sveltekit-i18n" description="Go to Library"></doc-link>
-    <doc-link title="Adapter for Astro" icon="devicon-plain:astro" href="/m/iljlwzfs/paraglide-astro-i18n" description="Go to Library"></doc-link>
-    <doc-link title="Adapter for SolidJS" icon="tabler:brand-solidjs" href="/m/n860p17j/paraglide-solidstart-i18n" description="Go to Library"></doc-link>
-</doc-links>
-
-#### Alternatively, [you can write your own adapter](#writing-an-adapter)
-
-# Usage
-
-Running your `build` script will generate a `src/paraglide` folder. This folder contains all the code that you need to use paraglide-js.
-
-## Adding Messages
+Messages are stored in `messages/{lang}.json`. To add a message simply add a key-value pair. You can add parameters with curly braces.
 
-By default, paraglide expects your messages to be in `messages/{lang}.json`.
-
-```json
+```diff
+// messages/en.json
 {
-	"hello": "Hello world!"
-	"loginHeader": "Hello {name}, please login to continue."
+	"$schema": "https://inlang.com/schema/inlang-message-format",
++ 	"greeting": "Hello {name}!"
 }
 ```
 
-## Using Messages
+Make sure to re-run the paraglide compiler after editing your messages.
 
-You can import messages with `import * as m from "./paraglide/messages"`. Don't worry, your bundler will only include the messages that you actually use.
+```bash
+npx @inlang/paraglide-js compile --project ./project.inlang --outdir ./src/paraglide
+```
+
+If you are using Bundler, you can use one of the [Bundler Plugins](#usage-with-a-bundler) to recompile automatically.
+
+## Using Messages in Code
+
+After running the compiler, you can import messages with `import * as m from "./paraglide/messages"`.
 
 ```js
 import * as m from "./paraglide/messages.js"
@@ -79,7 +85,7 @@ m.hello() // Hello world!
 m.loginHeader({ name: "Samuel" }) // Hello Samuel, please login to continue.
 ```
 
-If you want to choose between messages at runtime, you can create a record of messages and index into it.
+To choose between messages at runtime create a map of messages and index into it.
 
 ```ts
 import * as m from "./paraglide/messages.js"
@@ -94,24 +100,6 @@ const season = {
 const msg = season["spring"]() // Hello spring!
 ```
 
-### Using the [Sherlock IDE Extension](https://inlang.com/m/r7kp499g/app-inlang-ideExtension) (optional)
-
-[Sherlock](https://inlang.com/m/r7kp499g/app-inlang-ideExtension) integrates with paraglide to give you the optimal dev-experience.
-
-![VsCode screenshot showing Sherlock adding inlay hints next to messages and making an "extract message" code action available for hardcoded text](https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/sherlock-preview.png)
-
-## Adding Languages
-
-You can declare which languages you support in `./project.inlang/settings.json`.
-```json
-// project.inlang/settings.json
-{
-	"languageTags": ["en", "de"]
-}
-```
-
-Then create another `messages/{lang}.json` file and get translating!
-
 ## Setting the language
 
 You can set the [language tag](https://www.inlang.com/m/8y8sxj09/library-inlang-languageTag) by calling `setLanguageTag()`. Any subsequent calls to either `languageTag()` or a message function will use the new language tag.
@@ -129,13 +117,13 @@ m.hello() // Hello world!
 
 The [language tag](https://www.inlang.com/m/8y8sxj09/library-inlang-languageTag) is global, so you need to be careful with it on the server to make sure multiple requests don't interfere with each other.
 
-You will need to call `setLanguageTag` on both the server and the client, since they run in separate processes.
+You will need to call `setLanguageTag` on both the server and the client since they run in separate processes.
 
 ## Reacting to language changes
 
 Messages aren't reactive, so you will need to trigger a re-render when the language changes. You can register a callback using `onSetLanguageTag()`. It is called whenever the [language tag](https://www.inlang.com/m/8y8sxj09/library-inlang-languageTag) changes.
 
-If you are using an adapter this is likely done for you.
+If you are using a [framework-specific library](#use-it-with-your-favorite-framework) this is done for you.
 
 ```js
 import { setLanguageTag, onSetLanguageTag } from "./paraglide/runtime.js"
@@ -149,10 +137,10 @@ setLanguageTag("de") // The language changed to de
 setLanguageTag("en") // The language changed to en
 ```
 
-There are a few things to know about `onSetLanguageTag()`:
+A few things to know about `onSetLanguageTag()`:
 
 - You can only register one listener. If you register a second listener it will throw an error.
-- `setLanguageTag` shouldn't be used on the server.
+- `onSetLanguageTag` shouldn't be used on the server.
 
 ## Getting a message in a specific language
 
@@ -173,9 +161,9 @@ const msg = m.hello({ name: "Samuel" }, { languageTag: "de" }) // Hallo Samuel!
 ## Lazy-Loading
 
 Paraglide consciously discourages lazy-loading translations since it seriously hurts
-your web-vitals. Learn more about why lazy-loading is bad & what to do instead in [this blog post](https://inlang.com/g/mqlyfa7l/guide-lorissigrist-dontlazyload).
+your Web Vitals. Learn more about why lazy-loading is bad & what to do instead in [our blog post on lazy-loading](https://inlang.com/g/mqlyfa7l/guide-lorissigrist-dontlazyload). 
 
-If you _really_ want to do it anway, you can lazily import the language-specific message files. Be careful with this.
+If you want to do it anyway, lazily import the language-specific message files. Be careful with this.
 
 ```ts
 const lazyGerman = await import("./paraglide/messages/de.js")
@@ -184,7 +172,7 @@ lazyGerman.hello() // Hallo Welt
 
 ## Usage with a Bundler
 
-If you are using a bundler you should use the corresponding plugin. The plugin will keep your message-functions up-to-date by compiling whenever your messages change and before build.
+If you are using a bundler you should use the corresponding plugin. The plugin will keep your Message Functions up-to-date by compiling whenever your messages change and before building your app.
 
 <doc-links>
 	<doc-link title="Vite Plugin" icon="tabler:brand-vite" href="https://github.com/opral/monorepo/tree/main/inlang/source-code/paraglide/paraglide-js-adapter-vite" description="Go to Github"></doc-link>
@@ -192,9 +180,44 @@ If you are using a bundler you should use the corresponding plugin. The plugin w
     <doc-link title="Webpack Plugin" icon="mdi:webpack" href="https://github.com/opral/monorepo/tree/main/inlang/source-code/paraglide/paraglide-js-adapter-webpack" description="Go to Github"></doc-link>
 </doc-links>
 
+## Configuration
+
+Most of the configuration is done in `./project.inlang/settings.json`, except for paraglide's output directory, which needs to be passed in when calling the compiler.
+
+### Languages
+
+You can declare which languages you support in the `languageTags` array.
+
+```json
+// project.inlang/settings.json
+{
+	"languageTags": ["en", "de"]
+}
+```
+
+Create the corresponding `messages/{lang}.json` files and get translating!
+
+### Moving the Translation Files
+
+If you want your language files to be in a different location you can change the `pathPattern` of the [Inlang-Message-Format plugin](https://inlang.com/m/reootnfj/plugin-inlang-messageFormat).
+
+```diff
+// project.inlang/settings.json
+"plugin.inlang.messageFormat": {
+-	"pathPattern": "./messages/{languageTag}.json"
++	"pathPattern": "./i18n/{languageTag}.json"
+},
+```
+
+### Lint Rules
+
+If you're using the [Sherlock VS Code extension](https://inlang.com/m/r7kp499g/app-inlang-ideExtension) you might see warnings about certain messages. Perhaps they're duplicates, perhaps they're missing in one language. 
+
+You can configure which lint-rules are active in `./project.inlang/settings.json`. Simply add or remove them from the `modules` array.
+
 # Playground
 
-Find examples for how to use paraglide on codesandbox or in [our GitHub repository](https://github.com/opral/monorepo/tree/main/inlang/source-code/paraglide).
+Find examples of how to use Paraglide on CodeSandbox or in [our GitHub repository](https://github.com/opral/monorepo/tree/main/inlang/source-code/paraglide).
 
 <doc-links>
     <doc-link title="NextJS + Paraglide JS" icon="lucide:codesandbox" href="https://stackblitz.com/~/LorisSigrist/paraglide-next-app-router-example" description="Play around with NextJS and Paraglide JS"></doc-link>
@@ -208,11 +231,11 @@ ParaglideJS leverages a compiler to generate vanilla JavaScript functions from y
 
 Message Functions are fully typed using JSDoc. They are exported individually from the `messages.js` file making them tree-shakable. They aren't reactive, they just return a string.
 
-This avoids many edge cases associated with reactivity, lazy-loading and namespacing that other i18n libraries have to work around.
+This avoids many edge cases associated with reactivity, lazy-loading, and namespacing that other i18n libraries have to work around.
 
 In addition to the message functions, ParaglideJS also emits a runtime. The runtime is used to set the language tag. It contains less than 50 LOC (lines of code) and is less than 300 bytes minified & gzipped.
 
-![paraglide JS architecture](https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/architecture.svg)
+![Diagram of the Paraglide Compiler Architecture](https://cdn.jsdelivr.net/gh/opral/monorepo@latest/inlang/source-code/paraglide/paraglide-js/assets/architecture.svg)
 
 Paraglide consists of four main parts:
 
@@ -250,7 +273,7 @@ export const hello = (params) => `Hello ${params.name}!`
 
 ## Messages
 
-By convention we import the compiled funcitions with a wildcard import.
+By convention, we import the compiled functions with a wildcard import.
 
 ```js
 import * as m from "../paraglide/messages.js"
@@ -260,29 +283,33 @@ Bundlers like Rollup, Webpack, or Turbopack tree-shake the messages that are not
 
 # Writing an Adapter
 
-An "Adapter" is a library that integrates with a framework's liefcycle and does two things:
+An "Adapter" is a library that integrates with a framework's lifecycle and does two things:
 
 1. Calls `setLanguageTag()` at appropriate times to set the language
 2. Reacts to `onSetLanguageTag()`, usually by navigating or relading the page.
 
-This example adapts Paraglide to a fictitious fullstack framework.
+This example adapts Paraglide to a fictitious full-stack framework.
 
 ```tsx
-import { setLanguageTag, onSetLanguageTag, type AvailableLanguageTag } from "../paraglide/runtime.js"
+import {
+	setLanguageTag,
+	onSetLanguageTag,
+	type AvailableLanguageTag,
+} from "../paraglide/runtime.js"
 import { isServer, isClient, request, render } from "@example/framework"
 import { detectLanguage } from "./utils.js"
 
 if (isServer) {
-	// On the server the language tag needs to be resolved on a per-request basis. 
+	// On the server the language tag needs to be resolved on a per-request basis.
 	// Pass a getter function that resolves the language from the correct request
 
-	const detectLanguage = (request: Request) : AvailableLanguageTag => {
+	const detectLanguage = (request: Request): AvailableLanguageTag => {
 		//your logic ...
 	}
 	setLanguageTag(() => detectLanguage(request))
 }
 
-if(isClient) {
+if (isClient) {
 	// On the client, the language tag can be resolved from
 	// the document's html lang tag.
 	setLanguageTag(() => document.documentElement.lang)
@@ -304,20 +331,6 @@ render((page) => (
 ))
 ```
 
-# Community
-
-We are grateful for all the support we get from the community. Here are a few comments we've received recently.
-
-If you have any feedback / problems, please let us know on [GitHub](https://github.com/opral/inlang-paraglide-js/issues/new)
-
-<doc-comments>
-<doc-comment text="Just tried Paraglide JS from @inlangHQ. This is how i18n should be done! Totally new level of DX for both implementation and managing translations! Superb support for SvelteKit as well ⭐" author="Patrik Engborg" icon="mdi:twitter" data-source="https://twitter.com/patrikengborg/status/1747260930873053674"></doc-comment>
-<doc-comment text="I was messing with various i18n frameworks and tools in combination with Astro, and i must say that Paraglide was the smoothest experience. I have migrated my website from i18next and it was a breeze. SSG and SSR worked out of the box (which was the first one for me), and overall DX is great. Thanks for your work!" author="Dally H" icon="mdi:discord" data-source="https://discord.com/channels/897438559458430986/1096039983116202034/1220796380772307004"></doc-comment>
-<doc-comment text="The lib is great guys!" author="ktarmyshov" icon="mdi:github"></doc-comment>
-<doc-comment text="Thank you for that huge work you have done and still doing!" author="ZerdoX-x" icon="mdi:github"></doc-comment>
-<doc-comment text="Thanks for all the great work @Samuel Stroschein" author="Willem" icon="mdi:discord"></doc-comment>
-</doc-comments>
-
 # Roadmap
 
 Of course, we're not done yet! We plan on adding the following features to Paraglide JS soon:
@@ -325,6 +338,7 @@ Of course, we're not done yet! We plan on adding the following features to Parag
 - [ ] Pluralization ([Join the Discussion](https://github.com/opral/monorepo/discussions/2025))
 - [ ] Formatting of numbers and dates ([Join the Discussion](https://github.com/opral/monorepo/discussions/992))
 - [ ] Markup Placeholders ([Join the Discussion](https://github.com/opral/monorepo/discussions/913))
+- [ ] Even Smaller Output
 
 # Talks
 
@@ -335,9 +349,9 @@ Of course, we're not done yet! We plan on adding the following features to Parag
 
 # Tooling
 
-Paraglide JS is part of the Inlang ecosystem and integrates nicely with all the other Inlang compatible tools.
+Paraglide JS is part of the Inlang ecosystem and integrates nicely with all the other Inlang-compatible tools.
 
-As a developer, you will love the [Sherlock IDE extension](http://localhost:4001/m/r7kp499g/app-inlang-ideExtension).
+As a developer, you will love the [Sherlock VS Code extension](https://inlang.com/m/r7kp499g/app-inlang-ideExtension).
 
 If you are working with translators or designers you will find these tools useful:
 

package/dist/cli/commands/compile/command.d.ts

@@ -1,2 +1,3 @@
-import { Command } from "commander";
+import { Command } from 'commander';
+
 export declare const compileCommand: Command;

package/dist/cli/commands/init/cli-utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * One step in a CLI chain.
+ * Defines which types the context needs to extend and how it extends the context
+ *
+ * Cli Steps can be chained to slowly build up the context over time
+ *
+ * @example
+ * ```ts
+ * const step1:  CliStep<unknown, { foo: string }> = async (ctx) => {
+ *    return {...ctx, foo: "hello" }
+ * }
+ *
+ * const step2: CliStep<{ foo: string }, { bar: number }> = async (ctx) => {
+ *   return { ...ctx, bar: 42 }
+ * }
+ *
+ * const initial = { baz: "baz" } as const;
+ * const ctx1 = await step1(initial);
+ * const ctx2 = await step2(ctx1);
+ *
+ * ctx2 // Has type { foo: string, bar: number, baz: "baz" }
+ * ```
+ */
+export type CliStep<In extends object, Out> = <Ctx extends In>(ctx: Ctx) => Promise<Ctx & Out>;

package/dist/cli/commands/init/command.d.ts

@@ -1,35 +1,70 @@
-import { Command } from "commander";
-import { Logger } from "../../../services/logger/index.js";
-import { type Repository } from "@lix-js/client";
-type Context = {
-    logger: Logger;
-    repo: Repository;
-};
+import { CliStep } from './cli-utils.js';
+import { Repository } from '@lix-js/client';
+import { Logger } from '~/services/logger/index.js';
+import { InlangProject } from '@inlang/sdk';
+import { Command } from 'commander';
+
 export declare const initCommand: Command;
-export declare const initializeInlangProject: (ctx: Context) => Promise<string>;
-export declare const maybeAddVsCodeExtension: (args: {
+export declare const initializeInlangProject: CliStep<{
+    repo: Repository;
+    logger: Logger;
+}, {
+    project: InlangProject;
+    /** Relative path to the project */
     projectPath: string;
-}, ctx: Context) => Promise<void>;
-export declare const addParaglideJsToDevDependencies: (ctx: Context) => Promise<void>;
-export declare const findExistingInlangProjectPath: (ctx: Context) => Promise<string | undefined>;
-export declare const existingProjectFlow: (args: {
+}>;
+export declare const maybeAddVsCodeExtension: CliStep<{
+    repo: Repository;
+    logger: Logger;
+    project: InlangProject;
+}, unknown>;
+export declare const addParaglideJsToDevDependencies: CliStep<{
+    repo: Repository;
+    logger: Logger;
+}, unknown>;
+export declare const findExistingInlangProjectPath: (repo: Repository) => Promise<string | undefined>;
+export declare const determineOutdir: CliStep<{
+    logger: Logger;
+}, {
+    /** Relative path to the output directory */
+    outdir: string;
+}>;
+export declare const existingProjectFlow: (ctx: {
     existingProjectPath: string;
-}, ctx: Context) => Promise<undefined>;
-export declare const createNewProjectFlow: (ctx: Context) => Promise<undefined>;
-export declare const checkIfPackageJsonExists: (ctx: Context) => Promise<undefined>;
-export declare const checkIfUncommittedChanges: (ctx: Context) => Promise<void>;
-export declare const addCompileStepToPackageJSON: (args: {
+    repo: Repository;
+    logger: Logger;
+}) => Promise<InlangProject>;
+export declare const createNewProjectFlow: (ctx: {
+    repo: Repository;
+    logger: Logger;
+}) => Promise<InlangProject>;
+export declare const checkIfPackageJsonExists: CliStep<{
+    logger: Logger;
+    repo: Repository;
+}, unknown>;
+export declare const checkIfUncommittedChanges: CliStep<{
+    logger: Logger;
+}, unknown>;
+export declare const addCompileStepToPackageJSON: CliStep<{
+    repo: Repository;
+    logger: Logger;
     projectPath: string;
-}, ctx: Context) => Promise<undefined>;
+    outdir: string;
+}, unknown>;
 /**
  * Ensures that the moduleResolution compiler option is set to "bundler" or similar in the tsconfig.json.
  *
  * Otherwise, types defined in `package.exports` are not resolved by TypeScript. Leading to type
  * errors with Paraglide-JS.
  */
-export declare const maybeChangeTsConfigModuleResolution: (ctx: Context) => Promise<void>;
+export declare const maybeChangeTsConfigModuleResolution: CliStep<{
+    repo: Repository;
+    logger: Logger;
+}, unknown>;
 /**
  * Paraligde JS compiles to JS with JSDoc comments. TypeScript doesn't allow JS files by default.
  */
-export declare const maybeChangeTsConfigAllowJs: (ctx: Context) => Promise<void>;
-export {};
+export declare const maybeChangeTsConfigAllowJs: CliStep<{
+    repo: Repository;
+    logger: Logger;
+}, unknown>;

package/dist/cli/commands/init/defaults.d.ts

@@ -11,3 +11,4 @@ export declare function getNewProjectTemplate(): {
     };
 };
 export declare const DEFAULT_PROJECT_PATH = "./project.inlang";
+export declare const DEFAULT_OUTDIR = "./src/paraglide";

package/dist/cli/main.d.ts

@@ -1,2 +1,3 @@
-import { Command } from "commander";
+import { Command } from 'commander';
+
 export declare const cli: Command;

package/dist/compiler/compile.d.ts

@@ -1,4 +1,5 @@
-import { ProjectSettings, type Message } from "@inlang/sdk";
+import { ProjectSettings, Message } from '@inlang/sdk';
+
 /**
  * A compile function takes a list of messages and project settings and returns
  * a map of file names to file contents.

package/dist/compiler/compileMessage.d.ts

@@ -1,4 +1,5 @@
-import { LanguageTag, type Message } from "@inlang/sdk";
+import { LanguageTag, Message } from '@inlang/sdk';
+
 type Resource = {
     index: string;
     [languageTag: string]: string;