Is their a way when generating JS libraries from KMP that will eventually be published to npm to not bundle ANY of it’s dependencies? like ktor/kotlin-stdlib And instead give them as runtime dependencies? (dependencies in package.json) The default behaviour seems to bundle everything which I don’t get the reasoning for.. if it’s possible then is there a downside?

checking out 2.2.0-RC: has the generated copy method been removed from @JsPlainObject? getting compile errors

Is there any documentation for the

binaries.library()

configuration? I understand at a high level what it does (produce a distributable node library), but I can't seem to find any documentation for it, or any official information about how/when to use it.

Another Question ... Can we not export enums? The docs for

@JsExport

indicate that we cannot:

@ExperimentalJsExport
@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.PROPERTY, AnnotationTarget.FUNCTION, AnnotationTarget.FILE])
expect annotation class JsExport(source)
Exports top-level declaration on JS platform.

Compiled module exposes declarations that are marked with this annotation without name mangling.

This annotation can be applied to either files or top-level declarations.

It is currently prohibited to export the following kinds of declarations:

expect declarations
inline functions with reified type parameters
suspend functions
secondary constructors without @JsName
extension properties
enum classes
annotation classes

When I add

@JsExport

to a basic enum

enum class Num { ONE, TWO, THREE }

... it compiles OK, but when I try to use it in javascript (typesript) code, I get a runtime error

Cannot read properties of undefined

when I import and use it, like

const one = Num.ONE;

how do I export my kotlin functions and import them in a nodejs project? The docs have me confused about this. I think something gets messed up because I use kotlin packages. more info in 🧵

How do I understand where exactly this error is coming from? Maybe I just need to understand what "IrClassSymbolImpl is unbound" means.

> Task :fmproto:compileTestDevelopmentExecutableKotlinJs
00:12:48.789  e: java.lang.IllegalStateException: IrClassSymbolImpl is unbound. Signature: kotlin.js/Promise|null[0]
00:12:48.789  	at org.jetbrains.kotlin.ir.symbols.impl.IrSymbolBase.getOwner(IrSymbolImpl.kt:37)
00:12:48.789  	at org.jetbrains.kotlin.ir.types.IrTypesKt.getDefaultType(irTypes.kt:173)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.lower.TestGenerator.generateCodeForTestMethod(TestGenerator.kt:206)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.lower.TestGenerator.generateTestCalls(TestGenerator.kt:120)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.lower.TestGenerator.createTestContainer$lambda$5$lambda$4(TestGenerator.kt:67)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.WholeWorldStageController.restrictTo(WholeWorldStageController.kt:29)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.lower.TestGenerator.createTestContainer(TestGenerator.kt:66)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.lower.TestGeneratorKt.generateJsTests(TestGenerator.kt:42)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.JsIrCompilerWithIC.compile(compilerWithIC.kt:94)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.ic.CacheUpdater.compileDirtyFiles(CacheUpdater.kt:716)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.ic.CacheUpdater.loadIrAndMakeIrFragmentGenerators(CacheUpdater.kt:816)
00:12:48.789  	at org.jetbrains.kotlin.ir.backend.js.ic.CacheUpdater.actualizeCaches(CacheUpdater.kt:848)
00:12:48.789  	at org.jetbrains.kotlin.cli.js.IcCachesKt.prepareIcCaches(IcCaches.kt:118)

using 2.2.0-RC2: I've noticed this warning that appears for anything using @JsExport that has a covariant return type marked with out; this wasn't an issue before, any idea why this happens? removing the out makes it go away

I’m new to Kotlin/JS Interoperability and got stuck with this error: "Calls to 'js(code)' must be a single expression inside a top-level function body or a property initializer" My code tries to load a WebWorker with js() inside a Koin module, but it’s not allowed. Here’s the problem:

actual val platformModule = module {
     single {
         val driver = WebWorkerDriver(
             Worker(
                 js("""new URL("@cashapp/sqldelight-sqljs-worker/sqljs.worker.js", import.meta.url)""") // :x: Error here
             )
         )
         LlmsDatabaseWrapper(driver, LlmsDatabase(driver))
     }
 }

