svelte-docinfo 0.7.0 → 0.8.0

package/dist/source.js

@@ -1,12 +1,9 @@
 /**
- * Source file type predicates and path helpers.
- *
- * Pure functions for detecting file types by extension and extracting
- * component names from paths. No configuration dependency — these are
- * the building blocks used by `source-config.ts`.
+ * Source file shapes (`SourceFileInfo`, `AnalyzerType`), extension predicates,
+ * and svelte2tsx virtual-path and generated-name helpers. No configuration
+ * dependency; the building blocks under `source-config.ts`.
  *
  * @see `source-config.ts` for configuration-aware functions (`isSource`, `extractPath`, etc.)
- * @see `analyze.ts` for consumers (`analyze`, `analyzeFromFiles`)
  *
  * @module
  */
@@ -14,7 +11,7 @@
  * Default analyzer resolver based on file extension.
  *
  * - `.svelte` → `'svelte'`
- * - `.ts`, `.js` → `'typescript'`
+ * - `.ts` (not `.d.ts`), `.js` → `'typescript'`
  * - `.css` → `'css'`
  * - `.json` → `'json'`
  * - Other extensions → `null` (skip)

package/dist/svelte.d.ts

@@ -74,8 +74,9 @@ export interface TransformResult {
  *
  * Produces a `SvelteVirtualFile` containing the transformed TypeScript content
  * and source map. The virtual file can be included in a TypeScript program
- * (via `createAnalysisProgram({ virtualFiles })`) so that the checker can
- * resolve imported types, `<script module>` exports, and re-exports.
+ * (via `createAnalysisProgram({ virtualFiles })`, or the language service's
+ * `setFile` in sessions) so that the checker can resolve imported types,
+ * `<script module>` exports, and re-exports.
  *
  * Errors at ingest are returned via `diagnostics` rather than thrown:
  * - svelte2tsx throws → `transform_failed`, `virtual: undefined`
@@ -153,7 +154,7 @@ export declare const extractSvelteModuleComment: (scriptContent: string) => stri
  * assembling modules themselves through `analyzeModule` /
  * `analyzeSvelteModule`.
  *
- * @mutates diagnostics — rewrites `line`/`column` on virtual-file entries
+ * @mutates diagnostics - rewrites `line`/`column` on virtual-file entries
  */
 export declare const remapVirtualDiagnosticPositions: (diagnostics: Array<Diagnostic>, virtualFiles: Iterable<SvelteVirtualFile>) => void;
 /**
@@ -224,11 +225,27 @@ export declare const synthesizeSnippetTypeSignature: (parameters: Array<Paramete
  * Analyze a Svelte module using checker-backed analysis.
  *
  * Requires the svelte2tsx virtual output to be included in the TypeScript program
- * (via `createAnalysisProgram({ virtualFiles })`). Provides full type resolution for:
+ * (via `createAnalysisProgram({ virtualFiles })`, or the language service's
+ * `setFile` in sessions). Provides full type resolution for:
  * - Imported prop types (`let {x}: ImportedProps = $props()`)
  * - `<script module>` exports (constants, types, re-exports)
  * - Star exports and re-exports from Svelte files
  *
+ * Mirrors the numbered steps in the body:
+ *
+ * 1. `analyzeExports` on the virtual collects `<script module>` exports,
+ *    re-exports, and star exports
+ * 2. svelte2tsx internals are filtered (`isSvelte2tsxGeneratedExport`) and
+ *    exported snippets reclassified to `kind: 'snippet'` (`isSnippetReturnType`);
+ *    2b remaps module-level `sourceLine`s to the original `.svelte` source
+ * 3. the component declaration is synthesized: props via `extractPropsViaChecker`,
+ *    `acceptsChildren` from a `Snippet`-typed `children` prop or, failing that,
+ *    template use (`__sveltets_2_ensureSnippet`), plus generics, doc comment, and
+ *    source line from the landmarks `findComponentNodes` locates
+ * 4. the module comment is read from the original source
+ * 5. declarations combine, component first
+ * 6. dependencies are extracted
+ *
  * @param sourceFile - the original Svelte source file
  * @param modulePath - module path relative to source root; feeds
  *   `ModuleJson.path` and the component name, never `Diagnostic.file` (which

package/dist/svelte.d.ts.map

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

package/dist/svelte.js

@@ -34,15 +34,16 @@ import { getComponentName, isSvelte2tsxGeneratedExport, SVELTE_COMPONENT_ALIAS_S
 import { extractDependencies } from './source-config.js';
 import { compareStrings } from './postprocess.js';
 import {} from './diagnostics.js';
-import { to_error_message } from './error.js';
+import { toErrorMessage } from './error.js';
 import { toPosixPath } from './paths.js';
 /**
  * Pre-transform a Svelte source file via svelte2tsx.
  *
  * Produces a `SvelteVirtualFile` containing the transformed TypeScript content
  * and source map. The virtual file can be included in a TypeScript program
- * (via `createAnalysisProgram({ virtualFiles })`) so that the checker can
- * resolve imported types, `<script module>` exports, and re-exports.
+ * (via `createAnalysisProgram({ virtualFiles })`, or the language service's
+ * `setFile` in sessions) so that the checker can resolve imported types,
+ * `<script module>` exports, and re-exports.
  *
  * Errors at ingest are returned via `diagnostics` rather than thrown:
  * - svelte2tsx throws → `transform_failed`, `virtual: undefined`
@@ -85,7 +86,7 @@ export const transformSvelteSource = (sourceFile) => {
         diagnostics.push({
             kind: 'transform_failed',
             file: posixId,
-            message: `svelte2tsx failed to transform Svelte source: ${to_error_message(err)}`,
+            message: `svelte2tsx failed to transform Svelte source: ${toErrorMessage(err)}`,
             severity: 'error'
         });
         return { virtual: undefined, diagnostics };
@@ -99,7 +100,7 @@ export const transformSvelteSource = (sourceFile) => {
         diagnostics.push({
             kind: 'source_map_failed',
             file: posixId,
-            message: `Failed to parse svelte2tsx source map: ${to_error_message(err)}. Line/column positions for this file will reference virtual TypeScript output instead of the original Svelte source.`,
+            message: `Failed to parse svelte2tsx source map: ${toErrorMessage(err)}. Line/column positions for this file will reference virtual TypeScript output instead of the original Svelte source.`,
             severity: 'warning'
         });
     }
@@ -491,6 +492,9 @@ const extractComponentTsdoc = (nodes, sourceFile) => {
  * documented statement in a propless runes component or a legacy `export let`
  * component is some local's doc, not the component's). The HTML `@component`
  * comment is the authoring path for anchorless components.
+ *
+ * A JSDoc above the instance script's first import is missed: svelte2tsx
+ * hoists imports out of `$$render`, taking their leading comments with them.
  */
 const findInstanceTsdoc = (renderBody, sourceFile) => {
     const { statements } = renderBody;
@@ -521,6 +525,13 @@ const isPropsDeclaration = (statement) => ts.isVariableStatement(statement) &&
  * annotation (or the one svelte2tsx synthesizes for untyped `$props()`)
  * parses to an empty result and would otherwise claim the doc slot, masking
  * the HTML `@component` fallback.
+ *
+ * Two JS-component caveats: a description block written above a separate
+ * `/** @type {...} *\/` block never attaches (TypeScript binds only the last
+ * block — write docs in the HTML comment, or inside the `@type` block), and
+ * svelte2tsx consumes descriptions merged into an inline `@type {{...}}`
+ * literal when it rewrites it into a synthesized typedef (the HTML fallback
+ * still applies).
  */
 const findComponentTsdoc = (root, sourceFile) => {
     let foundTsdoc = undefined;
@@ -566,7 +577,7 @@ const findComponentTsdoc = (root, sourceFile) => {
  * assembling modules themselves through `analyzeModule` /
  * `analyzeSvelteModule`.
  *
- * @mutates diagnostics — rewrites `line`/`column` on virtual-file entries
+ * @mutates diagnostics - rewrites `line`/`column` on virtual-file entries
  */
 export const remapVirtualDiagnosticPositions = (diagnostics, virtualFiles) => {
     if (diagnostics.length === 0)
@@ -825,7 +836,7 @@ const detectChildrenSnippet = (propsType, propsTypeNode, ctx, componentName, dia
         ctx.diagnostics.push({
             kind: 'svelte_prop_failed',
             file: diagnosticFile,
-            message: `Failed to resolve type for "children" in ${componentName} while detecting acceptsChildren: ${to_error_message(err)}`,
+            message: `Failed to resolve type for "children" in ${componentName} while detecting acceptsChildren: ${toErrorMessage(err)}`,
             severity: 'warning',
             componentName,
             propName: 'children'
@@ -888,15 +899,18 @@ const extractPropsViaChecker = (virtualSource, ctx, componentName, diagnosticFil
     }
     const { type: propsType, node: propsTypeNode } = resolvedProps;
     // Detect `acceptsChildren` via type inference: `children` must resolve to a
-    // `Snippet<...>` type. Checking the symbol name alone (the previous approach)
-    // misreports a non-Snippet `children` (e.g. `children: string`) as accepting
-    // children. The lookup runs on the unfiltered props type so inherited
-    // `children` from `SvelteHTMLElements`/`DOMAttributes` (declared as `Snippet`)
-    // is honored even when its declaration lives in node_modules.
+    // `Snippet<...>` type. Checking the symbol name alone would misreport a
+    // non-Snippet `children` (e.g. `children: string`) as accepting children.
+    // The lookup runs on the unfiltered props type so inherited `children` from
+    // `SvelteHTMLElements`/`DOMAttributes` (declared as `Snippet`) is honored
+    // even when its declaration lives in node_modules.
     const acceptsChildren = detectChildrenSnippet(propsType, propsTypeNode, ctx, componentName, diagnosticFile);
     // Drop properties contributed by external types (node_modules / svelte's
     // element-attribute bags like `SvelteHTMLElements['li']`); those external
     // types are summarized in `externalTypes` rather than enumerated as props.
+    // No `hasExtractableProperties` gate here, unlike the type-alias path, so
+    // union prop types (`HTMLButtonAttributes | HTMLAnchorAttributes`) still get
+    // `externalTypes`.
     const { properties, externalTypes } = filterDocumentedProperties(propsType, propsTypeNode, checker, ctx.isExternalFile);
     // One pick rule for "which declaration represents this prop": the symbol's
     // declaration in the component's own file when one exists, else the usual
@@ -996,7 +1010,7 @@ const extractPropsViaChecker = (virtualSource, ctx, componentName, diagnosticFil
                 file: diagnosticFile,
                 line: finalLine,
                 column: finalColumn,
-                message: `Failed to resolve type for prop "${prop.name}" in ${componentName}, falling back to 'any': ${to_error_message(err)}`,
+                message: `Failed to resolve type for prop "${prop.name}" in ${componentName}, falling back to 'any': ${toErrorMessage(err)}`,
                 severity: 'warning',
                 componentName,
                 propName: prop.name
@@ -1010,11 +1024,27 @@ const extractPropsViaChecker = (virtualSource, ctx, componentName, diagnosticFil
  * Analyze a Svelte module using checker-backed analysis.
  *
  * Requires the svelte2tsx virtual output to be included in the TypeScript program
- * (via `createAnalysisProgram({ virtualFiles })`). Provides full type resolution for:
+ * (via `createAnalysisProgram({ virtualFiles })`, or the language service's
+ * `setFile` in sessions). Provides full type resolution for:
  * - Imported prop types (`let {x}: ImportedProps = $props()`)
  * - `<script module>` exports (constants, types, re-exports)
  * - Star exports and re-exports from Svelte files
  *
+ * Mirrors the numbered steps in the body:
+ *
+ * 1. `analyzeExports` on the virtual collects `<script module>` exports,
+ *    re-exports, and star exports
+ * 2. svelte2tsx internals are filtered (`isSvelte2tsxGeneratedExport`) and
+ *    exported snippets reclassified to `kind: 'snippet'` (`isSnippetReturnType`);
+ *    2b remaps module-level `sourceLine`s to the original `.svelte` source
+ * 3. the component declaration is synthesized: props via `extractPropsViaChecker`,
+ *    `acceptsChildren` from a `Snippet`-typed `children` prop or, failing that,
+ *    template use (`__sveltets_2_ensureSnippet`), plus generics, doc comment, and
+ *    source line from the landmarks `findComponentNodes` locates
+ * 4. the module comment is read from the original source
+ * 5. declarations combine, component first
+ * 6. dependencies are extracted
+ *
  * @param sourceFile - the original Svelte source file
  * @param modulePath - module path relative to source root; feeds
  *   `ModuleJson.path` and the component name, never `Diagnostic.file` (which
@@ -1275,7 +1305,10 @@ export const analyzeSvelteModule = (sourceFile, modulePath, checker, options, di
             severity: 'warning'
         });
     }
-    // 5. Combine: component declaration first (primary export), then <script module> exports
+    // 5. Combine: component declaration first (primary export), then <script module> exports;
+    // `@nodocs` is read from whichever doc source won (in-script JSDoc over the
+    // HTML `@component` comment), so an HTML `@nodocs` is ignored when in-script
+    // JSDoc supplies the doc
     const allDeclarations = [
         { declaration: componentDecl, nodocs: componentTsdoc?.tsdoc.nodocs === true },
         ...moduleDeclarations

package/dist/tsdoc.d.ts

@@ -22,11 +22,9 @@
  *
  * `@internal` is a marker, not an exclusion: it means "not stable public API"
  * and lands as `internalMessage` (with any trailing prose; empty string for a
- * bare tag) while the declaration stays documented. Use `@nodocs` to exclude
- * a declaration from output entirely.
- *
- * The `@nodocs` tag excludes exports from documentation and flat namespace validation.
- * The declaration is still exported and usable, just not documented.
+ * bare tag) while the declaration stays documented. `@nodocs` excludes a
+ * declaration from documentation and flat-namespace validation — it's still
+ * exported and usable, just not documented.
  *
  * Also supports `@mutates` (non-standard) for documenting mutations to parameters or external state.
  * Format: `@mutates target - description of mutation` — the target is everything before the
@@ -40,9 +38,7 @@
  *
  * ## 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.
+ * `@module` blocks are excluded from `parseComment` (see there).
  *
  * `JSDocPropertyLikeTag` nodes (`@property`/`@param` declaring a symbol in a
  * typedef or callback) parse to their own tag description — the only doc such

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEpF;;;;;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,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,qCAAqC;IACrC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AA+DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,YAAY,GACxB,MAAM,EAAE,CAAC,IAAI,EACb,aAAY,EAAE,CAAC,UAAiC,KAC9C,kBAAkB,GAAG,SAqIvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,2BAA2B,kBAAkB,KAAG,OAGrB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC9B,aAAa,oBAAoB,GAAG,eAAe,EACnD,OAAO,kBAAkB,GAAG,SAAS,EACrC,WAAU,OAAe,KACvB,IAwCF,CAAC;AAEF;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEpF;;;;;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,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,qCAAqC;IACrC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AA+DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,YAAY,GACxB,MAAM,EAAE,CAAC,IAAI,EACb,aAAY,EAAE,CAAC,UAAiC,KAC9C,kBAAkB,GAAG,SAqIvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,GAAI,2BAA2B,kBAAkB,KAAG,OAGrB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC9B,aAAa,oBAAoB,GAAG,eAAe,EACnD,OAAO,kBAAkB,GAAG,SAAS,EACrC,WAAU,OAAe,KACvB,IAwCF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GAAI,aAAa,MAAM,KAAG,MAAM,GAAG,SAW3D,CAAC"}

package/dist/tsdoc.js

@@ -22,11 +22,9 @@
  *
  * `@internal` is a marker, not an exclusion: it means "not stable public API"
  * and lands as `internalMessage` (with any trailing prose; empty string for a
- * bare tag) while the declaration stays documented. Use `@nodocs` to exclude
- * a declaration from output entirely.
- *
- * The `@nodocs` tag excludes exports from documentation and flat namespace validation.
- * The declaration is still exported and usable, just not documented.
+ * bare tag) while the declaration stays documented. `@nodocs` excludes a
+ * declaration from documentation and flat-namespace validation — it's still
+ * exported and usable, just not documented.
  *
  * Also supports `@mutates` (non-standard) for documenting mutations to parameters or external state.
  * Format: `@mutates target - description of mutation` — the target is everything before the
@@ -40,9 +38,7 @@
  *
  * ## 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.
+ * `@module` blocks are excluded from `parseComment` (see there).
  *
  * `JSDocPropertyLikeTag` nodes (`@property`/`@param` declaring a symbol in a
  * typedef or callback) parse to their own tag description — the only doc such