@neovici/cosmoz-utils 4.0.0-beta.2 → 5.1.0

package/dist/haunted-polymer.d.ts

@@ -0,0 +1,341 @@
+import { BaseScheduler, GenericRenderer, ComponentOrVirtualComponent } from 'haunted';
+import { ChildPart } from 'lit-html';
+declare class Scheduler<P extends object, T extends HTMLElement | ChildPart, R extends GenericRenderer<T, P>, H extends ComponentOrVirtualComponent<T, P>, C extends (result: unknown) => void> extends BaseScheduler<P, T, R, H> {
+    _commit: C;
+    constructor(renderer: R, host: H, commitCallback: C);
+    commit(result: unknown): void;
+}
+interface PElement extends HTMLElement {
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    set<T>(path: string, value: T): void;
+    setProperties<T>(props: T): void;
+    _propertiesChanged<P, C, O>(currentProps: P, changedProps: C, oldProps: O): void;
+    _hauntedUpdateFrameHandle: ReturnType<typeof requestAnimationFrame>;
+    _onlyHauntedPropertiesChanged<T>(changedProps: T): boolean;
+}
+export declare type Constructor<T> = new (...args: any[]) => T;
+declare type Hook = <T>(a: T) => void;
+declare type Obj = Record<string, any>;
+/**
+ * Creates a mixin that mixes a haunted hook with a polymer component.
+ *
+ * @param {String} outputPath The property where the result of the hook will be stored (deprecated)
+ * @param {Function} hook A haunted hook
+ * @returns {Function} The mixin
+ */
+export declare const hauntedPolymer: (outputPath: string | Hook, hook?: Hook) => (base: Constructor<PElement>) => {
+    new (): {
+        _scheduler: Scheduler<object, HTMLElement | ChildPart, () => void, any, (result: unknown) => void>;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+        _propertiesChanged<P extends Obj, C extends Obj, O>(currentProps: P, changedProps: C, oldProps: O): void;
+        _onlyHauntedPropertiesChanged<C_1 extends Obj>(changedProps: C_1): boolean;
+        renderLitTo(part: ChildPart | (() => ChildPart), outlet: HTMLElement): void;
+        set<T>(path: string, value: T): void;
+        setProperties<T_1>(props: T_1): void;
+        _hauntedUpdateFrameHandle: ReturnType<typeof requestAnimationFrame>;
+        accessKey: string;
+        readonly accessKeyLabel: string;
+        autocapitalize: string;
+        dir: string;
+        draggable: boolean;
+        hidden: boolean;
+        innerText: string;
+        lang: string;
+        readonly offsetHeight: number;
+        readonly offsetLeft: number;
+        readonly offsetParent: Element | null;
+        readonly offsetTop: number;
+        readonly offsetWidth: number;
+        outerText: string;
+        spellcheck: boolean;
+        title: string;
+        translate: boolean;
+        attachInternals(): ElementInternals;
+        click(): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions | undefined): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions | undefined): void;
+        removeEventListener<K_1 extends keyof HTMLElementEventMap>(type: K_1, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_1]) => any, options?: boolean | EventListenerOptions | undefined): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions | undefined): void;
+        readonly attributes: NamedNodeMap;
+        readonly classList: DOMTokenList;
+        className: string;
+        readonly clientHeight: number;
+        readonly clientLeft: number;
+        readonly clientTop: number;
+        readonly clientWidth: number;
+        id: string;
+        readonly localName: string;
+        readonly namespaceURI: string | null;
+        onfullscreenchange: ((this: Element, ev: Event) => any) | null;
+        onfullscreenerror: ((this: Element, ev: Event) => any) | null;
+        outerHTML: string;
+        readonly ownerDocument: Document;
+        readonly part: DOMTokenList;
+        readonly prefix: string | null;
+        readonly scrollHeight: number;
+        scrollLeft: number;
+        scrollTop: number;
+        readonly scrollWidth: number;
+        readonly shadowRoot: ShadowRoot | null;
+        slot: string;
+        readonly tagName: string;
+        attachShadow(init: ShadowRootInit): ShadowRoot;
+        closest<K_2 extends keyof HTMLElementTagNameMap>(selector: K_2): HTMLElementTagNameMap[K_2] | null;
+        closest<K_3 extends keyof SVGElementTagNameMap>(selector: K_3): SVGElementTagNameMap[K_3] | null;
+        closest<E extends Element = Element>(selectors: string): E | null;
+        getAttribute(qualifiedName: string): string | null;
+        getAttributeNS(namespace: string | null, localName: string): string | null;
+        getAttributeNames(): string[];
+        getAttributeNode(qualifiedName: string): Attr | null;
+        getAttributeNodeNS(namespace: string | null, localName: string): Attr | null;
+        getBoundingClientRect(): DOMRect;
+        getClientRects(): DOMRectList;
+        getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
+        getElementsByTagName<K_4 extends keyof HTMLElementTagNameMap>(qualifiedName: K_4): HTMLCollectionOf<HTMLElementTagNameMap[K_4]>;
+        getElementsByTagName<K_5 extends keyof SVGElementTagNameMap>(qualifiedName: K_5): HTMLCollectionOf<SVGElementTagNameMap[K_5]>;
+        getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
+        getElementsByTagNameNS(namespace: string | null, localName: string): HTMLCollectionOf<Element>;
+        hasAttribute(qualifiedName: string): boolean;
+        hasAttributeNS(namespace: string | null, localName: string): boolean;
+        hasAttributes(): boolean;
+        hasPointerCapture(pointerId: number): boolean;
+        insertAdjacentElement(where: InsertPosition, element: Element): Element | null;
+        insertAdjacentHTML(position: InsertPosition, text: string): void;
+        insertAdjacentText(where: InsertPosition, data: string): void;
+        matches(selectors: string): boolean;
+        releasePointerCapture(pointerId: number): void;
+        removeAttribute(qualifiedName: string): void;
+        removeAttributeNS(namespace: string | null, localName: string): void;
+        removeAttributeNode(attr: Attr): Attr;
+        requestFullscreen(options?: FullscreenOptions | undefined): Promise<void>;
+        requestPointerLock(): void;
+        scroll(options?: ScrollToOptions | undefined): void;
+        scroll(x: number, y: number): void;
+        scrollBy(options?: ScrollToOptions | undefined): void;
+        scrollBy(x: number, y: number): void;
+        scrollIntoView(arg?: boolean | ScrollIntoViewOptions | undefined): void;
+        scrollTo(options?: ScrollToOptions | undefined): void;
+        scrollTo(x: number, y: number): void;
+        setAttribute(qualifiedName: string, value: string): void;
+        setAttributeNS(namespace: string | null, qualifiedName: string, value: string): void;
+        setAttributeNode(attr: Attr): Attr | null;
+        setAttributeNodeNS(attr: Attr): Attr | null;
+        setPointerCapture(pointerId: number): void;
+        toggleAttribute(qualifiedName: string, force?: boolean | undefined): boolean;
+        webkitMatchesSelector(selectors: string): boolean;
+        readonly baseURI: string;
+        readonly childNodes: NodeListOf<ChildNode>;
+        readonly firstChild: ChildNode | null;
+        readonly isConnected: boolean;
+        readonly lastChild: ChildNode | null;
+        readonly nextSibling: ChildNode | null;
+        readonly nodeName: string;
+        readonly nodeType: number;
+        nodeValue: string | null;
+        readonly parentElement: HTMLElement | null;
+        readonly parentNode: ParentNode | null;
+        readonly previousSibling: ChildNode | null;
+        textContent: string | null;
+        appendChild<T_2 extends Node>(node: T_2): T_2;
+        cloneNode(deep?: boolean | undefined): Node;
+        compareDocumentPosition(other: Node): number;
+        contains(other: Node | null): boolean;
+        getRootNode(options?: GetRootNodeOptions | undefined): Node;
+        hasChildNodes(): boolean;
+        insertBefore<T_3 extends Node>(node: T_3, child: Node | null): T_3;
+        isDefaultNamespace(namespace: string | null): boolean;
+        isEqualNode(otherNode: Node | null): boolean;
+        isSameNode(otherNode: Node | null): boolean;
+        lookupNamespaceURI(prefix: string | null): string | null;
+        lookupPrefix(namespace: string | null): string | null;
+        normalize(): void;
+        removeChild<T_4 extends Node>(child: T_4): T_4;
+        replaceChild<T_5 extends Node>(node: Node, child: T_5): T_5;
+        readonly ATTRIBUTE_NODE: number;
+        readonly CDATA_SECTION_NODE: number;
+        readonly COMMENT_NODE: number;
+        readonly DOCUMENT_FRAGMENT_NODE: number;
+        readonly DOCUMENT_NODE: number;
+        readonly DOCUMENT_POSITION_CONTAINED_BY: number;
+        readonly DOCUMENT_POSITION_CONTAINS: number;
+        readonly DOCUMENT_POSITION_DISCONNECTED: number;
+        readonly DOCUMENT_POSITION_FOLLOWING: number;
+        readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: number;
+        readonly DOCUMENT_POSITION_PRECEDING: number;
+        readonly DOCUMENT_TYPE_NODE: number;
+        readonly ELEMENT_NODE: number;
+        readonly ENTITY_NODE: number;
+        readonly ENTITY_REFERENCE_NODE: number;
+        readonly NOTATION_NODE: number;
+        readonly PROCESSING_INSTRUCTION_NODE: number;
+        readonly TEXT_NODE: number;
+        dispatchEvent(event: Event): boolean;
+        ariaAtomic: string | null;
+        ariaAutoComplete: string | null;
+        ariaBusy: string | null;
+        ariaChecked: string | null;
+        ariaColCount: string | null;
+        ariaColIndex: string | null;
+        ariaColSpan: string | null;
+        ariaCurrent: string | null;
+        ariaDisabled: string | null;
+        ariaExpanded: string | null;
+        ariaHasPopup: string | null;
+        ariaHidden: string | null;
+        ariaKeyShortcuts: string | null;
+        ariaLabel: string | null;
+        ariaLevel: string | null;
+        ariaLive: string | null;
+        ariaModal: string | null;
+        ariaMultiLine: string | null;
+        ariaMultiSelectable: string | null;
+        ariaOrientation: string | null;
+        ariaPlaceholder: string | null;
+        ariaPosInSet: string | null;
+        ariaPressed: string | null;
+        ariaReadOnly: string | null;
+        ariaRequired: string | null;
+        ariaRoleDescription: string | null;
+        ariaRowCount: string | null;
+        ariaRowIndex: string | null;
+        ariaRowSpan: string | null;
+        ariaSelected: string | null;
+        ariaSetSize: string | null;
+        ariaSort: string | null;
+        ariaValueMax: string | null;
+        ariaValueMin: string | null;
+        ariaValueNow: string | null;
+        ariaValueText: string | null;
+        animate(keyframes: PropertyIndexedKeyframes | Keyframe[] | null, options?: number | KeyframeAnimationOptions | undefined): Animation;
+        getAnimations(options?: GetAnimationsOptions | undefined): Animation[];
+        after(...nodes: (string | Node)[]): void;
+        before(...nodes: (string | Node)[]): void;
+        remove(): void;
+        replaceWith(...nodes: (string | Node)[]): void;
+        innerHTML: string;
+        readonly nextElementSibling: Element | null;
+        readonly previousElementSibling: Element | null;
+        readonly childElementCount: number;
+        readonly children: HTMLCollection;
+        readonly firstElementChild: Element | null;
+        readonly lastElementChild: Element | null;
+        append(...nodes: (string | Node)[]): void;
+        prepend(...nodes: (string | Node)[]): void;
+        querySelector<K_6 extends keyof HTMLElementTagNameMap>(selectors: K_6): HTMLElementTagNameMap[K_6] | null;
+        querySelector<K_7 extends keyof SVGElementTagNameMap>(selectors: K_7): SVGElementTagNameMap[K_7] | null;
+        querySelector<E_1 extends Element = Element>(selectors: string): E_1 | null;
+        querySelectorAll<K_8 extends keyof HTMLElementTagNameMap>(selectors: K_8): NodeListOf<HTMLElementTagNameMap[K_8]>;
+        querySelectorAll<K_9 extends keyof SVGElementTagNameMap>(selectors: K_9): NodeListOf<SVGElementTagNameMap[K_9]>;
+        querySelectorAll<E_2 extends Element = Element>(selectors: string): NodeListOf<E_2>;
+        replaceChildren(...nodes: (string | Node)[]): void;
+        readonly assignedSlot: HTMLSlotElement | null;
+        oncopy: ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+        oncut: ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+        onpaste: ((this: DocumentAndElementEventHandlers, ev: ClipboardEvent) => any) | null;
+        readonly style: CSSStyleDeclaration;
+        contentEditable: string;
+        enterKeyHint: string;
+        inputMode: string;
+        readonly isContentEditable: boolean;
+        onabort: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onanimationcancel: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onauxclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onblur: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        oncanplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncanplaythrough: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onclose: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncontextmenu: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        oncuechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ondblclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        ondrag: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragend: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragenter: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragleave: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragover: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragstart: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondrop: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondurationchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onemptied: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onended: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onerror: OnErrorEventHandler;
+        onfocus: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        onformdata: ((this: GlobalEventHandlers, ev: FormDataEvent) => any) | null;
+        ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        oninput: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onkeydown: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeypress: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeyup: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onload: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadeddata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadedmetadata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onlostpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onmousedown: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseenter: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseleave: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmousemove: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseout: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseover: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseup: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onpause: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplaying: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onpointercancel: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerdown: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerenter: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerleave: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointermove: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerout: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerover: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerup: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onprogress: ((this: GlobalEventHandlers, ev: ProgressEvent<EventTarget>) => any) | null;
+        onratechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onreset: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onresize: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onscroll: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsecuritypolicyviolation: ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | null;
+        onseeked: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onseeking: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselect: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectionchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onslotchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onstalled: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsubmit: ((this: GlobalEventHandlers, ev: SubmitEvent) => any) | null;
+        onsuspend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontimeupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontoggle: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontouchcancel?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchend?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchmove?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchstart?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontransitioncancel: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionend: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionrun: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionstart: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        onvolumechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwaiting: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationiteration: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkittransitionend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwheel: ((this: GlobalEventHandlers, ev: WheelEvent) => any) | null;
+        autofocus: boolean;
+        readonly dataset: DOMStringMap;
+        nonce?: string | undefined;
+        tabIndex: number;
+        blur(): void;
+        focus(options?: FocusOptions | undefined): void;
+    };
+};
+export {};

