import type { CreateOptions } from './types.ts';
/**
 * Create an HTML element with full declarative configuration.
 *
 * Combines element creation with class, style, attribute, children,
 * and event binding in a single call — reducing imperative boilerplate.
 *
 * @example
 *     const card = create('div', {
 *         text: 'Hello',
 *         css: { padding: '1rem', '--theme': 'dark' },
 *         attrs: { 'data-id': '123' },
 *         class: ['card', 'active'],
 *         children: [create('span', { text: 'child' }), 'text node'],
 *         on: { click: handler },
 *         signal: controller.signal
 *     });
 */
export declare function create<K extends keyof HTMLElementTagNameMap>(tag: K, opts?: CreateOptions): HTMLElementTagNameMap[K];
/**
 * Append one or more children to a parent element.
 *
 * @example
 *     append(container, header, body, footer);
 */
export declare function append(parent: Element, ...children: (Element | Node)[]): void;
/**
 * Prepend one or more children to a parent element.
 *
 * @example
 *     prepend(list, newFirstItem);
 */
export declare function prepend(parent: Element, ...children: (Element | Node)[]): void;
/**
 * Remove an element from the DOM.
 *
 * @example
 *     remove(obsoleteElement);
 */
export declare function remove(el: Element): void;
/**
 * Replace an existing element with a new one.
 *
 * @example
 *     replace(oldCard, updatedCard);
 */
export declare function replace(oldEl: Element, newEl: Element): void;