@fuzdev/fuz_ui 0.191.0 → 0.191.1

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,7 @@
 		logo_fuz_css,
 		logo_fuz_util,
 		logo_gro,
+		logo_fuz_docs,
 	} from './logos.js';
 
 	// TODO refactor
@@ -29,11 +31,11 @@
 		{name: 'fuz_ui', url: 'https://ui.fuz.dev/', logo: logo_fuz_ui, description: 'Svelte UI library', glyph: '🧶', color_class: 'color_c_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_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":"AAwEA,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

@@ -189,7 +189,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.js

@@ -115,7 +115,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/library_analysis.d.ts

@@ -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.js

@@ -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_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,7 +45,7 @@ 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
  * // Assuming page.url.origin is 'https://example.com'

package/dist/library_helpers.js

@@ -23,7 +23,7 @@ export const url_api_declaration = (declaration_name) => `${DOCS_API_PATH}#${enc
  *
  * @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 const url_api_declaration_full = (homepage, declaration_name) => `${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
 /**
@@ -38,7 +38,7 @@ export const url_api_module = (module_path) => `${DOCS_API_PATH}/${module_path}`
  *
  * @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 const url_package_logo = (homepage_url, logo_path) => {
     if (!homepage_url)
@@ -53,7 +53,7 @@ export const url_package_logo = (homepage_url, 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
  * // Assuming page.url.origin is 'https://example.com'

package/dist/logos.d.ts

@@ -57,6 +57,13 @@ export declare const logo_fuz_gitops: {
         d: string;
     }[];
 };
+export declare const logo_fuz_docs: {
+    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,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,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,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,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,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"}

package/dist/logos.js

@@ -88,6 +88,11 @@ export const logo_fuz_gitops = {
     fill: '#6199d1',
     paths: logo_fuz.paths,
 };
+export const logo_fuz_docs = {
+    label: 'a friendly cyan spider facing you',
+    fill: '#1ec3d2',
+    paths: logo_fuz.paths,
+};
 export const logo_fuz_template = {
     label: 'a friendly orange pixelated spider facing you',
     fill: '#f4672f',

package/dist/mdz.js

@@ -627,7 +627,7 @@ export class MdzParser {
     /**
      * Restore previously saved text accumulation state.
      * Used to restore parent state when exiting nested structure parsing.
-     * @param state - State object returned from `#save_accumulation_state()`
+     * @param state - state object returned from `#save_accumulation_state()`
      */
     #restore_accumulation_state(state) {
         this.#accumulated_text = state.accumulated_text;
@@ -640,9 +640,9 @@ export class MdzParser {
      * Word boundary = not surrounded by word characters (A-Z, a-z, 0-9).
      * Used to prevent intraword emphasis for underscores and tildes.
      *
-     * @param index - Position to check
-     * @param check_before - Whether to check the character before this position
-     * @param check_after - Whether to check the character after this position
+     * @param index - position to check
+     * @param check_before - whether to check the character before this position
+     * @param check_after - whether to check the character after this position
      */
     #is_at_word_boundary(index, check_before, check_after) {
         if (check_before && index > 0) {
@@ -832,9 +832,9 @@ export class MdzParser {
      * - Paragraph break (double newline) is encountered (allows block elements to interrupt inline formatting)
      * - `end_index` boundary is reached
      *
-     * @param delimiter - The delimiter string to stop at (e.g., '**', '_', ']')
-     * @param end_index - Optional maximum index to parse up to (for greedy/bounded parsing)
-     * @returns Array of parsed nodes (may be empty if delimiter found immediately)
+     * @param delimiter - the delimiter string to stop at (e.g., '**', '_', ']')
+     * @param end_index - optional maximum index to parse up to (for greedy/bounded parsing)
+     * @returns array of parsed nodes (may be empty if delimiter found immediately)
      */
     #parse_nodes_until(delimiter, end_index) {
         const nodes = [];

package/dist/mdz_helpers.d.ts

@@ -123,9 +123,9 @@ export declare const mdz_is_url: (s: string) => boolean;
  * (e.g., `'./a/../b'` → navigates up then down).
  * Clamps at root — excess `..` segments stop at `/` rather than escaping.
  *
- * @param reference - a relative path starting with `./` or `../`.
- * @param base - an absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ * @param reference - a relative path starting with `./` or `../`
+ * @param base - An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns an absolute resolved path (e.g., `'/docs/mdz/grammar'`)
  */
 export declare const resolve_relative_path: (reference: string, base: string) => string;
 export declare const extract_single_tag: (nodes: Array<MdzNode>) => MdzComponentNode | MdzElementNode | null;

package/dist/mdz_helpers.js

@@ -243,9 +243,9 @@ export const mdz_is_url = (s) => URL_PATTERN.test(s);
  * (e.g., `'./a/../b'` → navigates up then down).
  * Clamps at root — excess `..` segments stop at `/` rather than escaping.
  *
- * @param reference - a relative path starting with `./` or `../`.
- * @param base - an absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ * @param reference - a relative path starting with `./` or `../`
+ * @param base - An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns an absolute resolved path (e.g., `'/docs/mdz/grammar'`)
  */
 export const resolve_relative_path = (reference, base) => {
     const segments = base.split('/');

package/dist/mdz_to_svelte.d.ts

@@ -28,12 +28,12 @@ export interface MdzToSvelteResult {
  * Each node type produces output matching what `MdzNodeView.svelte` renders at runtime.
  * Collects required imports and flags unconfigured component/element references.
  *
- * @param nodes - parsed mdz nodes to render.
- * @param components - component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`).
+ * @param nodes - parsed mdz nodes to render
+ * @param components - Component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`)
  *   If content references a component not in this map, `has_unconfigured_tags` is set.
- * @param elements - allowed HTML element names (e.g., `new Set(['aside', 'details'])`).
+ * @param elements - Allowed HTML element names (e.g., `new Set(['aside', 'details'])`)
  *   If content references an element not in this set, `has_unconfigured_tags` is set.
- * @param base - base path for resolving relative links (e.g., `'/docs/mdz/'`).
+ * @param base - Base path for resolving relative links (e.g., `'/docs/mdz/'`)
  *   When provided, relative references (`./`, `../`) are resolved to absolute paths
  *   and passed through `resolve()`. Trailing slash recommended.
  */

package/dist/mdz_to_svelte.js

@@ -17,12 +17,12 @@ import { resolve_relative_path } from './mdz_helpers.js';
  * Each node type produces output matching what `MdzNodeView.svelte` renders at runtime.
  * Collects required imports and flags unconfigured component/element references.
  *
- * @param nodes - parsed mdz nodes to render.
- * @param components - component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`).
+ * @param nodes - parsed mdz nodes to render
+ * @param components - Component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`)
  *   If content references a component not in this map, `has_unconfigured_tags` is set.
- * @param elements - allowed HTML element names (e.g., `new Set(['aside', 'details'])`).
+ * @param elements - Allowed HTML element names (e.g., `new Set(['aside', 'details'])`)
  *   If content references an element not in this set, `has_unconfigured_tags` is set.
- * @param base - base path for resolving relative links (e.g., `'/docs/mdz/'`).
+ * @param base - Base path for resolving relative links (e.g., `'/docs/mdz/'`)
  *   When provided, relative references (`./`, `../`) are resolved to absolute paths
  *   and passed through `resolve()`. Trailing slash recommended.
  */

package/dist/module_helpers.d.ts

@@ -307,7 +307,7 @@ export declare const module_is_test: (path: string) => boolean;
  *
  * @param path - full absolute path to check
  * @param options - module source options for filtering
- * @returns True if the path is an analyzable source file
+ * @returns true if the path is an analyzable source file
  *
  * @example
  * ```ts

package/dist/module_helpers.js

@@ -256,7 +256,7 @@ export const module_is_test = (path) => path.endsWith('.test.ts');
  *
  * @param path - full absolute path to check
  * @param options - module source options for filtering
- * @returns True if the path is an analyzable source file
+ * @returns true if the path is an analyzable source file
  *
  * @example
  * ```ts

package/dist/package_helpers.d.ts

@@ -27,7 +27,7 @@ import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param file_path - path to the file (leading './' is stripped)
  * @param line - optional line number for deep linking
- * @returns Full GitHub URL to the file on the main branch
+ * @returns full GitHub URL to the file on the main branch
  *
  * @example
  * ```ts
@@ -47,7 +47,7 @@ export declare const url_github_file: (repo_url: string, file_path: string, line
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param repo_name - repository name to strip from the URL
- * @returns Organization URL, or null if repo_url doesn't end with repo_name
+ * @returns organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
  * ```ts
@@ -60,7 +60,7 @@ export declare const url_github_org: (repo_url: string, repo_name: string) => st
  * Extract GitHub owner/org name from repository URL.
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
- * @returns Owner name, or null if not a valid GitHub URL
+ * @returns owner name, or null if not a valid GitHub URL
  *
  * @example
  * ```ts
@@ -79,7 +79,7 @@ export declare const repo_url_github_owner: (repo_url: string) => string | null;
  * Build npm package URL.
  *
  * @param package_name - package name (can be scoped like '@org/package')
- * @returns Full npm package page URL
+ * @returns full npm package page URL
  *
  * @example
  * ```ts
@@ -97,14 +97,14 @@ export declare const url_npm_package: (package_name: string) => string;
  * - Its version is not the initial '0.0.1'
  *
  * @param package_json - the package.json object to check
- * @returns True if the package appears to be published
+ * @returns `true` if the package appears to be published
  */
 export declare const package_is_published: (package_json: PackageJson) => boolean;
 /**
  * Extract repository name without scope from package name.
  *
  * @param name - package name (can be scoped like '@org/package')
- * @returns Repository name without scope
+ * @returns repository name without scope
  * @throws Error if scoped package name is malformed
  *
  * @example
@@ -127,7 +127,7 @@ export declare const repo_name_parse: (name: string) => string;
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
  * @param repository - the repository field from package.json
- * @returns Clean repository URL, or null if not provided
+ * @returns clean repository URL, or null if not provided
  *
  * @example
  * ```ts
@@ -153,7 +153,7 @@ export declare const repo_url_parse: (repository: PackageJson["repository"]) =>
  *
  * @param homepage_url - package homepage URL
  * @param filename - filename in .well-known directory
- * @returns Full URL to the .well-known file
+ * @returns full URL to the .well-known file
  *
  * @example
  * ```ts

package/dist/package_helpers.js

@@ -27,7 +27,7 @@ import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param file_path - path to the file (leading './' is stripped)
  * @param line - optional line number for deep linking
- * @returns Full GitHub URL to the file on the main branch
+ * @returns full GitHub URL to the file on the main branch
  *
  * @example
  * ```ts
@@ -51,7 +51,7 @@ export const url_github_file = (repo_url, file_path, line) => {
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param repo_name - repository name to strip from the URL
- * @returns Organization URL, or null if repo_url doesn't end with repo_name
+ * @returns organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
  * ```ts
@@ -66,7 +66,7 @@ export const url_github_org = (repo_url, repo_name) => {
  * Extract GitHub owner/org name from repository URL.
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
- * @returns Owner name, or null if not a valid GitHub URL
+ * @returns owner name, or null if not a valid GitHub URL
  *
  * @example
  * ```ts
@@ -91,7 +91,7 @@ export const repo_url_github_owner = (repo_url) => {
  * Build npm package URL.
  *
  * @param package_name - package name (can be scoped like '@org/package')
- * @returns Full npm package page URL
+ * @returns full npm package page URL
  *
  * @example
  * ```ts
@@ -109,7 +109,7 @@ export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/
  * - Its version is not the initial '0.0.1'
  *
  * @param package_json - the package.json object to check
- * @returns True if the package appears to be published
+ * @returns `true` if the package appears to be published
  */
 export const package_is_published = (package_json) => {
     return !package_json.private && !!package_json.exports && package_json.version !== '0.0.1';
@@ -118,7 +118,7 @@ export const package_is_published = (package_json) => {
  * Extract repository name without scope from package name.
  *
  * @param name - package name (can be scoped like '@org/package')
- * @returns Repository name without scope
+ * @returns repository name without scope
  * @throws Error if scoped package name is malformed
  *
  * @example
@@ -150,7 +150,7 @@ export const repo_name_parse = (name) => {
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
  * @param repository - the repository field from package.json
- * @returns Clean repository URL, or null if not provided
+ * @returns clean repository URL, or null if not provided
  *
  * @example
  * ```ts
@@ -183,7 +183,7 @@ export const repo_url_parse = (repository) => {
  *
  * @param homepage_url - package homepage URL
  * @param filename - filename in .well-known directory
- * @returns Full URL to the .well-known file
+ * @returns full URL to the .well-known file
  *
  * @example
  * ```ts

package/dist/storage.d.ts

@@ -7,7 +7,7 @@ export declare const save_to_storage: (key: string, value: any, is_json?: boolea
  * @param key - the localStorage key
  * @param is_json - whether to parse the value as JSON
  * @param parse_fn - optional custom parsing function to transform the value
- * @returns The parsed value or null if not found or parsing fails
+ * @returns the parsed value or null if not found or parsing fails
  */
 export declare const load_from_storage: <T>(key: string, is_json?: boolean, parse_fn?: (value: unknown) => T | null) => T | null;
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.js

@@ -20,7 +20,7 @@ export const save_to_storage = (key, value, is_json = false) => {
  * @param key - the localStorage key
  * @param is_json - whether to parse the value as JSON
  * @param parse_fn - optional custom parsing function to transform the value
- * @returns The parsed value or null if not found or parsing fails
+ * @returns the parsed value or null if not found or parsing fails
  */
 export const load_from_storage = (key, is_json = false, parse_fn) => {
     if (!BROWSER)

package/dist/svelte_helpers.d.ts

@@ -48,7 +48,7 @@ export interface SvelteFileAnalysis {
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module analysis matching ModuleAnalysis structure
+ * @returns module analysis matching `ModuleAnalysis` structure
  */
 export declare const svelte_analyze_module: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleAnalysis;
 /**
@@ -65,7 +65,7 @@ export declare const svelte_analyze_module: (source_file: SourceFileInfo, module
  * @param module_path - module path relative to source root (e.g., 'Alert.svelte')
  * @param checker - TypeScript type checker for type resolution
  * @param ctx - analysis context for collecting diagnostics
- * @returns Component declaration and optional module-level comment
+ * @returns component declaration and optional module-level comment
  */
 export declare const svelte_analyze_file: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, ctx: AnalysisContext) => SvelteFileAnalysis;
 /**
@@ -85,8 +85,8 @@ export declare const svelte_extract_script_content: (svelte_source: string) => s
  * Requires `@module` tag to identify module comments. The tag line is stripped
  * from the output.
  *
- * @param script_content - The content of the `<script>` tag.
- * @returns The cleaned module comment text, or undefined if none found.
+ * @param script_content - the content of the `<script>` tag
+ * @returns the cleaned module comment text, or undefined if none found
  */
 export declare const svelte_extract_module_comment: (script_content: string) => string | undefined;
 //# sourceMappingURL=svelte_helpers.d.ts.map

package/dist/svelte_helpers.js

@@ -58,7 +58,7 @@ const svelte_assert_version = () => {
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module analysis matching ModuleAnalysis structure
+ * @returns module analysis matching `ModuleAnalysis` structure
  */
 export const svelte_analyze_module = (source_file, module_path, checker, options, ctx) => {
     // Use the existing helper for core analysis
@@ -90,7 +90,7 @@ export const svelte_analyze_module = (source_file, module_path, checker, options
  * @param module_path - module path relative to source root (e.g., 'Alert.svelte')
  * @param checker - TypeScript type checker for type resolution
  * @param ctx - analysis context for collecting diagnostics
- * @returns Component declaration and optional module-level comment
+ * @returns component declaration and optional module-level comment
  */
 export const svelte_analyze_file = (source_file, module_path, checker, ctx) => {
     svelte_assert_version();
@@ -172,8 +172,8 @@ export const svelte_extract_script_content = (svelte_source) => {
  * Requires `@module` tag to identify module comments. The tag line is stripped
  * from the output.
  *
- * @param script_content - The content of the `<script>` tag.
- * @returns The cleaned module comment text, or undefined if none found.
+ * @param script_content - the content of the `<script>` tag
+ * @returns the cleaned module comment text, or undefined if none found
  */
 export const svelte_extract_module_comment = (script_content) => {
     // Parse the script content as TypeScript and reuse the shared extraction logic

package/dist/svelte_preprocess_mdz.d.ts

@@ -59,7 +59,7 @@ export interface SveltePreprocessMdzOptions {
  * Creates a Svelte preprocessor that compiles static `Mdz` content at build time.
  *
  * @param options - configuration for component/element resolution and file filtering
- * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
+ * @returns a Svelte `PreprocessorGroup` for use in `svelte.config.js`
  */
 export declare const svelte_preprocess_mdz: (options?: SveltePreprocessMdzOptions) => PreprocessorGroup;
 //# sourceMappingURL=svelte_preprocess_mdz.d.ts.map

package/dist/svelte_preprocess_mdz.js

@@ -25,7 +25,7 @@ const PRECOMPILED_NAME = 'MdzPrecompiled';
  * Creates a Svelte preprocessor that compiles static `Mdz` content at build time.
  *
  * @param options - configuration for component/element resolution and file filtering
- * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
+ * @returns a Svelte `PreprocessorGroup` for use in `svelte.config.js`
  */
 export const svelte_preprocess_mdz = (options = {}) => {
     const { exclude = [], components = {}, elements: elements_array = [], component_imports = ['@fuzdev/fuz_ui/Mdz.svelte'], compiled_component_import = '@fuzdev/fuz_ui/MdzPrecompiled.svelte', on_error = process.env.CI === 'true' ? 'throw' : 'log', } = options;

package/dist/tome.d.ts

@@ -10,7 +10,7 @@ export declare const Tome: z.ZodObject<{
 }, z.core.$strip>;
 export type Tome = z.infer<typeof Tome>;
 /**
- * @param hash - URL fragment to append, with or without the `#`.
+ * @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 tomes_context: {

package/dist/tome.js

@@ -13,7 +13,7 @@ export const Tome = z.object({
     related_declarations: z.array(z.string()),
 });
 /**
- * @param hash - URL fragment to append, with or without the `#`.
+ * @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;

package/dist/ts_helpers.d.ts

@@ -48,7 +48,7 @@ export interface ModuleExportsAnalysis {
  *
  * @param options - configuration options for program creation
  * @param log - optional logger for info messages
- * @returns The program and type checker
+ * @returns the program and type checker
  * @throws Error if tsconfig.json is not found
  */
 export declare const ts_create_program: (options?: TsProgramOptions, log?: Logger) => TsProgram;
@@ -67,7 +67,7 @@ export declare const ts_create_program: (options?: TsProgramOptions, log?: Logge
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module metadata and re-export information
+ * @returns module metadata and re-export information
  */
 export declare const ts_analyze_module: (source_file_info: SourceFileInfo, ts_source_file: ts.SourceFile, module_path: string, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleAnalysis;
 /**
@@ -87,7 +87,7 @@ export declare const ts_analyze_module: (source_file_info: SourceFileInfo, ts_so
  * @param checker - the TypeScript type checker
  * @param options - module source options for path extraction in re-exports
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module comment, declarations, re-exports, and star exports
+ * @returns module comment, declarations, re-exports, and star exports
  */
 export declare const ts_analyze_module_exports: (source_file: ts.SourceFile, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleExportsAnalysis;
 /**
@@ -101,7 +101,7 @@ export declare const ts_analyze_module_exports: (source_file: ts.SourceFile, che
  * @param source_file - the source file containing the symbol
  * @param checker - the TypeScript type checker
  * @param ctx - optional analysis context for collecting diagnostics
- * @returns Complete declaration metadata including docs, types, and parameters, plus nodocs flag
+ * @returns complete declaration metadata including docs, types, and parameters, plus nodocs flag
  */
 export declare const ts_analyze_declaration: (symbol: ts.Symbol, source_file: ts.SourceFile, checker: ts.TypeChecker, ctx: AnalysisContext) => DeclarationAnalysis;
 /**
@@ -133,7 +133,7 @@ export declare const ts_infer_declaration_kind: (symbol: ts.Symbol, node: ts.Nod
  * @param sig - the TypeScript signature to extract parameters from
  * @param checker - TypeScript type checker for type resolution
  * @param tsdoc_params - map of parameter names to TSDoc descriptions (from tsdoc.params)
- * @returns Array of parameter info objects
+ * @returns array of parameter info objects
  */
 export declare const ts_extract_signature_parameters: (sig: ts.Signature, checker: ts.TypeChecker, tsdoc_params: Map<string, string> | undefined) => Array<{
     name: string;

package/dist/ts_helpers.js

@@ -13,7 +13,7 @@ import { module_extract_dependencies, module_extract_path, module_is_source, } f
  *
  * @param options - configuration options for program creation
  * @param log - optional logger for info messages
- * @returns The program and type checker
+ * @returns the program and type checker
  * @throws Error if tsconfig.json is not found
  */
 export const ts_create_program = (options, log) => {
@@ -48,7 +48,7 @@ export const ts_create_program = (options, log) => {
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module metadata and re-export information
+ * @returns module metadata and re-export information
  */
 export const ts_analyze_module = (source_file_info, ts_source_file, module_path, checker, options, ctx) => {
     // Use the mid-level helper for core analysis
@@ -82,7 +82,7 @@ export const ts_analyze_module = (source_file_info, ts_source_file, module_path,
  * @param checker - the TypeScript type checker
  * @param options - module source options for path extraction in re-exports
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module comment, declarations, re-exports, and star exports
+ * @returns module comment, declarations, re-exports, and star exports
  */
 export const ts_analyze_module_exports = (source_file, checker, options, ctx) => {
     const declarations = [];
@@ -184,7 +184,7 @@ export const ts_analyze_module_exports = (source_file, checker, options, ctx) =>
  * @param source_file - the source file containing the symbol
  * @param checker - the TypeScript type checker
  * @param ctx - optional analysis context for collecting diagnostics
- * @returns Complete declaration metadata including docs, types, and parameters, plus nodocs flag
+ * @returns complete declaration metadata including docs, types, and parameters, plus nodocs flag
  */
 export const ts_analyze_declaration = (symbol, source_file, checker, ctx) => {
     const name = symbol.name;
@@ -328,7 +328,7 @@ export const ts_infer_declaration_kind = (symbol, node) => {
  * @param sig - the TypeScript signature to extract parameters from
  * @param checker - TypeScript type checker for type resolution
  * @param tsdoc_params - map of parameter names to TSDoc descriptions (from tsdoc.params)
- * @returns Array of parameter info objects
+ * @returns array of parameter info objects
  */
 export const ts_extract_signature_parameters = (sig, checker, tsdoc_params) => {
     return sig.parameters.map((param) => {

package/dist/tsdoc_helpers.d.ts

@@ -104,7 +104,7 @@ export declare const tsdoc_apply_to_declaration: (declaration: DeclarationJson,
  * Transforms `/** ... *\/` style comments into clean text.
  *
  * @param comment_text - the raw comment text including `/**` and `*\/` markers
- * @returns Cleaned comment text, or undefined if empty after cleaning
+ * @returns cleaned comment text, or undefined if empty after cleaning
  */
 export declare const tsdoc_clean_comment: (comment_text: string) => string | undefined;
 //# sourceMappingURL=tsdoc_helpers.d.ts.map

package/dist/tsdoc_helpers.js

@@ -183,7 +183,7 @@ export const tsdoc_apply_to_declaration = (declaration, tsdoc) => {
  * Transforms `/** ... *\/` style comments into clean text.
  *
  * @param comment_text - the raw comment text including `/**` and `*\/` markers
- * @returns Cleaned comment text, or undefined if empty after cleaning
+ * @returns cleaned comment text, or undefined if empty after cleaning
  */
 export const tsdoc_clean_comment = (comment_text) => {
     const text = comment_text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.191.0",
+  "version": "0.191.1",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -81,7 +81,7 @@
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.56.0",
+    "@fuzdev/fuz_css": "^0.57.0",
     "@fuzdev/fuz_util": "^0.55.0",
     "@fuzdev/gro": "^0.197.0",
     "@jridgewell/trace-mapping": "^0.3.31",
@@ -100,10 +100,10 @@
     "jsdom": "^27.2.0",
     "magic-string": "^0.30.21",
     "prettier": "^3.7.4",
-    "prettier-plugin-svelte": "^3.4.1",
-    "svelte": "^5.53.12",
+    "prettier-plugin-svelte": "^3.5.1",
+    "svelte": "^5.54.0",
     "svelte-check": "^4.4.5",
-    "svelte2tsx": "^0.7.47",
+    "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.48.1",

package/src/lib/analysis_context.ts

@@ -227,7 +227,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 const format_diagnostic = (
 	diagnostic: Diagnostic,

package/src/lib/library_analysis.ts

@@ -118,7 +118,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 const library_analyze_module = (
 	source_file: SourceFileInfo,

package/src/lib/library_helpers.ts

@@ -28,7 +28,7 @@ export 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 const url_api_declaration_full = (homepage: string, declaration_name: string): string =>
 	`${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
@@ -46,7 +46,7 @@ export const url_api_module = (module_path: string): string => `${DOCS_API_PATH}
  *
  * @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 const url_package_logo = (
 	homepage_url: string | null,
@@ -64,7 +64,7 @@ export const url_package_logo = (
  *
  * @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
  * // Assuming page.url.origin is 'https://example.com'

package/src/lib/logos.ts

@@ -100,6 +100,12 @@ export const logo_fuz_gitops = {
 	paths: logo_fuz.paths,
 } satisfies SvgData;
 
+export const logo_fuz_docs = {
+	label: 'a friendly cyan spider facing you',
+	fill: '#1ec3d2',
+	paths: logo_fuz.paths,
+} satisfies SvgData;
+
 export const logo_fuz_template = {
 	label: 'a friendly orange pixelated spider facing you',
 	fill: '#f4672f',

package/src/lib/mdz.ts

@@ -493,9 +493,9 @@ export class MdzParser {
 	 * - Empty content (e.g., `__` or `~~`)
 	 * - Paragraph break interrupts before closing delimiter
 	 *
-	 * @param delimiter - The delimiter character (`_` for italic, `~` for strikethrough)
-	 * @param node_type - The node type to create ('Italic' or 'Strikethrough')
-	 * @returns Formatted node or text node if validation fails
+	 * @param delimiter - the delimiter character (`_` for italic, `~` for strikethrough)
+	 * @param node_type - the node type to create ('Italic' or 'Strikethrough')
+	 * @returns formatted node or text node if validation fails
 	 */
 	#parse_single_delimiter_formatting(
 		delimiter: '_',
@@ -863,7 +863,7 @@ export class MdzParser {
 	/**
 	 * Restore previously saved text accumulation state.
 	 * Used to restore parent state when exiting nested structure parsing.
-	 * @param state - State object returned from `#save_accumulation_state()`
+	 * @param state - state object returned from `#save_accumulation_state()`
 	 */
 	#restore_accumulation_state(state: {
 		accumulated_text: string;
@@ -881,9 +881,9 @@ export class MdzParser {
 	 * Word boundary = not surrounded by word characters (A-Z, a-z, 0-9).
 	 * Used to prevent intraword emphasis for underscores and tildes.
 	 *
-	 * @param index - Position to check
-	 * @param check_before - Whether to check the character before this position
-	 * @param check_after - Whether to check the character after this position
+	 * @param index - position to check
+	 * @param check_before - whether to check the character before this position
+	 * @param check_after - whether to check the character after this position
 	 */
 	#is_at_word_boundary(index: number, check_before: boolean, check_after: boolean): boolean {
 		if (check_before && index > 0) {
@@ -1106,9 +1106,9 @@ export class MdzParser {
 	 * - Paragraph break (double newline) is encountered (allows block elements to interrupt inline formatting)
 	 * - `end_index` boundary is reached
 	 *
-	 * @param delimiter - The delimiter string to stop at (e.g., '**', '_', ']')
-	 * @param end_index - Optional maximum index to parse up to (for greedy/bounded parsing)
-	 * @returns Array of parsed nodes (may be empty if delimiter found immediately)
+	 * @param delimiter - the delimiter string to stop at (e.g., '**', '_', ']')
+	 * @param end_index - optional maximum index to parse up to (for greedy/bounded parsing)
+	 * @returns array of parsed nodes (may be empty if delimiter found immediately)
 	 */
 	#parse_nodes_until(delimiter: string, end_index?: number): Array<MdzNode> {
 		const nodes: Array<MdzNode> = [];

package/src/lib/mdz_helpers.ts

@@ -262,9 +262,9 @@ export const mdz_is_url = (s: string): boolean => URL_PATTERN.test(s);
  * (e.g., `'./a/../b'` → navigates up then down).
  * Clamps at root — excess `..` segments stop at `/` rather than escaping.
  *
- * @param reference - a relative path starting with `./` or `../`.
- * @param base - an absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ * @param reference - a relative path starting with `./` or `../`
+ * @param base - An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns an absolute resolved path (e.g., `'/docs/mdz/grammar'`)
  */
 export const resolve_relative_path = (reference: string, base: string): string => {
 	const segments = base.split('/');

package/src/lib/mdz_to_svelte.ts

@@ -35,12 +35,12 @@ export interface MdzToSvelteResult {
  * Each node type produces output matching what `MdzNodeView.svelte` renders at runtime.
  * Collects required imports and flags unconfigured component/element references.
  *
- * @param nodes - parsed mdz nodes to render.
- * @param components - component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`).
+ * @param nodes - parsed mdz nodes to render
+ * @param components - Component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`)
  *   If content references a component not in this map, `has_unconfigured_tags` is set.
- * @param elements - allowed HTML element names (e.g., `new Set(['aside', 'details'])`).
+ * @param elements - Allowed HTML element names (e.g., `new Set(['aside', 'details'])`)
  *   If content references an element not in this set, `has_unconfigured_tags` is set.
- * @param base - base path for resolving relative links (e.g., `'/docs/mdz/'`).
+ * @param base - Base path for resolving relative links (e.g., `'/docs/mdz/'`)
  *   When provided, relative references (`./`, `../`) are resolved to absolute paths
  *   and passed through `resolve()`. Trailing slash recommended.
  */

package/src/lib/module_helpers.ts

@@ -432,7 +432,7 @@ export const module_is_test = (path: string): boolean => path.endsWith('.test.ts
  *
  * @param path - full absolute path to check
  * @param options - module source options for filtering
- * @returns True if the path is an analyzable source file
+ * @returns true if the path is an analyzable source file
  *
  * @example
  * ```ts

package/src/lib/package_helpers.ts

@@ -30,7 +30,7 @@ import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param file_path - path to the file (leading './' is stripped)
  * @param line - optional line number for deep linking
- * @returns Full GitHub URL to the file on the main branch
+ * @returns full GitHub URL to the file on the main branch
  *
  * @example
  * ```ts
@@ -55,7 +55,7 @@ export const url_github_file = (repo_url: string, file_path: string, line?: numb
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param repo_name - repository name to strip from the URL
- * @returns Organization URL, or null if repo_url doesn't end with repo_name
+ * @returns organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
  * ```ts
@@ -71,7 +71,7 @@ export const url_github_org = (repo_url: string, repo_name: string): string | nu
  * Extract GitHub owner/org name from repository URL.
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
- * @returns Owner name, or null if not a valid GitHub URL
+ * @returns owner name, or null if not a valid GitHub URL
  *
  * @example
  * ```ts
@@ -96,7 +96,7 @@ export const repo_url_github_owner = (repo_url: string): string | null => {
  * Build npm package URL.
  *
  * @param package_name - package name (can be scoped like '@org/package')
- * @returns Full npm package page URL
+ * @returns full npm package page URL
  *
  * @example
  * ```ts
@@ -116,7 +116,7 @@ export const url_npm_package = (package_name: string): string =>
  * - Its version is not the initial '0.0.1'
  *
  * @param package_json - the package.json object to check
- * @returns True if the package appears to be published
+ * @returns `true` if the package appears to be published
  */
 export const package_is_published = (package_json: PackageJson): boolean => {
 	return !package_json.private && !!package_json.exports && package_json.version !== '0.0.1';
@@ -126,7 +126,7 @@ export const package_is_published = (package_json: PackageJson): boolean => {
  * Extract repository name without scope from package name.
  *
  * @param name - package name (can be scoped like '@org/package')
- * @returns Repository name without scope
+ * @returns repository name without scope
  * @throws Error if scoped package name is malformed
  *
  * @example
@@ -159,7 +159,7 @@ export const repo_name_parse = (name: string): string => {
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
  * @param repository - the repository field from package.json
- * @returns Clean repository URL, or null if not provided
+ * @returns clean repository URL, or null if not provided
  *
  * @example
  * ```ts
@@ -191,7 +191,7 @@ export const repo_url_parse = (repository: PackageJson['repository']): string |
  *
  * @param homepage_url - package homepage URL
  * @param filename - filename in .well-known directory
- * @returns Full URL to the .well-known file
+ * @returns full URL to the .well-known file
  *
  * @example
  * ```ts

package/src/lib/storage.ts

@@ -21,7 +21,7 @@ export const save_to_storage = (key: string, value: any, is_json = false): void
  * @param key - the localStorage key
  * @param is_json - whether to parse the value as JSON
  * @param parse_fn - optional custom parsing function to transform the value
- * @returns The parsed value or null if not found or parsing fails
+ * @returns the parsed value or null if not found or parsing fails
  */
 export const load_from_storage = <T>(
 	key: string,

package/src/lib/svelte_helpers.ts

@@ -81,7 +81,7 @@ export interface SvelteFileAnalysis {
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module analysis matching ModuleAnalysis structure
+ * @returns module analysis matching `ModuleAnalysis` structure
  */
 export const svelte_analyze_module = (
 	source_file: SourceFileInfo,
@@ -122,7 +122,7 @@ export const svelte_analyze_module = (
  * @param module_path - module path relative to source root (e.g., 'Alert.svelte')
  * @param checker - TypeScript type checker for type resolution
  * @param ctx - analysis context for collecting diagnostics
- * @returns Component declaration and optional module-level comment
+ * @returns component declaration and optional module-level comment
  */
 export const svelte_analyze_file = (
 	source_file: SourceFileInfo,
@@ -259,8 +259,8 @@ export const svelte_extract_script_content = (svelte_source: string): string | u
  * Requires `@module` tag to identify module comments. The tag line is stripped
  * from the output.
  *
- * @param script_content - The content of the `<script>` tag.
- * @returns The cleaned module comment text, or undefined if none found.
+ * @param script_content - the content of the `<script>` tag
+ * @returns the cleaned module comment text, or undefined if none found
  */
 export const svelte_extract_module_comment = (script_content: string): string | undefined => {
 	// Parse the script content as TypeScript and reuse the shared extraction logic

package/src/lib/svelte_preprocess_mdz.ts

@@ -99,7 +99,7 @@ const PRECOMPILED_NAME = 'MdzPrecompiled';
  * Creates a Svelte preprocessor that compiles static `Mdz` content at build time.
  *
  * @param options - configuration for component/element resolution and file filtering
- * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
+ * @returns a Svelte `PreprocessorGroup` for use in `svelte.config.js`
  */
 export const svelte_preprocess_mdz = (
 	options: SveltePreprocessMdzOptions = {},

package/src/lib/tome.ts

@@ -18,7 +18,7 @@ export const Tome = z.object({
 export type Tome = z.infer<typeof Tome>;
 
 /**
- * @param hash - URL fragment to append, with or without the `#`.
+ * @param hash - URL fragment to append, with or without the `#`
  */
 export const to_tome_pathname = (
 	item: Tome | string,

package/src/lib/ts_helpers.ts

@@ -65,7 +65,7 @@ export interface ModuleExportsAnalysis {
  *
  * @param options - configuration options for program creation
  * @param log - optional logger for info messages
- * @returns The program and type checker
+ * @returns the program and type checker
  * @throws Error if tsconfig.json is not found
  */
 export const ts_create_program = (options?: TsProgramOptions, log?: Logger): TsProgram => {
@@ -106,7 +106,7 @@ export const ts_create_program = (options?: TsProgramOptions, log?: Logger): TsP
  * @param checker - TypeScript type checker
  * @param options - module source options for path extraction
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module metadata and re-export information
+ * @returns module metadata and re-export information
  */
 export const ts_analyze_module = (
 	source_file_info: SourceFileInfo,
@@ -155,7 +155,7 @@ export const ts_analyze_module = (
  * @param checker - the TypeScript type checker
  * @param options - module source options for path extraction in re-exports
  * @param ctx - analysis context for collecting diagnostics
- * @returns Module comment, declarations, re-exports, and star exports
+ * @returns module comment, declarations, re-exports, and star exports
  */
 export const ts_analyze_module_exports = (
 	source_file: ts.SourceFile,
@@ -279,7 +279,7 @@ export const ts_analyze_module_exports = (
  * @param source_file - the source file containing the symbol
  * @param checker - the TypeScript type checker
  * @param ctx - optional analysis context for collecting diagnostics
- * @returns Complete declaration metadata including docs, types, and parameters, plus nodocs flag
+ * @returns complete declaration metadata including docs, types, and parameters, plus nodocs flag
  */
 export const ts_analyze_declaration = (
 	symbol: ts.Symbol,
@@ -434,7 +434,7 @@ export const ts_infer_declaration_kind = (symbol: ts.Symbol, node: ts.Node): Dec
  * @param sig - the TypeScript signature to extract parameters from
  * @param checker - TypeScript type checker for type resolution
  * @param tsdoc_params - map of parameter names to TSDoc descriptions (from tsdoc.params)
- * @returns Array of parameter info objects
+ * @returns array of parameter info objects
  */
 export const ts_extract_signature_parameters = (
 	sig: ts.Signature,

package/src/lib/tsdoc_helpers.ts

@@ -220,7 +220,7 @@ export const tsdoc_apply_to_declaration = (
  * Transforms `/** ... *\/` style comments into clean text.
  *
  * @param comment_text - the raw comment text including `/**` and `*\/` markers
- * @returns Cleaned comment text, or undefined if empty after cleaning
+ * @returns cleaned comment text, or undefined if empty after cleaning
  */
 export const tsdoc_clean_comment = (comment_text: string): string | undefined => {
 	const text = comment_text