@fuzdev/fuz_ui 0.194.0 → 0.195.1

package/dist/declaration.svelte.d.ts

@@ -1,18 +1,26 @@
-import { type DeclarationJson } from '@fuzdev/fuz_util/source_json.js';
+import type { DeclarationJsonInput } from 'svelte-docinfo/types.js';
 import type { Module } from './module.svelte.js';
 /**
  * Rich runtime representation of an exported declaration.
+ *
+ * Wraps svelte-docinfo's `DeclarationJson` discriminated union (on `kind`)
+ * with Svelte 5 reactive derivations and computed URLs.
+ * Kind-specific fields are accessed via the `field()` helper since
+ * not all fields exist on all variants.
+ *
+ * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
+ * @see `DeclarationDetail.svelte` for the rendering component
  */
 export declare class Declaration {
     readonly module: Module;
-    readonly declaration_json: DeclarationJson;
+    readonly declaration_json: DeclarationJsonInput;
     library: import("./library.svelte.ts").Library;
     /**
      * Module path where this declaration is defined.
      */
     module_path: string;
     name: string;
-    kind: "function" | "class" | "type" | "json" | "variable" | "constructor" | "component" | "css";
+    kind: "function" | "class" | "type" | "variable" | "component" | "interface" | "enum" | "snippet" | "namespace";
     /**
      * GitHub source URL with line number.
      */
@@ -37,57 +45,257 @@ export declare class Declaration {
     doc_comment: string | undefined;
     deprecated_message: string | undefined;
     parameters: {
-        [x: string]: unknown;
         name: string;
         type: string;
         optional?: boolean | undefined;
+        rest?: boolean | undefined;
         description?: string | undefined;
-        default_value?: string | undefined;
+        defaultValue?: string | undefined;
     }[] | undefined;
     props: {
-        [x: string]: unknown;
         name: string;
         type: string;
-        optional?: boolean | undefined;
-        description?: string | undefined;
-        default_value?: string | undefined;
-        bindable?: boolean | undefined;
         examples?: string[] | undefined;
-        deprecated_message?: string | undefined;
-        see_also?: string[] | undefined;
+        deprecatedMessage?: string | undefined;
+        seeAlso?: string[] | undefined;
         throws?: {
-            [x: string]: unknown;
             description: string;
             type?: string | undefined;
         }[] | undefined;
         since?: string | undefined;
+        optional?: boolean | undefined;
+        description?: string | undefined;
+        defaultValue?: string | undefined;
+        bindable?: boolean | undefined;
+        parameters?: {
+            name: string;
+            type: string;
+            optional?: boolean | undefined;
+            rest?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: string | undefined;
+        }[] | undefined;
     }[] | undefined;
     return_type: string | undefined;
     return_description: string | undefined;
     generic_params: {
-        [x: string]: unknown;
         name: string;
         constraint?: string | undefined;
-        default_type?: string | undefined;
-    }[] | undefined;
-    extends: string[] | undefined;
-    implements: string[] | undefined;
+        defaultType?: string | undefined;
+    }[];
+    extends_type: string | string[] | undefined;
+    implements_types: string[] | undefined;
     throws: {
-        [x: string]: unknown;
         description: string;
         type?: string | undefined;
-    }[] | undefined;
+    }[];
     since: string | undefined;
