@askrjs/askr 0.0.52 → 0.0.54

package/dist/foundations/structures/presence.js

@@ -1,37 +0,0 @@
-import { ELEMENT_TYPE, Fragment } from "../../common/jsx.js";
-import "../../jsx/index.js";
-//#region src/foundations/structures/presence.ts
-/**
-* Presence
-*
-* Structural policy primitive for conditional mount/unmount.
-* - No timers
-* - No animation coupling
-* - No DOM side-effects
-*
-* POLICY DECISIONS (LOCKED):
-*
-* 1. Present as Function
-*    Accepts boolean OR function to support lazy evaluation patterns.
-*    Function is called once per render. Use boolean form for static values.
-*
-* 2. Children Type
-*    Presence forwards normal renderable child content only.
-*    Imperative DOM nodes are not part of the public contract.
-*
-* 3. Immediate Mount/Unmount
-*    No exit animations or transitions. When `present` becomes false,
-*    children are removed immediately. Animation must be layered above
-*    this primitive.
-*/
-function Presence({ present, children }) {
-	if (!(typeof present === "function" ? present() : Boolean(present))) return null;
-	return {
-		$$typeof: ELEMENT_TYPE,
-		type: Fragment,
-		props: { children },
-		key: null
-	};
-}
-//#endregion
-export { Presence };

package/dist/foundations/structures/slot.d.ts

@@ -1,34 +0,0 @@
-import { JSXElement } from "../../common/jsx.js";
-import { RenderableChild } from "../../common/vnode.js";
-//#region src/foundations/structures/slot.d.ts
-type SlotProps = {
-  asChild: true;
-  children: JSXElement;
-  [key: string]: unknown;
-} | {
-  asChild?: false;
-  children?: RenderableChild;
-};
-/**
- * Slot
- *
- * Structural primitive for prop forwarding patterns.
- *
- * POLICY DECISIONS (LOCKED):
- *
- * 1. asChild Pattern
- *    When asChild=true, merges props into the single child element.
- *    Child must be a valid JSXElement; non-element children return null.
- *    **Slot props override child props** (injection pattern).
- *
- * 2. Fallback Behavior
- *    When asChild=false, returns a Fragment (structural no-op).
- *    No DOM element is introduced.
- *
- * 3. Type Safety
- *    asChild=true requires exactly one JSXElement child (enforced by type).
- *    Runtime validates with isElement() check.
- */
-declare function Slot(props: SlotProps): JSXElement | null;
-//#endregion
-export { Slot, SlotProps };

package/dist/foundations/structures/slot.js

@@ -1,39 +0,0 @@
-import { ELEMENT_TYPE, Fragment } from "../../common/jsx.js";
-import { cloneElement, isElement } from "../../jsx/utils.js";
-import "../../jsx/index.js";
-//#region src/foundations/structures/slot.tsx
-/**
-* Slot
-*
-* Structural primitive for prop forwarding patterns.
-*
-* POLICY DECISIONS (LOCKED):
-*
-* 1. asChild Pattern
-*    When asChild=true, merges props into the single child element.
-*    Child must be a valid JSXElement; non-element children return null.
-*    **Slot props override child props** (injection pattern).
-*
-* 2. Fallback Behavior
-*    When asChild=false, returns a Fragment (structural no-op).
-*    No DOM element is introduced.
-*
-* 3. Type Safety
-*    asChild=true requires exactly one JSXElement child (enforced by type).
-*    Runtime validates with isElement() check.
-*/
-function Slot(props) {
-	if (props.asChild) {
-		const { children, asChild: _asChild, ...rest } = props;
-		if (isElement(children)) return cloneElement(children, rest);
-		return null;
-	}
-	return {
-		$$typeof: ELEMENT_TYPE,
-		type: Fragment,
-		props: { children: props.children },
-		key: null
-	};
-}
-//#endregion
-export { Slot };

package/dist/foundations/utilities/aria.d.ts

