@utrecht/web-component-library-stencil 1.0.0-alpha.48 → 1.0.0-alpha.481

package/dist/types/stencil-public-runtime.d.ts

@@ -133,7 +133,7 @@ export interface ListenOptions {
      */
     passive?: boolean;
 }
-export declare type ListenTargetOptions = 'body' | 'document' | 'window';
+export type ListenTargetOptions = 'body' | 'document' | 'window';
 export interface StateDecorator {
     (): PropertyDecorator;
 }
@@ -214,14 +214,16 @@ export declare const State: StateDecorator;
  * https://stenciljs.com/docs/reactive-data#watch-decorator
  */
 export declare const Watch: WatchDecorator;
-export declare type ResolutionHandler = (elm: HTMLElement) => string | undefined | null;
-export declare type ErrorHandler = (err: any, element?: HTMLElement) => void;
+export type ResolutionHandler = (elm: HTMLElement) => string | undefined | null;
+export type ErrorHandler = (err: any, element?: HTMLElement) => void;
 /**
  * `setMode()` is used for libraries which provide multiple "modes" for styles.
  */
 export declare const setMode: (handler: ResolutionHandler) => void;
 /**
- * getMode
+ * `getMode()` is used for libraries which provide multiple "modes" for styles.
+ * @param ref a reference to the node to get styles for
+ * @returns the current mode or undefined, if not found
  */
 export declare function getMode<T = string | undefined>(ref: any): T;
 export declare function setPlatformHelpers(helpers: {
@@ -234,6 +236,9 @@ export declare function setPlatformHelpers(helpers: {
 /**
  * Get the base path to where the assets can be found. Use `setAssetPath(path)`
  * if the path needs to be customized.
+ * @param path the path to use in calculating the asset path. this value will be
+ * used in conjunction with the base asset path
+ * @returns the base path
  */
 export declare function getAssetPath(path: string): string;
 /**
@@ -246,22 +251,38 @@ export declare function getAssetPath(path: string): string;
  * `setAssetPath(document.currentScript.src)`, or using a bundler's replace plugin to
  * dynamically set the path at build time, such as `setAssetPath(process.env.ASSET_PATH)`.
  * But do note that this configuration depends on how your script is bundled, or lack of
- * bunding, and where your assets can be loaded from. Additionally custom bundling
+ * bundling, and where your assets can be loaded from. Additionally custom bundling
  * will have to ensure the static assets are copied to its build directory.
+ * @param path the asset path to set
+ * @returns the set path
  */
 export declare function setAssetPath(path: string): string;
 /**
- * getElement
+ * Used to specify a nonce value that corresponds with an application's
+ * [Content Security Policy (CSP)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP).
+ * When set, the nonce will be added to all dynamically created script and style tags at runtime.
+ * Alternatively, the nonce value can be set on a `meta` tag in the DOM head
+ * (<meta name="csp-nonce" content="{ nonce value here }" />) and will result in the same behavior.
+ * @param nonce The value to be used for the nonce attribute.
+ */
+export declare function setNonce(nonce: string): void;
+/**
+ * Retrieve a Stencil element for a given reference
+ * @param ref the ref to get the Stencil element for
+ * @returns a reference to the element
  */
 export declare function getElement(ref: any): HTMLStencilElement;
 /**
  * Schedules a new render of the given instance or element even if no state changed.
  *
- * Notice `forceUpdate()` is not syncronous and might perform the DOM render in the next frame.
+ * Notice `forceUpdate()` is not synchronous and might perform the DOM render in the next frame.
+ *
+ * @param ref the node/element to force the re-render of
  */
 export declare function forceUpdate(ref: any): void;
 /**
  * getRenderingRef
+ * @returns the rendering ref
  */
 export declare function getRenderingRef(): any;
 export interface HTMLStencilElement extends HTMLElement {
@@ -272,6 +293,8 @@ export interface HTMLStencilElement extends HTMLElement {
  * in the best moment to perform DOM mutation without causing layout thrashing.
  *
  * For further information: https://developers.google.com/web/fundamentals/performance/rendering/avoid-large-complex-layouts-and-layout-thrashing
+ *
+ * @param task the DOM-write to schedule
  */
 export declare function writeTask(task: RafCallback): void;
 /**
@@ -279,6 +302,8 @@ export declare function writeTask(task: RafCallback): void;
  * in the best moment to perform DOM reads without causing layout thrashing.
  *
  * For further information: https://developers.google.com/web/fundamentals/performance/rendering/avoid-large-complex-layouts-and-layout-thrashing
+ *
+ * @param task the DOM-read to schedule
  */
 export declare function readTask(task: RafCallback): void;
 /**
@@ -417,13 +442,57 @@ interface HostAttributes {
     ref?: (el: HTMLElement | null) => void;
     [prop: string]: any;
 }
+/**
+ * Utilities for working with functional Stencil components. An object
+ * conforming to this interface is passed by the Stencil runtime as the third
+ * argument to a functional component, allowing component authors to work with
+ * features like children.
+ *
+ * The children of a functional component will be passed as the second
+ * argument, so a functional component which uses these utils to transform its
+ * children might look like the following:
+ *
+ * ```ts
+ * export const AddClass: FunctionalComponent = (_, children, utils) => (
+ *  utils.map(children, child => ({
+ *    ...child,
+ *    vattrs: {
+ *      ...child.vattrs,
+ *      class: `${child.vattrs.class} add-class`
+ *    }
+ *  }))
+ * );
+ * ```
+ *
+ * For more see the Stencil documentation, here:
+ * https://stenciljs.com/docs/functional-components
+ */
 export interface FunctionalUtilities {
+    /**
+     * Utility for reading the children of a functional component at runtime.
+     * Since the Stencil runtime uses a different interface for children it is
+     * not recommendeded to read the children directly, and is preferable to use
+     * this utility to, for instance, perform a side effect for each child.
+     */
     forEach: (children: VNode[], cb: (vnode: ChildNode, index: number, array: ChildNode[]) => void) => void;
+    /**
+     * Utility for transforming the children of a functional component. Given an
+     * array of children and a callback this will return a list of the results of
+     * passing each child to the supplied callback.
+     */
     map: (children: VNode[], cb: (vnode: ChildNode, index: number, array: ChildNode[]) => ChildNode) => VNode[];
 }
 export interface FunctionalComponent<T = {}> {
     (props: T, children: VNode[], utils: FunctionalUtilities): VNode | VNode[];
 }
+/**
+ * A Child VDOM node
+ *
+ * This has most of the same properties as {@link VNode} but friendlier names
+ * (i.e. `vtag` instead of `$tag$`, `vchildren` instead of `$children$`) in
+ * order to provide a friendlier public interface for users of the
+ * {@link FunctionalUtilities}).
+ */
 export interface ChildNode {
     vtag?: string | number | Function;
     vkey?: string | number;
@@ -470,6 +539,9 @@ export declare function h(sel: any, children: Array<VNode | undefined | null>):
 export declare function h(sel: any, data: VNodeData | null, text: string): VNode;
 export declare function h(sel: any, data: VNodeData | null, children: Array<VNode | undefined | null>): VNode;
 export declare function h(sel: any, data: VNodeData | null, children: VNode): VNode;
+/**
+ * A virtual DOM node
+ */
 export interface VNode {
     $flags$: number;
     $tag$: string | number | Function;
@@ -666,7 +738,7 @@ export declare namespace JSXBase {
         use: JSXBase.SVGAttributes;
         view: JSXBase.SVGAttributes;
     }
-    interface SlotAttributes {
+    interface SlotAttributes extends JSXAttributes {
         name?: string;
         slot?: string;
         onSlotchange?: (event: Event) => void;
@@ -679,6 +751,7 @@ export declare namespace JSXBase {
         media?: string;
         rel?: string;
         target?: string;
+        referrerPolicy?: ReferrerPolicy;
     }
     interface AudioHTMLAttributes<T> extends MediaHTMLAttributes<T> {
     }
@@ -819,8 +892,8 @@ export declare namespace JSXBase {
         accept?: string;
         allowdirs?: boolean;
         alt?: string;
-        autoCapitalize?: any;
-        autocapitalize?: any;
+        autoCapitalize?: string;
+        autocapitalize?: string;
         autoComplete?: string;
         autocomplete?: string;
         autoFocus?: boolean;
@@ -1144,8 +1217,8 @@ export declare namespace JSXBase {
         resource?: string;
         typeof?: string;
         vocab?: string;
-        autoCapitalize?: any;
-        autocapitalize?: any;
+        autoCapitalize?: string;
+        autocapitalize?: string;
         autoCorrect?: string;
         autocorrect?: string;
         autoSave?: string;
@@ -1166,87 +1239,87 @@ export declare namespace JSXBase {
         unselectable?: boolean;
     }
     interface SVGAttributes<T = SVGElement> extends DOMAttributes<T> {
-        'class'?: string | {
+        class?: string | {
             [className: string]: boolean;
         };
-        'color'?: string;
-        'height'?: number | string;
-        'id'?: string;
-        'lang'?: string;
-        'max'?: number | string;
-        'media'?: string;
-        'method'?: string;
-        'min'?: number | string;
-        'name'?: string;
-        'style'?: {
+        color?: string;
+        height?: number | string;
+        id?: string;
+        lang?: string;
+        max?: number | string;
+        media?: string;
+        method?: string;
+        min?: number | string;
+        name?: string;
+        style?: {
             [key: string]: string | undefined;
         };
-        'target'?: string;
-        'type'?: string;
-        'width'?: number | string;
-        'role'?: string;
-        'tabindex'?: number;
+        target?: string;
+        type?: string;
+        width?: number | string;
+        role?: string;
+        tabindex?: number;
         'accent-height'?: number | string;
-        'accumulate'?: 'none' | 'sum';
-        'additive'?: 'replace' | 'sum';
+        accumulate?: 'none' | 'sum';
+        additive?: 'replace' | 'sum';
         'alignment-baseline'?: 'auto' | 'baseline' | 'before-edge' | 'text-before-edge' | 'middle' | 'central' | 'after-edge' | 'text-after-edge' | 'ideographic' | 'alphabetic' | 'hanging' | 'mathematical' | 'inherit';
-        'allowReorder'?: 'no' | 'yes';
-        'alphabetic'?: number | string;
-        'amplitude'?: number | string;
+        allowReorder?: 'no' | 'yes';
+        alphabetic?: number | string;
+        amplitude?: number | string;
         'arabic-form'?: 'initial' | 'medial' | 'terminal' | 'isolated';
-        'ascent'?: number | string;
-        'attributeName'?: string;
-        'attributeType'?: string;
-        'autoReverse'?: number | string;
-        'azimuth'?: number | string;
-        'baseFrequency'?: number | string;
+        ascent?: number | string;
+        attributeName?: string;
+        attributeType?: string;
+        autoReverse?: number | string;
+        azimuth?: number | string;
+        baseFrequency?: number | string;
         'baseline-shift'?: number | string;
-        'baseProfile'?: number | string;
-        'bbox'?: number | string;
-        'begin'?: number | string;
-        'bias'?: number | string;
-        'by'?: number | string;
-        'calcMode'?: number | string;
+        baseProfile?: number | string;
+        bbox?: number | string;
+        begin?: number | string;
+        bias?: number | string;
+        by?: number | string;
+        calcMode?: number | string;
         'cap-height'?: number | string;
-        'clip'?: number | string;
+        clip?: number | string;
         'clip-path'?: string;
-        'clipPathUnits'?: number | string;
+        clipPathUnits?: number | string;
         'clip-rule'?: number | string;
         'color-interpolation'?: number | string;
         'color-interpolation-filters'?: 'auto' | 's-rGB' | 'linear-rGB' | 'inherit';
         'color-profile'?: number | string;
         'color-rendering'?: number | string;
-        'contentScriptType'?: number | string;
-        'contentStyleType'?: number | string;
-        'cursor'?: number | string;
-        'cx'?: number | string;
-        'cy'?: number | string;
-        'd'?: string;
-        'decelerate'?: number | string;
-        'descent'?: number | string;
-        'diffuseConstant'?: number | string;
-        'direction'?: number | string;
-        'display'?: number | string;
-        'divisor'?: number | string;
+        contentScriptType?: number | string;
+        contentStyleType?: number | string;
+        cursor?: number | string;
+        cx?: number | string;
+        cy?: number | string;
+        d?: string;
+        decelerate?: number | string;
+        descent?: number | string;
+        diffuseConstant?: number | string;
+        direction?: number | string;
+        display?: number | string;
+        divisor?: number | string;
         'dominant-baseline'?: number | string;
-        'dur'?: number | string;
-        'dx'?: number | string;
-        'dy'?: number | string;
+        dur?: number | string;
+        dx?: number | string;
+        dy?: number | string;
         'edge-mode'?: number | string;
-        'elevation'?: number | string;
+        elevation?: number | string;
         'enable-background'?: number | string;
-        'end'?: number | string;
-        'exponent'?: number | string;
-        'externalResourcesRequired'?: number | string;
-        'fill'?: string;
+        end?: number | string;
+        exponent?: number | string;
+        externalResourcesRequired?: number | string;
+        fill?: string;
         'fill-opacity'?: number | string;
         'fill-rule'?: 'nonzero' | 'evenodd' | 'inherit';
-        'filter'?: string;
-        'filterRes'?: number | string;
-        'filterUnits'?: number | string;
+        filter?: string;
+        filterRes?: number | string;
+        filterUnits?: number | string;
         'flood-color'?: number | string;
         'flood-opacity'?: number | string;
-        'focusable'?: number | string;
+        focusable?: number | string;
         'font-family'?: string;
         'font-size'?: number | string;
         'font-size-adjust'?: number | string;
@@ -1254,113 +1327,113 @@ export declare namespace JSXBase {
         'font-style'?: number | string;
         'font-variant'?: number | string;
         'font-weight'?: number | string;
-        'format'?: number | string;
-        'from'?: number | string;
-        'fx'?: number | string;
-        'fy'?: number | string;
-        'g1'?: number | string;
-        'g2'?: number | string;
+        format?: number | string;
+        from?: number | string;
+        fx?: number | string;
+        fy?: number | string;
+        g1?: number | string;
+        g2?: number | string;
         'glyph-name'?: number | string;
         'glyph-orientation-horizontal'?: number | string;
         'glyph-orientation-vertical'?: number | string;
-        'glyphRef'?: number | string;
-        'gradientTransform'?: string;
-        'gradientUnits'?: string;
-        'hanging'?: number | string;
+        glyphRef?: number | string;
+        gradientTransform?: string;
+        gradientUnits?: string;
+        hanging?: number | string;
         'horiz-adv-x'?: number | string;
         'horiz-origin-x'?: number | string;
-        'href'?: string;
-        'ideographic'?: number | string;
+        href?: string;
+        ideographic?: number | string;
         'image-rendering'?: number | string;
-        'in2'?: number | string;
-        'in'?: string;
-        'intercept'?: number | string;
-        'k1'?: number | string;
-        'k2'?: number | string;
-        'k3'?: number | string;
-        'k4'?: number | string;
-        'k'?: number | string;
-        'kernelMatrix'?: number | string;
-        'kernelUnitLength'?: number | string;
-        'kerning'?: number | string;
-        'keyPoints'?: number | string;
-        'keySplines'?: number | string;
-        'keyTimes'?: number | string;
-        'lengthAdjust'?: number | string;
+        in2?: number | string;
+        in?: string;
+        intercept?: number | string;
+        k1?: number | string;
+        k2?: number | string;
+        k3?: number | string;
+        k4?: number | string;
+        k?: number | string;
+        kernelMatrix?: number | string;
+        kernelUnitLength?: number | string;
+        kerning?: number | string;
+        keyPoints?: number | string;
+        keySplines?: number | string;
+        keyTimes?: number | string;
+        lengthAdjust?: number | string;
         'letter-spacing'?: number | string;
         'lighting-color'?: number | string;
-        'limitingConeAngle'?: number | string;
-        'local'?: number | string;
+        limitingConeAngle?: number | string;
+        local?: number | string;
         'marker-end'?: string;
-        'markerHeight'?: number | string;
+        markerHeight?: number | string;
         'marker-mid'?: string;
         'marker-start'?: string;
-        'markerUnits'?: number | string;
-        'markerWidth'?: number | string;
-        'mask'?: string;
-        'maskContentUnits'?: number | string;
-        'maskUnits'?: number | string;
-        'mathematical'?: number | string;
-        'mode'?: number | string;
-        'numOctaves'?: number | string;
-        'offset'?: number | string;
-        'opacity'?: number | string;
-        'operator'?: number | string;
-        'order'?: number | string;
-        'orient'?: number | string;
-        'orientation'?: number | string;
-        'origin'?: number | string;
-        'overflow'?: number | string;
+        markerUnits?: number | string;
+        markerWidth?: number | string;
+        mask?: string;
+        maskContentUnits?: number | string;
+        maskUnits?: number | string;
+        mathematical?: number | string;
+        mode?: number | string;
+        numOctaves?: number | string;
+        offset?: number | string;
+        opacity?: number | string;
+        operator?: number | string;
+        order?: number | string;
+        orient?: number | string;
+        orientation?: number | string;
+        origin?: number | string;
+        overflow?: number | string;
         'overline-position'?: number | string;
         'overline-thickness'?: number | string;
         'paint-order'?: number | string;
-        'panose1'?: number | string;
-        'pathLength'?: number | string;
-        'patternContentUnits'?: string;
-        'patternTransform'?: number | string;
-        'patternUnits'?: string;
+        panose1?: number | string;
+        pathLength?: number | string;
+        patternContentUnits?: string;
+        patternTransform?: number | string;
+        patternUnits?: string;
         'pointer-events'?: number | string;
-        'points'?: string;
-        'pointsAtX'?: number | string;
-        'pointsAtY'?: number | string;
-        'pointsAtZ'?: number | string;
-        'preserveAlpha'?: number | string;
-        'preserveAspectRatio'?: string;
-        'primitiveUnits'?: number | string;
-        'r'?: number | string;
-        'radius'?: number | string;
-        'refX'?: number | string;
-        'refY'?: number | string;
+        points?: string;
+        pointsAtX?: number | string;
+        pointsAtY?: number | string;
+        pointsAtZ?: number | string;
+        preserveAlpha?: number | string;
+        preserveAspectRatio?: string;
+        primitiveUnits?: number | string;
+        r?: number | string;
+        radius?: number | string;
+        refX?: number | string;
+        refY?: number | string;
         'rendering-intent'?: number | string;
-        'repeatCount'?: number | string;
-        'repeatDur'?: number | string;
-        'requiredextensions'?: number | string;
-        'requiredFeatures'?: number | string;
-        'restart'?: number | string;
-        'result'?: string;
-        'rotate'?: number | string;
-        'rx'?: number | string;
-        'ry'?: number | string;
-        'scale'?: number | string;
-        'seed'?: number | string;
+        repeatCount?: number | string;
+        repeatDur?: number | string;
+        requiredextensions?: number | string;
+        requiredFeatures?: number | string;
+        restart?: number | string;
+        result?: string;
+        rotate?: number | string;
+        rx?: number | string;
+        ry?: number | string;
+        scale?: number | string;
+        seed?: number | string;
         'shape-rendering'?: number | string;
-        'slope'?: number | string;
-        'spacing'?: number | string;
-        'specularConstant'?: number | string;
-        'specularExponent'?: number | string;
-        'speed'?: number | string;
-        'spreadMethod'?: string;
-        'startOffset'?: number | string;
-        'stdDeviation'?: number | string;
-        'stemh'?: number | string;
-        'stemv'?: number | string;
-        'stitchTiles'?: number | string;
+        slope?: number | string;
+        spacing?: number | string;
+        specularConstant?: number | string;
+        specularExponent?: number | string;
+        speed?: number | string;
+        spreadMethod?: string;
+        startOffset?: number | string;
+        stdDeviation?: number | string;
+        stemh?: number | string;
+        stemv?: number | string;
+        stitchTiles?: number | string;
         'stop-color'?: string;
         'stop-opacity'?: number | string;
         'strikethrough-position'?: number | string;
         'strikethrough-thickness'?: number | string;
-        'string'?: number | string;
-        'stroke'?: string;
+        string?: number | string;
+        stroke?: string;
         'stroke-dasharray'?: string | number;
         'stroke-dashoffset'?: string | number;
         'stroke-linecap'?: 'butt' | 'round' | 'square' | 'inherit';
@@ -1368,67 +1441,65 @@ export declare namespace JSXBase {
         'stroke-miterlimit'?: string;
         'stroke-opacity'?: number | string;
         'stroke-width'?: number | string;
-        'surfaceScale'?: number | string;
-        'systemLanguage'?: number | string;
-        'tableValues'?: number | string;
-        'targetX'?: number | string;
-        'targetY'?: number | string;
+        surfaceScale?: number | string;
+        systemLanguage?: number | string;
+        tableValues?: number | string;
+        targetX?: number | string;
+        targetY?: number | string;
         'text-anchor'?: string;
         'text-decoration'?: number | string;
-        'textLength'?: number | string;
+        textLength?: number | string;
         'text-rendering'?: number | string;
-        'to'?: number | string;
-        'transform'?: string;
-        'u1'?: number | string;
-        'u2'?: number | string;
+        to?: number | string;
+        transform?: string;
+        u1?: number | string;
+        u2?: number | string;
         'underline-position'?: number | string;
         'underline-thickness'?: number | string;
-        'unicode'?: number | string;
+        unicode?: number | string;
         'unicode-bidi'?: number | string;
         'unicode-range'?: number | string;
         'units-per-em'?: number | string;
         'v-alphabetic'?: number | string;
-        'values'?: string;
+        values?: string;
         'vector-effect'?: number | string;
-        'version'?: string;
+        version?: string;
         'vert-adv-y'?: number | string;
         'vert-origin-x'?: number | string;
         'vert-origin-y'?: number | string;
         'v-hanging'?: number | string;
         'v-ideographic'?: number | string;
-        'viewBox'?: string;
-        'viewTarget'?: number | string;
-        'visibility'?: number | string;
+        viewBox?: string;
+        viewTarget?: number | string;
+        visibility?: number | string;
         'v-mathematical'?: number | string;
-        'widths'?: number | string;
+        widths?: number | string;
         'word-spacing'?: number | string;
         'writing-mode'?: number | string;
-        'x1'?: number | string;
-        'x2'?: number | string;
-        'x'?: number | string;
+        x1?: number | string;
+        x2?: number | string;
+        x?: number | string;
         'x-channel-selector'?: string;
         'x-height'?: number | string;
-        'xlinkActuate'?: string;
-        'xlinkArcrole'?: string;
-        'xlinkHref'?: string;
-        'xlinkRole'?: string;
-        'xlinkShow'?: string;
-        'xlinkTitle'?: string;
-        'xlinkType'?: string;
-        'xmlBase'?: string;
-        'xmlLang'?: string;
-        'xmlns'?: string;
-        'xmlSpace'?: string;
-        'y1'?: number | string;
-        'y2'?: number | string;
-        'y'?: number | string;
-        'yChannelSelector'?: string;
-        'z'?: number | string;
-        'zoomAndPan'?: string;
+        xlinkActuate?: string;
+        xlinkArcrole?: string;
+        xlinkHref?: string;
+        xlinkRole?: string;
+        xlinkShow?: string;
+        xlinkTitle?: string;
+        xlinkType?: string;
+        xmlBase?: string;
+        xmlLang?: string;
+        xmlns?: string;
+        xmlSpace?: string;
+        y1?: number | string;
+        y2?: number | string;
+        y?: number | string;
+        yChannelSelector?: string;
+        z?: number | string;
+        zoomAndPan?: string;
     }
-    interface DOMAttributes<T = Element> {
-        key?: string | number;
-        ref?: (elm?: T) => void;
+    interface DOMAttributes<T> extends JSXAttributes<T> {
         slot?: string;
         part?: string;
         exportparts?: string;
@@ -1438,12 +1509,12 @@ export declare namespace JSXBase {
         onCutCapture?: (event: ClipboardEvent) => void;
         onPaste?: (event: ClipboardEvent) => void;
         onPasteCapture?: (event: ClipboardEvent) => void;
-        onCompositionEnd?: (event: CompositionEvent) => void;
-        onCompositionEndCapture?: (event: CompositionEvent) => void;
-        onCompositionStart?: (event: CompositionEvent) => void;
-        onCompositionStartCapture?: (event: CompositionEvent) => void;
-        onCompositionUpdate?: (event: CompositionEvent) => void;
-        onCompositionUpdateCapture?: (event: CompositionEvent) => void;
+        onCompositionend?: (event: CompositionEvent) => void;
+        onCompositionendCapture?: (event: CompositionEvent) => void;
+        onCompositionstart?: (event: CompositionEvent) => void;
+        onCompositionstartCapture?: (event: CompositionEvent) => void;
+        onCompositionupdate?: (event: CompositionEvent) => void;
+        onCompositionupdateCapture?: (event: CompositionEvent) => void;
         onFocus?: (event: FocusEvent) => void;
         onFocusCapture?: (event: FocusEvent) => void;
         onFocusin?: (event: FocusEvent) => void;
@@ -1454,8 +1525,8 @@ export declare namespace JSXBase {
         onBlurCapture?: (event: FocusEvent) => void;
         onChange?: (event: Event) => void;
         onChangeCapture?: (event: Event) => void;
-        onInput?: (event: Event) => void;
-        onInputCapture?: (event: Event) => void;
+        onInput?: (event: InputEvent) => void;
+        onInputCapture?: (event: InputEvent) => void;
         onReset?: (event: Event) => void;
         onResetCapture?: (event: Event) => void;
         onSubmit?: (event: Event) => void;
@@ -1549,6 +1620,10 @@ export declare namespace JSXBase {
         onTransitionEndCapture?: (event: TransitionEvent) => void;
     }
 }
+export interface JSXAttributes<T = Element> {
+    key?: string | number;
+    ref?: (elm?: T) => void;
+}
 export interface CustomElementsDefineOptions {
     exclude?: string[];
     resourcesUrl?: string;