@fuzdev/fuz_util 0.55.0 → 0.56.0

package/src/lib/benchmark.ts

@@ -44,8 +44,8 @@ import type {
 const DEFAULT_DURATION_MS = 1000;
 const DEFAULT_WARMUP_ITERATIONS = 10;
 const DEFAULT_COOLDOWN_MS = 100;
-const DEFAULT_MIN_ITERATIONS = 10;
-const DEFAULT_MAX_ITERATIONS = 100_000;
+const DEFAULT_ITERATIONS_MIN = 10;
+const DEFAULT_ITERATIONS_MAX = 100_000;
 
 /**
  * Validate and normalize benchmark configuration.
@@ -90,10 +90,10 @@ interface BenchmarkTaskInternal extends BenchmarkTask {
  * Warmup function by running it multiple times.
  * Detects whether the function is async based on return value.
  *
- * @param fn - Function to warmup (sync or async)
- * @param iterations - Number of warmup iterations
- * @param async_hint - If provided, use this instead of detecting
- * @returns Whether the function is async
+ * @param fn - function to warmup (sync or async)
+ * @param iterations - number of warmup iterations
+ * @param async_hint - if provided, use this instead of detecting
+ * @returns whether the function is async
  *
  * @example
  * ```ts
@@ -146,8 +146,8 @@ export class Benchmark {
 			duration_ms: config.duration_ms ?? DEFAULT_DURATION_MS,
 			warmup_iterations: config.warmup_iterations ?? DEFAULT_WARMUP_ITERATIONS,
 			cooldown_ms: config.cooldown_ms ?? DEFAULT_COOLDOWN_MS,
-			min_iterations: config.min_iterations ?? DEFAULT_MIN_ITERATIONS,
-			max_iterations: config.max_iterations ?? DEFAULT_MAX_ITERATIONS,
+			min_iterations: config.min_iterations ?? DEFAULT_ITERATIONS_MIN,
+			max_iterations: config.max_iterations ?? DEFAULT_ITERATIONS_MAX,
 			timer: config.timer ?? timer_default,
 			on_iteration: config.on_iteration,
 			on_task_complete: config.on_task_complete,
@@ -156,9 +156,9 @@ export class Benchmark {
 
 	/**
 	 * Add a benchmark task.
-	 * @param name - Task name or full task object
+	 * @param name - task name or full task object
 	 * @param fn - Function to benchmark (if name is string). Return values are ignored.
-	 * @returns This Benchmark instance for chaining
+	 * @returns this `Benchmark` instance for chaining
 	 *
 	 * @example
 	 * ```ts
@@ -194,8 +194,8 @@ export class Benchmark {
 
 	/**
 	 * Remove a benchmark task by name.
-	 * @param name - Name of the task to remove
-	 * @returns This Benchmark instance for chaining
+	 * @param name - name of the task to remove
+	 * @returns this `Benchmark` instance for chaining
 	 * @throws Error if task with given name doesn't exist
 	 *
 	 * @example
@@ -217,8 +217,8 @@ export class Benchmark {
 
 	/**
 	 * Mark a task to be skipped during benchmark runs.
-	 * @param name - Name of the task to skip
-	 * @returns This Benchmark instance for chaining
+	 * @param name - name of the task to skip
+	 * @returns this `Benchmark` instance for chaining
 	 * @throws Error if task with given name doesn't exist
 	 *
 	 * @example
@@ -240,8 +240,8 @@ export class Benchmark {
 
 	/**
 	 * Mark a task to run exclusively (along with other `only` tasks).
-	 * @param name - Name of the task to run exclusively
-	 * @returns This Benchmark instance for chaining
+	 * @param name - name of the task to run exclusively
+	 * @returns this `Benchmark` instance for chaining
 	 * @throws Error if task with given name doesn't exist
 	 *
 	 * @example
@@ -264,7 +264,7 @@ export class Benchmark {
 
 	/**
 	 * Run all benchmark tasks.
-	 * @returns Array of benchmark results
+	 * @returns array of benchmark results
 	 */
 	async run(): Promise<Array<BenchmarkResult>> {
 		this.#results = [];
@@ -385,8 +385,8 @@ export class Benchmark {
 
 	/**
 	 * Format results as an ASCII table with percentiles, min/max, and relative performance.
-	 * @param options - Formatting options
-	 * @returns Formatted table string
+	 * @param options - formatting options
+	 * @returns formatted table string
 	 *
 	 * @example
 	 * ```ts
@@ -410,8 +410,8 @@ export class Benchmark {
 
 	/**
 	 * Format results as a Markdown table.
-	 * @param options - Formatting options (groups for organized output with optional baselines)
-	 * @returns Formatted markdown string
+	 * @param options - formatting options (groups for organized output with optional baselines)
+	 * @returns formatted markdown string
 	 *
 	 * @example
 	 * ```ts
@@ -435,7 +435,7 @@ export class Benchmark {
 
 	/**
 	 * Format results as JSON.
-	 * @param options - Formatting options (pretty, include_timings)
+	 * @param options - formatting options (pretty, include_timings)
 	 * @returns JSON string
 	 */
 	json(options?: BenchmarkFormatJsonOptions): string {
@@ -445,7 +445,7 @@ export class Benchmark {
 	/**
 	 * Get the benchmark results.
 	 * Returns a shallow copy to prevent external mutation.
-	 * @returns Array of benchmark results
+	 * @returns array of benchmark results
 	 */
 	results(): Array<BenchmarkResult> {
 		return [...this.#results];
@@ -453,7 +453,7 @@ export class Benchmark {
 
 	/**
 	 * Check if the benchmark has been run and has results.
-	 * @returns True if results are available
+	 * @returns true if results are available
 	 *
 	 * @example
 	 * ```ts
@@ -469,7 +469,7 @@ export class Benchmark {
 	/**
 	 * Get results as a map for convenient lookup by task name.
 	 * Returns a new Map each call to prevent external mutation.
-	 * @returns Map of task name to benchmark result
+	 * @returns map of task name to benchmark result
 	 *
 	 * @example
 	 * ```ts
@@ -487,7 +487,7 @@ export class Benchmark {
 	/**
 	 * Reset the benchmark results.
 	 * Keeps tasks intact so benchmarks can be rerun.
-	 * @returns This Benchmark instance for chaining
+	 * @returns this `Benchmark` instance for chaining
 	 */
 	reset(): this {
 		this.#results = [];
@@ -497,7 +497,7 @@ export class Benchmark {
 	/**
 	 * Clear everything (results and tasks).
 	 * Use this to start fresh with a new set of benchmarks.
-	 * @returns This Benchmark instance for chaining
+	 * @returns this `Benchmark` instance for chaining
 	 */
 	clear(): this {
 		this.#results = [];
@@ -507,7 +507,7 @@ export class Benchmark {
 
 	/**
 	 * Get a quick text summary of the fastest task.
-	 * @returns Human-readable summary string
+	 * @returns human-readable summary string
 	 *
 	 * @example
 	 * ```ts

package/src/lib/benchmark_baseline.ts

@@ -161,8 +161,8 @@ const results_to_entries = (results: Array<BenchmarkResult>): Array<BenchmarkBas
 /**
  * Save benchmark results as the current baseline.
  *
- * @param results - Benchmark results to save
- * @param options - Save options
+ * @param results - benchmark results to save
+ * @param options - save options
  *
  * @example
  * ```ts
@@ -204,8 +204,8 @@ export const benchmark_baseline_save = async (
 /**
  * Load the current baseline from disk.
  *
- * @param options - Load options
- * @returns The baseline, or null if not found or invalid
+ * @param options - load options
+ * @returns the baseline, or null if not found or invalid
  *
  * @example
  * ```ts
@@ -255,9 +255,9 @@ export const benchmark_baseline_load = async (
 /**
  * Compare benchmark results against the stored baseline.
  *
- * @param results - Current benchmark results
- * @param options - Comparison options including regression threshold and staleness warning
- * @returns Comparison result with regressions, improvements, and unchanged tasks
+ * @param results - current benchmark results
+ * @param options - comparison options including regression threshold and staleness warning
+ * @returns comparison result with regressions, improvements, and unchanged tasks
  *
  * @example
  * ```ts
@@ -420,8 +420,8 @@ export const benchmark_baseline_compare = async (
 /**
  * Format a baseline comparison result as a human-readable string.
  *
- * @param result - Comparison result from benchmark_baseline_compare
- * @returns Formatted string summary
+ * @param result - comparison result from `benchmark_baseline_compare`
+ * @returns formatted string summary
  */
 export const benchmark_baseline_format = (result: BenchmarkBaselineComparisonResult): string => {
 	if (!result.baseline_found) {
@@ -506,8 +506,8 @@ export const benchmark_baseline_format = (result: BenchmarkBaselineComparisonRes
 /**
  * Format a baseline comparison result as JSON for programmatic consumption.
  *
- * @param result - Comparison result from benchmark_baseline_compare
- * @param options - Formatting options
+ * @param result - comparison result from `benchmark_baseline_compare`
+ * @param options - formatting options
  * @returns JSON string
  */
 export const benchmark_baseline_format_json = (

package/src/lib/benchmark_format.ts

@@ -6,9 +6,9 @@ import {format_number} from './maths.js';
 /**
  * Format results as an ASCII table with percentiles, min/max, and relative performance.
  * All times use the same unit for easy comparison.
- * @param results - Array of benchmark results
- * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
- * @returns Formatted table string with enhanced metrics
+ * @param results - array of benchmark results
+ * @param baseline - optional task name to use as baseline for comparison (defaults to fastest)
+ * @returns formatted table string with enhanced metrics
  *
  * @example
  * ```ts
@@ -126,9 +126,9 @@ export const benchmark_format_table = (
 /**
  * Format results as a Markdown table with key metrics.
  * All times use the same unit for easy comparison.
- * @param results - Array of benchmark results
- * @param baseline - Optional task name to use as baseline for comparison (defaults to fastest)
- * @returns Formatted markdown table string
+ * @param results - array of benchmark results
+ * @param baseline - optional task name to use as baseline for comparison (defaults to fastest)
+ * @returns formatted markdown table string
  *
  * @example
  * ```ts
@@ -238,9 +238,9 @@ export const benchmark_format_markdown = (
 
 /**
  * Format results as grouped Markdown tables with headers between groups.
- * @param results - Array of benchmark results
- * @param groups - Array of group definitions
- * @returns Formatted markdown string with group headers and tables
+ * @param results - array of benchmark results
+ * @param groups - array of group definitions
+ * @returns formatted markdown string with group headers and tables
  *
  * @example
  * ```ts
@@ -301,8 +301,8 @@ export interface BenchmarkFormatJsonOptions {
 
 /**
  * Format results as JSON.
- * @param results - Array of benchmark results
- * @param options - Formatting options
+ * @param results - array of benchmark results
+ * @param options - formatting options
  * @returns JSON string
  *
  * @example
@@ -348,9 +348,9 @@ export const benchmark_format_json = (
 
 /**
  * Format results as a grouped table with visual separators between groups.
- * @param results - Array of benchmark results
- * @param groups - Array of group definitions
- * @returns Formatted table string with group separators
+ * @param results - array of benchmark results
+ * @param groups - array of group definitions
+ * @returns formatted table string with group separators
  *
  * @example
  * ```ts
@@ -405,6 +405,6 @@ export const benchmark_format_table_grouped = (
 
 /**
  * Format a number with fixed decimal places and thousands separators.
- * @see {@link format_number} in maths.ts for the underlying implementation.
+ * @see `format_number` in `maths.ts` for the underlying implementation.
  */
 export const benchmark_format_number = format_number;

package/src/lib/benchmark_stats.ts

@@ -1,6 +1,6 @@
 /**
  * Benchmark-specific statistical analysis.
- * Uses the general stats utilities from stats.ts for timing/performance analysis.
+ * Uses the general stats utilities from `stats.ts` for timing/performance analysis.
  * All timing values are in nanoseconds.
  *
  * @module
@@ -204,10 +204,10 @@ export class BenchmarkStats {
  * calibrated for social science and produce false positives in benchmarking
  * where within-run variance is tight.
  *
- * @param a - First benchmark stats (or any object with required properties)
- * @param b - Second benchmark stats (or any object with required properties)
- * @param options - Comparison options
- * @returns Comparison result with significance, effect size, and recommendation
+ * @param a - first benchmark stats (or any object with required properties)
+ * @param b - second benchmark stats (or any object with required properties)
+ * @param options - comparison options
+ * @returns comparison result with significance, effect size, and recommendation
  *
  * @example
  * ```ts

package/src/lib/benchmark_types.ts

@@ -41,7 +41,7 @@ export interface BenchmarkConfig {
 
 	/**
 	 * Custom timer to use for measurements.
-	 * Default: timer_default (auto-detects environment)
+	 * Default: `timer_default` (auto-detects environment)
 	 */
 	timer?: Timer;
 
@@ -54,9 +54,9 @@ export interface BenchmarkConfig {
 	 * after the timing capture. However, frequent GC calls will slow overall benchmark
 	 * execution time.
 	 *
-	 * @param task_name - Name of the current task being benchmarked
-	 * @param iteration - Current iteration number (1-indexed)
-	 * @param abort - Call to stop the benchmark early for this task
+	 * @param task_name - name of the current task being benchmarked
+	 * @param iteration - current iteration number (1-indexed)
+	 * @param abort - call to stop the benchmark early for this task
 	 *
 	 * @example
 	 * ```ts
@@ -90,9 +90,9 @@ export interface BenchmarkConfig {
 	 * Callback invoked after each task completes.
 	 * Useful for logging progress during long benchmark runs.
 	 *
-	 * @param result - The completed benchmark result
-	 * @param index - Zero-based index of the completed task
-	 * @param total - Total number of tasks to run
+	 * @param result - the completed benchmark result
+	 * @param index - zero-based index of the completed task
+	 * @param total - total number of tasks to run
 	 *
 	 * @example
 	 * ```ts

package/src/lib/bytes.ts

@@ -10,8 +10,8 @@ const encoder = new TextEncoder();
  * Converts string or binary data to a `Uint8Array`.
  * Strings are UTF-8 encoded. `Uint8Array` inputs are returned as-is.
  *
- * @param data - String or `BufferSource` to convert.
- * @returns `Uint8Array` view of the data.
+ * @param data - string or `BufferSource` to convert
+ * @returns `Uint8Array` view of the data
  */
 export const to_bytes = (data: BufferSource | string): Uint8Array => {
 	if (typeof data === 'string') return encoder.encode(data);
@@ -23,8 +23,8 @@ export const to_bytes = (data: BufferSource | string): Uint8Array => {
 /**
  * Formats a byte count as a human-readable string.
  *
- * @param n - byte count.
- * @returns formatted string like `'1.2 KB'` or `'3.4 MB'`.
+ * @param n - byte count
+ * @returns formatted string like `'1.2 KB'` or `'3.4 MB'`
  */
 export const format_bytes = (n: number): string => {
 	if (n < 1024) return n + ' B';

package/src/lib/dag.ts

@@ -80,8 +80,8 @@ export interface DagResult {
  * eligible to start. Failure cascading and stop-on-failure are handled
  * per the options.
  *
- * @param options - DAG execution options.
- * @returns Aggregated result with per-node details.
+ * @param options - DAG execution options
+ * @returns aggregated result with per-node details
  */
 export const run_dag = async <T extends DagNode>(options: DagOptions<T>): Promise<DagResult> => {
 	const {

package/src/lib/deep_equal.ts

@@ -10,8 +10,8 @@
  * - Promises always return false (cannot be meaningfully compared)
  * - Maps/Sets compare by reference for object keys/values
  *
- * @param a first value to compare
- * @param b second value to compare
+ * @param a - first value to compare
+ * @param b - second value to compare
  * @returns true if deeply equal, false otherwise
  */
 export const deep_equal = (a: unknown, b: unknown): boolean => {

package/src/lib/diff.ts

@@ -15,9 +15,9 @@ export interface DiffLine {
 /**
  * Generate a line-based diff between two strings using LCS algorithm.
  *
- * @param a - The original/current content.
- * @param b - The new/desired content.
- * @returns Array of diff lines with type annotations.
+ * @param a - the original/current content
+ * @param b - the new/desired content
+ * @returns array of diff lines with type annotations
  */
 export const diff_lines = (a: string, b: string): Array<DiffLine> => {
 	const a_lines = a.split('\n');
@@ -94,9 +94,9 @@ const compute_lcs = (a: Array<string>, b: Array<string>): Array<string> => {
 /**
  * Filter diff to only include lines within N lines of context around changes.
  *
- * @param diff - The full diff lines.
- * @param context_lines - Number of context lines to show around changes (default: 3).
- * @returns Filtered diff with ellipsis markers for skipped regions.
+ * @param diff - the full diff lines
+ * @param context_lines - number of context lines to show around changes (default: 3)
+ * @returns filtered diff with ellipsis markers for skipped regions
  */
 export const filter_diff_context = (diff: Array<DiffLine>, context_lines = 3): Array<DiffLine> => {
 	if (diff.length === 0) return [];
@@ -163,11 +163,11 @@ export interface FormatDiffOptions {
 /**
  * Format a diff for display.
  *
- * @param diff - The diff lines to format.
- * @param current_path - Path label for "current" content.
- * @param desired_path - Path label for "desired" content.
- * @param options - Formatting options.
- * @returns Formatted diff string.
+ * @param diff - the diff lines to format
+ * @param current_path - path label for "current" content
+ * @param desired_path - path label for "desired" content
+ * @param options - formatting options
+ * @returns formatted diff string
  */
 export const format_diff = (
 	diff: Array<DiffLine>,
@@ -208,14 +208,14 @@ export const format_diff = (
 /**
  * Generate a formatted diff between two strings.
  *
- * Combines diff_lines, filter_diff_context, and format_diff for convenience.
+ * Combines `diff_lines`, `filter_diff_context`, and `format_diff` for convenience.
  * Returns null if content is binary.
  *
- * @param current - Current content.
- * @param desired - Desired content.
- * @param path - File path for labels.
- * @param options - Formatting options.
- * @returns Formatted diff string, or null if binary.
+ * @param current - current content
+ * @param desired - desired content
+ * @param path - file path for labels
+ * @param options - formatting options
+ * @returns formatted diff string, or null if binary
  */
 export const generate_diff = (
 	current: string,

package/src/lib/dom.ts

@@ -60,11 +60,11 @@ export const is_interactive = (el: any): boolean => {
 
 /**
  * Stops an event from bubbling and doing default behavior.
- * @param event
- * @param immediate defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
- * @param preventDefault defaults to `true`
+ * @param event - the event to swallow
+ * @param immediate - defaults to `true` to use `stopImmediatePropagation` over `stopPropagation`
+ * @param preventDefault - defaults to `true`
+ * @returns the swallowed event
  * @mutates event - calls preventDefault(), stopPropagation(), or stopImmediatePropagation()
- * @returns
  */
 export const swallow = <
 	T extends Pick<Event, 'preventDefault' | 'stopPropagation' | 'stopImmediatePropagation'>,

package/src/lib/fetch.ts

@@ -34,7 +34,7 @@ export interface FetchValueOptions<TValue, TParams = undefined> {
  *   (you can still provide headers directly)
  *
  * Unlike `fetch`, this throws on ratelimits (status code 429)
- * to halt whatever is happpening in its tracks to avoid accidental abuse,
+ * to halt whatever is happening in its tracks to avoid accidental abuse,
  * but returns a `Result` in all other cases.
  * Handling ratelimit headers with more sophistication gets tricky because behavior
  * differs across services.

package/src/lib/git.ts

@@ -122,7 +122,7 @@ export interface GitWorkspaceStatus {
  * Note: This implementation treats submodules the same as regular files.
  * Submodule-specific status codes (lowercase m, ?) are interpreted as changes.
  *
- * @param stdout - The raw output from `git status --porcelain -z`
+ * @param stdout - the raw output from `git status --porcelain -z`
  * @returns status object with flags for unstaged changes, staged changes, and untracked files
  */
 export const git_parse_workspace_status = (stdout: string | null): GitWorkspaceStatus => {

package/src/lib/hash.ts

@@ -15,9 +15,9 @@ const encoder = new TextEncoder();
 /**
  * Computes a hash using Web Crypto API.
  *
- * @param algorithm - Web Crypto algorithm name (e.g. `'SHA-256'`).
+ * @param algorithm - Web Crypto algorithm name (e.g. `'SHA-256'`)
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns hexadecimal hash string.
+ * @returns hexadecimal hash string
  */
 const hash_webcrypto = async (algorithm: string, data: BufferSource | string): Promise<string> => {
 	const buffer = typeof data === 'string' ? encoder.encode(data) : data;
@@ -29,7 +29,7 @@ const hash_webcrypto = async (algorithm: string, data: BufferSource | string): P
  * Computes a SHA-1 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 40-character hexadecimal hash string.
+ * @returns 40-character hexadecimal hash string
  */
 export const hash_sha1 = (data: BufferSource | string): Promise<string> =>
 	hash_webcrypto('SHA-1', data);
@@ -38,7 +38,7 @@ export const hash_sha1 = (data: BufferSource | string): Promise<string> =>
  * Computes a SHA-256 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string.
+ * @returns 64-character hexadecimal hash string
  */
 export const hash_sha256 = (data: BufferSource | string): Promise<string> =>
 	hash_webcrypto('SHA-256', data);
@@ -47,7 +47,7 @@ export const hash_sha256 = (data: BufferSource | string): Promise<string> =>
  * Computes a SHA-384 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 96-character hexadecimal hash string.
+ * @returns 96-character hexadecimal hash string
  */
 export const hash_sha384 = (data: BufferSource | string): Promise<string> =>
 	hash_webcrypto('SHA-384', data);
@@ -56,7 +56,7 @@ export const hash_sha384 = (data: BufferSource | string): Promise<string> =>
  * Computes a SHA-512 hash using Web Crypto API.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 128-character hexadecimal hash string.
+ * @returns 128-character hexadecimal hash string
  */
 export const hash_sha512 = (data: BufferSource | string): Promise<string> =>
 	hash_webcrypto('SHA-512', data);
@@ -68,8 +68,8 @@ export const hash_sha512 = (data: BufferSource | string): Promise<string> =>
  * Note: Strings use UTF-16 code units, buffers use raw bytes.
  * For non-ASCII, `hash_insecure(str) !== hash_insecure(encoder.encode(str))`.
  *
- * @param data - String or binary data to hash.
- * @returns 8-character hex-encoded unsigned 32-bit hash.
+ * @param data - string or binary data to hash
+ * @returns 8-character hex-encoded unsigned 32-bit hash
  */
 export const hash_insecure = (data: BufferSource | string): string => {
 	let hash = 5381; // DJB2 initial value, chosen empirically for good distribution

package/src/lib/hash_blake3.ts

@@ -25,7 +25,7 @@ export const blake3_ready = init();
  * Computes a BLAKE3 hash synchronously.
  *
  * @param data - String or binary data to hash. Strings are UTF-8 encoded.
- * @returns 64-character hexadecimal hash string (32 bytes).
+ * @returns 64-character hexadecimal hash string (32 bytes)
  */
 export const hash_blake3 = (data: BufferSource | string): string => to_hex(hash(to_bytes(data)));
 

package/src/lib/hex.ts

@@ -7,8 +7,8 @@
 /**
  * Converts a `Uint8Array` to a lowercase hex string.
  *
- * @param bytes - Binary data to encode.
- * @returns Hex string with two characters per byte.
+ * @param bytes - binary data to encode
+ * @returns hex string with two characters per byte
  */
 export const to_hex = (bytes: Uint8Array): string => {
 	const lookup = get_byte_to_hex();
@@ -23,8 +23,8 @@ export const to_hex = (bytes: Uint8Array): string => {
  * Decodes a hex string to a `Uint8Array`.
  * Whitespace is stripped before parsing. Returns `null` for invalid hex.
  *
- * @param hex - Hex string to decode (case-insensitive, whitespace allowed).
- * @returns Decoded bytes, or `null` if the input is not valid hex.
+ * @param hex - hex string to decode (case-insensitive, whitespace allowed)
+ * @returns decoded bytes, or `null` if the input is not valid hex
  */
 export const from_hex = (hex: string): Uint8Array | null => {
 	const clean = hex.replace(/\s/g, '');

package/src/lib/json.ts

@@ -44,8 +44,8 @@ export const json_embed = <T>(data: T, stringify: (data: T) => string = JSON.str
  * Recursively sorts object keys alphabetically for consistent hashing.
  * Arrays and primitives are serialized as-is.
  *
- * @param value Any JSON-serializable value
- * @returns Deterministic JSON string representation
+ * @param value - any JSON-serializable value
+ * @returns deterministic JSON string representation
  */
 export const json_stringify_deterministic = (value: unknown): string =>
 	JSON.stringify(value, (_key, val) => {