svelte-docinfo 0.5.1 → 0.5.3

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-build.d.ts

@@ -121,7 +121,11 @@ export interface DeclarationAnalysis {
  * Produced by `analyzeExports` in `typescript-exports.ts`.
  */
 export interface ModuleExportsAnalysis {
-    /** Module-level documentation comment. */
+    /**
+     * Module-level documentation comment. Always `undefined` for svelte2tsx
+     * virtual files — `analyzeSvelteModule` extracts Svelte module comments
+     * from the original source instead.
+     */
     moduleComment?: string;
     /** All exported declarations with `@nodocs` flags — consumer filters based on policy. */
     declarations: Array<DeclarationAnalysis>;

package/dist/declaration-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declaration-build.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration-build.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"declaration-build.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration-build.ts"],"names":[],"mappings":"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"}

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.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.
  *
@@ -339,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.js

@@ -8,22 +8,22 @@
  *
  * @module
  */
-// ── 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/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/svelte.d.ts

@@ -90,6 +90,16 @@ export declare const transformSvelteSource: (sourceFile: SourceFileInfo) => Tran
  * @returns the script tag content, or undefined if no matching script tag is found
  */
 export declare const extractScriptContent: (svelteSource: string) => string | undefined;
+/**
+ * Extract the content of the module `<script>` tag from Svelte source.
+ *
+ * Counterpart of `extractScriptContent` with the same attribute test inverted:
+ * matches only module scripts (`<script module>`, `<script context="module">`),
+ * so the two partition a source's script tags consistently.
+ *
+ * @returns the module script tag content, or undefined if no module script is found
+ */
+export declare const extractModuleScriptContent: (svelteSource: string) => string | undefined;
 /**
  * Extract `@module` comment from HTML comments in Svelte source.
  *
@@ -105,9 +115,11 @@ export declare const extractHtmlModuleComment: (svelteSource: string) => string
  * Extract module-level comment from Svelte script content.
  *
  * Parses the script content as TypeScript and delegates to `extractModuleComment`
- * for the shared `@module` tag detection logic.
+ * for the shared `@module` tag detection logic. Works on either script's
+ * content — instance `<script>` and `<script module>` (see
+ * `extractScriptContent`/`extractModuleScriptContent`).
  *
- * @param scriptContent - the content of the `<script>` tag
+ * @param scriptContent - the content of a `<script>` or `<script module>` tag
  * @returns the cleaned module comment text, or undefined if none found
  */
 export declare const extractSvelteModuleComment: (scriptContent: string) => string | undefined;

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;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"}
+{"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,SAC9B,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SACrC,CAAC;AAmBvC;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,GAAI,cAAc,MAAM,KAAG,MAAM,GAAG,SA0BxE,CAAC;AAEF;;;;;;;;;;GAUG;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,SAiRnB,CAAC"}

package/dist/svelte.js

