@fuzdev/fuz_ui 0.192.0 → 0.193.0

package/dist/ApiIndex.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
 	import {library_context, type Library} from './library.svelte.js';
-	import {get_tome_by_name, type Tome} from './tome.js';
+	import {tome_get_by_slug, type Tome} from './tome.js';
 	import TomeContent from './TomeContent.svelte';
 	import TomeLink from './TomeLink.svelte';
 	import DocsSearch from './DocsSearch.svelte';
@@ -10,7 +10,7 @@
 
 	const {
 		library = library_context.get(),
-		tome = get_tome_by_name('api'),
+		tome = tome_get_by_slug('api'),
 		minimal = false,
 	}: {
 		/**
@@ -40,7 +40,7 @@
 <TomeContent {tome}>
 	{#if minimal}
 		<section>
-			<p>Browse the full <TomeLink name="api" /> docs.</p>
+			<p>Browse the full <TomeLink slug="api" /> docs.</p>
 		</section>
 	{:else}
 		<section>

package/dist/ApiModule.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
 	import {library_context, type Library} from './library.svelte.js';
-	import {get_tome_by_name, type Tome} from './tome.js';
+	import {tome_get_by_slug, type Tome} from './tome.js';
 	import TomeContent from './TomeContent.svelte';
 	import TomeSection from './TomeSection.svelte';
 	import TomeSectionHeader from './TomeSectionHeader.svelte';
@@ -13,7 +13,7 @@
 	const {
 		module_path: module_path_param,
 		library = library_context.get(),
-		tome = get_tome_by_name('api'),
+		tome = tome_get_by_slug('api'),
 	}: {
 		/**
 		 * The module path parameter from the route (e.g., "lib/Button.svelte").

package/dist/Docs.svelte

@@ -27,8 +27,8 @@
 	} = $props();
 
 	// TODO this API is messy, inconsistent usage of props/context
-	const tomes_by_name = $derived(new Map(tomes.map((t) => [t.name, t])));
-	tomes_context.set(() => tomes_by_name);
+	const tomes_by_slug = $derived(new Map(tomes.map((t) => [t.slug, t])));
+	tomes_context.set(() => tomes_by_slug);
 
 	// TODO @many dialog navs - this is messy to satisfy SSR with the current design that puts the secondary nav in a dialog
 	const TERTIARY_NAV_BREAKPOINT = 1000;
@@ -69,7 +69,7 @@
 		{/key}
 		<!-- TODO @many dialog navs -->
 		{#if !innerWidth.current || innerWidth.current > TERTIARY_NAV_BREAKPOINT}
-			<DocsTertiaryNav {tomes} {tomes_by_name} />
+			<DocsTertiaryNav {tomes} {tomes_by_slug} />
 		{/if}
 		<section class="box">
 			<DocsFooter {library} root_url="https://www.fuz.dev/">
@@ -102,7 +102,7 @@
 			</div>
 			<div class="px_lg pb_xl">
 				<DocsSecondaryNav {tomes} sidebar={false} />
-				<DocsTertiaryNav {tomes} {tomes_by_name} sidebar={false} />
+				<DocsTertiaryNav {tomes} {tomes_by_slug} sidebar={false} />
 			</div>
 		</div>
 	</Dialog>

package/dist/DocsMenu.svelte

@@ -5,7 +5,7 @@
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
 	import DocsList from './DocsList.svelte';
-	import {to_tome_pathname, type Tome} from './tome.js';
+	import {tome_to_pathname, tome_to_title, type Tome} from './tome.js';
 	import DocsMenuHeader from './DocsMenuHeader.svelte';
 
 	const {
@@ -37,10 +37,10 @@
 					>{/if}
 				<ul class="unstyled">
 					{#each tomes as item (item)}
-						{@const pathname = to_tome_pathname(item)}
+						{@const pathname = tome_to_pathname(item)}
 						<li role="none" transition:slide>
 							<a class="menuitem" href={pathname} class:selected={pathname === page.url.pathname}
-								><div class="ellipsis">{item.name}</div></a
+								><div class="ellipsis">{tome_to_title(item)}</div></a
 							>
 						</li>
 					{/each}

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

@@ -1 +1 @@
-{"version":3,"file":"DocsMenu.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DocsMenu.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAmB,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAGrD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAkDH,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"DocsMenu.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DocsMenu.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAAkC,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAGpE,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG;IACpD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAkDH,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/DocsTertiaryNav.svelte

@@ -3,7 +3,7 @@
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
 	import DocsPageLinks from './DocsPageLinks.svelte';
-	import {to_tome_pathname, Tome} from './tome.js';
+	import {tome_to_pathname, Tome} from './tome.js';
 	import {docs_links_context} from './docs_helpers.svelte.js';
 	import {library_context} from './library.svelte.js';
 	import TomeLink from './TomeLink.svelte';
@@ -12,20 +12,20 @@
 
 	const {
 		tomes,
-		tomes_by_name,
+		tomes_by_slug,
 		sidebar = true,
 		...rest
 	}: SvelteHTMLElements['aside'] & {
 		tomes: Array<Tome>;
-		tomes_by_name: Map<string, Tome>;
+		tomes_by_slug: Map<string, Tome>;
 		sidebar?: boolean; // TODO @many dialog navs (this shouldn't exist)
 	} = $props();
 
-	const selected_tome = $derived(tomes.find((t) => to_tome_pathname(t) === page.url.pathname));
+	const selected_tome = $derived(tomes.find((t) => tome_to_pathname(t) === page.url.pathname));
 
 	const tomes_related_to_selected = $derived(
 		selected_tome?.related_tomes
-			.map((name) => tomes_by_name.get(name))
+			.map((slug) => tomes_by_slug.get(slug))
 			.filter((t) => t !== undefined) ?? [],
 	);
 
@@ -57,8 +57,8 @@
 		<section class="related-section">
 			<h4 class="mb_sm">related tomes</h4>
 			<ul class="unstyled">
-				{#each tomes_related_to_selected as tome (tome.name)}
-					<li><TomeLink name={tome.name} class="menuitem" /></li>
+				{#each tomes_related_to_selected as tome (tome.slug)}
+					<li><TomeLink slug={tome.slug} class="menuitem" /></li>
 				{/each}
 			</ul>
 		</section>

package/dist/DocsTertiaryNav.svelte.d.ts

@@ -2,7 +2,7 @@ import type { SvelteHTMLElements } from 'svelte/elements';
 import { Tome } from './tome.js';
 type $$ComponentProps = SvelteHTMLElements['aside'] & {
     tomes: Array<Tome>;
-    tomes_by_name: Map<string, Tome>;
+    tomes_by_slug: Map<string, Tome>;
     sidebar?: boolean;
 };
 declare const DocsTertiaryNav: import("svelte").Component<$$ComponentProps, {}, "">;

package/dist/TomeContent.svelte

@@ -5,7 +5,7 @@
 
 	import TomeHeader from './TomeHeader.svelte';
 	import {tome_context, type Tome} from './tome.js';
-	import {DOCS_PATH_DEFAULT, docs_links_context, docs_slugify} from './docs_helpers.svelte.js';
+	import {DOCS_PATH_DEFAULT, docs_links_context} from './docs_helpers.svelte.js';
 	import {intersect} from './intersect.svelte.js';
 
 	const {
@@ -24,7 +24,7 @@
 
 	tome_context.set(() => tome);
 
-	const fragment = $derived(docs_slugify(tome.name));
+	const fragment = $derived(tome.slug);
 
 	const at_root = $derived(page.url.pathname === resolve(docs_path as any));
 </script>

package/dist/TomeHeader.svelte

@@ -3,41 +3,42 @@
 	import {DEV} from 'esm-env';
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
-	import {tome_context} from './tome.js';
+	import {tome_context, tome_to_title} from './tome.js';
 	import Hashlink from './Hashlink.svelte';
-	import {docs_links_context, docs_slugify, to_docs_path_info} from './docs_helpers.svelte.js';
+	import {docs_links_context, to_docs_path_info} from './docs_helpers.svelte.js';
 
 	// eslint-disable-next-line @typescript-eslint/no-duplicate-type-constituents
 	const props: SvelteHTMLElements['h1'] | SvelteHTMLElements['h2'] = $props();
 
 	const get_tome = tome_context.get();
-	if (DEV && !get_tome) throw Error('TomeHeader expects a tome in context'); // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+	if (DEV && !get_tome) throw Error('TomeHeader expects a tome in context');
 	const tome = $derived(get_tome());
 
 	const docs_links = docs_links_context.get();
 
-	const fragment = $derived(docs_slugify(tome.name));
-	const path_slug = $derived(docs_slugify(tome.name));
+	// The slug is the route segment + anchor fragment; only the visible label uses `title`.
+	const fragment = $derived(tome.slug);
+	const title = $derived(tome_to_title(tome));
 	$effect(() => {
-		const id = docs_links.add(fragment, tome.name, page.url.pathname);
+		const id = docs_links.add(fragment, title, page.url.pathname);
 		return () => docs_links.remove(id);
 	});
 
-	const {path, path_is_selected} = $derived(to_docs_path_info(path_slug, page.url.pathname));
+	const {path, path_is_selected} = $derived(to_docs_path_info(fragment, page.url.pathname));
 </script>
 
 <svelte:element this={path_is_selected ? 'h1' : 'h2'} {...props} class="tome-header">
 	{#if path_is_selected}
-		{@render content(tome.name)}
+		{@render content(title)}
 	{:else}
 		<!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-		<a href={path}>{@render content(tome.name)}</a>
+		<a href={path}>{@render content(title)}</a>
 	{/if}
 	<Hashlink {fragment} />
 </svelte:element>
 
-{#snippet content(name: string)}
-	{name}
+{#snippet content(text: string)}
+	{text}
 {/snippet}
 
 <style>

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

@@ -1 +1 @@
-{"version":3,"file":"TomeHeader.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/TomeHeader.svelte"],"names":[],"mappings":"AA0DA,QAAA,MAAM,UAAU,kGAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}
+{"version":3,"file":"TomeHeader.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/TomeHeader.svelte"],"names":[],"mappings":"AA2DA,QAAA,MAAM,UAAU,kGAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/TomeLink.svelte

@@ -2,18 +2,18 @@
 	import {DEV} from 'esm-env';
 	import type {SvelteHTMLElements} from 'svelte/elements';
 
-	import {get_tome_by_name, to_tome_pathname} from './tome.js';
+	import {tome_get_by_slug, tome_to_pathname, tome_to_title, tomes_context} from './tome.js';
 	import {DOCS_PATH_DEFAULT} from './docs_helpers.svelte.js';
 
 	const {
-		name,
+		slug,
 		docs_path = DOCS_PATH_DEFAULT,
 		hash,
 		children,
 		class: class_prop = 'chip',
 		...rest
 	}: SvelteHTMLElements['a'] & {
-		name: string; // TODO type, generate from `tomes`?
+		slug: string; // TODO type, generate from `tomes`?
 		docs_path?: string;
 		/** URL fragment to append, with or without the `#`. */
 		hash?: string;
@@ -21,14 +21,21 @@
 
 	if (DEV) {
 		$effect(() => {
-			get_tome_by_name(name); // throws if not found
+			tome_get_by_slug(slug); // throws if not found
 		});
 	}
 
+	// Default link text is the tome's display title, falling back to its `slug`.
+	const get_tomes = tomes_context.get_maybe();
+	const label = $derived.by(() => {
+		const tome = get_tomes?.().get(slug);
+		return tome ? tome_to_title(tome) : slug;
+	});
+
 	// TODO add contextmenu behavior
 </script>
 
 <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-<a {...rest} class="tome-link {class_prop}" href={to_tome_pathname(name, docs_path, hash)}
-	>{#if children}{@render children()}{:else}{name}{/if}</a
+<a {...rest} class="tome-link {class_prop}" href={tome_to_pathname(slug, docs_path, hash)}
+	>{#if children}{@render children()}{:else}{label}{/if}</a
 >

package/dist/TomeLink.svelte.d.ts

@@ -1,6 +1,6 @@
 import type { SvelteHTMLElements } from 'svelte/elements';
 type $$ComponentProps = SvelteHTMLElements['a'] & {
-    name: string;
+    slug: string;
     docs_path?: string;
     /** URL fragment to append, with or without the `#`. */
     hash?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"TomeLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/TomeLink.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAKvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AA+BH,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"TomeLink.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/TomeLink.svelte"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAKvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAsCH,QAAA,MAAM,QAAQ,sDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/contextmenu_state.svelte.js

@@ -213,7 +213,7 @@ export class ContextmenuState {
         do {
             i.selected = true;
             new_selections.unshift(i);
-        } while ((i = i.menu) && i.menu); // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+        } while ((i = i.menu) && i.menu);
         this.selections = new_selections;
     }
     collapse_selected() {
@@ -341,7 +341,6 @@ export const contextmenu_open = (target, x, y, contextmenu, options) => {
     // `navigator.vibrate()` works with `ContextmenuRoot` but gets blocked by some browsers
     // when used with `ContextmenuRootForSafariCompatibility` because its longpress
     // workaround triggers from a timeout rather than a direct user interaction.
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
     if (BROWSER && vibrate && navigator.vibrate) {
         navigator.vibrate(CONTEXTMENU_OPEN_VIBRATE_DURATION);
     }

package/dist/csp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csp.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/csp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"csp.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/csp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,2BAA2B,CAAC;AAIvD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;KACnC,CAAC,IAAI,YAAY,IAAI,aAAa,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;CACjG,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IAC1C;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC,OAAO,4BAA4B,CAAC,CAAC;IAEhE;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;IAE/C;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE;SACV,CAAC,IAAI,YAAY,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI;KACjD,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAS,0BAA+B,KAAG,aA6HhF,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,mBAAmB,GAAI,WAAW,OAAO,KAAG,YAAY,GAAG,IAGhE,CAAC;AAET,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAgClF,eAAO,MAAM,wBAAwB,wDAAwD,CAAC;AAE9F;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,EAAE,OAAO,CAAC;KACjD,CAAC,IAAI,YAAY,GAAG,iBAAiB,CAAC,CAAC,CAAC;CACzC,CAyBA,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACrC,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,gBAAgB,CAwIvD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAE1E,CAAC;AA8BF,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC;AACjE,MAAM,MAAM,aAAa,GACtB,MAAM,GACN,aAAa,GACb,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,MAAM,CAAC;AACV,MAAM,MAAM,eAAe,GAAG,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;AACtF,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,WAAW,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,GAAG,sBAAsB,GAAG,iBAAiB,GAAG,aAAa,EAAE,CAAC;AAC5F,MAAM,MAAM,sBAAsB,GAAG,GAAG,MAAM,KAAK,GAAG,EAAE,CAAC;AACzD,MAAM,MAAM,aAAa,GAAG,IAAI,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACrD,MAAM,MAAM,eAAe,GACxB,OAAO,GACP,QAAQ,GACR,OAAO,GACP,cAAc,GACd,OAAO,GACP,aAAa,CAAC;AACjB,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,eAAe,GAAG,aAAa,CAAC;AAC1F,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC7B,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IAClD,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IACjD,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,iBAAiB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1C,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,eAAe,CAAC,CAAC;IAChD,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,2BAA2B,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,kBAAkB,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,KAAK,CACZ,yCAAyC,GACzC,aAAa,GACb,cAAc,GACd,wBAAwB,GACxB,oBAAoB,GACpB,cAAc,GACd,gCAAgC,GAChC,oBAAoB,GACpB,mBAAmB,GACnB,eAAe,GACf,yCAAyC,GACzC,sBAAsB,GACtB,yCAAyC,CAC3C,CAAC;CACF"}

package/dist/csp.js

@@ -22,7 +22,6 @@
  */
 export const create_csp_directives = (options = {}) => {
     const { replace_defaults = csp_directive_value_defaults, extend, overrides } = options;
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
     if (replace_defaults === null) {
         throw new Error(`Invalid value 'null' for options.replace_defaults. ` +
             `Omit the option to use library defaults, or pass {} to start with no directives.`);
@@ -40,12 +39,10 @@ export const create_csp_directives = (options = {}) => {
     // Stage 1: starting state from `replace_defaults`.
     // `{}` starts blank — every directive must come from `extend`/`overrides`.
     for_each_directive(replace_defaults, 'replace_defaults', (directive, value) => {
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
         if (value === null) {
             throw new Error(`Invalid value 'null' for directive '${directive}' in options.replace_defaults. ` +
                 `Omit the key instead, or use \`overrides: { '${directive}': null }\` to remove.`);
         }
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
         if (value === undefined)
             return;
         assign(directive, value);
@@ -95,7 +92,6 @@ export const create_csp_directives = (options = {}) => {
         for_each_directive(overrides, 'overrides', (directive, value) => {
             if (value === null) {
                 delete directives[directive]; // eslint-disable-line @typescript-eslint/no-dynamic-delete
-                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
             }
             else if (value !== undefined) {
                 assign(directive, value);
@@ -144,9 +140,8 @@ const is_none = (value) => Array.isArray(value) && value.length === 1 && value[0
  * `Object.entries`.
  */
 const for_each_directive = (source, source_label, fn) => {
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
     if (source === null || typeof source !== 'object') {
-        const got = source === null ? 'null' : typeof source; // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+        const got = source === null ? 'null' : typeof source;
         throw new Error(`Invalid entry in options.${source_label}: expected an object, got ${got}.`);
     }
     for (const [key, value] of Object.entries(source)) {

package/dist/tome.d.ts

@@ -1,7 +1,8 @@
 import type { Component } from 'svelte';
 import { z } from 'zod';
 export declare const Tome: z.ZodObject<{
-    name: z.ZodString;
+    slug: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
     category: z.ZodString;
     Component: z.ZodCustom<Component<any, any, string>, Component<any, any, string>>;
     related_tomes: z.ZodArray<z.ZodString>;
@@ -12,13 +13,17 @@ export type Tome = z.infer<typeof Tome>;
 /**
  * @param hash - URL fragment to append, with or without the `#`
  */
-export declare const to_tome_pathname: (item: Tome | string, docs_path?: string, hash?: string) => string;
+export declare const tome_to_pathname: (item: Tome | string, docs_path?: string, hash?: string) => string;
+/**
+ * The display label for a tome — its `title` if set, else its `slug`.
+ */
+export declare const tome_to_title: (tome: Tome) => string;
 export declare const tomes_context: {
     get: (error_message?: string) => () => Map<string, Tome>;
     get_maybe: () => (() => Map<string, Tome>) | undefined;
     set: (value: () => Map<string, Tome>) => () => Map<string, Tome>;
 };
-export declare const get_tome_by_name: (name: string) => Tome;
+export declare const tome_get_by_slug: (slug: string) => Tome;
 export declare const tome_context: {
     get: (error_message?: string) => () => Tome;
     get_maybe: () => (() => Tome) | undefined;

package/dist/tome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tome.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tome.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAMtB,eAAO,MAAM,IAAI;;;;;;;iBAQf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC5B,MAAM,IAAI,GAAG,MAAM,EACnB,kBAA6B,EAC7B,OAAO,MAAM,KACX,MAIF,CAAC;AAEF,eAAO,MAAM,aAAa;2CAAwB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;4BAAjB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;uBAAjB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,WAAjB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;CAAG,CAAC;AAEvE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,IAK/C,CAAC;AAEF,eAAO,MAAM,YAAY;2CAAwB,IAAI;4BAAJ,IAAI;uBAAJ,IAAI,WAAJ,IAAI;CAAG,CAAC"}
+{"version":3,"file":"tome.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tome.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAMtB,eAAO,MAAM,IAAI;;;;;;;;iBAoBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC5B,MAAM,IAAI,GAAG,MAAM,EACnB,kBAA6B,EAC7B,OAAO,MAAM,KACX,MAIF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,MAAiC,CAAC;AAE7E,eAAO,MAAM,aAAa;2CAAwB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;4BAAjB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;uBAAjB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,WAAjB,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;CAAG,CAAC;AAEvE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,IAK/C,CAAC;AAEF,eAAO,MAAM,YAAY;2CAAwB,IAAI;4BAAJ,IAAI;uBAAJ,IAAI,WAAJ,IAAI;CAAG,CAAC"}

package/dist/tome.js

@@ -2,9 +2,21 @@ import { resolve } from '$app/paths';
 import { z } from 'zod';
 import { ensure_start } from '@fuzdev/fuz_util/string.js';
 import { create_context } from './context_helpers.js';
-import { DOCS_PATH_DEFAULT, docs_slugify } from './docs_helpers.svelte.js';
+import { DOCS_PATH_DEFAULT } from './docs_helpers.svelte.js';
 export const Tome = z.object({
-    name: z.string(),
+    /**
+     * Stable identifier and URL path segment — must be a URL-safe slug
+     * (used directly as the route segment, the lookup key, and in
+     * `related_tomes` cross-references). Set `title` for the display label.
+     */
+    slug: z.string(),
+    /**
+     * Human-readable display label shown in menus, headings, and links.
+     * Falls back to `slug` when omitted, so set `title` to give multi-word or
+     * specially cased tomes a readable label (e.g. `slug: 'vite-plugin'` →
+     * `title: 'vite plugin'`).
+     */
+    title: z.string().optional(),
     // TODO maybe now this makes sense with mdz? summary: z.string(),
     category: z.string(),
     Component: z.custom(),
@@ -15,17 +27,21 @@ export const Tome = z.object({
 /**
  * @param hash - URL fragment to append, with or without the `#`
  */
-export const to_tome_pathname = (item, docs_path = DOCS_PATH_DEFAULT, hash) => {
-    const name = typeof item === 'string' ? item : item.name;
-    const path = docs_path + '/' + docs_slugify(name);
+export const tome_to_pathname = (item, docs_path = DOCS_PATH_DEFAULT, hash) => {
+    const slug = typeof item === 'string' ? item : item.slug;
+    const path = docs_path + '/' + slug;
     return resolve((hash ? path + ensure_start(hash, '#') : path));
 };
+/**
+ * The display label for a tome — its `title` if set, else its `slug`.
+ */
+export const tome_to_title = (tome) => tome.title ?? tome.slug;
 export const tomes_context = create_context();
-export const get_tome_by_name = (name) => {
+export const tome_get_by_slug = (slug) => {
     const get_tomes = tomes_context.get();
-    const tome = get_tomes().get(name);
+    const tome = get_tomes().get(slug);
     if (!tome)
-        throw Error(`unable to find tome "${name}"`);
+        throw Error(`unable to find tome "${slug}"`);
     return tome;
 };
 export const tome_context = create_context();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.192.0",
+  "version": "0.193.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -82,10 +82,10 @@
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_code": "^0.45.1",
     "@fuzdev/fuz_css": "^0.59.0",
-    "@fuzdev/fuz_util": "^0.57.0",
-    "@fuzdev/gro": "^0.198.0",
+    "@fuzdev/fuz_util": "^0.61.1",
+    "@fuzdev/gro": "^0.199.1",
     "@jridgewell/trace-mapping": "^0.3.31",
-    "@ryanatkn/eslint-config": "^0.11.0",
+    "@ryanatkn/eslint-config": "^0.12.1",
     "@sveltejs/acorn-typescript": "^1.0.9",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.55.0",

package/src/lib/contextmenu_state.svelte.ts

@@ -253,7 +253,7 @@ export class ContextmenuState {
 		do {
 			i.selected = true;
 			new_selections.unshift(i);
-		} while ((i = i.menu) && i.menu); // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+		} while ((i = i.menu) && i.menu);
 		this.selections = new_selections;
 	}
 
@@ -418,7 +418,7 @@ export const contextmenu_open = (
 	// `navigator.vibrate()` works with `ContextmenuRoot` but gets blocked by some browsers
 	// when used with `ContextmenuRootForSafariCompatibility` because its longpress
 	// workaround triggers from a timeout rather than a direct user interaction.
-	// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+
 	if (BROWSER && vibrate && navigator.vibrate) {
 		navigator.vibrate(CONTEXTMENU_OPEN_VIBRATE_DURATION);
 	}

package/src/lib/csp.ts

@@ -89,7 +89,6 @@ export interface CreateCspDirectivesOptions {
 export const create_csp_directives = (options: CreateCspDirectivesOptions = {}): CspDirectives => {
 	const {replace_defaults = csp_directive_value_defaults, extend, overrides} = options;
 
-	// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 	if (replace_defaults === null) {
 		throw new Error(
 			`Invalid value 'null' for options.replace_defaults. ` +
@@ -112,14 +111,13 @@ export const create_csp_directives = (options: CreateCspDirectivesOptions = {}):
 	// Stage 1: starting state from `replace_defaults`.
 	// `{}` starts blank — every directive must come from `extend`/`overrides`.
 	for_each_directive(replace_defaults, 'replace_defaults', (directive, value) => {
-		// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 		if (value === null) {
 			throw new Error(
 				`Invalid value 'null' for directive '${directive}' in options.replace_defaults. ` +
 					`Omit the key instead, or use \`overrides: { '${directive}': null }\` to remove.`,
 			);
 		}
-		// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+
 		if (value === undefined) return;
 		assign(directive, value);
 	});
@@ -172,7 +170,6 @@ export const create_csp_directives = (options: CreateCspDirectivesOptions = {}):
 		for_each_directive(overrides, 'overrides', (directive, value) => {
 			if (value === null) {
 				delete directives[directive]; // eslint-disable-line @typescript-eslint/no-dynamic-delete
-				// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 			} else if (value !== undefined) {
 				assign(directive, value);
 			}
@@ -242,9 +239,8 @@ const for_each_directive = <V>(
 	source_label: 'replace_defaults' | 'extend' | 'overrides',
 	fn: (directive: CspDirective, value: V) => void,
 ): void => {
-	// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
 	if (source === null || typeof source !== 'object') {
-		const got = source === null ? 'null' : typeof source; // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+		const got = source === null ? 'null' : typeof source;
 		throw new Error(`Invalid entry in options.${source_label}: expected an object, got ${got}.`);
 	}
 	for (const [key, value] of Object.entries(source)) {

package/src/lib/tome.ts

@@ -4,10 +4,22 @@ import {z} from 'zod';
 import {ensure_start} from '@fuzdev/fuz_util/string.js';
 
 import {create_context} from './context_helpers.js';
-import {DOCS_PATH_DEFAULT, docs_slugify} from './docs_helpers.svelte.js';
+import {DOCS_PATH_DEFAULT} from './docs_helpers.svelte.js';
 
 export const Tome = z.object({
-	name: z.string(),
+	/**
+	 * Stable identifier and URL path segment — must be a URL-safe slug
+	 * (used directly as the route segment, the lookup key, and in
+	 * `related_tomes` cross-references). Set `title` for the display label.
+	 */
+	slug: z.string(),
+	/**
+	 * Human-readable display label shown in menus, headings, and links.
+	 * Falls back to `slug` when omitted, so set `title` to give multi-word or
+	 * specially cased tomes a readable label (e.g. `slug: 'vite-plugin'` →
+	 * `title: 'vite plugin'`).
+	 */
+	title: z.string().optional(),
 	// TODO maybe now this makes sense with mdz? summary: z.string(),
 	category: z.string(),
 	Component: z.custom<Component<any, any>>(),
@@ -20,22 +32,27 @@ export type Tome = z.infer<typeof Tome>;
 /**
  * @param hash - URL fragment to append, with or without the `#`
  */
-export const to_tome_pathname = (
+export const tome_to_pathname = (
 	item: Tome | string,
 	docs_path = DOCS_PATH_DEFAULT,
 	hash?: string,
 ): string => {
-	const name = typeof item === 'string' ? item : item.name;
-	const path = docs_path + '/' + docs_slugify(name);
+	const slug = typeof item === 'string' ? item : item.slug;
+	const path = docs_path + '/' + slug;
 	return resolve((hash ? path + ensure_start(hash, '#') : path) as any);
 };
 
+/**
+ * The display label for a tome — its `title` if set, else its `slug`.
+ */
+export const tome_to_title = (tome: Tome): string => tome.title ?? tome.slug;
+
 export const tomes_context = create_context<() => Map<string, Tome>>();
 
-export const get_tome_by_name = (name: string): Tome => {
+export const tome_get_by_slug = (slug: string): Tome => {
 	const get_tomes = tomes_context.get();
-	const tome = get_tomes().get(name);
-	if (!tome) throw Error(`unable to find tome "${name}"`);
+	const tome = get_tomes().get(slug);
+	if (!tome) throw Error(`unable to find tome "${slug}"`);
 	return tome;
 };