@fuzdev/fuz_ui 0.196.0 → 0.197.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/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/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/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.197.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/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/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;
+}