svelte-docinfo 0.5.0 → 0.5.2

package/dist/analyze-core.d.ts

@@ -1266,7 +1266,7 @@ export declare const AnalyzeResultJson: z.ZodObject<{
             see: "see";
             nodocs: "nodocs";
         }>;
-        functionName: z.ZodString;
+        functionName: z.ZodOptional<z.ZodString>;
         file: z.ZodString;
         line: z.ZodOptional<z.ZodNumber>;
         column: z.ZodOptional<z.ZodNumber>;

package/dist/analyze-core.js

@@ -91,7 +91,7 @@ const dispatchOnDuplicates = (mode, duplicates, log) => {
     }
     mode(duplicates, errorLog);
 };
-// ── Result types ─────────────────────────────────────────────────────────────
+// Result types
 /**
  * Result of `analyze`, `analyzeFromFiles`, and `AnalysisSession.query`.
  *
@@ -154,7 +154,7 @@ const toModuleJson = (raw) => {
         ...(raw.moduleComment ? { moduleComment: raw.moduleComment } : {}),
     });
 };
-// ── Module dispatch ──────────────────────────────────────────────────────────
+// Module dispatch
 /**
  * Analyze a single non-Svelte source file and extract module metadata.
  *

package/dist/declaration-helpers.js

@@ -8,7 +8,7 @@
  *
  * @module
  */
-// ── Serialization ───────────────────────────────────────────────────────────
+// Serialization
 /**
  * JSON replacer that strips Zod default values for compact serialization.
  *
@@ -44,7 +44,7 @@
  * ```
  */
 export const compactReplacer = (_key, value) => (Array.isArray(value) && value.length === 0) || value === false ? undefined : value;
-// ── Display Helpers ─────────────────────────────────────────────────────────
+// Display Helpers
 /**
  * Format declaration or member name with generic parameters for display.
  *
@@ -133,7 +133,7 @@ const pascalCaseFromModulePath = (modulePath) => {
         .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
         .join('');
 };
-// ── Type Reference Helpers ─────────────────────────────────────────────────
+// Type Reference Helpers
 /**
  * Escape special regex characters in a string.
  */
@@ -218,7 +218,7 @@ export const findTypeReferences = (typeString, declarationNames) => {
     }
     return refs;
 };
-// ── Narrowed Declaration Types ──────────────────────────────────────────────
+// Narrowed Declaration Types
 /**
  * Narrow a declaration by kind for type-safe field access.
  *

package/dist/dep-resolver.d.ts

@@ -134,8 +134,12 @@ export declare const isNodeBuiltin: (specifier: string) => boolean;
  * resolver instance share the cache scope (correct, since resolver state is
  * shared too).
  *
- * Falls back to appending `.svelte` when the bare specifier doesn't resolve —
- * lets `.svelte` imports work without polluting the consumer's tsconfig.
+ * `ts.resolveModuleName` cannot resolve real `.svelte` files (no compiler
+ * option teaches it the extension), so relative and absolute `.svelte`
+ * specifiers — with or without the extension written — fall back to manual
+ * filesystem resolution against `fromFile`. Non-relative `.svelte` specifiers
+ * (tsconfig `paths` aliases, package subpaths) stay unresolved; supply a
+ * custom `resolveImport` for those setups.
  *
  * @param compilerOptions - parsed tsconfig (from `loadTsconfig`)
  * @param projectRoot - absolute project root for the module-resolution cache

package/dist/dep-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dep-resolver.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dep-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,KACZ,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC9B,uEAAuE;IACvE,OAAO,EAAE,eAAe,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,cAAc,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAClC,OAAO,aAAa,GAAG,SAAS,KAC9B,cAAc,GAAG,SAC6E,CAAC;AAElG;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,IAAI,CAErD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,KAAK,CAAC,MAAM,CAOxE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,KAAG,OAA+B,CAAC;AAElF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB,GACjC,iBAAiB,EAAE,CAAC,eAAe,EACnC,aAAa,MAAM,KACjB,cAwBF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAC7B,eAAe,eAAe,EAC9B,WAAU,MAAM,GAAG,MAA0B,KAC3C,cAGD,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,cAG5B,CAAC"}
+{"version":3,"file":"dep-resolver.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/dep-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAAE,MAAM,YAAY,CAAC;AAK5B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,KACZ,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC9B,uEAAuE;IACvE,OAAO,EAAE,eAAe,CAAC;IACzB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,cAAc,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,GAClC,OAAO,aAAa,GAAG,SAAS,KAC9B,cAAc,GAAG,SAC6E,CAAC;AAElG;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAa,OAAO,CAAC,IAAI,CAErD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,KAAK,CAAC,MAAM,CAOxE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,KAAG,OAA+B,CAAC;AAElF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,GACjC,iBAAiB,EAAE,CAAC,eAAe,EACnC,aAAa,MAAM,KACjB,cAsBF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAC7B,eAAe,eAAe,EAC9B,WAAU,MAAM,GAAG,MAA0B,KAC3C,cAGD,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,cAG5B,CAAC"}

package/dist/dep-resolver.js

@@ -27,8 +27,10 @@
  * @module
  */
 import { isBuiltin } from 'node:module';
+import { dirname, isAbsolute, resolve as resolvePath } from 'node:path';
 import ts from 'typescript';
 import { init as esModuleLexerInit, parse as esModuleLexerParse } from 'es-module-lexer';