how could I fix this issue?

Silly question: when running JS tests in the browser, is there a way to log things to the console? I have a bunch of tests that fail with no details - a few

println

would go a long way

Given the following wrapper function over

require

inline fun <T : Any> jsRequire(name: String): T =
  js("require(name)")

The JS output is something like:

var name = 'something'
return require(name)

The problem here is tools like esbuild do not analyze what

name

is, and thus don't correctly bundle the required dependency. Is there a way to workaround this, that is not unwrapping the

require

call?

Can someone tell why

Promise<List<Item>>

is exported to TypeScript as

Promise<any>

while

Promise<JsArray<Item>>

preserves both the container and item types? Is it expected behavior and we should use `JsArray`/`JsReadonlyArray` to preserve list item type in the Typescript declarations?

// JsItemsRepository.kt file

@OptIn(ExperimentalJsCollectionsApi::class)
class JsItemsRepository() {
    fun getAllArrayAsync(): Promise<JsReadonlyArray<Item>> = scope.promise { … }
    fun getAllListAsync(): Promise<List<Item>> = scope.promise { … }
    fun getFirstAsync(): Promise<Item> = scope.promise { … }
}

// mymodule.d.ts file

class JsItemsRepository {
    getAllArrayAsync(): Promise<ReadonlyArray<com.test.my.Item>>;
    getAllListAsync(): Promise<any/* kotlin.collections.KtList<com.test.my.Item> */>;
    getFirstAsync(): Promise<com.test.my.Item>;
}

NGINX deployment issue with Kotlin WebAssembly - WASM MIME type error I deployed a Kotlin WebAssembly application using NGINX, but when I open it in the browser, the console shows the following errors (see screenshot):

Extremely slow compilation (9min) for Kotlin/Wasm project on CI (10-core, 16GB, Kotlin 2.1.21) When compiling a Kotlin WebAssembly (Wasm) project on our CI machine, one task takes unusually long (~9 minutes). Here are the specs: • CI Machine: 10 CPU cores, 16GB RAM • Kotlin Version: 2.1.21 • nodeVersion = "20.9.0" • yarnVersion = "1.22.21" The slowdown seems disproportionate to the hardware. Has anyone encountered similar performance issues with Kotlin/Wasm builds?

can i somehow magically use the typescript types from npm libraries? ie I use the

stripe

package. do i need to create my own external interfaces(or use with dynamic) every time?

Hi all, i am trying to find a way to export suspend function for js target, i have gone through multiple resources online but i am not able to find a way to do that the way i want. I want that

suspend fun foo(): String

should get converted to

foo(): Promise<string>;

in Js. From what i know there is no native support for this. I was able to reach a Js signature

fooAsync(): Promise<String>;

using kotlin-suspend-transform-compiler-plugin , but i would want to have the same signature(without async) as it would be easier for all 3 targets(android, ios and js) to follow the generated docs and use it. Is there a way to achieve this ? other obv option is to have duplicate exported api interfaces for only js, but i really don't wish to go that route. I was also thinking if this plugin or some other plugin could help me generate a synthetic function

@JsExport
@JsName("foo")
fun fooSynthetic(): Promise<String> // generated synthetic function

@JsName("_foo")
suspend fun foo(): String // original function defined in api

If somehow above could be achieved, i was thinking it could work ? (Please correct me if my thought process is wrong here, i am new to KMP) Thanks.

How does one actually enable this? https://kotlinlang.org/docs/whatsnew20.html#suspend-functions-as-es2015-generators Couldn’t find any docs. Is it enabled by default when we set compilation target to es2015?

is there a kotlin js wrapper for framer motion or something else to get easy list animations (delete / insert of items) without writing much code myself