@@ -1,15 +0,0 @@
-//#region src/foundations/utilities/aria.d.ts
-/**
- * Tiny aria helpers
- */
-declare function ariaDisabled(disabled?: boolean): {
-  'aria-disabled'?: 'true';
-};
-declare function ariaExpanded(expanded?: boolean): {
-  'aria-expanded'?: 'true' | 'false';
-};
-declare function ariaSelected(selected?: boolean): {
-  'aria-selected'?: 'true' | 'false';
-};
-//#endregion
-export { ariaDisabled, ariaExpanded, ariaSelected };

package/dist/foundations/utilities/aria.js

@@ -1,15 +0,0 @@
-//#region src/foundations/utilities/aria.ts
-/**
-* Tiny aria helpers
-*/
-function ariaDisabled(disabled) {
-	return disabled ? { "aria-disabled": "true" } : {};
-}
-function ariaExpanded(expanded) {
-	return expanded === void 0 ? {} : { "aria-expanded": String(expanded) };
-}
-function ariaSelected(selected) {
-	return selected === void 0 ? {} : { "aria-selected": String(selected) };
-}
-//#endregion
-export { ariaDisabled, ariaExpanded, ariaSelected };

package/dist/foundations/utilities/compose-handlers.d.ts

@@ -1,36 +0,0 @@
-//#region src/foundations/utilities/compose-handlers.d.ts
-/**
- * composeHandlers
- *
- * Compose two event handlers into one. The first handler runs, and unless it
- * calls `event.preventDefault()` (or sets `defaultPrevented`), the second
- * handler runs. This prevents accidental clobbering of child handlers when
- * injecting props.
- *
- * POLICY DECISIONS (LOCKED):
- *
- * 1. Execution Order
- *    First handler runs before second (injected before base).
- *    This allows injected handlers to prevent default behavior.
- *
- * 2. Default Prevention Check
- *    By default, checks `defaultPrevented` on first argument.
- *    Can be disabled via options.checkDefaultPrevented = false.
- *
- * 3. Undefined Handler Support
- *    Undefined handlers are skipped (no-op). This simplifies usage
- *    where handlers are optional.
- *
- * 4. Type Safety
- *    Args are readonly to prevent mutation. Return type matches input.
- */
-interface ComposeHandlersOptions {
-  /**
-   * When true (default), do not run the second handler if the first prevented default.
-   * When false, always run both handlers.
-   */
-  checkDefaultPrevented?: boolean;
-}
-declare function composeHandlers<A extends readonly unknown[]>(first?: (...args: A) => void, second?: (...args: A) => void, options?: ComposeHandlersOptions): (...args: A) => void;
-//#endregion
-export { ComposeHandlersOptions, composeHandlers };

package/dist/foundations/utilities/compose-handlers.js

@@ -1,18 +0,0 @@
-//#region src/foundations/utilities/compose-handlers.ts
-function isDefaultPrevented(value) {
-	return typeof value === "object" && value !== null && "defaultPrevented" in value && value.defaultPrevented === true;
-}
-function composeHandlers(first, second, options) {
-	if (!first && !second) return noop;
-	if (!first) return second;
-	if (!second) return first;
-	const checkDefaultPrevented = options?.checkDefaultPrevented !== false;
-	return function composed(...args) {
-		first(...args);
-		if (checkDefaultPrevented && isDefaultPrevented(args[0])) return;
-		second(...args);
-	};
-}
-function noop() {}
-//#endregion
-export { composeHandlers };

package/dist/foundations/utilities/compose-ref.js

@@ -1,16 +0,0 @@
-//#region src/foundations/utilities/compose-ref.ts
-function setRef(ref, value) {
-	if (!ref) return;
-	if (typeof ref === "function") {
-		ref(value);
-		return;
-	}
-	if (Object.isExtensible(ref)) ref.current = value;
-}
-function composeRefs(...refs) {
-	return (value) => {
-		for (const ref of refs) setRef(ref, value);
-	};
-}
-//#endregion
-export { composeRefs, setRef };

package/dist/foundations/utilities/event-types.d.ts

