TypeStrong / TypeStrong/typedoc
Some cross-repository links not resolving
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 8.5k
- Forks
- 775
- PR merge metrics
- No merged PRs in 30d
Description
Search terms
multiple repository link
Expected Behavior
TypeDoc links to objects in dependency repository.
Actual Behavior
Showing error messages with failed resolution.
Steps to reproduce the bug
I have a TypeDoc project spread across multiple repositories. To replicate the messages I'm seeing, create an empty directory and run the following:
git clone --depth 1 --branch v1.0.26-beta https://github.com/aidc-toolkit/core.git
cd core
npm clean-install
npm run build:dev
cd ..
git clone --depth 1 --branch v1.0.26-beta https://github.com/aidc-toolkit/utility.git
cd utility
npm clean-install
npm run build:dev
cd ..
git clone --depth 1 --branch v1.0.26-beta https://github.com/aidc-toolkit/gs1.git
cd gs1
npm clean-install
npm run build:dev
cd ..
git clone --depth 1 --branch v1.0.26-beta https://github.com/aidc-toolkit/aidc-toolkit.github.io.git
cd aidc-toolkit.github.io
npm clean-install
npm run typedoc -- --logLevel Verbose
I'm getting these messages:
[warning] The comment for GS1.AI82_CREATOR links to "Exclusions.AllNumeric" which was resolved but is not included in the documentation. To fix this warning export it or add { "@aidc-toolkit/utility": { "__type.AllNumeric": "#" }} to the externalSymbolLinkMappings option
[warning] The comment for GS1.AI82_VALIDATOR links to "Exclusions.AllNumeric" which was resolved but is not included in the documentation. To fix this warning export it or add { "@aidc-toolkit/utility": { "__type.AllNumeric": "#" }} to the externalSymbolLinkMappings option
[warning] The comment for GS1.AI39_CREATOR links to "Exclusions.AllNumeric" which was resolved but is not included in the documentation. To fix this warning export it or add { "@aidc-toolkit/utility": { "__type.AllNumeric": "#" }} to the externalSymbolLinkMappings option
[warning] The comment for GS1.AI39_VALIDATOR links to "Exclusions.AllNumeric" which was resolved but is not included in the documentation. To fix this warning export it or add { "@aidc-toolkit/utility": { "__type.AllNumeric": "#" }} to the externalSymbolLinkMappings option
Other artefacts in the GS1 project that link to Utility work fine, e.g., the documentation for IdentifierValidator links to StringValidator without any problem.
Environment
- TypeDoc version: 0.28.15
- TypeScript version: 5.9.3
- Node.js version: 24.11.0
- OS: macOS 26.1
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by running the listed multi-repository reproduction commands with TypeDoc 0.28.15 and verbose logging. Trace how links to dependency-repository symbols such as Exclusions.AllNumeric are resolved and included, comparing them with the working StringValidator link. Done means the reported cross-repository links resolve without warnings in this reproduction.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- documentation
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100