@just-web/toolkits 1.0.0

package/dist/_internal/utils/try-parse-json.cjs

@@ -0,0 +1,14 @@
+
+//#region src/_internal/utils/try-parse-json.ts
+function tryParseJSON(json) {
+	if (!json) return void 0;
+	try {
+		return JSON.parse(json);
+	} catch {
+		return;
+	}
+}
+
+//#endregion
+exports.tryParseJSON = tryParseJSON;
+//# sourceMappingURL=try-parse-json.cjs.map

package/dist/_internal/utils/try-parse-json.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-parse-json.cjs","names":[],"sources":["../../../src/_internal/utils/try-parse-json.ts"],"sourcesContent":["export function tryParseJSON<T>(json: string | null | undefined): T | undefined {\n\tif (!json) return undefined\n\ttry {\n\t\treturn JSON.parse(json)\n\t} catch {\n\t\treturn undefined\n\t}\n}\n"],"mappings":";;AAAA,SAAgB,aAAgB,MAAgD;AAC/E,KAAI,CAAC,KAAM,QAAO;AAClB,KAAI;AACH,SAAO,KAAK,MAAM,KAAK;SAChB;AACP"}

package/dist/_internal/utils/try-parse-json.mjs

@@ -0,0 +1,13 @@
+//#region src/_internal/utils/try-parse-json.ts
+function tryParseJSON(json) {
+	if (!json) return void 0;
+	try {
+		return JSON.parse(json);
+	} catch {
+		return;
+	}
+}
+
+//#endregion
+export { tryParseJSON };
+//# sourceMappingURL=try-parse-json.mjs.map

package/dist/_internal/utils/try-parse-json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-parse-json.mjs","names":[],"sources":["../../../src/_internal/utils/try-parse-json.ts"],"sourcesContent":["export function tryParseJSON<T>(json: string | null | undefined): T | undefined {\n\tif (!json) return undefined\n\ttry {\n\t\treturn JSON.parse(json)\n\t} catch {\n\t\treturn undefined\n\t}\n}\n"],"mappings":";AAAA,SAAgB,aAAgB,MAAgD;AAC/E,KAAI,CAAC,KAAM,QAAO;AAClB,KAAI;AACH,SAAO,KAAK,MAAM,KAAK;SAChB;AACP"}

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,29 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/attributes/data-attribute.d.cts

@@ -0,0 +1,17 @@
+//#region src/attributes/data-attribute.d.ts
+/**
+ * Well-known data attribute names used in web development.
+ * Includes testing, analytics, Radix/shadcn-style component state,
+ * positioning, and common UI/design-system attributes.
+ * The `data-${string}` tail allows any custom data attribute.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/data-* MDN: data-* (HTML)}
+ * @see {@link https://testing-library.com/docs/queries/bytestid/ Testing Library: ByTestId}
+ * @see {@link https://css-tricks.com/a-complete-guide-to-data-attributes/ CSS-Tricks: A Complete Guide to Data Attributes}
+ * @see {@link https://www.components.build/data-attributes Components.build: Data Attributes}
+ * @see {@link https://www.radix-ui.com/primitives/docs/guides/styling Radix UI: Styling (data attributes)}
+ */
+type DataAttribute = 'data-testid' | 'data-metrics' | 'data-state' | 'data-orientation' | 'data-side' | 'data-align' | 'data-placement' | 'data-loading' | 'data-disabled' | 'data-selected' | 'data-checked' | 'data-expanded' | 'data-highlighted' | 'data-active' | 'data-open' | 'data-pressed' | 'data-value' | 'data-id' | 'data-name' | 'data-type' | 'data-label' | 'data-key' | 'data-index' | 'data-position' | 'data-variant' | 'data-size' | 'data-theme' | 'data-color' | 'data-intent' | (`data-${string}` & {});
+//#endregion
+export { DataAttribute };
+//# sourceMappingURL=data-attribute.d.cts.map

package/dist/attributes/data-attribute.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-attribute.d.cts","names":[],"sources":["../../src/attributes/data-attribute.ts"],"sourcesContent":[],"mappings":";;AAYA;;;;;;;;;;;KAAY,aAAA"}

package/dist/attributes/data-attribute.d.mts