-    examples: string[] | undefined;
-    see_also: string[] | undefined;
-    members: Array<DeclarationJson> | undefined;
-    properties: Array<DeclarationJson> | undefined;
+    examples: string[];
+    see_also: string[];
+    /**
+     * Nested members for classes, interfaces, types, and enums.
+     */
+    members: ({
+        kind: "function";
+        name: string;
+        optional?: boolean | undefined;
+        returnType?: string | undefined;
+        returnDescription?: string | undefined;
+        parameters?: {
+            name: string;
+            type: string;
+            optional?: boolean | undefined;
+            rest?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: string | undefined;
+        }[] | undefined;
+        overloads?: {
+            typeSignature: string;
+            parameters?: {
+                name: string;
+                type: string;
+                optional?: boolean | undefined;
+                rest?: boolean | undefined;
+                description?: string | undefined;
+                defaultValue?: string | undefined;
+            }[] | undefined;
+            returnType?: string | undefined;
+            genericParams?: {
+                name: string;
+                constraint?: string | undefined;
+                defaultType?: string | undefined;
+            }[] | undefined;
+            docComment?: string | undefined;
+            returnDescription?: string | undefined;
+        }[] | undefined;
+        mutates?: Record<string, string> | undefined;
+        partial?: boolean | undefined;
+        examples?: string[] | undefined;
+        deprecatedMessage?: string | undefined;
+        seeAlso?: string[] | undefined;
+        throws?: {
+            description: string;
+            type?: string | undefined;
+        }[] | undefined;
+        since?: string | undefined;
+        docComment?: string | undefined;
+        typeSignature?: string | undefined;
+        modifiers?: ("public" | "protected" | "readonly" | "static" | "abstract" | "getter" | "setter")[] | undefined;
+        sourceLine?: number | undefined;
+        genericParams?: {
+            name: string;
+            constraint?: string | undefined;
+            defaultType?: string | undefined;
+        }[] | undefined;
+    } | {
+        kind: "variable";
+        name: string;
+        optional?: boolean | undefined;
+        reactivity?: "$state" | "$state.raw" | "$derived" | "$derived.by" | undefined;
+        defaultValue?: string | undefined;
+        mutates?: Record<string, string> | undefined;
+        partial?: boolean | undefined;
+        examples?: string[] | undefined;
+        deprecatedMessage?: string | undefined;
+        seeAlso?: string[] | undefined;
+        throws?: {
+            description: string;
+            type?: string | undefined;
+        }[] | undefined;
+        since?: string | undefined;
+        docComment?: string | undefined;
+        typeSignature?: string | undefined;
+        modifiers?: ("public" | "protected" | "readonly" | "static" | "abstract" | "getter" | "setter")[] | undefined;
+        sourceLine?: number | undefined;
+        genericParams?: {
+            name: string;
+            constraint?: string | undefined;
+            defaultType?: string | undefined;
+        }[] | undefined;
+    } | {
+        kind: "constructor";
+        name: "constructor" | "(construct)";
+        parameters?: {
+            name: string;
+            type: string;
+            optional?: boolean | undefined;
+            rest?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: string | undefined;
+        }[] | undefined;
+        overloads?: {
+            typeSignature: string;
+            parameters?: {
+                name: string;
+                type: string;
+                optional?: boolean | undefined;
+                rest?: boolean | undefined;
+                description?: string | undefined;
+                defaultValue?: string | undefined;
+            }[] | undefined;
+            returnType?: string | undefined;
+            genericParams?: {
+                name: string;
+                constraint?: string | undefined;
+                defaultType?: string | undefined;
+            }[] | undefined;
+            docComment?: string | undefined;
+            returnDescription?: string | undefined;
+        }[] | undefined;
+        mutates?: Record<string, string> | undefined;
+        partial?: boolean | undefined;
+        examples?: string[] | undefined;
+        deprecatedMessage?: string | undefined;
+        seeAlso?: string[] | undefined;
+        throws?: {
+            description: string;
+            type?: string | undefined;
+        }[] | undefined;
+        since?: string | undefined;
+        docComment?: string | undefined;
+        typeSignature?: string | undefined;
+        modifiers?: ("public" | "protected" | "readonly" | "static" | "abstract" | "getter" | "setter")[] | undefined;
+        sourceLine?: number | undefined;
+        genericParams?: {
+            name: string;
+            constraint?: string | undefined;
+            defaultType?: string | undefined;
+        }[] | undefined;
+    })[] | undefined;
+    /**
+     * Intersection types whose properties are external (filtered out of props/members).
+     * Present on `component` and `type` kinds.
+     */
+    intersects: string[] | undefined;
+    /**
+     * Whether a component accepts children via props or template usage.
+     * Present on `component` kind only.
+     */
+    accepts_children: boolean | undefined;
+    /**
+     * Function overload signatures when multiple public overloads exist.
+     * Present on `function` and `snippet` kinds, and on function/constructor members.
+     */
+    overloads: {
+        typeSignature: string;
+        parameters?: {
+            name: string;
+            type: string;
+            optional?: boolean | undefined;
+            rest?: boolean | undefined;
+            description?: string | undefined;
+            defaultValue?: string | undefined;
+        }[] | undefined;
+        returnType?: string | undefined;
+        genericParams?: {
+            name: string;
+            constraint?: string | undefined;
+            defaultType?: string | undefined;
+        }[] | undefined;
+        docComment?: string | undefined;
+        returnDescription?: string | undefined;
+    }[] | undefined;
+    /**
+     * Re-export alias info when this declaration is a renamed re-export.
+     */
+    alias_of: {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | {
+        module: string;
+        name: string;
+    } | undefined;
+    /**
+     * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
+     */
+    mutates: Record<string, string> | undefined;
     has_examples: boolean;
     is_deprecated: boolean;
     has_documentation: boolean;
     has_parameters: boolean;
     has_props: boolean;
     has_generics: boolean;
-    constructor(module: Module, declaration_json: DeclarationJson);
+    constructor(module: Module, declaration_json: DeclarationJsonInput);
 }
 //# sourceMappingURL=declaration.svelte.d.ts.map