package/dist/haunted-polymer.js

@@ -0,0 +1,83 @@
+import { BaseScheduler, render, } from 'haunted';
+class Scheduler extends BaseScheduler {
+    _commit;
+    constructor(renderer, host, commitCallback) {
+        super(renderer, host);
+        this._commit = commitCallback;
+    }
+    commit(result) {
+        this._commit(result);
+    }
+}
+/**
+ * Creates a mixin that mixes a haunted hook with a polymer component.
+ *
+ * @param {String} outputPath The property where the result of the hook will be stored (deprecated)
+ * @param {Function} hook A haunted hook
+ * @returns {Function} The mixin
+ */
+export const hauntedPolymer = 
+// eslint-disable-next-line max-lines-per-function
+(outputPath, hook) => (base) => {
+    const hasOutputPath = hook !== undefined, _hook = hasOutputPath ? hook : outputPath;
+    // TODO: drop outputPath support after all usages are fixed.
+    if (hasOutputPath) {
+        // eslint-disable-next-line no-console
+        console.warn('Haunted Polymer: use of outputPath is deprecated. Instead have the hook return an object with the keys being property names to update.');
+    }
+    return class extends base {
+        _scheduler;
+        constructor() {
+            super();
+            this._scheduler = new Scheduler(// whenever the state is updated
+            () => _hook(this), // run the hook with the element as input
+            this, // using the element as state host
+            (result) => hasOutputPath
+                ? this.set(outputPath, result)
+                : this.setProperties(result) // and update the output path with the results
+            );
+        }
+        connectedCallback() {
+            super.connectedCallback();
+            this._scheduler.update();
+        }
+        disconnectedCallback() {
+            super.disconnectedCallback();
+            this._scheduler.teardown();
+        }
+        _propertiesChanged(currentProps, changedProps, oldProps) {
+            super._propertiesChanged(currentProps, changedProps, oldProps);
+            // skip haunted state update if the only thing that has changed is the hook output path
+            if (hasOutputPath &&
+                Object.keys(changedProps).length === 1 &&
+                changedProps[outputPath] != null) {
+                return;
+            }
+            // update haunted state only if a polymer prop has changed
+            if (this._onlyHauntedPropertiesChanged(changedProps)) {
+                return;
+            }
+            // trigger a haunted update loop
+            // do it in the next animation frame, so the current loop finishes processing first
+            cancelAnimationFrame(this._hauntedUpdateFrameHandle);
+            this._hauntedUpdateFrameHandle = requestAnimationFrame(() => this._scheduler.update());
+        }
+        _onlyHauntedPropertiesChanged(changedProps) {
+            const props = this.constructor
+                .__properties;
+            if (Object.keys(changedProps)
+                .map((prop) => prop.split('.')[0])
+                // props updated by haunted are not listed or have the `haunted` flag
+                .every((prop) => props[prop] == null || props[prop].haunted)) {
+                return true;
+            }
+            return false;
+        }
+        renderLitTo(part, outlet) {
+            // render in the next animation frame to allow the haunted scheduler to finish processing the current state update
+            // otherwise hooks might be updated twice
+            cancelAnimationFrame(outlet.__renderAF);
+            outlet.__renderAF = requestAnimationFrame(() => render(typeof part === 'function' ? part() : part, outlet));
+        }
+    };
+};

