@fuzdev/fuz_ui 0.196.0 → 0.198.0

package/README.md

@@ -55,8 +55,8 @@ import '@fuzdev/fuz_css/style.css';
 // and import a fuz_css theme:
 import '@fuzdev/fuz_css/theme.css'; // or bring your own
 
-// using Gro generates fuz_css' utility classes stylesheet by default:
-import '$routes/fuz.css';
+// the fuz_css Vite plugin exposes the generated utility classes as a virtual module:
+import 'virtual:fuz.css';
 
 // then import Fuz Svelte components:
 import ThemeRoot from '@fuzdev/fuz_ui/ThemeRoot.svelte';

package/dist/Breadcrumb.svelte

@@ -6,6 +6,9 @@
 	import {strip_start, ensure_end} from '@fuzdev/fuz_util/string.js';
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
+	import Svg from './Svg.svelte';
+	import {site_context} from './site.svelte.js';
+
 	const {
 		path,
 		selected_path,
@@ -29,9 +32,17 @@
 		 */
 		base_path?: string;
 		separator?: Snippet;
+		/**
+		 * Content of the root link. Defaults to the `site_context` icon rendered as
+		 * an `Svg`, then the `site_context` glyph, then `•`.
+		 */
 		children?: Snippet;
 	} = $props();
 
+	const site = site_context.get_maybe();
+	const icon_data = $derived(site?.icon ?? null);
+	const glyph_text = $derived(site?.glyph ?? null);
+
 	const final_base_path = $derived(base_path ?? resolve('/').slice(0, -1));
 
 	const final_path = $derived(path ?? strip_start(page.url.pathname, final_base_path));
@@ -51,7 +62,10 @@
 <div {...rest} class="breadcrumb {rest.class}">
 	<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
 	<a href={root_path} class:selected={root_path === final_base_path + final_selected_path}
