@stanfordspezi/spezi-web-design-system/dist/src/utils/misc/misc.d.ts

Stanford Biodesign Digital Health Spezi Web Design System

import { UrlObject } from 'url';
/**
 * When `true`, the component will render its child as the root element
 * instead of creating a new DOM element. This allows passing the component's
 * props and styling to a custom child component using Radix UI's Slot pattern.
 *
 * Two major use cases:
 *  - to reuse styles of a component, but render it using different element
 *  - to inject event handlers without passing them manually
 *
 * @example
 * // Renders a link as a badge
 * <Badge asChild>
 *   <a href="https://example.com">Link Badge</a>
 * </Badge>
 *
 * @default false
 */
export type AsChildProp = boolean;
/**
 * Negates value.
 * Useful for functional patterns and state callbacks.
 */
export declare const not: (value: unknown) => boolean;
/**
 * Type representing a value that can be either a direct value or a function that returns that value.
 * Useful for lazy initialization of state values.
 */
export type InitialState<T> = T | (() => T);
/**
 * Type representing a value that can be null or undefined.
 * Shorthand for `T | null | undefined`.
 */
export type Nil<T> = T | null | undefined;
/**
 * Type representing a URL that can be either a string or a URL object.
 */
export type Url = string | UrlObject;
/**
 * Make some fields in the object partial.
 *
 * @example
 * PartialSome<{ a: string, b: string, c: string }, 'a'> => { a?: string, b: string, c: string }
 */
export type PartialSome<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
/**
 * Make provided fields in the object required and the rest of fields partial.
 *
 * @example
 * RequiredSome<{ a: string, b: string, c: string }, 'a'> => { a: string, b?: string, c?: string }
 */
export type RequiredSome<T, K extends keyof T> = Partial<Omit<T, K>> & Required<Pick<T, K>>;
/**
 * Handles copying to clipboard and show confirmation toast.
 */
export declare const copyToClipboard: (value: string) => Promise<void>;
/**
 * Makes first letter uppercased.
 * @example upperFirst("lorem ipsum") => "Lorem ipsum"
 */
export declare const upperFirst: (value: string) => string;
/**
 * Generates an array with a specified length.
 */
export declare const times: <T>(length: number, callback: (index: number) => T) => T[];
/**
 * Utility to dynamically resolve a strategy pattern.
 *
 * Provides correct types for enums, guaranteeing that `record` provides every enum key.
 *
 * @example
 * enum Message {
 *   success
 *   error
 * }
 * strategy({
 *   [Message.success]: "Saving file worked!",
 *   [Message.error]: "Saving file failed. Please try again later!",
 * }, Message.error) // "Saving file failed. Please try again later!"
 */
export declare const strategy: <T extends string | number | symbol, F>(record: Record<T, F>, enumValue: T) => Record<T, F>[T];
/**
 * Ensures a value is a string, returning undefined if it's not.
 *
 * @example
 * ensureString("hello"); // "hello"
 * ensureString(123); // undefined
 */
export declare const ensureString: (value: unknown) => string | undefined;
/**
 * Type guard to check if a value is an object (and not null).
 *
 * @example
 * isObject({}); // true
 * isObject([]); // true
 * isObject(null); // false
 * isObject("string"); // false
 */
export declare const isObject: (value: unknown) => value is object;
interface IsEmptyFunction {
    (value: string): value is "";
    (value: null | undefined): value is null | undefined;
    (value: unknown): boolean;
}
/**
 * Checks if a value is empty.
 * Handles strings, null/undefined, arrays, objects, and collections with size property.
 *
 * @example
 * isEmpty(""); // true
 * isEmpty(null); // true
 * isEmpty([]); // true
 * isEmpty({}); // true
 * isEmpty(new Set()); // true
 * isEmpty("hello"); // false
 * isEmpty([1, 2, 3]); // false
 */
export declare const isEmpty: IsEmptyFunction;
export {};