@fuzdev/fuz_ui 0.186.0 → 0.187.0

package/dist/ApiModule.svelte

@@ -37,10 +37,15 @@
 	);
 
 	// find the module using the lookup helper
-	const module = $derived(library.lookup_module(module_path));
+	const module = $derived(library.module_by_path.get(module_path));
+
+	// check if this is a directory prefix containing child modules
+	const directory_modules = $derived(module ? null : library.lookup_directory_modules(module_path));
 
 	// fallback for 404
-	const module_name = $derived(module?.path || '[missing module]');
+	const module_name = $derived(
+		module?.path || (directory_modules ? module_path : '[missing module]'),
+	);
 
 	const search = $derived(create_module_declaration_search(module?.declarations ?? []));
 
@@ -57,7 +62,18 @@
 		<h1 class="mt_xl4">{module_name}</h1>
 	{/snippet}
 
-	{#if !module}
+	{#if !module && directory_modules}
+		<section>
+			<p>{directory_modules.length} module{directory_modules.length === 1 ? '' : 's'}</p>
+			<ul>
+				{#each directory_modules as child_module (child_module.path)}
+					<li>
+						<ModuleLink module_path={child_module.path} />
+					</li>
+				{/each}
+			</ul>
+		</section>
+	{:else if !module}
 		<section>
 			<p>Module not found: {module_path}</p>
 		</section>
@@ -67,7 +83,7 @@
 				<Mdz content={module.module_comment} />
 			</section>
 		{/if}
-		<!-- Declarations Section -->
+		<!-- Declarations section -->
 		<TomeSection>
 			<TomeSectionHeader text="Declarations" />
 
@@ -92,7 +108,7 @@
 			<ApiDeclarationList declarations={search.filtered} search_query={search.query} />
 		</TomeSection>
 
-		<!-- Depends on Section -->
+		<!-- Depends on section -->
 		{#if module.dependencies}
 			<TomeSection>
 				<TomeSectionHeader text="Depends on" />
@@ -106,7 +122,7 @@
 			</TomeSection>
 		{/if}
 
-		<!-- Imported by Section -->
+		<!-- Imported by section -->
 		{#if module.dependents}
 			<TomeSection>
 				<TomeSectionHeader text="Imported by" />

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

@@ -1 +1 @@
-{"version":3,"file":"ApiModule.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ApiModule.svelte"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAmB,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAUrD,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AA2GH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"ApiModule.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ApiModule.svelte"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAmB,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAUrD,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AA2HH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/DeclarationLink.svelte

@@ -20,7 +20,7 @@
 
 	const library = library_context.get();
 
-	const declaration = $derived(library.lookup_declaration(name));
+	const declaration = $derived(library.declaration_by_name.get(name));
 
 	const contextmenu_entries = $derived(
 		declaration ? create_declaration_contextmenu(declaration) : undefined,

package/dist/DocsLink.svelte

@@ -22,8 +22,8 @@
 	const library = library_context.get();
 
 	// Try to find as declaration first, then module
-	const declaration = $derived(library.lookup_declaration(reference));
-	const module = $derived(declaration ? declaration.module : library.lookup_module(reference));
+	const declaration = $derived(library.declaration_by_name.get(reference));
+	const module = $derived(declaration ? declaration.module : library.module_by_path.get(reference));
 </script>
 
 {#if declaration}

package/dist/DocsTertiaryNav.svelte

@@ -33,13 +33,13 @@
 
 	const modules_related_to_selected = $derived(
 		selected_tome?.related_modules
-			.map((path) => library.lookup_module(path))
+			.map((path) => library.module_by_path.get(path))
 			.filter((m) => m !== undefined) ?? [],
 	);
 
 	const declarations_related_to_selected = $derived(
 		selected_tome?.related_declarations
-			.map((name) => library.lookup_declaration(name))
+			.map((name) => library.declaration_by_name.get(name))
 			.filter((d) => d !== undefined) ?? [],
 	);
 

package/dist/ModuleLink.svelte

@@ -20,7 +20,7 @@
 
 	const library = library_context.get();
 
-	const module = $derived(library.lookup_module(module_path));
+	const module = $derived(library.module_by_path.get(module_path));
 
 	const color_class = $derived(module_path.endsWith('.svelte') ? 'color_h' : '');
 

package/dist/TypeLink.svelte

@@ -19,7 +19,7 @@
 	// TODO maybe better name?
 </script>
 
-{#if library.lookup_declaration(type)}
+{#if library.declaration_by_name.has(type)}
 	<DeclarationLink name={type} {hash} />
 {:else}
 	<Code lang="ts" content={type} inline />

package/dist/library.svelte.d.ts

@@ -22,7 +22,7 @@ export declare class Library {
      * Default `''` preserves single-package behavior.
      */
     readonly url_prefix: string;
-    package_json: {
+    readonly package_json: {
         [x: string]: unknown;
         name: string;
         version: string;
@@ -86,7 +86,7 @@ export declare class Library {
         main?: string | undefined;
         exports?: string | Record<string, unknown> | null | undefined;
     };
-    source_json: {
+    readonly source_json: {
         [x: string]: unknown;
         name: string;
         version: string;
@@ -162,49 +162,46 @@ export declare class Library {
             star_exports?: string[] | undefined;
         }[] | undefined;
     };
-    name: string;
-    repo_name: string;
-    repo_url: import("@fuzdev/fuz_util/url.js").Url;
-    owner_name: string | null;
-    homepage_url: import("@fuzdev/fuz_util/url.js").Url | null;
-    logo_url: import("@fuzdev/fuz_util/url.js").Url | null;
-    logo_alt: string;
-    npm_url: import("@fuzdev/fuz_util/url.js").Url | null;
-    changelog_url: import("@fuzdev/fuz_util/url.js").Url | null;
-    published: boolean;
+    readonly name: string;
+    readonly repo_name: string;
+    readonly repo_url: import("@fuzdev/fuz_util/url.js").Url;
+    readonly owner_name: string | null;
+    readonly homepage_url: import("@fuzdev/fuz_util/url.js").Url | null;
+    readonly logo_url: import("@fuzdev/fuz_util/url.js").Url | null;
+    readonly logo_alt: string;
+    readonly npm_url: import("@fuzdev/fuz_util/url.js").Url | null;
+    readonly changelog_url: import("@fuzdev/fuz_util/url.js").Url | null;
+    readonly published: boolean;
     /**
      * Organization URL (e.g., 'https://github.com/ryanatkn').
      */
-    org_url: string | null;
+    readonly org_url: string | null;
     /**
      * All modules as rich Module instances.
      */
-    modules: Module[];
+    readonly modules: Module[];
     /**
      * All modules sorted alphabetically by path.
      */
-    modules_sorted: Module[];
+    readonly modules_sorted: Module[];
     /**
      * All declarations across all modules as a flat array.
      */
-    declarations: Declaration[];
+    readonly declarations: Declaration[];
     /**
-     * Declaration lookup map by name. Provides O(1) lookup.
-     */
-    declaration_map: Map<string, Declaration>;
-    constructor(library_json: LibraryJson, url_prefix?: string);
-    /**
-     * Look up a declaration by name.
+     * Module lookup map by path. Provides O(1) lookup.
      */
-    lookup_declaration(name: string): Declaration | undefined;
+    readonly module_by_path: Map<string, Module>;
     /**
-     * Check if a declaration exists.
+     * Declaration lookup map by name. Provides O(1) lookup.
      */
-    has_declaration(name: string): boolean;
+    readonly declaration_by_name: Map<string, Declaration>;
+    constructor(library_json: LibraryJson, url_prefix?: string);
     /**
-     * Look up a module by its canonical path.
+     * Look up modules within a directory prefix.
+     * Returns modules whose paths start with `path + "/"`, or `null` if none match.
      */
-    lookup_module(path: string): Module | undefined;
+    lookup_directory_modules(path: string): Array<Module> | null;
     /**
      * Search declarations by query string with multi-term AND logic.
      */

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;AAIlE,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C;;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,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA4C;IACxD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA2C;IAEtD,IAAI,SAAoC;IACxC,SAAS,SAAyC;IAClD,QAAQ,wCAAwC;IAChD,UAAU,gBAA0C;IACpD,YAAY,+CAA4C;IACxD,QAAQ,+CAAwC;IAChD,QAAQ,SAAwC;IAChD,OAAO,+CAAuC;IAC9C,aAAa,+CAA6C;IAC1D,SAAS,UAAyC;IAElD;;OAEG;IACH,OAAO,gBAML;IAEF;;OAEG;IACH,OAAO,WAIL;IAEF;;OAEG;IACH,cAAc,WAA4E;IAE1F;;OAEG;IACH,YAAY,gBAAmE;IAE/E;;OAEG;IACH,eAAe,2BAAgE;gBAEnE,YAAY,EAAE,WAAW,EAAE,UAAU,SAAK;IAKtD;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIzD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;CAGtD;AAED,eAAO,MAAM,eAAe;;;;CAA4B,CAAC"}
+{"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;AAIlE,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAE1C;;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,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA4C;IACjE,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA2C;IAE/D,QAAQ,CAAC,IAAI,SAAoC;IACjD,QAAQ,CAAC,SAAS,SAAyC;IAC3D,QAAQ,CAAC,QAAQ,wCAAwC;IACzD,QAAQ,CAAC,UAAU,gBAA0C;IAC7D,QAAQ,CAAC,YAAY,+CAA4C;IACjE,QAAQ,CAAC,QAAQ,+CAAwC;IACzD,QAAQ,CAAC,QAAQ,SAAwC;IACzD,QAAQ,CAAC,OAAO,+CAAuC;IACvD,QAAQ,CAAC,aAAa,+CAA6C;IACnE,QAAQ,CAAC,SAAS,UAAyC;IAE3D;;OAEG;IACH,QAAQ,CAAC,OAAO,gBAMd;IAEF;;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;IAKtD;;;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;AAED,eAAO,MAAM,eAAe;;;;CAA4B,CAAC"}

package/dist/library.svelte.js

@@ -61,31 +61,31 @@ export class Library {
      * All declarations across all modules as a flat array.
      */
     declarations = $derived(this.modules.flatMap((module) => module.declarations));
+    /**
+     * Module lookup map by path. Provides O(1) lookup.
+     */
+    module_by_path = $derived(new Map(this.modules.map((m) => [m.path, m])));
     /**
      * Declaration lookup map by name. Provides O(1) lookup.
      */
-    declaration_map = $derived(new Map(this.declarations.map((d) => [d.name, d])));
+    declaration_by_name = $derived(new Map(this.declarations.map((d) => [d.name, d])));
     constructor(library_json, url_prefix = '') {
         this.library_json = library_json;
         this.url_prefix = parse_library_url_prefix(url_prefix);
     }
     /**
-     * Look up a declaration by name.
-     */
-    lookup_declaration(name) {
-        return this.declaration_map.get(name);
-    }
-    /**
-     * Check if a declaration exists.
+     * Look up modules within a directory prefix.
+     * Returns modules whose paths start with `path + "/"`, or `null` if none match.
      */
-    has_declaration(name) {
-        return this.declaration_map.has(name);
-    }
-    /**
-     * Look up a module by its canonical path.
-     */
-    lookup_module(path) {
-        return this.modules.find((m) => m.path === path);
+    lookup_directory_modules(path) {
+        const prefix = path + '/';
+        let result = null;
+        for (const m of this.modules_sorted) {
+            if (m.path.startsWith(prefix)) {
+                (result ??= []).push(m);
+            }
+        }
+        return result;
     }
     /**
      * Search declarations by query string with multi-term AND logic.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.186.0",
+  "version": "0.187.0",
   "description": "Svelte UI library",
   "motto": "friendly user zystem",
   "glyph": "🧶",
@@ -76,13 +76,13 @@
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.53.0",
-    "@fuzdev/fuz_util": "^0.52.0",
-    "@fuzdev/gro": "^0.195.0",
+    "@fuzdev/fuz_css": "^0.55.0",
+    "@fuzdev/fuz_util": "^0.53.4",
+    "@fuzdev/gro": "^0.197.0",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@ryanatkn/eslint-config": "^0.9.0",
+    "@ryanatkn/eslint-config": "^0.10.1",
     "@sveltejs/adapter-static": "^3.0.10",
-    "@sveltejs/kit": "^2.50.1",
+    "@sveltejs/kit": "^2.53.4",
     "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^6.2.4",
     "@types/estree": "^1.0.8",
@@ -95,8 +95,8 @@
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.4.1",
-    "svelte": "^5.49.1",
-    "svelte-check": "^4.3.6",
+    "svelte": "^5.53.7",
+    "svelte-check": "^4.4.5",
     "svelte2tsx": "^0.7.47",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",

package/src/lib/library.svelte.ts

@@ -32,24 +32,24 @@ export class Library {
 	 */
 	readonly url_prefix: string;
 
-	package_json = $derived(this.library_json.package_json);
-	source_json = $derived(this.library_json.source_json);
-
-	name = $derived(this.library_json.name);
-	repo_name = $derived(this.library_json.repo_name);
-	repo_url = $derived(this.library_json.repo_url);
-	owner_name = $derived(this.library_json.owner_name);
-	homepage_url = $derived(this.library_json.homepage_url);
-	logo_url = $derived(this.library_json.logo_url);
-	logo_alt = $derived(this.library_json.logo_alt);
-	npm_url = $derived(this.library_json.npm_url);
-	changelog_url = $derived(this.library_json.changelog_url);
-	published = $derived(this.library_json.published);
+	readonly package_json = $derived(this.library_json.package_json);
+	readonly source_json = $derived(this.library_json.source_json);
+
+	readonly name = $derived(this.library_json.name);
+	readonly repo_name = $derived(this.library_json.repo_name);
+	readonly repo_url = $derived(this.library_json.repo_url);
+	readonly owner_name = $derived(this.library_json.owner_name);
+	readonly homepage_url = $derived(this.library_json.homepage_url);
+	readonly logo_url = $derived(this.library_json.logo_url);
+	readonly logo_alt = $derived(this.library_json.logo_alt);
+	readonly npm_url = $derived(this.library_json.npm_url);
+	readonly changelog_url = $derived(this.library_json.changelog_url);
+	readonly published = $derived(this.library_json.published);
 
 	/**
 	 * Organization URL (e.g., 'https://github.com/ryanatkn').
 	 */
-	org_url = $derived(
+	readonly org_url = $derived(
 		this.repo_url && this.repo_name
 			? this.repo_url.endsWith('/' + this.repo_name)
 				? this.repo_url.slice(0, -this.repo_name.length - 1)
@@ -60,7 +60,7 @@ export class Library {
 	/**
 	 * All modules as rich Module instances.
 	 */
-	modules = $derived(
+	readonly modules = $derived(
 		this.source_json.modules
 			? this.source_json.modules.map((module_json) => new Module(this, module_json))
 			: [],
@@ -69,17 +69,24 @@ export class Library {
 	/**
 	 * All modules sorted alphabetically by path.
 	 */
-	modules_sorted = $derived([...this.modules].sort((a, b) => a.path.localeCompare(b.path)));
+	readonly modules_sorted = $derived(
+		[...this.modules].sort((a, b) => a.path.localeCompare(b.path)),
+	);
 
 	/**
 	 * All declarations across all modules as a flat array.
 	 */
-	declarations = $derived(this.modules.flatMap((module) => module.declarations));
+	readonly declarations = $derived(this.modules.flatMap((module) => module.declarations));
+
+	/**
+	 * Module lookup map by path. Provides O(1) lookup.
+	 */
+	readonly module_by_path = $derived(new Map(this.modules.map((m) => [m.path, m])));
 
 	/**
 	 * Declaration lookup map by name. Provides O(1) lookup.
 	 */
-	declaration_map = $derived(new Map(this.declarations.map((d) => [d.name, d])));
+	readonly declaration_by_name = $derived(new Map(this.declarations.map((d) => [d.name, d])));
 
 	constructor(library_json: LibraryJson, url_prefix = '') {
 		this.library_json = library_json;
@@ -87,24 +94,18 @@ export class Library {
 	}
 
 	/**
-	 * Look up a declaration by name.
-	 */
-	lookup_declaration(name: string): Declaration | undefined {
-		return this.declaration_map.get(name);
-	}
-
-	/**
-	 * Check if a declaration exists.
+	 * Look up modules within a directory prefix.
+	 * Returns modules whose paths start with `path + "/"`, or `null` if none match.
 	 */
-	has_declaration(name: string): boolean {
-		return this.declaration_map.has(name);
-	}
-
-	/**
-	 * Look up a module by its canonical path.
-	 */
-	lookup_module(path: string): Module | undefined {
-		return this.modules.find((m) => m.path === path);
+	lookup_directory_modules(path: string): Array<Module> | null {
+		const prefix = path + '/';
+		let result: Array<Module> | null = null;
+		for (const m of this.modules_sorted) {
+			if (m.path.startsWith(prefix)) {
+				(result ??= []).push(m);
+			}
+		}
+		return result;
 	}
 
 	/**