@@ -1,19 +0,0 @@
-//#region src/foundations/utilities/event-types.d.ts
-interface DefaultPreventable {
-  defaultPrevented?: boolean;
-  preventDefault?: () => void;
-}
-interface PropagationStoppable {
-  stopPropagation?: () => void;
-}
-interface KeyboardLikeEvent extends DefaultPreventable, PropagationStoppable {
-  key: string;
-}
-interface PointerLikeEvent extends DefaultPreventable, PropagationStoppable {
-  target?: unknown;
-}
-interface FocusLikeEvent extends DefaultPreventable, PropagationStoppable {
-  relatedTarget?: unknown;
-}
-//#endregion
-export { DefaultPreventable, FocusLikeEvent, KeyboardLikeEvent, PointerLikeEvent, PropagationStoppable };

package/dist/foundations/utilities/merge-props.d.ts

@@ -1,4 +0,0 @@
-//#region src/foundations/utilities/merge-props.d.ts
-declare function mergeProps<TBase extends object, TInjected extends object>(base: TBase, injected: TInjected): TInjected & TBase;
-//#endregion
-export { mergeProps };

package/dist/foundations/utilities/merge-props.js

@@ -1,47 +0,0 @@
-import { composeHandlers } from "./compose-handlers.js";
-//#region src/foundations/utilities/merge-props.ts
-/**
-* mergeProps
-*
-* Deterministic props merging.
-* - For non-handlers: `base` overwrites `injected`.
-* - For handlers present in both: handlers are composed with `injected` running
-*   first; it may call `preventDefault()` to suppress the `base` handler.
-*
-* POLICY DECISIONS (LOCKED):
-*
-* 1. Merge Strategy
-*    Base props overwrite injected props (base wins).
-*    Exception: Event handlers are composed, not overwritten.
-*
-* 2. Event Handler Detection
-*    Keys starting with "on" are treated as event handlers.
-*    This matches JSX conventions.
-*
-* 3. Handler Composition Order
-*    Injected handler runs first, base handler second.
-*    This allows injected handlers to prevent default.
-*
-* 4. Return Type
-*    Returns intersection type (TInjected & TBase) for type safety.
-*/
-function isEventHandlerKey(key) {
-	return key.startsWith("on");
-}
-function mergeProps(base, injected) {
-	const baseKeys = Object.keys(base);
-	if (baseKeys.length === 0) return injected;
-	const out = { ...injected };
-	for (const key of baseKeys) {
-		const baseValue = base[key];
-		const injectedValue = injected[key];
-		if (isEventHandlerKey(key) && typeof baseValue === "function" && typeof injectedValue === "function") {
-			out[key] = composeHandlers(injectedValue, baseValue);
-			continue;
-		}
-		out[key] = baseValue;
-	}
-	return out;
-}
-//#endregion
-export { mergeProps };

package/dist/foundations/utilities/use-id.d.ts

@@ -1,31 +0,0 @@
-//#region src/foundations/utilities/use-id.d.ts
-interface FormatIdOptions {
-  /** Defaults to 'askr' */
-  prefix?: string;
-  /** Stable, caller-provided identity */
-  id: string | number;
-}
-/**
- * formatId
- *
- * Formats a stable ID from a caller-provided identity.
- * - Pure and deterministic (no time/randomness/global counters)
- * - SSR-safe
- *
- * POLICY DECISIONS (LOCKED):
- *
- * 1. No Auto-Generation
- *    Caller must provide the `id`. No random/sequential generation.
- *    This ensures determinism and SSR safety.
- *
- * 2. Format Convention
- *    IDs are formatted as `{prefix}-{id}`.
- *    Default prefix is "askr".
- *
- * 3. Type Coercion
- *    Numbers are coerced to strings via String().
- *    This is deterministic and consistent.
- */
-declare function formatId(options: FormatIdOptions): string;
-//#endregion
-export { FormatIdOptions, formatId };

package/dist/fx/fx.d.ts

