@askrjs/askr 0.0.52 → 0.0.53

package/dist/fx/timing.d.ts

@@ -1,158 +0,0 @@
-//#region src/fx/timing.d.ts
-/**
- * Timing utilities — pure helpers for common async patterns
- * No framework coupling. No lifecycle awareness.
- */
-interface DebounceOptions {
-  leading?: boolean;
-  trailing?: boolean;
-}
-interface ThrottleOptions {
-  leading?: boolean;
-  trailing?: boolean;
-}
-interface RetryOptions {
-  maxAttempts?: number;
-  delayMs?: number;
-  backoff?: (attemptIndex: number) => number;
-}
-type AnyFn = (...args: never[]) => unknown;
-/**
- * Debounce — delay execution, coalesce rapid calls
- *
- * Useful for: text input, resize, autosave
- *
- * @param fn Function to debounce
- * @param ms Delay in milliseconds
- * @param options trailing (default true), leading
- * @returns Debounced function with cancel() method
- *
- * @example
- * ```ts
- * const save = debounce((text) => api.save(text), 500);
- * input.addEventListener('input', (e) => save(e.target.value));
- * save.cancel(); // stop any pending execution
- * ```
- */
-declare function debounce<T extends AnyFn>(fn: T, ms: number, options?: DebounceOptions): T & {
-  cancel(): void;
-};
-/**
- * Throttle — rate-limit execution, keep first/last
- *
- * Useful for: scroll, mouse move, high-frequency events
- *
- * @param fn Function to throttle
- * @param ms Minimum interval between calls in milliseconds
- * @param options leading (default true), trailing (default true)
- * @returns Throttled function with cancel() method
- *
- * @example
- * ```ts
- * const handleScroll = throttle(updateUI, 100);
- * window.addEventListener('scroll', handleScroll);
- * handleScroll.cancel();
- * ```
- */
-declare function throttle<T extends AnyFn>(fn: T, ms: number, options?: ThrottleOptions): T & {
-  cancel(): void;
-};
-/**
- * Once — guard against double execution
- *
- * Useful for: init logic, event safety
- *
- * @param fn Function to call at most once
- * @returns Function that executes fn only on first call
- *
- * @example
- * ```ts
- * const init = once(setup);
- * init(); // runs
- * init(); // does nothing
- * init(); // does nothing
- * ```
- */
-declare function once<T extends AnyFn>(fn: T): T;
-/**
- * Defer — schedule on microtask queue
- *
- * Useful for: run-after-current-stack logic
- * More reliable than setTimeout(..., 0)
- *
- * @param fn Function to defer
- *
- * @example
- * ```ts
- * defer(() => update()); // runs after current stack, before next macrotask
- * ```
- */
-declare function defer(fn: () => void): void;
-/**
- * RAF — coalesce multiple updates into single frame
- *
- * Useful for: animation, layout work, render updates
- *
- * @param fn Function to schedule on next animation frame
- * @returns Function that schedules fn on requestAnimationFrame
- *
- * @example
- * ```ts
- * const update = raf(render);
- * update(); // schedules on next frame
- * update(); // same frame, no duplicate
- * ```
- */
-declare function raf<T extends AnyFn>(fn: T): T;
-/**
- * Idle — schedule low-priority work
- *
- * Useful for: background prep, non-urgent updates
- * Falls back to setTimeout if requestIdleCallback unavailable
- *
- * @param fn Function to call when idle
- * @param options timeout for fallback
- *
- * @example
- * ```ts
- * idle(() => prefetchData());
- * ```
- */
-declare function idle(fn: () => void, options?: {
-  timeout?: number;
-}): void;
-/**
- * Timeout — Promise-based delay
- *
- * Useful for: readable async code, waiting between retries
- *
- * @param ms Milliseconds to wait
- * @returns Promise that resolves after delay
- *
- * @example
- * ```ts
- * await timeout(300);
- * console.log('300ms later');
- * ```
- */
-declare function timeout(ms: number): Promise<void>;
-/**
- * Retry — attempt function with backoff
- *
- * Useful for: network calls, transient failures
- *
- * @param fn Async function to retry
- * @param options maxAttempts, delayMs, backoff function
- * @returns Promise with final result or error
- *
- * @example
- * ```ts
- * const data = await retry(() => fetch(url), {
- *   maxAttempts: 3,
- *   delayMs: 100,
- * });
- * ```
- */
-declare function retry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
-//#endregion
-export { DebounceOptions, RetryOptions, ThrottleOptions, debounce, defer, idle, once, raf, retry, throttle, timeout };