package/dist/hooks/use-debounce-raf.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Debounces a value by updating it via a double requestAnimationFrame call.
+ *
+ * Double RAF is useful for ensuring that animations start before expensive rendering is done.
+ * It helps provide smoother user experience by making animations feel reactive.
+ * Normal rendering would block the animation from starting.
+ *
+ * In the context of haunted, the double RAF call makes sure the value is updated *after* all
+ * hooks have been processed and the rendering has been done. Effectively all rapid, intermediary
+ * state changes will be skipped.
+ *
+ * @template T
+ * @param {T} value the value to debounce
+ * @returns {T} the debounced value
+ */
+export declare const useDebounceRaf: <T>(value: T) => T;

package/dist/hooks/use-debounce-raf.js

@@ -0,0 +1,36 @@
+import { useState, useEffect } from 'haunted';
+/**
+ * Debounces a value by updating it via a double requestAnimationFrame call.
+ *
+ * Double RAF is useful for ensuring that animations start before expensive rendering is done.
+ * It helps provide smoother user experience by making animations feel reactive.
+ * Normal rendering would block the animation from starting.
+ *
+ * In the context of haunted, the double RAF call makes sure the value is updated *after* all
+ * hooks have been processed and the rendering has been done. Effectively all rapid, intermediary
+ * state changes will be skipped.
+ *
+ * @template T
+ * @param {T} value the value to debounce
+ * @returns {T} the debounced value
+ */
+export const useDebounceRaf = (value) => {
+    // State and setters for debounced value
+    const [debouncedValue, setDebouncedValue] = useState(() => value);
+    useEffect(() => {
+        let double;
+        // Update debounced value after double RAF
+        const handler = requestAnimationFrame(() => {
+            double = requestAnimationFrame(() => setDebouncedValue(value));
+        });
+        // Cancel the animation frames if value changes (also on unmount)
+        // This is how we prevent debounced value from updating if value is changed.
+        // RAF gets cleared and restarted.
+        return () => {
+            cancelAnimationFrame(handler);
+            cancelAnimationFrame(double);
+        };
+    }, [value] // Only re-call effect if value changes
+    );
+    return debouncedValue;
+};

