@fuzdev/fuz_ui 0.197.0 → 0.198.1

package/README.md

@@ -4,9 +4,11 @@
 
 > friendly user zystem 🧶 [fuz.dev](https://ui.fuz.dev/)
 
-fuz_ui is a [Svelte](https://svelte.dev/) UI library
-with components and helpers for making zippy websites.
-It's in early alpha and it will go through many breaking changes.
+fuz_ui is a Svelte UI library with components and helpers for making zippy
+websites. It's built on [fuz_css](https://css.fuz.dev/)
+and provides includes a documentation system built on
+[svelte-docinfo](https://svelte-docinfo.fuz.dev/).
+It's in early alpha with breaking changes ahead.
 
 fuz_ui is being made to support
 [my other projects](https://www.ryanatkn.com/)

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/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

@@ -14,6 +14,7 @@
 		logo_fuz_util,
 		logo_gro,
 		logo_fuz_docs,
+		logo_svelte_docinfo,
 		logo_fuz_app,
 	} from './logos.js';
 
@@ -39,6 +40,7 @@
 		{name: 'fuz_mastodon', url: 'https://mastodon.fuz.dev/', logo: logo_fuz_mastodon, description: 'Mastodon components and helpers for Svelte, SvelteKit, and Fuz', glyph: '🦣', color_class: 'color_d_50'},
 		{name: 'fuz_gitops', url: 'https://gitops.fuz.dev/', logo: logo_fuz_gitops, description: 'a tool for managing many repos', glyph: '🪄', color_class: 'color_a_50'},
 		{name: 'fuz_docs', url: 'https://docs.fuz.dev/', logo: logo_fuz_docs, description: 'AI-generated documentation and skills for the Fuz stack', glyph: '📜', color_class: 'color_i_50'},
+		{name: 'svelte-docinfo', url: 'https://svelte-docinfo.fuz.dev/', logo: logo_svelte_docinfo, description: 'static analysis for TypeScript and Svelte', glyph: '📜', color_class: 'color_i_50'},
 		{name: 'fuz_util', url: 'https://util.fuz.dev/', logo: logo_fuz_util, description: 'utility belt for JS', glyph: '🦕', color_class: 'color_f_50'},
 		{name: 'gro', url: 'https://github.com/fuzdev/gro', logo: logo_gro, description: 'task runner and toolkit extending SvelteKit', glyph: '🌰', color_class: 'color_f_50'},
 	];

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":"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"}
+{"version":3,"file":"ProjectLinks.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ProjectLinks.svelte"],"names":[],"mappings":"AA8EA,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/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/logos.d.ts

@@ -71,6 +71,13 @@ export declare const logo_fuz_docs: {
         d: string;
     }[];
 };
+export declare const logo_svelte_docinfo: {
+    label: string;
+    fill: string;
+    paths: {
+        d: string;
+    }[];
+};
 export declare const logo_fuz_template: {
     label: string;
     fill: string;

package/dist/logos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;CAIN,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;CAIT,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}
+{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;CAIN,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;CAIT,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,mBAAmB;;;;;;CAQb,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}

package/dist/logos.js

@@ -98,6 +98,15 @@ export const logo_fuz_docs = {
     fill: '#1ec3d2',
     paths: logo_fuz.paths,
 };
+export const logo_svelte_docinfo = {
+    label: 'a cyan scroll with curling ends',
+    fill: '#1ec3d2',
+    paths: [
+        {
+            d: 'M 83,80.28 c -9.75,-34.41 2.18,-52.33 -3.76,-70 -2.31,-7.66 -48.25,-12 -70.25,-6 -12,6 -10,24 4,24 6,0 5.51,-13.67 6,-18 0,0 -1.43,59.52 5.13,80.21 1.2,3.8 2.91,5.28 4,5.92 3.93,2.31 63.48,3.74 68.01,0.54 1.18,-0.84 3.11,-5.38 2.63,-8.75 -0.42,-2.94 -3.27,-5.78 -5.28,-6.26 -1.74,-0.41 -0.62,-0.79 -5.37,-0.59 C 77.2,81.96 71.49,85.44 47.57,84.25 41.58,84.09 11.04,79.77 64.12,56.73 51.2,46.21 46.99,49.36 37.77,43.13 37.39,42.87 55,45.85 66.37,56.98 -10.84,93.94 82.99,80.29 82.99,80.29 Z',
+        },
+    ],
+};
 export const logo_fuz_template = {
     label: 'a friendly orange pixelated spider facing you',
     fill: '#f4672f',

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.197.0",
+  "version": "0.198.1",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -104,7 +104,7 @@
     "prettier-plugin-svelte": "^3.5.1",
     "svelte": "^5.56.0",
     "svelte-check": "^4.4.8",
-    "svelte-docinfo": "^0.2.0",
+    "svelte-docinfo": "^0.2.1",
     "svelte2tsx": "^0.7.55",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",

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

@@ -112,6 +112,16 @@ export const logo_fuz_docs = {
 	paths: logo_fuz.paths,
 } satisfies SvgData;
 
+export const logo_svelte_docinfo = {
+	label: 'a cyan scroll with curling ends',
+	fill: '#1ec3d2',
+	paths: [
+		{
+			d: 'M 83,80.28 c -9.75,-34.41 2.18,-52.33 -3.76,-70 -2.31,-7.66 -48.25,-12 -70.25,-6 -12,6 -10,24 4,24 6,0 5.51,-13.67 6,-18 0,0 -1.43,59.52 5.13,80.21 1.2,3.8 2.91,5.28 4,5.92 3.93,2.31 63.48,3.74 68.01,0.54 1.18,-0.84 3.11,-5.38 2.63,-8.75 -0.42,-2.94 -3.27,-5.78 -5.28,-6.26 -1.74,-0.41 -0.62,-0.79 -5.37,-0.59 C 77.2,81.96 71.49,85.44 47.57,84.25 41.58,84.09 11.04,79.77 64.12,56.73 51.2,46.21 46.99,49.36 37.77,43.13 37.39,42.87 55,45.85 66.37,56.98 -10.84,93.94 82.99,80.29 82.99,80.29 Z',
+		},
+	],
+} satisfies SvgData;
+
 export const logo_fuz_template = {
 	label: 'a friendly orange pixelated spider facing you',
 	fill: '#f4672f',

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.
 	 */