@crutchcrew/oxlint-plugin-import-access 1.0.0 → 1.0.1

package/README.md

@@ -1,11 +1,11 @@
-# oxlint-plugin-import-access 📦🔒
+# @crutchcrew/oxlint-plugin-import-access 📦🔒
 
 [![npm version](https://img.shields.io/npm/v/@crutchcrew/oxlint-plugin-import-access)](https://www.npmjs.com/package/@crutchcrew/oxlint-plugin-import-access)
 [![coverage](https://img.shields.io/endpoint?url=https://crutchcrew.github.io/oxlint-plugin-import-access/badges/coverage.json)](https://github.com/crutchcrew/oxlint-plugin-import-access/actions)
 [![provenance](https://img.shields.io/badge/provenance-verified-brightgreen)](https://www.npmjs.com/package/@crutchcrew/oxlint-plugin-import-access)
 [![license](https://img.shields.io/npm/l/@crutchcrew/oxlint-plugin-import-access)](./LICENSE)
 
-JSDoc import access for TypeScript, enforced by [oxlint](https://oxc.rs/docs/guide/usage/linter). Only `@public` exports can be imported from anywhere, and an export without an access tag is `@package`: only files in its own directory can import it. Tag an export `@public` to share it with the whole project, or `@private` so no other file can import it. To make untagged exports `@public` or `@private` instead, set [`defaultImportability`](#options).
+JSDoc import access for TypeScript, enforced by [oxlint](https://oxc.rs/docs/guide/usage/linter). Only `@public` exports can be imported from anywhere, and an export without an access tag is `@package`: only files in its own package (its directory and subdirectories) can import it. Tag an export `@public` to share it with the whole project, or `@private` so no other file can import it. To make untagged exports `@public` or `@private` instead, set [`defaultImportability`](#options).
 
 A native oxlint JS plugin port of [eslint-plugin-import-access](https://github.com/uhyo/eslint-plugin-import-access) that needs **no type checker**: no `typescript` dependency, no `tsconfig.json` project loading, no typed linting setup.
 
@@ -110,11 +110,11 @@ The original rule asks the TypeScript type checker which declaration an import r
 
 1. resolve the import like TypeScript (`tsconfig` `paths`, `package.json` `exports`, `.js` → `.ts`) with [oxc-resolver](https://github.com/oxc-project/oxc-resolver),
 2. skip builtins and anything reached through `node_modules`,
-3. read the target file's exports and JSDoc with [oxc-parser](https://github.com/oxc-project/oxc/tree/main/napi/parser) — module record and comments only, no syntax tree — and cache them,
+3. read the target file's exports and JSDoc with [oxc-parser](https://github.com/oxc-project/oxc/tree/main/napi/parser) — the module record and comments; the syntax tree only for the few files with decorators, `export =`, re-exported imports or JSDoc inside variable statements — and cache them,
 4. follow `export *`, stop at direct re-exports like upstream, and read JSDoc with TypeScript's attachment and tag rules,
 5. check ambient `declare module "…"` and wildcard `declare module "*.svg"` declarations too.
 
-**Verified against the original:** the upstream test suite passes unchanged (same lines, columns, messages), and a differential test compares this plugin with upstream's TypeScript-based rule on every fixture file and option combination, including new fixtures for re-export chains, overloads, enums, `export =`, wildcard modules and JSDoc placement. The [known differences](./docs/rule-jsdoc.md#differences-from-upstream) are edge cases such as module augmentation across files.
+**Verified against the original:** the upstream test suite passes unchanged (same lines, columns, messages), and the port was compared with upstream's TypeScript-based rule on every fixture file and option combination, including new fixtures for re-export chains, overloads, enums, `export =`, wildcard modules and JSDoc placement, whose expectations in the test suite were generated by the original rule. The [known differences](./docs/rule-jsdoc.md#differences-from-upstream) are edge cases such as module augmentation across files.
 
 ## Performance
 

package/dist/core/checkImportability.d.ts

@@ -39,7 +39,8 @@ export declare class ImportabilityChecker {
     constructor(watching?: boolean);
     /**
      * Start checking `fileName`. In a long-running host, everything read for earlier files is
-     * re-validated: exporter files are stat-ed again and specifiers resolved again.
+     * re-validated: exporter files are stat-ed again, specifiers resolved again and package names
+     * looked up again.
      */
     nextFile(fileName: string): void;
     clear(): void;

package/dist/index.js

@@ -737,6 +737,9 @@ function lookupPackageName(file) {
   }
   return result;
 }
+function clearPackageNameCache() {
+  packageNameCache.clear();
+}
 
 // src/core/resolveModule.ts
 import { realpathSync } from "node:fs";
@@ -903,6 +906,7 @@ class ImportabilityChecker {
     }
     this.exportTables.nextGeneration();
     this.resolver.clear();
+    clearPackageNameCache();
     this.#found = new WeakMap;
   }
   clear() {
@@ -910,6 +914,7 @@ class ImportabilityChecker {
     this.resolver.clear();
     this.exportTables.clear();
     this.ambientModules.clear();
+    clearPackageNameCache();
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crutchcrew/oxlint-plugin-import-access",
-	"version": "1.0.0",
+	"version": "1.0.1",
 	"description": "Oxlint JS plugin for import access via JSDoc @public, @package and @private, without a type checker",
 	"keywords": [
 		"import-access",