package/dist/hooks/use-dropped-files.d.ts

@@ -0,0 +1 @@
+export declare const useDroppedFiles: <T extends HTMLElement>(el: T) => File[];

package/dist/hooks/use-dropped-files.js

@@ -0,0 +1,7 @@
+import { useState, useCallback } from 'haunted';
+import { useHandleDrop } from './use-handle-drop';
+export const useDroppedFiles = (el) => {
+    const [files, setFiles] = useState([]), handleDrop = useCallback((event) => setFiles(Array.from(event.dataTransfer?.files ?? [])), [setFiles]);
+    useHandleDrop(el, handleDrop);
+    return files;
+};

package/dist/hooks/use-handle-drop.d.ts

@@ -0,0 +1 @@
+export declare const useHandleDrop: <T extends HTMLElement>(el: T, callback: (e: DragEvent) => void) => void;

package/dist/hooks/use-handle-drop.js

@@ -0,0 +1,18 @@
+import { useEffect } from 'haunted';
+export const useHandleDrop = (el, callback) => useEffect(() => {
+    const dragStop = (event) => {
+        event.stopPropagation();
+        event.preventDefault();
+    }, handleDrop = (event) => {
+        dragStop(event);
+        callback(event);
+    };
+    el.addEventListener('dragenter', dragStop);
+    el.addEventListener('dragover', dragStop);
+    el.addEventListener('drop', handleDrop);
+    return () => {
+        el.removeEventListener('dragenter', dragStop);
+        el.removeEventListener('dragover', dragStop);
+        el.removeEventListener('drop', handleDrop);
+    };
+}, [el, callback]);

