@fuzdev/fuz_ui 0.190.0 → 0.191.1

package/dist/tsdoc_helpers.d.ts

@@ -83,8 +83,8 @@ export interface TsdocParsedComment {
  * - `@since` - version information
  * - `@mutates` - mutation documentation (non-standard)
  *
- * @param node The TypeScript node to extract JSDoc from
- * @param source_file Source file (used for extracting full` @see` tag text)
+ * @param node - the TypeScript node to extract JSDoc from
+ * @param source_file - source file (used for extracting full ` @see` tag text)
  */
 export declare const tsdoc_parse: (node: ts.Node, source_file: ts.SourceFile) => TsdocParsedComment | undefined;
 /**
@@ -93,8 +93,8 @@ export declare const tsdoc_parse: (node: ts.Node, source_file: ts.SourceFile) =>
  * Consolidates the common pattern of assigning TSDoc fields to declarations,
  * with conditional assignment for array fields (only if non-empty).
  *
- * @param declaration declaration object to update
- * @param tsdoc parsed TSDoc comment (if available)
+ * @param declaration - declaration object to update
+ * @param tsdoc - parsed TSDoc comment (if available)
  * @mutates declaration - adds doc_comment, deprecated_message, examples, see_also, throws, since fields
  */
 export declare const tsdoc_apply_to_declaration: (declaration: DeclarationJson, tsdoc: TsdocParsedComment | undefined) => void;
@@ -103,8 +103,8 @@ 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
+ * @param comment_text - the raw comment text including `/**` and `*\/` markers
+ * @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

@@ -54,8 +54,8 @@ import ts from 'typescript';
  * - `@since` - version information
  * - `@mutates` - mutation documentation (non-standard)
  *
- * @param node The TypeScript node to extract JSDoc from
- * @param source_file Source file (used for extracting full` @see` tag text)
+ * @param node - the TypeScript node to extract JSDoc from
+ * @param source_file - source file (used for extracting full ` @see` tag text)
  */
 export const tsdoc_parse = (node, source_file) => {
     const tsdoc_comments = ts.getJSDocCommentsAndTags(node);
@@ -154,8 +154,8 @@ export const tsdoc_parse = (node, source_file) => {
  * Consolidates the common pattern of assigning TSDoc fields to declarations,
  * with conditional assignment for array fields (only if non-empty).
  *
- * @param declaration declaration object to update
- * @param tsdoc parsed TSDoc comment (if available)
+ * @param declaration - declaration object to update
+ * @param tsdoc - parsed TSDoc comment (if available)
  * @mutates declaration - adds doc_comment, deprecated_message, examples, see_also, throws, since fields
  */
 export const tsdoc_apply_to_declaration = (declaration, tsdoc) => {
@@ -182,8 +182,8 @@ 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
+ * @param comment_text - the raw comment text including `/**` and `*\/` markers
+ * @returns cleaned comment text, or undefined if empty after cleaning
  */
 export const tsdoc_clean_comment = (comment_text) => {
     const text = comment_text

package/dist/tsdoc_mdz.js

@@ -7,7 +7,7 @@
  *
  * @module
  */
-import { mdz_is_url } from './mdz.js';
+import { mdz_is_url } from './mdz_helpers.js';
 /** Format a reference as mdz: URLs pass through, identifiers get backticks. */
 const format_reference = (ref) => (mdz_is_url(ref) ? ref : `\`${ref}\``);
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.190.0",
+  "version": "0.191.1",
   "description": "Svelte UI library",
   "tagline": "friendly user zystem",
   "glyph": "🧶",
@@ -28,7 +28,8 @@
     "fixtures:update": "gro src/test/fixtures/update",
     "preview": "vite preview",
     "deploy": "gro deploy",
-    "benchmark_mdz": "gro run src/benchmarks/mdz.benchmark.ts"
+    "benchmark": "gro run src/benchmarks/mdz.benchmark.ts",
+    "benchmark:save": "gro run src/benchmarks/mdz.benchmark.ts --save"
   },
   "type": "module",
   "engines": {
@@ -80,8 +81,8 @@
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
     "@fuzdev/fuz_code": "^0.45.1",
-    "@fuzdev/fuz_css": "^0.56.0",
-    "@fuzdev/fuz_util": "^0.54.0",
+    "@fuzdev/fuz_css": "^0.57.0",
+    "@fuzdev/fuz_util": "^0.55.0",
     "@fuzdev/gro": "^0.197.0",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.10.1",
@@ -99,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

@@ -225,9 +225,9 @@ export interface FormatDiagnosticOptions {
 /**
  * Format a diagnostic for display.
  *
- * @param diagnostic The diagnostic to format
- * @param options Formatting options
- * @returns Formatted string like './file.ts:10:5: error: message'
+ * @param diagnostic - the diagnostic to format
+ * @param options - formatting options
+ * @returns formatted string like './file.ts:10:5: error: message'
  */
 export const format_diagnostic = (
 	diagnostic: Diagnostic,

package/src/lib/contextmenu_state.svelte.ts

@@ -344,7 +344,7 @@ let cache_key_counter = 0;
 
 /**
  * Creates an attachment that sets up contextmenu behavior on an element.
- * @param params Contextmenu parameters or nullish to disable
+ * @param params - contextmenu parameters or nullish to disable
  */
 export const contextmenu_attachment =
 	<T extends ContextmenuParams, U extends T | Array<T>>(
@@ -380,11 +380,11 @@ export interface ContextmenuOpenOptions {
 /**
  * Opens the contextmenu, if appropriate,
  * querying the menu items from the DOM starting at the event target.
- * @param target the leaf element from which to open the contextmenu
- * @param x the page X coordinate at which to open the contextmenu, typically the mouse `pageX`
- * @param y the page Y coordinate at which to open the contextmenu, typically the mouse `pageY`
- * @param contextmenu the contextmenu store
- * @param options optional configuration for filtering entries and haptic feedback
+ * @param target - the leaf element from which to open the contextmenu
+ * @param x - the page X coordinate at which to open the contextmenu, typically the mouse `pageX`
+ * @param y - the page Y coordinate at which to open the contextmenu, typically the mouse `pageY`
+ * @param contextmenu - the contextmenu store
+ * @param options - optional configuration for filtering entries and haptic feedback
  * @returns a boolean indicating if the menu was opened or not
  */
 export const contextmenu_open = (
@@ -487,7 +487,7 @@ const non_scoped_roots: Set<symbol> = new Set();
  * Registers a contextmenu root and warns if multiple non-scoped roots are detected.
  * Only active in development mode. Automatically handles cleanup on unmount.
  *
- * @param get_scoped Getter function that returns the current scoped value
+ * @param get_scoped - getter function that returns the current scoped value
  */
 export const contextmenu_check_global_root = (get_scoped: () => boolean): void => {
 	$effect(() => {

package/src/lib/docs_helpers.svelte.ts

@@ -5,11 +5,13 @@ import {ensure_end, ensure_start} from '@fuzdev/fuz_util/string.js';
 import {create_context} from './context_helpers.js';
 
 /**
- * Convert a string to a URL-safe fragment identifier, preserving case for API declarations.
- * Only transforms spaces and special characters, keeping valid identifier characters intact.
- * Used for hash anchors in documentation.
- * @param str - The string to convert to a fragment
- * @returns A URL-safe fragment identifier
+ * Convert a string to a URL-safe fragment identifier, preserving case.
+ * 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.
+ * @param str - the string to convert to a fragment
+ * @returns a URL-safe fragment identifier with case preserved
  */
 export const docs_slugify = (str: string): string => {
 	return (

package/src/lib/intersect.svelte.ts

@@ -30,7 +30,7 @@ export type IntersectParamsOrCallback = OnIntersect | IntersectParams;
  * Creates an attachment that observes element viewport intersection.
  * Uses the lazy function pattern to optimize reactivity:
  * callbacks can update without recreating the observer, preserving state.
- * @param get_params Function that returns callback, params object, or nullish to disable
+ * @param get_params - function that returns callback, params object, or nullish to disable
  */
 export const intersect =
 	(

package/src/lib/library_analysis.ts

@@ -113,12 +113,12 @@ export interface ModuleAnalysis {
  * only re-analyze changed files. The TypeScript program should include all files
  * for accurate type resolution, but only changed files need re-analysis.
  *
- * @param source_file The source file info with content and optional dependency data
- * @param program TypeScript program (used for type checking and source file lookup)
- * @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
+ * @param source_file - the source file info with content and optional dependency data
+ * @param program - TypeScript program (used for type checking and source file lookup)
+ * @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
  */
 export const library_analyze_module = (
 	source_file: SourceFileInfo,

package/src/lib/library_gen.ts

@@ -89,9 +89,9 @@ export const source_file_from_disknode = (disknode: Disknode): SourceFileInfo =>
  * have malformed paths or missing content). The filtering uses `module_is_source` which
  * checks `source_paths` to only include files in configured source directories.
  *
- * @param disknodes Iterator of Gro disknodes from filer
- * @param options Module source options for filtering
- * @param log Optional logger for status messages
+ * @param disknodes - iterator of Gro disknodes from filer
+ * @param options - module source options for filtering
+ * @param log - optional logger for status messages
  */
 export const library_collect_source_files_from_disknodes = (
 	disknodes: Iterable<Disknode>,
@@ -146,7 +146,7 @@ export const library_collect_source_files_from_disknodes = (
  * export const gen = library_gen();
  * ```
  *
- * @param options Optional generation options
+ * @param options - optional generation options
  */
 export const library_gen = (options?: LibraryGenOptions): Gen => {
 	return {

package/src/lib/library_generate.ts

@@ -43,8 +43,8 @@ import {AnalysisContext, format_diagnostic} from './analysis_context.js';
 /**
  * Callback for handling duplicate declaration names.
  *
- * @param duplicates Map of declaration names to their occurrences across modules
- * @param log Logger for reporting
+ * @param duplicates - map of declaration names to their occurrences across modules
+ * @param log - logger for reporting
  */
 export type OnDuplicatesCallback = (
 	duplicates: Map<string, Array<DuplicateInfo>>,

package/src/lib/library_helpers.ts

@@ -17,7 +17,7 @@ import {DOCS_API_PATH, DOCS_PATH_DEFAULT} from './docs_helpers.svelte.js';
 /**
  * Build project-relative API documentation URL with hash anchor.
  *
- * @param declaration_name Name of the declaration to link to
+ * @param declaration_name - name of the declaration to link to
  * @returns URL path like '/docs/api#declaration_name'
  */
 export const url_api_declaration = (declaration_name: string): string =>
@@ -26,9 +26,9 @@ export const url_api_declaration = (declaration_name: string): string =>
 /**
  * Build full API documentation URL with domain and hash anchor.
  *
- * @param homepage Package homepage URL
- * @param declaration_name Name of the declaration to link to
- * @returns Full URL like 'https://example.com/docs/api#declaration_name'
+ * @param homepage - package homepage URL
+ * @param declaration_name - name of the declaration to link to
+ * @returns full URL like 'https://example.com/docs/api#declaration_name'
  */
 export const url_api_declaration_full = (homepage: string, declaration_name: string): string =>
 	`${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
@@ -36,7 +36,7 @@ export const url_api_declaration_full = (homepage: string, declaration_name: str
 /**
  * Build project-relative module documentation URL.
  *
- * @param module_path Module path (e.g., 'helpers.ts')
+ * @param module_path - module path (e.g., 'helpers.ts')
  * @returns URL path like '/docs/api/helpers.ts'
  */
 export const url_api_module = (module_path: string): string => `${DOCS_API_PATH}/${module_path}`;
@@ -44,9 +44,9 @@ export const url_api_module = (module_path: string): string => `${DOCS_API_PATH}
 /**
  * Build package logo URL with favicon.png fallback.
  *
- * @param homepage_url Package homepage URL, or null
- * @param logo_path Optional custom logo path (defaults to 'favicon.png')
- * @returns Full URL to the logo, or null if no homepage
+ * @param homepage_url - package homepage URL, or null
+ * @param logo_path - optional custom logo path (defaults to 'favicon.png')
+ * @returns full URL to the logo, or null if no homepage
  */
 export const url_package_logo = (
 	homepage_url: string | null,
@@ -62,9 +62,9 @@ export const url_package_logo = (
  *
  * Uses SvelteKit's page state for the current origin by default.
  *
- * @param url Full URL to convert
- * @param origin Origin to strip (defaults to current page origin)
- * @returns Root-relative URL starting with '/'
+ * @param url - full URL to convert
+ * @param origin - origin to strip (defaults to current page origin)
+ * @returns root-relative URL starting with '/'
  *
  * @example
  * // Assuming page.url.origin is 'https://example.com'

package/src/lib/library_pipeline.ts

@@ -130,8 +130,8 @@ export interface CollectedReExport {
  * // - helpers.ts foo declaration gets: also_exported_from: ['index.ts']
  * // - helpers.ts bar declaration gets: also_exported_from: ['index.ts']
  *
- * @param source_json The source JSON with all modules (will be mutated)
- * @param collected_re_exports Array of re-exports collected during phase 1
+ * @param source_json - the source JSON with all modules (will be mutated)
+ * @param collected_re_exports - array of re-exports collected during phase 1
  * @mutates source_json - adds `also_exported_from` to declarations
  */
 export const library_merge_re_exports = (
@@ -180,9 +180,9 @@ export const library_merge_re_exports = (
  * File types are determined by `options.get_analyzer`. By default, `.ts`, `.js`, and `.svelte`
  * files are supported. Customize `get_analyzer` to support additional file types like `.svx`.
  *
- * @param files Iterable of source file info (from Gro filer, file system, or other source)
- * @param options Module source options for filtering
- * @param log Optional logger for status messages
+ * @param files - iterable of source file info (from Gro filer, file system, or other source)
+ * @param options - module source options for filtering
+ * @param log - optional logger for status messages
  */
 export const library_collect_source_files = (
 	files: Iterable<SourceFileInfo>,

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',