Zitto

Zero-Dependency Utility • Runtime-Safe Options • Predictable Defaults • Strict Config Control

• Features
• Usage
• API
• Examples
• Changelog
• Support
• License
• Related
• Author

• ⚡ Always returns defaults when no opts passed
• 🛠 Merges known keys with defaults
• 🚫 Throws on unknown keys at runtime
• 🧩 Enforces object shape with TS and runtime
• 🔒 Strict variant drops extras automatically
• 🪶 Tiny zero-dep footprint
• 📦 Predictable results across runtimes

Install it by executing any of the following, depending on your preferred package manager:

pnpm add @igorskyflyer/zitto

yarn add @igorskyflyer/zitto

npm i @igorskyflyer/zitto

function defineOptions<T extends object>(
  defaults: T,
  options?: Partial<T>
): T

Merge defaults with optional user options.

T - Shape of the defaults object

defaults - Base configuration with required keys

options - Optional overrides, must be a subset of defaults

Returns a new object with defaults and overrides merged.

function defineStrictOptions<T extends object, U extends Partial<T>>(
  defaults: T,
  options?: U
): T

Merge defaults with optional user options, dropping unknown keys.

T - Shape of the defaults object

U - Subset of T allowed as overrides

defaults - Base configuration with required keys

options - Optional overrides, must be a subset of defaults

Throws a TypeError if options is not an object

Throws an Error if options contains unknown keys

Returns a new object with defaults and known overrides merged.

import { defineOptions, defineStrictOptions } from '@igorskyflyer/zitto'

const opts = defineOptions({ retries: 3, verbose: false }, { verbose: true })
// => { retries: 3, verbose: true }

const opts = defineStrictOptions({ retries: 3, verbose: false }, { retries: 5, extra: 'x' })
// => { retries: 5, verbose: false }  // 'extra' is dropped

📑 Read about the latest changes in the CHANGELOG.

Licensed under the MIT license.

I work hard for every project, including this one and your support means a lot to me!
Consider buying me a coffee. ☕



Thank you for supporting my efforts! 🙏😊

@igorskyflyer/strip-html

🥞 Removes HTML code from the given string. Can even extract text-only from the given an HTML string. ✨

@igorskyflyer/is-rootdir

🔼 Checks whether the given path is the root of a drive or filesystem. ⛔

@igorskyflyer/unc-path

🥽 Provides ways of parsing UNC paths and checking whether they are valid. 🎱

@igorskyflyer/regkeys

📚 A package for fetching Windows registry keys. 🗝

@igorskyflyer/rawelement

🐯 A utility that lets you manipulate HTML elements, their attributes and innerHTML as strings, on the go and then render the modified HTML. Very useful in SSG projects. 💤

Created by Igor Dimitrijević (@igorskyflyer).