package/dist/hooks/use-host-bounds.d.ts

@@ -0,0 +1,2 @@
+declare const useHostBounds: () => DOMRectReadOnly;
+export { useHostBounds };

package/dist/hooks/use-host-bounds.js

@@ -0,0 +1,12 @@
+import { useLayoutEffect, useState } from 'haunted';
+import { useHost } from './use-host';
+const useHostBounds = () => {
+    const host = useHost(), [bounds, setBounds] = useState();
+    useLayoutEffect(() => {
+        const observer = new ResizeObserver((entries) => requestAnimationFrame(() => setBounds(entries[0]?.contentRect)));
+        observer.observe(host);
+        return () => observer.unobserve(host);
+    }, []);
+    return bounds;
+};
+export { useHostBounds };

package/dist/hooks/use-host.d.ts

@@ -0,0 +1,3 @@
+declare type UseHost = <T extends HTMLElement>() => T;
+export declare const useHost: UseHost;
+export {};

package/dist/hooks/use-host.js

@@ -0,0 +1,6 @@
+import { hook, Hook } from 'haunted';
+export const useHost = hook(class extends Hook {
+    update() {
+        return this.state.host;
+    }
+});

package/dist/hooks/use-imperative-api.d.ts

@@ -0,0 +1 @@
+export declare const useImperativeApi: <A, D extends unknown[] = unknown[]>(api: A, values: D[]) => void;

