api #

Attaches the 'uncoughtException' event to despawn all processes, and enables custom error logging with to_error_label.

Benchmark class for measuring and comparing function performance.

Compare benchmark results against the stored baseline.

Format a baseline comparison result as a human-readable string.

Format a baseline comparison result as JSON for programmatic consumption.

Load the current baseline from disk.

Save benchmark results as the current baseline.

Format results as JSON.

Format results as a Markdown table with key metrics. All times use the same unit for easy comparison.

Format results as grouped Markdown tables with headers between groups.

Format a number with fixed decimal places and thousands separators.

Format results as an ASCII table with percentiles, min/max, and relative performance. All times use the same unit for easy comparison.

Format results as a grouped table with visual separators between groups.

Compare two benchmark results for statistical significance. Uses Welch's t-test (handles unequal variances) and Cohen's d effect size.

Warmup function by running it multiple times. Detects whether the function is async based on return value.

Schema for the complete baseline file.

Options for comparing against a baseline.

Result of comparing current results against a baseline.

Schema for a single benchmark entry in the baseline.

Options for loading a baseline.

Options for saving a baseline.

Comparison result for a single task.

Options for benchmark comparison.

Result from comparing two benchmark stats.

Configuration options for a benchmark suite.

Options for table formatting.

A group definition for organizing benchmark results.

Result from running a single benchmark task.

Complete statistical analysis of timing measurements. Includes outlier detection, descriptive statistics, and performance metrics. All timing values are in nanoseconds.

Minimal stats interface for comparison. This allows comparing stats from different sources (e.g., loaded baselines).

A benchmark task to execute.

Returns n bounded to min and max.

Compares two map entries for sorting purposes. If the key is a string, it uses localeCompare for comparison. For other types, it uses >.

Component prop information for Svelte components.

Kept distinct from ParameterInfo despite structural similarity. Component props are named attributes with different semantics: no positional order when passing (<Foo {a} {b} /> = <Foo {b} {a} />), support two-way binding via $bindable rune.

Configures the module-level styling function for colored output.

Returns the count of graphemes in a string, the individually rendered characters.

Useful for fast counting when .length is not available.

Creates a string id generator function, outputting ${name}_${count} by default.

Creates a counter constructor function, starting at 0.

Creates a object with a promise and its resolve/reject handlers.

Seeded pseudo-random number generator. DO NOT USE when security matters, use webcrypto APIs instead.

Tracks elapsed time in milliseconds.

Generate TypeScript import statement for a declaration.

Format declaration name with generic parameters for display.

Metadata for an exported declaration (function, type, class, component, etc.).

Extracted from TypeScript source and JSDoc/TSDoc comments at build time.

The kind of exported declaration.

Deep equality comparison that checks both structure and type.

Key behaviors:

- Compares by constructor to prevent type confusion (security: {} ≠ [], {} ≠ new Map(), new ClassA() ≠ new ClassB()) - Prevents asymmetry bugs: deep_equal(a, b) always equals deep_equal(b, a) - Compares only enumerable own properties (ignores prototypes, symbols, non-enumerable) - Special handling for: Date (timestamp), Number/Boolean (boxed primitives), Error (message/name) - Promises always return false (cannot be meaningfully compared) - Maps/Sets compare by reference for object keys/values

Creates a deferred object with a promise and its resolve/reject handlers.

Removes leading and trailing spaces from each line of a string.

Converts a serialized cache string to a FetchValueCache.

Kills a child process and returns a SpawnResult.

Kills all globally registered child processes.

Runs an async function on each item with controlled concurrency. Like map_concurrent but doesn't collect results (more efficient for side effects).