package/dist/declaration.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,eAAe,EAGpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAK/C;;GAEG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,CAAiB;IAE3D,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4FAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAMd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,YAAY,SAAiE;IAE7E,cAAc,qBAAkD;IAChE,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,UAAU;;;;;;;oBAA8C;IACxD,KAAK;;;;;;;;;;;;;;;;;oBAAyC;IAC9C,WAAW,qBAA+C;IAC1D,kBAAkB,qBAAsD;IACxE,cAAc;;;;;oBAAkD;IAChE,OAAO,uBAA2C;IAClD,UAAU,uBAA8C;IACxD,MAAM;;;;oBAA0C;IAChD,KAAK,qBAAyC;IAC9C,QAAQ,uBAA4C;IACpD,QAAQ,uBAA4C;IACpD,OAAO,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAEzC;IACF,UAAU,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,SAAS,CAE5C;IAEF,YAAY,UAA2D;IACvE,aAAa,UAAuC;IACpD,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAAuE;gBAEvE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe;CAI7D"}
+{"version":3,"file":"declaration.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/declaration.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,oBAAoB,EAKpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAa/C;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAiB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAiB;IAEhE,OAAO,wCAAiC;IAExC;;OAEG;IACH,WAAW,SAA8B;IAEzC,IAAI,SAAwC;IAC5C,IAAI,4GAAwC;IAE5C;;OAEG;IACH,UAAU,qBAQR;IAEF;;OAEG;IACH,OAAO,SAAoF;IAE3F;;OAEG;IACH,gBAAgB,SAQd;IAEF;;OAEG;IACH,YAAY,qBAIV;IAEF;;OAEG;IAGH,YAAY,SAKV;IAEF,cAAc,qBAAiD;IAC/D,WAAW,qBAA8C;IACzD,kBAAkB,qBAAqD;IACvE,UAAU;;;;;;;oBAAmF;IAC7F,KAAK;;;;;;;;;;;;;;;;;;;;;;;oBAAkF;IACvF,WAAW,qBAAgE;IAC3E,kBAAkB,qBAAuE;IACzF,cAAc;;;;QAAuD;IACrE,YAAY,gCAA6E;IACzF,gBAAgB,uBAAuE;IACvF,MAAM;;;QAAgD;IACtD,KAAK,qBAAyC;IAC9C,QAAQ,WAAkD;IAC1D,QAAQ,WAAiD;IACzD;;OAEG;IACH,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAA6E;IAEpF;;;OAGG;IACH,UAAU,uBAAuE;IAEjF;;;OAGG;IACH,gBAAgB,sBAAsE;IAEtF;;;OAGG;IACH,SAAS;;;;;;;;;;;;;;;;;;oBAAiF;IAE1F;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA2C;IAEnD;;OAEG;IACH,OAAO,qCAA2C;IAElD,YAAY,UAAsC;IAClD,aAAa,UAAuC;IACpD,iBAAiB,UAAgC;IACjD,cAAc,UAA+D;IAC7E,SAAS,UAAqD;IAC9D,YAAY,UAA4C;gBAE5C,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,oBAAoB;CAIlE"}

