refactor(core): replace parent-relative imports with # package imports

[btea]

Description

refer to https://beta.docs.nodejs.org/packages#subpath-imports

Validation

Related Issues

Check List

• I have read the Contributing Guidelines and made commit messages that follow the guideline.
• I have run node --run test and all tests passed.
• I have check code formatting with node --run format:check & node --run lint.
• I've covered new added functionality with unit tests if necessary.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Ready	Preview	Aug 17, 2026 12:58am

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.46%. Comparing base (31333d8) to head (a440782).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1044   +/-   ##
=======================================
  Coverage   89.46%   89.46%           
=======================================
  Files         203      203           
  Lines       19039    19047    +8     
  Branches     1782     1782           
=======================================
+ Hits        17033    17041    +8     
  Misses       1999     1999           
  Partials        7        7           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

api-links Generator

Performance estimate _{(single CI run)}

• Generation time: 23.3% faster (1.29 s → 990.00 ms)
• Peak memory: 1.3% higher (355.02 MB → 359.75 MB)

legacy-html Generator

Performance estimate _{(single CI run)}

• Generation time: 16.3% slower (18.49 s → 21.51 s)
• Peak memory: 0.5% lower (2.26 GB → 2.25 GB)

legacy-json Generator

Performance estimate _{(single CI run)}

• Generation time: 3.6% slower (8.96 s → 9.28 s)
• Peak memory: 0.1% lower (1.80 GB → 1.80 GB)

llms-txt Generator

Performance estimate _{(single CI run)}

• Generation time: 9.6% slower (8.86 s → 9.71 s)
• Peak memory: 2.7% higher (1.72 GB → 1.77 GB)

orama-db Generator

Output size: 1 file changed · net -1.15 KB

File size details

File	Main	PR	Change
orama-db.json	9.15 MB	9.14 MB	-1.15 KB (-0.0%)

Performance estimate _{(single CI run)}

• Generation time: 31.2% faster (9.99 s → 6.87 s)
• Peak memory: 2.7% higher (1.76 GB → 1.81 GB)

web Generator

Output size: 1 file changed · net -168.00 B

File size details

File	Main	PR	Change
all.html	31.74 MB	31.74 MB	-168.00 B (-0.0%)

Performance estimate _{(single CI run)}

• Generation time: 3.9% faster (87.47 s → 84.04 s)
• Peak memory: 0.1% higher (4.71 GB → 4.72 GB)

[btea]

The leave-comment action was successful. #1044 (comment)

[bmuenzenmeyer]

we do this in nodejs.org - except with a single root

[ovflowd]

Description

refer to beta.docs.nodejs.org/packages#subpath-imports

doc-kit inception!

[ovflowd]

btw: We need to ensure this will still work on the published package and when consumed by downstream packages.