Effect size magnitude interpretation (Cohen's d).

Frozen empty object with no properties, good for options default values.

Adds the substring ensured to the end of the source string if it's not already present.

Adds the substring ensured to the start of the source string if it's not already present.

Escapes a string for literal matching in a RegExp.

Specializes fetch with some slightly different behavior and additional features:

- throws on ratelimit errors to mitigate unintentional abuse - optional parse function called on the return value - optional cache (different from the browser cache, the caller can serialize it so e.g. dev setups can avoid hitting the network) - optional simplified API for authorization and data types (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, but returns a Result in all other cases. Handling ratelimit headers with more sophistication gets tricky because behavior differs across services. (e.g. Mastodon returns an ISO string for x-ratelimit-reset, but GitHub returns Date.now()/1000, and other services may do whatever, or even use a different header)

It's also stateless to avoid the complexity and bugs, so we don't try to track x-ratelimit-remaining per domain.

If the value is cached, only the cached safe subset of the headers are returned. (currently just etag and last-modified) Otherwise the full res.headers are included.

A filter function for file paths only.

The Flavored and Branded type helpers add varying degrees of nominal typing to other types. This is especially useful with primitives like strings and numbers.

Format a number with fixed decimal places and thousands separators.

Formats a URL by removing 'https://', 'www.', and trailing slashes. Notably it does not remove 'http://', so the user can see that it's insecure.

Empties a directory, recursively by default. If should_remove is provided, only entries where it returns true are removed.

Checks if a file or directory exists.

Generic type parameter information.

Returns the global git config setting for pull.rebase.

Checks the git workspace status using a single git status --porcelain -z call. The -z format provides more reliable parsing by using NUL separators and avoiding escaping.

Calls git checkout and throws if anything goes wrong.

Clones a branch locally to another directory and updates the origin to match the source.

Returns the hash of the current branch's first commit or throws if something goes wrong.

Returns the current git branch name or throws if something goes wrong.

Returns the branch's latest commit hash or throws if something goes wrong.

Deletes a branch locally and throws if anything goes wrong.

Deletes a branch remotely and throws if anything goes wrong.

Calls git fetch and throws if anything goes wrong.

Get basic git info (commit hash and branch name) without throwing. Returns null values if git commands fail (e.g., not in a git repo).

Parses the output of git status --porcelain -z (v1 format) into a status object. This is a pure function that can be tested independently.

Format: XY path\0 where: - X = staged status (index) - Y = unstaged status (work tree) - path = file path (unescaped with -z)

Supported status codes: - M = modified - A = added - D = deleted - R = renamed - C = copied - T = type changed (regular file, symbolic link or submodule) - U = unmerged - ? = untracked - ! = ignored

For renames/copies: XY new\0old\0 (two NUL-separated paths)

Note: This implementation treats submodules the same as regular files. Submodule-specific status codes (lowercase m, ?) are interpreted as changes.

Calls git pull and throws if anything goes wrong.

Calls git push and throws if anything goes wrong.

Calls git push and throws if anything goes wrong.

Resets the target branch back to its first commit both locally and remotely.

Converts a workspace status to a human-readable message.

Basic git repository info.

Git workspace status flags indicating which types of changes are present.

We register spawned processes gloabally so we can gracefully exit child processes. Otherwise, errors can cause zombie processes, sometimes blocking ports even!

golden ratio/mean constants, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**2, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**2), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**3, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**3), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**4, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**4), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**5, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**5), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**6, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**6), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**7, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**7), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**8, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**8), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, GR**9, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/(GR**9), useful for scaling: https://wikipedia.org/wiki/Golden_ratio

golden ratio/mean constants, 1/GR, useful for scaling: https://wikipedia.org/wiki/Golden_ratio

Handles the value of an event's target and invokes a callback. Defaults to swallowing the event to prevent default actions and propagation.

Converts a hex color to an RGB color.

Converts an HSL color value to RGB. Conversion formula adapted from http://wikipedia.org/wiki/HSL_color_space. Values h/s/l are in the range [0,1] and returns r/g/b in the range [0,255].

Returns the first arg.

Returns true if the element is within a contenteditable ancestor.

Checks if the given element is editable. Returns true for text-based input types, textareas, and contenteditable elements.

Returns a boolean indicating if the current browser window, if any, is iframed inside of another.

Checks if the element is interactive (clickable, focusable, or otherwise accepts user input). Returns true for buttons, links, form controls, and elements with interactive attributes and ARIA roles.

Returns a boolean indicating if value is a plain object, possibly created with Object.create(null). But warning! This fails for some obscure corner cases, use a proper library for weird things.

Checks if value is a Promise (or thenable).

Loosely validates a UUID string.

Embeds data as a JSON string, escaping single quotes. Useful for optimizing JSON in JS because it parses faster.