@@ -204,19 +204,31 @@ const extractComponentSourceLine = (virtualSource, sourceMap) => {
  *
  * @returns the script tag content, or undefined if no matching script tag is found
  */
-export const extractScriptContent = (svelteSource) => {
-    // Match <script> with any attributes, excluding module scripts:
-    // - Svelte 5: <script module> or <script lang="ts" module>
-    // - Svelte 4: <script context="module"> or <script lang="ts" context="module">
-    // Uses global regex to skip module scripts and find the instance script
+export const extractScriptContent = (svelteSource) => findScriptContent(svelteSource, false);
+/**
+ * Extract the content of the module `<script>` tag from Svelte source.
+ *
+ * Counterpart of `extractScriptContent` with the same attribute test inverted:
+ * matches only module scripts (`<script module>`, `<script context="module">`),
+ * so the two partition a source's script tags consistently.
+ *
+ * @returns the module script tag content, or undefined if no module script is found
+ */
+export const extractModuleScriptContent = (svelteSource) => findScriptContent(svelteSource, true);
+/**
+ * Shared scan behind `extractScriptContent`/`extractModuleScriptContent`.
+ *
+ * A script tag is a module script when its attributes contain the word
+ * `module` — covers Svelte 5 `<script module>` (with any `lang`) and
+ * Svelte 4 `<script context="module">`.
+ */
+const findScriptContent = (svelteSource, wantModule) => {
     const scriptRegex = /<script(\s+[^>]*)?>([^]*?)<\/script>/gi;
     let match;
     while ((match = scriptRegex.exec(svelteSource)) !== null) {
         const attrs = match[1] ?? '';
-        // Skip module scripts (Svelte 5 `module` attribute or Svelte 4 `context="module"`)
-        if (/\bmodule\b/.test(attrs))
-            continue;
-        return match[2];
+        if (/\bmodule\b/.test(attrs) === wantModule)
+            return match[2];
     }
     return undefined;
 };
@@ -259,9 +271,11 @@ export const extractHtmlModuleComment = (svelteSource) => {
  * Extract module-level comment from Svelte script content.
  *
  * Parses the script content as TypeScript and delegates to `extractModuleComment`
- * for the shared `@module` tag detection logic.
+ * for the shared `@module` tag detection logic. Works on either script's
+ * content — instance `<script>` and `<script module>` (see
+ * `extractScriptContent`/`extractModuleScriptContent`).
  *
- * @param scriptContent - the content of the `<script>` tag
+ * @param scriptContent - the content of a `<script>` or `<script module>` tag
  * @returns the cleaned module comment text, or undefined if none found
  */
 export const extractSvelteModuleComment = (scriptContent) => {
@@ -464,7 +478,7 @@ const extractPropsMetadata = (virtualSource) => {
     visit(virtualSource);
     return { bindableProps, propsDefaults, propsTypeName };
 };
-// ── Snippet Detection ──────────────────────────────────────────────────────
+// Snippet Detection
 /**
  * Check if a type string represents a `Snippet` type.
  *
@@ -535,7 +549,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.
  *
@@ -726,8 +740,13 @@ export const analyzeSvelteModule = (sourceFile, modulePath, checker, options, di
         });
         return undefined;
     }
-    // 1. Use analyzeExports for full checker-backed analysis (same as .ts files)
-    const { declarations: rawDeclarations, reExports, starExports, externalReExports, externalStarExports, moduleComment: scriptModuleComment, } = analyzeExports(virtualTsSource, checker, options, diagnostics);
+    // 1. Use analyzeExports for full checker-backed analysis (same as .ts files).
+    // Its `moduleComment` is undefined for virtuals — the `<script module>`
+    // comment is extracted from the original source in step 4, because svelte2tsx
+    // hoists instance-script imports (with their leading JSDoc) to the virtual's
+    // top level, where an instance `@module` comment would masquerade as a
+    // `<script module>` one.
+    const { declarations: rawDeclarations, reExports, starExports, externalReExports, externalStarExports, } = analyzeExports(virtualTsSource, checker, options, diagnostics);
     // 2. Filter internal svelte2tsx symbols and the default export (generated component class),
     //    and reclassify exported snippets from 'function' to 'snippet'
     const moduleDeclarations = [];
@@ -903,11 +922,15 @@ export const analyzeSvelteModule = (sourceFile, modulePath, checker, options, di
     const instanceModuleComment = scriptContent
         ? extractSvelteModuleComment(scriptContent)
         : undefined;
+    const moduleScriptContent = extractModuleScriptContent(sourceFile.content);
+    const scriptModuleComment = moduleScriptContent
+        ? extractSvelteModuleComment(moduleScriptContent)
+        : 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.
+    // @nodocs has no module-level meaning — warn per misplaced comment
     warnModuleCommentNodocs(instanceModuleComment, modulePath, diagnostics);
+    warnModuleCommentNodocs(scriptModuleComment, modulePath, diagnostics);
     warnModuleCommentNodocs(htmlModuleComment, modulePath, diagnostics);
     // Warn if multiple @module sources exist
     const moduleCommentSources = [

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

@@ -40,7 +40,8 @@ export declare const analyzeTypescriptModule: (sourceFileInfo: SourceFileInfo &
 /**
  * Analyze all exports from a TypeScript source file.
  *
- * Extracts the module-level comment via `extractModuleComment`, star exports via
+ * Extracts the module-level comment via `extractModuleComment` (skipped for
+ * svelte2tsx virtual files — see the inline note), star exports via
  * `extractStarExports`, and all exported declarations with complete metadata.
  * Handles re-exports by:
  * - Same-name re-exports: tracked in `reExports` for `alsoExportedFrom` building

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,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,cAAc,GAC1B,YAAY,EAAE,CAAC,UAAU,EACzB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,aAAa,KAAK,CAAC,UAAU,CAAC,KAC5B,qBAgVF,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

@@ -266,7 +266,8 @@ const synthesizeCrossFileAlias = (publicName, aliasedSymbol, originalSource, ori
 /**
  * Analyze all exports from a TypeScript source file.
  *
- * Extracts the module-level comment via `extractModuleComment`, star exports via
+ * Extracts the module-level comment via `extractModuleComment` (skipped for
+ * svelte2tsx virtual files — see the inline note), star exports via
  * `extractStarExports`, and all exported declarations with complete metadata.
  * Handles re-exports by:
  * - Same-name re-exports: tracked in `reExports` for `alsoExportedFrom` building
@@ -290,13 +291,17 @@ export const analyzeExports = (sourceFile, checker, options, diagnostics) => {
     const reExports = [];
     const externalReExports = [];
     const isExternalFile = createIsExternalFile(options);
-    // Extract module-level comment
-    const moduleComment = extractModuleComment(sourceFile);
     // Extract star exports (export * from './module' / 'pkg')
     const { starExports, externalStarExports } = extractStarExports(sourceFile, checker, options);
     // 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);
+    // Extract module-level comment — skipped for svelte2tsx virtuals, where
+    // hoisted instance-script comments would read as module comments;
+    // `analyzeSvelteModule` extracts the `<script module>` comment from the
+    // original source instead (and owns its `@nodocs` warning)
+    const isVirtual = currentFileName !== sourceFile.fileName;
+    const moduleComment = isVirtual ? undefined : extractModuleComment(sourceFile);
     warnModuleCommentNodocs(moduleComment, currentFileName, diagnostics);
     // 1-based line of a node in this file. Virtual coordinates for Svelte
     // `<script module>` sources — remapped in `analyzeSvelteModule`.

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.1",
+  "version": "0.5.3",
   "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",