@magnet-js/common 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fernando G. Vilar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/esm/_dnt.shims.d.ts

@@ -0,0 +1,2 @@
+export declare const dntGlobalThis: Omit<typeof globalThis, never>;
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/esm/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,gCAA2C,CAAC"}

package/esm/_dnt.shims.js

@@ -0,0 +1,57 @@
+const dntGlobals = {};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/common.d.ts

@@ -0,0 +1,80 @@
+import type { Falsy } from "@std/assert";
+/** Either a read-only or writable reactive signal. */
+export type AnySignal<T> = Computed<T> | State<T>;
+/** Disposes a subscription, effect, or other resource. */
+export interface Cleanup {
+    (): unknown | void;
+}
+/** Reactive value that can be read synchronously. */
+export interface Computed<T> {
+    get(): T;
+}
+/** Creates a reactive value derived from other signals. */
+export interface Compute {
+    <T>(computer: () => T, options?: SignalOptions<T>): Computed<T>;
+}
+/** Plain object whose values all share the same type and keys are strings. */
+export type Dict<T> = Record<string, T>;
+/** Runs a side-effect whenever its reactive dependencies change. */
+export interface Effect {
+    (callback: EffectCallback): Cleanup;
+}
+/** Body of a reactive effect; may return a cleanup function. */
+export interface EffectCallback {
+    (): Maybe<Cleanup>;
+}
+/** Determines whether an unknown value is a signal. */
+export interface IsSignal {
+    (value: unknown): value is AnySignal<unknown>;
+}
+export type Letter = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z";
+/** Value that may be missing or void. */
+export type Maybe<T> = T | null | undefined | void;
+/** Single value or a list of the same value. */
+export type MaybeArray<T> = T | T[];
+/** Plain value or a reactive wrapper of that value. */
+export type MaybeComputed<T> = T | Computed<T>;
+/** Plain value or a recursive array of the same value. */
+export type MaybeNestedArray<T> = T | NestedArray<T>;
+/** Plain value or a recursive array of reactive values. */
+export type MaybeNestedSignals<T> = MaybeSignal<T> | MaybeNestedSignals<T>[];
+/** Plain value or any reactive wrapper of that value. */
+export type MaybeSignal<T> = T | AnySignal<T>;
+/** Array that may contain more arrays of the same item type. */
+export type NestedArray<T> = (T | NestedArray<T>)[];
+/** Complete signal implementation exposed as a single dependency. */
+export interface SignalAPI {
+    isSignal: IsSignal;
+    effect: Effect;
+    state: Store;
+    computed: Compute;
+    /** Synchronously drains any pending reactive effects. */
+    flush: () => void;
+}
+/** Customizes how a signal compares new values to previous ones. */
+export interface SignalOptions<T> {
+    equals?: (this: AnySignal<T>, v1: T, v2: T) => boolean;
+}
+/** Reactive value that can be read and updated. */
+export interface State<T> extends Computed<T> {
+    set(v: T): unknown;
+}
+/** Creates a reactive, writable value. */
+export interface Store {
+    <T>(initialValue: T, options?: SignalOptions<T>): State<T>;
+}
+export declare const XHTML_NAMESPACE = "http://www.w3.org/1999/xhtml";
+export declare const MATHML_NAMESPACE = "http://www.w3.org/1998/Math/MathML";
+export declare const SVG_NAMESPACE = "http://www.w3.org/2000/svg";
+/** Detects whether the current environment has a DOM. */
+export declare const browser: () => boolean;
+/** Creates a dictionary object with no inherited properties. */
+export declare const createEmpty: <T = object>() => T;
+/** Checks whether a value is an array. */
+export declare const isArray: <T>(value: unknown) => value is T[];
+/** Checks whether a value is callable. */
+export declare const isFunction: (value: unknown) => value is (...args: unknown[]) => unknown;
+/** Checks whether a value is a string. */
+export declare const isString: (value: unknown) => value is string;
+export type { Falsy };
+//# sourceMappingURL=common.d.ts.map

