@fuzdev/fuz_ui 0.202.0 → 0.203.0

package/dist/library.svelte.d.ts

@@ -2,11 +2,38 @@ import type { LibraryJson } from '@fuzdev/fuz_util/library_json.js';
 import type { Url } from '@fuzdev/fuz_util/url.js';
 import { Declaration } from './declaration.svelte.js';
 import { Module } from './module.svelte.js';
+/**
+ * Holds a getter to the active `Library` for the current subtree.
+ *
+ * The getter form keeps consumers reactive when the library changes without
+ * requiring a remount — set it with a closure over reactive state, e.g.
+ * `library_context.set(() => library)`. Components that accept a `library`
+ * prop (`LibraryDetail`, `ApiIndex`, `ApiModule`) project the prop into this
+ * context for their subtree, so descendants like `ModuleLink`,
+ * `DeclarationLink`, and TSDoc-rendered `DocsLink` resolve against the same
+ * library — including when an aggregator renders a foreign library that
+ * differs from the site-level context.
+ */
 export declare const library_context: {
-    get: (error_message?: string) => Library;
-    get_maybe: () => Library | undefined;
-    set: (value: Library) => Library;
+    get: (error_message?: string) => () => Library;
+    get_maybe: () => (() => Library) | undefined;
+    set: (value: () => Library) => () => Library;
 };
+/**
+ * Sets `library_context` for the component's subtree to a getter that prefers
+ * the component's `library` prop and falls back to the ancestor's value,
+ * returning the resolved getter.
+ *
+ * Pass `get_library_prop` as a getter (not a snapshot) so prop changes remain
+ * reactive. The ancestor lookup happens once at component init, before the
+ * projection — the fallback sees the parent value, not the projection.
+ *
+ * @param get_library_prop - Getter for the component's `library` prop. A thunk so the prop stays reactive.
+ * @param component_name - Used in the error when neither the prop nor the context provides a library.
+ * @returns getter for the resolved library; read it lazily, e.g. `$derived(get_library())`
+ * @initializes
+ */
+export declare const set_library_context_with_fallback: (get_library_prop: () => Library | undefined, component_name: string) => (() => Library);
 /**
  * Normalizes a URL prefix: ensures leading `/`, strips trailing `/`, returns `''` for falsy and non-string values.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"library.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAGjD,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAW1C,eAAO,MAAM,eAAe;;;;CAA4B,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAGzD,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAiB;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,QAAQ,iDAAwC;IACzD,QAAQ,CAAC,WAAW,wDAA2C;IAI/D,QAAQ,CAAC,IAAI,SAAgC;IAC7C,QAAQ,CAAC,SAAS,SAAiD;IACnE,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAuD;IAC7E,QAAQ,CAAC,UAAU,gBAAkD;IACrE,QAAQ,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI,CAA4C;IAC7E,QAAQ,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAA6D;IAC1F,QAAQ,CAAC,QAAQ,SAAoE;IACrF,QAAQ,CAAC,SAAS,UAAiD;IACnE,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAgE;IAC5F,QAAQ,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAEhC;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,gBAA8E;IAE9F;;OAEG;IACH,QAAQ,CAAC,OAAO,WAId;IAEF;;OAEG;IACH,QAAQ,CAAC,cAAc,WAErB;IAEF;;OAEG;IACH,QAAQ,CAAC,YAAY,gBAAmE;IAExF;;OAEG;IACH,QAAQ,CAAC,cAAc,sBAA2D;IAElF;;OAEG;IACH,QAAQ,CAAC,mBAAmB,2BAAgE;gBAEhF,YAAY,EAAE,WAAW,EAAE,UAAU,SAAK;IAatD;;;OAGG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IAW5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;CAGtD"}
+{"version":3,"file":"library.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAGjD,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAW1C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe;2CAAwB,OAAO;4BAAP,OAAO;uBAAP,OAAO,WAAP,OAAO;CAAG,CAAC;AAE/D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iCAAiC,GAC7C,kBAAkB,MAAM,OAAO,GAAG,SAAS,EAC3C,gBAAgB,MAAM,KACpB,CAAC,MAAM,OAAO,CAWhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAGzD,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAiB;IAEnD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,QAAQ,iDAAwC;IACzD,QAAQ,CAAC,WAAW,wDAA2C;IAI/D,QAAQ,CAAC,IAAI,SAAgC;IAC7C,QAAQ,CAAC,SAAS,SAAiD;IACnE,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAuD;IAC7E,QAAQ,CAAC,UAAU,gBAAkD;IACrE,QAAQ,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI,CAA4C;IAC7E,QAAQ,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAA6D;IAC1F,QAAQ,CAAC,QAAQ,SAAoE;IACrF,QAAQ,CAAC,SAAS,UAAiD;IACnE,QAAQ,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAgE;IAC5F,QAAQ,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAEhC;IAEF;;OAEG;IACH,QAAQ,CAAC,OAAO,gBAA8E;IAE9F;;OAEG;IACH,QAAQ,CAAC,OAAO,WAId;IAEF;;OAEG;IACH,QAAQ,CAAC,cAAc,WAErB;IAEF;;OAEG;IACH,QAAQ,CAAC,YAAY,gBAAmE;IAExF;;OAEG;IACH,QAAQ,CAAC,cAAc,sBAA2D;IAElF;;OAEG;IACH,QAAQ,CAAC,mBAAmB,2BAAgE;gBAEhF,YAAY,EAAE,WAAW,EAAE,UAAU,SAAK;IAatD;;;OAGG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IAW5D;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;CAGtD"}

package/dist/library.svelte.js

@@ -3,7 +3,45 @@ import { create_context } from './context_helpers.js';
 import { Declaration } from './declaration.svelte.js';
 import { Module } from './module.svelte.js';
 import { package_is_published, repo_name_parse, repo_url_github_owner, repo_url_parse, url_github_file, url_logo, url_npm_package, } from '@fuzdev/fuz_util/package_helpers.js';
+/**
+ * Holds a getter to the active `Library` for the current subtree.
+ *
+ * The getter form keeps consumers reactive when the library changes without
+ * requiring a remount — set it with a closure over reactive state, e.g.
+ * `library_context.set(() => library)`. Components that accept a `library`
+ * prop (`LibraryDetail`, `ApiIndex`, `ApiModule`) project the prop into this
+ * context for their subtree, so descendants like `ModuleLink`,
+ * `DeclarationLink`, and TSDoc-rendered `DocsLink` resolve against the same
+ * library — including when an aggregator renders a foreign library that
+ * differs from the site-level context.
+ */
 export const library_context = create_context();
+/**
+ * Sets `library_context` for the component's subtree to a getter that prefers
+ * the component's `library` prop and falls back to the ancestor's value,
+ * returning the resolved getter.
+ *
+ * Pass `get_library_prop` as a getter (not a snapshot) so prop changes remain
+ * reactive. The ancestor lookup happens once at component init, before the
+ * projection — the fallback sees the parent value, not the projection.
+ *
+ * @param get_library_prop - Getter for the component's `library` prop. A thunk so the prop stays reactive.
+ * @param component_name - Used in the error when neither the prop nor the context provides a library.
+ * @returns getter for the resolved library; read it lazily, e.g. `$derived(get_library())`
+ * @initializes
+ */
+export const set_library_context_with_fallback = (get_library_prop, component_name) => {
+    const get_outer = library_context.get_maybe();
+    const get_library = () => {
+        const value = get_library_prop() ?? get_outer?.();
+        if (!value) {
+            throw Error(`${component_name} requires a \`library\` prop or a set \`library_context\``);
+        }
+        return value;
+    };
+    library_context.set(get_library);
+    return get_library;
+};
 /**
  * Normalizes a URL prefix: ensures leading `/`, strips trailing `/`, returns `''` for falsy and non-string values.
  */

package/dist/module.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { ModuleJsonInput } from 'svelte-docinfo/types.js';
+import type { ModuleJsonInput, ReExportJsonInput, ExternalReExportJsonInput } from 'svelte-docinfo/types.js';
 import { Declaration } from './declaration.svelte.js';
 import type { Library } from './library.svelte.js';
 /**
@@ -49,6 +49,10 @@ export declare class Module {
      * GitHub source URL.
      */
     url_github: string | undefined;
+    /**
+     * Whether the module has renderable declarations (after the default-export
+     * filter in `declarations`).
+     */
     has_declarations: boolean;
     has_module_comment: boolean;
     /**
@@ -61,6 +65,63 @@ export declare class Module {
     dependents: string[];
     has_dependencies: boolean;
     has_dependents: boolean;
+    /**
+     * Same-name re-export edges in this module's source (`ModuleJson.reExports`)
+     * — the forward view of declarations' `alsoExportedFrom`, sorted by name
+     * then module. Renamed re-exports appear as declarations with `aliasOf`
+     * instead, and star exports in `star_exports`.
+     */
+    re_exports: {
+        name: string;
+        module: string;
+        typeOnly?: boolean | undefined;
+        sourceLine?: number | undefined;
+    }[];
+    has_re_exports: boolean;
+    /**
+     * Modules fully re-exported via `export * from './module'`
+     * (`ModuleJson.starExports`), in source order. Star-projected symbols are
+     * not materialized as declarations or `re_exports` edges — this is their
+     * sole encoding.
+     */
+    star_exports: string[];
+    has_star_exports: boolean;
+    /**
+     * Re-export edges grouped by canonical module path, groups sorted by path.
+     * Entries within each group keep their name-sorted serialized order.
+     */
+    re_exports_by_module: Map<string, Array<ReExportJsonInput>>;
+    /**
+     * Re-exports whose immediate target is an external package
+     * (`ModuleJson.externalReExports`) — `export {x} from 'pkg'` and
+     * `export * as ns from 'pkg'` forms, sorted by name then specifier.
+     */
+    external_re_exports: {
+        name: string;
+        specifier: string;
+        originalName?: string | undefined;
+        typeOnly?: boolean | undefined;
+        sourceLine?: number | undefined;
+    }[];
+    has_external_re_exports: boolean;
+    /**
+     * External re-exports grouped by package specifier, groups sorted by
+     * specifier. Entries within each group keep their name-sorted serialized
+     * order.
+     */
+    external_re_exports_by_specifier: Map<string, Array<ExternalReExportJsonInput>>;
+    /**
+     * External packages fully re-exported via `export * from 'pkg'`
+     * (`ModuleJson.externalStarExports`), in source order. The projected
+     * names are unknown — the package isn't analyzed.
+     */
+    external_star_exports: string[];
+    has_external_star_exports: boolean;
+    /**
+     * Whether the module re-exports anything in any form — same-name edges,
+     * star exports, or the external variants of both.
+     */
+    has_any_re_exports: boolean;
     constructor(library: Library, module_json: ModuleJsonInput);
     /**
      * Look up a declaration by name within this module.

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

@@ -1 +1 @@
-{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAGjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;;;;OAKG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,UAAU,qBAIR;IAEF,gBAAgB,EAAE,OAAO,CAA8D;IAEvF,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;IAEzD,gBAAgB,EAAE,OAAO,CAA0C;IAEnE,cAAc,EAAE,OAAO,CAAwC;gBAEnD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}
+{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,eAAe,EACf,iBAAiB,EACjB,yBAAyB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAwBjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;;;;OAKG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,UAAU,qBAIR;IAEF;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAA0C;IAEnE,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;IAEzD,gBAAgB,EAAE,OAAO,CAA0C;IAEnE,cAAc,EAAE,OAAO,CAAwC;IAE/D;;;;;OAKG;IACH,UAAU;;;;;QAA8C;IAExD,cAAc,EAAE,OAAO,CAAwC;IAE/D;;;;;OAKG;IACH,YAAY,WAAgD;IAE5D,gBAAgB,EAAE,OAAO,CAA0C;IAEnE;;;OAGG;IACH,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAEzD;IAEF;;;;OAIG;IACH,mBAAmB;;;;;;QAAsD;IAEzE,uBAAuB,EAAE,OAAO,CAAiD;IAEjF;;;;OAIG;IACH,gCAAgC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAE7E;IAEF;;;;OAIG;IACH,qBAAqB,WAAwD;IAE7E,yBAAyB,EAAE,OAAO,CAAmD;IAErF;;;OAGG;IACH,kBAAkB,EAAE,OAAO,CAKzB;gBAEU,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}

package/dist/module.svelte.js

@@ -1,5 +1,22 @@
 import { Declaration } from './declaration.svelte.js';
 import { url_github_file } from '@fuzdev/fuz_util/package_helpers.js';
+/**
+ * Groups entries by a string key, with groups sorted by key. Entries within
+ * each group keep their input order.
+ */
+const group_sorted = (entries, get_key) => {
+    const by_key = new Map();
+    for (const entry of entries) {
+        const key = get_key(entry);
+        let group = by_key.get(key);
+        if (!group) {
+            group = [];
+            by_key.set(key, group);
+        }
+        group.push(entry);
+    }
+    return new Map([...by_key].sort(([a], [b]) => a.localeCompare(b)));
+};
 /**
  * Rich runtime representation of a module with computed properties.
  *
@@ -58,7 +75,11 @@ export class Module {
     url_github = $derived(this.library.repo_url
         ? url_github_file(this.library.repo_url, `src/lib/${this.path}`)
         : undefined);
-    has_declarations = $derived((this.module_json.declarations?.length ?? 0) > 0);
+    /**
+     * Whether the module has renderable declarations (after the default-export
+     * filter in `declarations`).
+     */
+    has_declarations = $derived(this.declarations.length > 0);
     has_module_comment = $derived(!!this.module_comment);
     /**
      * Modules this imports (paths relative to src/lib).
@@ -70,6 +91,55 @@ export class Module {
     dependents = $derived(this.module_json.dependents ?? []);
     has_dependencies = $derived(this.dependencies.length > 0);
     has_dependents = $derived(this.dependents.length > 0);
+    /**
+     * Same-name re-export edges in this module's source (`ModuleJson.reExports`)
+     * — the forward view of declarations' `alsoExportedFrom`, sorted by name
+     * then module. Renamed re-exports appear as declarations with `aliasOf`
+     * instead, and star exports in `star_exports`.
+     */
+    re_exports = $derived(this.module_json.reExports ?? []);
+    has_re_exports = $derived(this.re_exports.length > 0);
+    /**
+     * Modules fully re-exported via `export * from './module'`
+     * (`ModuleJson.starExports`), in source order. Star-projected symbols are
+     * not materialized as declarations or `re_exports` edges — this is their
+     * sole encoding.
+     */
+    star_exports = $derived(this.module_json.starExports ?? []);
+    has_star_exports = $derived(this.star_exports.length > 0);
+    /**
+     * Re-export edges grouped by canonical module path, groups sorted by path.
+     * Entries within each group keep their name-sorted serialized order.
+     */
+    re_exports_by_module = $derived(group_sorted(this.re_exports, (entry) => entry.module));
+    /**
+     * Re-exports whose immediate target is an external package
+     * (`ModuleJson.externalReExports`) — `export {x} from 'pkg'` and
+     * `export * as ns from 'pkg'` forms, sorted by name then specifier.
+     */
+    external_re_exports = $derived(this.module_json.externalReExports ?? []);
+    has_external_re_exports = $derived(this.external_re_exports.length > 0);
+    /**
+     * External re-exports grouped by package specifier, groups sorted by
+     * specifier. Entries within each group keep their name-sorted serialized
+     * order.
+     */
+    external_re_exports_by_specifier = $derived(group_sorted(this.external_re_exports, (entry) => entry.specifier));
+    /**
+     * External packages fully re-exported via `export * from 'pkg'`
+     * (`ModuleJson.externalStarExports`), in source order. The projected
+     * names are unknown — the package isn't analyzed.
+     */
+    external_star_exports = $derived(this.module_json.externalStarExports ?? []);
+    has_external_star_exports = $derived(this.external_star_exports.length > 0);
+    /**
+     * Whether the module re-exports anything in any form — same-name edges,
+     * star exports, or the external variants of both.
+     */
+    has_any_re_exports = $derived(this.has_re_exports ||
+        this.has_star_exports ||
+        this.has_external_re_exports ||
+        this.has_external_star_exports);
     constructor(library, module_json) {
         this.library = library;
         this.module_json = module_json;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.202.0",
+  "version": "0.203.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -105,7 +105,7 @@
     "prettier-plugin-svelte": "^3.5.1",
     "svelte": "^5.56.0",
     "svelte-check": "^4.4.8",
-    "svelte-docinfo": "^0.4.1",
+    "svelte-docinfo": "^0.5.1",
     "svelte2tsx": "^0.7.55",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",