@@ -0,0 +1,17 @@
+//#region src/attributes/data-attribute.d.ts
+/**
+ * Well-known data attribute names used in web development.
+ * Includes testing, analytics, Radix/shadcn-style component state,
+ * positioning, and common UI/design-system attributes.
+ * The `data-${string}` tail allows any custom data attribute.
+ *
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/data-* MDN: data-* (HTML)}
+ * @see {@link https://testing-library.com/docs/queries/bytestid/ Testing Library: ByTestId}
+ * @see {@link https://css-tricks.com/a-complete-guide-to-data-attributes/ CSS-Tricks: A Complete Guide to Data Attributes}
+ * @see {@link https://www.components.build/data-attributes Components.build: Data Attributes}
+ * @see {@link https://www.radix-ui.com/primitives/docs/guides/styling Radix UI: Styling (data attributes)}
+ */
+type DataAttribute = 'data-testid' | 'data-metrics' | 'data-state' | 'data-orientation' | 'data-side' | 'data-align' | 'data-placement' | 'data-loading' | 'data-disabled' | 'data-selected' | 'data-checked' | 'data-expanded' | 'data-highlighted' | 'data-active' | 'data-open' | 'data-pressed' | 'data-value' | 'data-id' | 'data-name' | 'data-type' | 'data-label' | 'data-key' | 'data-index' | 'data-position' | 'data-variant' | 'data-size' | 'data-theme' | 'data-color' | 'data-intent' | (`data-${string}` & {});
+//#endregion
+export { DataAttribute };
+//# sourceMappingURL=data-attribute.d.mts.map

package/dist/attributes/data-attribute.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-attribute.d.mts","names":[],"sources":["../../src/attributes/data-attribute.ts"],"sourcesContent":[],"mappings":";;AAYA;;;;;;;;;;;KAAY,aAAA"}

package/dist/attributes/get-attribute.cjs

@@ -0,0 +1,26 @@
+
+//#region src/attributes/get-attribute.ts
+/**
+* Gets the value of an attribute from an element.
+*
+* @param qualifiedName - The name of the attribute to get
+* @param element - The element to get the attribute from. Defaults to `document.documentElement`
+* @returns The attribute value cast to type T, or null if the attribute doesn't exist
+*
+* @example
+* ```ts
+* // Get theme from document root
+* const theme = getAttribute('data-theme')
+*
+* // Get data-testid from a specific element
+* const testId = getAttribute('data-testid', element)
+* ```
+*/
+function getAttribute(qualifiedName, element) {
+	element = element ?? globalThis.document.documentElement;
+	return element.getAttribute(qualifiedName);
+}
+
+//#endregion
+exports.getAttribute = getAttribute;
+//# sourceMappingURL=get-attribute.cjs.map

