Repository navigation
update: JS compiler features - #5884
Open
Danil Pavlov (danil-pavlov) wants to merge 2 commits into
Open
Danil Pavlov (danil-pavlov) wants to merge 2 commits into
Danil Pavlov (danil-pavlov) wants to merge 2 commits into
Conversation
Artem Kobzar (JSMonk)
approved these changes
Oct 27, 2026
Alex Epanchintseva (aepanchi)
requested changes
Oct 29, 2026
|
|
||
| To change the granularity, set the `kotlin.js.ir.output.granularity` property in your `gradle.properties` file: | ||
|
|
||
| ```none |
Contributor
There was a problem hiding this comment.
Doesn't gradle.properties use a different syntax? The // text becomes part of the value, rather than a comment.
| To change the granularity, set the `kotlin.js.ir.output.granularity` property in your `gradle.properties` file: | ||
|
|
||
| ```none | ||
| kotlin.js.ir.output.granularity=whole-program // 'per-module' is the default |
Contributor
There was a problem hiding this comment.
Suggested change
| kotlin.js.ir.output.granularity=whole-program // 'per-module' is the default | |
| # Default: per-module | |
| kotlin.js.ir.output.granularity=whole-program |
| @@ -4,6 +4,74 @@ Kotlin/JS includes compiler features to optimize code for performance, size, and | |||
Contributor
There was a problem hiding this comment.
Should we update the intro to cover the expanded scope?
| This works through the compilation process, which transforms Kotlin code into an intermediate representation (IR) before | ||
| generating the JavaScript code. | ||
|
|
||
| ## Configure output JavaScript versions |
Contributor
There was a problem hiding this comment.
Should we duplicate the instructions here, if they are already covered in https://kotlinlang.org/docs/js-project-setup.html#set-an-ecmascript-target? Maybe crosslink instead?
Contributor
Author
There was a problem hiding this comment.
It's just a feature overview of the compiler with links to additional info in the corresponding pages
|
|
||
| ## Configure output JavaScript versions | ||
|
|
||
| The Kotlin/JS compiler can generate JavaScript for the ES5, ES2015, and ES2020 versions of the ECMAScript standard. |
Contributor
There was a problem hiding this comment.
Suggested change
| The Kotlin/JS compiler can generate JavaScript for the ES5, ES2015, and ES2020 versions of the ECMAScript standard. | |
| The Kotlin/JS compiler can generate JavaScript for the ES5, ES2015, and ES2020 versions of the ECMAScript standard. Choose the newest version supported by your target environment. |
| You can choose how the compiler outputs `.js` files in your project: | ||
|
|
||
| * **Per module** (default). The compiler outputs a separate `.js` file for each project module. | ||
| * **Whole program**. The compiler compiles the whole project into a single `.js` file. |
Contributor
There was a problem hiding this comment.
Suggested change
| * **Whole program**. The compiler compiles the whole project into a single `.js` file. | |
| * **Whole program:** generates a single `.js` file for the whole program. |
|
|
||
| * **Per module** (default). The compiler outputs a separate `.js` file for each project module. | ||
| * **Whole program**. The compiler compiles the whole project into a single `.js` file. | ||
| * **Per file**. The compiler generates one (or two, if the file contains exported declarations) `.js` file per each Kotlin file. |
Contributor
There was a problem hiding this comment.
Suggested change
| * **Per file**. The compiler generates one (or two, if the file contains exported declarations) `.js` file per each Kotlin file. | |
| * **Per file:** generates one `.js` file for each Kotlin file, or two if the file contains exported declarations. |
| ```none | ||
| kotlin.js.ir.output.granularity=whole-program // 'per-module' is the default | ||
| ``` | ||
|
|
Contributor
There was a problem hiding this comment.
Should we mention that it's availavle for ES2015 or ES2020 only?
|
|
||
| ## Configure output granularity | ||
|
|
||
| You can choose how the compiler outputs `.js` files in your project: |
Contributor
There was a problem hiding this comment.
Can subsequent bundling change how that output is divided into files?
Contributor
Author
There was a problem hiding this comment.
I wouldn't go into such details here
| kotlin.js.ir.output.granularity=whole-program // 'per-module' is the default | ||
| ``` | ||
|
|
||
| For more details, including the requirements for the per-file mode, see [Configure output granularity](js-project-setup.md#configure-output-granularity). |
Contributor
There was a problem hiding this comment.
Suggested change
| For more details, including the requirements for the per-file mode, see [Configure output granularity](js-project-setup.md#configure-output-granularity). | |
| For configuration details, see [Configure output granularity](js-project-setup.md#configure-output-granularity). |
Danil Pavlov (danil-pavlov)
requested a review
from Alex Epanchintseva (aepanchi)
November 4, 2026 18:03
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.