import { HTMLElementClasses, RegisterOptions } from "../types.js";
/**
 * register custom elements (web components) to the dom
 *  - takes an object full of custom html elements, and automatically dashes the names
 *    - eg, `MyCoolElement` is registered as `<my-cool-element></my-cool-element>`
 *  - calls `customElements.define`
 *  - option `soft`
 *    - `false` (default) will throw errors if elements are already defined
 *    - `true` will do nothing if an element is already defined
 *  - option `upgrade`
 *    - `true` (default) will run `customElements.upgrade` where appropriate
 *    - `false` will NOT upgrade any existing elements on the page
 */
export declare function register<E extends HTMLElementClasses>(elements: E, options?: Partial<RegisterOptions>): void;