This commit is contained in:
eewing
2026-02-17 14:10:16 -06:00
parent 2bca5834c5
commit cf73cd3b4c
11246 changed files with 1690552 additions and 0 deletions
+23
View File
@@ -0,0 +1,23 @@
export type ConfigurableWindow = {
/** Provide a custom `window` object to use in place of the global `window` object. */
window?: typeof globalThis & Window;
};
export type ConfigurableDocument = {
/** Provide a custom `document` object to use in place of the global `document` object. */
document?: Document;
};
export type ConfigurableDocumentOrShadowRoot = {
document?: DocumentOrShadowRoot;
};
export type ConfigurableNavigator = {
/** Provide a custom `navigator` object to use in place of the global `navigator` object. */
navigator?: Navigator;
};
export type ConfigurableLocation = {
/** Provide a custom `location` object to use in place of the global `location` object. */
location?: Location;
};
export declare const defaultWindow: (Window & typeof globalThis) | undefined;
export declare const defaultDocument: Document | undefined;
export declare const defaultNavigator: Navigator | undefined;
export declare const defaultLocation: Location | undefined;
+5
View File
@@ -0,0 +1,5 @@
import { BROWSER } from "esm-env";
export const defaultWindow = BROWSER && typeof window !== "undefined" ? window : undefined;
export const defaultDocument = BROWSER && typeof window !== "undefined" ? window.document : undefined;
export const defaultNavigator = BROWSER && typeof window !== "undefined" ? window.navigator : undefined;
export const defaultLocation = BROWSER && typeof window !== "undefined" ? window.location : undefined;
+11
View File
@@ -0,0 +1,11 @@
export type Getter<T> = () => T;
export type MaybeGetter<T> = T | Getter<T>;
export type MaybeElementGetter<T extends Element = HTMLElement> = MaybeGetter<T | null | undefined>;
export type MaybeElement = HTMLElement | SVGElement | undefined | null;
export type Setter<T> = (value: T) => void;
export type Expand<T> = T extends infer U ? {
[K in keyof U]: U[K];
} : never;
export type WritableProperties<T> = {
-readonly [P in keyof T]: T[P];
};
+1
View File
@@ -0,0 +1 @@
export {};
+5
View File
@@ -0,0 +1,5 @@
/**
* Get nth item of Array. Negative for backward
*/
export declare function at<T>(array: readonly T[], index: number): T | undefined;
export declare function last<T>(array: readonly T[]): T | undefined;
+14
View File
@@ -0,0 +1,14 @@
/**
* Get nth item of Array. Negative for backward
*/
export function at(array, index) {
const len = array.length;
if (!len)
return undefined;
if (index < 0)
index += len;
return array[index];
}
export function last(array) {
return array[array.length - 1];
}
+1
View File
@@ -0,0 +1 @@
export { BROWSER as browser } from "esm-env";
+1
View File
@@ -0,0 +1 @@
export { BROWSER as browser } from "esm-env";
+25
View File
@@ -0,0 +1,25 @@
/**
* Handles getting the active element in a document or shadow root.
* If the active element is within a shadow root, it will traverse the shadow root
* to find the active element.
* If not, it will return the active element in the document.
*
* @param document A document or shadow root to get the active element from.
* @returns The active element in the document or shadow root.
*/
export declare function getActiveElement(document: DocumentOrShadowRoot): Element | null;
/**
* Returns the owner document of a given element.
*
* @param node The element to get the owner document from.
* @returns
*/
export declare function getOwnerDocument(node: Element | null | undefined, fallback?: Document | undefined): Document | undefined;
/**
* Checks if an element is or is contained by another element.
*
* @param node The element to check if it or its descendants contain the target element.
* @param target The element to check if it is contained by the node.
* @returns
*/
export declare function isOrContainsTarget(node: Element, target: Element): boolean;
+40
View File
@@ -0,0 +1,40 @@
import { defaultDocument } from "../configurable-globals.js";
/**
* Handles getting the active element in a document or shadow root.
* If the active element is within a shadow root, it will traverse the shadow root
* to find the active element.
* If not, it will return the active element in the document.
*
* @param document A document or shadow root to get the active element from.
* @returns The active element in the document or shadow root.
*/
export function getActiveElement(document) {
let activeElement = document.activeElement;
while (activeElement?.shadowRoot) {
const node = activeElement.shadowRoot.activeElement;
if (node === activeElement)
break;
else
activeElement = node;
}
return activeElement;
}
/**
* Returns the owner document of a given element.
*
* @param node The element to get the owner document from.
* @returns
*/
export function getOwnerDocument(node, fallback = defaultDocument) {
return node?.ownerDocument ?? fallback;
}
/**
* Checks if an element is or is contained by another element.
*
* @param node The element to check if it or its descendants contain the target element.
* @param target The element to check if it is contained by the node.
* @returns
*/
export function isOrContainsTarget(node, target) {
return node === target || node.contains(target);
}
+1
View File
@@ -0,0 +1 @@
export declare function noop(): void;
+1
View File
@@ -0,0 +1 @@
export function noop() { }
+2
View File
@@ -0,0 +1,2 @@
import type { MaybeGetter } from "../types.js";
export declare function get<T>(value: MaybeGetter<T>): T;
+7
View File
@@ -0,0 +1,7 @@
import { isFunction } from "./is.js";
export function get(value) {
if (isFunction(value)) {
return value();
}
return value;
}
+3
View File
@@ -0,0 +1,3 @@
export declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
export declare function isObject(value: unknown): value is Record<PropertyKey, unknown>;
export declare function isElement(value: unknown): value is Element;
+9
View File
@@ -0,0 +1,9 @@
export function isFunction(value) {
return typeof value === "function";
}
export function isObject(value) {
return value !== null && typeof value === "object";
}
export function isElement(value) {
return value instanceof Element;
}
+1
View File
@@ -0,0 +1 @@
export declare function sleep(ms?: number): Promise<void>;
+3
View File
@@ -0,0 +1,3 @@
export async function sleep(ms = 0) {
return new Promise((resolve) => setTimeout(resolve, ms));
}