@tempots/dom 28.6.3 → 29.0.1

package/renderable/on.d.ts

@@ -186,6 +186,40 @@ export declare const on: {
     waiting: (handler: (event: Event, ctx: DOMContext) => void) => Renderable;
     wheel: (handler: (event: WheelEvent, ctx: DOMContext) => void) => Renderable;
 };
+/**
+ * Options for event handlers.
+ *
+ * @public
+ */
+export type EmitOptions = {
+    preventDefault?: boolean;
+    stopPropagation?: boolean;
+    stopImmediatePropagation?: boolean;
+};
+/**
+ * Creates an event handler that calls the provided function with the event as an argument.
+ * @param fn - The function to call when the event is triggered.
+ * @returns An event handler function that can be used with event listeners.
+ * @public
+ */
+export declare const emit: (fn: (event: Event) => void, options?: EmitOptions) => (event: Event) => void;
+/**
+ * Creates an event handler that extracts and emits the target element from an event.
+ *
+ * @example
+ * ```typescript
+ * html.input(
+ *   on.input(emitTarget((input) => {
+ *     console.log('Input value:', input.value)
+ *   }))
+ * )
+ * ```
+ *
+ * @param fn - Callback function that receives the target element
+ * @returns Event handler function that can be used with event listeners
+ * @public
+ */
+export declare const emitTarget: <EL extends HTMLElement>(fn: (element: EL, event: Event) => void, options?: EmitOptions) => (event: Event) => void;
 /**
  * Creates an event handler that extracts and emits the string value from an input element.
  *
@@ -220,7 +254,7 @@ export declare const on: {
  * @returns Event handler function that can be used with event listeners
  * @public
  */
-export declare const emitValue: (fn: (text: string) => void) => (event: Event) => void;
+export declare const emitValue: (fn: (text: string, event: Event) => void, options?: EmitOptions) => (event: Event) => void;
 /**
  * Creates an event handler that extracts and emits the numeric value from an input element.
  *
@@ -261,35 +295,35 @@ export declare const emitValue: (fn: (text: string) => void) => (event: Event) =
  * @returns Event handler function that can be used with event listeners
  * @public
  */
-export declare const emitValueAsNumber: (fn: (num: number) => void) => (event: Event) => void;
+export declare const emitValueAsNumber: (fn: (num: number, event: Event) => void, options?: EmitOptions) => (event: Event) => void;
 /**
  * Converts the value of an HTML input element to a Date object and emits it using the provided callback function.
  * @param fn - The callback function to be called with the converted Date object.
  * @returns A function that can be used as an event handler for input events.
  * @public
  */
-export declare const emitValueAsDate: (fn: (date: Date) => void) => (event: Event) => void;
+export declare const emitValueAsDate: (fn: (date: Date, event: Event) => void, options?: EmitOptions) => (event: Event) => void;
 /**
  * Converts the value of an HTML input element to a Date object or null and emits it using the provided callback function.
  * @param fn - The callback function to be called with the converted Date object or null.
  * @returns A function that can be used as an event handler for input events.
  * @public
  */
-export declare const emitValueAsNullableDate: (fn: (date: Date | null) => void) => (event: Event) => void;
+export declare const emitValueAsNullableDate: (fn: (date: Date | null, event: Event) => void, options?: EmitOptions) => (event: Event) => void;
 /**
  * Emits the value of an HTMLInputElement as a Date object.
  * @param fn - The callback function to be called with the emitted Date object.
  * @returns The event handler function.
  * @public
  */
-export declare const emitValueAsDateTime: (fn: (date: Date) => void) => (event: Event) => void;
+export declare const emitValueAsDateTime: (fn: (date: Date, event: Event) => void, options?: EmitOptions) => (event: Event) => void;
 /**
  * Emits the value of an HTMLInputElement as a Date object or null.
  * @param fn - The callback function to be called with the emitted Date object or null.
  * @returns The event handler function.
  * @public
  */
-export declare const emitValueAsNullableDateTime: (fn: (date: Date | null) => void) => (event: Event) => void;
+export declare const emitValueAsNullableDateTime: (fn: (date: Date | null, event: Event) => void, options?: EmitOptions) => (event: Event) => void;
 /**
  * Creates an event handler that extracts and emits the checked state from a checkbox or radio input.
  *
@@ -342,25 +376,4 @@ export declare const emitValueAsNullableDateTime: (fn: (date: Date | null) => vo
  * @returns Event handler function that can be used with event listeners
  * @public
  */
-export declare const emitChecked: (fn: (checked: boolean) => void) => (event: Event) => void;
-/**
- * Wraps a function to prevent the default behavior of an event before invoking it.
- * @param fn - The function to be wrapped.
- * @returns A new function that prevents the default behavior of the event and then invokes the original function.
- * @public
- */
-export declare const emitPreventDefault: (fn: () => void) => (event: Event) => void;
-/**
- * Creates a new event handler that stops event propagation and invokes the provided function.
- * @param fn - The function to be invoked when the event is triggered.
- * @returns A new event handler function.
- * @public
- */
-export declare const emitStopPropagation: (fn: () => void) => (event: Event) => void;
-/**
- * Creates an event handler that stops immediate propagation of the event and invokes the provided function.
- * @param fn - The function to be invoked.
- * @returns The event handler function.
- * @public
- */
-export declare const emitStopImmediatePropagation: (fn: () => void) => (event: Event) => void;
+export declare const emitChecked: (fn: (checked: boolean, event: Event) => void, options?: EmitOptions) => (event: Event) => void;

package/types/domain.d.ts

@@ -1,5 +1,5 @@
 import { DOMContext } from '../dom/dom-context';
-import { Computed, Prop, Signal } from '../std/signal';
+import { AnySignal, Computed, Prop, Signal } from '../std/signal';
 import { Value } from '../std/value';
 /**
  * A function that renders content into the DOM and returns a cleanup function.
@@ -149,13 +149,14 @@ export type Size = {
      */
     readonly height: number;
 };
-type WithNullish<X> = Value<X> | Value<X | null> | Value<X | undefined> | Value<X | null | undefined>;
 /**
  * Represents a nullable value or a signal of a nullable value.
  * @typeParam T - The type of the value.
  * @public
  */
-export type NValue<T> = WithNullish<T> | null | undefined;
+export type NValue<T> = Value<NonNullable<T>> | AnySignal<T> | AnySignal<T | null> | AnySignal<T | undefined> | AnySignal<T | null | undefined> | null | undefined;
+type TupleToUnion<T extends unknown[]> = T[number];
+export type SplitNValue<T> = (T extends unknown ? TupleToUnion<NValue<T>[]> : never) | NValue<T>;
 /**
  * Gets the value type of a given Value type.
  * If the type is a `Signal`, it returns the inferred value type.