Document how to make use of & debug the example type checking? about docs-ts HOT 2 OPEN

docs/examples is a temporary folder used by docs-ts to run all the examples (which are supposed to be valid, including the necessary imports). If there are no errors, it will be deleted by docs-ts, and it is not supposed to be committed.

The error you're receiving is due to the fact that type: "module" is not supported.

As a workaround, you could add the following two files to the /docs folder:

package.json

{
  "name": "examples"
}

tsconfig.json

{
  "compilerOptions": {
    "module": "CommonJS"
    // your other options
  }
}

from docs-ts.

@gcanti That doesn't appear to work for me with ESM imports:

// https://www.typescriptlang.org/docs/handbook/esm-node.html
import x from './y.js'

// https://nodejs.org/api/packages.html#subpath-imports
import x from '#self/y'

TSError: ⨯ Unable to compile TypeScript:
docs/examples/src-Alternative.ts-function-pureIf-0.ts(2,24): error TS1479: The current file is a CommonJS module whose imports will produce 'require' calls; however, the referenced file is an ECMAScript module and cannot be imported with 'require'. Consider writing a dynamic 'import("../../src/Alternative")' call instead.
  To convert this file to an ECMAScript module, change its file extension to '.mts', or add the field `"type": "module"` to '/path/to/repo/docs/package.json'.

Repro (slightly different files in :/docs/ but easy to adjust): https://github.com/samhh/fp-ts-std/tree/esm (Edit: out of date, but the issue can be repro'd in the repo generally)

Edit: Built a workaround script: samhh/fp-ts-std@4d679d6#diff-11acf79cfa31caef7478b768e28dffb6d7272c308c98f666c529f68bc9685871

from docs-ts.