@wirekyt/dom 0.0.1 → 0.0.2

package/dist/index-BMtpmaRD.d.cts

@@ -0,0 +1,16 @@
+//#region src/common/live-region/index.d.ts
+interface LiveRegionOptions {
+  level: "polite" | "assertive";
+  document?: Document | undefined;
+  root?: HTMLElement | null | undefined;
+  delay?: number | undefined;
+  debug?: boolean | undefined;
+}
+type LiveRegion = ReturnType<typeof createLiveRegion>;
+declare function createLiveRegion(opts?: Partial<LiveRegionOptions>): {
+  announce: (message: string, delay?: number) => void;
+  destroy: () => void;
+  toJSON(): string;
+};
+//#endregion
+export { LiveRegionOptions as n, createLiveRegion as r, LiveRegion as t };

package/dist/index-BMtpmaRD.d.ts

@@ -0,0 +1,16 @@
+//#region src/common/live-region/index.d.ts
+interface LiveRegionOptions {
+  level: "polite" | "assertive";
+  document?: Document | undefined;
+  root?: HTMLElement | null | undefined;
+  delay?: number | undefined;
+  debug?: boolean | undefined;
+}
+type LiveRegion = ReturnType<typeof createLiveRegion>;
+declare function createLiveRegion(opts?: Partial<LiveRegionOptions>): {
+  announce: (message: string, delay?: number) => void;
+  destroy: () => void;
+  toJSON(): string;
+};
+//#endregion
+export { LiveRegionOptions as n, createLiveRegion as r, LiveRegion as t };

package/dist/index-BWiYePx8.d.cts