package/dist/fx/timing.js

@@ -1,241 +0,0 @@
-//#region src/fx/timing.ts
-/**
-* Debounce — delay execution, coalesce rapid calls
-*
-* Useful for: text input, resize, autosave
-*
-* @param fn Function to debounce
-* @param ms Delay in milliseconds
-* @param options trailing (default true), leading
-* @returns Debounced function with cancel() method
-*
-* @example
-* ```ts
-* const save = debounce((text) => api.save(text), 500);
-* input.addEventListener('input', (e) => save(e.target.value));
-* save.cancel(); // stop any pending execution
-* ```
-*/
-function debounce(fn, ms, options) {
-	const callable = fn;
-	let timeoutId = null;
-	const { leading = false, trailing = true } = options || {};
-	let lastArgs = null;
-	let lastThis = null;
-	let lastCallTime = 0;
-	const debounced = function(...args) {
-		const callTime = Date.now();
-		lastArgs = args;
-		lastThis = this;
-		if (timeoutId !== null) clearTimeout(timeoutId);
-		if (leading && callTime - lastCallTime >= ms) {
-			callable.apply(this, args);
-			lastCallTime = callTime;
-		}
-		if (trailing) timeoutId = setTimeout(() => {
-			callable.apply(lastThis, lastArgs);
-			timeoutId = null;
-			lastCallTime = Date.now();
-		}, ms);
-	};
-	debounced.cancel = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-	};
-	return debounced;
-}
-/**
-* Throttle — rate-limit execution, keep first/last
-*
-* Useful for: scroll, mouse move, high-frequency events
-*
-* @param fn Function to throttle
-* @param ms Minimum interval between calls in milliseconds
-* @param options leading (default true), trailing (default true)
-* @returns Throttled function with cancel() method
-*
-* @example
-* ```ts
-* const handleScroll = throttle(updateUI, 100);
-* window.addEventListener('scroll', handleScroll);
-* handleScroll.cancel();
-* ```
-*/
-function throttle(fn, ms, options) {
-	const callable = fn;
-	let lastCallTime = null;
-	let timeoutId = null;
-	const { leading = true, trailing = true } = options || {};
-	let lastArgs = null;
-	let lastThis = null;
-	const throttled = function(...args) {
-		const callTime = Date.now();
-		const timeSinceLastCall = lastCallTime === null ? Number.POSITIVE_INFINITY : callTime - lastCallTime;
-		lastArgs = args;
-		lastThis = this;
-		if (leading && timeSinceLastCall >= ms) {
-			callable.apply(this, args);
-			lastCallTime = callTime;
-			if (timeoutId !== null) {
-				clearTimeout(timeoutId);
-				timeoutId = null;
-			}
-			return;
-		}
-		if (!leading && lastCallTime === null) lastCallTime = callTime;
-		if (trailing && timeoutId === null) timeoutId = setTimeout(() => {
-			callable.apply(lastThis, lastArgs);
-			lastCallTime = Date.now();
-			timeoutId = null;
-		}, lastCallTime === null ? ms : Math.max(0, ms - (callTime - lastCallTime)));
-	};
-	throttled.cancel = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-	};
-	return throttled;
-}
-/**
-* Once — guard against double execution
-*
-* Useful for: init logic, event safety
-*
-* @param fn Function to call at most once
-* @returns Function that executes fn only on first call
-*
-* @example
-* ```ts
-* const init = once(setup);
-* init(); // runs
-* init(); // does nothing
-* init(); // does nothing
-* ```
-*/
-function once(fn) {
-	const callable = fn;
-	let called = false;
-	let result;
-	return ((...args) => {
-		if (!called) {
-			called = true;
-			result = callable(...args);
-		}
-		return result;
-	});
-}
-/**
-* Defer — schedule on microtask queue
-*
-* Useful for: run-after-current-stack logic
-* More reliable than setTimeout(..., 0)
-*
-* @param fn Function to defer
-*
-* @example
-* ```ts
-* defer(() => update()); // runs after current stack, before next macrotask
-* ```
-*/
-function defer(fn) {
-	Promise.resolve().then(fn);
-}
-/**
-* RAF — coalesce multiple updates into single frame
-*
-* Useful for: animation, layout work, render updates
-*
-* @param fn Function to schedule on next animation frame
-* @returns Function that schedules fn on requestAnimationFrame
-*
-* @example
-* ```ts
-* const update = raf(render);
-* update(); // schedules on next frame
-* update(); // same frame, no duplicate
-* ```
-*/
-function raf(fn) {
-	const callable = fn;
-	let frameId = null;
-	let lastArgs = null;
-	let lastThis = null;
-	return function(...args) {
-		lastArgs = args;
-		lastThis = this;
-		if (frameId === null) frameId = requestAnimationFrame(() => {
-			callable.apply(lastThis, lastArgs);
-			frameId = null;
-		});
-	};
-}
-/**
-* Idle — schedule low-priority work
-*
-* Useful for: background prep, non-urgent updates
-* Falls back to setTimeout if requestIdleCallback unavailable
-*
-* @param fn Function to call when idle
-* @param options timeout for fallback
-*
-* @example
-* ```ts
-* idle(() => prefetchData());
-* ```
-*/
-function idle(fn, options) {
-	if (typeof requestIdleCallback !== "undefined") requestIdleCallback(fn, options ? { timeout: options.timeout } : void 0);
-	else Promise.resolve().then(() => {
-		setTimeout(fn, 0);
-	});
-}
-/**
-* Timeout — Promise-based delay
-*
-* Useful for: readable async code, waiting between retries
-*
-* @param ms Milliseconds to wait
-* @returns Promise that resolves after delay
-*
-* @example
-* ```ts
-* await timeout(300);
-* console.log('300ms later');
-* ```
-*/
-function timeout(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-/**
-* Retry — attempt function with backoff
-*
-* Useful for: network calls, transient failures
-*
-* @param fn Async function to retry
-* @param options maxAttempts, delayMs, backoff function
-* @returns Promise with final result or error
-*
-* @example
-* ```ts
-* const data = await retry(() => fetch(url), {
-*   maxAttempts: 3,
-*   delayMs: 100,
-* });
-* ```
-*/
-async function retry(fn, options) {
-	const { maxAttempts = 3, delayMs = 100, backoff = (i) => delayMs * Math.pow(2, i) } = options || {};
-	let lastError = null;
-	for (let attempt = 0; attempt < maxAttempts; attempt++) try {
-		return await fn();
-	} catch (error) {
-		lastError = error;
-		if (attempt < maxAttempts - 1) await timeout(backoff(attempt));
-	}
-	throw lastError || /* @__PURE__ */ new Error("Retry failed");
-}
-//#endregion
-export { debounce, defer, idle, once, raf, retry, throttle, timeout };

package/dist/jsx/index.d.ts

@@ -1,2 +0,0 @@
-import { Fragment, JSXComponent, JSXElement, JSXElementType } from "../common/jsx.js";
-export type { JSXElement };

package/dist/jsx/index.js

@@ -1,4 +0,0 @@
-import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
-import "./types.js";
-import { cloneElement, isElement } from "./utils.js";
-export { ELEMENT_TYPE, Fragment, cloneElement, isElement };

package/dist/jsx/types.js

@@ -1,2 +0,0 @@
-import { ELEMENT_TYPE, Fragment, STATIC_CHILDREN } from "../common/jsx.js";
-export { ELEMENT_TYPE, Fragment, STATIC_CHILDREN };

package/dist/jsx/utils.d.ts

@@ -1,4 +0,0 @@
-import { JSXElement } from "../common/jsx.js";
-//#region src/jsx/utils.d.ts
-declare function isElement(value: unknown): value is JSXElement;
-declare function cloneElement(element: JSXElement, props: Record<string, unknown>): JSXElement;

package/dist/jsx/utils.js

@@ -1,17 +0,0 @@
-import { ELEMENT_TYPE } from "../common/jsx.js";
-import "./types.js";
-//#region src/jsx/utils.ts
-function isElement(value) {
-	return typeof value === "object" && value !== null && value.$$typeof === ELEMENT_TYPE;
-}
-function cloneElement(element, props) {
-	return {
-		...element,
-		props: {
-			...element.props,
-			...props
-		}
-	};
-}
-//#endregion
-export { cloneElement, isElement };

package/dist/jsx-runtime2.d.ts

@@ -1,3 +0,0 @@
-import { Fragment, JSXComponent, JSXElement, JSXElementType } from "./common/jsx.js";
-import { JSX, jsx, jsxDEV, jsxs } from "./jsx-runtime.js";
-export { Fragment, jsx, jsxs };

package/dist/jsx-runtime2.js

@@ -1,4 +0,0 @@
-import { Fragment } from "./common/jsx.js";
-import "./jsx/types.js";
-import { jsx, jsxs } from "./jsx-runtime.js";
-export { Fragment, jsx, jsxs };

package/dist/renderer/attributes.js

@@ -1,254 +0,0 @@
-import { incrementPerfMetric } from "../runtime/perf-metrics.js";
-import "../runtime/index.js";
-import { extractKey, getRenderedAttributeName, isSkippedProp, parseEventName, readElementClassName, removeRenderedAttribute, setRenderedAttribute, tagNamesEqualIgnoreCase, writeElementClassName } from "./utils.js";
-function applyFormControlProp(el, key, value, tagName) {
-	if (key === "value") {
-		if (tagNamesEqualIgnoreCase(tagName, "input") || tagNamesEqualIgnoreCase(tagName, "textarea") || tagNamesEqualIgnoreCase(tagName, "select")) {
-			el.value = String(value);
-			el.setAttribute("value", String(value));
-		} else el.setAttribute("value", String(value));
-		return;
-	}
-	if (key === "checked") if (tagNamesEqualIgnoreCase(tagName, "input")) {
-		const checked = Boolean(value);
-		el.checked = checked;
-		if (checked) el.setAttribute("checked", "");
-		else el.removeAttribute("checked");
-	} else if (value) el.setAttribute("checked", "");
-	else el.removeAttribute("checked");
-}
-function normalizeStylePropertyName(propertyName) {
-	if (propertyName.startsWith("--")) return propertyName;
-	return propertyName.replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`);
-}
-function collectCurrentStyleEntries(el) {
-	const entries = /* @__PURE__ */ new Map();
-	const style = el.style;
-	if (!style) return entries;
-	for (let index = 0; index < style.length; index += 1) {
-		const propertyName = style.item(index);
-		entries.set(propertyName, style.getPropertyValue(propertyName));
-	}
-	return entries;
-}
-function normalizeStyleEntries(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-	const entries = /* @__PURE__ */ new Map();
-	for (const [key, entryValue] of Object.entries(value)) {
-		if (entryValue === void 0 || entryValue === null || entryValue === false) continue;
-		entries.set(normalizeStylePropertyName(key), String(entryValue));
-	}
-	return entries;
-}
-function applyStylePropValue(el, value) {
-	const style = el.style;
-	if (!style) {
-		if (value === null || value === void 0 || value === false) {
-			el.removeAttribute("style");
-			return;
-		}
-		el.setAttribute("style", String(value));
-		return;
-	}
-	if (value === null || value === void 0 || value === false) {
-		if (!el.getAttribute("style")) {
-			incrementPerfMetric("skippedDomPropWrites");
-			return;
-		}
-		style.cssText = "";
-		el.removeAttribute("style");
-		return;
-	}
-	if (typeof value === "string") {
-		if ((el.getAttribute("style") ?? "") === value) {
-			incrementPerfMetric("skippedDomPropWrites");
-			return;
-		}
-		style.cssText = value;
-		return;
-	}
-	const nextEntries = normalizeStyleEntries(value);
-	if (!nextEntries) {
-		const nextText = String(value);
-		if ((el.getAttribute("style") ?? "") === nextText) {
-			incrementPerfMetric("skippedDomPropWrites");
-			return;
-		}
-		style.cssText = nextText;
-		return;
-	}
-	const previousEntries = collectCurrentStyleEntries(el);
-	let didWrite = false;
-	for (const [propertyName] of previousEntries) {
-		if (nextEntries.has(propertyName)) continue;
-		style.removeProperty(propertyName);
-		didWrite = true;
-	}
-	for (const [propertyName, propertyValue] of nextEntries) {
-		if (previousEntries.get(propertyName) === propertyValue) continue;
-		style.setProperty(propertyName, propertyValue);
-		didWrite = true;
-	}
-	if (!didWrite) incrementPerfMetric("skippedDomPropWrites");
-}
-function applyStaticScalarPropsToElement(el, props, tagName) {
-	for (const key in props) {
-		if (isSkippedProp(key)) continue;
-		const value = props[key];
-		if (value === void 0 || value === null || value === false) continue;
-		if (key === "class" || key === "className") writeElementClassName(el, String(value));
-		else if (key === "style") applyStylePropValue(el, value);
-		else if (key === "value" || key === "checked") applyFormControlProp(el, key, value, tagName);
-		else setRenderedAttribute(el, key, String(value));
-	}
-}
-function tokenizeClassValue(value) {
-	if (typeof value !== "string") return null;
-	const trimmed = value.trim();
-	if (trimmed.length === 0) return [];
-	return trimmed.split(/\s+/);
-}
-function patchClassList(el, previousTokens, nextTokens) {
-	if (previousTokens.length === nextTokens.length) {
-		let identical = true;
-		for (let index = 0; index < previousTokens.length; index += 1) if (previousTokens[index] !== nextTokens[index]) {
-			identical = false;
-			break;
-		}
-		if (identical) return;
-	}
-	if (previousTokens.length === 0) {
-		if (nextTokens.length === 0) return;
-		el.classList.add(...nextTokens);
-		incrementPerfMetric("classListPatchOps");
-		return;
-	}
-	if (nextTokens.length === 0) {
-		el.classList.remove(...previousTokens);
-		incrementPerfMetric("classListPatchOps");
-		return;
-	}
-	if (previousTokens.length === 1 && nextTokens.length === 1) {
-		el.classList.remove(previousTokens[0]);
-		el.classList.add(nextTokens[0]);
-		incrementPerfMetric("classListPatchOps");
-		return;
-	}
-	const nextSet = new Set(nextTokens);
-	const previousSet = new Set(previousTokens);
-	for (const token of previousTokens) if (!nextSet.has(token)) el.classList.remove(token);
-	for (const token of nextTokens) if (!previousSet.has(token)) el.classList.add(token);
-	incrementPerfMetric("classListPatchOps");
-}
-function applyClassPropValue(el, value, previousValue, descriptor) {
-	const nextString = String(value);
-	const nextTokens = tokenizeClassValue(nextString);
-	const previousTokens = descriptor?.lastClassTokens ?? tokenizeClassValue(previousValue);
-	if (nextTokens && previousTokens) {
-		patchClassList(el, previousTokens, nextTokens);
-		if (descriptor) descriptor.lastClassTokens = nextTokens;
-		return;
-	}
-	writeElementClassName(el, nextString);
-	if (descriptor) descriptor.lastClassTokens = nextTokens;
-}
-function applyScalarPropValue(el, key, value, tagName, previousValue, descriptor) {
-	if (value === void 0 || value === null || value === false) {
-		if (key === "class" || key === "className") {
-			const previousTokens = descriptor?.lastClassTokens;
-			if (previousTokens && previousTokens.length > 0) {
-				el.classList.remove(...previousTokens);
-				incrementPerfMetric("classListPatchOps");
-			} else writeElementClassName(el, "");
-			if (descriptor) descriptor.lastClassTokens = [];
-		} else if (key === "value") applyFormControlProp(el, key, "", tagName);
-		else if (key === "checked") applyFormControlProp(el, key, false, tagName);
-		else if (key === "style") applyStylePropValue(el, null);
-		else removeRenderedAttribute(el, key);
-		return;
-	}
-	if (key === "class" || key === "className") applyClassPropValue(el, value, previousValue, descriptor);
-	else if (key === "style") applyStylePropValue(el, value);
-	else if (key === "value" || key === "checked") applyFormControlProp(el, key, value, tagName);
-	else setRenderedAttribute(el, key, String(value));
-}
-function removeStaleAttributes(el, vnode, props) {
-	const desiredAttributes = /* @__PURE__ */ new Set();
-	if (extractKey(vnode) !== void 0) {
-		desiredAttributes.add("data-key");
-		desiredAttributes.add("data-askr-key-kind");
-	}
-	for (const propName in props) {
-		if (isSkippedProp(propName)) continue;
-		if (parseEventName(propName)) continue;
-		const value = props[propName];
-		if (value === void 0 || value === null || value === false) continue;
-		desiredAttributes.add(getRenderedAttributeName(el, propName));
-	}
-	for (const attribute of Array.from(el.attributes)) if (!desiredAttributes.has(getRenderedAttributeName(el, attribute.name))) removeRenderedAttribute(el, attribute.name);
-}
-function materializeKey(el, vnode, props) {
-	const rawKey = vnode.key ?? props.key;
-	const vnodeKey = rawKey === null || rawKey === void 0 ? void 0 : typeof rawKey === "symbol" ? String(rawKey) : rawKey;
-	if (vnodeKey !== void 0) {
-		const nextKey = String(vnodeKey);
-		if (el.getAttribute("data-key") !== nextKey) el.setAttribute("data-key", nextKey);
-		const keyKind = typeof vnodeKey;
-		if (el.getAttribute("data-askr-key-kind") !== keyKind) el.setAttribute("data-askr-key-kind", keyKind);
-	}
-}
-/** @internal Materialize keyed metadata on a newly created or cloned node. */
-function materializeFreshKey(el, vnode, props) {
-	const rawKey = vnode.key ?? props.key;
-	if (rawKey === null || rawKey === void 0) return;
-	const vnodeKey = typeof rawKey === "symbol" ? String(rawKey) : rawKey;
-	el.setAttribute("data-key", String(vnodeKey));
-	const keyKind = typeof vnodeKey;
-	if (el.getAttribute("data-askr-key-kind") !== keyKind) el.setAttribute("data-askr-key-kind", keyKind);
-}
-function hasMatchingStaticPropsInternal(el, props, vnodeType, ignoreEventProps) {
-	let staticPropCount = 0;
-	for (const key in props) {
-		if (isSkippedProp(key)) continue;
-		const value = props[key];
-		if (value === void 0 || value === null || value === false) return false;
-		if (parseEventName(key)) {
-			if (ignoreEventProps) continue;
-			return false;
-		}
-		if (typeof value === "function") return false;
-		if (key === "class" || key === "className") {
-			if (readElementClassName(el) !== String(value)) return false;
-			staticPropCount += 1;
-			continue;
-		}
-		if (key === "style") {
-			const styleValue = typeof value === "string" ? value.trim().replace(/;$/, "") : null;
-			const domStyle = el.getAttribute("style")?.trim().replace(/;$/, "") ?? "";
-			if (styleValue === null || domStyle !== styleValue) return false;
-			staticPropCount += 1;
-			continue;
-		}
-		if (key === "value" || key === "checked") {
-			if (el[key] !== value) return false;
-			staticPropCount += 1;
-			continue;
-		}
-		if (key === "selected" && vnodeType === "option") {
-			if (el.selected !== Boolean(value)) return false;
-			staticPropCount += 1;
-			continue;
-		}
-		if (el.getAttribute(getRenderedAttributeName(el, key)) !== String(value)) return false;
-		staticPropCount += 1;
-	}
-	return el.attributes.length === staticPropCount;
-}
-function hasMatchingStaticProps(el, props, vnodeType) {
-	return hasMatchingStaticPropsInternal(el, props, vnodeType, false);
-}
-function hasMatchingStaticPropsIgnoringEvents(el, props, vnodeType) {
-	return hasMatchingStaticPropsInternal(el, props, vnodeType, true);
-}
-//#endregion
-export { applyClassPropValue, applyFormControlProp, applyScalarPropValue, applyStaticScalarPropsToElement, applyStylePropValue, hasMatchingStaticProps, hasMatchingStaticPropsIgnoringEvents, materializeFreshKey, materializeKey, removeStaleAttributes };