-		>{#if children}{@render children()}{:else}•{/if}</a
+		>{#if children}{@render children()}{:else if icon_data}<Svg
+				data={icon_data}
+				size="1em"
+			/>{:else if glyph_text}{glyph_text}{:else}•{/if}</a
 	>{#each path_pieces as path_piece (path_piece)}{#if path_piece.type === 'piece'}<!-- eslint-disable-next-line svelte/no-navigation-without-resolve --><a
 				href={final_base_path + path_piece.path}
 				class:selected={path_piece.path === final_selected_path}>{path_piece.name}</a

package/dist/Breadcrumb.svelte.d.ts

@@ -16,6 +16,10 @@ type $$ComponentProps = SvelteHTMLElements['div'] & {
      */
     base_path?: string;
     separator?: Snippet;
+    /**
+     * Content of the root link. Defaults to the `site_context` icon rendered as
+     * an `Svg`, then the `site_context` glyph, then `•`.
+     */
     children?: Snippet;
 };
 declare const Breadcrumb: import("svelte").Component<$$ComponentProps, {}, "">;

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

@@ -1 +1 @@
-{"version":3,"file":"Breadcrumb.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Breadcrumb.svelte"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA2CH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"Breadcrumb.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Breadcrumb.svelte"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAKvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAkDH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/Contextmenu.svelte

@@ -4,8 +4,10 @@
 
 	import {contextmenu_attachment} from './contextmenu_state.svelte.js';
 
+	/* eslint-disable @typescript-eslint/no-unnecessary-type-assertion */
+
 	const {
-		tag = 'span' as T, // TODO why is casting needed?
+		tag = 'span' as any, // TODO why is casting needed?
 		entries,
 		children,
 		...rest

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

@@ -1 +1 @@
-{"version":3,"file":"Contextmenu.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Contextmenu.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAGxD,iBAAS,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;;cAOnC,CAAC;iBACE,OAAO;kBACN,OAAO;;;;;;EAkBsG;AACzH,cAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC7C,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACpZ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACnJ,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,WAAW,EAAE,qBAAmC,CAAC;AACrC,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"Contextmenu.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Contextmenu.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAGxD,iBAAS,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;;cAOnC,CAAC;iBACE,OAAO;kBACN,OAAO;;;;;;EAoBsG;AACzH,cAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC7C,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClD,KAAK,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,QAAQ;IACR,OAAO;CACV;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;KAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACpZ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACnJ,YAAY,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CACjE;AACD,QAAA,MAAM,WAAW,EAAE,qBAAmC,CAAC;AACrC,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,eAAe,WAAW,CAAC"}

package/dist/DeclarationLink.svelte

@@ -9,6 +9,7 @@
 	const {
 		name,
 		hash,
+		full = false,
 		children,
 		class: class_prop = 'chip',
 		...rest
@@ -16,17 +17,25 @@
 		name: string;
 		/** URL fragment to append, with or without the `#`. */
 		hash?: string;
+		/**
+		 * Link to the library's own deployed docs (`url_api_full`) instead of a
+		 * site-local path (`url_api`). Use when rendering a foreign library on a
+		 * different site, e.g. an aggregator, so links don't dangle locally.
+		 */
+		full?: boolean;
 	} = $props();
 
 	const library = library_context.get();
 
 	const declaration = $derived(library.declaration_by_name.get(name));
 
+	// When linking a foreign library's docs, prefer its full URL; fall back to
+	// the site-local path if `homepage_url` is unavailable.
+	const url_api = $derived((full && declaration?.url_api_full) || declaration?.url_api);
+
 	const contextmenu_entries = $derived(
 		declaration ? create_declaration_contextmenu(declaration) : undefined,
 	);
-
-	// TODO @many support full https:// url variants - automatic detection? library prop?
 </script>
 
 {#if declaration}
@@ -35,7 +44,7 @@
 	<a
 		{...rest}
 		class="declaration-link {class_prop}"
-		href={declaration.url_api + (hash ? ensure_start(hash, '#') : '')}
+		href={url_api + (hash ? ensure_start(hash, '#') : '')}
 		{@attach contextmenu_attachment(contextmenu_entries)}
 	>
 		{#if children}

package/dist/DeclarationLink.svelte.d.ts

@@ -3,6 +3,12 @@ type $$ComponentProps = SvelteHTMLElements['a'] & {
     name: string;
     /** URL fragment to append, with or without the `#`. */
     hash?: string;
+    /**
+     * Link to the library's own deployed docs (`url_api_full`) instead of a
+     * site-local path (`url_api`). Use when rendering a foreign library on a
+     * different site, e.g. an aggregator, so links don't dangle locally.
+     */
+    full?: boolean;
 };
 declare const DeclarationLink: import("svelte").Component<$$ComponentProps, {}, "">;
 type DeclarationLink = ReturnType<typeof DeclarationLink>;

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

@@ -1 +1 @@
-{"version":3,"file":"DeclarationLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationLink.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAOvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAiDH,QAAA,MAAM,eAAe,sDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"DeclarationLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationLink.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAOvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAoDH,QAAA,MAAM,eAAe,sDAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/Docs.svelte

@@ -4,7 +4,6 @@
 	import {innerWidth} from 'svelte/reactivity/window';
 	import {page} from '$app/state';
 
-	import type {Library} from './library.svelte.js';
 	import Breadcrumb from './Breadcrumb.svelte';
 	import {Tome, tomes_context} from './tome.js';
 	import DocsPrimaryNav from './DocsPrimaryNav.svelte';
@@ -12,20 +11,20 @@
 	import DocsTertiaryNav from './DocsTertiaryNav.svelte';
 	import Dialog from './Dialog.svelte';
 	import DocsFooter from './DocsFooter.svelte';
+	import {site_context} from './site.svelte.js';
+	import {FUZ_DEV_URL} from './constants.js';
 	import {DocsLinks, docs_links_context} from './docs_helpers.svelte.js';
 
 	const {
 		tomes,
-		library,
-		breadcrumb_children,
 		children,
 	}: {
 		tomes: Array<Tome>;
-		library: Library;
-		breadcrumb_children?: Snippet<[is_primary_nav: boolean]>;
 		children: Snippet;
 	} = $props();
 
+	const site = site_context.get('`Docs` requires `site_context`; set it in your root layout');
+
 	// TODO this API is messy, inconsistent usage of props/context
 	const tomes_by_slug = $derived(new Map(tomes.map((t) => [t.slug, t])));
 	tomes_context.set(() => tomes_by_slug);
@@ -51,7 +50,7 @@
 <svelte:window onhashchange={() => (show_secondary_nav_dialog = false)} />
 
 <div class="docs" style:--docs_menu_width={docs_menu_width}>
-	<DocsPrimaryNav {library} {breadcrumb_children}>
+	<DocsPrimaryNav>
 		<div class="nav-dialog-toggle">
 			<button class="plain" type="button" onclick={() => toggle_secondary_nav_dialog()}>menu</button
 			>
@@ -72,15 +71,9 @@
 			<DocsTertiaryNav {tomes} {tomes_by_slug} />
 		{/if}
 		<section class="box">
-			<DocsFooter {library} root_url="https://www.fuz.dev/">
+			<DocsFooter repo_url={site.repo_url} root_url={FUZ_DEV_URL}>
 				<div class="mb_xl5">
-					<Breadcrumb>
-						{#if breadcrumb_children}
-							{@render breadcrumb_children(false)}
-						{:else}
-							{library.package_json.glyph ?? '🏠'}
-						{/if}
-					</Breadcrumb>
+					<Breadcrumb />
 				</div>
 			</DocsFooter>
 		</section>
@@ -92,13 +85,7 @@
 	<Dialog onclose={() => (show_secondary_nav_dialog = false)}>
 		<div class="pane" style:--docs_menu_width={docs_menu_width}>
 			<div class="p_xl pb_0">
-				<Breadcrumb>
-					{#if breadcrumb_children}
-						{@render breadcrumb_children(false)}
-					{:else}
-						{library.package_json.glyph ?? '🏠'}
-					{/if}
-				</Breadcrumb>
+				<Breadcrumb />
 			</div>
 			<div class="px_lg pb_xl">
 				<DocsSecondaryNav {tomes} sidebar={false} />

package/dist/Docs.svelte.d.ts

@@ -1,10 +1,7 @@
 import type { Snippet } from 'svelte';
-import type { Library } from './library.svelte.js';
 import { Tome } from './tome.js';
 type $$ComponentProps = {
     tomes: Array<Tome>;
-    library: Library;
-    breadcrumb_children?: Snippet<[is_primary_nav: boolean]>;
     children: Snippet;
 };
 declare const Docs: import("svelte").Component<$$ComponentProps, {}, "">;

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

@@ -1 +1 @@
-{"version":3,"file":"Docs.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Docs.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAKpC,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAC,IAAI,EAAgB,MAAM,WAAW,CAAC;AAQ7C,KAAK,gBAAgB,GAAI;IACxB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA6GH,QAAA,MAAM,IAAI,sDAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Docs.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Docs.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAMpC,OAAO,EAAC,IAAI,EAAgB,MAAM,WAAW,CAAC;AAU7C,KAAK,gBAAgB,GAAI;IACxB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AAkGH,QAAA,MAAM,IAAI,sDAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}

package/dist/DocsFooter.svelte

@@ -3,12 +3,11 @@
 	import type {Snippet} from 'svelte';
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
-	import type {Library} from './library.svelte.js';
 	import Svg from './Svg.svelte';
 	import {logo_github} from './logos.js';
 
 	const {
-		library,
+		repo_url,
 		root_url = null,
 		logo,
 		logo_header,
@@ -16,8 +15,14 @@
 		children,
 		...rest
 	}: SvelteHTMLElements['footer'] & {
-		library: Library;
+		/**
+		 * Link target for the logo, e.g. the project's source repository.
+		 */
+		repo_url?: Url | null;
 		root_url?: Url | null;
+		/**
+		 * Overrides the default GitHub logo mark, e.g. for repos hosted elsewhere.
+		 */
 		logo?: Snippet;
 		logo_header?: Snippet;
 		logo_footer?: Snippet;
@@ -28,13 +33,12 @@
 	{@render children?.()}
 	<div class="logo box panel p_lg shadow_inset_xs">
 		{@render logo_header?.()}
-		<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-		<a href={library.repo_url} rel="me" title="source code on GitHub"
-			>{#if logo}{@render logo()}{:else}<Svg
-					data={logo_github}
-					size="var(--icon_size_lg)"
-				/>{/if}</a
-		>
+		{#if repo_url}
+			<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+			<a href={repo_url} rel="me" title="source code">{@render logo_mark()}</a>
+		{:else}
+			{@render logo_mark()}
+		{/if}
 		{@render logo_footer?.()}
 	</div>
 	{#if root_url}
@@ -45,6 +49,11 @@
 	{/if}
 </footer>
 
+{#snippet logo_mark()}{#if logo}{@render logo()}{:else}<Svg
+			data={logo_github}
+			size="var(--icon_size_lg)"
+		/>{/if}{/snippet}
+
 <style>
 	/* TODO probably extract */
 	.logo a {

package/dist/DocsFooter.svelte.d.ts

@@ -1,10 +1,15 @@
 import { type Url } from '@fuzdev/fuz_util/url.js';
 import type { Snippet } from 'svelte';
 import type { SvelteHTMLElements } from 'svelte/elements';
-import type { Library } from './library.svelte.js';
 type $$ComponentProps = SvelteHTMLElements['footer'] & {
-    library: Library;
+    /**
+     * Link target for the logo, e.g. the project's source repository.
+     */
+    repo_url?: Url | null;
     root_url?: Url | null;
+    /**
+     * Overrides the default GitHub logo mark, e.g. for repos hosted elsewhere.
+     */
     logo?: Snippet;
     logo_header?: Snippet;
     logo_footer?: Snippet;

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

@@ -1 +1 @@
-{"version":3,"file":"DocsFooter.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DocsFooter.svelte"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAIhD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,QAAQ,CAAC,GAAG;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAyCH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"DocsFooter.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DocsFooter.svelte"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAKvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,QAAQ,CAAC,GAAG;IACvD;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AA8CH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/DocsPrimaryNav.svelte

@@ -4,17 +4,12 @@
 	import {scrollY} from 'svelte/reactivity/window';
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
-	import type {Library} from './library.svelte.js';
 	import Breadcrumb from './Breadcrumb.svelte';
 
 	const {
-		library,
-		breadcrumb_children,
 		children,
 		...rest
 	}: SvelteHTMLElements['div'] & {
-		library: Library;
-		breadcrumb_children?: Snippet<[is_primary_nav: boolean]>;
 		children?: Snippet;
 	} = $props();
 
@@ -29,13 +24,7 @@
 		<div class="background" aria-hidden="true"></div>
 		<div class="content">
 			<nav aria-label="Primary nav">
-				<Breadcrumb>
-					{#if breadcrumb_children}
-						{@render breadcrumb_children(true)}
-					{:else}
-						{library.package_json.glyph ?? '🏠'}
-					{/if}
-				</Breadcrumb>
+				<Breadcrumb />
 			</nav>
 			{@render children?.()}
 		</div>

package/dist/DocsPrimaryNav.svelte.d.ts

@@ -1,9 +1,6 @@
 import type { Snippet } from 'svelte';
 import type { SvelteHTMLElements } from 'svelte/elements';
-import type { Library } from './library.svelte.js';
 type $$ComponentProps = SvelteHTMLElements['div'] & {
-    library: Library;
-    breadcrumb_children?: Snippet<[is_primary_nav: boolean]>;
     children?: Snippet;
 };
 declare const DocsPrimaryNav: import("svelte").Component<$$ComponentProps, {}, "">;

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

@@ -1 +1 @@
-{"version":3,"file":"DocsPrimaryNav.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DocsPrimaryNav.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAGhD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AA6CH,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"DocsPrimaryNav.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DocsPrimaryNav.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAIvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAoCH,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/DocsSearch.svelte

@@ -7,7 +7,7 @@
 		declaration_count,
 		filtered_module_count,
 		filtered_declaration_count,
-		search_query = $bindable(),
+		search_query = $bindable(), // eslint-disable-line @typescript-eslint/no-useless-default-assignment
 		...rest
 	}: SvelteHTMLElements['input'] & {
 		placeholder?: string;

package/dist/EcosystemLinks.svelte

@@ -1,4 +1,6 @@
 <script lang="ts">
+	import {FUZ_DEV_URL} from './constants.js';
+
 	const {
 		selected,
 	}: {
@@ -8,7 +10,8 @@
 
 <ul>
 	<li>
-		<a rel="me" href="https://www.fuz.dev/" class:selected={selected === 'fuz.dev'}>fuz.dev</a>
+		<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+		<a rel="me" href={FUZ_DEV_URL} class:selected={selected === 'fuz.dev'}>fuz.dev</a>
 		- the Fuz stack homepage{#if selected === 'fuz.dev'}, you are here{/if}
 	</li>
 	<li>

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

@@ -1 +1 @@
-{"version":3,"file":"EcosystemLinks.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/EcosystemLinks.svelte"],"names":[],"mappings":"AAGC,KAAK,gBAAgB,GAAI;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB,CAAC;AAqBH,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"EcosystemLinks.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/EcosystemLinks.svelte"],"names":[],"mappings":"AAKC,KAAK,gBAAgB,GAAI;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACrB,CAAC;AAwBH,QAAA,MAAM,cAAc,sDAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/LibraryDetail.svelte

@@ -21,6 +21,7 @@ with file-type coloring. Uses svelte-docinfo's file type predicates for module c
 
 	const {
 		library,
+		links_full = false,
 		repo_name,
 		description,
 		tagline,
@@ -29,6 +30,12 @@ with file-type coloring. Uses svelte-docinfo's file type predicates for module c
 		children,
 	}: {
 		library: Library;
+		/**
+		 * Link the module/declaration index to the library's own deployed docs
+		 * (`url_api_full`) instead of site-local paths. Use when rendering a
+		 * foreign library on a different site, e.g. an aggregator.
+		 */
+		links_full?: boolean;
 		repo_name?: Snippet<[repo_name: string]>;
 		description?: Snippet<[description: string]>;
 		tagline?: Snippet<[description: string]>;
@@ -166,7 +173,7 @@ with file-type coloring. Uses svelte-docinfo's file type predicates for module c
 					>
 						<div class="module-content">
 							<span class="font_size_xl">
-								<ModuleLink module_path={module.path}>
+								<ModuleLink module_path={module.path} full={links_full}>
 									{module.path}
 								</ModuleLink>
 							</span>
@@ -174,7 +181,7 @@ with file-type coloring. Uses svelte-docinfo's file type predicates for module c
 								<ul class="declarations unstyled">
 									{#each module.declarations as declaration (declaration.name)}
 										<li>
-											<DeclarationLink name={declaration.name} />
+											<DeclarationLink name={declaration.name} full={links_full} />
 										</li>
 									{/each}
 								</ul>

package/dist/LibraryDetail.svelte.d.ts

@@ -2,6 +2,12 @@ import type { Snippet } from 'svelte';
 import type { Library } from './library.svelte.js';
 type $$ComponentProps = {
     library: Library;
+    /**
+     * Link the module/declaration index to the library's own deployed docs
+     * (`url_api_full`) instead of site-local paths. Use when rendering a
+     * foreign library on a different site, e.g. an aggregator.
+     */
+    links_full?: boolean;
     repo_name?: Snippet<[repo_name: string]>;
     description?: Snippet<[description: string]>;
     tagline?: Snippet<[description: string]>;

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

@@ -1 +1 @@
-{"version":3,"file":"LibraryDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/LibraryDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAOhD,KAAK,gBAAgB,GAAI;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC,CAAC;AAiKH;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"LibraryDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/LibraryDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAEpC,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAOhD,KAAK,gBAAgB,GAAI;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;CACvC,CAAC;AAkKH;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/ModuleLink.svelte

@@ -9,6 +9,7 @@
 	const {
 		module_path,
 		hash,
+		full = false,
 		children,
 		class: class_prop = 'chip',
 		...rest
@@ -16,17 +17,25 @@
 		module_path: string; // TODO maybe rename?
 		/** URL fragment to append, with or without the `#`. */
 		hash?: string;
+		/**
+		 * Link to the library's own deployed docs (`url_api_full`) instead of a
+		 * site-local path (`url_api`). Use when rendering a foreign library on a
+		 * different site, e.g. an aggregator, so links don't dangle locally.
+		 */
+		full?: boolean;
 	} = $props();
 
 	const library = library_context.get();
 
 	const module = $derived(library.module_by_path.get(module_path));
 
+	// When linking a foreign library's docs, prefer its full URL; fall back to
+	// the site-local path if `homepage_url` is unavailable.
+	const url_api = $derived((full && module?.url_api_full) || module?.url_api);
+
 	const color_class = $derived(module_path.endsWith('.svelte') ? 'color_h' : '');
 
 	const contextmenu_entries = $derived(module ? create_module_contextmenu(module) : undefined);
-
-	// TODO @many support full https:// url variants - automatic detection? library prop?
 </script>
 
 {#if module}
@@ -34,7 +43,7 @@
 	<a
 		{...rest}
 		class="module-link {class_prop} {color_class}"
-		href={module.url_api + (hash ? ensure_start(hash, '#') : '')}
+		href={url_api + (hash ? ensure_start(hash, '#') : '')}
 		{@attach contextmenu_attachment(contextmenu_entries)}
 	>
 		<!-- eslint-enable svelte/no-navigation-without-resolve -->

package/dist/ModuleLink.svelte.d.ts

@@ -3,6 +3,12 @@ type $$ComponentProps = SvelteHTMLElements['a'] & {
     module_path: string;
     /** URL fragment to append, with or without the `#`. */
     hash?: string;
+    /**
+     * Link to the library's own deployed docs (`url_api_full`) instead of a
+     * site-local path (`url_api`). Use when rendering a foreign library on a
+     * different site, e.g. an aggregator, so links don't dangle locally.
+     */
+    full?: boolean;
 };
 declare const ModuleLink: import("svelte").Component<$$ComponentProps, {}, "">;
 type ModuleLink = ReturnType<typeof ModuleLink>;

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

@@ -1 +1 @@
-{"version":3,"file":"ModuleLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ModuleLink.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAOvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAiDH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ModuleLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ModuleLink.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAOvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAoDH,QAAA,MAAM,UAAU,sDAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/ProjectLinks.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
-	import Svg, {type SvgData} from './Svg.svelte';
+	import Svg from './Svg.svelte';
+	import type {SvgData} from './svg.js';
 	import {
 		// TODO when fuz.dev is ready
 		// logo_fuz,

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectLinks.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ProjectLinks.svelte"],"names":[],"mappings":"AA0EA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,YAAY;;kBAA+E,CAAC;AAChF,KAAK,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ProjectLinks.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ProjectLinks.svelte"],"names":[],"mappings":"AA4EA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,YAAY;;kBAA+E,CAAC;AAChF,KAAK,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,eAAe,YAAY,CAAC"}

package/dist/Svg.svelte

@@ -1,31 +1,9 @@
-<script lang="ts" module>
+<script lang="ts">
 	import {ensure_end} from '@fuzdev/fuz_util/string.js';
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
-	export interface SvgData {
-		/**
-		 * Raw svg markup string that's inserted unsafely as a child of the `svg` element.
-		 * This is an escape hatch for non-`path` markup -
-		 * generally, you should instead use the `paths` property to avoid security/CSP implications.
-		 */
-		raw?: string | null;
-		/**
-		 * List of svg `path` attribute objects. The `d` attribute is required.
-		 */
-		paths?: Array<{d: string} & SvelteHTMLElements['path']> | null;
-		attrs?: SvelteHTMLElements['svg'] | null;
-		fill?: string | null;
-		width?: string | null;
-		height?: string | null;
-		label?: string | null;
-		/**
-		 * Defaults to `"0 0 100 100"`.
-		 */
-		viewBox?: string | null;
-	}
-</script>
+	import type {SvgData} from './svg.js';
 
-<script lang="ts">
 	const {
 		data,
 		fill,

package/dist/Svg.svelte.d.ts

@@ -1,27 +1,5 @@
 import type { SvelteHTMLElements } from 'svelte/elements';
-export interface SvgData {
-    /**
-     * Raw svg markup string that's inserted unsafely as a child of the `svg` element.
-     * This is an escape hatch for non-`path` markup -
-     * generally, you should instead use the `paths` property to avoid security/CSP implications.
-     */
-    raw?: string | null;
-    /**
-     * List of svg `path` attribute objects. The `d` attribute is required.
-     */
-    paths?: Array<{
-        d: string;
-    } & SvelteHTMLElements['path']> | null;
-    attrs?: SvelteHTMLElements['svg'] | null;
-    fill?: string | null;
-    width?: string | null;
-    height?: string | null;
-    label?: string | null;
-    /**
-     * Defaults to `"0 0 100 100"`.
-     */
-    viewBox?: string | null;
-}
+import type { SvgData } from './svg.js';
 type $$ComponentProps = SvelteHTMLElements['svg'] & {
     data: SvgData;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"Svg.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Svg.svelte"],"names":[],"mappings":"AAIC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,IAAI,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AA2CH,QAAA,MAAM,GAAG,sDAAwC,CAAC;AAClD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;AAClC,eAAe,GAAG,CAAC"}
+{"version":3,"file":"Svg.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Svg.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,UAAU,CAAC;AAErC,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,IAAI,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AA8CH,QAAA,MAAM,GAAG,sDAAwC,CAAC;AAClD,KAAK,GAAG,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;AAClC,eAAe,GAAG,CAAC"}

package/dist/constants.d.ts

@@ -1,2 +1,6 @@
 export declare const MAIN_HEADER_MARGIN_TOP = "calc(60px + var(--space_lg))";
+/**
+ * The Fuz ecosystem home url, e.g. for `DocsFooter`'s `root_url`.
+ */
+export declare const FUZ_DEV_URL = "https://www.fuz.dev/";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,iCAAiC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,iCAAiC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,WAAW,yBAAyB,CAAC"}

package/dist/constants.js

@@ -1,3 +1,7 @@
 // TODO the 60px is a hack, need `--docs_primary_nav_height` exported or :root values from Fuz -- the --space_lg also needs to be kept in sync
 // see also the same issue in fuz_css
 export const MAIN_HEADER_MARGIN_TOP = 'calc(60px + var(--space_lg))';
+/**
+ * The Fuz ecosystem home url, e.g. for `DocsFooter`'s `root_url`.
+ */
+export const FUZ_DEV_URL = 'https://www.fuz.dev/';

package/dist/library_helpers.d.ts

@@ -8,36 +8,6 @@
  *
  * @module
  */
-/**
- * Build project-relative API documentation URL with hash anchor.
- *
- * @param declaration_name - name of the declaration to link to
- * @returns URL path like '/docs/api#declaration_name'
- */
-export declare const url_api_declaration: (declaration_name: string) => string;
-/**
- * Build full API documentation URL with domain and hash anchor.
- *
- * @param homepage - package homepage URL
- * @param declaration_name - name of the declaration to link to
- * @returns full URL like 'https://example.com/docs/api#declaration_name'
- */
-export declare const url_api_declaration_full: (homepage: string, declaration_name: string) => string;
-/**
- * Build project-relative module documentation URL.
- *
- * @param module_path - module path (e.g., 'helpers.ts')
- * @returns URL path like '/docs/api/helpers.ts'
- */
-export declare const url_api_module: (module_path: string) => string;
-/**
- * Build package logo URL with favicon.png fallback.
- *
- * @param homepage_url - package homepage URL, or null
- * @param logo_path - optional custom logo path (defaults to 'favicon.png')
- * @returns full URL to the logo, or null if no homepage
- */
-export declare const url_package_logo: (homepage_url: string | null, logo_path?: string) => string | null;
 /**
  * Convert a full URL to root-relative format by removing the origin.
  *

package/dist/library_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,kBAAkB,MAAM,KAAG,MACJ,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,EAAE,kBAAkB,MAAM,KAAG,MACR,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAA2C,CAAC;AAEjG;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,cAAc,MAAM,GAAG,IAAI,EAC3B,YAAY,MAAM,KAChB,MAAM,GAAG,IAIX,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,EAAE,SAAQ,MAAwB,KAAG,MAcpF,CAAC"}
+{"version":3,"file":"library_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,EAAE,SAAQ,MAAwB,KAAG,MAcpF,CAAC"}

package/dist/library_helpers.js

@@ -10,42 +10,6 @@
  */
 import { ensure_end, strip_start } from '@fuzdev/fuz_util/string.js';
 import { page } from '$app/state';
-import { DOCS_API_PATH, DOCS_PATH_DEFAULT } from './docs_helpers.svelte.js';
-/**
- * Build project-relative API documentation URL with hash anchor.
- *
- * @param declaration_name - name of the declaration to link to
- * @returns URL path like '/docs/api#declaration_name'
- */
-export const url_api_declaration = (declaration_name) => `${DOCS_API_PATH}#${encodeURIComponent(declaration_name)}`;
-/**
- * Build full API documentation URL with domain and hash anchor.
- *
- * @param homepage - package homepage URL
- * @param declaration_name - name of the declaration to link to
- * @returns full URL like 'https://example.com/docs/api#declaration_name'
- */
-export const url_api_declaration_full = (homepage, declaration_name) => `${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
-/**
- * Build project-relative module documentation URL.
- *
- * @param module_path - module path (e.g., 'helpers.ts')
- * @returns URL path like '/docs/api/helpers.ts'
- */
-export const url_api_module = (module_path) => `${DOCS_API_PATH}/${module_path}`;
-/**
- * Build package logo URL with favicon.png fallback.
- *
- * @param homepage_url - package homepage URL, or null
- * @param logo_path - optional custom logo path (defaults to 'favicon.png')
- * @returns full URL to the logo, or null if no homepage
- */
-export const url_package_logo = (homepage_url, logo_path) => {
-    if (!homepage_url)
-        return null;
-    const path = logo_path ? strip_start(logo_path, '/') : 'favicon.png';
-    return ensure_end(homepage_url, '/') + path;
-};
 /**
  * Convert a full URL to root-relative format by removing the origin.
  *

package/dist/module.svelte.d.ts

@@ -38,6 +38,13 @@ export declare class Module {
      * API documentation URL for this module.
      */
     url_api: string;
+    /**
+     * Public documentation link (if `homepage_url` is available).
+     *
+     * 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: string | undefined;
     /**
      * GitHub source URL.
      */

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;;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;gBAE7C,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,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;gBAE7C,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

@@ -43,6 +43,15 @@ export class Module {
      * API documentation URL for this module.
      */
     url_api = $derived(`/docs/api${this.library.url_prefix}/${this.path}`);
+    /**
+     * Public documentation link (if `homepage_url` is available).
+     *
+     * 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);
     /**
      * GitHub source URL.
      */

package/dist/site.svelte.d.ts

@@ -0,0 +1,34 @@
+import type { Url } from '@fuzdev/fuz_util/url.js';
+import type { SvgData } from './svg.js';
+export interface SiteStateOptions {
+    /**
+     * The site's icon, e.g. a logo from `logos.ts`.
+     */
+    icon?: SvgData | null;
+    /**
+     * The site's glyph, a single unicode character identifying the project.
+     */
+    glyph?: string | null;
+    /**
+     * The site's source repository url, e.g. for `DocsFooter` links.
+     */
+    repo_url?: Url | null;
+}
+/**
+ * Light site-identity values for app chrome - the icon, glyph, and repo url used
+ * by components like `Breadcrumb` and `DocsFooter`. Set once per app at the root
+ * layout. Distinct from `library_context`, which carries the heavy
+ * module/declaration metadata that only docs and API pages need.
+ */
+export declare class SiteState {
+    icon: SvgData | null;
+    glyph: string | null;
+    repo_url: Url | null;
+    constructor(options?: SiteStateOptions);
+}
+export declare const site_context: {
+    get: (error_message?: string) => SiteState;
+    get_maybe: () => SiteState | undefined;
+    set: (value: SiteState) => SiteState;
+};
+//# sourceMappingURL=site.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"site.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/site.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,yBAAyB,CAAC;AAGjD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACrB,IAAI,EAAE,OAAO,GAAG,IAAI,CAAoB;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAoB;IACxC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAoB;gBAE5B,OAAO,GAAE,gBAAqB;CAK1C;AAED,eAAO,MAAM,YAAY;;;;CAA8B,CAAC"}

package/dist/site.svelte.js

@@ -0,0 +1,18 @@
+import { create_context } from './context_helpers.js';
+/**
+ * Light site-identity values for app chrome - the icon, glyph, and repo url used
+ * by components like `Breadcrumb` and `DocsFooter`. Set once per app at the root
+ * layout. Distinct from `library_context`, which carries the heavy
+ * module/declaration metadata that only docs and API pages need.
+ */
+export class SiteState {
+    icon = $state.raw(null);
+    glyph = $state.raw(null);
+    repo_url = $state.raw(null);
+    constructor(options = {}) {
+        this.icon = options.icon ?? null;
+        this.glyph = options.glyph ?? null;
+        this.repo_url = options.repo_url ?? null;
+    }
+}
+export const site_context = create_context();

package/dist/svg.d.ts

@@ -0,0 +1,25 @@
+import type { SvelteHTMLElements } from 'svelte/elements';
+export interface SvgData {
+    /**
+     * Raw svg markup string that's inserted unsafely as a child of the `svg` element.
+     * This is an escape hatch for non-`path` markup -
+     * generally, you should instead use the `paths` property to avoid security/CSP implications.
+     */
+    raw?: string | null;
+    /**
+     * List of svg `path` attribute objects. The `d` attribute is required.
+     */
+    paths?: Array<{
+        d: string;
+    } & SvelteHTMLElements['path']> | null;
+    attrs?: SvelteHTMLElements['svg'] | null;
+    fill?: string | null;
+    width?: string | null;
+    height?: string | null;
+    label?: string | null;
+    /**
+     * Defaults to `"0 0 100 100"`.
+     */
+    viewBox?: string | null;
+}
+//# sourceMappingURL=svg.d.ts.map

package/dist/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB"}

package/dist/svg.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.196.0",
+  "version": "0.198.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -80,9 +80,9 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/blake3_wasm": "^0.1.0",
+    "@fuzdev/blake3_wasm": "^0.1.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.60.0",
+    "@fuzdev/fuz_css": "^0.61.1",
     "@fuzdev/fuz_util": "^0.63.0",
     "@fuzdev/gro": "^0.200.0",
     "@jridgewell/trace-mapping": "^0.3.31",
@@ -95,20 +95,20 @@
     "@types/estree": "^1.0.8",
     "@types/node": "^24.10.1",
     "@webref/css": "^8.2.0",
-    "eslint": "^9.39.1",
-    "eslint-plugin-svelte": "^3.13.1",
+    "eslint": "^9.39.4",
+    "eslint-plugin-svelte": "^3.19.0",
     "esm-env": "^1.2.2",
     "jsdom": "^27.2.0",
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
     "prettier-plugin-svelte": "^3.5.1",
-    "svelte": "^5.55.10",
+    "svelte": "^5.56.0",
     "svelte-check": "^4.4.8",
     "svelte-docinfo": "^0.2.0",
     "svelte2tsx": "^0.7.55",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.48.1",
+    "typescript-eslint": "^8.60.0",
     "vite": "^7.3.1",
     "vitest": "^4.0.15",
     "zimmerframe": "^1.1.4",

package/src/lib/constants.ts

@@ -1,3 +1,8 @@
 // TODO the 60px is a hack, need `--docs_primary_nav_height` exported or :root values from Fuz -- the --space_lg also needs to be kept in sync
 // see also the same issue in fuz_css
 export const MAIN_HEADER_MARGIN_TOP = 'calc(60px + var(--space_lg))';
+
+/**
+ * The Fuz ecosystem home url, e.g. for `DocsFooter`'s `root_url`.
+ */
+export const FUZ_DEV_URL = 'https://www.fuz.dev/';

package/src/lib/library_helpers.ts

@@ -12,51 +12,6 @@
 import {ensure_end, strip_start} from '@fuzdev/fuz_util/string.js';
 import {page} from '$app/state';
 
-import {DOCS_API_PATH, DOCS_PATH_DEFAULT} from './docs_helpers.svelte.js';
-
-/**
- * Build project-relative API documentation URL with hash anchor.
- *
- * @param declaration_name - name of the declaration to link to
- * @returns URL path like '/docs/api#declaration_name'
- */
-export const url_api_declaration = (declaration_name: string): string =>
-	`${DOCS_API_PATH}#${encodeURIComponent(declaration_name)}`;
-
-/**
- * Build full API documentation URL with domain and hash anchor.
- *
- * @param homepage - package homepage URL
- * @param declaration_name - name of the declaration to link to
- * @returns full URL like 'https://example.com/docs/api#declaration_name'
- */
-export const url_api_declaration_full = (homepage: string, declaration_name: string): string =>
-	`${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
-
-/**
- * Build project-relative module documentation URL.
- *
- * @param module_path - module path (e.g., 'helpers.ts')
- * @returns URL path like '/docs/api/helpers.ts'
- */
-export const url_api_module = (module_path: string): string => `${DOCS_API_PATH}/${module_path}`;
-
-/**
- * Build package logo URL with favicon.png fallback.
- *
- * @param homepage_url - package homepage URL, or null
- * @param logo_path - optional custom logo path (defaults to 'favicon.png')
- * @returns full URL to the logo, or null if no homepage
- */
-export const url_package_logo = (
-	homepage_url: string | null,
-	logo_path?: string,
-): string | null => {
-	if (!homepage_url) return null;
-	const path = logo_path ? strip_start(logo_path, '/') : 'favicon.png';
-	return ensure_end(homepage_url, '/') + path;
-};
-
 /**
  * Convert a full URL to root-relative format by removing the origin.
  *

package/src/lib/logos.ts

@@ -1,4 +1,4 @@
-import type {SvgData} from './Svg.svelte';
+import type {SvgData} from './svg.js';
 
 // TODO these can be optimized during builds, helpers and gen files?
 

package/src/lib/mdz_lexer.ts

@@ -603,7 +603,7 @@ export class MdzLexer {
 		const open_type = kind === 'italic' ? 'italic_open' : 'strikethrough_open';
 		const close_type = kind === 'italic' ? 'italic_close' : 'strikethrough_close';
 		const open_token_index = this.#tokens.length;
-		this.#tokens.push({type: open_type, start, end: this.#index} as MdzToken);
+		this.#tokens.push({type: open_type, start, end: this.#index});
 
 		// Set search boundary for nested parsers
 		const saved_max = this.#max_search_index;
@@ -634,7 +634,7 @@ export class MdzLexer {
 				type: close_type,
 				start: close_index,
 				end: close_index + 1,
-			} as MdzToken);
+			});
 			this.#index = close_index + 1;
 		} else {
 			// Convert opening to text

package/src/lib/mdz_token_parser.ts

@@ -443,7 +443,7 @@ class MdzTokenParser {
 						end: node.end,
 					};
 				} else {
-					pending_text = {...node} as MdzTextNode;
+					pending_text = {...node};
 				}
 			} else {
 				if (pending_text) {

package/src/lib/module.svelte.ts

@@ -55,6 +55,18 @@ export class Module {
 	 */
 	url_api = $derived(`/docs/api${this.library.url_prefix}/${this.path}`);
 
+	/**
+	 * Public documentation link (if `homepage_url` is available).
+	 *
+	 * 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,
+	);
+
 	/**
 	 * GitHub source URL.
 	 */

package/src/lib/site.svelte.ts

@@ -0,0 +1,39 @@
+import type {Url} from '@fuzdev/fuz_util/url.js';
+
+import {create_context} from './context_helpers.js';
+import type {SvgData} from './svg.js';
+
+export interface SiteStateOptions {
+	/**
+	 * The site's icon, e.g. a logo from `logos.ts`.
+	 */
+	icon?: SvgData | null;
+	/**
+	 * The site's glyph, a single unicode character identifying the project.
+	 */
+	glyph?: string | null;
+	/**
+	 * The site's source repository url, e.g. for `DocsFooter` links.
+	 */
+	repo_url?: Url | null;
+}
+
+/**
+ * Light site-identity values for app chrome - the icon, glyph, and repo url used
+ * by components like `Breadcrumb` and `DocsFooter`. Set once per app at the root
+ * layout. Distinct from `library_context`, which carries the heavy
+ * module/declaration metadata that only docs and API pages need.
+ */
+export class SiteState {
+	icon: SvgData | null = $state.raw(null);
+	glyph: string | null = $state.raw(null);
+	repo_url: Url | null = $state.raw(null);
+
+	constructor(options: SiteStateOptions = {}) {
+		this.icon = options.icon ?? null;
+		this.glyph = options.glyph ?? null;
+		this.repo_url = options.repo_url ?? null;
+	}
+}
+
+export const site_context = create_context<SiteState>();

package/src/lib/storage.ts

@@ -41,7 +41,7 @@ export const load_from_storage = <T>(
 			return parse_fn(value);
 		}
 
-		return value as unknown as T;
+		return value;
 	} catch (_) {
 		return null;
 	}

package/src/lib/svg.ts

@@ -0,0 +1,23 @@
+import type {SvelteHTMLElements} from 'svelte/elements';
+
+export interface SvgData {
+	/**
+	 * Raw svg markup string that's inserted unsafely as a child of the `svg` element.
+	 * This is an escape hatch for non-`path` markup -
+	 * generally, you should instead use the `paths` property to avoid security/CSP implications.
+	 */
+	raw?: string | null;
+	/**
+	 * List of svg `path` attribute objects. The `d` attribute is required.
+	 */
+	paths?: Array<{d: string} & SvelteHTMLElements['path']> | null;
+	attrs?: SvelteHTMLElements['svg'] | null;
+	fill?: string | null;
+	width?: string | null;
+	height?: string | null;
+	label?: string | null;
+	/**
+	 * Defaults to `"0 0 100 100"`.
+	 */
+	viewBox?: string | null;
+}