Skip to content

importHelpers with symlinks breaks type resolution #29221

Description

TypeScript Version: 3.2.2

Search Terms:
type symlink importHelpers pnpm

Code
https://github.com/stevefan1999-personal/gqlify/tree/patch-pnpm-tslib

Reproduction:
This is a little bit complicated, you will need to clone the repo I provided and checkout the branch, then run pnpm install, and then please flip the importHelpers options to false and re-run the installation again.

Expected behavior:
When importHelpers is true, it shouldn't break type inference like we should when importHelpers is false.

Actual behavior:

error TS2742: The inferred type of '...' cannot be named without a reference to '...'. This is likely not portable. A type annotation is necessary.

When importHelpers is true and the Types (@types) directory is a symlink.

Related Issues:
pnpm/pnpm#1375

Extra Stuff:
Although it is application-specific (Lerna with NPM/Yarn works fine on this), I do think this should be handled correctly regardless of any layers of symlinks.

PS:
tsc output observation diff: http://www.mergely.com/a6N4kOW3/

Activity

  1. weswigham commented on Jan 3, 2019

    @weswigham
    Member

    I can't seem the repro the issue with the steps provided (builds fine both ways) - what platform and filesystem case-sensitivity are you on?

  2. stevefan1999-personal commented on Jan 4, 2019

    @stevefan1999-personal
    Author

    Wesley Wigham (@weswigham) I'm using Linux and F2FS, but I don't think it mattered.

  3. weswigham commented on Jan 4, 2019

    @weswigham
    Member

    Is F2FS a case-sensitive filesystem?

  4. stevefan1999-personal commented on Jan 4, 2019

    @stevefan1999-personal
    Author
  5. sheetalkamat commented on Jan 4, 2019

    @sheetalkamat
    Member

    Wesley Wigham (@weswigham) You can repro this by setting useCaseSensitiveFileNames of nodeSystem in tsc.js to true

  6. added
    BugA bug in TypeScript
    Needs InvestigationThis issue needs a team member to investigate its status.
    and removed
    Needs More InfoThe issue still hasn't been fully clarified
    on Jan 4, 2019
  7. wzhudev commented on Jan 17, 2019

    @wzhudev

    Similar problem here and I guess the reason is the same. Typescript 3.2.2. Downgrade to 3.1.3 and everthing is fine.

    Works fine on Mac and Ubuntu but breaks on Windows, which is using NTFS for sure.

    ERROR in components/empty/nz-embed-empty.component.ts(36,3): error TS2742: The inferred type of 'defaultSvg' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/@angular/platform-browser/platform-browser'. This is likely not portable. A type annotation is necessary.
    components/empty/nz-empty.component.ts(34,3): error TS2742: The inferred type of 'defaultSvg' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/@angular/platform-browser/platform-browser'. This is likely not portable. A type annotation is necessary.
    components/select/nz-select.service.ts(45,3): error TS2742: The inferred type of 'open$' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/rxjs'. This is likely not portable. A type annotation is necessary.
    components/select/nz-select.service.ts(52,3): error TS2742: The inferred type of 'listOfSelectedValue$' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/rxjs'. This is likely not portable. A type annotation is necessary.
    components/select/nz-select.service.ts(53,3): error TS2742: The inferred type of 'modelChange$' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/rxjs'. This is likely not portable. A type annotation is necessary.
    components/select/nz-select.service.ts(69,3): error TS2742: The inferred type of 'searchValue$' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/rxjs'. This is likely not portable. A type annotation is necessary.
    components/select/nz-select.service.ts(97,3): error TS2742: The inferred type of 'valueOrOption$' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/rxjs'. This is likely not portable. A type annotation is necessary.
    components/select/nz-select.service.ts(113,3): error TS2742: The inferred type of 'check$' cannot be named without a reference to 'D:/Developer/ng-zorro-antd/node_modules/rxjs'. This is likely not portable. A type annotation is necessary.
    
  8. qzmfranklin commented on Feb 1, 2019

    @qzmfranklin

    I ran into this issue as well. My project was built with Bazel.

    A few snippets to reproduce the error:

    import {Parser as ParserBase} from 'chevrotain'
    
    
    const parser = createParser()
    
    // @ts-ignore: TS2742
    const BaseCstVisitor = parser.getBaseCstVisitorConstructor();
    
    function createParser(): Parser {
        return new Parser()
    }
    
    class Parser extends ParserBase {
    ...
    }

    The compilation error after upgrading from ts 3.1.3 to 3.2.4:

    src/ui/lib/dsl/langs/logi/semantic.ts:13:7 - error TS2742: The inferred type of 'BaseCstVisitor' cannot be named without a reference to '../../../../../../external/npm/node_modules/chevrotain/lib/chevrotain'. This is likely not portable. A type annotation is necessary.
    
    13 const BaseCstVisitor = parser.getBaseCstVisitorConstructor();
             ~~~~~~~~~~~~~~
    

    What I want is the ability to just mute this TS2742 error and make the code compile again.

    I have tried adding // @ts-ignore, no luck.

    Help needed. Thanks in advance!

  9. jfaust commented on Feb 8, 2019

    @jfaust

    We're having this problem with Bazel-built typescript as well. Bazel symlinks all the node_modules directories.

  10. DovydasNavickas commented on Mar 15, 2019

    @DovydasNavickas

    Well, I've not only encountered this thing, but got a minimal repro with the weird behavior hapening on 3 computers:
    https://github.com/DovydasNavickas/ts-2742

    I'm just not sure whether this is a TypeScript or VS Code bug.
    Same thing happens in the latest stable and latest insider versions of VS Code with all 3.3, 3.3.3333 and nightly 3.4.0-dev.20190315 versions.

    When you clone the repo, just run pnpm install and go to test.ts file. The error should be there:

    The inferred type of 'TestContext' cannot be named without a reference to '.registry.npmjs.org/@types/react/16.8.8/node_modules/@types/react'. This is likely not portable. A type annotation is necessary. ts(2742)
    

    If it's not there, restart VS Code and you should see it at least then.

    NB! If run the compiler with pnpx tsc, you will _NOT_ get an error

    Now, go to tsconfig.json and comment either "declaration": true or "importHelpers": true line and restart VS Code. The error will go away when you comment either config option.

    The error also goes away when you import React itself along with createContext function:
    import React, { createContext } from "react";

    But then I get another error:

    'React' is declared but its value is never read. ts(6133)
    

    So yeah. Compiler does not complain about this, but VS Code does.

  11. 21 remaining items

  12. stevefan1999-personal commented on Aug 15, 2019

    @stevefan1999-personal
    Author

    @nthypes because the TS team is so naively thinking it's finally put a nail in the coffin. we still need more regression test to handle this.

    Sadly I'm still in work and the university semester is going to start I probably had no time to handle this for everybody.

  13. weswigham commented on Aug 19, 2019

    @weswigham
    Member

    The reason this issue is closed is because there's nothing actionable in the thread at this point, and what was actionable was fixed, best as could be observed - if you have a codebase that still has an issue on the latest builds, opening a new issue with a full set of reproduction steps (as these kinds of issues are super sensitive to compiler settings, host environment, and actual code layout on disk) would be useful and tracking down and squashing the bug.

    But in many instances, seeing the error reported isn't a bug - even in @simonfox's example, it probably isn't. Why, you ask? Because if TypeScript needs to load two differing versions of one of your dependencies (because you upgraded one dep that shared a different dep with you but did not update that secondary dep within yourself) and one of them is nested, while we can often typecheck in the face of that, thanks to structual checking, we definitely have no stable, safe way to say "the type at this position refers to the older version of the type that we found in the nested node module here". We could only do one of two things - incorrectly map to the later version, hoping it's close enough, or issue an error. We err on the side of caution. Having consistent versions of your dependencies is a good thing~ (and, failing that, I think you can override how we resolve the dependency in question with a path mapping to force us to, for example, always resolve to the root version even if node module resolution would normally choose a nested one)

  14. mikolaj-leszczynski commented on Sep 8, 2019

    @mikolaj-leszczynski

    I have this problem as well on multiple projects that appeared when upgrading from angular 7 to angular 8 (TS 3.1.6 to TS 3.4.5).
    We have no symlinks and the issue only occurs when building with angular. A tsc build does not result in an error and there are no errors displayed in VS code.

    Roaders I'm having the same problem. Did you manage to find a solution ?

  15. markovicdenis commented on Dec 7, 2019

    @markovicdenis

    Similar problem here and I guess the reason is the same. Typescript 3.2.2. Downgrade to 3.1.3 and everthing is fine.

    Same here, downgrading to 3.1.3 did it. VSCode auto import functionality works again in TS files.

  16. locked as resolved and limited conversation to collaborators on Oct 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    BugA bug in TypeScript

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions