@fuzdev/fuz_ui 0.206.6 → 0.206.8

package/src/lib/module.svelte.ts

@@ -1,12 +1,13 @@
 import type {
 	ModuleJsonInput,
 	ReExportJsonInput,
-	ExternalReExportJsonInput,
+	ExternalReExportJsonInput
 } from 'svelte-docinfo/types.js';
+import { EMPTY_ARRAY } from '@fuzdev/fuz_util/array.ts';
 
-import {Declaration} from './declaration.svelte.ts';
-import type {Library} from './library.svelte.ts';
-import {url_github_file} from '@fuzdev/fuz_util/package_helpers.ts';
+import { Declaration } from './declaration.svelte.ts';
+import type { Library } from './library.svelte.ts';
+import { url_github_file } from '@fuzdev/fuz_util/package_helpers.ts';
 
 /**
  * Groups entries by a string key, with groups sorted by key. Entries within
@@ -14,7 +15,7 @@ import {url_github_file} from '@fuzdev/fuz_util/package_helpers.ts';
  */
 const group_sorted = <T>(
 	entries: Array<T>,
-	get_key: (entry: T) => string,
+	get_key: (entry: T) => string
 ): Map<string, Array<T>> => {
 	const by_key: Map<string, Array<T>> = new Map();
 	for (const entry of entries) {
@@ -32,8 +33,11 @@ const group_sorted = <T>(
 /**
  * Rich runtime representation of a module with computed properties.
  *
- * Wraps svelte-docinfo's `ModuleJson` with reactive derivations,
- * URL generation, and `Declaration` instances.
+ * Wraps svelte-docinfo's `ModuleJson` with computed properties, URL
+ * generation, and `Declaration` instances.
+ *
+ * Computed properties are plain getters rather than `$derived` — see
+ * `Library` for why.
  *
  * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
  * @see `declaration.svelte.ts` for the `Declaration` wrapper class
@@ -57,28 +61,38 @@ export class Module {
 	 * A leading `./` or a `.js` runtime extension will not match. Top-level
 	 * files match by bare filename; nested files require the full sub-path.
 	 */
-	path = $derived(this.module_json.path);
+	get path(): string {
+		return this.module_json.path;
+	}
 
 	/**
 	 * Import-style path with ./ prefix.
 	 */
-	path_import = $derived('./' + this.path);
+	get path_import(): string {
+		return './' + this.path;
+	}
 
-	module_comment = $derived(this.module_json.moduleComment);
+	get module_comment(): string | undefined {
+		return this.module_json.moduleComment;
+	}
+
+	#declarations: Array<Declaration> | undefined;
 
 	/**
 	 * Array of `Declaration` instances. Filters out default exports.
 	 */
-	declarations = $derived(
-		(this.module_json.declarations ?? [])
+	get declarations(): Array<Declaration> {
+		return (this.#declarations ??= (this.module_json.declarations ?? [])
 			.filter((declaration_json) => declaration_json.name !== 'default')
-			.map((declaration_json) => new Declaration(this, declaration_json)),
-	);
+			.map((declaration_json) => new Declaration(this, declaration_json)));
+	}
 
 	/**
 	 * API documentation URL for this module.
 	 */
-	url_api = $derived(`/docs/api${this.library.url_prefix}/${this.path}`);
+	get url_api(): string {
+		return `/docs/api${this.library.url_prefix}/${this.path}`;
+	}
 
 	/**
 	 * Public documentation link (if `homepage_url` is available).
@@ -86,42 +100,52 @@ export class Module {
 	 * Absolute URL into the library's own deployed docs, for rendering a
 	 * foreign library's modules on a different site (e.g. an aggregator).
 	 */
-	url_api_full = $derived(
-		this.library.homepage_url
-			? `${this.library.homepage_url.replace(/\/$/, '')}/docs/api/${this.path}`
-			: undefined,
-	);
+	get url_api_full(): string | undefined {
+		const { homepage_url } = this.library;
+		return homepage_url ? `${homepage_url.replace(/\/$/, '')}/docs/api/${this.path}` : undefined;
+	}
 
 	/**
 	 * GitHub source URL.
 	 */
-	url_github = $derived(
-		this.library.repo_url
-			? url_github_file(this.library.repo_url, `src/lib/${this.path}`)
-			: undefined,
-	);
+	get url_github(): string | undefined {
+		const { repo_url } = this.library;
+		return repo_url ? url_github_file(repo_url, `src/lib/${this.path}`) : undefined;
+	}
 
 	/**
 	 * Whether the module has renderable declarations (after the default-export
 	 * filter in `declarations`).
 	 */
-	has_declarations: boolean = $derived(this.declarations.length > 0);
+	get has_declarations(): boolean {
+		return this.declarations.length > 0;
+	}
 
-	has_module_comment: boolean = $derived(!!this.module_comment);
+	get has_module_comment(): boolean {
+		return !!this.module_comment;
+	}
 
 	/**
 	 * Modules this imports (paths relative to src/lib).
 	 */
-	dependencies = $derived(this.module_json.dependencies ?? []);
+	get dependencies(): NonNullable<ModuleJsonInput['dependencies']> {
+		return this.module_json.dependencies ?? EMPTY_ARRAY;
+	}
 
 	/**
 	 * Modules that import this (paths relative to src/lib).
 	 */
-	dependents = $derived(this.module_json.dependents ?? []);
+	get dependents(): NonNullable<ModuleJsonInput['dependents']> {
+		return this.module_json.dependents ?? EMPTY_ARRAY;
+	}
 
-	has_dependencies: boolean = $derived(this.dependencies.length > 0);
+	get has_dependencies(): boolean {
+		return this.dependencies.length > 0;
+	}
 
-	has_dependents: boolean = $derived(this.dependents.length > 0);
+	get has_dependents(): boolean {
+		return this.dependents.length > 0;
+	}
 
 	/**
 	 * Same-name re-export edges in this module's source (`ModuleJson.reExports`)
@@ -129,9 +153,13 @@ export class Module {
 	 * then module. Renamed re-exports appear as declarations with `aliasOf`
 	 * instead, and star exports in `star_exports`.
 	 */
-	re_exports = $derived(this.module_json.reExports ?? []);
+	get re_exports(): NonNullable<ModuleJsonInput['reExports']> {
+		return this.module_json.reExports ?? EMPTY_ARRAY;
+	}
 
-	has_re_exports: boolean = $derived(this.re_exports.length > 0);
+	get has_re_exports(): boolean {
+		return this.re_exports.length > 0;
+	}
 
 	/**
 	 * Modules fully re-exported via `export * from './module'`
@@ -139,55 +167,76 @@ export class Module {
 	 * not materialized as declarations or `re_exports` edges — this is their
 	 * sole encoding.
 	 */
-	star_exports = $derived(this.module_json.starExports ?? []);
+	get star_exports(): NonNullable<ModuleJsonInput['starExports']> {
+		return this.module_json.starExports ?? EMPTY_ARRAY;
+	}
 
-	has_star_exports: boolean = $derived(this.star_exports.length > 0);
+	get has_star_exports(): boolean {
+		return this.star_exports.length > 0;
+	}
+
+	#re_exports_by_module: Map<string, Array<ReExportJsonInput>> | undefined;
 
 	/**
 	 * 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>> = $derived(
-		group_sorted(this.re_exports, (entry) => entry.module),
-	);
+	get re_exports_by_module(): Map<string, Array<ReExportJsonInput>> {
+		return (this.#re_exports_by_module ??= 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 ?? []);
+	get external_re_exports(): NonNullable<ModuleJsonInput['externalReExports']> {
+		return this.module_json.externalReExports ?? EMPTY_ARRAY;
+	}
+
+	get has_external_re_exports(): boolean {
+		return this.external_re_exports.length > 0;
+	}
 
-	has_external_re_exports: boolean = $derived(this.external_re_exports.length > 0);
+	#external_re_exports_by_specifier: Map<string, Array<ExternalReExportJsonInput>> | undefined;
 
 	/**
 	 * 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>> = $derived(
-		group_sorted(this.external_re_exports, (entry) => entry.specifier),
-	);
+	get external_re_exports_by_specifier(): Map<string, Array<ExternalReExportJsonInput>> {
+		return (this.#external_re_exports_by_specifier ??= 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 ?? []);
+	get external_star_exports(): NonNullable<ModuleJsonInput['externalStarExports']> {
+		return this.module_json.externalStarExports ?? EMPTY_ARRAY;
+	}
 
-	has_external_star_exports: boolean = $derived(this.external_star_exports.length > 0);
+	get has_external_star_exports(): boolean {
+		return 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: boolean = $derived(
-		this.has_re_exports ||
+	get has_any_re_exports(): boolean {
+		return (
+			this.has_re_exports ||
 			this.has_star_exports ||
 			this.has_external_re_exports ||
-			this.has_external_star_exports,
-	);
+			this.has_external_star_exports
+		);
+	}
 
 	constructor(library: Library, module_json: ModuleJsonInput) {
 		this.library = library;

package/src/lib/module_contextmenu.ts

@@ -1,5 +1,5 @@
-import type {Module} from './module.svelte.ts';
-import type {ContextmenuParams} from './contextmenu_state.svelte.ts';
+import type { Module } from './module.svelte.ts';
+import type { ContextmenuParams } from './contextmenu_state.svelte.ts';
 
 // TODO @many expand contextmenus for docs
 
@@ -11,8 +11,8 @@ export const create_module_contextmenu = (module: Module): Array<ContextmenuPara
 		entries.push({
 			snippet: 'link',
 			props: {
-				href: module.url_github,
-			},
+				href: module.url_github
+			}
 		});
 	}
 

package/src/lib/site.svelte.ts

@@ -1,9 +1,9 @@
-import type {Url} from '@fuzdev/fuz_util/url.ts';
-import type {PkgJson} from '@fuzdev/fuz_util/pkg_json.ts';
+import type { Url } from '@fuzdev/fuz_util/url.ts';
+import type { PkgJson } from '@fuzdev/fuz_util/pkg_json.ts';
 
-import {create_context} from './context_helpers.ts';
-import {repo_url_parse} from '@fuzdev/fuz_util/package_helpers.ts';
-import type {SvgData} from './svg.ts';
+import { create_context } from './context_helpers.ts';
+import { repo_url_parse } from '@fuzdev/fuz_util/package_helpers.ts';
+import type { SvgData } from './svg.ts';
 
 export interface SiteStateOptions {
 	/**

package/src/lib/storage.ts

@@ -1,4 +1,4 @@
-import {BROWSER} from 'esm-env';
+import { BROWSER } from 'esm-env';
 
 // TODO more than just localStorage, maybe rework the module
 
@@ -26,7 +26,7 @@ export const save_to_storage = (key: string, value: any, is_json = false): void
 export const load_from_storage = <T>(
 	key: string,
 	is_json = false,
-	parse_fn?: (value: unknown) => T | null,
+	parse_fn?: (value: unknown) => T | null
 ): T | null => {
 	if (!BROWSER) return null;
 	try {

package/src/lib/style_variable_helpers.svelte.ts

@@ -1,6 +1,6 @@
-import type {StyleVariable} from '@fuzdev/fuz_css/variable.ts';
+import type { StyleVariable } from '@fuzdev/fuz_css/variable.ts';
 
-import {create_context} from './context_helpers.ts';
+import { create_context } from './context_helpers.ts';
 
 export const selected_variable_context = create_context(() => new SelectedStyleVariable(null));
 

package/src/lib/svg.ts

@@ -1,4 +1,4 @@
-import type {SvelteHTMLElements} from 'svelte/elements';
+import type { SvelteHTMLElements } from 'svelte/elements';
 
 /**
  * A structured icon definition rendered by `Svg.svelte`. Rendering is purely
@@ -11,7 +11,7 @@ export interface SvgData {
 	 * List of svg `path` attribute objects, spread onto each `path` element. The
 	 * `d` attribute is required; a per-path `fill` overrides the resolved `fill`.
 	 */
-	paths?: Array<{d: string} & SvelteHTMLElements['path']> | null;
+	paths?: Array<{ d: string } & SvelteHTMLElements['path']> | null;
 	/**
 	 * Inline `style` applied to the root `svg` element, merged with any `style`
 	 * passed as a component prop. Travels with the icon definition - per-instance

package/src/lib/theme_state.svelte.ts

@@ -1,9 +1,9 @@
-import {color_schemes, type ColorScheme, type Theme} from '@fuzdev/fuz_css/theme.ts';
-import {default_themes} from '@fuzdev/fuz_css/themes.ts';
-import {BROWSER} from 'esm-env';
+import { color_schemes, type ColorScheme, type Theme } from '@fuzdev/fuz_css/theme.ts';
+import { default_themes } from '@fuzdev/fuz_css/themes.ts';
+import { BROWSER } from 'esm-env';
 
-import {create_context} from './context_helpers.ts';
-import {load_from_storage, save_to_storage} from './storage.ts';
+import { create_context } from './context_helpers.ts';
+import { load_from_storage, save_to_storage } from './storage.ts';
 
 export interface ThemeStateJson {
 	theme: Theme;
@@ -29,7 +29,7 @@ export class ThemeState {
 	toJSON(): ThemeStateJson {
 		return {
 			theme: this.theme,
-			color_scheme: this.color_scheme,
+			color_scheme: this.color_scheme
 		};
 	}
 }
@@ -49,14 +49,14 @@ export const THEME_STORAGE_KEY = 'fuz:theme';
 
 export const save_color_scheme = (
 	color_scheme: ColorScheme | null,
-	key = COLOR_SCHEME_STORAGE_KEY,
+	key = COLOR_SCHEME_STORAGE_KEY
 ): void => {
 	save_to_storage(key, color_scheme);
 };
 
 export const load_color_scheme = (
 	fallback: ColorScheme = 'auto',
-	key = COLOR_SCHEME_STORAGE_KEY,
+	key = COLOR_SCHEME_STORAGE_KEY
 ): ColorScheme => load_from_storage(key, false, parse_color_scheme) ?? fallback;
 
 export const save_theme = (theme: Theme | null, key = THEME_STORAGE_KEY): void => {

package/src/lib/tome.ts

@@ -1,10 +1,10 @@
-import {resolve} from '$app/paths';
-import type {Component} from 'svelte';
-import {z} from 'zod';
-import {ensure_start} from '@fuzdev/fuz_util/string.ts';
+import { resolve } from '$app/paths';
+import type { Component } from 'svelte';
+import { z } from 'zod';
+import { ensure_start } from '@fuzdev/fuz_util/string.ts';
 
-import {create_context} from './context_helpers.ts';
-import {DOCS_PATH_DEFAULT} from './docs_helpers.svelte.ts';
+import { create_context } from './context_helpers.ts';
+import { DOCS_PATH_DEFAULT } from './docs_helpers.svelte.ts';
 
 export const tomes_context = create_context<() => Map<string, Tome>>();
 
@@ -29,7 +29,7 @@ export const Tome = z.object({
 	Component: z.custom<Component<any, any>>(),
 	related_tomes: z.array(z.string()),
 	related_modules: z.array(z.string()),
-	related_declarations: z.array(z.string()),
+	related_declarations: z.array(z.string())
 });
 export type Tome = z.infer<typeof Tome>;
 
@@ -39,7 +39,7 @@ export type Tome = z.infer<typeof Tome>;
 export const tome_to_pathname = (
 	item: Tome | string,
 	docs_path = DOCS_PATH_DEFAULT,
-	hash?: string,
+	hash?: string
 ): string => {
 	const slug = typeof item === 'string' ? item : item.slug;
 	const path = docs_path + '/' + slug;

package/src/lib/vite_plugin_pkg_json.ts

@@ -44,11 +44,11 @@
  * @module
  */
 
-import {readFileSync} from 'node:fs';
-import {join} from 'node:path';
-import type {Plugin, Rollup} from 'vite';
-import type {PackageJson} from '@fuzdev/fuz_util/package_json.ts';
-import {pkg_json_from_package_json, pkg_json_keys} from '@fuzdev/fuz_util/pkg_json.ts';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import type { Plugin, Rollup } from 'vite';
+import type { PackageJson } from '@fuzdev/fuz_util/package_json.ts';
+import { pkg_json_from_package_json, pkg_json_keys } from '@fuzdev/fuz_util/pkg_json.ts';
 
 const VIRTUAL_ID = 'virtual:pkg.json';
 /**
@@ -81,7 +81,7 @@ export interface VitePluginPkgJsonOptions {
  * the publish-safe field set defaults to `pkg_json_keys`; widen it via `keys`.
  */
 export const vite_plugin_pkg_json = (options: VitePluginPkgJsonOptions = {}): Plugin => {
-	const {keys = pkg_json_keys} = options;
+	const { keys = pkg_json_keys } = options;
 	let root = '';
 	let is_dev = false;
 	/** Curated JSON cached for build; left `null` in dev so `load` re-reads. */
@@ -106,7 +106,7 @@ export const vite_plugin_pkg_json = (options: VitePluginPkgJsonOptions = {}): Pl
 			return ctx.error(
 				`vite_plugin_pkg_json: failed to read or parse ${package_json_path}: ${
 					(err as Error).message
-				}`,
+				}`
 			);
 		}
 		if (raw.name === undefined) {
@@ -139,6 +139,6 @@ export const vite_plugin_pkg_json = (options: VitePluginPkgJsonOptions = {}): Pl
 		load(id) {
 			if (id !== RESOLVED_VIRTUAL_ID) return undefined;
 			return cached ?? read_curated(this);
-		},
+		}
 	};
 };