Support for ESNext module imports in Godot-TS

[jmservier]

I’m trying to use Godot-TS with a pure ESNext setup (no CommonJS), but I can’t find any examples demonstrating this configuration. When I attempt to import the godot namespace, I get an error saying that the module has no exported member godot.

Reproduction Steps:

1. Create a new GodotJS + TypeScript project.
2. Generate a godot.d.ts at the project root via the Godot editor:

// godot.d.ts
export namespace godot {
  export type GodotClass = new () => godot.Object;
  export class Object {}
  export class Node extends godot.Object {
    _ready(): void;
  }
  export namespace Node {}
}

3. Configure tsconfig.json as follows:

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "node",
    "rootDir": ".",
    "outDir": "dist",
    "declaration": true,
    "declarationDir": "typings",
    "isolatedModules": true,
    "skipLibCheck": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "resolveJsonModule": true,
    "experimentalDecorators": true,
    "incremental": true,
    "tsBuildInfoFile": ".godot/.tsbuildinfo",
    "baseUrl": "."
  },
  "include": [
    "src",
    "godot.d.ts",
    "typings"
  ],
  "exclude": [
    "lib.dom.d.ts",
    "node_modules",
    "dist"
  ],
  "types": ["godot.d.ts"]
}

4. In a TypeScript file:

    import { godot } from "godot";

5. Build or run the project.

Actual Behavior:

Module '"godot"' has no exported member 'godot'.

Expected Behavior:
The godot namespace should be available as an ES module import, matching the declarations in godot.d.ts.

Notes / Questions:

• Are there existing examples or recommended settings for using Godot-TS with "module": "ESNext"?
  

• Should the declarations in `godot.d.ts` be modified (e.g. use export default godot, or a different module mapping) to support ESM?
  

• Is there a mapping or alias configuration needed in `tsconfig.json` (e.g. paths) to make import { godot } from "godot" work?
  

Any guidance or example repository demonstrating a pure ESNext import setup would be greatly appreciated.

[bioinfornatics]

After lot of test and learn...
Maybe that will hep you @nmerget to provide better documentation and/or fix this one

get Godot with javascript v8 module, thanks to @ialex32x

1. Install godot editor with javascript module

Binary are here

install script for linux

curl -LO https://github.com/ialex32x/GodotJS-Build/releases/download/GodotJS_1.0.0-2/prebuilt_linux_x64_v8.zip
sudo mkdir -p /opt/godot/4.4/bin
sudo unzip prebuilt_linux_x64_v8.zip -d   /opt/godot/4.4/

sudo mv /opt/godot/4.4/godot.linuxbsd.editor.dev.x86_64 /opt/godot/4.4/bin/godot.editor
sudo mv /opt/godot/4.4/godot.linuxbsd.template_release.x86_64 /opt/godot/4.4/bin/godot.template_release
sudo mv /opt/godot/4.4/godot.linuxbsd.template_debug.x86_64 /opt/godot/4.4/bin/godot.template_debug
sudo mv /opt/godot/4.4/godot.linuxbsd.template_release.x86_64.debugsymbols /opt/godot/4.4/bin/godot.template_release.debugsymbols

sudo chmod +x /opt/godot/4.4/bin/godot.editor

sudo update-alternatives --install /usr/local/bin/godot godot /opt/godot/4.4/bin/godot.editor 40400

echo '
if ! [[ "$PATH" =~ "/usr/local/bin" ]]
then
    PATH="/usr/local/bin:$PATH"
fi
' >> ~/.bashrc

2. initialize your project

$ npx -y @godot-js/godot-ts init -n my_project
$ cd my_project
$ npm i

3. Remove the generated godot.d.ts file

4. Replace generated tsconfig file content

{
  "compilerOptions": {
    "incremental": true,
    "tsBuildInfoFile": ".godot/.tsbuildinfo",
    "target": "ES2020",
    "module": "ESNext",
    "moduleResolution": "node",
    "lib": ["ESNext"],
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    "rootDir": "src",
    "baseUrl": ".",
    "paths": {
      "decorators.bundle": ["typings/decorators.bundle.d.ts"],
      "godot": ["typings/godot.minimal.d.ts"]
    },
    "typeRoots": ["typings", "node_modules/@types"],
    "sourceMap": true,
    "outDir": "scripts/js/generated",
    "sourceRoot": "src",
    "newLine": "lf",
    "noEmitOnError": false,
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*", "typings/**/*.d.ts"],
  "exclude": ["node_modules"]
}

5. Generate godot.d.ts file with the godot engine

$ npm run dev

6. start to code into src dir with following import

import { node } from "decorators.bundle";
import * as godot from "godot";