svelte-docinfo 0.7.0 → 0.8.0

package/dist/typescript-program.js

@@ -5,8 +5,8 @@
  * plumbing, `.svelte` module resolution):
  *
  * - `createAnalysisProgram` — one-shot `ts.Program` from a `ts.CompilerHost`.
- *   Lower-level escape hatch for power users + dependency resolution. Does not
- *   support incremental updates.
+ *   Lower-level escape hatch for power users. Does not support incremental
+ *   updates.
  * - `createAnalysisLanguageService` — persistent `ts.LanguageService` with
  *   versioned `IScriptSnapshot`s. Incremental: subsequent `getProgram()` calls
  *   reuse parsed ASTs and checker state for unchanged files. Used by
@@ -23,6 +23,7 @@ import ts from 'typescript';
 import { SVELTE_VIRTUAL_SUFFIX } from './source.js';
 import { getSourceRoot } from './source-config.js';
 import { toPosixPath } from './paths.js';
+import { compareStrings } from './postprocess.js';
 /** Create an empty `OwnedDirIndex`. @internal */
 export const createOwnedDirIndex = () => {
     const paths = new Set();
@@ -129,7 +130,10 @@ export const applyVirtualFiles = (host, virtualFiles) => {
  * resolution via `ts.resolveModuleName`) without the cost of building a full
  * `ts.Program`.
  *
- * @throws Error if tsconfig.json (or the requested `tsconfigName`) is not found.
+ * Each call globs the tsconfig `include` to build `rootFileNames`; reuse the
+ * result rather than calling per resolve.
+ *
+ * @throws Error if tsconfig.json (or the file named by `options.tsconfig`) is not found.
  */
 export const loadTsconfig = (options, log) => {
     const projectRoot = options?.projectRoot ?? process.cwd();
@@ -302,11 +306,16 @@ export const createAnalysisLanguageService = (options, log) => {
         getCompilationSettings: () => compilerOptions,
         getScriptFileNames: () => {
             // Combine tsconfig roots with owned virtual roots. Set semantics
-            // dedupe when an owned file was also a tsconfig root.
+            // dedupe when an owned file was also a tsconfig root. Owned roots
+            // are sorted rather than kept in ingest order: root order sets the
+            // program's file order, and with it the merge order of
+            // `declare global`, module augmentations, and interface merging.
+            // The LS compares root lists by content, so a stable sort keeps
+            // program reuse intact.
             if (ownedRoots.size === 0)
                 return [...tsconfigRoots];
             const combined = new Set(tsconfigRoots);
-            for (const path of ownedRoots)
+            for (const path of [...ownedRoots].sort(compareStrings))
                 combined.add(path);
             return [...combined];
         },
@@ -371,6 +380,15 @@ export const createAnalysisLanguageService = (options, log) => {
     };
     return { getProgram, getCompilerOptions, setFile, deleteFile, hasFile, dispose };
 };
+/** The project/source prefixes both externality predicates compare against. */
+const externalityPrefixes = (options) => {
+    const projectPrefix = options.projectRoot + '/';
+    const effectiveRoot = getSourceRoot(options);
+    return {
+        projectPrefix,
+        sourcePrefix: effectiveRoot ? projectPrefix + effectiveRoot + '/' : projectPrefix
+    };
+};
 /**
  * Create an `IsExternalFile` predicate from `ModuleSourceOptions`.
  *
@@ -381,15 +399,6 @@ export const createAnalysisLanguageService = (options, log) => {
  *   declarations like `.svelte-kit/non-ambient.d.ts` while keeping user `.d.ts` files
  *   in the source tree)
  */
-/** The project/source prefixes both externality predicates compare against. */
-const externalityPrefixes = (options) => {
-    const projectPrefix = options.projectRoot + '/';
-    const effectiveRoot = getSourceRoot(options);
-    return {
-        projectPrefix,
-        sourcePrefix: effectiveRoot ? projectPrefix + effectiveRoot + '/' : projectPrefix
-    };
-};
 export const createIsExternalFile = (options) => {
     const { projectPrefix, sourcePrefix } = externalityPrefixes(options);
     return (sf) => !sf.fileName.startsWith(projectPrefix) ||

package/dist/vite.d.ts

@@ -6,9 +6,8 @@
  * `setFiles` + one `query` per debounce window — multi-file editor saves
  * collapse to a single re-analysis instead of N serialized round-trips.
  *
- * The plugin no longer maintains a `fileCache.content` mirror — `setFile`
- * returns `{changed: boolean}` so HMR invalidation reacts to that flag
- * directly. `session.list()` / `session.has()` cover owned-set introspection.
+ * HMR invalidation keys on `setFiles`'s `changedIds`; the watcher gates on
+ * `isSource(file) || session.has(file)`.
  *
  * Consumers import the analysis result:
  *
@@ -49,40 +48,18 @@ export interface VitePluginSvelteDocinfoOptions {
      */
     projectRoot?: string;
     /**
-     * Glob patterns to include (relative to `projectRoot`; an absolute pattern
-     * inside the root relativizes, an out-of-root one throws — see
-     * `normalizeIncludePatterns`).
-     *
-     * When provided under the default `discovery: 'auto'`, collapses the chain
-     * to glob (exports discovery is skipped). Combining `include` with
-     * `discovery: 'exports'` throws at config-resolve time — `exports` mode
-     * has no concept of include patterns.
-     *
-     * Explicit patterns also widen the source scope: their static bases join
-     * `sourceOptions.sourcePaths` (see `widenSourcePathsForInclude`), so
-     * include-discovered files outside the configured source paths still emit
-     * modules — and the watcher tracks their changes. A pattern with no static
-     * base (`'**\/*.ts'`, a literal root file) scopes the whole project root
-     * as source and logs an info line; an out-of-root base throws.
-     *
-     * When omitted, the glob fallback derives an include from
-     * `sourceOptions.sourcePaths` via `deriveIncludePatterns`, so custom
-     * `sourcePaths` survive the fallback instead of silently defaulting to
-     * `src/lib`.
+     * Glob patterns to include, relative to `projectRoot`. Collapses
+     * `discovery: 'auto'` to glob (combining with `'exports'` throws at
+     * config-resolve time), and each pattern's static base widens
+     * `sourceOptions.sourcePaths` so the matched files emit modules and the
+     * watcher tracks them (see `createSourceOptionsWithInclude`).
      */
     include?: Array<string>;
     /**
-     * Glob patterns to exclude, applied at both discovery and analysis time.
-     *
-     * Takes precedence over `sourceOptions.exclude` (no merge between the
-     * two). An array **replaces** the default patterns wholesale — the test,
-     * spec, and `internal/` filters are dropped unless re-included — while the
-     * callback form extends them without restating them
-     * (`(defaults) => [...defaults, '**\/*.gen.ts']` — see `ExcludeOption`).
-     * The callback always receives the built-in defaults, even when
-     * `sourceOptions.exclude` is also set (that value is superseded whole).
-     * The always-on baseline (`node_modules` + dot-directories below a matched
-     * source path) applies beneath it and is unaffected by overrides.
+     * Glob patterns to exclude, applied at both discovery and analysis time —
+     * supersedes `sourceOptions.exclude` whole (no merge; the callback form
+     * still receives the built-in defaults). An array replaces the defaults, a
+     * callback extends them — see `ExcludeOption`.
      */
     exclude?: ExcludeOption;
     /**
@@ -98,7 +75,7 @@ export interface VitePluginSvelteDocinfoOptions {
      * Discovery strategy for source files.
      *
      * @default 'auto'
-     * @see {@link Discovery}
+     * @see `Discovery`
      */
     discovery?: Discovery;
     /**

package/dist/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,OAAO,KAAK,EAAwB,MAAM,EAAiB,MAAM,MAAM,CAAC;AAGxE,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKrE,OAAO,EAGN,KAAK,aAAa,EAElB,KAAK,sBAAsB,EAC3B,MAAM,oBAAoB,CAAC;AAU5B,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC9C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,aAAa,GAAI,UAAS,8BAAmC,KAAG,MAwYrE,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,KAAK,EAAwB,MAAM,EAAiB,MAAM,MAAM,CAAC;AAGxE,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKrE,OAAO,EAGN,KAAK,aAAa,EAElB,KAAK,sBAAsB,EAC3B,MAAM,oBAAoB,CAAC;AAU5B,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC9C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,QAAA,MAAM,aAAa,GAAI,UAAS,8BAAmC,KAAG,MA0YrE,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/vite.js

@@ -6,9 +6,8 @@
  * `setFiles` + one `query` per debounce window — multi-file editor saves
  * collapse to a single re-analysis instead of N serialized round-trips.
  *
- * The plugin no longer maintains a `fileCache.content` mirror — `setFile`
- * returns `{changed: boolean}` so HMR invalidation reacts to that flag
- * directly. `session.list()` / `session.has()` cover owned-set introspection.
+ * HMR invalidation keys on `setFiles`'s `changedIds`; the watcher gates on
+ * `isSource(file) || session.has(file)`.
  *
  * Consumers import the analysis result:
  *
@@ -186,8 +185,10 @@ const svelteDocinfo = (options = {}) => {
     // session's context closure — e.g. `internal/` modules public files
     // import), whose edits change public output through the checker even
     // though they emit no module themselves. A context file created *after*
-    // its importer's last ingest becomes owned on that importer's next
-    // change (the closure re-walks); until then its events are dropped.
+    // its importer's last ingest becomes owned on that importer's next change
+    // (the dev resolver doesn't cache misses; see
+    // `AnalysisSessionOptions.contextClosure`); until then its events are
+    // dropped.
     const isWatchedFile = (file) => isSource(file, resolvedSourceOptions) || (session?.has(file) ?? false);
     // Initial analysis (cold start in buildStart)
     const runInitialAnalysis = async () => {
@@ -292,7 +293,7 @@ const svelteDocinfo = (options = {}) => {
             // as `analyzeFromFiles`).
             const mergedSourceOptions = exclude !== undefined ? { ...sourceOptions, exclude } : sourceOptions;
             // Explicit include patterns widen the source scope (same as
-            // `analyzeFromFiles`) — also fixes the watcher, whose `isWatchedFile`
+            // `analyzeFromFiles`), which the watcher needs too: its `isWatchedFile`
             // gate reads `sourcePaths` and would otherwise ignore changes to
             // include-discovered files outside them.
             resolvedSourceOptions = createSourceOptionsWithInclude(projectRoot, mergedSourceOptions, include, logger);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-docinfo",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "static analysis for TypeScript and Svelte",
   "glyph": "📜",
   "logo": "logo.svg",
@@ -50,14 +50,14 @@
     "zod": "^4"
   },
   "devDependencies": {
-    "@fuzdev/blake3_wasm": "^0.1.1",
-    "@fuzdev/fuz_code": "^0.47.0",
-    "@fuzdev/fuz_css": "^0.63.2",
-    "@fuzdev/fuz_ui": "^0.206.6",
-    "@fuzdev/fuz_util": "^0.65.2",
-    "@fuzdev/gro": "^0.205.1",
+    "@fuzdev/blake3-wasm": "^0.2.0",
+    "@fuzdev/fuz_code": "^0.50.0",
+    "@fuzdev/fuz_css": "^0.65.1",
+    "@fuzdev/fuz_ui": "^0.210.1",
+    "@fuzdev/fuz_util": "^0.69.0",
+    "@fuzdev/gro": "^0.213.0",
     "@fuzdev/mdz": "^0.3.0",
-    "@ryanatkn/eslint-config": "^0.12.1",
+    "@ryanatkn/eslint-config": "^0.12.2",
     "@sveltejs/acorn-typescript": "^1.0.9",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.69.2",
@@ -71,8 +71,6 @@
     "eslint-plugin-svelte": "^3.19.0",
     "esm-env": "^1.2.2",
     "magic-string": "^0.30.21",
-    "prettier": "^3.9.6",
-    "prettier-plugin-svelte": "^4.1.1",
     "svelte": "^5.56.4",
     "svelte-check": "^4.7.2",
     "svelte2tsx": "^0.7.55",
@@ -80,28 +78,10 @@
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",
     "vite": "^7.3.6",
-    "vitest": "^4.0.15",
+    "vitest": "^5.0.0",
     "zimmerframe": "^1.1.4",
     "zod": "^4.3.6"
   },
-  "prettier": {
-    "plugins": [
-      "prettier-plugin-svelte"
-    ],
-    "useTabs": true,
-    "printWidth": 100,
-    "singleQuote": true,
-    "bracketSpacing": true,
-    "trailingComma": "none",
-    "overrides": [
-      {
-        "files": "package.json",
-        "options": {
-          "useTabs": false
-        }
-      }
-    ]
-  },
   "sideEffects": [],
   "files": [
     "dist",

package/virtual-svelte-docinfo.d.ts

@@ -28,13 +28,15 @@
  *
  * ## Why this file lives at the package root, not `src/lib/`
  *
- * `svelte.config.js` aliases `'svelte-docinfo' → 'src/lib'` (load-bearing
- * for fuz_ui's `library_gen`, a circular dev-dep). `@sveltejs/package`
- * applies that alias to every file under `src/lib/`, including hand-written
- * `.d.ts`, rewriting the `'svelte-docinfo'` import below to a relative
- * path. TypeScript doesn't resolve relative imports inside ambient
- * `declare module` blocks in consumer projects — types silently collapse
- * to `any`.
+ * `svelte.config.js` aliases `'svelte-docinfo' → 'src/lib'` — load-bearing for
+ * the site build, where dependencies (fuz_ui, gro) import `svelte-docinfo` at
+ * runtime and the package isn't installed in its own `node_modules`, so only
+ * the alias resolves those imports (package self-reference doesn't apply to
+ * imports from inside another package). `@sveltejs/package` applies that
+ * alias to every file under `src/lib/`, including hand-written `.d.ts`,
+ * rewriting the `'svelte-docinfo'` import below to a relative path.
+ * TypeScript doesn't resolve relative imports inside ambient `declare module`
+ * blocks in consumer projects — types silently collapse to `any`.
  *
  * Living at the root keeps the file out of `svelte-package`'s reach;
  * `gro.config.ts` and `package.json` `files` re-register it for npm.