@fuzdev/fuz_ui 0.190.0 → 0.191.0

package/dist/module_helpers.d.ts

@@ -159,8 +159,8 @@ export declare const MODULE_SOURCE_PARTIAL: ModuleSourcePartial;
 /**
  * Create complete source options from project root and optional overrides.
  *
- * @param project_root Absolute path to project root (typically `process.cwd()`)
- * @param overrides Optional overrides for default options
+ * @param project_root - absolute path to project root (typically `process.cwd()`)
+ * @param overrides - optional overrides for default options
  *
  * @example
  * ```ts
@@ -243,8 +243,8 @@ export declare const module_get_source_root: (options: ModuleSourceOptions) => s
  *
  * Uses proper path semantics: strips `project_root/source_root/` prefix.
  *
- * @param source_id Absolute path to the source file
- * @param options Module source options for path extraction
+ * @param source_id - absolute path to the source file
+ * @param options - module source options for path extraction
  *
  * @example
  * ```ts
@@ -305,8 +305,8 @@ export declare const module_is_test: (path: string) => boolean;
  * `project_root/source_path/`. No heuristics needed - nested directories
  * are correctly excluded by the prefix check.
  *
- * @param path Full absolute path to check
- * @param options Module source options for filtering
+ * @param path - full absolute path to check
+ * @param options - module source options for filtering
  * @returns True if the path is an analyzable source file
  *
  * @example
@@ -324,8 +324,8 @@ export declare const module_is_source: (path: string, options: ModuleSourceOptio
  * Filters to only include source modules (excludes external packages, node_modules, tests).
  * Returns sorted arrays of module paths (relative to source_root) for deterministic output.
  *
- * @param source_file The source file info to extract dependencies from
- * @param options Module source options for filtering and path extraction
+ * @param source_file - the source file info to extract dependencies from
+ * @param options - module source options for filtering and path extraction
  */
 export declare const module_extract_dependencies: (source_file: SourceFileInfo, options: ModuleSourceOptions) => {
     dependencies: Array<string>;

package/dist/module_helpers.js

@@ -36,8 +36,8 @@ export const MODULE_SOURCE_PARTIAL = {
 /**
  * Create complete source options from project root and optional overrides.
  *
- * @param project_root Absolute path to project root (typically `process.cwd()`)
- * @param overrides Optional overrides for default options
+ * @param project_root - absolute path to project root (typically `process.cwd()`)
+ * @param overrides - optional overrides for default options
  *
  * @example
  * ```ts
@@ -183,8 +183,8 @@ export const module_get_source_root = (options) => {
  *
  * Uses proper path semantics: strips `project_root/source_root/` prefix.
  *
- * @param source_id Absolute path to the source file
- * @param options Module source options for path extraction
+ * @param source_id - absolute path to the source file
+ * @param options - module source options for path extraction
  *
  * @example
  * ```ts
@@ -254,8 +254,8 @@ export const module_is_test = (path) => path.endsWith('.test.ts');
  * `project_root/source_path/`. No heuristics needed - nested directories
  * are correctly excluded by the prefix check.
  *
- * @param path Full absolute path to check
- * @param options Module source options for filtering
+ * @param path - full absolute path to check
+ * @param options - module source options for filtering
  * @returns True if the path is an analyzable source file
  *
  * @example
@@ -288,8 +288,8 @@ export const module_is_source = (path, options) => {
  * Filters to only include source modules (excludes external packages, node_modules, tests).
  * Returns sorted arrays of module paths (relative to source_root) for deterministic output.
  *
- * @param source_file The source file info to extract dependencies from
- * @param options Module source options for filtering and path extraction
+ * @param source_file - the source file info to extract dependencies from
+ * @param options - module source options for filtering and path extraction
  */
 export const module_extract_dependencies = (source_file, options) => {
     const dependencies = [];

package/dist/package_helpers.d.ts

@@ -24,9 +24,9 @@ import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
 /**
  * Build GitHub file URL for a repository.
  *
- * @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
+ * @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
  *
  * @example
@@ -45,8 +45,8 @@ export declare const url_github_file: (repo_url: string, file_path: string, line
 /**
  * Build GitHub organization URL from repo URL and repo name.
  *
- * @param repo_url Repository URL (e.g., 'https://github.com/owner/repo')
- * @param repo_name Repository name to strip from the URL
+ * @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
  *
  * @example
@@ -59,7 +59,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')
+ * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @returns Owner name, or null if not a valid GitHub URL
  *
  * @example
@@ -78,7 +78,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')
+ * @param package_name - package name (can be scoped like '@org/package')
  * @returns Full npm package page URL
  *
  * @example
@@ -96,14 +96,14 @@ export declare const url_npm_package: (package_name: string) => string;
  * - It has exports defined
  * - Its version is not the initial '0.0.1'
  *
- * @param package_json The package.json object to check
+ * @param package_json - the package.json object to check
  * @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')
+ * @param name - package name (can be scoped like '@org/package')
  * @returns Repository name without scope
  * @throws Error if scoped package name is malformed
  *
@@ -126,7 +126,7 @@ export declare const repo_name_parse: (name: string) => string;
  * Handles both string format and object format with `url` property.
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
- * @param repository The repository field from package.json
+ * @param repository - the repository field from package.json
  * @returns Clean repository URL, or null if not provided
  *
  * @example
@@ -151,8 +151,8 @@ export declare const repo_url_parse: (repository: PackageJson["repository"]) =>
 /**
  * Build .well-known URL for package metadata files.
  *
- * @param homepage_url Package homepage URL
- * @param filename Filename in .well-known directory
+ * @param homepage_url - package homepage URL
+ * @param filename - filename in .well-known directory
  * @returns Full URL to the .well-known file
  *
  * @example

package/dist/package_helpers.js

@@ -24,9 +24,9 @@ import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
 /**
  * Build GitHub file URL for a repository.
  *
- * @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
+ * @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
  *
  * @example
@@ -49,8 +49,8 @@ export const url_github_file = (repo_url, file_path, line) => {
 /**
  * Build GitHub organization URL from repo URL and repo name.
  *
- * @param repo_url Repository URL (e.g., 'https://github.com/owner/repo')
- * @param repo_name Repository name to strip from the URL
+ * @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
  *
  * @example
@@ -65,7 +65,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')
+ * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @returns Owner name, or null if not a valid GitHub URL
  *
  * @example
@@ -90,7 +90,7 @@ export const repo_url_github_owner = (repo_url) => {
 /**
  * Build npm package URL.
  *
- * @param package_name Package name (can be scoped like '@org/package')
+ * @param package_name - package name (can be scoped like '@org/package')
  * @returns Full npm package page URL
  *
  * @example
@@ -108,7 +108,7 @@ export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/
  * - It has exports defined
  * - Its version is not the initial '0.0.1'
  *
- * @param package_json The package.json object to check
+ * @param package_json - the package.json object to check
  * @returns True if the package appears to be published
  */
 export const package_is_published = (package_json) => {
@@ -117,7 +117,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')
+ * @param name - package name (can be scoped like '@org/package')
  * @returns Repository name without scope
  * @throws Error if scoped package name is malformed
  *
@@ -149,7 +149,7 @@ export const repo_name_parse = (name) => {
  * Handles both string format and object format with `url` property.
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
- * @param repository The repository field from package.json
+ * @param repository - the repository field from package.json
  * @returns Clean repository URL, or null if not provided
  *
  * @example
@@ -181,8 +181,8 @@ export const repo_url_parse = (repository) => {
 /**
  * Build .well-known URL for package metadata files.
  *
- * @param homepage_url Package homepage URL
- * @param filename Filename in .well-known directory
+ * @param homepage_url - package homepage URL
+ * @param filename - filename in .well-known directory
  * @returns Full URL to the .well-known file
  *
  * @example

package/dist/storage.d.ts

@@ -4,9 +4,9 @@
 export declare const save_to_storage: (key: string, value: any, is_json?: boolean) => void;
 /**
  * Utility function to load a value from `localStorage` with optional parsing
- * @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
+ * @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
  */
 export declare const load_from_storage: <T>(key: string, is_json?: boolean, parse_fn?: (value: unknown) => T | null) => T | null;

package/dist/storage.js

@@ -17,9 +17,9 @@ export const save_to_storage = (key, value, is_json = false) => {
 };
 /**
  * Utility function to load a value from `localStorage` with optional parsing
- * @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
+ * @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
  */
 export const load_from_storage = (key, is_json = false, parse_fn) => {

package/dist/svelte_helpers.d.ts

@@ -43,11 +43,11 @@ export interface SvelteFileAnalysis {
  * Returns raw analysis data matching `ModuleAnalysis` structure.
  * Consumer decides filtering policy (Svelte components are never nodocs).
  *
- * @param source_file The source file info (from Gro filer, file system, or other source)
- * @param module_path The module path (relative to source root)
- * @param checker TypeScript type checker
- * @param options Module source options for path extraction
- * @param ctx Analysis context for collecting diagnostics
+ * @param source_file - the source file info (from Gro filer, file system, or other source)
+ * @param module_path - the module path (relative to source root)
+ * @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
  */
 export declare const svelte_analyze_module: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleAnalysis;
@@ -61,10 +61,10 @@ export declare const svelte_analyze_module: (source_file: SourceFileInfo, module
  *
  * Suitable for use in documentation generators, build tools, and analysis.
  *
- * @param source_file Source file info with path and content
- * @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
+ * @param source_file - source file info with path and content
+ * @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
  */
 export declare const svelte_analyze_file: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, ctx: AnalysisContext) => SvelteFileAnalysis;

package/dist/svelte_helpers.js

@@ -53,11 +53,11 @@ const svelte_assert_version = () => {
  * Returns raw analysis data matching `ModuleAnalysis` structure.
  * Consumer decides filtering policy (Svelte components are never nodocs).
  *
- * @param source_file The source file info (from Gro filer, file system, or other source)
- * @param module_path The module path (relative to source root)
- * @param checker TypeScript type checker
- * @param options Module source options for path extraction
- * @param ctx Analysis context for collecting diagnostics
+ * @param source_file - the source file info (from Gro filer, file system, or other source)
+ * @param module_path - the module path (relative to source root)
+ * @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
  */
 export const svelte_analyze_module = (source_file, module_path, checker, options, ctx) => {
@@ -86,10 +86,10 @@ export const svelte_analyze_module = (source_file, module_path, checker, options
  *
  * Suitable for use in documentation generators, build tools, and analysis.
  *
- * @param source_file Source file info with path and content
- * @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
+ * @param source_file - source file info with path and content
+ * @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
  */
 export const svelte_analyze_file = (source_file, module_path, checker, ctx) => {

package/dist/svelte_preprocess_mdz.d.ts

@@ -58,7 +58,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.
+ * @param options - configuration for component/element resolution and file filtering
  * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
  */
 export declare const svelte_preprocess_mdz: (options?: SveltePreprocessMdzOptions) => PreprocessorGroup;

package/dist/svelte_preprocess_mdz.js

@@ -24,7 +24,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.
+ * @param options - configuration for component/element resolution and file filtering
  * @returns A Svelte `PreprocessorGroup` for use in `svelte.config.js`.
  */
 export const svelte_preprocess_mdz = (options = {}) => {

package/dist/ts_helpers.d.ts

@@ -46,8 +46,8 @@ export interface ModuleExportsAnalysis {
 /**
  * Create TypeScript program for analysis.
  *
- * @param options Configuration options for program creation
- * @param log Optional logger for info messages
+ * @param options - configuration options for program creation
+ * @param log - optional logger for info messages
  * @returns The program and type checker
  * @throws Error if tsconfig.json is not found
  */
@@ -61,12 +61,12 @@ export declare const ts_create_program: (options?: TsProgramOptions, log?: Logge
  * This is a high-level function suitable for building documentation or library metadata.
  * For lower-level analysis, use `ts_analyze_module_exports` directly.
  *
- * @param source_file_info The source file info (from Gro filer, file system, or other source)
- * @param ts_source_file TypeScript source file from the program
- * @param module_path The module path (relative to source root)
- * @param checker TypeScript type checker
- * @param options Module source options for path extraction
- * @param ctx Analysis context for collecting diagnostics
+ * @param source_file_info - the source file info (from Gro filer, file system, or other source)
+ * @param ts_source_file - TypeScript source file from the program
+ * @param module_path - the module path (relative to source root)
+ * @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
  */
 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;
@@ -83,10 +83,10 @@ export declare const ts_analyze_module: (source_file_info: SourceFileInfo, ts_so
  * suitable for building documentation, API explorers, or analysis tools.
  * For standard SvelteKit library layouts, use `module_create_source_options(process.cwd())`.
  *
- * @param source_file The TypeScript source file to analyze
- * @param checker The TypeScript type checker
- * @param options Module source options for path extraction in re-exports
- * @param ctx Analysis context for collecting diagnostics
+ * @param source_file - the TypeScript source file to analyze
+ * @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
  */
 export declare const ts_analyze_module_exports: (source_file: ts.SourceFile, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleExportsAnalysis;
@@ -97,10 +97,10 @@ export declare const ts_analyze_module_exports: (source_file: ts.SourceFile, che
  * type analysis to produce complete declaration metadata. Suitable for use
  * in documentation generators, IDE integrations, and other tooling.
  *
- * @param symbol The TypeScript symbol to analyze
- * @param source_file The source file containing the symbol
- * @param checker The TypeScript type checker
- * @param ctx Optional analysis context for collecting diagnostics
+ * @param symbol - the TypeScript symbol to analyze
+ * @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
  */
 export declare const ts_analyze_declaration: (symbol: ts.Symbol, source_file: ts.SourceFile, checker: ts.TypeChecker, ctx: AnalysisContext) => DeclarationAnalysis;
@@ -130,9 +130,9 @@ export declare const ts_infer_declaration_kind: (symbol: ts.Symbol, node: ts.Nod
  * Shared helper for extracting parameter information from both standalone functions
  * and class methods/constructors.
  *
- * @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)
+ * @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
  */
 export declare const ts_extract_signature_parameters: (sig: ts.Signature, checker: ts.TypeChecker, tsdoc_params: Map<string, string> | undefined) => Array<{

package/dist/ts_helpers.js

@@ -11,8 +11,8 @@ import { module_extract_dependencies, module_extract_path, module_is_source, } f
 /**
  * Create TypeScript program for analysis.
  *
- * @param options Configuration options for program creation
- * @param log Optional logger for info messages
+ * @param options - configuration options for program creation
+ * @param log - optional logger for info messages
  * @returns The program and type checker
  * @throws Error if tsconfig.json is not found
  */
@@ -42,12 +42,12 @@ export const ts_create_program = (options, log) => {
  * This is a high-level function suitable for building documentation or library metadata.
  * For lower-level analysis, use `ts_analyze_module_exports` directly.
  *
- * @param source_file_info The source file info (from Gro filer, file system, or other source)
- * @param ts_source_file TypeScript source file from the program
- * @param module_path The module path (relative to source root)
- * @param checker TypeScript type checker
- * @param options Module source options for path extraction
- * @param ctx Analysis context for collecting diagnostics
+ * @param source_file_info - the source file info (from Gro filer, file system, or other source)
+ * @param ts_source_file - TypeScript source file from the program
+ * @param module_path - the module path (relative to source root)
+ * @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
  */
 export const ts_analyze_module = (source_file_info, ts_source_file, module_path, checker, options, ctx) => {
@@ -78,10 +78,10 @@ export const ts_analyze_module = (source_file_info, ts_source_file, module_path,
  * suitable for building documentation, API explorers, or analysis tools.
  * For standard SvelteKit library layouts, use `module_create_source_options(process.cwd())`.
  *
- * @param source_file The TypeScript source file to analyze
- * @param checker The TypeScript type checker
- * @param options Module source options for path extraction in re-exports
- * @param ctx Analysis context for collecting diagnostics
+ * @param source_file - the TypeScript source file to analyze
+ * @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
  */
 export const ts_analyze_module_exports = (source_file, checker, options, ctx) => {
@@ -180,10 +180,10 @@ export const ts_analyze_module_exports = (source_file, checker, options, ctx) =>
  * type analysis to produce complete declaration metadata. Suitable for use
  * in documentation generators, IDE integrations, and other tooling.
  *
- * @param symbol The TypeScript symbol to analyze
- * @param source_file The source file containing the symbol
- * @param checker The TypeScript type checker
- * @param ctx Optional analysis context for collecting diagnostics
+ * @param symbol - the TypeScript symbol to analyze
+ * @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
  */
 export const ts_analyze_declaration = (symbol, source_file, checker, ctx) => {
@@ -325,9 +325,9 @@ export const ts_infer_declaration_kind = (symbol, node) => {
  * Shared helper for extracting parameter information from both standalone functions
  * and class methods/constructors.
  *
- * @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)
+ * @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
  */
 export const ts_extract_signature_parameters = (sig, checker, tsdoc_params) => {

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,7 +103,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
+ * @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;

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,7 +182,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
+ * @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) => {

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.0",
   "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": {
@@ -81,7 +82,7 @@
     "@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_util": "^0.55.0",
     "@fuzdev/gro": "^0.197.0",
     "@jridgewell/trace-mapping": "^0.3.31",
     "@ryanatkn/eslint-config": "^0.10.1",

package/src/lib/analysis_context.ts

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