package/dist/attributes/get-attribute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-attribute.cjs","names":[],"sources":["../../src/attributes/get-attribute.ts"],"sourcesContent":["/**\n * Gets the value of an attribute from an element.\n *\n * @param qualifiedName - The name of the attribute to get\n * @param element - The element to get the attribute from. Defaults to `document.documentElement`\n * @returns The attribute value cast to type T, or null if the attribute doesn't exist\n *\n * @example\n * ```ts\n * // Get theme from document root\n * const theme = getAttribute('data-theme')\n *\n * // Get data-testid from a specific element\n * const testId = getAttribute('data-testid', element)\n * ```\n */\nexport function getAttribute<T extends string>(qualifiedName: T, element?: Element | undefined) {\n\telement = element ?? globalThis.document.documentElement\n\treturn element.getAttribute(qualifiedName)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,SAAgB,aAA+B,eAAkB,SAA+B;AAC/F,WAAU,WAAW,WAAW,SAAS;AACzC,QAAO,QAAQ,aAAa,cAAc"}

package/dist/attributes/get-attribute.d.cts

@@ -0,0 +1,21 @@
+//#region src/attributes/get-attribute.d.ts
+/**
+ * Gets the value of an attribute from an element.
+ *
+ * @param qualifiedName - The name of the attribute to get
+ * @param element - The element to get the attribute from. Defaults to `document.documentElement`
+ * @returns The attribute value cast to type T, or null if the attribute doesn't exist
+ *
+ * @example
+ * ```ts
+ * // Get theme from document root
+ * const theme = getAttribute('data-theme')
+ *
+ * // Get data-testid from a specific element
+ * const testId = getAttribute('data-testid', element)
+ * ```
+ */
+declare function getAttribute<T extends string>(qualifiedName: T, element?: Element | undefined): string | null;
+//#endregion
+export { getAttribute };
+//# sourceMappingURL=get-attribute.d.cts.map

package/dist/attributes/get-attribute.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-attribute.d.cts","names":[],"sources":["../../src/attributes/get-attribute.ts"],"sourcesContent":[],"mappings":";;AAgBA;;;;;;;;;;;;;;;iBAAgB,8CAA8C,aAAa"}

package/dist/attributes/get-attribute.d.mts

@@ -0,0 +1,21 @@
+//#region src/attributes/get-attribute.d.ts
+/**
+ * Gets the value of an attribute from an element.
+ *
+ * @param qualifiedName - The name of the attribute to get
+ * @param element - The element to get the attribute from. Defaults to `document.documentElement`
+ * @returns The attribute value cast to type T, or null if the attribute doesn't exist
+ *
+ * @example
+ * ```ts
+ * // Get theme from document root
+ * const theme = getAttribute('data-theme')
+ *
+ * // Get data-testid from a specific element
+ * const testId = getAttribute('data-testid', element)
+ * ```
+ */
+declare function getAttribute<T extends string>(qualifiedName: T, element?: Element | undefined): string | null;
+//#endregion
+export { getAttribute };
+//# sourceMappingURL=get-attribute.d.mts.map

package/dist/attributes/get-attribute.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-attribute.d.mts","names":[],"sources":["../../src/attributes/get-attribute.ts"],"sourcesContent":[],"mappings":";;AAgBA;;;;;;;;;;;;;;;iBAAgB,8CAA8C,aAAa"}

package/dist/attributes/get-attribute.mjs

@@ -0,0 +1,25 @@
+//#region src/attributes/get-attribute.ts
+/**
+* Gets the value of an attribute from an element.
+*
+* @param qualifiedName - The name of the attribute to get
+* @param element - The element to get the attribute from. Defaults to `document.documentElement`
+* @returns The attribute value cast to type T, or null if the attribute doesn't exist
+*
+* @example
+* ```ts
+* // Get theme from document root
+* const theme = getAttribute('data-theme')
+*
+* // Get data-testid from a specific element
+* const testId = getAttribute('data-testid', element)
+* ```
+*/
+function getAttribute(qualifiedName, element) {
+	element = element ?? globalThis.document.documentElement;
+	return element.getAttribute(qualifiedName);
+}
+
+//#endregion
+export { getAttribute };
+//# sourceMappingURL=get-attribute.mjs.map

package/dist/attributes/get-attribute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-attribute.mjs","names":[],"sources":["../../src/attributes/get-attribute.ts"],"sourcesContent":["/**\n * Gets the value of an attribute from an element.\n *\n * @param qualifiedName - The name of the attribute to get\n * @param element - The element to get the attribute from. Defaults to `document.documentElement`\n * @returns The attribute value cast to type T, or null if the attribute doesn't exist\n *\n * @example\n * ```ts\n * // Get theme from document root\n * const theme = getAttribute('data-theme')\n *\n * // Get data-testid from a specific element\n * const testId = getAttribute('data-testid', element)\n * ```\n */\nexport function getAttribute<T extends string>(qualifiedName: T, element?: Element | undefined) {\n\telement = element ?? globalThis.document.documentElement\n\treturn element.getAttribute(qualifiedName)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,SAAgB,aAA+B,eAAkB,SAA+B;AAC/F,WAAU,WAAW,WAAW,SAAS;AACzC,QAAO,QAAQ,aAAa,cAAc"}

package/dist/attributes/get-data-attribute.cjs

@@ -0,0 +1,19 @@
+const require_get_attribute = require('./get-attribute.cjs');
+
+//#region src/attributes/get-data-attribute.ts
+/**
+* Gets the value of a data attribute from an element.
+*
+* @param qualifiedName - The name of the data attribute to get
+* @param element - The element to get the data attribute from. Defaults to `document.documentElement`
+* @returns The data attribute value, or null if the attribute doesn't exist
+*
+* @example
+*/
+function getDataAttribute(qualifiedName, element) {
+	return require_get_attribute.getAttribute(qualifiedName, element);
+}
+
+//#endregion
+exports.getDataAttribute = getDataAttribute;
+//# sourceMappingURL=get-data-attribute.cjs.map

package/dist/attributes/get-data-attribute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-data-attribute.cjs","names":["getAttribute"],"sources":["../../src/attributes/get-data-attribute.ts"],"sourcesContent":["import type { DataAttribute } from './data-attribute.ts'\nimport { getAttribute } from './get-attribute.ts'\n\n/**\n * Gets the value of a data attribute from an element.\n *\n * @param qualifiedName - The name of the data attribute to get\n * @param element - The element to get the data attribute from. Defaults to `document.documentElement`\n * @returns The data attribute value, or null if the attribute doesn't exist\n *\n * @example\n */\nexport function getDataAttribute(qualifiedName: DataAttribute, element?: Element | undefined) {\n\treturn getAttribute(qualifiedName, element)\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,iBAAiB,eAA8B,SAA+B;AAC7F,QAAOA,mCAAa,eAAe,QAAQ"}

package/dist/attributes/get-data-attribute.d.cts

@@ -0,0 +1,17 @@
+import { DataAttribute } from "./data-attribute.cjs";
+
+//#region src/attributes/get-data-attribute.d.ts
+
+/**
+ * Gets the value of a data attribute from an element.
+ *
+ * @param qualifiedName - The name of the data attribute to get
+ * @param element - The element to get the data attribute from. Defaults to `document.documentElement`
+ * @returns The data attribute value, or null if the attribute doesn't exist
+ *
+ * @example
+ */
+declare function getDataAttribute(qualifiedName: DataAttribute, element?: Element | undefined): string | null;
+//#endregion
+export { getDataAttribute };
+//# sourceMappingURL=get-data-attribute.d.cts.map

package/dist/attributes/get-data-attribute.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-data-attribute.d.cts","names":[],"sources":["../../src/attributes/get-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;;;;;;;iBAAgB,gBAAA,gBAAgC,yBAAyB"}

package/dist/attributes/get-data-attribute.d.mts

@@ -0,0 +1,17 @@
+import { DataAttribute } from "./data-attribute.mjs";
+
+//#region src/attributes/get-data-attribute.d.ts
+
+/**
+ * Gets the value of a data attribute from an element.
+ *
+ * @param qualifiedName - The name of the data attribute to get
+ * @param element - The element to get the data attribute from. Defaults to `document.documentElement`
+ * @returns The data attribute value, or null if the attribute doesn't exist
+ *
+ * @example
+ */
+declare function getDataAttribute(qualifiedName: DataAttribute, element?: Element | undefined): string | null;
+//#endregion
+export { getDataAttribute };
+//# sourceMappingURL=get-data-attribute.d.mts.map

package/dist/attributes/get-data-attribute.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-data-attribute.d.mts","names":[],"sources":["../../src/attributes/get-data-attribute.ts"],"sourcesContent":[],"mappings":";;;;;;AAYA;;;;;;;iBAAgB,gBAAA,gBAAgC,yBAAyB"}

package/dist/attributes/get-data-attribute.mjs

@@ -0,0 +1,19 @@
+import { getAttribute } from "./get-attribute.mjs";
+
+//#region src/attributes/get-data-attribute.ts
+/**
+* Gets the value of a data attribute from an element.
+*
+* @param qualifiedName - The name of the data attribute to get
+* @param element - The element to get the data attribute from. Defaults to `document.documentElement`
+* @returns The data attribute value, or null if the attribute doesn't exist
+*
+* @example
+*/
+function getDataAttribute(qualifiedName, element) {
+	return getAttribute(qualifiedName, element);
+}
+
+//#endregion
+export { getDataAttribute };
+//# sourceMappingURL=get-data-attribute.mjs.map

package/dist/attributes/get-data-attribute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-data-attribute.mjs","names":[],"sources":["../../src/attributes/get-data-attribute.ts"],"sourcesContent":["import type { DataAttribute } from './data-attribute.ts'\nimport { getAttribute } from './get-attribute.ts'\n\n/**\n * Gets the value of a data attribute from an element.\n *\n * @param qualifiedName - The name of the data attribute to get\n * @param element - The element to get the data attribute from. Defaults to `document.documentElement`\n * @returns The data attribute value, or null if the attribute doesn't exist\n *\n * @example\n */\nexport function getDataAttribute(qualifiedName: DataAttribute, element?: Element | undefined) {\n\treturn getAttribute(qualifiedName, element)\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,iBAAiB,eAA8B,SAA+B;AAC7F,QAAO,aAAa,eAAe,QAAQ"}

package/dist/attributes/observe-attribute.cjs

@@ -0,0 +1,40 @@
+
+//#region src/attributes/observe-attribute.ts
+/**
+* Observes attributes changes on an element and calls corresponding handlers.
+*
+* @param handlers - An object mapping attribute names to handler functions.
+* @param element - The element to observe. Defaults to `document.documentElement`.
+* @returns {MutationObserver} The observer instance, which can be used to disconnect the observer.
+*
+* @example
+* ```ts
+* const observer = observeAttributes({
+*   'data-theme': (attr, value) => console.log(`Theme changed to: ${value}`),
+*   'class': (attr, value) => console.log(`class changed to: ${value}`)
+* });
+*
+* // Later, to stop observing:
+* observer.disconnect();
+* ```
+*/
+function observeAttributes(handlers, element) {
+	element = element ?? globalThis.document.documentElement;
+	const observer = new MutationObserver((mutations) => {
+		for (const mutation of mutations) {
+			const attribute = mutation.attributeName;
+			if (!attribute) continue;
+			const value = element.getAttribute(attribute);
+			handlers[attribute]?.(value);
+		}
+	});
+	observer.observe(element, {
+		attributes: true,
+		attributeFilter: Object.keys(handlers)
+	});
+	return observer;
+}
+
+//#endregion
+exports.observeAttributes = observeAttributes;
+//# sourceMappingURL=observe-attribute.cjs.map

package/dist/attributes/observe-attribute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-attribute.cjs","names":[],"sources":["../../src/attributes/observe-attribute.ts"],"sourcesContent":["/**\n * Observes attributes changes on an element and calls corresponding handlers.\n *\n * @param handlers - An object mapping attribute names to handler functions.\n * @param element - The element to observe. Defaults to `document.documentElement`.\n * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer.\n *\n * @example\n * ```ts\n * const observer = observeAttributes({\n *   'data-theme': (attr, value) => console.log(`Theme changed to: ${value}`),\n *   'class': (attr, value) => console.log(`class changed to: ${value}`)\n * });\n *\n * // Later, to stop observing:\n * observer.disconnect();\n * ```\n */\nexport function observeAttributes<T extends string>(\n\thandlers: Record<string, (value: T | null) => void>,\n\telement?: Element | undefined\n) {\n\telement = element ?? globalThis.document.documentElement\n\tconst observer = new MutationObserver((mutations) => {\n\t\tfor (const mutation of mutations) {\n\t\t\tconst attribute = mutation.attributeName\n\t\t\tif (!attribute) continue\n\t\t\tconst value = element.getAttribute(attribute) as T | null\n\t\t\thandlers[attribute]?.(value)\n\t\t}\n\t})\n\tobserver.observe(element, {\n\t\tattributes: true,\n\t\tattributeFilter: Object.keys(handlers)\n\t})\n\treturn observer\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,kBACf,UACA,SACC;AACD,WAAU,WAAW,WAAW,SAAS;CACzC,MAAM,WAAW,IAAI,kBAAkB,cAAc;AACpD,OAAK,MAAM,YAAY,WAAW;GACjC,MAAM,YAAY,SAAS;AAC3B,OAAI,CAAC,UAAW;GAChB,MAAM,QAAQ,QAAQ,aAAa,UAAU;AAC7C,YAAS,aAAa,MAAM;;GAE5B;AACF,UAAS,QAAQ,SAAS;EACzB,YAAY;EACZ,iBAAiB,OAAO,KAAK,SAAS;EACtC,CAAC;AACF,QAAO"}

package/dist/attributes/observe-attribute.d.cts

@@ -0,0 +1,23 @@
+//#region src/attributes/observe-attribute.d.ts
+/**
+ * Observes attributes changes on an element and calls corresponding handlers.
+ *
+ * @param handlers - An object mapping attribute names to handler functions.
+ * @param element - The element to observe. Defaults to `document.documentElement`.
+ * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer.
+ *
+ * @example
+ * ```ts
+ * const observer = observeAttributes({
+ *   'data-theme': (attr, value) => console.log(`Theme changed to: ${value}`),
+ *   'class': (attr, value) => console.log(`class changed to: ${value}`)
+ * });
+ *
+ * // Later, to stop observing:
+ * observer.disconnect();
+ * ```
+ */
+declare function observeAttributes<T extends string>(handlers: Record<string, (value: T | null) => void>, element?: Element | undefined): MutationObserver;
+//#endregion
+export { observeAttributes };
+//# sourceMappingURL=observe-attribute.d.cts.map

package/dist/attributes/observe-attribute.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-attribute.d.cts","names":[],"sources":["../../src/attributes/observe-attribute.ts"],"sourcesContent":[],"mappings":";;AAkBA;;;;;;;;;;;;;;;;;iBAAgB,8CACL,uBAAuB,8BACvB,sBAAmB"}

package/dist/attributes/observe-attribute.d.mts

@@ -0,0 +1,23 @@
+//#region src/attributes/observe-attribute.d.ts
+/**
+ * Observes attributes changes on an element and calls corresponding handlers.
+ *
+ * @param handlers - An object mapping attribute names to handler functions.
+ * @param element - The element to observe. Defaults to `document.documentElement`.
+ * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer.
+ *
+ * @example
+ * ```ts
+ * const observer = observeAttributes({
+ *   'data-theme': (attr, value) => console.log(`Theme changed to: ${value}`),
+ *   'class': (attr, value) => console.log(`class changed to: ${value}`)
+ * });
+ *
+ * // Later, to stop observing:
+ * observer.disconnect();
+ * ```
+ */
+declare function observeAttributes<T extends string>(handlers: Record<string, (value: T | null) => void>, element?: Element | undefined): MutationObserver;
+//#endregion
+export { observeAttributes };
+//# sourceMappingURL=observe-attribute.d.mts.map

package/dist/attributes/observe-attribute.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-attribute.d.mts","names":[],"sources":["../../src/attributes/observe-attribute.ts"],"sourcesContent":[],"mappings":";;AAkBA;;;;;;;;;;;;;;;;;iBAAgB,8CACL,uBAAuB,8BACvB,sBAAmB"}

package/dist/attributes/observe-attribute.mjs

@@ -0,0 +1,39 @@
+//#region src/attributes/observe-attribute.ts
+/**
+* Observes attributes changes on an element and calls corresponding handlers.
+*
+* @param handlers - An object mapping attribute names to handler functions.
+* @param element - The element to observe. Defaults to `document.documentElement`.
+* @returns {MutationObserver} The observer instance, which can be used to disconnect the observer.
+*
+* @example
+* ```ts
+* const observer = observeAttributes({
+*   'data-theme': (attr, value) => console.log(`Theme changed to: ${value}`),
+*   'class': (attr, value) => console.log(`class changed to: ${value}`)
+* });
+*
+* // Later, to stop observing:
+* observer.disconnect();
+* ```
+*/
+function observeAttributes(handlers, element) {
+	element = element ?? globalThis.document.documentElement;
+	const observer = new MutationObserver((mutations) => {
+		for (const mutation of mutations) {
+			const attribute = mutation.attributeName;
+			if (!attribute) continue;
+			const value = element.getAttribute(attribute);
+			handlers[attribute]?.(value);
+		}
+	});
+	observer.observe(element, {
+		attributes: true,
+		attributeFilter: Object.keys(handlers)
+	});
+	return observer;
+}
+
+//#endregion
+export { observeAttributes };
+//# sourceMappingURL=observe-attribute.mjs.map

package/dist/attributes/observe-attribute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-attribute.mjs","names":[],"sources":["../../src/attributes/observe-attribute.ts"],"sourcesContent":["/**\n * Observes attributes changes on an element and calls corresponding handlers.\n *\n * @param handlers - An object mapping attribute names to handler functions.\n * @param element - The element to observe. Defaults to `document.documentElement`.\n * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer.\n *\n * @example\n * ```ts\n * const observer = observeAttributes({\n *   'data-theme': (attr, value) => console.log(`Theme changed to: ${value}`),\n *   'class': (attr, value) => console.log(`class changed to: ${value}`)\n * });\n *\n * // Later, to stop observing:\n * observer.disconnect();\n * ```\n */\nexport function observeAttributes<T extends string>(\n\thandlers: Record<string, (value: T | null) => void>,\n\telement?: Element | undefined\n) {\n\telement = element ?? globalThis.document.documentElement\n\tconst observer = new MutationObserver((mutations) => {\n\t\tfor (const mutation of mutations) {\n\t\t\tconst attribute = mutation.attributeName\n\t\t\tif (!attribute) continue\n\t\t\tconst value = element.getAttribute(attribute) as T | null\n\t\t\thandlers[attribute]?.(value)\n\t\t}\n\t})\n\tobserver.observe(element, {\n\t\tattributes: true,\n\t\tattributeFilter: Object.keys(handlers)\n\t})\n\treturn observer\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,kBACf,UACA,SACC;AACD,WAAU,WAAW,WAAW,SAAS;CACzC,MAAM,WAAW,IAAI,kBAAkB,cAAc;AACpD,OAAK,MAAM,YAAY,WAAW;GACjC,MAAM,YAAY,SAAS;AAC3B,OAAI,CAAC,UAAW;GAChB,MAAM,QAAQ,QAAQ,aAAa,UAAU;AAC7C,YAAS,aAAa,MAAM;;GAE5B;AACF,UAAS,QAAQ,SAAS;EACzB,YAAY;EACZ,iBAAiB,OAAO,KAAK,SAAS;EACtC,CAAC;AACF,QAAO"}

package/dist/attributes/observe-data-attribute.cjs

@@ -0,0 +1,31 @@
+const require_observe_attribute = require('./observe-attribute.cjs');
+
+//#region src/attributes/observe-data-attribute.ts
+/**
+* Observes changes to `data-*` attributes on an element and calls corresponding handlers.
+*
+* @param options - Configuration options
+* @param options.handlers - An object mapping `data-*` attribute names to handler functions.
+* @param options.element - The element to observe. Defaults to `document.documentElement`
+* @returns {MutationObserver} The observer instance, which can be used to disconnect the observer
+*
+* @example
+* ```ts
+* const observer = observeDataAttributes({
+*   handlers: {
+*     'data-theme': (value) => console.log(`Theme changed to: ${value}`),
+*     'data-mode': (value) => console.log(`Mode changed to: ${value}`)
+*   }
+* });
+*
+* // Later, to stop observing:
+* observer.disconnect();
+* ```
+*/
+function observeDataAttributes(handlers, element) {
+	return require_observe_attribute.observeAttributes(handlers, element);
+}
+
+//#endregion
+exports.observeDataAttributes = observeDataAttributes;
+//# sourceMappingURL=observe-data-attribute.cjs.map

package/dist/attributes/observe-data-attribute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-data-attribute.cjs","names":["observeAttributes"],"sources":["../../src/attributes/observe-data-attribute.ts"],"sourcesContent":["import { observeAttributes } from './observe-attribute.ts'\n\n/**\n * Observes changes to `data-*` attributes on an element and calls corresponding handlers.\n *\n * @param options - Configuration options\n * @param options.handlers - An object mapping `data-*` attribute names to handler functions.\n * @param options.element - The element to observe. Defaults to `document.documentElement`\n * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer\n *\n * @example\n * ```ts\n * const observer = observeDataAttributes({\n *   handlers: {\n *     'data-theme': (value) => console.log(`Theme changed to: ${value}`),\n *     'data-mode': (value) => console.log(`Mode changed to: ${value}`)\n *   }\n * });\n *\n * // Later, to stop observing:\n * observer.disconnect();\n * ```\n */\nexport function observeDataAttributes<T extends string, K extends `data-${string}`>(\n\thandlers: Record<K, (value: T | null) => void>,\n\telement?: Element | undefined\n) {\n\treturn observeAttributes(handlers, element)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,sBACf,UACA,SACC;AACD,QAAOA,4CAAkB,UAAU,QAAQ"}

package/dist/attributes/observe-data-attribute.d.cts

@@ -0,0 +1,26 @@
+//#region src/attributes/observe-data-attribute.d.ts
+/**
+ * Observes changes to `data-*` attributes on an element and calls corresponding handlers.
+ *
+ * @param options - Configuration options
+ * @param options.handlers - An object mapping `data-*` attribute names to handler functions.
+ * @param options.element - The element to observe. Defaults to `document.documentElement`
+ * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer
+ *
+ * @example
+ * ```ts
+ * const observer = observeDataAttributes({
+ *   handlers: {
+ *     'data-theme': (value) => console.log(`Theme changed to: ${value}`),
+ *     'data-mode': (value) => console.log(`Mode changed to: ${value}`)
+ *   }
+ * });
+ *
+ * // Later, to stop observing:
+ * observer.disconnect();
+ * ```
+ */
+declare function observeDataAttributes<T extends string, K extends `data-${string}`>(handlers: Record<K, (value: T | null) => void>, element?: Element | undefined): MutationObserver;
+//#endregion
+export { observeDataAttributes };
+//# sourceMappingURL=observe-data-attribute.d.cts.map

package/dist/attributes/observe-data-attribute.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-data-attribute.d.cts","names":[],"sources":["../../src/attributes/observe-data-attribute.ts"],"sourcesContent":[],"mappings":";;AAuBA;;;;;;;;;;;;;;;;;;;;iBAAgB,8EACL,OAAO,WAAW,8BAClB,sBAAmB"}

package/dist/attributes/observe-data-attribute.d.mts

@@ -0,0 +1,26 @@
+//#region src/attributes/observe-data-attribute.d.ts
+/**
+ * Observes changes to `data-*` attributes on an element and calls corresponding handlers.
+ *
+ * @param options - Configuration options
+ * @param options.handlers - An object mapping `data-*` attribute names to handler functions.
+ * @param options.element - The element to observe. Defaults to `document.documentElement`
+ * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer
+ *
+ * @example
+ * ```ts
+ * const observer = observeDataAttributes({
+ *   handlers: {
+ *     'data-theme': (value) => console.log(`Theme changed to: ${value}`),
+ *     'data-mode': (value) => console.log(`Mode changed to: ${value}`)
+ *   }
+ * });
+ *
+ * // Later, to stop observing:
+ * observer.disconnect();
+ * ```
+ */
+declare function observeDataAttributes<T extends string, K extends `data-${string}`>(handlers: Record<K, (value: T | null) => void>, element?: Element | undefined): MutationObserver;
+//#endregion
+export { observeDataAttributes };
+//# sourceMappingURL=observe-data-attribute.d.mts.map

package/dist/attributes/observe-data-attribute.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-data-attribute.d.mts","names":[],"sources":["../../src/attributes/observe-data-attribute.ts"],"sourcesContent":[],"mappings":";;AAuBA;;;;;;;;;;;;;;;;;;;;iBAAgB,8EACL,OAAO,WAAW,8BAClB,sBAAmB"}

package/dist/attributes/observe-data-attribute.mjs

@@ -0,0 +1,31 @@
+import { observeAttributes } from "./observe-attribute.mjs";
+
+//#region src/attributes/observe-data-attribute.ts
+/**
+* Observes changes to `data-*` attributes on an element and calls corresponding handlers.
+*
+* @param options - Configuration options
+* @param options.handlers - An object mapping `data-*` attribute names to handler functions.
+* @param options.element - The element to observe. Defaults to `document.documentElement`
+* @returns {MutationObserver} The observer instance, which can be used to disconnect the observer
+*
+* @example
+* ```ts
+* const observer = observeDataAttributes({
+*   handlers: {
+*     'data-theme': (value) => console.log(`Theme changed to: ${value}`),
+*     'data-mode': (value) => console.log(`Mode changed to: ${value}`)
+*   }
+* });
+*
+* // Later, to stop observing:
+* observer.disconnect();
+* ```
+*/
+function observeDataAttributes(handlers, element) {
+	return observeAttributes(handlers, element);
+}
+
+//#endregion
+export { observeDataAttributes };
+//# sourceMappingURL=observe-data-attribute.mjs.map

package/dist/attributes/observe-data-attribute.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-data-attribute.mjs","names":[],"sources":["../../src/attributes/observe-data-attribute.ts"],"sourcesContent":["import { observeAttributes } from './observe-attribute.ts'\n\n/**\n * Observes changes to `data-*` attributes on an element and calls corresponding handlers.\n *\n * @param options - Configuration options\n * @param options.handlers - An object mapping `data-*` attribute names to handler functions.\n * @param options.element - The element to observe. Defaults to `document.documentElement`\n * @returns {MutationObserver} The observer instance, which can be used to disconnect the observer\n *\n * @example\n * ```ts\n * const observer = observeDataAttributes({\n *   handlers: {\n *     'data-theme': (value) => console.log(`Theme changed to: ${value}`),\n *     'data-mode': (value) => console.log(`Mode changed to: ${value}`)\n *   }\n * });\n *\n * // Later, to stop observing:\n * observer.disconnect();\n * ```\n */\nexport function observeDataAttributes<T extends string, K extends `data-${string}`>(\n\thandlers: Record<K, (value: T | null) => void>,\n\telement?: Element | undefined\n) {\n\treturn observeAttributes(handlers, element)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,sBACf,UACA,SACC;AACD,QAAO,kBAAkB,UAAU,QAAQ"}