package/esm/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"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"}

package/esm/common.js

@@ -0,0 +1,22 @@
+import * as dntShim from "./_dnt.shims.js";
+export const XHTML_NAMESPACE = "http://www.w3.org/1999/xhtml";
+export const MATHML_NAMESPACE = "http://www.w3.org/1998/Math/MathML";
+export const SVG_NAMESPACE = "http://www.w3.org/2000/svg";
+/** Detects whether the current environment has a DOM. */
+export const browser = () => {
+    try {
+        const { document } = dntShim.dntGlobalThis;
+        return typeof document?.createElement === "function";
+    }
+    catch {
+        return false;
+    }
+};
+/** Creates a dictionary object with no inherited properties. */
+export const createEmpty = () => Object.create(null);
+/** Checks whether a value is an array. */
+export const isArray = (value) => Array.isArray(value);
+/** Checks whether a value is callable. */
+export const isFunction = (value) => typeof value === "function";
+/** Checks whether a value is a string. */
+export const isString = (value) => typeof value === "string";

package/esm/dom/aria.d.ts

@@ -0,0 +1,266 @@
+import type { MaybeSignal } from "../common.js";
+import type { Absent } from "./globalAttributes.js";
+/**
+ * WAI-ARIA attributes that can be applied to HTML elements.
+ *
+ * Each property maps to a kebab-case (except for `role`) ARIA attribute.
+ * Values may be the attribute's allowed token, a boolean-ish string, `false`
+ * to explicitly remove the attribute, or omitted/`null`/`undefined`
+ * to leave it unset.
+ *
+ * @see https://www.w3.org/TR/wai-aria/#states_and_properties
+ */
+export interface AriaAttributes {
+    /**
+     * Identifies the currently active element when DOM focus is on a composite widget, textbox,
+     * group, or application.
+     */
+    "aria-activedescendant"?: MaybeSignal<string | Absent>;
+    /**
+     * Indicates whether assistive technologies will present all, or only parts of, the changed
+     * region based on the change notifications defined by the aria-relevant attribute.
+     */
+    "aria-atomic"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Defines a string value that labels the current element, which is intended to be converted
+     * into Braille.
+     */
+    "aria-braillelabel"?: MaybeSignal<string | Absent>;
+    /**
+     * Defines a human-readable, author-localized abbreviated description for the role of an
+     * element intended to be converted into Braille.
+     */
+    "aria-brailleroledescription"?: MaybeSignal<string | Absent>;
+    /**
+     * Indicates whether inputting text could trigger display of one or more predictions of the
+     * user's intended value for an input and specifies how predictions would be presented if they
+     * are made.
+     */
+    "aria-autocomplete"?: MaybeSignal<"none" | "inline" | "list" | "both" | Absent>;
+    /**
+     * Indicates an element is being modified and that assistive technologies MAY want to wait until
+     * the modifications are complete before exposing them to the user.
+     */
+    "aria-busy"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Indicates the current "checked" state of checkboxes, radio buttons, and other widgets.
+     */
+    "aria-checked"?: MaybeSignal<"false" | "mixed" | "true" | Absent>;
+    /**
+     * Defines the total number of columns in a table, grid, or treegrid.
+     */
+    "aria-colcount"?: MaybeSignal<number | Absent>;
+    /**
+     * Defines an element's column index or position with respect to the total number of columns
+     * within a table, grid, or treegrid.
+     */
+    "aria-colindex"?: MaybeSignal<number | Absent>;
+    /** Defines a human-readable text alternative of the numeric aria-colindex. */
+    "aria-colindextext"?: MaybeSignal<string | Absent>;
+    /**
+     * Defines the number of columns spanned by a cell or gridcell within a table, grid, or
+     * treegrid.
+     */
+    "aria-colspan"?: MaybeSignal<number | Absent>;
+    /**
+     * Identifies the element (or elements) whose contents or presence are controlled by the current
+     * element.
+     */
+    "aria-controls"?: MaybeSignal<string | Absent>;
+    /**
+     * Indicates the element that represents the current item within a container or set of related
+     * elements.
+     */
+    "aria-current"?: MaybeSignal<"false" | "true" | "page" | "step" | "location" | "date" | "time" | Absent>;
+    /**
+     * Identifies the element (or elements) that describes the object.
+     */
+    "aria-describedby"?: MaybeSignal<string | Absent>;
+    /**
+     * Defines a string value that describes or annotates the current element.
+     */
+    "aria-description"?: MaybeSignal<string | Absent>;
+    /**
+     * Identifies the element that provides a detailed, extended description for the object.
+     */
+    "aria-details"?: MaybeSignal<string | Absent>;
+    /**
+     * Indicates that the element is perceivable but disabled, so it is not editable or otherwise
+     * operable.
+     */
+    "aria-disabled"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Indicates what functions can be performed when a dragged object is released on the drop
+     * target.
+     *
+     * @deprecated in ARIA 1.1
+     */
+    "aria-dropeffect"?: MaybeSignal<"none" | "copy" | "execute" | "link" | "move" | "popup" | Absent>;
+    /**
+     * Identifies the element that provides an error message for the object.
+     */
+    "aria-errormessage"?: MaybeSignal<string | Absent>;
+    /**
+     * Indicates whether the element, or another grouping element it controls, is currently expanded
+     * or collapsed.
+     */
+    "aria-expanded"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Identifies the next element (or elements) in an alternate reading order of content which, at
+     * the user's discretion, allows assistive technology to override the general default of reading
+     * in document source order.
+     */
+    "aria-flowto"?: MaybeSignal<string | Absent>;
+    /**
+     * Indicates an element's "grabbed" state in a drag-and-drop operation.
+     *
+     * @deprecated in ARIA 1.1
+     */
+    "aria-grabbed"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Indicates the availability and type of interactive popup element, such as menu or dialog,
+     * that can be triggered by an element.
+     */
+    "aria-haspopup"?: MaybeSignal<"false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | Absent>;
+    /**
+     * Indicates whether the element is exposed to an accessibility API.
+     */
+    "aria-hidden"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Indicates the entered value does not conform to the format expected by the application.
+     */
+    "aria-invalid"?: MaybeSignal<"false" | "true" | "grammar" | "spelling" | Absent>;
+    /**
+     * Indicates keyboard shortcuts that an author has implemented to activate or give focus to an
+     * element.
+     */
+    "aria-keyshortcuts"?: MaybeSignal<string | Absent>;
+    /**
+     * Defines a string value that labels the current element.
+     */
+    "aria-label"?: MaybeSignal<string | Absent>;
+    /**
+     * Identifies the element (or elements) that labels the current element.
+     */
+    "aria-labelledby"?: MaybeSignal<string | Absent>;
+    /** Defines the hierarchical level of an element within a structure. */
+    "aria-level"?: MaybeSignal<number | Absent>;
+    /**
+     * Indicates that an element will be updated, and describes the types of updates the user
+     * agents, assistive technologies, and user can expect from the live region.
+     */
+    "aria-live"?: MaybeSignal<"off" | "assertive" | "polite" | Absent>;
+    /** Indicates whether an element is modal when displayed. */
+    "aria-modal"?: MaybeSignal<"false" | "true" | Absent>;
+    /** Indicates whether a text box accepts multiple lines of input or only a single line. */
+    "aria-multiline"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Indicates that the user may select more than one item from the current selectable
+     * descendants.
+     */
+    "aria-multiselectable"?: MaybeSignal<"false" | "true" | Absent>;
+    /** Indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. */
+    "aria-orientation"?: MaybeSignal<"horizontal" | "vertical" | "undefined" | Absent>;
+    /**
+     * Identifies an element (or elements) in order to define a visual, functional, or contextual
+     * parent/child relationship between DOM elements where the DOM hierarchy cannot be used to
+     * represent the relationship.
+     */
+    "aria-owns"?: MaybeSignal<string | Absent>;
+    /**
+     * Defines a short hint (a word or short phrase) intended to aid the user with data entry when
+     * the control has no value.
+     */
+    "aria-placeholder"?: MaybeSignal<string | Absent>;
+    /**
+     * Defines an element's number or position in the current set of listitems or treeitems.
+     */
+    "aria-posinset"?: MaybeSignal<number | Absent>;
+    /**
+     * Indicates the current "pressed" state of toggle buttons.
+     */
+    "aria-pressed"?: MaybeSignal<"false" | "mixed" | "true" | Absent>;
+    /**
+     * Indicates that the element is not editable, but is otherwise operable.
+     */
+    "aria-readonly"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Indicates what notifications the user agent will trigger when the accessibility tree within a
+     * live region is modified.
+     *
+     * Valid `aria-relevant` values: a space-separated token list, or the shorthand `all`.
+     *
+     * @see https://www.w3.org/TR/wai-aria/#aria-relevant
+     */
+    "aria-relevant"?: MaybeSignal<"all" | `additions${"" | ` removals${"" | " text"}` | ` text${"" | " removals"}`}` | `removals${"" | ` additions${"" | " text"}` | ` text${"" | " additions"}`}` | `text${"" | ` removals${"" | " additions"}` | ` additions${"" | " removals"}`}` | ("additions" | "removals" | "text")[] | Absent>;
+    /** Indicates that user input is required on the element before a form may be submitted. */
+    "aria-required"?: MaybeSignal<"false" | "true" | Absent>;
+    /** Defines a human-readable, author-localized description for the role of an element. */
+    "aria-roledescription"?: MaybeSignal<string | Absent>;
+    /**
+     * Defines the total number of rows in a table, grid, or treegrid.
+     */
+    "aria-rowcount"?: MaybeSignal<number | Absent>;
+    /**
+     * Defines an element's row index or position with respect to the total number of rows within a
+     * table, grid, or treegrid.
+     */
+    "aria-rowindex"?: MaybeSignal<number | Absent>;
+    /** Defines a human-readable text alternative of aria-rowindex. */
+    "aria-rowindextext"?: MaybeSignal<number | string | Absent>;
+    /**
+     * Defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid.
+     */
+    "aria-rowspan"?: MaybeSignal<number | Absent>;
+    /**
+     * Indicates the current "selected" state of various widgets.
+     */
+    "aria-selected"?: MaybeSignal<"false" | "true" | Absent>;
+    /**
+     * Defines the number of items in the current set of `listitems` or `treeitems`.
+     */
+    "aria-setsize"?: MaybeSignal<number | Absent>;
+    /** Indicates if items in a table or grid are sorted in ascending or descending order. */
+    "aria-sort"?: MaybeSignal<"none" | "ascending" | "descending" | "other" | Absent>;
+    /** Defines the maximum allowed value for a range widget. */
+    "aria-valuemax"?: MaybeSignal<number | Absent>;
+    /** Defines the minimum allowed value for a range widget. */
+    "aria-valuemin"?: MaybeSignal<number | Absent>;
+    /**
+     * Defines the current value for a range widget.
+     */
+    "aria-valuenow"?: MaybeSignal<number | Absent>;
+    /** Defines the human readable text alternative of aria-valuenow for a range widget. */
+    "aria-valuetext"?: MaybeSignal<string | Absent>;
+    /** Defines an explicit role for the element. */
+    role?: MaybeSignal<AriaRole | Absent>;
+}
+/** Union of all supported ARIA attribute names. */
+export type AriaAttributeKey = keyof AriaAttributes;
+/**
+ * ARIA attributes that are allowed on elements where naming is prohibited.
+ *
+ * This excludes `aria-label` and `aria-labelledby` because those attributes
+ * provide an accessible name, which must not be used on purely presentational
+ * or otherwise naming-prohibited elements.
+ */
+export type NamingNotAllowed = Exclude<AriaAttributeKey, "aria-label" | "aria-labelledby">;
+/**
+ * Canonical list of WAI-ARIA roles defined in the specification.
+ *
+ * The array is declared `as const` so its elements can be used to derive the
+ * {@link AriaRole} string literal type.
+ *
+ * @see https://www.w3.org/TR/wai-aria/#role_definitions
+ */
+export declare const ARIA_ROLES: readonly ["alert", "alertdialog", "application", "article", "banner", "button", "cell", "checkbox", "columnheader", "combobox", "complementary", "contentinfo", "definition", "dialog", "directory", "document", "feed", "figure", "form", "grid", "gridcell", "group", "heading", "img", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"];
+/** Any single role name from the WAI-ARIA role definitions. */
+export type AriaRole = (typeof ARIA_ROLES)[number];
+/**
+ * Determines whether a value is one of the known ARIA roles.
+ *
+ * @param role - The value to check.
+ * @returns `true` if `role` is a valid ARIA role.
+ */
+export declare const isAriaRole: (role: unknown) => role is AriaRole;
+//# sourceMappingURL=aria.d.ts.map

package/esm/dom/aria.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria.d.ts","sourceRoot":"","sources":["../../src/dom/aria.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACvD;;;OAGG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACvD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD;;;OAGG;IACH,6BAA6B,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7D;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,WAAW,CAC/B,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAC7C,CAAC;IACF;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACrD;;OAEG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAClE;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD;;;OAGG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C;;;OAGG;IACH,cAAc,CAAC,EAAE,WAAW,CACxB,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,CACT,CAAC;IACF;;OAEG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAClD;;OAEG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAClD;;OAEG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACzD;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,WAAW,CAC3B,MAAM,GACN,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,CACT,CAAC;IACF;;OAEG;IACH,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACzD;;;;OAIG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7C;;;;OAIG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACxD;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,CACzB,OAAO,GACP,MAAM,GACN,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,CACT,CAAC;IACF;;OAEG;IACH,aAAa,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACvD;;OAEG;IACH,cAAc,CAAC,EAAE,WAAW,CAC1B,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CACnD,CAAC;IACF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnD;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5C;;OAEG;IACH,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACjD,uEAAuE;IACvE,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5C;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IACnE,4DAA4D;IAC5D,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAC1D;;;OAGG;IACH,sBAAsB,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAChE,iGAAiG;IACjG,kBAAkB,CAAC,EAAE,WAAW,CAC9B,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CACjD,CAAC;IACF;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAClD;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C;;OAEG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAClE;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACzD;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,WAAW,CACzB,KAAK,GACL,YACE,EAAE,GACF,YAAY,EAAE,GAAG,OAAO,EAAE,GAC1B,QAAQ,EAAE,GAAG,WAAW,EAAE,EAAE,GAC9B,WACE,EAAE,GACF,aAAa,EAAE,GAAG,OAAO,EAAE,GAC3B,QAAQ,EAAE,GAAG,YAAY,EAAE,EAAE,GAC/B,OACE,EAAE,GACF,YAAY,EAAE,GAAG,YAAY,EAAE,GAC/B,aAAa,EAAE,GAAG,WAAW,EAAE,EAAE,GACnC,CAAC,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC,EAAE,GACrC,MAAM,CACT,CAAC;IACF,2FAA2F;IAC3F,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACzD,yFAAyF;IACzF,sBAAsB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACtD;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C;;;OAGG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5D;;OAEG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IACzD;;OAEG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC9C,yFAAyF;IACzF,WAAW,CAAC,EAAE,WAAW,CACvB,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,CACvD,CAAC;IACF,4DAA4D;IAC5D,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C;;OAEG;IACH,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/C,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAChD,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC;CACvC;AAED,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,MAAM,cAAc,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACpC,gBAAgB,EAChB,YAAY,GAAG,iBAAiB,CACjC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,+wBAuEb,CAAC;AAEX,+DAA+D;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,SAAU,OAAO,KAAG,IAAI,IAAI,QACZ,CAAC"}

package/esm/dom/aria.js

@@ -0,0 +1,87 @@
+/**
+ * Canonical list of WAI-ARIA roles defined in the specification.
+ *
+ * The array is declared `as const` so its elements can be used to derive the
+ * {@link AriaRole} string literal type.
+ *
+ * @see https://www.w3.org/TR/wai-aria/#role_definitions
+ */
+export const ARIA_ROLES = [
+    "alert",
+    "alertdialog",
+    "application",
+    "article",
+    "banner",
+    "button",
+    "cell",
+    "checkbox",
+    "columnheader",
+    "combobox",
+    "complementary",
+    "contentinfo",
+    "definition",
+    "dialog",
+    "directory",
+    "document",
+    "feed",
+    "figure",
+    "form",
+    "grid",
+    "gridcell",
+    "group",
+    "heading",
+    "img",
+    "link",
+    "list",
+    "listbox",
+    "listitem",
+    "log",
+    "main",
+    "marquee",
+    "math",
+    "menu",
+    "menubar",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "meter",
+    "navigation",
+    "none",
+    "note",
+    "option",
+    "presentation",
+    "progressbar",
+    "radio",
+    "radiogroup",
+    "region",
+    "row",
+    "rowgroup",
+    "rowheader",
+    "scrollbar",
+    "search",
+    "searchbox",
+    "separator",
+    "slider",
+    "spinbutton",
+    "status",
+    "switch",
+    "tab",
+    "table",
+    "tablist",
+    "tabpanel",
+    "term",
+    "textbox",
+    "timer",
+    "toolbar",
+    "tooltip",
+    "tree",
+    "treegrid",
+    "treeitem",
+];
+/**
+ * Determines whether a value is one of the known ARIA roles.
+ *
+ * @param role - The value to check.
+ * @returns `true` if `role` is a valid ARIA role.
+ */
+export const isAriaRole = (role) => ARIA_ROLES.includes(role);

package/esm/dom/globalAttributes.d.ts

@@ -0,0 +1,95 @@
+import type { Cleanup, Letter, Maybe, MaybeArray, MaybeSignal } from "../common.js";
+export type Absent = false | null | undefined;
+export interface Action<T> {
+    (element: T, connected: boolean): Maybe<Cleanup>;
+}
+/** Valid tag name for a custom HTML element. */
+export type CustomElementName = `${Letter}${Lowercase<string>}-${Letter}${Lowercase<string>}`;
+/** Data attribute name. */
+export type DataAttribute = `data-${string}`;
+export type EventListenerKey = `on${keyof GlobalEventHandlersEventMap}`;
+export interface Listener<T, E> {
+    (this: T, event: E): unknown;
+}
+export interface ListenerObject<E> extends AddEventListenerOptions {
+    handleEvent(event: E): unknown;
+    prevent?: boolean;
+    stop?: boolean;
+    stopImmediate?: boolean;
+}
+export type EventHandler<T, E> = string | Listener<T, E> | ListenerObject<E> | Absent;
+export type Listeners<T> = {
+    [K in keyof GlobalEventHandlersEventMap as `on${K}`]?: MaybeSignal<MaybeArray<EventHandler<T, GlobalEventHandlersEventMap[K]>>>;
+};
+/**
+ * HTML global attributes shared by all elements.
+ *
+ * @see https://html.spec.whatwg.org/multipage/dom.html#global-attributes
+ */
+export interface HTMLGlobalAttributes<T> extends Listeners<T> {
+    /** Keyboard shortcut(s) to activate or focus the element. */
+    accesskey?: MaybeSignal<string | Absent>;
+    /** Controls whether and how text input is automatically capitalized. */
+    autocapitalize?: MaybeSignal<"none" | "off" | "on" | "sentences" | "words" | "characters" | Absent>;
+    /** Controls whether and how text input is automatically corrected. */
+    autocorrect?: MaybeSignal<"" | "on" | "off" | boolean | Absent>;
+    /** Focuses the element automatically when the document is loaded. */
+    autofocus?: MaybeSignal<"" | boolean | Absent>;
+    /** CSS classes to apply to the element; may be a single string or a list. */
+    class?: MaybeSignal<string[] | string | Absent>;
+    /** Indicates whether the element's content is editable. */
+    contenteditable?: MaybeSignal<"" | "true" | "false" | "inherit" | "plaintext-only" | boolean | Absent>;
+    /** Custom `data-*` attributes. */
+    [k: DataAttribute]: MaybeSignal<(string | number | bigint | Absent)[] | string | bigint | number | Absent>;
+    /** Text directionality of the element's content. */
+    dir?: MaybeSignal<"ltr" | "rtl" | "auto" | Absent>;
+    /** Whether the element is draggable. */
+    draggable?: MaybeSignal<"true" | "false" | Absent>;
+    /** Hint for the action label of the Enter key on virtual keyboards. */
+    enterkeyhint?: MaybeSignal<"enter" | "done" | "go" | "next" | "previous" | "search" | "send" | Absent>;
+    /** Hides the element from the accessibility tree and rendering. */
+    hidden?: MaybeSignal<"" | "hidden" | "until-found" | boolean | Absent>;
+    /** Unique identifier for the element within the document. */
+    id?: MaybeSignal<string | Absent>;
+    /** Makes the element and its descendants inert to user input and accessibility. */
+    inert?: MaybeSignal<"" | boolean | Absent>;
+    /** Hint for selecting a virtual keyboard layout. */
+    inputmode?: MaybeSignal<"none" | "text" | "decimal" | "numeric" | "tel" | "search" | "email" | "url" | Absent>;
+    /** Customized built-in element type name for the `is` attribute. */
+    is?: MaybeSignal<CustomElementName | Absent>;
+    /** Global identifier of the element's microdata item. */
+    itemid?: MaybeSignal<string | Absent>;
+    /** Names of the element's microdata properties. */
+    itemprop?: MaybeSignal<string | Absent>;
+    /** IDs of elements that supply additional microdata property values. */
+    itemref?: MaybeSignal<string | Absent>;
+    /** Creates a microdata item with the element as its scope. */
+    itemscope?: MaybeSignal<"" | boolean | Absent>;
+    /** URLs identifying the type(s) of the microdata item. */
+    itemtype?: MaybeSignal<string | Absent>;
+    /** Language of the element's content. */
+    lang?: MaybeSignal<string | Absent>;
+    /** Cryptographic nonce for inline style or script content. */
+    nonce?: MaybeSignal<string | Absent>;
+    /** Names of the element's exportable shadow parts. */
+    part?: MaybeSignal<string | Absent>;
+    /** Turns the element into a popover control. */
+    popover?: MaybeSignal<"auto" | "hint" | "manual" | Absent>;
+    /** Name of the shadow DOM slot the element is assigned to. */
+    slot?: MaybeSignal<string | Absent>;
+    /** Whether the element's content is checked for spelling errors. */
+    spellcheck?: MaybeSignal<"" | "true" | "false" | boolean | Absent>;
+    /** Inline CSS styles for the element. */
+    style?: MaybeSignal<string | Absent>;
+    /** Whether the element is focusable and its relative tab order. */
+    tabindex?: MaybeSignal<"" | "0" | "-1" | number | boolean | Absent>;
+    /** Advisory information displayed as a tooltip. */
+    title?: MaybeSignal<string | Absent>;
+    /** Whether the element's translatable attributes and text nodes should be translated. */
+    translate?: MaybeSignal<"" | "yes" | "no" | boolean | Absent>;
+    /** Controls whether virtual keyboards appear when the element is focused. */
+    virtualkeyboardpolicy?: MaybeSignal<"" | "auto" | "manual" | boolean | Absent>;
+    /** Whether the browser may offer writing suggestions for the element. */
+    writingsuggestions?: MaybeSignal<"false" | "true" | Absent>;
+}
+//# sourceMappingURL=globalAttributes.d.ts.map