Document that package.json aliases may target only direct subfolders of src

2026-10-16 21:48:20 +09:00
parent 006bbe6b0c
commit b170f25c7d
4 changed files with 21 additions and 4 deletions
@@ -11,8 +11,9 @@ Decided 2026-10-14 for all repos.
  config needed. Packages publish only `dist/`, so colocated tests cost nothing
  in the tarball.
 - **Regression and integration tests** live in the top-level `tests/` folder
-  and use only the public entry point (an alias like `#plugin`), never
-  internals. `vp test tests` runs just these.
+  and use only the public entry point through a relative import
+  (`../src/index.ts`; no alias may target `src/` itself, see
+  [[imports-aliases-barrels]]), never internals. `vp test tests` runs just these.
 - **No in-source tests** (`import.meta.vitest`).
 - **`scripts/` gets no tests** (2026-10-15): it is repo tooling, not
  production code (`project-lint.ts`, `decorators.ts`, `lit-check.ts`,