docs: add import syntax with module example

[anthumchris]

Specify import alongside require() syntax

[wraithgar]

Is this true? I thought it was optional, but the compromise was in performance.

[anthumchris]

excluding "type: module" shows a verbose warning:

$ node -v
v25.2.1

$ ls
package-cjs.json    package-esm.json    test.js

$ cat test.js 
import path from 'node:path'
console.log('test:', typeof path)

$ ln -fs package-cjs.json package.json && cat $_ && node test.js
{
  "name": "module-test"
}
(node:2825) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///Users/kratos/tmp/module-test/test.js is not specified and it doesn't parse as CommonJS.
Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
To eliminate this warning, add "type": "module" to /Users/kratos/tmp/module-test/package.json.
(Use `node --trace-warnings ...` to show where the warning was created)
test: object

$ ln -fs package-esm.json package.json && cat $_ && node test.js
{
  "name": "module-test",
  "type": "module"
}
test: object

[wraithgar]

Ah yep I remembered correctly.

This incurs a performance overhead.

This can read "should" instead of "must" imo.

[anthumchris]

resolved in 8b0ec24