api #

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

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.

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.

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.

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.

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.

Loosely validates a UUID string.

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

Serializes a value to JSON with deterministic key ordering. Recursively sorts object keys alphabetically for consistent hashing. Arrays and primitives are serialized as-is.

Returns the JsonType of value, which is like typeof json but includes 'array' and omits 'undefined'.

Like typeof json, but includes arrays. Excludes 'undefined' because it's not valid JSON.

Like keyof but works for type unions.

Linear interpolation between a and b by amount.

Creates a LibraryJson with computed properties from package.json and source metadata.

Extracts GitHub org URL from a library, e.g. https://github.com/ryanatkn.

Extracts repo name from a package name, e.g. @fuzdev/fuz_ui → fuz.

A library's package.json and source metadata with computed properties.

Parses and validates a log level string.

Converts a log level to its numeric value for comparison. Higher numbers indicate more verbose logging.

Console interface subset used by Logger for output. Allows custom console implementations for testing.

Simple, flexible logger with support for child loggers and automatic context.

Features: - Instance-based configuration (no global state) - Child loggers with automatic label concatenation - Parent chain inheritance for level, console, and colors - Respects NO_COLOR environment variable

Log level hierarchy from least to most verbose. - 'off': No logging - 'error': Only errors - 'warn': Errors and warnings - 'info': Errors, warnings, and info (default) - 'debug': All messages including debug

Maps over items with controlled concurrency, preserving input order.

Like map_concurrent but collects all results/errors instead of failing fast. Returns an array of settlement objects matching the Promise.allSettled pattern.

Iterated keys in for..in are always returned as strings, so to prevent usage errors the key type of mapper is always a string. Symbols are not enumerable as keys, so they're excluded.

A source file in src/lib/ with its exported declarations.

Does nothing when called.

Async function that returns a resolved promise.

Frozen object representing a failed result.

Frozen object representing a successful result.

Creates a new object without the specified keys.

omit_undefined is a commonly used form of pick_by. See this issue for why it's used so much: https://github.com/Microsoft/TypeScript/issues/13195

Package exports can be: 1. A string (shorthand for main export) 2. null (to block exports) 3. A record of export conditions/paths

Parameter information for functions and methods.

Kept distinct from ComponentPropInfo despite structural similarity. Function parameters form a tuple with positional semantics: calling order matters (fn(a, b) vs fn(b, a)), may include rest parameters and destructuring patterns.

Treats all paths as absolute, so the first piece is always a '/' with type 'separator'.

Gets the individual parts of a path, ignoring dots and separators.

A filter function for paths, can distinguish between files and directories.

An absolute path on the filesystem. Named "id" to be consistent with Rollup.

Basic information about a filesystem path.

A piece of a parsed path, either a path segment or separator.

Creates a new object with properties that pass the should_pick predicate.

Like Pick but works for type unions.

Returns a plural suffix based on a count.

Formats a boolean for printing.

Formats an error for printing. Because throwing errors and rejecting promises isn't typesafe, don't assume the arg is an Error and try to return something useful.

Formats a key-value pair for printing.