summaryrefslogtreecommitdiffstats
path: root/chromium/third_party/node/node_modules/lit-element/lit-element.d.ts
diff options
context:
space:
mode:
authorMichal Klocek <michal.klocek@qt.io>2024-05-06 12:49:24 +0200
committerMichal Klocek <michal.klocek@qt.io>2024-05-07 09:51:27 +0000
commit6c04301ecbe57a84d6cc82776b9de9d27fd10076 (patch)
treeed50ecf908d5dec121b5646c69f9da2e6415965f /chromium/third_party/node/node_modules/lit-element/lit-element.d.ts
parentbdd23a0120a16de636b411a50c92cd273c4e80fa (diff)
Missing node module sources
* lit-html * lit-element * lit-reactive-element * lit-directive Change-Id: Idb8413411ad45acd9350e5f155c39c9789f15b95 Reviewed-on: https://codereview.qt-project.org/c/qt/qtwebengine-chromium/+/558486 Reviewed-by: Allan Sandfeld Jensen <allan.jensen@qt.io>
Diffstat (limited to 'chromium/third_party/node/node_modules/lit-element/lit-element.d.ts')
-rw-r--r--chromium/third_party/node/node_modules/lit-element/lit-element.d.ts174
1 files changed, 174 insertions, 0 deletions
diff --git a/chromium/third_party/node/node_modules/lit-element/lit-element.d.ts b/chromium/third_party/node/node_modules/lit-element/lit-element.d.ts
new file mode 100644
index 00000000000..f88e91ecacc
--- /dev/null
+++ b/chromium/third_party/node/node_modules/lit-element/lit-element.d.ts
@@ -0,0 +1,174 @@
+/**
+ * @license
+ * Copyright 2017 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * The main LitElement module, which defines the {@linkcode LitElement} base
+ * class and related APIs.
+ *
+ * LitElement components can define a template and a set of observed
+ * properties. Changing an observed property triggers a re-render of the
+ * element.
+ *
+ * Import {@linkcode LitElement} and {@linkcode html} from this module to
+ * create a component:
+ *
+ * ```js
+ * import {LitElement, html} from 'lit-element';
+ *
+ * class MyElement extends LitElement {
+ *
+ * // Declare observed properties
+ * static get properties() {
+ * return {
+ * adjective: {}
+ * }
+ * }
+ *
+ * constructor() {
+ * this.adjective = 'awesome';
+ * }
+ *
+ * // Define the element's template
+ * render() {
+ * return html`<p>your ${adjective} template here</p>`;
+ * }
+ * }
+ *
+ * customElements.define('my-element', MyElement);
+ * ```
+ *
+ * `LitElement` extends {@linkcode ReactiveElement} and adds lit-html
+ * templating. The `ReactiveElement` class is provided for users that want to
+ * build their own custom element base classes that don't use lit-html.
+ *
+ * @packageDocumentation
+ */
+import { PropertyValues, ReactiveElement } from '@lit/reactive-element';
+import { RenderOptions } from 'lit-html';
+export * from '@lit/reactive-element';
+export * from 'lit-html';
+import { LitUnstable } from 'lit-html';
+import { ReactiveUnstable } from '@lit/reactive-element';
+/**
+ * Contains types that are part of the unstable debug API.
+ *
+ * Everything in this API is not stable and may change or be removed in the future,
+ * even on patch releases.
+ */
+export declare namespace Unstable {
+ /**
+ * When Lit is running in dev mode and `window.emitLitDebugLogEvents` is true,
+ * we will emit 'lit-debug' events to window, with live details about the update and render
+ * lifecycle. These can be useful for writing debug tooling and visualizations.
+ *
+ * Please be aware that running with window.emitLitDebugLogEvents has performance overhead,
+ * making certain operations that are normally very cheap (like a no-op render) much slower,
+ * because we must copy data and dispatch events.
+ */
+ namespace DebugLog {
+ type Entry = LitUnstable.DebugLog.Entry | ReactiveUnstable.DebugLog.Entry;
+ }
+}
+/**
+ * Base element class that manages element properties and attributes, and
+ * renders a lit-html template.
+ *
+ * To define a component, subclass `LitElement` and implement a
+ * `render` method to provide the component's template. Define properties
+ * using the {@linkcode LitElement.properties properties} property or the
+ * {@linkcode property} decorator.
+ */
+export declare class LitElement extends ReactiveElement {
+ static ['_$litElement$']: boolean;
+ /**
+ * @category rendering
+ */
+ readonly renderOptions: RenderOptions;
+ private __childPart;
+ /**
+ * @category rendering
+ */
+ protected createRenderRoot(): HTMLElement | DocumentFragment;
+ /**
+ * Updates the element. This method reflects property values to attributes
+ * and calls `render` to render DOM via lit-html. Setting properties inside
+ * this method will *not* trigger another update.
+ * @param changedProperties Map of changed properties with old values
+ * @category updates
+ */
+ protected update(changedProperties: PropertyValues): void;
+ /**
+ * Invoked when the component is added to the document's DOM.
+ *
+ * In `connectedCallback()` you should setup tasks that should only occur when
+ * the element is connected to the document. The most common of these is
+ * adding event listeners to nodes external to the element, like a keydown
+ * event handler added to the window.
+ *
+ * ```ts
+ * connectedCallback() {
+ * super.connectedCallback();
+ * addEventListener('keydown', this._handleKeydown);
+ * }
+ * ```
+ *
+ * Typically, anything done in `connectedCallback()` should be undone when the
+ * element is disconnected, in `disconnectedCallback()`.
+ *
+ * @category lifecycle
+ */
+ connectedCallback(): void;
+ /**
+ * Invoked when the component is removed from the document's DOM.
+ *
+ * This callback is the main signal to the element that it may no longer be
+ * used. `disconnectedCallback()` should ensure that nothing is holding a
+ * reference to the element (such as event listeners added to nodes external
+ * to the element), so that it is free to be garbage collected.
+ *
+ * ```ts
+ * disconnectedCallback() {
+ * super.disconnectedCallback();
+ * window.removeEventListener('keydown', this._handleKeydown);
+ * }
+ * ```
+ *
+ * An element may be re-connected after being disconnected.
+ *
+ * @category lifecycle
+ */
+ disconnectedCallback(): void;
+ /**
+ * Invoked on each update to perform rendering tasks. This method may return
+ * any value renderable by lit-html's `ChildPart` - typically a
+ * `TemplateResult`. Setting properties inside this method will *not* trigger
+ * the element to update.
+ * @category rendering
+ */
+ protected render(): unknown;
+}
+/**
+ * END USERS SHOULD NOT RELY ON THIS OBJECT.
+ *
+ * Private exports for use by other Lit packages, not intended for use by
+ * external users.
+ *
+ * We currently do not make a mangled rollup build of the lit-ssr code. In order
+ * to keep a number of (otherwise private) top-level exports mangled in the
+ * client side code, we export a _$LE object containing those members (or
+ * helper methods for accessing private fields of those members), and then
+ * re-export them for use in lit-ssr. This keeps lit-ssr agnostic to whether the
+ * client-side code is being used in `dev` mode or `prod` mode.
+ *
+ * This has a unique name, to disambiguate it from private exports in
+ * lit-html, since this module re-exports all of lit-html.
+ *
+ * @private
+ */
+export declare const _$LE: {
+ _$attributeToProperty: (el: LitElement, name: string, value: string | null) => void;
+ _$changedProperties: (el: LitElement) => any;
+};
+//# sourceMappingURL=lit-element.d.ts.map \ No newline at end of file