package/dist/hooks/use-imperative-api.js

@@ -0,0 +1,18 @@
+import { Hook, hook } from 'haunted';
+export const useImperativeApi = hook(class extends Hook {
+    values;
+    constructor(id, state, api, values) {
+        super(id, state);
+        Object.assign(state.host, api);
+        this.values = values;
+    }
+    update(api, values) {
+        if (this.hasChanged(values)) {
+            this.values = values;
+            Object.assign(this.state.host, api);
+        }
+    }
+    hasChanged(values = []) {
+        return values.some((value, i) => this.values[i] !== value);
+    }
+});

package/dist/hooks/use-meta.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copies properties of an Object into a memoized object.
+ * Useful to create an object that does not change.
+ *
+ * @param {Object} meta - The source object
+ * @returns {Object} The memoized object.
+ */
+export declare const useMeta: <T>(meta: T) => T;

package/{lib → dist}/hooks/use-meta.js

@@ -1,5 +1,4 @@
 import { useMemo } from 'haunted';
-
 /**
  * Copies properties of an Object into a memoized object.
  * Useful to create an object that does not change.
@@ -7,8 +6,7 @@ import { useMemo } from 'haunted';
  * @param {Object} meta - The source object
  * @returns {Object} The memoized object.
  */
-export const useMeta = meta => {
-	const ref = useMemo(() => ({}), []);
-	return useMemo(() => Object.assign(ref, meta), [ref, ...Object.values(meta)]);
+export const useMeta = (meta) => {
+    const ref = useMemo(() => ({}), []);
+    return useMemo(() => Object.assign(ref, meta), [ref, ...Object.values(meta)]);
 };
-

package/dist/hooks/use-notify-property.d.ts

@@ -0,0 +1,2 @@
+declare const notifyProperty: <T extends HTMLElement, K extends Extract<keyof T, string>, V extends T[K]>(host: T, name: K, value: V) => void, useNotifyProperty: <T extends HTMLElement, K extends Extract<keyof T, string>, V extends T[K]>(name: K, value: V) => void;
+export { notifyProperty, useNotifyProperty };

package/dist/hooks/use-notify-property.js

@@ -0,0 +1,19 @@
+import { useEffect } from 'haunted';
+import { useHost } from './use-host';
+const UPPER = /([A-Z])/gu, 
+/* Emulate polymer notify props */
+notifyProperty = (host, name, value) => {
+    // this is required to make polymer double-binding recognize the change
+    // @see https://github.com/Polymer/polymer/blob/76c71e186ecc605294c3575dd31ac7983a8b3ae3/lib/mixins/property-effects.js#L382
+    host[name] = value;
+    // emulate polymer notify event
+    host.dispatchEvent(new CustomEvent(name.replace(UPPER, '-$1').toLowerCase() + '-changed', {
+        detail: { value },
+    }));
+}, useNotifyProperty = (name, value) => {
+    const host = useHost();
+    useEffect(() => {
+        notifyProperty(host, name, value);
+    }, [value]);
+};
+export { notifyProperty, useNotifyProperty };

package/dist/hooks/use-promise.d.ts

@@ -0,0 +1 @@
+export function usePromise(promise: any): any[];