@@ -1,32 +0,0 @@
-//#region src/fx/fx.d.ts
-type CancelFn = () => void;
-declare function debounceEvent(ms: number, handler: EventListener, options?: {
-  leading?: boolean;
-  trailing?: boolean;
-}): EventListener & {
-  cancel(): void;
-  flush(): void;
-};
-declare function throttleEvent(ms: number, handler: EventListener, options?: {
-  leading?: boolean;
-  trailing?: boolean;
-}): EventListener & {
-  cancel(): void;
-};
-declare function rafEvent(handler: EventListener): EventListener & {
-  cancel(): void;
-};
-declare function scheduleTimeout(ms: number, fn: () => void): CancelFn;
-declare function scheduleIdle(fn: () => void, options?: {
-  timeout?: number;
-}): CancelFn;
-interface RetryOptions {
-  maxAttempts?: number;
-  delayMs?: number;
-  backoff?: (attemptIndex: number) => number;
-}
-declare function scheduleRetry<T>(fn: () => Promise<T>, options?: RetryOptions): {
-  cancel(): void;
-};
-//#endregion
-export { CancelFn, RetryOptions, debounceEvent, rafEvent, scheduleIdle, scheduleRetry, scheduleTimeout, throttleEvent };

package/dist/fx/fx.js