+import { toPosixPath } from './paths.js';
 /**
  * Normalize the public `ResolveImport` union to an `ImportResolver`.
  *
@@ -92,8 +94,12 @@ export const isNodeBuiltin = (specifier) => isBuiltin(specifier);
  * resolver instance share the cache scope (correct, since resolver state is
  * shared too).
  *
- * Falls back to appending `.svelte` when the bare specifier doesn't resolve —
- * lets `.svelte` imports work without polluting the consumer's tsconfig.
+ * `ts.resolveModuleName` cannot resolve real `.svelte` files (no compiler
+ * option teaches it the extension), so relative and absolute `.svelte`
+ * specifiers — with or without the extension written — fall back to manual
+ * filesystem resolution against `fromFile`. Non-relative `.svelte` specifiers
+ * (tsconfig `paths` aliases, package subpaths) stay unresolved; supply a
+ * custom `resolveImport` for those setups.
  *
  * @param compilerOptions - parsed tsconfig (from `loadTsconfig`)
  * @param projectRoot - absolute project root for the module-resolution cache
@@ -104,12 +110,16 @@ export const createDefaultResolver = (compilerOptions, projectRoot) => {
         const result = ts.resolveModuleName(specifier, fromFile, compilerOptions, ts.sys, cache);
         if (result.resolvedModule)
             return result.resolvedModule.resolvedFileName;
-        // Fallback: try with .svelte extension. ts.resolveModuleName doesn't
-        // know about .svelte files unless explicitly configured.
-        if (!specifier.endsWith('.svelte')) {
-            const svelte = ts.resolveModuleName(specifier + '.svelte', fromFile, compilerOptions, ts.sys, cache);
-            if (svelte.resolvedModule)
-                return svelte.resolvedModule.resolvedFileName;
+        // ts.resolveModuleName never resolves real .svelte files — no compiler
+        // option teaches it the extension — so resolve relative/absolute
+        // specifiers manually, appending .svelte when it isn't written.
+        if (specifier.startsWith('./') || specifier.startsWith('../') || isAbsolute(specifier)) {
+            const withExt = specifier.endsWith('.svelte') ? specifier : specifier + '.svelte';
+            const candidate = isAbsolute(withExt) ? withExt : resolvePath(dirname(fromFile), withExt);
+            // posixified for parity with ts.resolveModuleName, which always
+            // returns forward-slash paths
+            if (ts.sys.fileExists(candidate))
+                return toPosixPath(candidate);
         }
         return null;
     };

package/dist/diagnostics.d.ts

@@ -354,19 +354,23 @@ export declare const DuplicateCommentDiagnostic: z.ZodObject<{
 }, z.core.$strict>;
 export type DuplicateCommentDiagnostic = z.infer<typeof DuplicateCommentDiagnostic>;
 /**
- * Symbol-scope JSDoc tag (`@example`, `@deprecated`, `@since`, `@see`,
- * `@throws`, `@mutates`, `@default`, `@nodocs`) found on a non-primary overload
- * signature.
+ * A JSDoc tag found somewhere it has no effect.
  *
- * Symbol-scope tags describe the function as a whole, not individual
- * signatures. The primary signature's JSDoc feeds the parent declaration's
- * symbol-level extraction; tags on non-primary overload signatures are
- * silently dropped from output. This diagnostic surfaces them so authors
- * can move them to the primary signature.
+ * Two contexts emit this:
  *
- * `@default` and `@nodocs` are included here even though overloads never
- * carry a `defaultValue` or per-overload exclusion: their presence on a
- * non-primary signature is always a misplacement.
+ * - **Non-primary overload signature** — symbol-scope tags (`@example`,
+ *   `@deprecated`, `@since`, `@see`, `@throws`, `@mutates`, `@default`,
+ *   `@nodocs`) describe the function as a whole, not individual signatures.
+ *   The primary signature's JSDoc feeds the parent declaration's symbol-level
+ *   extraction; tags on non-primary overload signatures are silently dropped
+ *   from output. This diagnostic surfaces them so authors can move them to
+ *   the primary signature. `@default` and `@nodocs` are included even though
+ *   overloads never carry a `defaultValue` or per-overload exclusion: their
+ *   presence on a non-primary signature is always a misplacement.
+ * - **Module comment** — `@nodocs` has no module-level meaning (it applies to
+ *   declarations and export statements); in a `@module` comment the tag does
+ *   nothing except remain verbatim in `moduleComment` text. To omit a module
+ *   from analysis, use `exclude` patterns instead.
  */
 export declare const MisplacedTagDiagnostic: z.ZodObject<{
     /** The tag name without the `@` prefix (e.g., `'example'`, `'deprecated'`). */
@@ -380,8 +384,11 @@ export declare const MisplacedTagDiagnostic: z.ZodObject<{
         see: "see";
         nodocs: "nodocs";
     }>;
-    /** Name of the function or method whose overload carries the misplaced tag. */
-    functionName: z.ZodString;
+    /**
+     * Name of the function or method whose overload carries the misplaced tag.
+     * Absent for module-comment misplacements (no enclosing symbol).
+     */
+    functionName: z.ZodOptional<z.ZodString>;
     /**
      * File path relative to project root (no leading slash, no `./` prefix).
      *

package/dist/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/diagnostics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;EAA+B,CAAC;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAIpE;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAezB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAiC5D;;GAEG;AACH,eAAO,MAAM,wBAAwB;IAGpC,2DAA2D;;IA1B3D;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAa9C,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,2BAA2B;IAGvC,sCAAsC;;IArCtC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAwB9C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAGjC,yBAAyB;;IAEzB,sCAAsC;;IAlDtC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAqC9C,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAGhC,6BAA6B;;IAE7B,wBAAwB;;IA/DxB;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAkD9C,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB;IAGnC,qCAAqC;;;;;;IArFrC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAwE9C,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;IAlGtC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAsF9C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,qBAAqB;IA3GjC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBA+F9C,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,0BAA0B;IAGtC,wCAAwC;;;;;IAxHxC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBA2G9C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sBAAsB;IAGlC,+EAA+E;;;;;;;;;;;IAW/E;;;OAGG;;IAjKH;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAoJ9C,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;IAGlC,2DAA2D;;IAE3D,sCAAsC;;IAjLtC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAoK9C,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B;IAG1C,uCAAuC;;IAEvC,sDAAsD;;IApMtD;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAuL9C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB;IArNrC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAyM9C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;IApOrC;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBAwN9C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB;IAGpC,mDAAmD;;IAxPnD;;;;;;;;;OASG;;IAEH,6DAA6D;;IAE7D,+DAA+D;;IAE/D,+CAA+C;;;;;;;kBA2O9C,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,qBAAqB,CAC/C;IACC,OAAO,wBAAwB;IAC/B,OAAO,2BAA2B;IAClC,OAAO,qBAAqB;IAC5B,OAAO,oBAAoB;IAC3B,OAAO,uBAAuB;IAC9B,OAAO,0BAA0B;IACjC,OAAO,qBAAqB;IAC5B,OAAO,0BAA0B;IACjC,OAAO,sBAAsB;IAC7B,OAAO,sBAAsB;IAC7B,OAAO,yBAAyB;IAChC,OAAO,8BAA8B;IACrC,OAAO,yBAAyB;IAChC,OAAO,wBAAwB;CAC/B,EACD,MAAM,CAgBL,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIpD;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,aAAa,KAAK,CAAC,UAAU,CAAC,KAAG,OACX,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,aAAa,KAAK,CAAC,UAAU,CAAC,KAAG,OACX,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,aAAa,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CACxB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,aAAa,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CACxB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,cAAc,EAC9C,aAAa,KAAK,CAAC,UAAU,CAAC,EAC9B,MAAM,CAAC,KACL,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE;IAAC,IAAI,EAAE,CAAC,CAAA;CAAC,CAAC,CAC6C,CAAC;AAErF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,GAAI,YAAY,UAAU,KAAG,MAMzD,CAAC"}

package/dist/diagnostics.js

@@ -58,7 +58,7 @@
  * @module
  */
 import { z } from 'zod';
-// ── Severity ─────────────────────────────────────────────────────────────────
+// Severity
 /**
  * Diagnostic severity levels.
  *
@@ -66,7 +66,7 @@ import { z } from 'zod';
  * - `'warning'` — partial success, something seems off but analysis continued
  */
 export const DiagnosticSeverity = z.enum(['error', 'warning']);
-// ── Kind ─────────────────────────────────────────────────────────────────────
+// Kind
 /**
  * Discriminant for `Diagnostic` variant types.
  */
@@ -86,7 +86,7 @@ export const DiagnosticKind = z.enum([
     'transform_failed',
     'resolver_failed',
 ]);
-// ── Variants ─────────────────────────────────────────────────────────────────
+// Variants
 /**
  * Base diagnostic fields shared by every variant.
  *
@@ -205,19 +205,23 @@ export const DuplicateCommentDiagnostic = z.strictObject({
     commentType: z.enum(['module_comment', 'doc_comment']),
 });
 /**
- * Symbol-scope JSDoc tag (`@example`, `@deprecated`, `@since`, `@see`,
- * `@throws`, `@mutates`, `@default`, `@nodocs`) found on a non-primary overload
- * signature.
+ * A JSDoc tag found somewhere it has no effect.
  *
- * Symbol-scope tags describe the function as a whole, not individual
- * signatures. The primary signature's JSDoc feeds the parent declaration's
- * symbol-level extraction; tags on non-primary overload signatures are
- * silently dropped from output. This diagnostic surfaces them so authors
- * can move them to the primary signature.
+ * Two contexts emit this:
  *
- * `@default` and `@nodocs` are included here even though overloads never
- * carry a `defaultValue` or per-overload exclusion: their presence on a
- * non-primary signature is always a misplacement.
+ * - **Non-primary overload signature** — symbol-scope tags (`@example`,
+ *   `@deprecated`, `@since`, `@see`, `@throws`, `@mutates`, `@default`,
+ *   `@nodocs`) describe the function as a whole, not individual signatures.
+ *   The primary signature's JSDoc feeds the parent declaration's symbol-level
+ *   extraction; tags on non-primary overload signatures are silently dropped
+ *   from output. This diagnostic surfaces them so authors can move them to
+ *   the primary signature. `@default` and `@nodocs` are included even though
+ *   overloads never carry a `defaultValue` or per-overload exclusion: their
+ *   presence on a non-primary signature is always a misplacement.
+ * - **Module comment** — `@nodocs` has no module-level meaning (it applies to
+ *   declarations and export statements); in a `@module` comment the tag does
+ *   nothing except remain verbatim in `moduleComment` text. To omit a module
+ *   from analysis, use `exclude` patterns instead.
  */
 export const MisplacedTagDiagnostic = z.strictObject({
     kind: z.literal('misplaced_tag'),
@@ -233,8 +237,11 @@ export const MisplacedTagDiagnostic = z.strictObject({
         'default',
         'nodocs',
     ]),
-    /** Name of the function or method whose overload carries the misplaced tag. */
-    functionName: z.string(),
+    /**
+     * Name of the function or method whose overload carries the misplaced tag.
+     * Absent for module-comment misplacements (no enclosing symbol).
+     */
+    functionName: z.string().optional(),
 });
 /**
  * `@param` tag references a name that doesn't match any actual parameter.
@@ -332,7 +339,7 @@ export const Diagnostic = z.discriminatedUnion('kind', [
     TransformFailedDiagnostic,
     ResolverFailedDiagnostic,
 ]);
-// ── Helpers ────────────────────────────────────────────────────────────────
+// Helpers
 /**
  * Check if any error-severity diagnostics were collected.
  */

package/dist/exports.js

@@ -14,10 +14,10 @@ import { join, relative, resolve } from 'node:path';
 import { glob } from 'tinyglobby';
 import { toPosixPath } from './paths.js';
 import { MAX_FILE_CONCURRENCY, map_concurrent } from './concurrency.js';
-// ── Condition priority ───────────────────────────────────────────────────────
+// Condition priority
 /** Priority order for selecting the condition to use for source mapping. */
 const CONDITION_PRIORITY = ['svelte', 'default', 'import', 'require'];
-// ── Parsing ──────────────────────────────────────────────────────────────────
+// Parsing
 /**
  * Read and parse the exports field from package.json.
  *
@@ -85,7 +85,7 @@ const flattenConditions = (value, prefix) => {
     }
     return null;
 };
-// ── Source mapping ───────────────────────────────────────────────────────────
+// Source mapping
 /**
  * Map a dist file path to its source file path.
  *
@@ -131,7 +131,7 @@ export const mapDistToSource = (distPath, condition, options) => {
     }
     return sourceBase;
 };
-// ── Discovery ────────────────────────────────────────────────────────────────
+// Discovery
 /**
  * Select the best condition for source mapping from an export entry.
  */

package/dist/index.d.ts

@@ -7,7 +7,6 @@
  * Svelte analysis internals, or TSDoc parsing utilities.
  *
  * @module
- * @nodocs
  */
 export { analyze, analyzeFromFiles } from './analyze.js';
 export type { AnalyzeOptions, AnalyzeFromFilesOptions } from './analyze.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAC,OAAO,EAAE,gBAAgB,EAAC,MAAM,cAAc,CAAC;AACvD,YAAY,EAAC,cAAc,EAAE,uBAAuB,EAAC,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAC,qBAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAC,qBAAqB,EAAC,MAAM,cAAc,CAAC;AACnD,YAAY,EACX,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAC,cAAc,EAAE,aAAa,EAAE,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAItF,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,UAAU,GACV,MAAM,YAAY,CAAC;AAIpB,OAAO,EACN,cAAc,EACd,cAAc,EACd,eAAe,EACf,MAAM,EACN,kBAAkB,EAClB,0BAA0B,GAC1B,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EAAC,cAAc,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAI9D,OAAO,EAAC,mBAAmB,EAAE,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAC,mBAAmB,EAAE,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAInF,OAAO,EACN,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAC,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AAI9F,OAAO,EAAC,qBAAqB,EAAC,MAAM,YAAY,CAAC;AAIjD,OAAO,EAAC,mBAAmB,EAAC,MAAM,gBAAgB,CAAC;AACnD,YAAY,EACX,SAAS,EACT,0BAA0B,EAC1B,yBAAyB,GACzB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACN,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,UAAU,GACV,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAC,WAAW,EAAC,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAC,OAAO,EAAE,gBAAgB,EAAC,MAAM,cAAc,CAAC;AACvD,YAAY,EAAC,cAAc,EAAE,uBAAuB,EAAC,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAC,qBAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAC,qBAAqB,EAAC,MAAM,cAAc,CAAC;AACnD,YAAY,EACX,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAC,cAAc,EAAE,aAAa,EAAE,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAItF,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,UAAU,GACV,MAAM,YAAY,CAAC;AAIpB,OAAO,EACN,cAAc,EACd,cAAc,EACd,eAAe,EACf,MAAM,EACN,kBAAkB,EAClB,0BAA0B,GAC1B,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EAAC,cAAc,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAI9D,OAAO,EAAC,mBAAmB,EAAE,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAC/E,YAAY,EAAC,mBAAmB,EAAE,qBAAqB,EAAC,MAAM,oBAAoB,CAAC;AAInF,OAAO,EACN,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,oBAAoB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAC,oBAAoB,EAAE,aAAa,EAAE,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AAI9F,OAAO,EAAC,qBAAqB,EAAC,MAAM,YAAY,CAAC;AAIjD,OAAO,EAAC,mBAAmB,EAAC,MAAM,gBAAgB,CAAC;AACnD,YAAY,EACX,SAAS,EACT,0BAA0B,EAC1B,yBAAyB,GACzB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACN,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,UAAU,GACV,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAC,WAAW,EAAC,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -7,24 +7,23 @@
  * Svelte analysis internals, or TSDoc parsing utilities.
  *
  * @module
- * @nodocs
  */
-// ── Core entry points ───────────────────────────────────────────────────────
+// Core entry points
 export { analyze, analyzeFromFiles } from './analyze.js';
 export { throwOnDuplicates, AnalyzeResultJson } from './analyze-core.js';
 export { createAnalysisSession } from './session.js';
 export { normalizeResolveImport } from './dep-resolver.js';
-// ── Types (Zod schemas + TypeScript interfaces) ─────────────────────────────
+// Types (Zod schemas + TypeScript interfaces)
 export { DeclarationKind, DeclarationModifier, MemberKind, Reactivity, GenericParamJson, ParameterJson, ComponentPropJson, OverloadJson, FunctionMemberJson, VariableMemberJson, ConstructorMemberJson, MemberJson, FunctionDeclarationJson, ClassDeclarationJson, InterfaceDeclarationJson, TypeDeclarationJson, VariableDeclarationJson, EnumDeclarationJson, ComponentDeclarationJson, SnippetDeclarationJson, NamespaceDeclarationJson, DeclarationJson, ReExportJson, ExternalReExportJson, ModuleJson, } from './types.js';
-// ── Declaration helpers ────────────────────────────────────────────────────
+// Declaration helpers
 export { getDisplayName, generateImport, compactReplacer, isKind, findTypeReferences, buildTypeReferencePatterns, } from './declaration-helpers.js';
-// ── Source options ──────────────────────────────────────────────────────────
+// Source options
 export { createSourceOptions, DEFAULT_SOURCE_OPTIONS } from './source-config.js';
-// ── Post-processing ────────────────────────────────────────────────────────
+// Post-processing
 export { findDuplicates, mergeReExports, resolveComponentAliases, resolveExportSurface, } from './postprocess.js';
-// ── File system constants ──────────────────────────────────────────────────
+// File system constants
 export { deriveIncludePatterns } from './files.js';
-// ── File discovery ──────────────────────────────────────────────────────────
+// File discovery
 export { discoverSourceFiles } from './discovery.js';
-// ── Diagnostics ─────────────────────────────────────────────────────────────
+// Diagnostics
 export { hasErrors, hasWarnings, errorsOf, warningsOf, byKind, formatDiagnostic, DiagnosticSeverity, DiagnosticKind, Diagnostic, } from './diagnostics.js';

package/dist/postprocess.d.ts

@@ -54,18 +54,22 @@ export interface DuplicateDeclaration {
  */
 export declare const findDuplicates: (modules: Array<ModuleJson>) => Map<string, Array<DuplicateDeclaration>>;
 /**
- * Code-unit string comparator for deterministic output ordering.
- *
- * Unlike `localeCompare` (host-locale/ICU-dependent, so byte-identical input
- * can serialize in different orders on different machines), code-unit order is
- * environment-independent — and it matches the default `Array.prototype.sort`
- * used for `alsoExportedFrom`, `dependencies`, and `dependents`.
+ * Case-insensitive string comparator for deterministic output ordering.
+ *
+ * Case-folded comparison first (so `Analyze` and `analyze` sort together
+ * instead of all uppercase before all lowercase), then a code-unit tiebreak —
+ * so equal-ignoring-case strings still compare unequal and the result is an
+ * exact total order. Unlike `localeCompare` (host-locale/ICU-dependent, so
+ * byte-identical input can serialize in different orders on different
+ * machines), both passes use Unicode default mappings only and are
+ * environment-independent. All output ordering goes through this comparator —
+ * never bare `localeCompare` or default `Array.prototype.sort`.
  */
 export declare const compareStrings: (a: string, b: string) => number;
 /**
  * Sort modules alphabetically by path for deterministic output and cleaner diffs.
  *
- * Code-unit order (`compareStrings`) so the output is environment-independent.
+ * Case-insensitive order (`compareStrings`) so the output is environment-independent.
  *
  * @param modules - the modules to sort
  * @returns a new sorted array (does not mutate input)
@@ -182,7 +186,7 @@ export interface ExportSurfaceEntry {
  * A module's resolved export surface — see `resolveExportSurface`.
  */
 export interface ExportSurface {
-    /** Surface entries, sorted by `name` (code-unit order). */
+    /** Surface entries, sorted by `name` (case-insensitive order, `compareStrings`). */
     entries: Array<ExportSurfaceEntry>;
     /**
      * Star targets (own or transitive) absent from the analyzed set — their

package/dist/postprocess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postprocess.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/postprocess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAA2B,eAAe,EAAE,UAAU,EAAC,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAuBhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,qCAAqC;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CACf;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,cAAc,GAC1B,SAAS,KAAK,CAAC,UAAU,CAAC,KACxB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAwCzC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAAsC,CAAC;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CAExE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,IAmC3D,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,IAoDpE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB,GAC7B,OAAO,aAAa,CAAC,cAAc,CAAC,KAClC,KAAK,CAAC,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,CAwD7D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,GAAG,EAAE,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACtD,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,2DAA2D;IAC3D,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnC;;;OAGG;IACH,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACnC;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,oBAAoB,GAChC,SAAS,KAAK,CAAC,UAAU,CAAC,EAC1B,MAAM,MAAM,KACV,aAAa,GAAG,IA+IlB,CAAC"}
+{"version":3,"file":"postprocess.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/postprocess.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAA2B,eAAe,EAAE,UAAU,EAAC,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAuBhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,qCAAqC;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CACf;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,cAAc,GAC1B,SAAS,KAAK,CAAC,UAAU,CAAC,KACxB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAwCzC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAMrD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CAExE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,IAmC3D,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,IAoDpE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,iBAAiB,GAC7B,OAAO,aAAa,CAAC,cAAc,CAAC,KAClC,KAAK,CAAC,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,CAwD7D,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,GAAG,EAAE,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IACtD,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,oFAAoF;IACpF,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnC;;;OAGG;IACH,qBAAqB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACnC;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,oBAAoB,GAChC,SAAS,KAAK,CAAC,UAAU,CAAC,EAC1B,MAAM,MAAM,KACV,aAAa,GAAG,IA+IlB,CAAC"}

package/dist/postprocess.js

@@ -133,18 +133,30 @@ export const findDuplicates = (modules) => {
     return duplicates;
 };
 /**
- * Code-unit string comparator for deterministic output ordering.
+ * Case-insensitive string comparator for deterministic output ordering.
  *
- * Unlike `localeCompare` (host-locale/ICU-dependent, so byte-identical input
- * can serialize in different orders on different machines), code-unit order is
- * environment-independent — and it matches the default `Array.prototype.sort`
- * used for `alsoExportedFrom`, `dependencies`, and `dependents`.
+ * Case-folded comparison first (so `Analyze` and `analyze` sort together
+ * instead of all uppercase before all lowercase), then a code-unit tiebreak —
+ * so equal-ignoring-case strings still compare unequal and the result is an
+ * exact total order. Unlike `localeCompare` (host-locale/ICU-dependent, so
+ * byte-identical input can serialize in different orders on different
+ * machines), both passes use Unicode default mappings only and are
+ * environment-independent. All output ordering goes through this comparator —
+ * never bare `localeCompare` or default `Array.prototype.sort`.
  */
-export const compareStrings = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+export const compareStrings = (a, b) => {
+    const af = a.toLowerCase();
+    const bf = b.toLowerCase();
+    if (af < bf)
+        return -1;
+    if (af > bf)
+        return 1;
+    return a < b ? -1 : a > b ? 1 : 0;
+};
 /**
  * Sort modules alphabetically by path for deterministic output and cleaner diffs.
  *
- * Code-unit order (`compareStrings`) so the output is environment-independent.
+ * Case-insensitive order (`compareStrings`) so the output is environment-independent.
  *
  * @param modules - the modules to sort
  * @returns a new sorted array (does not mutate input)
@@ -216,7 +228,7 @@ export const mergeReExports = (modules) => {
                 const merged = new Set(declaration.alsoExportedFrom);
                 for (const reExporter of reExporters)
                     merged.add(reExporter);
-                declaration.alsoExportedFrom = Array.from(merged).sort();
+                declaration.alsoExportedFrom = Array.from(merged).sort(compareStrings);
             }
         }
     }
@@ -362,7 +374,7 @@ export const computeDependents = (files) => {
             return file;
         }
         // Sort for deterministic output
-        const dependents = Array.from(computed).sort();
+        const dependents = Array.from(computed).sort(compareStrings);
         return {
             ...file,
             dependents,
@@ -547,7 +559,7 @@ export const resolveExportSurface = (modules, path) => {
         entries: Array.from(resolved.entries.values())
             .map(({ entry }) => entry)
             .sort((a, b) => compareStrings(a.name, b.name)),
-        unresolvedStarExports: Array.from(resolved.unresolvedStars).sort(),
-        externalStarExports: Array.from(resolved.externalStars).sort(),
+        unresolvedStarExports: Array.from(resolved.unresolvedStars).sort(compareStrings),
+        externalStarExports: Array.from(resolved.externalStars).sort(compareStrings),
     };
 };

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAIN,KAAK,8BAA8B,EACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,UAAU,CAAC;AAE1C,OAAO,EAEN,KAAK,aAAa,EAMlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAChD,OAAO,EAAC,KAAK,mBAAmB,EAAmC,MAAM,oBAAoB,CAAC;AAG9F,OAAO,EAGN,iBAAiB,EACjB,KAAK,YAAY,EACjB,MAAM,mBAAmB,CAAC;AAG3B;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC7B,qFAAqF;IACrF,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uEAAuE;IACvE,GAAG,CAAC,EAAE,WAAW,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7E;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/F,0DAA0D;IAC1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mEAAmE;IACnE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,4EAA4E;IAC5E,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,iBAAiB,CAAC;IAC9C;;;;;;;;OAQG;IACH,oBAAoB,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1C;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CACnD,8BAA8B,EAC9B,aAAa,GAAG,cAAc,CAC9B;IACA;;;;;;;;;OASG;IACH,aAAa,EAAE,mBAAmB,CAAC;IACnC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kDAAkD;IAClD,GAAG,CAAC,EAAE,WAAW,CAAC;CAClB;AA+FD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,sBAAsB,KAAG,eAkdvE,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAIN,KAAK,8BAA8B,EACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,UAAU,CAAC;AAE1C,OAAO,EAEN,KAAK,aAAa,EAMlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAChD,OAAO,EAAC,KAAK,mBAAmB,EAAmC,MAAM,oBAAoB,CAAC;AAG9F,OAAO,EAGN,iBAAiB,EACjB,KAAK,YAAY,EACjB,MAAM,mBAAmB,CAAC;AAG3B;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC7B,qFAAqF;IACrF,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;OAIG;IACH,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uEAAuE;IACvE,GAAG,CAAC,EAAE,WAAW,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7E;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/F,0DAA0D;IAC1D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,mEAAmE;IACnE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,4EAA4E;IAC5E,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,iBAAiB,CAAC;IAC9C;;;;;;;;OAQG;IACH,oBAAoB,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1C;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CACnD,8BAA8B,EAC9B,aAAa,GAAG,cAAc,CAC9B;IACA;;;;;;;;;OASG;IACH,aAAa,EAAE,mBAAmB,CAAC;IACnC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kDAAkD;IAClD,GAAG,CAAC,EAAE,WAAW,CAAC;CAClB;AA+FD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,sBAAsB,KAAG,eAsdvE,CAAC"}

package/dist/session.js

@@ -133,7 +133,7 @@ export const createAnalysisSession = (options) => {
             return sessionDefaultResolver;
         return getDefaultResolver();
     };
-    // ── Phase 1: sync per-file transform/lex ─────────────────────────────────
+    // Phase 1: sync per-file transform/lex
     // `resolver` is `null` when the entire batch is pre-resolved — phase 1
     // needs no resolver identity in that case, and skipping `pickResolver`
     // avoids constructing the lazy default for fully pre-resolved consumers.
@@ -231,7 +231,7 @@ export const createAnalysisSession = (options) => {
             preResolvedDeps: usePreResolved ? preResolvedDeps : undefined,
         };
     };
-    // ── Phase 3: serial per-file LS push + entry write ───────────────────────
+    // Phase 3: serial per-file LS push + entry write
     const phase3 = (pending, resolved) => {
         if (pending.cacheHit) {
             // Cached SetFileResult: same diagnostics array reference, changed: false.
@@ -247,13 +247,16 @@ export const createAnalysisSession = (options) => {
         // Build `unfilteredDeps` from one of two sources:
         //   pre-resolved → caller's `file.dependencies`, posixified + filtered
         //   lex+resolve  → resolver task outputs, already posixified, filtered
-        const unfilteredDeps = [];
+        // The Set dedupes in first-occurrence order — multiple statements
+        // importing the same module (or a duplicate caller-declared edge) are
+        // one edge.
+        const depSet = new Set();
         if (pending.preResolvedDeps !== undefined) {
             for (const raw of pending.preResolvedDeps) {
                 const posix = toPosixPath(raw);
                 if (!isSource(posix, sourceOptions))
                     continue;
-                unfilteredDeps.push(posix);
+                depSet.add(posix);
             }
         }
         else {
@@ -262,9 +265,10 @@ export const createAnalysisSession = (options) => {
                     continue;
                 if (!isSource(r, sourceOptions))
                     continue;
-                unfilteredDeps.push(r);
+                depSet.add(r);
             }
         }
+        const unfilteredDeps = [...depSet];
         // Build a mode-specific entry. The discriminator (`mode`) tags which
         // cache-key field to read on the next ingest: `resolverIdentity` for
         // lex+resolve, `preResolvedDepsSnapshot` for pre-resolved. Snapshot
@@ -310,7 +314,7 @@ export const createAnalysisSession = (options) => {
         }
         return { changed: true, diagnostics: [...pending.ingestDiagnostics] };
     };
-    // ── setFiles: orchestrate three phases ───────────────────────────────────
+    // setFiles: orchestrate three phases
     const setFiles = async (files, opts) => {
         await ensureLexerReady();
         // Resolver gating: pick one only if any file in the batch lacks

package/dist/source-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-config.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/source-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAC,KAAK,YAAY,EAAE,KAAK,cAAc,EAAqB,MAAM,aAAa,CAAC;AAGvF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;OAcG;IACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAIpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,mBAAmB,GAC/B,aAAa,MAAM,EACnB,YAAY,OAAO,CAAC,qBAAqB,CAAC,KACxC,mBAKA,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,mBAAmB,KAAG,mBAmDrE,CAAC;AA+BF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,mBAAmB,KAAG,MAQ5D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,SAAS,mBAAmB,KAAG,MAgB5E,CAAC;AAwBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,SAAS,mBAAmB,KAAG,OAwBrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC/B,YAAY,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,EACjE,SAAS,mBAAmB,KAC1B;IAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CA2BzD,CAAC"}
+{"version":3,"file":"source-config.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/source-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAC,KAAK,YAAY,EAAE,KAAK,cAAc,EAAqB,MAAM,aAAa,CAAC;AAIvF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;OAcG;IACH,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;CACvD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAIpC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,mBAAmB,GAC/B,aAAa,MAAM,EACnB,YAAY,OAAO,CAAC,qBAAqB,CAAC,KACxC,mBAKA,CAAC;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,mBAAmB,KAAG,mBAmDrE,CAAC;AA+BF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,mBAAmB,KAAG,MAQ5D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,SAAS,mBAAmB,KAAG,MAgB5E,CAAC;AAwBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,SAAS,mBAAmB,KAAG,OAwBrE,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC/B,YAAY,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,EACjE,SAAS,mBAAmB,KAC1B;IAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CA2BzD,CAAC"}

package/dist/source-config.js

@@ -14,6 +14,7 @@ import { resolve, relative } from 'node:path';
 import picomatch from 'picomatch';
 import { getDefaultAnalyzer } from './source.js';
 import { toPosixPath } from './paths.js';
+import { compareStrings } from './postprocess.js';
 /**
  * Default partial options for standard SvelteKit library structure.
  *
@@ -350,7 +351,7 @@ export const extractDependencies = (sourceFile, options) => {
         }
     }
     // Sort for deterministic output
-    dependencies.sort();
-    dependents.sort();
+    dependencies.sort(compareStrings);
+    dependents.sort(compareStrings);
     return { dependencies, dependents };
 };

package/dist/svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAC,QAAQ,EAAsB,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAA2C,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAC7F,OAAO,KAAK,EAGX,cAAc,EACd,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAAC,KAAK,cAAc,EAA0C,MAAM,aAAa,CAAC;AACzF,OAAO,EAAC,KAAK,mBAAmB,EAAsB,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAC,KAAK,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAGjD,0FAA0F;AAC1F,KAAK,SAAS,GAAG,YAAY,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,sGAAsG;IACtG,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,GAAI,YAAY,cAAc,KAAG,eAoDlE,CAAC;AAkHF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SAcpE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SA0BxE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAI,eAAe,MAAM,KAAG,MAAM,GAAG,SAU3E,CAAC;AA0PF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,OAExD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,GACpC,aAAa,EAAE,CAAC,IAAI,EACpB,SAAS,EAAE,CAAC,WAAW,KACrB,KAAK,CAAC,kBAAkB,CAqB1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,OAKxD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,GAAI,YAAY,KAAK,CAAC,kBAAkB,CAAC,KAAG,MAGtF,CAAC;AA8NF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC/B,YAAY,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,EACjE,YAAY,MAAM,EAClB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,aAAa,KAAK,CAAC,UAAU,CAAC,EAC9B,SAAS,EAAE,CAAC,OAAO,EACnB,aAAa,iBAAiB,KAC5B,cAAc,GAAG,SAoQnB,CAAC"}
+{"version":3,"file":"svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAC,QAAQ,EAAsB,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAA2C,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAC7F,OAAO,KAAK,EAGX,cAAc,EACd,MAAM,wBAAwB,CAAC;AAShC,OAAO,EAAC,KAAK,cAAc,EAA0C,MAAM,aAAa,CAAC;AACzF,OAAO,EAAC,KAAK,mBAAmB,EAAsB,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAC,KAAK,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAGjD,0FAA0F;AAC1F,KAAK,SAAS,GAAG,YAAY,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,sGAAsG;IACtG,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,GAAI,YAAY,cAAc,KAAG,eAoDlE,CAAC;AAkHF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SAcpE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SA0BxE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAI,eAAe,MAAM,KAAG,MAAM,GAAG,SAU3E,CAAC;AAyPF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,OAExD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,GACpC,aAAa,EAAE,CAAC,IAAI,EACpB,SAAS,EAAE,CAAC,WAAW,KACrB,KAAK,CAAC,kBAAkB,CAqB1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,OAKxD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,GAAI,YAAY,KAAK,CAAC,kBAAkB,CAAC,KAAG,MAGtF,CAAC;AA8NF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC/B,YAAY,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,EACjE,YAAY,MAAM,EAClB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,aAAa,KAAK,CAAC,UAAU,CAAC,EAC9B,SAAS,EAAE,CAAC,OAAO,EACnB,aAAa,iBAAiB,KAC5B,cAAc,GAAG,SAyQnB,CAAC"}

package/dist/svelte.js

@@ -26,10 +26,10 @@ import { TraceMap, originalPositionFor } from '@jridgewell/trace-mapping';
 import { VERSION } from 'svelte/compiler';
 import { svelte2tsx } from 'svelte2tsx';
 import ts from 'typescript';
-import { parseComment, applyToDeclaration, hasModuleTag } from './tsdoc.js';
+import { parseComment, applyToDeclaration } from './tsdoc.js';
 import { createIsExternalFile } from './typescript-program.js';
 import { parseGenericParam, filterExternalProperties } from './typescript-extract-shared.js';
-import { extractModuleComment, analyzeExports } from './typescript-exports.js';
+import { extractModuleComment, analyzeExports, warnModuleCommentNodocs, } from './typescript-exports.js';
 import { getComponentName, SVELTE_VIRTUAL_SUFFIX } from './source.js';
 import { extractDependencies } from './source-config.js';
 import {} from './diagnostics.js';
@@ -298,9 +298,10 @@ const hasScriptDocComment = (scriptContent) => {
     if (!scriptContent)
         return false;
     const sourceFile = ts.createSourceFile('script.ts', scriptContent, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
-    // Walk statements looking for a non-@module JSDoc comment
+    // Walk statements looking for a JSDoc comment (`parseComment` filters
+    // `@module` blocks, so module comments don't count)
     for (const statement of sourceFile.statements) {
-        if (ts.isVariableStatement(statement) && !hasModuleTag(statement)) {
+        if (ts.isVariableStatement(statement)) {
             const tsdoc = parseComment(statement, sourceFile);
             if (tsdoc)
                 return true;
@@ -327,14 +328,12 @@ const extractComponentTsdoc = (sourceFile) => {
         }
         // Check for JSDoc on VariableStatement or VariableDeclaration
         // Component-level JSDoc is attached to these node types
-        // Skip @module comments — those are module-level, not component-level
+        // (`parseComment` filters module-level `@module` blocks)
         if (ts.isVariableStatement(node) || ts.isVariableDeclaration(node)) {
-            if (!hasModuleTag(node)) {
-                const tsdoc = parseComment(node, sourceFile);
-                if (tsdoc) {
-                    foundTsdoc = tsdoc;
-                    return;
-                }
+            const tsdoc = parseComment(node, sourceFile);
+            if (tsdoc) {
+                foundTsdoc = tsdoc;
+                return;
             }
         }
         // Continue searching child nodes
@@ -465,7 +464,7 @@ const extractPropsMetadata = (virtualSource) => {
     visit(virtualSource);
     return { bindableProps, propsDefaults, propsTypeName };
 };
-// ── Snippet Detection ──────────────────────────────────────────────────────
+// Snippet Detection
 /**
  * Check if a type string represents a `Snippet` type.
  *
@@ -536,7 +535,7 @@ export const synthesizeSnippetTypeSignature = (parameters) => {
     const inner = parameters.map((p) => `${p.name}: ${p.type}`).join(', ');
     return `Snippet<[${inner}]>`;
 };
-// ── Checker-Backed Analysis ─────────────────────────────────────────────────
+// Checker-Backed Analysis
 /**
  * Check if a symbol name is an internal svelte2tsx identifier.
  *
@@ -906,6 +905,10 @@ export const analyzeSvelteModule = (sourceFile, modulePath, checker, options, di
         : undefined;
     const htmlModuleComment = extractHtmlModuleComment(sourceFile.content);
     const moduleComment = instanceModuleComment ?? scriptModuleComment ?? htmlModuleComment;
+    // @nodocs has no module-level meaning — warn per misplaced comment. The
+    // <script module> source is covered by analyzeExports on the virtual above.
+    warnModuleCommentNodocs(instanceModuleComment, modulePath, diagnostics);
+    warnModuleCommentNodocs(htmlModuleComment, modulePath, diagnostics);
     // Warn if multiple @module sources exist
     const moduleCommentSources = [
         instanceModuleComment,

package/dist/tsdoc.d.ts

@@ -31,6 +31,10 @@
  *
  * ## Behavioral notes
  *
+ * JSDoc blocks tagged `@module` are excluded from `parseComment` entirely (text
+ * and tags) — module comments attach to the file's first statement in the AST
+ * and are owned by `extractModuleComment` instead.
+ *
  * Due to TS Compiler API limitations:
  * - TS API includes dash separator in `@param` tag text; we strip the leading `- ` as it's syntax, not content
  * - `@throws` tags have `{Type}` stripped by TS API; fallback regex extracts first word as error type
@@ -92,9 +96,14 @@ export interface TsdocParsedComment {
  * - `@mutates` - mutation documentation (non-standard)
  * - `@nodocs` - exclusion flag (non-standard)
  *
+ * JSDoc blocks tagged `@module` are excluded entirely (text and tags): a module
+ * comment attaches to the file's first statement in the AST, and without the
+ * filter it would read as that statement's own docs. `extractModuleComment`
+ * (`typescript-exports.ts`) owns module comments.
+ *
  * @param node - the TypeScript node to extract JSDoc from
  * @param sourceFile - source file (used for extracting full `@see` tag text)
- * @returns parsed comment with structured metadata, or undefined if no JSDoc found
+ * @returns parsed comment with structured metadata, or undefined if no JSDoc found (or only `@module` blocks)
  *
  * @example
  * ```ts
@@ -117,16 +126,6 @@ export declare const parseComment: (node: ts.Node, sourceFile: ts.SourceFile) =>
  * @mutates declaration - adds docComment, deprecatedMessage, examples, seeAlso, throws, since, mutates, defaultValue fields
  */
 export declare const applyToDeclaration: (declaration: DeclarationJsonBuild | MemberJsonBuild, tsdoc: TsdocParsedComment | undefined) => void;
-/**
- * Check if a TypeScript node has a `@module` JSDoc tag.
- *
- * Used to prevent `@module` comments from leaking into declaration `docComment` fields.
- * Module-level comments are extracted separately by `extractModuleComment`.
- *
- * @param node - the TypeScript node to check
- * @returns true if any JSDoc tag on the node is `@module`
- */
-export declare const hasModuleTag: (node: ts.Node) => boolean;
 /**
  * Clean raw JSDoc comment text by removing comment markers and leading asterisks.
  *

package/dist/tsdoc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdoc.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tsdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAC,oBAAoB,EAAE,eAAe,EAAC,MAAM,wBAAwB,CAAC;AAElF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACrD,qCAAqC;IACrC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAYD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY,GACxB,MAAM,EAAE,CAAC,IAAI,EACb,YAAY,EAAE,CAAC,UAAU,KACvB,kBAAkB,GAAG,SA4GvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC9B,aAAa,oBAAoB,GAAG,eAAe,EACnD,OAAO,kBAAkB,GAAG,SAAS,KACnC,IAgCF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,EAAE,CAAC,IAAI,KAAG,OACsB,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,KAAG,MAAM,GAAG,SAW3D,CAAC"}
+{"version":3,"file":"tsdoc.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tsdoc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAC,oBAAoB,EAAE,eAAe,EAAC,MAAM,wBAAwB,CAAC;AAElF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACrD,qCAAqC;IACrC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,YAAY,GACxB,MAAM,EAAE,CAAC,IAAI,EACb,YAAY,EAAE,CAAC,UAAU,KACvB,kBAAkB,GAAG,SA4GvB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC9B,aAAa,oBAAoB,GAAG,eAAe,EACnD,OAAO,kBAAkB,GAAG,SAAS,KACnC,IAgCF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,KAAG,MAAM,GAAG,SAW3D,CAAC"}

package/dist/tsdoc.js

@@ -31,6 +31,10 @@
  *
  * ## Behavioral notes
  *
+ * JSDoc blocks tagged `@module` are excluded from `parseComment` entirely (text
+ * and tags) — module comments attach to the file's first statement in the AST
+ * and are owned by `extractModuleComment` instead.
+ *
  * Due to TS Compiler API limitations:
  * - TS API includes dash separator in `@param` tag text; we strip the leading `- ` as it's syntax, not content
  * - `@throws` tags have `{Type}` stripped by TS API; fallback regex extracts first word as error type
@@ -51,6 +55,22 @@ import ts from 'typescript';
  * @returns cleaned text with leading `- ` removed if present
  */
 const cleanTagDescription = (text) => text.trim().replace(/^-\s+/, '');
+/**
+ * Whether a JSDoc block is a module-level comment (carries a `@module` tag).
+ */
+const isModuleJsdocBlock = (jsdoc) => jsdoc.tags?.some((tag) => tag.tagName.text === 'module') ?? false;
+/**
+ * Whether a JSDoc node or tag belongs to a module-level (`@module`) block.
+ *
+ * A module comment physically precedes the file's first statement, so the AST
+ * attaches it to that statement's JSDoc — without this filter the module
+ * comment (including tags like `@nodocs`) would read as the statement's own
+ * docs. Per-block, so a statement's own JSDoc below a module comment still
+ * applies. `extractModuleComment` owns module-comment extraction.
+ */
+const belongsToModuleBlock = (node) => ts.isJSDoc(node)
+    ? isModuleJsdocBlock(node)
+    : ts.isJSDoc(node.parent) && isModuleJsdocBlock(node.parent);
 /**
  * Parse JSDoc comment from a TypeScript node.
  *
@@ -67,9 +87,14 @@ const cleanTagDescription = (text) => text.trim().replace(/^-\s+/, '');
  * - `@mutates` - mutation documentation (non-standard)
  * - `@nodocs` - exclusion flag (non-standard)
  *
+ * JSDoc blocks tagged `@module` are excluded entirely (text and tags): a module
+ * comment attaches to the file's first statement in the AST, and without the
+ * filter it would read as that statement's own docs. `extractModuleComment`
+ * (`typescript-exports.ts`) owns module comments.
+ *
  * @param node - the TypeScript node to extract JSDoc from
  * @param sourceFile - source file (used for extracting full `@see` tag text)
- * @returns parsed comment with structured metadata, or undefined if no JSDoc found
+ * @returns parsed comment with structured metadata, or undefined if no JSDoc found (or only `@module` blocks)
  *
  * @example
  * ```ts
@@ -81,7 +106,7 @@ const cleanTagDescription = (text) => text.trim().replace(/^-\s+/, '');
  * ```
  */
 export const parseComment = (node, sourceFile) => {
-    const tsdocComments = ts.getJSDocCommentsAndTags(node);
+    const tsdocComments = ts.getJSDocCommentsAndTags(node).filter((c) => !belongsToModuleBlock(c));
     if (tsdocComments.length === 0)
         return undefined;
     let fullText = '';
@@ -109,8 +134,8 @@ export const parseComment = (node, sourceFile) => {
             fullText += text + '\n';
         }
     }
-    // Extract tags
-    const tags = ts.getJSDocTags(node);
+    // Extract tags (module-block tags filtered like their text above)
+    const tags = ts.getJSDocTags(node).filter((tag) => !belongsToModuleBlock(tag));
     for (const tag of tags) {
         const tagText = typeof tag.comment === 'string' ? tag.comment : tag.comment?.map((c) => c.text).join('');
         const tagName = tag.tagName.text;
@@ -233,16 +258,6 @@ export const applyToDeclaration = (declaration, tsdoc) => {
         declaration.defaultValue = tsdoc.defaultValue;
     }
 };
-/**
- * Check if a TypeScript node has a `@module` JSDoc tag.
- *
- * Used to prevent `@module` comments from leaking into declaration `docComment` fields.
- * Module-level comments are extracted separately by `extractModuleComment`.
- *
- * @param node - the TypeScript node to check
- * @returns true if any JSDoc tag on the node is `@module`
- */
-export const hasModuleTag = (node) => ts.getJSDocTags(node).some((tag) => tag.tagName.text === 'module');
 /**
  * Clean raw JSDoc comment text by removing comment markers and leading asterisks.
  *

package/dist/types.js

@@ -304,7 +304,7 @@ const functionLikeFields = {
     ...callableFields,
     ...returnFields,
 };
-// ── MemberJson Variants ────────────────────────────────────────────────────
+// MemberJson Variants
 /**
  * A function member (method, call signature, method signature).
  * Has `parameters`, `returnType`, `returnDescription`, `overloads`.
@@ -380,7 +380,7 @@ export const ConstructorMemberJson = z.strictObject({
  * Nesting is exactly one level deep — members never contain their own members.
  */
 export const MemberJson = z.discriminatedUnion('kind', [FunctionMemberJson, VariableMemberJson, ConstructorMemberJson]);
-// ── DeclarationJson Variants ────────────────────────────────────────────────
+// DeclarationJson Variants
 /** Top-level-only fields shared by all `DeclarationJson` variants. */
 const declarationTopLevelFields = {
     /**

package/dist/typescript-exports.d.ts

@@ -90,4 +90,18 @@ export declare const analyzeDeclaration: (symbol: ts.Symbol, sourceFile: ts.Sour
  * @see {@link https://typedoc.org/documents/Tags._module.html|TypeDoc @module documentation}
  */
 export declare const extractModuleComment: (sourceFile: ts.SourceFile) => string | undefined;
+/**
+ * Warn when a module comment carries `@nodocs`.
+ *
+ * The tag has no module-level meaning — it applies to declarations and export
+ * statements — so its presence in a `@module` comment is always author
+ * confusion: it does nothing except remain verbatim in `moduleComment` text.
+ * Same line-start detection as `extractModuleComment`'s `@module` test, so a
+ * backticked or mid-prose mention doesn't trigger.
+ *
+ * @internal Shared by `analyzeExports` (TS files and Svelte `<script module>`
+ * virtuals) and `analyzeSvelteModule` (instance-script and HTML module
+ * comments, which `analyzeExports` never sees).
+ */
+export declare const warnModuleCommentNodocs: (moduleComment: string | undefined, file: string, diagnostics: Array<Diagnostic>) => void;
 //# sourceMappingURL=typescript-exports.d.ts.map

package/dist/typescript-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript-exports.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/typescript-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EACX,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EAErB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACN,KAAK,cAAc,EAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,mBAAmB,EAIxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,KAAK,cAAc,EAAuB,MAAM,yBAAyB,CAAC;AAMlF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,GACnC,gBAAgB,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,EACrE,cAAc,EAAE,CAAC,UAAU,EAC3B,YAAY,MAAM,EAClB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,aAAa,KAAK,CAAC,UAAU,CAAC,KAC5B,cAyBF,CAAC;AA+QF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAC1B,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,aAAa,KAAK,CAAC,UAAU,CAAC,KAC5B,qBA0UF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,EAAE,CAAC,MAAM,EACjB,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,CAAC,WAAW,EACvB,aAAa,KAAK,CAAC,UAAU,CAAC,EAC9B,gBAAgB,cAAc,KAC5B,mBA+CF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAAI,YAAY,EAAE,CAAC,UAAU,KAAG,MAAM,GAAG,SAqCzE,CAAC"}
+{"version":3,"file":"typescript-exports.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/typescript-exports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EACX,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EAErB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACN,KAAK,cAAc,EAInB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,mBAAmB,EAIxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAC,KAAK,cAAc,EAAuB,MAAM,yBAAyB,CAAC;AAMlF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,uBAAuB,GACnC,gBAAgB,cAAc,GAAG;IAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CAAC,EACrE,cAAc,EAAE,CAAC,UAAU,EAC3B,YAAY,MAAM,EAClB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,aAAa,KAAK,CAAC,UAAU,CAAC,KAC5B,cAyBF,CAAC;AA+QF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAC1B,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,aAAa,KAAK,CAAC,UAAU,CAAC,KAC5B,qBA4UF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,EAAE,CAAC,MAAM,EACjB,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,CAAC,WAAW,EACvB,aAAa,KAAK,CAAC,UAAU,CAAC,EAC9B,gBAAgB,cAAc,KAC5B,mBA+CF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAAI,YAAY,EAAE,CAAC,UAAU,KAAG,MAAM,GAAG,SAqCzE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,GACnC,eAAe,MAAM,GAAG,SAAS,EACjC,MAAM,MAAM,EACZ,aAAa,KAAK,CAAC,UAAU,CAAC,KAC5B,IAUF,CAAC"}

package/dist/typescript-exports.js

@@ -12,7 +12,7 @@
  * @module
  */
 import ts from 'typescript';
-import { parseComment, applyToDeclaration, cleanComment, hasModuleTag } from './tsdoc.js';
+import { parseComment, applyToDeclaration, cleanComment } from './tsdoc.js';
 import { stripVirtualSuffix, SVELTE_VIRTUAL_SUFFIX, getComponentName, } from './source.js';
 import { extractDependencies, extractPath, isSource, } from './source-config.js';
 import { createIsExternalFile } from './typescript-program.js';
@@ -297,6 +297,7 @@ export const analyzeExports = (sourceFile, checker, options, diagnostics) => {
     // Normalize virtual paths once (e.g., Foo.svelte.__svelte2tsx__.ts → Foo.svelte)
     // so re-export tracking matches real module paths
     const currentFileName = stripVirtualSuffix(sourceFile.fileName);
+    warnModuleCommentNodocs(moduleComment, currentFileName, diagnostics);
     // 1-based line of a node in this file. Virtual coordinates for Svelte
     // `<script module>` sources — remapped in `analyzeSvelteModule`.
     const lineOf = (node) => sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1;
@@ -605,12 +606,12 @@ export const analyzeDeclaration = (symbol, sourceFile, checker, diagnostics, isE
     if (!declNode) {
         return { declaration: result, nodocs: false };
     }
-    // Extract TSDoc — skip @module comments (handled by extractModuleComment)
+    // Extract TSDoc — `parseComment` filters `@module` blocks (handled by
+    // `extractModuleComment`), so a first declaration under a module comment
+    // keeps its own JSDoc
     const tsdoc = parseComment(declNode, sourceFile);
     const nodocs = tsdoc?.nodocs ?? false;
-    if (!hasModuleTag(declNode)) {
-        applyToDeclaration(result, tsdoc);
-    }
+    applyToDeclaration(result, tsdoc);
     // Extract source line
     const start = declNode.getStart(sourceFile);
     const startPos = sourceFile.getLineAndCharacterOfPosition(start);
@@ -680,6 +681,30 @@ export const extractModuleComment = (sourceFile) => {
     }
     return undefined;
 };
+/**
+ * Warn when a module comment carries `@nodocs`.
+ *
+ * The tag has no module-level meaning — it applies to declarations and export
+ * statements — so its presence in a `@module` comment is always author
+ * confusion: it does nothing except remain verbatim in `moduleComment` text.
+ * Same line-start detection as `extractModuleComment`'s `@module` test, so a
+ * backticked or mid-prose mention doesn't trigger.
+ *
+ * @internal Shared by `analyzeExports` (TS files and Svelte `<script module>`
+ * virtuals) and `analyzeSvelteModule` (instance-script and HTML module
+ * comments, which `analyzeExports` never sees).
+ */
+export const warnModuleCommentNodocs = (moduleComment, file, diagnostics) => {
+    if (!moduleComment || !/(?:^|\n)@nodocs\b/.test(moduleComment))
+        return;
+    diagnostics.push({
+        kind: 'misplaced_tag',
+        file,
+        message: '@nodocs in a module comment has no effect — it applies to declarations and export statements; to omit a module from analysis, use exclude patterns',
+        severity: 'warning',
+        tagName: 'nodocs',
+    });
+};
 /**
  * Strip `@module` tag line from comment text.
  *

package/dist/vite.js

@@ -71,7 +71,7 @@ const svelteDocinfo = (options = {}) => {
     // runs at cold start). Tracked here because the session has no concept of
     // "discovery" — it ingests files the plugin hands to it.
     let discoveryDiagnostics = [];
-    // ── Resolver wiring ──────────────────────────────────────────────────────
+    // Resolver wiring
     // Dev resolver: server.pluginContainer.resolveId. Stable identity across
     // the dev session — cache hits work across HMR cycles.
     const viteDevResolver = {
@@ -86,7 +86,7 @@ const svelteDocinfo = (options = {}) => {
         },
         identity: VITE_DEV_IDENTITY,
     };
-    // ── In-flight analysis tracking ─────────────────────────────────────────
+    // In-flight analysis tracking
     // Initial analysis runs once in buildStart; HMR flushes run on debounce.
     // `load()` awaits both so we never serve stale JSON to a freshly-importing
     // module.
@@ -182,7 +182,7 @@ const svelteDocinfo = (options = {}) => {
         log.error(`[svelte-docinfo] ${message}`);
     };
     const isWatchedFile = (file) => isSource(file, resolvedSourceOptions);
-    // ── Initial analysis (cold start in buildStart) ──────────────────────────
+    // Initial analysis (cold start in buildStart)
     const runInitialAnalysis = async () => {
         if (!session)
             return;
@@ -198,7 +198,7 @@ const svelteDocinfo = (options = {}) => {
         const result = session.query({ onDuplicates, log: logger ?? undefined });
         updateOutputFromQuery(result.modules, result.diagnostics);
     };
-    // ── HMR flush: drain pendingChanges via setFiles + query ─────────────────
+    // HMR flush: drain pendingChanges via setFiles + query
     const flushBatch = async () => {
         if (initialPromise)
             await initialPromise;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-docinfo",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "static analysis for TypeScript and Svelte",
   "glyph": "📜",
   "logo": "logo.svg",
@@ -53,7 +53,7 @@
     "@fuzdev/blake3_wasm": "^0.1.1",
     "@fuzdev/fuz_code": "^0.46.0",
     "@fuzdev/fuz_css": "^0.62.0",
-    "@fuzdev/fuz_ui": "^0.202.0",
+    "@fuzdev/fuz_ui": "^0.203.1",
     "@fuzdev/fuz_util": "^0.65.1",
     "@fuzdev/gro": "^0.204.0",
     "@ryanatkn/eslint-config": "^0.12.1",