Hi, I’m Genis, a 3D developer specializing in immersive web and interactive experiences. I leverage cutting-edge tools like: Three.js, Babylon.js → High-performance WebGL & 3D web apps Cesium, Mapbox → Geospatial & real-time 3D mapping Unity 3D → Games, simulations, AR/VR With 7+ years of experience, I build visually stunning, scalable solutions for clients worldwide. Check out my work: 👉 Portfolio: https://kakao-3d.vercel.app/ Let’s collaborate! Open to freelance projects, contract roles, or innovative partnerships. #3DDevelopment #Three.js #WebGL #Unity3D #GameDev #TechArt

@broadway_lamb regarding the Clojure Compiler discussion, and the fact the JS code has to be parsed and potentially lowered to older targets, what about using the TS compiler API? It's just a random idea, but it gives you a visitable AST + the ability to downlevel by compiling it. Yes, you'll have to implement a separate program (and exchange data with it, e.g. via a pipe?) to translate TS AST to something you can read in Kotlin, spawn a separate process, but it doesn't seem totally crazy. With

tsgo

this might become even easier as it won't require a Node instance to be running.

How to check if code is running in test mode (unit test)?

How can I dynamically link resources to my index.html via webpack? https://kotlinlang.org/docs/running-kotlin-js.html#run-the-browser-target Only shows hardcoded strings for the generated js file. When i want to use the webpack content hash for example, what is the best way to implement this?

outputFileName = “main.bundle-[contenthash].js”

What’s the current status of Automatic generation of Kotlin wrappers from TypeScript typings mentioned in https://blog.jetbrains.com/kotlin/2025/05/present-and-future-kotlin-for-web/ ? Is there a ticket to track the progress at YouTrack or GitHub?

Hey, I have a small Problem with TanStackQuery. The options that expect functions don't work.

useQuery<Array<DocumentationElementDto>?, Error, Array<DocumentationElementDto>, QueryKey>(
    options = UseQueryOptions(
        queryKey = DOCUMENTATION_QUERY_KEY.plus(subCategory),
        queryFn = QueryFunction { 
            secureApi(DocumentationEndpoints
                .getDocumentationElement
                .copy(optionalQueryParams = pairListOf("category" to subCategory))
        )},
        refetchOnMount = { _ -> false },
        refetchOnWindowFocus = { _ -> false },
        refetchOnReconnect = { _ -> false },
        refetchInterval = 0,
        refetchIntervalInBackground = false,
    )
)

In this case

refetchOnMount = { _ -> false },
refetchOnWindowFocus = { _ -> false },
refetchOnReconnect = { _ -> false },

doesn't work, but these two:

refetchInterval = 0,
refetchIntervalInBackground = false,

behave as expected. I also tried

useCallback { _ -> false }

, but it isn't accepted by the compiler.

I am using multiple kotlinjs in one project. Problem is, yarn is in root project and it is shared. thats makes conflicts, because of overwriting. Is there smart way to handle this?

Hey, I have a problem with the google maps api and the predefined marker symbols. I looked at this this and I use

<http://vis.gl/react-google-maps|vis.gl/react-google-maps>

, but I also loaded

googlemaps/js-api-loader

. If you look at the Marker example there is:

new google.maps.Marker({
    position: map.getCenter(),
    icon: {
      path: google.maps.SymbolPath.CIRCLE,
      scale: 10,
    },
    draggable: true,
    map: map,
  });

But I can't figure out how to aquire the predefined

google.maps.SymbolPath.CIRCLE

constant? object? Just providing the path as a string doesn't work it says unexpected g at position 0 (the g from google I guess). I tried

@file:JsModule("@googlemaps/js-api-loader")
@file:JsNonModule

package shared.utils.maps

@JsName("CIRCLE")
external val CIRCLE: dynamic

But that also doesn't work. I know I can provide my own SVG and PNG and such, but it kinda irks me, someone got an idea? Edit: Okay I added the npm https://www.npmjs.com/package/google-maps and added:

@file:JsModule("google-maps")
@file:JsNonModule

package shared.utils.maps

@JsName("CIRCLE")
external val CIRCLE: dynamic

But it seems that

CIRCLE

is