@@ -1,211 +0,0 @@
-import { logger } from "../common/logger.js";
-import { enqueueRuntimeTask } from "../runtime/access.js";
-import { getCurrentComponentInstance } from "../runtime/component-scope.js";
-import "../runtime/index.js";
-import { noopEventListener, noopEventListenerWithFlush } from "./noop.js";
-//#region src/fx/fx.ts
-function throwIfDuringRender() {
-	if (getCurrentComponentInstance() !== null) throw new Error("[Askr] calling FX handler during render is not allowed. Move calls to event handlers or effects.");
-}
-/**
-* Helper: schedule a user callback through the global scheduler
-*/
-function enqueueUserCallback(fn) {
-	enqueueRuntimeTask(() => {
-		try {
-			fn();
-		} catch (err) {
-			logger.error("[Askr] FX handler error:", err);
-		}
-	});
-}
-function debounceEvent(ms, handler, options) {
-	const { leading = false, trailing = true } = options || {};
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return noopEventListenerWithFlush;
-	let timeoutId = null;
-	let lastEvent = null;
-	let lastCallTime = 0;
-	const debounced = function(ev) {
-		throwIfDuringRender();
-		const now = Date.now();
-		lastEvent = ev;
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-		if (leading && now - lastCallTime >= ms) {
-			enqueueUserCallback(() => handler.call(null, ev));
-			lastCallTime = now;
-		}
-		if (trailing) timeoutId = setTimeout(() => {
-			if (lastEvent) enqueueUserCallback(() => handler.call(null, lastEvent));
-			timeoutId = null;
-			lastCallTime = Date.now();
-		}, ms);
-	};
-	debounced.cancel = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-		lastEvent = null;
-	};
-	debounced.flush = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			const ev = lastEvent;
-			lastEvent = null;
-			timeoutId = null;
-			if (ev) enqueueUserCallback(() => handler.call(null, ev));
-		}
-	};
-	if (inst) (inst.cleanupFns ??= []).push(() => {
-		debounced.cancel();
-	});
-	return debounced;
-}
-function throttleEvent(ms, handler, options) {
-	const { leading = true, trailing = true } = options || {};
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return noopEventListener;
-	let lastCallTime = 0;
-	let timeoutId = null;
-	let lastEvent = null;
-	const throttled = function(ev) {
-		throwIfDuringRender();
-		const now = Date.now();
-		lastEvent = ev;
-		if (leading && now - lastCallTime >= ms) {
-			enqueueUserCallback(() => handler.call(null, ev));
-			lastCallTime = now;
-			if (timeoutId !== null) {
-				clearTimeout(timeoutId);
-				timeoutId = null;
-			}
-		} else if (!leading && lastCallTime === 0) lastCallTime = now;
-		if (trailing && timeoutId === null) {
-			const wait = ms - (now - lastCallTime);
-			timeoutId = setTimeout(() => {
-				if (lastEvent) enqueueUserCallback(() => handler.call(null, lastEvent));
-				lastCallTime = Date.now();
-				timeoutId = null;
-			}, Math.max(0, wait));
-		}
-	};
-	throttled.cancel = () => {
-		if (timeoutId !== null) {
-			clearTimeout(timeoutId);
-			timeoutId = null;
-		}
-		lastEvent = null;
-	};
-	if (inst) (inst.cleanupFns ??= []).push(() => throttled.cancel());
-	return throttled;
-}
-function rafEvent(handler) {
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return noopEventListener;
-	let frameId = null;
-	let lastEvent = null;
-	const scheduleFrame = () => {
-		frameId = (typeof requestAnimationFrame !== "undefined" ? requestAnimationFrame : (cb) => setTimeout(() => cb(Date.now()), 16))(() => {
-			frameId = null;
-			if (lastEvent) {
-				const ev = lastEvent;
-				lastEvent = null;
-				enqueueUserCallback(() => handler.call(null, ev));
-			}
-		});
-	};
-	const fn = function(ev) {
-		throwIfDuringRender();
-		lastEvent = ev;
-		if (frameId === null) scheduleFrame();
-	};
-	fn.cancel = () => {
-		if (frameId !== null) {
-			if (typeof cancelAnimationFrame !== "undefined" && typeof frameId === "number") cancelAnimationFrame(frameId);
-			else clearTimeout(frameId);
-			frameId = null;
-		}
-		lastEvent = null;
-	};
-	if (inst) (inst.cleanupFns ??= []).push(() => fn.cancel());
-	return fn;
-}
-function scheduleTimeout(ms, fn) {
-	throwIfDuringRender();
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return () => {};
-	let id = setTimeout(() => {
-		id = null;
-		enqueueUserCallback(fn);
-	}, ms);
-	const cancel = () => {
-		if (id !== null) {
-			clearTimeout(id);
-			id = null;
-		}
-	};
-	if (inst) (inst.cleanupFns ??= []).push(cancel);
-	return cancel;
-}
-function scheduleIdle(fn, options) {
-	throwIfDuringRender();
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return () => {};
-	let id = null;
-	let usingRIC = false;
-	if (typeof requestIdleCallback !== "undefined") {
-		usingRIC = true;
-		id = requestIdleCallback(() => {
-			id = null;
-			enqueueUserCallback(fn);
-		}, options);
-	} else id = setTimeout(() => {
-		id = null;
-		enqueueUserCallback(fn);
-	}, 0);
-	const cancel = () => {
-		if (id !== null) {
-			if (usingRIC && typeof cancelIdleCallback !== "undefined" && typeof id === "number") cancelIdleCallback(id);
-			else clearTimeout(id);
-			id = null;
-		}
-	};
-	if (inst) (inst.cleanupFns ??= []).push(cancel);
-	return cancel;
-}
-function scheduleRetry(fn, options) {
-	throwIfDuringRender();
-	const inst = getCurrentComponentInstance();
-	if (inst && inst.ssr) return { cancel: () => {} };
-	const { maxAttempts = 3, delayMs = 100, backoff = (i) => delayMs * Math.pow(2, i) } = options || {};
-	let cancelled = false;
-	const attempt = (index) => {
-		if (cancelled) return;
-		enqueueRuntimeTask(() => {
-			if (cancelled) return;
-			fn().then(() => {}, () => {
-				if (cancelled) return;
-				if (index + 1 < maxAttempts) {
-					const delay = backoff(index);
-					setTimeout(() => {
-						attempt(index + 1);
-					}, delay);
-				}
-			}).catch((e) => {
-				logger.error("[Askr] scheduleRetry error:", e);
-			});
-		});
-	};
-	attempt(0);
-	const cancel = () => {
-		cancelled = true;
-	};
-	if (inst) (inst.cleanupFns ??= []).push(cancel);
-	return { cancel };
-}
-//#endregion
-export { debounceEvent, rafEvent, scheduleIdle, scheduleRetry, scheduleTimeout, throttleEvent };

package/dist/fx/noop.js

@@ -1,7 +0,0 @@
-const noopEventListener = Object.assign((_ev) => {}, { cancel() {} });
-const noopEventListenerWithFlush = Object.assign((_ev) => {}, {
-	cancel() {},
-	flush() {}
-});
-//#endregion
-export { noopEventListener, noopEventListenerWithFlush };