@@ -0,0 +1,216 @@
+import { S as JSX, c as MaybeFn, u as Nullable } from "./index-BXfunVyD.cjs";
+//#region src/common/dom-query/types.d.ts
+type Booleanish = boolean | "true" | "false";
+interface Point {
+  x: number;
+  y: number;
+}
+interface EventKeyOptions {
+  dir?: "ltr" | "rtl" | undefined;
+  orientation?: "horizontal" | "vertical" | undefined;
+}
+type NativeEvent<E> = JSX.ChangeEvent<any> extends E ? InputEvent : E extends JSX.SyntheticEvent<any, infer T> ? T : never;
+type AnyPointerEvent = MouseEvent | TouchEvent | PointerEvent;
+type MaybeElement = Nullable<HTMLElement>;
+type MaybeElementOrFn = MaybeFn<MaybeElement>;
+type HTMLElementWithValue = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+//#endregion
+//#region src/common/dom-query/event.d.ts
+declare function getBeforeInputValue(event: Pick<InputEvent, "currentTarget">): string;
+declare function getEventTarget<T extends EventTarget>(event: Partial<Pick<UIEvent, "target" | "composedPath">>): T | null;
+declare function isOpeningInNewTab(event: Pick<MouseEvent, "currentTarget" | "metaKey" | "ctrlKey" | "button">): boolean;
+declare function isDownloadingEvent(event: Pick<MouseEvent, "altKey" | "currentTarget">): boolean;
+declare function isComposingEvent(event: any): boolean;
+declare function isKeyboardClick(e: Pick<MouseEvent, "detail" | "clientX" | "clientY">): boolean;
+declare function isCtrlOrMetaKey(e: Pick<KeyboardEvent, "ctrlKey" | "metaKey">): boolean;
+declare function isPrintableKey(e: Pick<KeyboardEvent, "key" | "ctrlKey" | "metaKey">): boolean;
+declare function isVirtualPointerEvent(e: PointerEvent): boolean;
+declare function isVirtualClick(e: MouseEvent | PointerEvent): boolean;
+declare const isLeftClick: (e: Pick<MouseEvent, "button">) => boolean;
+declare const isContextMenuEvent: (e: Pick<MouseEvent, "button" | "ctrlKey" | "metaKey">) => boolean;
+declare const isModifierKey: (e: Pick<KeyboardEvent, "ctrlKey" | "metaKey" | "altKey">) => boolean;
+declare const isTouchEvent: (event: AnyPointerEvent) => event is TouchEvent;
+declare function getEventKey(event: Pick<KeyboardEvent, "key">, options?: EventKeyOptions): string;
+declare function getNativeEvent<E>(event: E): NativeEvent<E>;
+declare function getEventStep(event: Pick<KeyboardEvent, "key" | "shiftKey">): 1 | 10;
+interface EventStepOptions {
+  step: number;
+  largeStep: number;
+  smallStep?: number | undefined;
+}
+declare function getEventStepValue(event: Pick<KeyboardEvent, "key" | "shiftKey" | "altKey">, options: EventStepOptions): number;
+declare function getEventPoint(event: any, type?: "page" | "client"): {
+  x: number;
+  y: number;
+};
+interface DOMEventMap extends DocumentEventMap, WindowEventMap, HTMLElementEventMap {}
+declare const addDomEvent: <K extends keyof DOMEventMap>(target: MaybeFn<EventTarget | null>, eventName: K | (string & {}), handler: (event: DOMEventMap[K]) => void, options?: boolean | AddEventListenerOptions) => () => void;
+declare const isSelfTarget: (event: Partial<Pick<UIEvent, "currentTarget" | "target" | "composedPath">>) => boolean;
+//#endregion
+//#region src/common/dom-query/form.d.ts
+declare function setElementValue(el: HTMLElementWithValue | null, value: string, property?: "value" | "checked"): void;
+declare function setElementChecked(el: HTMLInputElement | null, checked: boolean): void;
+interface InputValueEventOptions {
+  value: string | number;
+  bubbles?: boolean | undefined;
+}
+declare function dispatchInputValueEvent(el: HTMLElementWithValue | null, options: InputValueEventOptions): void;
+interface CheckedEventOptions {
+  checked: boolean;
+  bubbles?: boolean | undefined;
+}
+declare function dispatchInputCheckedEvent(el: HTMLInputElement | null, options: CheckedEventOptions): void;
+interface TrackFormControlOptions {
+  onFieldsetDisabledChange: (disabled: boolean) => void;
+  onFormReset: VoidFunction;
+}
+declare function trackFormControl(el: HTMLElement | null, options: TrackFormControlOptions): (() => void) | undefined;
+declare const INTERNAL_CHANGE_EVENT: unique symbol;
+type InternalChangeEventProps = {
+  [INTERNAL_CHANGE_EVENT]?: boolean;
+};
+declare function isInternalChangeEvent<T extends Event>(e: T): e is T & InternalChangeEventProps;
+declare function markAsInternalChangeEvent<T extends Event>(event: T): T & InternalChangeEventProps;
+//#endregion
+//#region src/common/dom-query/mutation-observer.d.ts
+interface ObserveAttributeOptions {
+  attributes: string[];
+  callback(record: MutationRecord): void;
+  defer?: boolean | undefined;
+}
+declare function observeAttributes(nodeOrFn: MaybeElementOrFn, options: ObserveAttributeOptions): () => void;
+interface ObserveChildrenOptions {
+  callback: MutationCallback;
+  defer?: boolean | undefined;
+}
+declare function observeChildren(nodeOrFn: MaybeElementOrFn, options: ObserveChildrenOptions): () => void;
+//#endregion
+//#region src/common/dom-query/node.d.ts
+declare const isElement: (el: any) => el is Element;
+declare const isHTMLElement: (el: any) => el is HTMLElement;
+declare const isDocument: (el: any) => el is Document;
+declare const isWindow: (el: any) => el is Window;
+declare const isVisualViewport: (el: any) => el is VisualViewport;
+declare const getNodeName: (node: Node | Window) => string;
+declare function isRootElement(node: Node): boolean;
+declare const isNode: (el: any) => el is Node;
+declare const isShadowRoot: (el: any) => el is ShadowRoot;
+declare const isInputElement: (el: any) => el is HTMLInputElement;
+declare const isAnchorElement: (el: HTMLElement | null | undefined) => el is HTMLAnchorElement;
+declare const isElementVisible: (el: Node) => boolean;
+declare function isActiveElement(element: Element | null | undefined): boolean;
+declare function isEditableElement(el: HTMLElement | EventTarget | null): boolean;
+type Target = HTMLElement | EventTarget | null | undefined;
+declare function getParentElement(node: Element): Element | null;
+declare function getAncestorElements(node: Element | null): Element[];
+declare function contains(parent: Target, child: Target): boolean;
+declare function getDocument(el: Element | Window | Node | Document | null | undefined): Document;
+declare function getDocumentElement(el: Element | Node | Window | Document | null | undefined): HTMLElement;
+declare function getWindow(el: Node | ShadowRoot | Document | null | undefined): Window & typeof globalThis;
+declare function getActiveElement(rootNode: Document | ShadowRoot): HTMLElement | null;
+declare function getParentNode(node: Node): Node;
+declare function getRootNode(node: Node): Document | ShadowRoot;
+//#endregion
+//#region src/common/dom-query/point.d.ts
+interface PercentValueOptions {
+  inverted?: boolean | {
+    x?: boolean | undefined;
+    y?: boolean | undefined;
+  } | undefined;
+  dir?: "ltr" | "rtl" | undefined;
+  orientation?: "vertical" | "horizontal" | undefined;
+}
+declare function getRelativePoint(point: Point, element: HTMLElement): {
+  offset: {
+    x: number;
+    y: number;
+  };
+  percent: {
+    x: number;
+    y: number;
+  };
+  getPercentValue: (options?: PercentValueOptions) => number;
+};
+//#endregion
+//#region src/common/dom-query/pointer-move.d.ts
+interface PointerMoveDetails {
+  point: Point;
+  event: PointerEvent;
+}
+interface PointerUpDetails {
+  point: Point;
+  event: PointerEvent;
+}
+interface PointerMoveHandlers {
+  onPointerUp: (details: PointerUpDetails) => void;
+  onPointerMove: (details: PointerMoveDetails) => void;
+}
+declare function trackPointerMove(doc: Document, handlers: PointerMoveHandlers): () => void;
+//#endregion
+//#region src/common/dom-query/press.d.ts
+interface PressDetails {
+  point: Point;
+  event: PointerEvent;
+}
+interface TrackPressOptions {
+  pointerNode: Element | null;
+  keyboardNode?: Element | null | undefined;
+  isValidKey?(event: KeyboardEvent): boolean;
+  onPress?(details: PressDetails): void;
+  onPressStart?(details: PressDetails): void;
+  onPressEnd?(details: PressDetails): void;
+}
+declare function trackPress(options: TrackPressOptions): () => void;
+//#endregion
+//#region src/common/dom-query/tabbable.d.ts
+type IncludeContainerType = boolean | "if-empty";
+type GetShadowRootOption = boolean | ((node: HTMLElement) => ShadowRoot | boolean | undefined) | undefined;
+interface TabbableOptions {
+  includeContainer?: IncludeContainerType;
+  getShadowRoot?: GetShadowRootOption;
+}
+interface NextTabbableOptions {
+  current?: HTMLElement | undefined | null;
+  getShadowRoot?: GetShadowRootOption;
+}
+declare const getFocusables: (container: Pick<HTMLElement, "querySelectorAll"> | null, options?: TabbableOptions) => HTMLElement[];
+declare function isFocusable(element: HTMLElement | EventTarget | null): element is HTMLElement;
+declare function getFirstFocusable(container: HTMLElement | null, options?: TabbableOptions): HTMLElement | null;
+declare function getTabbables(container: HTMLElement | null, options?: TabbableOptions): HTMLElement[];
+declare function isTabbable(el: HTMLElement | EventTarget | null): el is HTMLElement;
+declare function getFirstTabbable(container: HTMLElement | null, options?: TabbableOptions): HTMLElement | null;
+declare function getLastTabbable(container: HTMLElement | null, options?: TabbableOptions): HTMLElement | null;
+declare function getTabbableEdges(container: HTMLElement | null, options?: TabbableOptions): [HTMLElement, HTMLElement] | [null, null];
+declare function getNextTabbable(container: HTMLElement | null, options?: NextTabbableOptions): HTMLElement | null;
+declare function getTabIndex(node: HTMLElement | SVGElement): number;
+//#endregion
+//#region src/common/dom-query/proxy-tab-focus.d.ts
+interface ProxyTabFocusOptions<T = MaybeElement> {
+  triggerElement?: T | undefined;
+  onFocus?: ((elementToFocus: HTMLElement) => void) | undefined;
+  onFocusEnter?: VoidFunction | undefined;
+  defer?: boolean | undefined;
+  getShadowRoot?: GetShadowRootOption | undefined;
+}
+declare function proxyTabFocus(container: MaybeElementOrFn, options: ProxyTabFocusOptions<MaybeElementOrFn>): () => void;
+//#endregion
+//#region src/common/dom-query/scope.d.ts
+interface ScopeContext {
+  getRootNode?: (() => Document | ShadowRoot | Node) | undefined;
+}
+declare function createScope<T>(methods: T): {
+  getRootNode: (ctx: ScopeContext) => Document | ShadowRoot;
+  getDoc: (ctx: ScopeContext) => Document;
+  getWin: (ctx: ScopeContext) => Window & typeof globalThis;
+  getActiveElement: (ctx: ScopeContext) => HTMLElement | null;
+  isActiveElement: typeof isActiveElement;
+  getById: <T_1 extends Element = HTMLElement>(ctx: ScopeContext, id: string) => T_1 | null;
+  setValue: <T_1 extends HTMLElementWithValue>(elem: T_1 | null, value: string | number | null | undefined) => void;
+} & T;
+//#endregion
+//#region src/common/dom-query/shared.d.ts
+declare const MAX_Z_INDEX = 2147483647;
+declare const dataAttr: (guard: boolean | undefined) => Booleanish;
+declare const ariaAttr: (guard: boolean | undefined) => "true" | undefined;
+//#endregion
+export { ObserveAttributeOptions as $, contains as A, isSelfTarget as At, isActiveElement as B, trackPress as C, isCtrlOrMetaKey as Ct, trackPointerMove as D, isModifierKey as Dt, PointerUpDetails as E, isLeftClick as Et, getNodeName as F, isElementVisible as G, isDocument as H, getParentElement as I, isNode as J, isHTMLElement as K, getParentNode as L, getAncestorElements as M, isVirtualClick as Mt, getDocument as N, isVirtualPointerEvent as Nt, PercentValueOptions as O, isOpeningInNewTab as Ot, getDocumentElement as P, Booleanish as Pt, isWindow as Q, getRootNode as R, TrackPressOptions as S, isContextMenuEvent as St, PointerMoveHandlers as T, isKeyboardClick as Tt, isEditableElement as U, isAnchorElement as V, isElement as W, isShadowRoot as X, isRootElement as Y, isVisualViewport as Z, getTabbableEdges as _, getEventStep as _t, createScope as a, TrackFormControlOptions as at, isTabbable as b, getNativeEvent as bt, GetShadowRootOption as c, isInternalChangeEvent as ct, getFirstFocusable as d, setElementValue as dt, ObserveChildrenOptions as et, getFirstTabbable as f, trackFormControl as ft, getTabIndex as g, getEventPoint as gt, getNextTabbable as h, getEventKey as ht, ScopeContext as i, InputValueEventOptions as it, getActiveElement as j, isTouchEvent as jt, getRelativePoint as k, isPrintableKey as kt, NextTabbableOptions as l, markAsInternalChangeEvent as lt, getLastTabbable as m, getBeforeInputValue as mt, ariaAttr as n, observeChildren as nt, ProxyTabFocusOptions as o, dispatchInputCheckedEvent as ot, getFocusables as p, addDomEvent as pt, isInputElement as q, dataAttr as r, CheckedEventOptions as rt, proxyTabFocus as s, dispatchInputValueEvent as st, MAX_Z_INDEX as t, observeAttributes as tt, TabbableOptions as u, setElementChecked as ut, getTabbables as v, getEventStepValue as vt, PointerMoveDetails as w, isDownloadingEvent as wt, PressDetails as x, isComposingEvent as xt, isFocusable as y, getEventTarget as yt, getWindow as z };