null

when I access it.

Are singletons not allowed anymore? I updated to

2025.6.11

and now I get

org.jetbrains.kotlin.util.FileAnalysisException: While analysing Authentication.kt:47:1: org.jetbrains.kotlin.utils.exceptions.KotlinIllegalArgumentExceptionWithAttachments: Exception in declaration checker

Caused by: java.lang.IllegalStateException: Symbol for Any not found

For every top level

object

declaration like

object Foo {
  val bar: Bar
}

where there is no

Any

? EDIT Okay I cleaned and invalidated everything and it doesn't come up for now. I'll check back once the migration is fixed. Edit2 I get the error with Kotlin 2.1.0, but not with 2.2.0, but migrating to 2.2.0 is much work now. sigh.

Vite for Kotlin 0.5.2 is released, and it finally supports Kotlin 2.1.0+! https://opensavvy.gitlab.io/automation/kotlin-vite/api-docs/

I have a KMP library with a JS library export. My Kotlin declarations are namespaced in JS so for example the user has to do:

const { PokeApi } = require('pokekotlin').co.pokeapi.pokekotlin

Is there any way to override that namespacing so JS users can use my library like:

const { PokeApi } = require('pokekotlin')

Or alternatively, is there a way to include some custom js and .d.ts in my Kotlin/JS library export? So I can define an index.js myself that re-exports my declarations from the root My goal is to have a single KMP library with an idiomatic API for Kotlin, Java, JS/TS, and Swift/ObjC, but the package name being exposed to JS is awkward there. It’s more than just the import syntax; LSP tooling like automatic imports and stuff don’t work well when the importable declarations are buried under a package hierarchy.

How do sourcemaps work? If I create a simple project and run

jsBrowserDevelopmentRun

, I get: •

build/js/packages/example-simple/kotlin/example-simple.js

•

build/js/packages/example-simple/kotlin/example-simple.js.map

The second one contains:

{
	"version": 3,
	"sources": [
		"../../../../../src/jsMain/kotlin/Main.kt",
		"../../../../compileSync/js/main/developmentExecutable/kotlin/src/kotlin/util/Standard.kt"
	],
    // …

The

Main.kt

file refers to my own source code, fine. However, I don't understand that

Standard.kt

file. The

build/compileSync/js/main/developmentExecutable/kotlin

folder does NOT contain a

src/

folder, and there is no

Standard.kt

file anywhere in the

build/

directory. What's going on here?

While running jsBrowserProductionWebpack, some of the modules generate with warnings. How can I see what those warning are?

> Task :web:jsBrowserProductionWebpack
asset web.js 221 KiB [emitted] [minimized] (name: main) 2 related assets
modules by path ../../node_modules/ 539 KiB
  modules by path ../../node_modules/react-dom/ 512 KiB 4 modules
  modules by path ../../node_modules/react/ 16.9 KiB
    ../../node_modules/react/index.js 186 bytes [built] [code generated]
    ../../node_modules/react/cjs/react.production.js 16.7 KiB [built] [code generated]
  modules by path ../../node_modules/scheduler/ 10.1 KiB
    ../../node_modules/scheduler/index.js 194 bytes [built] [code generated]
    ../../node_modules/scheduler/cjs/scheduler.production.js 9.94 KiB [built] [code generated]
modules by path ./kotlin/*.js 158 KiB
  ./kotlin/prison-web.js 16.2 KiB [built] [code generated] [3 warnings]
  ./kotlin/kotlin-kotlin-stdlib.js 124 KiB [built] [code generated] [64 warnings]
  ./kotlin/kotlin-react.js 2.92 KiB [built] [code generated] [5 warnings]
  ./kotlin/kotlin-react-core.js 6.69 KiB [built] [code generated] [6 warnings]
  ./kotlin/prison-core.js 3.82 KiB [built] [code generated]
  ./kotlin/kotlin-react-dom.js 4.5 KiB [built] [code generated] [6 warnings]
webpack 5.94.0 compiled successfully in 4535 ms