@fuzdev/fuz_ui 0.197.0 → 0.198.0

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

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

package/dist/library_helpers.d.ts.map

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

package/dist/library_helpers.js

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

package/dist/module.svelte.d.ts

@@ -38,6 +38,13 @@ export declare class Module {
      * API documentation URL for this module.
      */
     url_api: string;
+    /**
+     * Public documentation link (if `homepage_url` is available).
+     *
+     * Absolute URL into the library's own deployed docs, for rendering a
+     * foreign library's modules on a different site (e.g. an aggregator).
+     */
+    url_api_full: string | undefined;
     /**
      * GitHub source URL.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAGjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;OAEG;IACH,UAAU,qBAIR;IAEF,gBAAgB,EAAE,OAAO,CAA8D;IAEvF,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;gBAE7C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}
+{"version":3,"file":"module.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/module.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAGjD;;;;;;;;GAQG;AACH,qBAAa,MAAM;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAiB;IAK1C,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAiB;IAEtD;;;;;;;;;;OAUG;IACH,IAAI,SAAmC;IAEvC;;OAEG;IACH,WAAW,SAA8B;IAEzC,cAAc,qBAA4C;IAE1D;;OAEG;IACH,YAAY,gBAIV;IAEF;;OAEG;IACH,OAAO,SAAgE;IAEvE;;;;;OAKG;IACH,YAAY,qBAIV;IAEF;;OAEG;IACH,UAAU,qBAIR;IAEF,gBAAgB,EAAE,OAAO,CAA8D;IAEvF,kBAAkB,EAAE,OAAO,CAAmC;IAE9D;;OAEG;IACH,YAAY,WAAiD;IAE7D;;OAEG;IACH,UAAU,WAA+C;gBAE7C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe;IAK1D;;OAEG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;CAG9D"}

package/dist/module.svelte.js

@@ -43,6 +43,15 @@ export class Module {
      * API documentation URL for this module.
      */
     url_api = $derived(`/docs/api${this.library.url_prefix}/${this.path}`);
+    /**
+     * Public documentation link (if `homepage_url` is available).
+     *
+     * Absolute URL into the library's own deployed docs, for rendering a
+     * foreign library's modules on a different site (e.g. an aggregator).
+     */
+    url_api_full = $derived(this.library.homepage_url
+        ? `${this.library.homepage_url.replace(/\/$/, '')}/docs/api/${this.path}`
+        : undefined);
     /**
      * GitHub source URL.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.197.0",
+  "version": "0.198.0",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",

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