Skip to content

doc: clarify bare specifier subpath examples#63353

Closed
MukundaKatta wants to merge 1 commit into
nodejs:mainfrom
MukundaKatta:codex/doc-bare-specifier-subpaths
Closed

doc: clarify bare specifier subpath examples#63353
MukundaKatta wants to merge 1 commit into
nodejs:mainfrom
MukundaKatta:codex/doc-bare-specifier-subpaths

Conversation

@MukundaKatta
Copy link
Copy Markdown

Fixes: #53022

Clarify the bare specifier terminology by replacing the ambiguous extension note with explicit examples for package main entries, exported package subpaths, and file subpaths in packages without an exports field.

Validation:

  • node tools/lint-md/lint-md.mjs doc/api/esm.md
  • git diff --check origin/main...HEAD
  • Runtime ESM probe covering pkg, pkg/shuffle.mjs, pkg-exports/shuffle, and failure for pkg/shuffle without exports.

@nodejs-github-bot
Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/loaders

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. esm Issues and PRs related to the ECMAScript Modules implementation. labels May 15, 2026
Comment thread doc/api/esm.md
refer to the main entry point of a package by the package name, or to a
package subpath by appending the subpath to the package name. Examples include
`'some-package/shuffle'` for a subpath exported by the package, and
`'some-package/shuffle.js'` for a file subpath in a package without an
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if it's being required, the extensionless path works too. only import forces extensions absent an exports field.

@aduh95
Copy link
Copy Markdown
Contributor

aduh95 commented May 15, 2026

It seems you are using a LLM to open PRs at a rate that's not humanely sustainable, without following up at all on the feedback received, please stop, this is not bringing any value and is wasting our time. If you keep opening more PRs, you'll get blocked.

@aduh95 aduh95 closed this May 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Issues and PRs related to the documentations. esm Issues and PRs related to the ECMAScript Modules implementation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bare specifiers definition.

4 participants