package/dist/declaration.svelte.js

@@ -1,8 +1,23 @@
-import { declaration_generate_import, declaration_get_display_name, } from '@fuzdev/fuz_util/source_json.js';
+import { generateImport, getDisplayName } from 'svelte-docinfo/declaration-helpers.js';
 import { url_github_file } from './package_helpers.js';
-/* eslint-disable @typescript-eslint/no-deprecated */
+// `library.json` is serialized with svelte-docinfo's `compactReplacer`, which
+// strips empty default arrays — so the on-disk data is the `*Input` shape
+// (defaulted arrays optional), not the parsed `*Json` shape. Typing it as
+// input makes TypeScript force a guard on every defaulted-array read.
+//
+// Helper to access kind-specific fields on the discriminated union.
+// At runtime the field is present or undefined; TypeScript needs the cast.
+const field = (decl, key) => decl[key];
 /**
  * Rich runtime representation of an exported declaration.
+ *
+ * Wraps svelte-docinfo's `DeclarationJson` discriminated union (on `kind`)
+ * with Svelte 5 reactive derivations and computed URLs.
+ * Kind-specific fields are accessed via the `field()` helper since
+ * not all fields exist on all variants.
+ *
+ * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
+ * @see `DeclarationDetail.svelte` for the rendering component
  */
 export class Declaration {
     module = $state.raw();
@@ -17,8 +32,8 @@ export class Declaration {
     /**
      * GitHub source URL with line number.
      */
-    url_github = $derived(this.library.repo_url && this.declaration_json.source_line
-        ? url_github_file(this.library.repo_url, `src/lib/${this.module_path}`, this.declaration_json.source_line)
+    url_github = $derived(this.library.repo_url && this.declaration_json.sourceLine
+        ? url_github_file(this.library.repo_url, `src/lib/${this.module_path}`, this.declaration_json.sourceLine)
         : undefined);
     /**
      * API documentation URL.
@@ -27,7 +42,10 @@ export class Declaration {
     /**
      * Generated TypeScript import statement.
      */
-    import_statement = $derived(declaration_generate_import(this.declaration_json, this.module_path, this.library.package_json.name));
+    import_statement = $derived(
+    // `generateImport` reads only `name`/`kind`/path, none of the defaulted
+    // arrays, so asserting the parsed shape here is sound.
+    generateImport(this.declaration_json, this.module_path, this.library.package_json.name));
     /**
      * Public documentation link (if homepage_url is available).
      */
@@ -37,29 +55,59 @@ export class Declaration {
     /**
      * Display name with generic parameters.
      */
-    display_name = $derived(declaration_get_display_name(this.declaration_json));
-    type_signature = $derived(this.declaration_json.type_signature);
-    doc_comment = $derived(this.declaration_json.doc_comment);
-    deprecated_message = $derived(this.declaration_json.deprecated_message);
-    parameters = $derived(this.declaration_json.parameters);
-    props = $derived(this.declaration_json.props);
-    return_type = $derived(this.declaration_json.return_type);
-    return_description = $derived(this.declaration_json.return_description);
-    generic_params = $derived(this.declaration_json.generic_params);
-    extends = $derived(this.declaration_json.extends);
-    implements = $derived(this.declaration_json.implements);
-    throws = $derived(this.declaration_json.throws);
+    // `getDisplayName` reads `genericParams` unguarded, so feed it the defaulted
+    // value rather than the raw (possibly-absent) input field.
+    display_name = $derived(getDisplayName({
+        ...this.declaration_json,
+        genericParams: this.declaration_json.genericParams ?? [],
+    }));
+    type_signature = $derived(this.declaration_json.typeSignature);
+    doc_comment = $derived(this.declaration_json.docComment);
+    deprecated_message = $derived(this.declaration_json.deprecatedMessage);
+    parameters = $derived(field(this.declaration_json, 'parameters'));
+    props = $derived(field(this.declaration_json, 'props'));
+    return_type = $derived(field(this.declaration_json, 'returnType'));
+    return_description = $derived(field(this.declaration_json, 'returnDescription'));
+    generic_params = $derived(this.declaration_json.genericParams ?? []);
+    extends_type = $derived(field(this.declaration_json, 'extends'));
+    implements_types = $derived(field(this.declaration_json, 'implements'));
+    throws = $derived(this.declaration_json.throws ?? []);
     since = $derived(this.declaration_json.since);
-    examples = $derived(this.declaration_json.examples);
-    see_also = $derived(this.declaration_json.see_also);
-    members = $derived(this.declaration_json.members);
-    properties = $derived(this.declaration_json.properties);
-    has_examples = $derived(!!(this.examples && this.examples.length > 0));
+    examples = $derived(this.declaration_json.examples ?? []);
+    see_also = $derived(this.declaration_json.seeAlso ?? []);
+    /**
+     * Nested members for classes, interfaces, types, and enums.
+     */
+    members = $derived(field(this.declaration_json, 'members'));
+    /**
+     * Intersection types whose properties are external (filtered out of props/members).
+     * Present on `component` and `type` kinds.
+     */
+    intersects = $derived(field(this.declaration_json, 'intersects'));
+    /**
+     * Whether a component accepts children via props or template usage.
+     * Present on `component` kind only.
+     */
+    accepts_children = $derived(field(this.declaration_json, 'acceptsChildren'));
+    /**
+     * Function overload signatures when multiple public overloads exist.
+     * Present on `function` and `snippet` kinds, and on function/constructor members.
+     */
+    overloads = $derived(field(this.declaration_json, 'overloads'));
+    /**
+     * Re-export alias info when this declaration is a renamed re-export.
+     */
+    alias_of = $derived(this.declaration_json.aliasOf);
+    /**
+     * Mutation documentation from `@mutates` tags, mapping parameter names to descriptions.
+     */
+    mutates = $derived(this.declaration_json.mutates);
+    has_examples = $derived(this.examples.length > 0);
     is_deprecated = $derived(!!this.deprecated_message);
     has_documentation = $derived(!!this.doc_comment);
     has_parameters = $derived(!!(this.parameters && this.parameters.length > 0));
     has_props = $derived(!!(this.props && this.props.length > 0));
-    has_generics = $derived(!!(this.generic_params && this.generic_params.length > 0));
+    has_generics = $derived(this.generic_params.length > 0);
     constructor(module, declaration_json) {
         this.module = module;
         this.declaration_json = declaration_json;

package/dist/library.svelte.js

@@ -52,7 +52,7 @@ export class Library {
      * All modules as rich `Module` instances.
      */
     modules = $derived(this.source_json.modules
-        ? this.source_json.modules.map((module_json) => new Module(this, module_json))
+        ? this.source_json.modules.map((module_json) => new Module(this, module_json)) // TODO: remove cast when fuz_util SourceJson uses svelte-docinfo types
         : []);
     /**
      * All modules sorted alphabetically by path.

package/dist/library_gen.d.ts

@@ -1,22 +1,21 @@
 /**
  * Gro-specific library metadata generation.
  *
- * This module provides Gro integration for library generation. It wraps the generic
- * `library_generate` function with Gro's `Gen` interface and provides adapters for
- * converting Gro's `Disknode` to the build-tool agnostic `SourceFileInfo`.
+ * This module provides Gro integration for library generation. It uses svelte-docinfo's
+ * pure analysis (`analyze`) and wraps the results with fuz_ui's opinionated
+ * LibraryJson format (GitHub/npm metadata).
  *
- * For build-tool agnostic usage, see `library_generate.ts`.
+ * For build-tool agnostic usage, see `svelte-docinfo`.
  *
- * @see `library_generate.ts` for the generic generation entry point
- * @see `library_pipeline.ts` for pipeline helpers
- * @see `library_output.ts` for output file generation
+ * @see svelte-docinfo/analyze.js for the generic analysis entry point
+ * @see svelte-docinfo/postprocess.js for post-processing helpers
+ * @see library_output.js for output file generation
  *
  * @module
  */
 import type { Gen } from '@fuzdev/gro';
 import type { Disknode } from '@fuzdev/gro/disknode.js';
-import { type SourceFileInfo, type ModuleSourceOptions, type ModuleSourcePartial } from './module_helpers.js';
-import { type OnDuplicatesCallback } from './library_generate.js';
+import { type ModuleSourceOptions, type OnDuplicatesCallback, type SourceFileInfo, type SourceOptionsDefaults } from 'svelte-docinfo';
 /** Options for Gro library generation. */
 export interface LibraryGenOptions {
     /**
@@ -26,17 +25,17 @@ export interface LibraryGenOptions {
      * merged with defaults. The `project_root` is automatically set to
      * `process.cwd()` if not provided.
      */
-    source?: ModuleSourceOptions | Partial<ModuleSourcePartial>;
+    source?: ModuleSourceOptions | Partial<SourceOptionsDefaults>;
     /**
      * Callback invoked when duplicate declaration names are found.
      *
      * Consumers decide how to handle duplicates: throw, warn, or ignore.
-     * Use `library_throw_on_duplicates` for strict flat namespace enforcement.
+     * Use `throwOnDuplicates` for strict flat namespace enforcement.
      *
      * @example
      * ```ts
      * // Throw on duplicates (strict flat namespace)
-     * library_gen({ on_duplicates: library_throw_on_duplicates });
+     * library_gen({ on_duplicates: throwOnDuplicates });
      *
      * // Warn but continue
      * library_gen({
@@ -53,7 +52,13 @@ export interface LibraryGenOptions {
 /**
  * Convert Gro's `Disknode` to the build-tool agnostic `SourceFileInfo` interface.
  *
- * Use this when you want to analyze files using Gro's filer directly.
+ * Use this when you want to analyze files using Gro's filer directly. The
+ * `dependencies` field is populated from the filer's forward-edge graph — the
+ * svelte-docinfo session honors it as pre-resolved input and skips its own
+ * lex+resolve pass for these files, avoiding duplicate work the filer already did.
+ *
+ * Reverse edges (`dependents`) are not threaded through — svelte-docinfo
+ * computes them internally from the forward edges of the owned set.
  *
  * @throws Error if disknode has no content (should be loaded by Gro filer)
  */
@@ -62,7 +67,7 @@ export declare const source_file_from_disknode: (disknode: Disknode) => SourceFi
  * Collect source files from Gro disknodes, filtering BEFORE conversion to `SourceFileInfo`.
  *
  * This avoids errors from files outside source directories (like test fixtures that may
- * have malformed paths or missing content). The filtering uses `module_is_source` which
+ * have malformed paths or missing content). The filtering uses `isSource` which
  * checks `source_paths` to only include files in configured source directories.
  *
  * @param disknodes - iterator of Gro disknodes from filer
@@ -78,10 +83,12 @@ export declare const library_collect_source_files_from_disknodes: (disknodes: It
  *
  * This is the Gro-specific entry point. It handles:
  * - Reading files from Gro's filer
- * - Loading `package.json` via Gro utilities
- * - Returning output in Gro's `Gen` format
+ * - Loading package.json via Gro utilities
+ * - Analyzing source with svelte-docinfo (pure analysis)
+ * - Wrapping with LibraryJson (GitHub/npm metadata)
+ * - Returning output in Gro's Gen format
  *
- * For build-tool agnostic usage, use `library_generate` directly.
+ * For build-tool agnostic usage, use `analyze` directly.
  *
  * Usage in a `.gen.ts` file:
  *

package/dist/library_gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_gen.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAKxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAmB,KAAK,oBAAoB,EAAC,MAAM,uBAAuB,CAAC;AAElF,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,QAAQ,KAAG,cAY9D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2CAA2C,GACvD,WAAW,QAAQ,CAAC,QAAQ,CAAC,EAC7B,SAAS,mBAAmB,EAC5B,MAAM;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CAAC,KACtF,KAAK,CAAC,cAAc,CA6BtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,GA2CzD,CAAC"}
+{"version":3,"file":"library_gen.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAGN,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,MAAM,gBAAgB,CAAC;AAMxB,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC9D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,QAAQ,KAAG,cAW9D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2CAA2C,GACvD,WAAW,QAAQ,CAAC,QAAQ,CAAC,EAC7B,SAAS,mBAAmB,EAC5B,MAAM;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CAAC,KACtF,KAAK,CAAC,cAAc,CA+BtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,GAwDzD,CAAC"}