@fuzdev/fuz_ui 0.185.2 → 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/Mdz.svelte

@@ -3,18 +3,23 @@
 
 	import {mdz_parse} from './mdz.js';
 	import MdzNodeView from './MdzNodeView.svelte';
+	import {mdz_base_context} from './mdz_components.js';
 
 	const {
 		content,
 		inline = false,
 		nowrap = false,
+		base,
 		...rest
 	}: (SvelteHTMLElements['div'] | SvelteHTMLElements['span']) & {
 		content: string;
 		inline?: boolean;
 		nowrap?: boolean;
+		base?: string;
 	} = $props();
 
+	mdz_base_context.set(() => base);
+
 	const nodes = $derived(mdz_parse(content));
 </script>
 

package/dist/Mdz.svelte.d.ts

@@ -3,6 +3,7 @@ type $$ComponentProps = (SvelteHTMLElements['div'] | SvelteHTMLElements['span'])
     content: string;
     inline?: boolean;
     nowrap?: boolean;
+    base?: string;
 };
 declare const Mdz: import("svelte").Component<$$ComponentProps, {}, "">;
 type Mdz = ReturnType<typeof Mdz>;

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

@@ -1 +1 @@
-{"version":3,"file":"Mdz.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Mdz.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAKvD,KAAK,gBAAgB,GAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAyBH,QAAA,MAAM,GAAG,sDAAwC,CAAC;AAClD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;AAClC,eAAe,GAAG,CAAC"}
+{"version":3,"file":"Mdz.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Mdz.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAMvD,KAAK,gBAAgB,GAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AA6BH,QAAA,MAAM,GAAG,sDAAwC,CAAC;AAClD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;AAClC,eAAe,GAAG,CAAC"}

package/dist/MdzNodeView.svelte

@@ -2,10 +2,14 @@
 	import Code from '@fuzdev/fuz_code/Code.svelte';
 	import {resolve} from '$app/paths';
 
-	import type {MdzNode} from './mdz.js';
+	import {type MdzNode, resolve_relative_path} from './mdz.js';
 	import DocsLink from './DocsLink.svelte';
 	import MdzNodeView from './MdzNodeView.svelte';
-	import {mdz_components_context, mdz_elements_context} from './mdz_components.js';
+	import {
+		mdz_components_context,
+		mdz_elements_context,
+		mdz_base_context,
+	} from './mdz_components.js';
 
 	const {
 		node,
@@ -15,6 +19,7 @@
 
 	const components = mdz_components_context.get_maybe();
 	const elements = mdz_elements_context.get_maybe();
+	const get_mdz_base = mdz_base_context.get_maybe();
 	// TODO make `Code` customizable via context, maybe registered as component Codeblock?
 </script>
 
@@ -53,12 +58,18 @@
 {:else if node.type === 'Link'}
 	{@const {reference} = node}
 	{#if node.link_type === 'internal'}
-		{@const is_fragment_or_query_only = reference.startsWith('#') || reference.startsWith('?')}
-		<!-- Fragment/query-only links skip resolve() to avoid unwanted `/` prefix -->
-		<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-		<a href={is_fragment_or_query_only ? reference : resolve(reference as any)}
-			>{@render render_children(node.children)}</a
-		>
+		{@const skip_resolve = reference.startsWith('#') || reference.startsWith('?')}
+		{@const mdz_base = get_mdz_base?.()}
+		{#if reference.startsWith('.') && mdz_base}
+			{@const resolved = resolve_relative_path(reference, mdz_base)}
+			<a href={resolve(resolved as any)}>{@render render_children(node.children)}</a>
+		{:else if skip_resolve || reference.startsWith('.')}
+			<!-- Fragment, query, and relative links without base skip resolve() -->
+			<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+			<a href={reference}>{@render render_children(node.children)}</a>
+		{:else}
+			<a href={resolve(reference as any)}>{@render render_children(node.children)}</a>
+		{/if}
 	{:else}
 		<!-- external link -->
 		<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->

package/dist/MdzNodeView.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { MdzNode } from './mdz.js';
+import { type MdzNode } from './mdz.js';
 import MdzNodeView from './MdzNodeView.svelte';
 type $$ComponentProps = {
     node: MdzNode;

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

@@ -1 +1 @@
-{"version":3,"file":"MdzNodeView.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzNodeView.svelte"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,UAAU,CAAC;AAEtC,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAG9C,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,OAAO,CAAC;CACd,CAAC;AA2FH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"MdzNodeView.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/MdzNodeView.svelte"],"names":[],"mappings":"AAMA,OAAO,EAAC,KAAK,OAAO,EAAwB,MAAM,UAAU,CAAC;AAE7D,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAO9C,KAAK,gBAAgB,GAAI;IACxB,IAAI,EAAE,OAAO,CAAC;CACd,CAAC;AAoGH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

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/dist/mdz.d.ts

@@ -109,4 +109,17 @@ export declare class MdzParser {
     parse(): Array<MdzNode>;
 }
 export declare const mdz_is_url: (s: string) => boolean;
+/**
+ * Resolves a relative path (`./` or `../`) against a base path.
+ * The base is treated as a directory regardless of trailing slash
+ * (`'/docs/mdz'` and `'/docs/mdz/'` behave identically).
+ * Handles embedded `.` and `..` segments within the reference
+ * (e.g., `'./a/../b'` → navigates up then down).
+ * Clamps at root — excess `..` segments stop at `/` rather than escaping.
+ *
+ * @param reference A relative path starting with `./` or `../`.
+ * @param base An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ */
+export declare const resolve_relative_path: (reference: string, base: string) => string;
 //# sourceMappingURL=mdz.d.ts.map

package/dist/mdz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,OAAO,CAAgC,CAAC;AAEvF,MAAM,MAAM,OAAO,GAChB,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,cAAc,GACd,cAAc,GACd,gBAAgB,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACxD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;CACnC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC7C,IAAI,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AA+CD;;;;GAIG;AACH,qBAAa,SAAS;;gBAQT,QAAQ,EAAE,MAAM;IAI5B;;;;;;OAMG;IACH,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;CAslDvB;AAQD,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,OAA8B,CAAC"}
+{"version":3,"file":"mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz.ts"],"names":[],"mappings":"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"}