@fuzdev/fuz_util 0.55.0 → 0.56.0

package/dist/benchmark_format.d.ts

@@ -2,9 +2,9 @@ import type { BenchmarkResult, BenchmarkGroup } from './benchmark_types.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
@@ -21,9 +21,9 @@ export declare const benchmark_format_table: (results: Array<BenchmarkResult>, b
 /**
  * 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
@@ -37,9 +37,9 @@ export declare const benchmark_format_table: (results: Array<BenchmarkResult>, b
 export declare const benchmark_format_markdown: (results: Array<BenchmarkResult>, baseline?: string) => string;
 /**
  * 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
@@ -68,8 +68,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
@@ -82,9 +82,9 @@ export interface BenchmarkFormatJsonOptions {
 export declare const benchmark_format_json: (results: Array<BenchmarkResult>, options?: BenchmarkFormatJsonOptions) => string;
 /**
  * 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
@@ -108,7 +108,7 @@ export declare const benchmark_format_json: (results: Array<BenchmarkResult>, op
 export declare const benchmark_format_table_grouped: (results: Array<BenchmarkResult>, groups: Array<BenchmarkGroup>) => string;
 /**
  * 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 declare const benchmark_format_number: (n: number, decimals?: number) => string;
 //# sourceMappingURL=benchmark_format.d.ts.map

package/dist/benchmark_format.js

@@ -4,9 +4,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
@@ -105,9 +105,9 @@ export const benchmark_format_table = (results, baseline) => {
 /**
  * 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
@@ -200,9 +200,9 @@ export const benchmark_format_markdown = (results, baseline) => {
 };
 /**
  * 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
@@ -248,8 +248,8 @@ export const benchmark_format_markdown_grouped = (results, groups) => {
 };
 /**
  * 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
@@ -290,9 +290,9 @@ export const benchmark_format_json = (results, options) => {
 };
 /**
  * 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
@@ -339,6 +339,6 @@ export const benchmark_format_table_grouped = (results, groups) => {
 };
 /**
  * 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/dist/benchmark_stats.d.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
@@ -117,10 +117,10 @@ export declare 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/dist/benchmark_stats.js

@@ -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
@@ -117,10 +117,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/dist/benchmark_types.d.ts

@@ -35,7 +35,7 @@ export interface BenchmarkConfig {
     max_iterations?: number;
     /**
      * Custom timer to use for measurements.
-     * Default: timer_default (auto-detects environment)
+     * Default: `timer_default` (auto-detects environment)
      */
     timer?: Timer;
     /**
@@ -47,9 +47,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
@@ -82,9 +82,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/dist/bytes.d.ts

@@ -7,15 +7,15 @@
  * 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 declare 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 declare const format_bytes: (n: number) => string;
 //# sourceMappingURL=bytes.d.ts.map

package/dist/bytes.js

@@ -8,8 +8,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) => {
     if (typeof data === 'string')
@@ -23,8 +23,8 @@ export const to_bytes = (data) => {
 /**
  * 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) => {
     if (n < 1024)

package/dist/dag.d.ts

@@ -73,8 +73,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 declare const run_dag: <T extends DagNode>(options: DagOptions<T>) => Promise<DagResult>;
 //# sourceMappingURL=dag.d.ts.map

package/dist/dag.js

@@ -18,8 +18,8 @@ import { topological_sort } from './sort.js';
  * 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 (options) => {
     const { nodes, execute, on_error, on_skip, should_skip, max_concurrency = Infinity, stop_on_failure = true, skip_validation = false, } = options;

package/dist/deep_equal.d.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 declare const deep_equal: (a: unknown, b: unknown) => boolean;

package/dist/deep_equal.js

@@ -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, b) => {

package/dist/diff.d.ts

@@ -11,17 +11,17 @@ 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 declare const diff_lines: (a: string, b: string) => Array<DiffLine>;
 /**
  * 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 declare const filter_diff_context: (diff: Array<DiffLine>, context_lines?: number) => Array<DiffLine>;
 /**
@@ -38,24 +38,24 @@ 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 declare const format_diff: (diff: Array<DiffLine>, current_path: string, desired_path: string, options?: FormatDiffOptions) => string;
 /**
  * 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 declare const generate_diff: (current: string, desired: string, path: string, options?: FormatDiffOptions) => string | null;
 //# sourceMappingURL=diff.d.ts.map

package/dist/diff.js

@@ -7,9 +7,9 @@ import { string_is_binary } from './string.js';
 /**
  * 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, b) => {
     const a_lines = a.split('\n');
@@ -84,9 +84,9 @@ const compute_lcs = (a, b) => {
 /**
  * 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, context_lines = 3) => {
     if (diff.length === 0)
@@ -131,11 +131,11 @@ const colors = {
 /**
  * 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, current_path, desired_path, options = {}) => {
     const { prefix = '', use_color = true, max_lines = 50 } = options;
@@ -165,14 +165,14 @@ export const format_diff = (diff, current_path, desired_path, options = {}) => {
 /**
  * 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, desired, path, options = {}) => {
     // Skip binary files

package/dist/dom.d.ts

@@ -15,11 +15,11 @@ export declare const inside_editable: (el: Element) => boolean;
 export declare 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 declare const swallow: <T extends Pick<Event, "preventDefault" | "stopPropagation" | "stopImmediatePropagation">>(event: T, immediate?: boolean, preventDefault?: boolean) => T;
 /**

package/dist/dom.js

@@ -52,11 +52,11 @@ export const is_interactive = (el) => {
 };
 /**
  * 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 = (event, immediate = true, preventDefault = true) => {
     if (preventDefault)

package/dist/fetch.d.ts

@@ -26,7 +26,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/dist/fetch.js

@@ -14,7 +14,7 @@ const DEFAULT_GITHUB_API_VERSION_HEADER = '2022-11-28';
  *   (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/dist/git.d.ts

@@ -62,7 +62,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 declare const git_parse_workspace_status: (stdout: string | null) => GitWorkspaceStatus;

package/dist/git.js

@@ -82,7 +82,7 @@ export const git_local_branch_exists = async (branch, options) => {
  * 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) => {

package/dist/hash.d.ts

@@ -11,28 +11,28 @@
  * 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 declare 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 declare 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 declare 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 declare const hash_sha512: (data: BufferSource | string) => Promise<string>;
 /**
@@ -42,8 +42,8 @@ export declare const hash_sha512: (data: BufferSource | string) => Promise<strin
  * 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 declare const hash_insecure: (data: BufferSource | string) => string;
 //# sourceMappingURL=hash.d.ts.map

package/dist/hash.js

@@ -12,9 +12,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, data) => {
     const buffer = typeof data === 'string' ? encoder.encode(data) : data;
@@ -25,28 +25,28 @@ const hash_webcrypto = async (algorithm, data) => {
  * 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) => hash_webcrypto('SHA-1', data);
 /**
  * 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) => hash_webcrypto('SHA-256', data);
 /**
  * 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) => hash_webcrypto('SHA-384', data);
 /**
  * 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) => hash_webcrypto('SHA-512', data);
 /**
@@ -56,8 +56,8 @@ export const hash_sha512 = (data) => hash_webcrypto('SHA-512', data);
  * 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) => {
     let hash = 5381; // DJB2 initial value, chosen empirically for good distribution

package/dist/hash_blake3.d.ts

@@ -18,7 +18,7 @@ export declare const blake3_ready: Promise<void>;
  * 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 declare const hash_blake3: (data: BufferSource | string) => string;
 /** Zod schema for a BLAKE3 hex hash — 64 lowercase hex characters (256-bit output). */

package/dist/hash_blake3.js

@@ -21,7 +21,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) => to_hex(hash(to_bytes(data)));
 /** Zod schema for a BLAKE3 hex hash — 64 lowercase hex characters (256-bit output). */