@fuzdev/fuz_ui 0.191.0 → 0.191.2

package/dist/Alert.svelte

@@ -5,7 +5,7 @@
 	import {alert_status_options, type AlertStatus} from './alert.js';
 
 	/**
-	 * @see https://www.w3.org/WAI/ARIA/apg/patterns/alert/
+	 * @see {@link https://www.w3.org/WAI/ARIA/apg/patterns/alert/}
 	 *
 	 * @module
 	 */

package/dist/ContextmenuRootForSafariCompatibility.svelte

@@ -383,7 +383,7 @@
 	 * a longpress with movement below threshold.
 	 *
 	 * @param el - the Window or HTMLElement to attach touch listeners to
-	 * @returns Cleanup function to remove all event listeners
+	 * @returns cleanup function to remove all event listeners
 	 */
 	const touch_event_attachment = (el: HTMLElement | Window) => {
 		// touchstart and touchcancel don't call preventDefault, so they can be passive for better performance

package/dist/ProjectLinks.svelte

@@ -1,7 +1,8 @@
 <script lang="ts">
 	import Svg, {type SvgData} from './Svg.svelte';
 	import {
-		logo_fuz,
+		// TODO when fuz.dev is ready
+		// logo_fuz,
 		logo_fuz_ui,
 		logo_fuz_code,
 		logo_fuz_blog,
@@ -11,6 +12,8 @@
 		logo_fuz_css,
 		logo_fuz_util,
 		logo_gro,
+		logo_fuz_docs,
+		logo_fuz_app,
 	} from './logos.js';
 
 	// TODO refactor
@@ -26,14 +29,15 @@
 	// TODO ideally this wouldn't duplicate metadata like descriptions, but adding fuz_gitops to this repo is heavy
 	// prettier-ignore
 	const project_items: Array<ProjectItem> = [
-		{name: 'fuz_ui', url: 'https://ui.fuz.dev/', logo: logo_fuz_ui, description: 'Svelte UI library', glyph: '🧶', color_class: 'color_c_50'},
+		{name: 'fuz_app', url: 'https://app.fuz.dev/', logo: logo_fuz_app, description: 'fullstack app library', glyph: '🗝', color_class: 'color_j_50'},
 		{name: 'fuz_css', url: 'https://css.fuz.dev/', logo: logo_fuz_css, description: 'CSS framework and design system', glyph: '🌿', color_class: 'color_b_50'},
+		{name: 'fuz_ui', url: 'https://ui.fuz.dev/', logo: logo_fuz_ui, description: 'Svelte UI library', glyph: '🧶', color_class: 'color_c_50'},
 		{name: 'fuz_template', url: 'https://template.fuz.dev/', logo: logo_fuz_template, description: 'a static web app and Node library template with TypeScript, Svelte, SvelteKit, Vite, esbuild, Fuz, and Gro', glyph: '❄', color_class: 'color_h_50'},
-		{name: 'fuz_docs', url: 'https://docs.fuz.dev/', logo: logo_fuz, description: 'AI-generated documentation and skills for the Fuz stack', glyph: '❄', color_class: 'color_i_50'},
 		{name: 'fuz_code', url: 'https://code.fuz.dev/', logo: logo_fuz_code, description: 'syntax styling utilities and components for TypeScript, Svelte, SvelteKit', glyph: '🎨', color_class: 'color_g_50'},
 		{name: 'fuz_blog', url: 'https://blog.fuz.dev/', logo: logo_fuz_blog, description: 'blog software from scratch with SvelteKit', glyph: '🖊️', color_class: 'color_e_50'},
 		{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: '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":"AAsEA,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":"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"}

package/dist/analysis_context.d.ts

@@ -8,7 +8,7 @@
  *
  * Analysis functions follow a two-tier error model:
  *
- * **Accumulated (non-fatal)** - Collected in AnalysisContext, analysis continues:
+ * **Accumulated (non-fatal)** - Collected in `AnalysisContext`, analysis continues:
  * - Type resolution failures (complex generics, circular refs)
  * - Missing or unparseable JSDoc
  * - Individual member/prop extraction failures
@@ -44,6 +44,7 @@
  * ```
  *
  * @example
+ * ```ts
  * const ctx = new AnalysisContext();
  * // ... analysis functions add diagnostics via ctx.add(...)
  * if (ctx.has_errors()) {
@@ -51,6 +52,7 @@
  *     console.error(`${err.file}:${err.line}: ${err.message}`);
  *   }
  * }
+ * ```
  *
  * @module
  */
@@ -137,6 +139,7 @@ export type Diagnostic = TypeExtractionDiagnostic | SignatureAnalysisDiagnostic
  * report collected diagnostics.
  *
  * @example
+ * ```ts
  * const ctx = new AnalysisContext();
  * ts_analyze_module_exports(source_file, checker, options, ctx);
  * if (ctx.has_errors()) {
@@ -145,11 +148,12 @@ export type Diagnostic = TypeExtractionDiagnostic | SignatureAnalysisDiagnostic
  *     console.error(format_diagnostic(d));
  *   }
  * }
+ * ```
  */
 export declare class AnalysisContext {
     readonly diagnostics: Array<Diagnostic>;
     /**
-     * Add a diagnostic to the collection.
+     * Add a `Diagnostic` to the collection.
      */
     add(diagnostic: Diagnostic): void;
     /**
@@ -169,7 +173,7 @@ export declare class AnalysisContext {
      */
     warnings(): Array<Diagnostic>;
     /**
-     * Get diagnostics of a specific kind.
+     * Get diagnostics of a specific `DiagnosticKind`.
      */
     by_kind<K extends DiagnosticKind>(kind: K): Array<Extract<Diagnostic, {
         kind: K;
@@ -189,7 +193,7 @@ export interface FormatDiagnosticOptions {
  *
  * @param diagnostic - the diagnostic to format
  * @param options - formatting options
- * @returns Formatted string like './file.ts:10:5: error: message'
+ * @returns formatted string like './file.ts:10:5: error: message'
  */
 export declare const format_diagnostic: (diagnostic: Diagnostic, options?: FormatDiagnosticOptions) => string;
 //# sourceMappingURL=analysis_context.d.ts.map

package/dist/analysis_context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analysis_context.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/analysis_context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GACvB,wBAAwB,GACxB,2BAA2B,GAC3B,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC/D,IAAI,EAAE,wBAAwB,CAAC;IAC/B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IAClE,IAAI,EAAE,2BAA2B,CAAC;IAClC,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC5D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC3D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC9D,IAAI,EAAE,gBAAgB,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,wBAAwB,GACxB,2BAA2B,GAC3B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAAC;AAE3B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC3B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAM;IAE7C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIjC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAI3B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC;IAI7B;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE;QAAC,IAAI,EAAE,CAAC,CAAA;KAAC,CAAC,CAAC;CAGjF;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC7B,YAAY,UAAU,EACtB,UAAU,uBAAuB,KAC/B,MAeF,CAAC"}
+{"version":3,"file":"analysis_context.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/analysis_context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GACvB,wBAAwB,GACxB,2BAA2B,GAC3B,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC/D,IAAI,EAAE,wBAAwB,CAAC;IAC/B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IAClE,IAAI,EAAE,2BAA2B,CAAC;IAClC,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC5D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC3D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC9D,IAAI,EAAE,gBAAgB,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,wBAAwB,GACxB,2BAA2B,GAC3B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;IAC3B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAM;IAE7C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIjC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAI3B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC;IAI7B;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE;QAAC,IAAI,EAAE,CAAC,CAAA;KAAC,CAAC,CAAC;CAGjF;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC7B,YAAY,UAAU,EACtB,UAAU,uBAAuB,KAC/B,MAeF,CAAC"}

package/dist/analysis_context.js

@@ -8,7 +8,7 @@
  *
  * Analysis functions follow a two-tier error model:
  *
- * **Accumulated (non-fatal)** - Collected in AnalysisContext, analysis continues:
+ * **Accumulated (non-fatal)** - Collected in `AnalysisContext`, analysis continues:
  * - Type resolution failures (complex generics, circular refs)
  * - Missing or unparseable JSDoc
  * - Individual member/prop extraction failures
@@ -44,6 +44,7 @@
  * ```
  *
  * @example
+ * ```ts
  * const ctx = new AnalysisContext();
  * // ... analysis functions add diagnostics via ctx.add(...)
  * if (ctx.has_errors()) {
@@ -51,6 +52,7 @@
  *     console.error(`${err.file}:${err.line}: ${err.message}`);
  *   }
  * }
+ * ```
  *
  * @module
  */
@@ -62,6 +64,7 @@
  * report collected diagnostics.
  *
  * @example
+ * ```ts
  * const ctx = new AnalysisContext();
  * ts_analyze_module_exports(source_file, checker, options, ctx);
  * if (ctx.has_errors()) {
@@ -70,11 +73,12 @@
  *     console.error(format_diagnostic(d));
  *   }
  * }
+ * ```
  */
 export class AnalysisContext {
     diagnostics = [];
     /**
-     * Add a diagnostic to the collection.
+     * Add a `Diagnostic` to the collection.
      */
     add(diagnostic) {
         this.diagnostics.push(diagnostic);
@@ -104,7 +108,7 @@ export class AnalysisContext {
         return this.diagnostics.filter((d) => d.severity === 'warning');
     }
     /**
-     * Get diagnostics of a specific kind.
+     * Get diagnostics of a specific `DiagnosticKind`.
      */
     by_kind(kind) {
         return this.diagnostics.filter((d) => d.kind === kind);
@@ -115,7 +119,7 @@ export class AnalysisContext {
  *
  * @param diagnostic - the diagnostic to format
  * @param options - formatting options
- * @returns Formatted string like './file.ts:10:5: error: message'
+ * @returns formatted string like './file.ts:10:5: error: message'
  */
 export const format_diagnostic = (diagnostic, options) => {
     const prefix = options?.prefix ?? './';

package/dist/contextmenu_state.svelte.d.ts

@@ -56,10 +56,10 @@ export interface ContextmenuStateOptions {
     layout?: Dimensions;
 }
 /**
- * Creates a `contextmenu` store.
+ * Creates a contextmenu store.
  * See usage with `ContextmenuRoot.svelte` and `Contextmenu.svelte`.
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event}
  */
 export declare class ContextmenuState {
     layout: Dimensions;
@@ -97,7 +97,7 @@ export declare class ContextmenuState {
     select_first(): void;
     select_last(): void;
     /**
-     * Used by `ContextmenuEntry` and custom entry components
+     * Used by `ContextmenuEntry.svelte` and custom entry components.
      * @initializes
      */
     add_entry(run: () => ContextmenuRun, disabled?: () => boolean): EntryState;

package/dist/contextmenu_state.svelte.js

@@ -38,10 +38,10 @@ export class RootMenuState {
     items = $state.raw([]);
 }
 /**
- * Creates a `contextmenu` store.
+ * Creates a contextmenu store.
  * See usage with `ContextmenuRoot.svelte` and `Contextmenu.svelte`.
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event}
  */
 export class ContextmenuState {
     layout; // TODO $state?
@@ -262,7 +262,7 @@ export class ContextmenuState {
         this.select(items.at(-1));
     }
     /**
-     * Used by `ContextmenuEntry` and custom entry components
+     * Used by `ContextmenuEntry.svelte` and custom entry components.
      * @initializes
      */
     add_entry(run, disabled = () => false) {

package/dist/csp.d.ts

@@ -50,7 +50,7 @@ export declare const parse_csp_directive: (directive: unknown) => CspDirective |
 export type CspDirectiveValue<T extends CspDirective> = Defined<CspDirectives[T]>;
 export declare const csp_trust_levels: readonly ["low", "medium", "high"];
 /**
- * Numeric values for CSP trust levels, `csp_trust_levels`.
+ * Numeric values for CSP trust levels. See `csp_trust_levels`.
  * Lower is less trusted.
  * Includes `undefined` in the type for safety.
  */
@@ -98,7 +98,7 @@ export declare const COLOR_SCHEME_SCRIPT_HASH = "sha256-QOxqn7EUzb3ydF9SALJoJGWS
 /**
  * The base CSP directive defaults.
  * Prioritizes safety but loosens around media and styles, relying on defense-in-depth.
- * Customizable via `CreateCspDirectivesOptions.defaults`.
+ * Customizable via `CreateCspDirectivesOptions`.
  */
 export declare const csp_directive_value_defaults: Record<CspDirective, CspDirectiveValue<CspDirective> | null>;
 /**
@@ -114,9 +114,9 @@ export declare const csp_directive_required_trust_defaults: Record<CspDirective,
  * Fuz excludes deprecated directives, so those are intentionally omitted,
  * but any newer missing directives are bugs.
  *
- * Could be moved to `csp.ts` but is currently here to keep that module smaller.
+ * Could be co-located but is currently here to keep that module smaller.
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy}
  */
 export declare const csp_directive_specs: Array<CspDirectiveSpec>;
 export declare const csp_directive_spec_by_name: Map<CspDirective, CspDirectiveSpec>;

package/dist/csp.js

@@ -104,7 +104,7 @@ export const parse_csp_directive = (directive) => typeof directive === 'string'
     : null;
 export const csp_trust_levels = ['low', 'medium', 'high'];
 /**
- * Numeric values for CSP trust levels, `csp_trust_levels`.
+ * Numeric values for CSP trust levels. See `csp_trust_levels`.
  * Lower is less trusted.
  * Includes `undefined` in the type for safety.
  */
@@ -144,7 +144,7 @@ export const COLOR_SCHEME_SCRIPT_HASH = 'sha256-QOxqn7EUzb3ydF9SALJoJGWSvywW9R0A
 /**
  * The base CSP directive defaults.
  * Prioritizes safety but loosens around media and styles, relying on defense-in-depth.
- * Customizable via `CreateCspDirectivesOptions.defaults`.
+ * Customizable via `CreateCspDirectivesOptions`.
  */
 export const csp_directive_value_defaults = {
     'default-src': ['none'],
@@ -210,9 +210,9 @@ export const csp_directive_required_trust_defaults = {
  * Fuz excludes deprecated directives, so those are intentionally omitted,
  * but any newer missing directives are bugs.
  *
- * Could be moved to `csp.ts` but is currently here to keep that module smaller.
+ * Could be co-located but is currently here to keep that module smaller.
  *
- * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Security-Policy}
  */
 export const csp_directive_specs = [
     {

package/dist/docs_helpers.svelte.d.ts

@@ -4,7 +4,7 @@ import { SvelteMap, SvelteSet } from 'svelte/reactivity';
  * Unlike `slugify` from `@fuzdev/fuz_util/path.js` which lowercases,
  * this keeps the original casing so API declarations like `AsyncStatus`
  * and `async_status` produce distinct fragment IDs.
- * Used by the Tome documentation system for heading and section anchors.
+ * Used by the `Tome` documentation system for heading and section anchors.
  * @param str - the string to convert to a fragment
  * @returns a URL-safe fragment identifier with case preserved
  */

package/dist/docs_helpers.svelte.js

@@ -7,7 +7,7 @@ import { create_context } from './context_helpers.js';
  * Unlike `slugify` from `@fuzdev/fuz_util/path.js` which lowercases,
  * this keeps the original casing so API declarations like `AsyncStatus`
  * and `async_status` produce distinct fragment IDs.
- * Used by the Tome documentation system for heading and section anchors.
+ * Used by the `Tome` documentation system for heading and section anchors.
  * @param str - the string to convert to a fragment
  * @returns a URL-safe fragment identifier with case preserved
  */

package/dist/library.svelte.d.ts

@@ -9,10 +9,10 @@ export declare const parse_library_url_prefix: (value: unknown) => string;
  * Rich runtime representation of a library.
  *
  * Wraps `LibraryJson` with computed properties and provides the root
- * of the API documentation hierarchy: Library → modules → declarations
+ * of the API documentation hierarchy: `Library` → `Module` → `Declaration`.
  *
- * @see module.svelte.ts for Module class
- * @see declaration.svelte.ts for Declaration class
+ * @see `module.svelte.ts` for `Module` class
+ * @see `declaration.svelte.ts` for `Declaration` class
  */
 export declare class Library {
     readonly library_json: LibraryJson;
@@ -177,7 +177,7 @@ export declare class Library {
      */
     readonly org_url: string | null;
     /**
-     * All modules as rich Module instances.
+     * All modules as rich `Module` instances.
      */
     readonly modules: Module[];
     /**

package/dist/library.svelte.js

@@ -14,10 +14,10 @@ export const parse_library_url_prefix = (value) => {
  * Rich runtime representation of a library.
  *
  * Wraps `LibraryJson` with computed properties and provides the root
- * of the API documentation hierarchy: Library → modules → declarations
+ * of the API documentation hierarchy: `Library` → `Module` → `Declaration`.
  *
- * @see module.svelte.ts for Module class
- * @see declaration.svelte.ts for Declaration class
+ * @see `module.svelte.ts` for `Module` class
+ * @see `declaration.svelte.ts` for `Declaration` class
  */
 export class Library {
     library_json = $state.raw();
@@ -48,7 +48,7 @@ export class Library {
             : null
         : null);
     /**
-     * All modules as rich Module instances.
+     * All modules as rich `Module` instances.
      */
     modules = $derived(this.source_json.modules
         ? this.source_json.modules.map((module_json) => new Module(this, module_json))

package/dist/library_analysis.d.ts

@@ -36,9 +36,9 @@
  * }
  * ```
  *
- * @see ts_helpers.ts for TypeScript-specific analysis
- * @see svelte_helpers.ts for Svelte component analysis
- * @see module_helpers.ts for path utilities and SourceFileInfo
+ * @see `ts_helpers.ts` for TypeScript-specific analysis
+ * @see `svelte_helpers.ts` for Svelte component analysis
+ * @see `module_helpers.ts` for path utilities and `SourceFileInfo`
  *
  * @module
  */
@@ -54,7 +54,7 @@ import type { AnalysisContext } from './analysis_context.js';
 export interface DeclarationAnalysis {
     /** The analyzed declaration metadata. */
     declaration: DeclarationJson;
-    /** Whether the declaration is marked @nodocs (should be excluded from documentation). */
+    /** Whether the declaration is marked `@nodocs` (should be excluded from documentation). */
     nodocs: boolean;
 }
 /**
@@ -106,7 +106,7 @@ export interface ModuleAnalysis {
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
  * @param log - optional logger for warnings
- * @returns Module metadata and re-exports, or undefined if source file not found in program
+ * @returns module metadata and re-exports, or undefined if source file not found in program
  */
 export declare const library_analyze_module: (source_file: SourceFileInfo, program: ts.Program, options: ModuleSourceOptions, ctx: AnalysisContext, log?: Logger) => ModuleAnalysis | undefined;
 //# sourceMappingURL=library_analysis.d.ts.map

package/dist/library_analysis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_analysis.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAIrE,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,yCAAyC;IACzC,WAAW,EAAE,eAAe,CAAC;IAC7B,yFAAyF;IACzF,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,YAAY,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,8EAA8E;IAC9E,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,gFAAgF;IAChF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,0EAA0E;IAC1E,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,GAClC,aAAa,cAAc,EAC3B,SAAS,EAAE,CAAC,OAAO,EACnB,SAAS,mBAAmB,EAC5B,KAAK,eAAe,EACpB,MAAM,MAAM,KACV,cAAc,GAAG,SAuCnB,CAAC"}
+{"version":3,"file":"library_analysis.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAIrE,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,yCAAyC;IACzC,WAAW,EAAE,eAAe,CAAC;IAC7B,2FAA2F;IAC3F,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,YAAY,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,8EAA8E;IAC9E,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,gFAAgF;IAChF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,0EAA0E;IAC1E,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,GAClC,aAAa,cAAc,EAC3B,SAAS,EAAE,CAAC,OAAO,EACnB,SAAS,mBAAmB,EAC5B,KAAK,eAAe,EACpB,MAAM,MAAM,KACV,cAAc,GAAG,SAuCnB,CAAC"}

package/dist/library_analysis.js

@@ -36,9 +36,9 @@
  * }
  * ```
  *
- * @see ts_helpers.ts for TypeScript-specific analysis
- * @see svelte_helpers.ts for Svelte component analysis
- * @see module_helpers.ts for path utilities and SourceFileInfo
+ * @see `ts_helpers.ts` for TypeScript-specific analysis
+ * @see `svelte_helpers.ts` for Svelte component analysis
+ * @see `module_helpers.ts` for path utilities and `SourceFileInfo`
  *
  * @module
  */
@@ -65,7 +65,7 @@ import { module_extract_path, } from './module_helpers.js';
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
  * @param log - optional logger for warnings
- * @returns Module metadata and re-exports, or undefined if source file not found in program
+ * @returns module metadata and re-exports, or undefined if source file not found in program
  */
 export const library_analyze_module = (source_file, program, options, ctx, log) => {
     const checker = program.getTypeChecker();

package/dist/library_gen.d.ts

@@ -7,9 +7,9 @@
  *
  * For build-tool agnostic usage, see `library_generate.ts`.
  *
- * @see library_generate.ts for the generic generation entry point
- * @see library_pipeline.ts for pipeline helpers
- * @see library_output.ts for output file generation
+ * @see `library_generate.ts` for the generic generation entry point
+ * @see `library_pipeline.ts` for pipeline helpers
+ * @see `library_output.ts` for output file generation
  *
  * @module
  */
@@ -34,6 +34,7 @@ export interface LibraryGenOptions {
      * Use `library_throw_on_duplicates` for strict flat namespace enforcement.
      *
      * @example
+     * ```ts
      * // Throw on duplicates (strict flat namespace)
      * library_gen({ on_duplicates: library_throw_on_duplicates });
      *
@@ -45,11 +46,12 @@ export interface LibraryGenOptions {
      *     }
      *   }
      * });
+     * ```
      */
     on_duplicates?: OnDuplicatesCallback;
 }
 /**
- * Convert Gro's Disknode to the build-tool agnostic SourceFileInfo interface.
+ * Convert Gro's `Disknode` to the build-tool agnostic `SourceFileInfo` interface.
  *
  * Use this when you want to analyze files using Gro's filer directly.
  *
@@ -57,7 +59,7 @@ export interface LibraryGenOptions {
  */
 export declare const source_file_from_disknode: (disknode: Disknode) => SourceFileInfo;
 /**
- * Collect source files from Gro disknodes, filtering BEFORE conversion to SourceFileInfo.
+ * Collect source files from Gro disknodes, filtering BEFORE conversion to `SourceFileInfo`.
  *
  * This avoids errors from files outside source directories (like test fixtures that may
  * have malformed paths or missing content). The filtering uses `module_is_source` which
@@ -72,12 +74,12 @@ export declare const library_collect_source_files_from_disknodes: (disknodes: It
     warn: (...args: Array<unknown>) => void;
 }) => Array<SourceFileInfo>;
 /**
- * Creates a Gen object for generating library metadata with full TypeScript analysis.
+ * Creates a `Gen` object for generating library metadata with full TypeScript analysis.
  *
  * This is the Gro-specific entry point. It handles:
  * - Reading files from Gro's filer
- * - Loading package.json via Gro utilities
- * - Returning output in Gro's Gen format
+ * - Loading `package.json` via Gro utilities
+ * - Returning output in Gro's `Gen` format
  *
  * For build-tool agnostic usage, use `library_generate` directly.
  *

package/dist/library_gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_gen.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAKxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAmB,KAAK,oBAAoB,EAAC,MAAM,uBAAuB,CAAC;AAElF,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,QAAQ,KAAG,cAY9D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2CAA2C,GACvD,WAAW,QAAQ,CAAC,QAAQ,CAAC,EAC7B,SAAS,mBAAmB,EAC5B,MAAM;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CAAC,KACtF,KAAK,CAAC,cAAc,CA6BtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,GA2CzD,CAAC"}
+{"version":3,"file":"library_gen.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,aAAa,CAAC;AAErC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAKxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAmB,KAAK,oBAAoB,EAAC,MAAM,uBAAuB,CAAC;AAElF,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IACjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,UAAU,QAAQ,KAAG,cAY9D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2CAA2C,GACvD,WAAW,QAAQ,CAAC,QAAQ,CAAC,EAC7B,SAAS,mBAAmB,EAC5B,MAAM;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;CAAC,KACtF,KAAK,CAAC,cAAc,CA6BtB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,GA2CzD,CAAC"}

package/dist/library_gen.js

@@ -7,9 +7,9 @@
  *
  * For build-tool agnostic usage, see `library_generate.ts`.
  *
- * @see library_generate.ts for the generic generation entry point
- * @see library_pipeline.ts for pipeline helpers
- * @see library_output.ts for output file generation
+ * @see `library_generate.ts` for the generic generation entry point
+ * @see `library_pipeline.ts` for pipeline helpers
+ * @see `library_output.ts` for output file generation
  *
  * @module
  */
@@ -17,7 +17,7 @@ import { package_json_load } from '@fuzdev/gro/package_json.js';
 import { module_create_source_options, module_validate_source_options, module_is_source, module_get_source_root, } from './module_helpers.js';
 import { library_generate } from './library_generate.js';
 /**
- * Convert Gro's Disknode to the build-tool agnostic SourceFileInfo interface.
+ * Convert Gro's `Disknode` to the build-tool agnostic `SourceFileInfo` interface.
  *
  * Use this when you want to analyze files using Gro's filer directly.
  *
@@ -35,7 +35,7 @@ export const source_file_from_disknode = (disknode) => {
     };
 };
 /**
- * Collect source files from Gro disknodes, filtering BEFORE conversion to SourceFileInfo.
+ * Collect source files from Gro disknodes, filtering BEFORE conversion to `SourceFileInfo`.
  *
  * This avoids errors from files outside source directories (like test fixtures that may
  * have malformed paths or missing content). The filtering uses `module_is_source` which
@@ -70,12 +70,12 @@ export const library_collect_source_files_from_disknodes = (disknodes, options,
     return source_files;
 };
 /**
- * Creates a Gen object for generating library metadata with full TypeScript analysis.
+ * Creates a `Gen` object for generating library metadata with full TypeScript analysis.
  *
  * This is the Gro-specific entry point. It handles:
  * - Reading files from Gro's filer
- * - Loading package.json via Gro utilities
- * - Returning output in Gro's Gen format
+ * - Loading `package.json` via Gro utilities
+ * - Returning output in Gro's `Gen` format
  *
  * For build-tool agnostic usage, use `library_generate` directly.
  *

package/dist/library_generate.d.ts

@@ -12,9 +12,9 @@
  * - Dependency graphs
  * - Svelte component props
  *
- * For Gro integration, see `library_gen.ts` which wraps this with Gro's Gen interface.
+ * For Gro integration, see `library_gen.ts` which wraps this with Gro's `Gen` interface.
  *
- * @see @fuzdev/fuz_util/source_json.js for type definitions
+ * @see `@fuzdev/fuz_util/source_json.js` for type definitions
  * @see `library_analysis.ts` for the unified analysis entry point
  * @see `library_pipeline.ts` for pipeline helpers
  * @see `library_output.ts` for JSON/TS file generation

package/dist/library_generate.js

@@ -12,9 +12,9 @@
  * - Dependency graphs
  * - Svelte component props
  *
- * For Gro integration, see `library_gen.ts` which wraps this with Gro's Gen interface.
+ * For Gro integration, see `library_gen.ts` which wraps this with Gro's `Gen` interface.
  *
- * @see @fuzdev/fuz_util/source_json.js for type definitions
+ * @see `@fuzdev/fuz_util/source_json.js` for type definitions
  * @see `library_analysis.ts` for the unified analysis entry point
  * @see `library_pipeline.ts` for pipeline helpers
  * @see `library_output.ts` for JSON/TS file generation

package/dist/library_helpers.d.ts

@@ -20,7 +20,7 @@ export declare const url_api_declaration: (declaration_name: string) => string;
  *
  * @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'
+ * @returns full URL like 'https://example.com/docs/api#declaration_name'
  */
 export declare const url_api_declaration_full: (homepage: string, declaration_name: string) => string;
 /**
@@ -35,7 +35,7 @@ export declare const url_api_module: (module_path: string) => string;
  *
  * @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
+ * @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;
 /**
@@ -45,12 +45,14 @@ export declare const url_package_logo: (homepage_url: string | null, logo_path?:
  *
  * @param url - full URL to convert
  * @param origin - origin to strip (defaults to current page origin)
- * @returns Root-relative URL starting with '/'
+ * @returns root-relative URL starting with '/'
  *
  * @example
+ * ```ts
  * // Assuming page.url.origin is 'https://example.com'
  * url_to_root_relative('https://example.com/docs/api')
  * // => '/docs/api'
+ * ```
  */
 export declare const url_to_root_relative: (url: string, origin?: string) => string;
 //# sourceMappingURL=library_helpers.d.ts.map

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;;;;;;;;;;;;;GAaG;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;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"}